دليل SVM
@qorechain/svm هو محوّل رقيق وآمن من حيث الأنواع فوق
@solana/web3.js لـ JSON-RPC
المتوافق مع Solana في QoreChain. إنّ @solana/web3.js اعتمادية نظيرة. تضيف
الحزمة مصنع عميل يستهدف نقطة نهاية SVM RPC، ومساعدات المفاتيح، وأغلفة قراءة
مُصنّفة، وبناء/توقيع/إرسال تحويل SOL، وبناة تعليمات الأوامر الأصلية الأدنى.
npm i @qorechain/svm @solana/web3.js
مسار تنفيذ SVM معطَّل على مستوى الشبكة بأكملها لإرسال المعاملات
(code 11, "SVM module is disabled")، ونقاط نهاية SVM RPC العامة للقراءة فقط.
تعمل عمليات القراءة (getBalance وgetAccountInfo وgetSlot و
getSignaturesForAddress وgetMinimumBalanceForRentExemption و
getLatestBlockhash). لا تبنِ تدفق تحويل أو نشر برامج على SVM بعد: فمساعدات
البناء والتوقيع والإرسال أدناه هي واجهة مكتبة العميل ولا يمكنها اليوم إدراج
معاملة على الشبكات العامة. انظر
تطوير SVM.
إنشاء عميل
import { createSvmClient } from "@qorechain/svm";
const client = createSvmClient({
endpoints: { svmRpc: "https://svm-testnet.qore.host" }, // mainnet: https://svm.qore.host
});
يمكنك أيضًا تمرير rpcUrl، أو connection موجود، أو الاعتماد على
DEFAULT_SVM_RPC_URL (المضيف المحلي 8899).
المفاتيح
أعد بناء Keypair الخاص بـ @solana/web3.js من مفتاح SVM السرّي المشتقّ، أو
اطبع عنوانًا:
import { deriveSvmAccount } from "@qorechain/sdk";
import { svmKeypairFromSecretKey, svmAddress } from "@qorechain/svm";
const account = await deriveSvmAccount(mnemonic);
const keypair = svmKeypairFromSecretKey(account.secretKey);
console.log(svmAddress(keypair)); // base58
تحويل SOL
ابنِ تحويلًا غير موقّع (دون اتصال). يُعرض الإرسال للاكتمال فحسب، ولا يمكن أن ينجح على الشبكات العامة ما دام مسار معاملات SVM معطَّلًا:
import { LAMPORTS_PER_SOL, PublicKey } from "@solana/web3.js";
const lamports = Math.round(0.01 * LAMPORTS_PER_SOL);
const recipient = new PublicKey("<recipient base58 address>"); // `to` is a PublicKey, not a string
// Build only (no broadcast):
const tx = client.buildTransferSol({ from: keypair, to: recipient, lamports });
// Or build + sign + send + confirm in one call:
// const sig = await client.transferSol({ from: keypair, to: recipient, lamports });
// Send an arbitrary transaction:
// const sig = await client.sendTransaction(tx, [keypair]);
// Simulate without submitting:
// const sim = await client.simulateTransaction(tx);
الأوامر (Programs)
بناة للأوامر الأصلية الشائعة إضافةً إلى باني استدعاء عام:
import {
createMemoInstruction,
createTransferTokenInstruction,
createAssociatedTokenAccountInstruction,
getAssociatedTokenAddress,
createInvokeInstruction,
PROGRAM_IDS,
SYSTEM_PROGRAM_ID,
TOKEN_PROGRAM_ID,
ASSOCIATED_TOKEN_PROGRAM_ID,
MEMO_PROGRAM_ID,
} from "@qorechain/svm";
// Attach a memo to a transaction.
tx.add(createMemoInstruction("hello from @qorechain/svm", [keypair.publicKey]));
// SPL-Token transfer, ATA creation, and a generic program invoke are also
// available via the builders above.
انظر مثال svm-transfer للحصول على نسخة قابلة للتشغيل.