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

SVM ガイド

@qorechain/svm は QoreChain の Solana 互換 JSON-RPC 向けの、 @solana/web3.js 上に構築された 薄く型安全なアダプターです。@solana/web3.js はピア依存です。このパッケージは SVM RPC エンドポイントを対象とするクライアントファクトリ、鍵ヘルパー、型付き読み取り ラッパー、SOL 送金の構築/署名/送信、最小限のネイティブプログラム命令ビルダーを追加します。

npm i @qorechain/svm @solana/web3.js
SVM のトランザクション送信は無効です

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(localhost の 8899)に依存することもできます。

鍵​

導出した SVM 秘密鍵から @solana/web3.js の Keypair を再構築したり、 アドレスを出力したりします:

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

プログラム​

一般的なネイティブプログラム向けのビルダーと、汎用の invoke ビルダー:

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 サンプルを参照してください。