دليل الفحص المُسبق بالذكاء الاصطناعي

تُعرِّف QoreChain نموذج مخاطر/شذوذ بالذكاء الاصطناعي على السلسلة يمكن لأي dApp قراءته من EVM. يُقصَد من precompiletين للقراءة فقط في EVM أن تتيحا لك تقييم معاملة قبل توقيعها أو بثها، باستخدام eth_call فقط لا غير:

القدرة	precompile	العنوان
درجة مخاطر لـ calldata	aiRiskScore(bytes)	0x0000000000000000000000000000000000000B01
فحص شذوذ لـ (sender, amount)	aiAnomalyCheck(address,uint256)	0x0000000000000000000000000000000000000B02

غير متاحة على الشبكات العامة اليوم

تقرأ simulateWithRiskScore وaiRiskScore وaiAnomalyCheck الـ precompiles عند 0x…0B01 / 0x…0B02. لا يستجيب precompile ثابت إلا إذا كان عنوانه ضمن معامل active_static_precompiles في وحدة EVM، وهذه القائمة فارغة على كل من qorechain-vladi (الشبكة الرئيسية) وqorechain-diana (شبكة الاختبار). وعند الاستدعاء على نقاط النهاية العامة تُرجِع المكالمة بيانات فارغة (0x) وتُطلق هذه المساعِدات خطأً (مثل returned no data ("0x")). وهي تعمل فقط على شبكة أو عقدة جرى فيها تفعيل الـ precompiles. تحقّق أولًا من GET /cosmos/evm/vm/v1/params، وانظر precompiles في EVM: حالة الشبكة.

يوجد التنفيذ في @qorechain/evm (محوّل EVM فوق viem) ويُعاد تصديره من @qorechain/sdk لتسهيل الاكتشاف.

تكون قيمة level للمخاطر أعلى للمعاملات الأكثر خطورة. سياسة المثال في السلسلة تستخدم require(level < 3).

فحص مُسبق باستدعاء واحد

تجمع simulateWithRiskScore تقدير الـ gas ودرجة المخاطر وفحص الشذوذ في حُكم استشاري واحد:

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، بحيث يُقيَّم حتى تحويل قيمة بسيط إلى عقد.

علم safe استشاري. لا تحجب precompiles أي شيء من تلقاء نفسها. اضبط سياستك الخاصة وافرضها خارج السلسلة (ويمكن لعقد أن يستخدم 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
);

يرمّز كلاهما الاستدعاء باستخدام encodeFunctionData من viem ويفكّ الصف (tuple) المُرجَع باستخدام decodeFunctionResult.

ثوابت العناوين

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

التوفّر

تُطلق المساعِدات خطأً كلما لم تكن الـ precompiles مفعّلة على العقدة التي تستعلم عنها: وعلى الشبكات العامة يحدث ذلك حاليًا دائمًا، وكذلك على عقدة EVM عادية. عامل أي خطأ مُطلَق من أي من هذه المساعِدات على أنه "الميزة غير موجودة على هذه العقدة".

راجع دليل EVM للحصول على قائمة precompiles الكاملة، والمثال القابل للتشغيل ai-preflight.