Aller au contenu principal

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'appelaiRiskScore(bytes)0x0000000000000000000000000000000000000b01
Vérification d'anomalie pour (sender, amount)aiAnomalyCheck(address,uint256)0x0000000000000000000000000000000000000b02
Non disponible aujourd'hui sur les réseaux publics

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 level de risque est plus élevé pour les transactions plus risquées. La politique d'exemple de la chaîne utilise require(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 safe est 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 faire require sur le niveau sur la chaîne). RISK_LEVEL_UNSAFE_THRESHOLD est 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.