AI ön kontrol kılavuzu

QoreChain, herhangi bir dApp'e zincir üzerinde bir AI risk/anomali modeli sunan ilk ağdır. Salt okunur iki EVM precompile'ı, yalnızca eth_call kullanarak, bir işlemi imzalanmadan veya yayınlanmadan önce puanlamanıza olanak tanır:

Yetenek	Precompile	Adres
Calldata için risk puanı	aiRiskScore(bytes)	0x0000000000000000000000000000000000000B01
(sender, amount) için anomali kontrolü	aiAnomalyCheck(address,uint256)	0x0000000000000000000000000000000000000B02

Uygulama @qorechain/evm içinde (viem üzerindeki EVM adaptörü) yer alır ve keşif için @qorechain/sdk'den yeniden dışa aktarılır.

Risk level değeri, daha riskli işlemler için daha yüksektir. Zincirin örnek politikası require(level < 3) kullanır.

Tek çağrıyla ön kontrol

simulateWithRiskScore, bir gaz tahmini, bir risk puanı ve bir anomali kontrolünü tek bir tavsiye niteliğindeki sonuçta bir araya getirir:

import { createEvmClient, simulateWithRiskScore } from "@qorechain/evm";

const { publicClient } = await createEvmClient({
  endpoints: { evmRpc: "https://evm.testnet.example" },
});

const preflight = await simulateWithRiskScore(publicClient, {
  from: "0xYourAddress",
  to: "0xToken",
  data: "0xa9059cbb...", // ERC-20 transfer calldata
  value: 0n,
});

console.log(preflight.gas);     // bigint — eth_estimateGas
console.log(preflight.risk);    // { score: bigint, level: number }
console.log(preflight.anomaly); // { anomalyScore: bigint, flagged: boolean }
console.log(preflight.safe);    // boolean — advisory verdict

safe, eşik varsayılan olarak 3 olmak üzere, risk.level < RISK_LEVEL_UNSAFE_THRESHOLD && !anomaly.flagged olarak hesaplanır. Hiçbir data sağlanmadığında, risk puanı to adresindeki dağıtılmış bytecode üzerinden hesaplanır, böylece bir sözleşmeye yapılan salt değer transferi de puanlanır.

safe bayrağı tavsiye niteliğindedir. Precompile'lar kendi başlarına hiçbir şeyi engellemez. Kendi politikanızı zincir dışında belirleyin ve uygulayın (ve bir sözleşme, zincir üzerinde level üzerinde require çağrısı yapabilir). RISK_LEVEL_UNSAFE_THRESHOLD dışa aktarılır, böylece SDK'nin belgelediği aynı varsayılana başvurabilirsiniz.

Yapı taşları

import { aiRiskScore, aiAnomalyCheck } from "@qorechain/evm";

// Risk score for raw calldata (accepts a 0x-hex string or a Uint8Array).
const { score, level } = await aiRiskScore(publicClient, "0xa9059cbb...");

// Anomaly check for a (sender, amount) pair.
const { anomalyScore, flagged } = await aiAnomalyCheck(
  publicClient,
  "0xYourAddress",
  1_000_000_000_000_000_000n, // 1 QOR in wei
);

Her ikisi de çağrıyı viem'in encodeFunctionData'sıyla kodlar ve döndürülen tuple'ı decodeFunctionResult ile çözer.

Adres sabitleri

import { AI_RISK_SCORE_ADDRESS, AI_ANOMALY_CHECK_ADDRESS } from "@qorechain/evm";

Kullanılabilirlik

AI precompile'ları QoreChain ağ düğümlerinde bulunur. Düz bir EVM düğümünde çağrılar bir "not available" hatası fırlatır — bu yardımcılardan herhangi birinden fırlatılan bir hatayı "bu düğümde özellik mevcut değil" olarak değerlendirin.

Tam precompile listesi için EVM kılavuzuna ve çalıştırılabilir ai-preflight örneğine bakın.