Guida al pre-flight AI
QoreChain definisce un modello AI on-chain di rischio/anomalia che una dApp può leggere
dall'EVM. Due precompile EVM in sola lettura sono pensati per permetterti di assegnare un punteggio a una transazione
prima che venga firmata o trasmessa, usando nient'altro che eth_call:
| Capacità | Precompile | Indirizzo |
|---|---|---|
| Punteggio di rischio per calldata | aiRiskScore(bytes) | 0x0000000000000000000000000000000000000b01 |
Controllo anomalia per (sender, amount) | aiAnomalyCheck(address,uint256) | 0x0000000000000000000000000000000000000b02 |
simulateWithRiskScore, aiRiskScore e aiAnomalyCheck leggono i precompile a
0x…0B01 / 0x…0B02. Un precompile statico risponde solo se il suo indirizzo è nel
parametro active_static_precompiles del modulo EVM. Quell'elenco è vuoto su
qorechain-vladi (mainnet), e su qorechain-diana (testnet) contiene solo i precompile PQC
e dei parametri di consenso (0x…0A01, 0x…0A02, 0x…0C01), non la coppia AI
(verificato il 27 ottobre 2026). Sugli endpoint
pubblici una chiamata restituisce dati vuoti (0x) e questi helper generano un errore (ad esempio
returned no data ("0x")). Funzionano solo su una rete o un nodo in cui i
precompile sono stati attivati. Controlla prima GET /cosmos/evm/vm/v1/params, e vedi
Precompile EVM: stato della rete.
L'implementazione si trova in @qorechain/evm (l'adapter EVM sopra
viem) ed è riesportata da @qorechain/sdk per facilitarne la scoperta.
Il
leveldi rischio è più alto per le transazioni più rischiose. La policy di esempio della chain usarequire(level < 3).
Pre-flight con una sola chiamata
simulateWithRiskScore raggruppa una stima del gas, un punteggio di rischio e un controllo
di anomalia in un unico verdetto consultivo:
import { createEvmClient, simulateWithRiskScore } from "@qorechain/evm";
const { publicClient } = await createEvmClient({
endpoints: { evmRpc: "https://evm-testnet.qore.host" },
});
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 è calcolato come risk.level < RISK_LEVEL_UNSAFE_THRESHOLD && !anomaly.flagged,
dove la soglia ha come valore predefinito 3. Quando non viene fornito alcun data, il punteggio di rischio viene
calcolato sul bytecode distribuito a to, quindi anche un semplice trasferimento di valore verso un
contratto riceve comunque un punteggio.
Il flag
safeè consultivo. I precompile non bloccano nulla di per sé. Imposta e applica la tua policy off-chain (e un contratto può usarerequiresul livello on-chain).RISK_LEVEL_UNSAFE_THRESHOLDè esportato così puoi fare riferimento allo stesso valore predefinito documentato dall'SDK.
I componenti di base
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
);
Entrambi codificano la chiamata con encodeFunctionData di viem e decodificano la tupla
restituita con decodeFunctionResult.
Costanti di indirizzo
import { AI_RISK_SCORE_ADDRESS, AI_ANOMALY_CHECK_ADDRESS } from "@qorechain/evm";
Disponibilità
Gli helper generano un errore ogni volta che i precompile non sono attivi sul nodo che interroghi: sulle reti pubbliche al momento è sempre così, e lo stesso vale per un normale nodo EVM. Tratta un errore generato da uno qualsiasi di questi helper come "feature non presente su questo nodo".
Consulta la guida EVM per l'elenco completo dei precompile, e l'esempio
eseguibile ai-preflight.