SVM 개발

QoreChain에는 Solana Virtual Machine(SVM) 실행 환경이 포함되어 있어, 개발자가 익숙한 Solana 툴링을 사용해 SBF/BPF 프로그램을 배포하고 실행할 수 있습니다. SVM 모듈은 8899번 포트에서 Solana 호환 JSON-RPC 인터페이스를 노출하며, 이는 qorechaind start가 자동으로 실행합니다(아래 JSON-RPC 서버 참고).

노트

아래 명령은 2026년 6월 7일부터 가동 중이며 체인 버전 v3.1.97를 실행하는 qorechain-vladi 메인넷을 기준으로 합니다. 테스트넷의 경우 --chain-id qorechain-diana로 대체하세요.

SVM 트랜잭션 제출이 현재 비활성화되어 있습니다

체인 버전 v3.1.89(8월 22일) 기준으로, 한 건의 사고 이후 SVM 실행 레인은 트랜잭션 제출에 대해 네트워크 전역에서 비활성화되었습니다 — x/svm으로 전송되는 모든 트랜잭션(프로그램 배포, 명령어 실행, 계정 생성, 전송)은 code 11, "SVM module is disabled"를 반환합니다. 이는 여러분 자신의 노드는 물론 공개 엔드포인트에도 동일하게 적용됩니다. 읽기 성격의 RPC 메서드는 계속 응답할 수 있지만, 이 레인이 다시 열리기 전까지는 실제 SVM 연동을 구축하거나 리허설하지 마세요 — 이는 런타임 매개변수가 아니라 컴파일 타임에 이루어진 비활성화이므로 거버넌스 투표로 다시 켤 수 없으며, 외부 감사에서 승인이 날 때까지 비활성 상태를 유지할 것으로 예상됩니다.

개요

x/svm 모듈은 다음을 제공합니다.

네이티브 QOR을 1급 SVM 자산으로 지원 — 계정의 통합 잔액이 lamport 단위로 표시됩니다
SBF/BPF 프로그램 배포 및 실행
데이터 계정 생성 및 관리
Solana 호환 JSON-RPC 엔드포인트
QoreChain 주소 형식과 Solana 주소 형식 간의 양방향 주소 매핑
컴퓨트 예산 계측 및 렌트 기반 스토리지 경제 모델

SVM 인터페이스상의 네이티브 QOR

체인 버전 v3.1.82 기준으로, SVM 인터페이스는 별도의 샌드박스 잔액이 아니라 1급 네이티브-QOR 인터페이스입니다. Cosmos 인터페이스에서는 uqor로, EVM에서는 18진법 wei로 보이는 것과 같은 자금인 계정의 단일 통합 잔액이, SVM 쪽에서는 lamport(9자리 소수점) 단위로 표시됩니다.

1 uqor = 1,000 lamports    ·    1 QOR = 1,000,000,000 lamports

getBalance / getAccountInfo 는 계정의 네이티브 QOR(단위: lamport)을 반환합니다.
getSignaturesForAddress 는 특정 주소와 관련된 트랜잭션 이력을 반환하며, 표준 Solana 툴링으로 입금 감지에 활용할 수 있습니다.
System Program 전송은 네이티브 QOR을 이동시킵니다 — Solana 방식의 전송 명령어는 Cosmos MsgSend나 EVM 전송과 동일한 자금을 이동시킵니다.
SVM 주소 형식 — 계정의 SVM 주소는 20바이트 계정 바이트를 32바이트로 오른쪽 패딩한 뒤 base58로 인코딩한 것입니다. 세 가지 주소 형식(qor1..., 0x..., base58) 모두 동일한 계정을 가리킵니다.

