Guide de pré-vérification IA
QoreChain définit un modèle de risque/anomalie IA sur la chaîne qu'une dApp peut lire
depuis l'EVM. Deux précompilés EVM en lecture seule sont destinés à vous permettre de noter une transaction
avant qu'elle ne soit signée ou diffusée, en utilisant uniquement eth_call :
| Capacité | Précompilé | Adresse |
|---|---|---|
| Score de risque pour les données d'appel | aiRiskScore(bytes) | 0x0000000000000000000000000000000000000b01 |
Vérification d'anomalie pour (sender, amount) | aiAnomalyCheck(address,uint256) | 0x0000000000000000000000000000000000000b02 |
simulateWithRiskScore, aiRiskScore et aiAnomalyCheck lisent les précompilés à
0x…0B01 / 0x…0B02. Un précompilé statique ne répond que si son adresse figure dans le
paramètre active_static_precompiles du module EVM. Cette liste est vide sur
qorechain-vladi (mainnet), et sur qorechain-diana (testnet) elle ne contient que les
précompilés PQC et de paramètres de consensus (0x…0A01, 0x…0A02, 0x…0C01), pas la paire IA
(vérifié le 27 octobre 2026). Sur les points de terminaison
publics, un appel renvoie des données vides (0x) et ces assistants lèvent une erreur (par exemple
returned no data ("0x")). Ils ne fonctionnent que sur un réseau ou un nœud où les
précompilés ont été activés. Vérifiez d'abord GET /cosmos/evm/vm/v1/params, et voir
Précompilés EVM : état du réseau.
L'implémentation se trouve dans @qorechain/evm (l'adaptateur EVM au-dessus de
viem) et est réexportée depuis @qorechain/sdk à des fins de découverte.
Le
levelde risque est plus élevé pour les transactions plus risquées. La politique d'exemple de la chaîne utiliserequire(level < 3).
Pré-vérification en un seul appel
simulateWithRiskScore regroupe une estimation de gaz, un score de risque et une vérification
d'anomalie en un seul verdict consultatif :
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 est calculé comme risk.level < RISK_LEVEL_UNSAFE_THRESHOLD && !anomaly.flagged,
où le seuil vaut par défaut 3. Lorsqu'aucune data n'est fournie, le score de risque est
calculé sur le bytecode déployé à to, de sorte qu'un simple transfert de valeur vers un
contrat est tout de même noté.
L'indicateur
safeest consultatif. Les précompilés ne bloquent rien par eux-mêmes. Définissez et appliquez votre propre politique hors chaîne (et un contrat peut fairerequiresur le niveau sur la chaîne).RISK_LEVEL_UNSAFE_THRESHOLDest exporté afin que vous puissiez référencer la même valeur par défaut que celle documentée par le SDK.
Les éléments de 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
);
Les deux encodent l'appel avec encodeFunctionData de viem et décodent le tuple
retourné avec decodeFunctionResult.
Constantes d'adresse
import { AI_RISK_SCORE_ADDRESS, AI_ANOMALY_CHECK_ADDRESS } from "@qorechain/evm";
Disponibilité
Les assistants lèvent une erreur dès que les précompilés ne sont pas actifs sur le nœud que vous interrogez : sur les réseaux publics, c'est actuellement toujours le cas, ainsi que sur un nœud EVM ordinaire. Traitez une erreur levée par l'un de ces assistants comme « fonctionnalité absente sur ce nœud ».
Voir le guide EVM pour la liste complète des précompilés, et
l'exemple ai-preflight exécutable.