본문으로 건너뛰기

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 예제를 참고하세요.