공개 엔드포인트(https://svm.qore.host, https://svm-testnet.qore.host)는 읽기 전용입니다 — 트랜잭션 제출은 엣지 단에서 비활성화되어 있습니다. 평상시라면 SVM 트랜잭션을 제출하기 위해 자체 노드(8899번 포트)를 운영하겠지만, 위의 주의 사항을 참고하세요 — x/svm 트랜잭션 레인 자체가 여러분 자신의 노드를 포함해 현재 네트워크 전역에서 비활성화되어 있습니다.

JSON-RPC 서버

Solana 호환 JSON-RPC 서버는 qorechaind start에 의해 시작되며 기본적으로 활성화되어 있습니다. app.toml의 [svm-rpc] 섹션을 통해 설정합니다.

[svm-rpc]
# Enable the Solana-compatible JSON-RPC server
enable = true
# Address the server listens on
address = "127.0.0.1:8899"

기본값은 enable = true, address = "127.0.0.1:8899"이므로, 새로 시작한 노드는 이미 8899번 포트에서 Solana JSON-RPC 인터페이스를 제공합니다 — 별도 설정 없이 @solana/web3.js가 http://127.0.0.1:8899로 연결할 수 있습니다. getVersion은 1.18.0-qorechain을 보고하며, getBalance / getAccountInfo는 실제 온체인 SVM 계정을 반환합니다.

속성	값
기본 URL	`http://127.0.0.1:8899`
활성화 여부	예, 기본적으로 활성화됨
실행 주체	`qorechaind start`
호환성	Solana JSON-RPC (부분 지원)
`getVersion`	`1.18.0-qorechain`

지원되는 메서드

메서드	설명
`getAccountInfo`	계정 데이터와 lamport 잔액 조회
`getBalance`	lamport 단위(네이티브 QOR) 계정 잔액 조회
`getSignaturesForAddress`	특정 주소의 트랜잭션 이력
`getSlot`	현재 슬롯 번호
`getMinimumBalanceForRentExemption`	특정 데이터 크기에 필요한 최소 잔액
`getVersion`	SVM 런타임 버전 정보
`getHealth`	SVM 엔드포인트 상태 확인

프로그램 배포 및 상호작용

정보

최신화된 SBF 실행. SVM 실행 엔진은 solana-sbpf 0.21.1로 최신화되어, 현재 Solana 툴체인(platform-tools v1.53 / agave 4.x)으로 새로 컴파일한 SBF 프로그램이 QoreChain에서 배포와 실행이 모두 가능합니다 — 실행이 완전히 지원되며, 배포만 가능한 것이 아닙니다. cargo build-sbf --arch v0 또는 --arch v3로 빌드한 프로그램 모두 지원됩니다.

SBF 프로그램 배포 — 현재 platform-tools(v1.53 / agave 4.x)로 Solana 프로그램을 SBF 공유 객체로 컴파일한 뒤 QoreChain에 배포합니다.

# Build with the current Solana toolchain (--arch v0 or --arch v3)
cargo build-sbf --arch v3

# Deploy the compiled program
qorechaind tx svm deploy-program ./my_program.so \
  --from mykey \
  --gas auto \
  --gas-adjustment 1.3 \
  -y

트랜잭션 응답에는 base58 형식의 프로그램 ID가 포함됩니다.

명령어 실행 — 명령어 데이터와 함께 온체인 BPF 프로그램을 호출합니다.
```
# Execute instruction
qorechaind tx svm execute <program-id-base58> <data-hex> \
  --from mykey \
  --gas auto \
  -y
```
매개변수 형식 설명
program-id-base58 Base58 문자열 배포된 프로그램의 주소
data-hex 16진수로 인코딩된 바이트 직렬화된 명령어 데이터
데이터 계정 생성 — 프로그램은 상태를 저장할 계정을 필요로 하는 경우가 많습니다. 지정한 크기와 소유자로 계정을 하나 생성합니다.
```
# Create data account
qorechaind tx svm create-account <owner-base58> <space> <lamports> \
  --from mykey \
  --gas auto \
  -y
```
매개변수 설명
owner-base58 이 계정을 소유하는 프로그램(base58)
space 데이터 필드의 크기(바이트)
lamports 초기 잔액(렌트 면제 최소값을 충족해야 함)

특정 크기에 대한 최소 렌트 면제 잔액을 조회합니다.
```
# RPC: getMinimumBalanceForRentExemption
curl -X POST http://localhost:8899 \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getMinimumBalanceForRentExemption",
    "params": [1024]
  }'
```

매개변수	형식	설명
`program-id-base58`	Base58 문자열	배포된 프로그램의 주소
`data-hex`	16진수로 인코딩된 바이트	직렬화된 명령어 데이터

매개변수	설명
`owner-base58`	이 계정을 소유하는 프로그램(base58)
`space`	데이터 필드의 크기(바이트)
`lamports`	초기 잔액(렌트 면제 최소값을 충족해야 함)

@solana/web3.js 사용하기 — Solana JavaScript SDK는 QoreChain SVM 엔드포인트와 바로 동작합니다.

import { Connection, PublicKey } from "@solana/web3.js";

const connection = new Connection("http://127.0.0.1:8899");

// Check health
const health = await connection.getHealth();
console.log("SVM health:", health);

// Get slot
const slot = await connection.getSlot();
console.log("Current slot:", slot);

// Get account info
const pubkey = new PublicKey("YourBase58ProgramId...");
const accountInfo = await connection.getAccountInfo(pubkey);
console.log("Account data:", accountInfo);

// Get balance
const balance = await connection.getBalance(pubkey);
console.log("Balance (lamports):", balance);

주소 매핑

QoreChain은 네이티브 Bech32 주소(qor1...)와 Solana 방식의 base58 주소 사이에 양방향 주소 매핑을 유지합니다.

방향	예시
네이티브 → SVM	`qor1abc...xyz`가 결정론적인 base58 주소로 매핑됩니다
SVM → 네이티브	base58 프로그램 주소가 대응하는 `qor1...` 주소로 다시 매핑됩니다

이 매핑은 결정론적이며 x/svm 모듈이 관리합니다. 두 표현 모두 동일한 기반 계정을 가리킵니다.

렌트 모델

SVM 모듈은 상태 비대화를 방지하기 위해 렌트 기반 스토리지 모델을 사용합니다.

매개변수	값
연간 바이트당 lamport	`3,480`
렌트 면제 배수	`2.0`
징수 주기	에포크마다

잔액이 2 * (data_size * 3480 / seconds_per_year)(lamport)를 초과하는 계정은 렌트가 면제되며 절대 과금되지 않습니다.
렌트 면제 기준치 미만인 계정은 매 에포크마다 렌트가 부과됩니다. 잔액이 0에 도달하면 해당 계정은 제거됩니다.

정보

모범 사례: 예기치 않은 계정 삭제를 피하려면 데이터 계정에는 항상 렌트 면제 최소값 이상을 채워 두세요.

컴퓨트 예산

각 명령어 실행은 컴퓨트 유닛으로 계측됩니다.

매개변수	값
명령어당 최대 컴퓨트 유닛	`1,400,000`
최대 CPI(교차 프로그램 호출) 깊이	`4`
최대 프로그램 크기	`10 MB`
최대 계정 데이터 크기	`10 MB`

컴퓨트 예산을 초과하는 프로그램은 중단되며 해당 트랜잭션은 되돌려집니다.

매개변수 요약

매개변수	값
`max_program_size`	10 MB
`max_account_data_size`	10 MB
`compute_budget_max`	1,400,000 CU
`max_cpi_depth`	4
`lamports_per_byte_year`	3,480
`rent_exemption_multiplier`	2.0
JSON-RPC 포트	8899

크로스-VM 상호운용성

SVM 프로그램은 비동기 크로스-VM 메시지 경로를 통해 EVM 및 CosmWasm 컨트랙트와 통신할 수 있습니다.

# Cross-VM call example
qorechaind tx crossvm call \
  --source-vm svm \
  --target-vm evm \
  --target-contract 0x1234...abcd \
  --payload '...' \
  --from mykey \
  -y

메시지는 큐에 쌓였다가 EndBlocker에 의해 처리됩니다. 메시지 생명 주기와 타임아웃 동작에 대한 자세한 내용은 크로스-VM 상호운용성을 참고하세요.

다음 단계

크로스-VM 상호운용성 — SVM, EVM, CosmWasm 간의 통신
EVM 개발 — QoreChain에서의 Solidity 스마트 컨트랙트
CosmWasm 개발 — Rust 기반 WebAssembly 컨트랙트

개요​

SVM 인터페이스상의 네이티브 QOR​

JSON-RPC 서버​

지원되는 메서드​

프로그램 배포 및 상호작용​

주소 매핑​

렌트 모델​

컴퓨트 예산​

매개변수 요약​

크로스-VM 상호운용성​

다음 단계​

개요