Guía de verificación previa con IA

QoreChain es la primera red que expone un modelo de riesgo/anomalías de IA en la cadena a cualquier dApp. Dos precompilados EVM de solo lectura te permiten puntuar una transacción antes de que se firme o se difunda, usando únicamente eth_call:

Capacidad	Precompilado	Dirección
Puntuación de riesgo para los datos de llamada	aiRiskScore(bytes)	0x0000000000000000000000000000000000000B01
Comprobación de anomalías para (sender, amount)	aiAnomalyCheck(address,uint256)	0x0000000000000000000000000000000000000B02

La implementación vive en @qorechain/evm (el adaptador EVM sobre viem) y se reexporta desde @qorechain/sdk para su descubrimiento.

El level de riesgo es más alto para las transacciones más arriesgadas. La política de ejemplo de la cadena usa require(level < 3).

Verificación previa en una sola llamada

simulateWithRiskScore agrupa una estimación de gas, una puntuación de riesgo y una comprobación de anomalías en un único veredicto orientativo:

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 se calcula como risk.level < RISK_LEVEL_UNSAFE_THRESHOLD && !anomaly.flagged, donde el umbral por defecto es 3. Cuando no se proporciona ningún data, la puntuación de riesgo se calcula sobre el bytecode desplegado en to, de modo que una mera transferencia de valor a un contrato también se puntúa.

El indicador safe es orientativo. Los precompilados no bloquean nada por sí mismos. Define y aplica tu propia política fuera de la cadena (y un contrato puede usar require sobre el nivel en la cadena). RISK_LEVEL_UNSAFE_THRESHOLD se exporta para que puedas referenciar el mismo valor por defecto que documenta el SDK.

Los componentes básicos

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
);

Ambos codifican la llamada con encodeFunctionData de viem y decodifican la tupla devuelta con decodeFunctionResult.

Constantes de dirección

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

Disponibilidad

Los precompilados de IA existen en los nodos de la red QoreChain. En un nodo EVM normal las llamadas lanzan un error "not available": trata un error lanzado por cualquiera de estos ayudantes como "feature not present on this node".

Consulta la guía de EVM para ver la lista completa de precompilados, y el ejemplo ejecutable ai-preflight.