Passa al contenuto principale

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àPrecompileIndirizzo
Punteggio di rischio per calldataaiRiskScore(bytes)0x0000000000000000000000000000000000000b01
Controllo anomalia per (sender, amount)aiAnomalyCheck(address,uint256)0x0000000000000000000000000000000000000b02
Non disponibile oggi sulle reti pubbliche

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 level di rischio è più alto per le transazioni più rischiose. La policy di esempio della chain usa require(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ò usare require sul 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.