メインコンテンツまでスキップ

AI プリフライトガイド

QoreChain は、dApp が EVM から読み取れるオンチェーンの AI リスク/異常検知モデルを定義しています。 2 つの読み取り専用 EVM プリコンパイルにより、eth_call だけを使って、 トランザクションが署名またはブロードキャストされる前にスコアリングできるようになることを意図しています。

機能プリコンパイルアドレス
calldata のリスクスコアaiRiskScore(bytes)0x0000000000000000000000000000000000000b01
(sender, amount) の異常チェックaiAnomalyCheck(address,uint256)0x0000000000000000000000000000000000000b02
現在、公開ネットワークでは利用できません

simulateWithRiskScore、aiRiskScore、aiAnomalyCheck は 0x…0B01 / 0x…0B02 のプリコンパイルを読み取ります。静的プリコンパイルは、そのアドレスが EVM モジュールの active_static_precompiles パラメーターに含まれている場合にのみ応答します。そのリストは qorechain-vladi(メインネット)では空で、qorechain-diana(テストネット)にあるのは PQC と コンセンサスパラメーターのプリコンパイル(0x…0A01、0x…0A02、0x…0C01)だけで、AI の2つは含まれていません (2026 年 10 月 27 日に確認)。公開 エンドポイントに対しては、呼び出しは空のデータ(0x)を返し、これらのヘルパーはエラーをスローします(例: returned no data ("0x"))。プリコンパイルが有効化されているネットワークまたはノードでのみ動作します。 まず GET /cosmos/evm/vm/v1/params を確認し、 EVM プリコンパイル: ネットワークの状況を参照してください。

実装は @qorechain/evm(viem 上の EVM アダプター)にあり、検出を容易にするため @qorechain/sdk から再エクスポートされています。

リスクの level は、よりリスクの高いトランザクションほど高くなります。チェーンのサンプルポリシーでは require(level < 3) を使用しています。

ワンコールのプリフライト​

simulateWithRiskScore は、ガス見積もり、リスクスコア、異常チェックを 1 つのアドバイザリ判定に まとめます。

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 は risk.level < RISK_LEVEL_UNSAFE_THRESHOLD && !anomaly.flagged として計算され、 しきい値はデフォルトで 3 です。data が指定されていない場合、リスクスコアは to にデプロイされた バイトコードに対して計算されるため、コントラクトへの単純な value 送金もスコアリングされます。

safe フラグはアドバイザリです。 プリコンパイル自体は何もブロックしません。独自のポリシーを オフチェーンで設定して適用してください(また、コントラクトはオンチェーンで level に対して require できます)。RISK_LEVEL_UNSAFE_THRESHOLD はエクスポートされているため、SDK が文書化している のと同じデフォルト値を参照できます。

構成要素​

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

どちらも viem の encodeFunctionData で呼び出しをエンコードし、decodeFunctionResult で 返されたタプルをデコードします。

アドレス定数​

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

利用可能性​

ヘルパーは、クエリ先のノードでプリコンパイルが有効でない場合は常にエラーをスローします。 公開ネットワークでは現在それが常に当てはまり、通常の EVM ノードでも同様です。 これらのヘルパーのいずれかからスローされたエラーは、「このノードに機能が存在しない」と みなしてください。

完全なプリコンパイル一覧については EVM ガイド を、実行可能なサンプルについては ai-preflight サンプル を 参照してください。