初めてのトランザクション
このガイドでは、QORトークンの送信、トランザクションの照会、そしてQoreChainのネイティブ、EVM、SVMの各インターフェースとの対話について説明します。
以下のコマンドは**qorechain-dianaテストネット(EVMチェーンID 9800)を使用しています。メインネット(qorechain-vladi**、EVMチェーンID 9801)は2026年6月7日から稼働しており、2026年11月12日からリリースv3.2.7を実行しています(テストネットは2026年11月12日からv3.2.8を実行しています) — メインネット上で取引する場合は、メインネットへの接続ページに記載のメインネットのチェーンIDとエンドポイントに置き換えてください。
残高の確認
トークンを送信する前に、アカウント残高を確認します。
qorechaind query bank balances qor1youraddress... --output json
レスポンスには、アカウントが保有するすべてのトークンデノミネーションが含まれます。QOR残高はuqor(マイクロQOR)で表示され、1 QOR = 1,000,000 uqorです。
QORの送信
QoreChainのアカウントは、Cosmosレーン上でハイブリッド署名を使って送信します。これは、クラシックなsecp256k1署名にML-DSA-87(Dilithium-5)署名を加えたものです。通常のqorechaind tx bank send ... -yは拒否されるため、送金は未署名の状態で構築し、その後に共署名します。アカウントにポスト量子鍵を一度登録しておく必要があります(下記のポスト量子鍵を登録するを参照)。また、download.qore.hostの公式qorechaindリリースバイナリを使用する必要があります(公開ソースツリーからビルドしたバイナリでは、Dilithium署名の作成も適用もできません)。
# 1. Build the unsigned transaction (the fee is fixed here, because cosign signs the fee in this file)
qorechaind tx bank send mykey qor1recipient... 1000000uqor \
--chain-id qorechain-diana \
--gas 400000 --fees 60000uqor \
--generate-only > tx.json
# 2. Add the ML-DSA-87 signature and broadcast
qorechaind tx pqc cosign tx.json --from mykey --pqc-key mypqc --chain-id qorechain-diana
これにより、1 QOR(1,000,000 uqor)が受取アドレスに送金され、60,000 uqor(0.06 QOR)の手数料が支払われます。ネットワークの下限はガス1単位あたり0.1 uqorであるため、手数料はガス上限に0.1を掛けた額以上でなければなりません。つまり--gas 400000には--fees 40000uqor以上が必要です。この例では、ガス1単位あたり0.15 uqor(--fees 60000uqor)を支払っています。v3.2.8 からメモリプールはガス1単位あたりの手数料でトランザクションを順序付けるため、下限ちょうどを支払う送金は、ブロックが混み合っているときに他のトランザクションの後ろで待たされます。署名によってトランザクションに約4.7 KBが加わるため、ハイブリッド署名の送金は通常160,000〜240,000ガスを使用します。cosignは、ネットワークがどの署名対象バイト形式を検証するかをノードに問い合わせるため、同じコマンドが両方のネットワークで動作します。
ポスト量子鍵を登録する
ポスト量子鍵は、アカウントごとに一度、明示的に登録します。チェーンが最初のトランザクション時に自動で登録することはありません。登録トランザクション自体(および鍵のマイグレーション)は、新規アカウントでもブートストラップできるよう、クラシック鍵のみで署名できます。
# generate the ML-DSA-87 key (stored under ~/.qorechaind/pqc/mypqc.dilithium, mode 0600, not encrypted)
qorechaind tx pqc gen-key mypqc
# register the printed public key for your account
qorechaind tx pqc register-key <public_key_hex> hybrid --from mykey \
--chain-id qorechain-diana --gas 600000 --fees 90000uqor
v3.2.3以降、チェーンは登録時にオプションの所有証明も受け付け、脆弱な鍵、縮退した鍵、すでに使用済みの鍵を拒否します。所有証明を添付するには、register-key-v2で登録し、ローカルの鍵を指定します。
qorechaind tx pqc register-key-v2 dilithium5 <public_key_hex> hybrid --from mykey --pqc-key mypqc \
--chain-id qorechain-diana --gas 600000 --fees 90000uqor
PQC鍵ファイルは、リカバリーフレーズと同じくらい慎重にバックアップしてください。リカバリーフレーズからqorechaind tx pqc recover-keyで再導出できます。QoreXとQoreChain SDKは、鍵の登録を代行します。ハイブリッドフローの全体については、ウォレットのセットアップを参照してください。
Cosmosレーンでは、ネットワークの設定はhybrid_signature_mode = requiredです(稼働中のネットワークはv3.2ラインを実行しています)。クラシック署名のみのトランザクションは拒否されます。CLIを使わずにハイブリッド署名を生成する場合は、オープンソースのqorechain-pqcライブラリ(hybridSignBytes)およびQoreChain SDKが同等の処理をコードで行います。
共署名されたトランザクションが受理されると、CLIはトランザクションハッシュを返します。
新しいアカウントの最初のトランザクション
リリースv3.2.8(テストネットでは2026年11月12日から。メインネットでは未適用)以降、新規アカウントの最初のトランザクションは、ポスト量子鍵の登録でなければなりません。具体的には、証明付きのMsgRegisterPQCKeyV2(所有証明を含む)を、クラシック鍵のみで署名して送ります。登録済みの鍵を持たないアカウントからの、それ以外の最初のトランザクションは拒否されます。これは、入金されたもののまだ何も送信したことがない新規アカウントに適用されます。すでに登録済みの鍵を持つアカウントには影響しません。
なぜ重要か。 Cosmosレーン上の以降のトランザクションはすべてハイブリッド署名(secp256k1とML-DSA-87)で署名され、チェーンはML-DSA-87の部分を、すでに把握している鍵に対してしか検証できません。登録は、その署名をまだ付けられない唯一のトランザクションであるため、チェーンがクラシック署名のみで受け付ける唯一のトランザクションであり、必ず最初に行う必要があります。登録の前に送金、ステーキングの委任、コントラクト呼び出しを送ると、そのトランザクションは拒否されるので、先に登録してください。
鍵を登録する
CLIでは、上記のポスト量子鍵を登録すると同じようにregister-key-v2を使います(鍵は先にqorechaind tx pqc gen-key mypqcで生成しておく必要があります)。
qorechaind tx pqc register-key-v2 dilithium5 <public_key_hex> hybrid --from mykey --pqc-key mypqc \
--chain-id qorechain-diana --gas 600000 --fees 90000uqor
TypeScript SDK(0.9.0以降)では、ensurePqcRegisteredが最初に鍵のステータスを読み取り、鍵がすでに登録済みであればトランザクションを送らず、所有証明を添付し、登録をクラシック署名で自動的に送信します。
import {
createClient,
deriveNativeAccount,
directSignerFromPrivateKey,
derivePqcCanonical,
ensurePqcRegistered,
} from "@qorechain/sdk";
const client = createClient({
endpoints: { rest: "https://api-testnet.qore.host", rpc: "https://rpc-testnet.qore.host" },
});
const account = await deriveNativeAccount(mnemonic);
const signer = await directSignerFromPrivateKey(account.privateKey, "qor");
const pqcKeypair = derivePqcCanonical(account.address, mnemonic);
const tx = await client.connectTx(signer, { pqcKeypair });
const res = await ensurePqcRegistered(tx, {
pqcKeypair,
rest: client.network.endpoints.rest,
fee: { amount: [{ denom: "uqor", amount: "90000" }], gas: "600000" },
});
console.log(res.alreadyRegistered ? "already registered" : res.txHash);
メッセージだけが必要な場合(たとえば独自のトランザクションボディに組み込む場合)は、buildRegisterPqcKeyMsg(sender, { pqcKeypair, ecdsaPubkey, proofOfPossession })が、送信せずにMsgRegisterPQCKeyV2を返します。
他のSDKにも同じ冪等なヘルパーがあります。いずれも、最初にREST経由で鍵のステータスを読み取り、確認せずに登録することはありません。
| 言語 | ヘルパー |
|---|---|
| Python | qorsdk.pqc_dx.ensure_pqc_registered(account=..., pqc_keypair=..., chain_id=..., account_number=..., sequence=..., rest_url=..., fee=...) |
| Go | pqcdx.New(pqcdx.Signer{...}, pqcdx.Options{}).EnsurePQCRegistered(pqcdx.RegisterOptions{}) |
| Rust | PqcDx::ensure_pqc_registered().await |
| Java | PqcDx.ensurePqcRegistered(signer, broadcaster, qor, new PqcDx.EnsureOptions()) |
各言語のsignerの完全なセットアップについては、その言語のSDKリファレンスを参照してください。登録には手数料を支払うのに十分なQORがアカウントに必要なので、登録の前に新しいアカウントに入金してください。
署名を含めた手数料の見積もり
ハイブリッド署名はトランザクションに約4.7 KBを加え、チェーンはそのための検証手数料を課します。そのため、未署名またはクラシック署名のみのコピーから見積もった手数料は低すぎます。ハイブリッド署名を含めた状態でトランザクションをシミュレーションするか、SDKに任せてください。TypeScriptクライアントのデフォルトの手数料は"auto"で、ハイブリッドトランザクションをシミュレーションし、その結果からガス上限を設定します。
import { toBase } from "@qorechain/sdk";
// "auto" is the default: the client simulates the hybrid transaction itself.
await tx.bankSend("qor1recipientaddress...", [{ denom: "uqor", amount: toBase("1.5") }]);
| トランザクション | 一般的なガス | ガス1単位あたり0.15 uqorでの手数料の例 |
|---|---|---|
| ハイブリッド署名の送金 | 約160,000〜240,000 | 24,000〜36,000 uqor |
| 鍵の登録 | 約600,000(設定する上限) | 90,000 uqor |
テストネットでの検証。 2026年11月12日(リリースv3.2.8)に、500 QORを持つ新規のeth-nativeアカウントが、最初に登録を送信しました(SDK 0.13.0、所有証明付き、クラシック署名)。結果はコード0、上限600,000に対して使用ガス299,233、手数料90,000 uqorでした。続く最初のハイブリッド署名の送金は、上限400,000に対して187,494ガスを使用しました(手数料60,000 uqor)。トランザクションをGET /cosmos/tx/v1beta1/txs/{hash}から読み戻すと、コード0、4,627バイトのML-DSA-87署名を載せた/qorechain.pqc.v1.PQCHybridSignature拡張、およびイベントpqc_verify(hybrid_mode=required)とpqc_hybrid_verify(status=verified)が確認できました。登録が最初のトランザクションでなければならないというルールはチェーンチームから聞いたもので、他の種類のトランザクションを最初に送る試験は行っていません。
ネットワークの下限はガス1単位あたり0.1 uqorです。v3.2.8からメモリプールはガス1単位あたりの手数料でトランザクションを順序付けるため、下限より少し多めに支払うと、ブロックが混み合っているときにトランザクションが他のトランザクションの後ろで待たされるのを防げます。
登録を省略した場合の表示
| 表示される内容 | 意味 | 対処 |
|---|---|---|
アカウントに登録済みのPQC鍵がない、またはハイブリッド署名を含める必要があるという拒否(モジュールpqc、コード8。SDKはpqc_key_requiredとして報告) | アカウントにまだ登録済みの鍵がない | 上記のとおり鍵を登録してから、再度送信する |
登録がalready registeredとして拒否される(モジュールpqc、コード7) | アカウントがすでに鍵を保持している | 何もする必要はありません。GET /qorechain/pqc/v1/account/{address}で登録内容を読み取るか、ensurePqcRegisteredを使用してください(別の鍵の場合はPqcKeyMismatchErrorをスローします) |
関連ページ: SDKクイックスタート、ポスト量子署名、ウォレットのセットアップ。
トランザクションの照会
完了したトランザクションをそのハッシュで照会します。
qorechaind query tx <txhash>
出力には、トランザクションのステータス、使用ガス量、ブロック高、実行中に発生したすべてのイベントが含まれます。
JSON形式で出力する場合は次のようにします。
qorechaind query tx <txhash> --output json
JSON-RPCの使用(EVM)
QoreChainのEVM実行環境は、ポート8545で標準的なEthereum JSON-RPCインターフェースを公開しています。
標準的なEthereum署名(MetaMask、ethers.jsなど)は変更なしで引き続き動作しますが、v3.2.0以降、EVMレーンは、登録済みのポスト量子鍵と開いているEVM承認ウィンドウの両方を持つアカウントからのトランザクションのみを受け付けます。最初にウィンドウを開いてください(これはCosmosレーンのトランザクションで、ML-DSA鍵で署名します)— 下記のEVM承認ウィンドウを参照してください。ウィンドウがない場合、ノードはno open EVM authorisation windowと応答します。状態の読み取り(eth_blockNumber、eth_getBalance、eth_call、eth_estimateGas)にはウィンドウは不要です。
最新のブロック番号の取得
curl -s -X POST http://localhost:8545 \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "eth_blockNumber",
"params": [],
"id": 1
}' | jq '.result'
アカウント残高の取得
curl -s -X POST http://localhost:8545 \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "eth_getBalance",
"params": ["0xYourEVMAddress", "latest"],
"id": 1
}' | jq '.result'
残高は、最小デノミネーションでの16進エンコード値として返されます。
EVM承認ウィンドウ
チェーンリリースv3.2.0(メインネットのブロック高2,981,742、2026年9月25日。テストネットのブロック高5,920,000)以降、EVMレーンは、次の両方を満たすアカウントからのトランザクションのみを受け付けます。
- 登録済みのポスト量子鍵(ML-DSA-87)を持っていること、かつ
- そのトランザクションを受け入れる余地のある開いているEVM承認ウィンドウを持っていること。
EVMレーンのそれ以外の点は変わりません。引き続きMetaMask、ethers.js、Hardhat、Foundryで署名でき、eth_estimateGasなどのシミュレーションはウィンドウなしで動作します。コントラクトのデプロイも他のEVMトランザクションと同様に扱われるため、デプロイの前にウィンドウが必要です。
なぜウィンドウが必要なのか? 標準的なウォレットはEthereumトランザクションに対して1つのsecp256k1署名しか生成せず、アプリケーションが2つ目のポスト量子署名を添付する手段もありません。そのため、ポスト量子による承認はトランザクションの前に届けられます。ML-DSA署名を伴う通常のCosmosレーンのトランザクションで制限付きのウィンドウを開くと、EVMレーンはそのウィンドウでカバーされるトランザクションを受け付けます。クラシック鍵だけではウィンドウを開くことはできないため、盗まれたクラシック鍵がEVMレーンで動けるのは、すでに開いているウィンドウが許可する範囲内に限られます。これはapproveに似ています。上限付きのトランザクション数と上限付きのネイティブQORの金額を、期限付きで承認し、その後は通常どおり取引します。ウィンドウは、トークンの金額やコントラクトがすでに保持している承認を制限しません。
ウィンドウが制限するもの。 3つの制限が同時に適用され、最初に尽きたものがウィンドウを閉じます。
| 制限 | 意味 | 許容範囲 |
|---|---|---|
blocks | ウィンドウを開いたブロックから数えて、ウィンドウが開いている期間 | 1 – 17,280 |
max-txs | 受け付けるEVMトランザクションの数 | 1 – 1,000 |
max-value | 受け付ける総流出額(uqor単位): 送金額に加えて、各トランザクションが支払い得る最大手数料(ガス上限 × 手数料上限)を切り上げたもの | 0より大きい値 |
- 17,280ブロックは、メインネットでは約15時間(1ブロックあたり約3.1秒)、テストネットでは約6時間(1ブロックあたり約1.3秒)です。
- 受け付けられた後に失敗したトランザクションも、スロットと金額の枠を消費します。
- 新しいウィンドウを開くと、前のウィンドウは置き換えられ、消費量はゼロから再開します。
- CLIは
max-valueをuqorまたはqorで受け付けます(1000qor= 1,000,000,000 uqor)。 - 金額の制限はネイティブQORのみを対象とします。トークン送金、approve、その他のコントラクト呼び出しの金額はゼロです。スコープ(下記)は、ウィンドウが受け付ける受取先を絞り込みますが、トークンの金額には上限を設けません。
ステップ1 — ポスト量子鍵を登録する(一度だけ): 上記のポスト量子鍵を登録するを参照してください。
ステップ2 — ウィンドウを開く。 ウィンドウを開くのはCosmosレーンのトランザクションなので、未署名で生成してから共署名します。
# at most 1000 QOR in total, at most 20 transactions, for 7,200 blocks (about 6.4 hours on mainnet)
qorechaind tx pqc open-evm-window 7200 20 1000qor --from mykey \
--chain-id qorechain-diana --gas 400000 --fees 60000uqor --generate-only > window.json
qorechaind tx pqc cosign window.json --from mykey --pqc-key mypqc --chain-id qorechain-diana
スコープの絞り込み(v3.2.3以降)。 2つのオプションフラグにより、開いているウィンドウが受け付けるものを制限できます。--native-onlyはネイティブQORの単純送金のみを受け付けます(calldataなし、コントラクト作成なし、コードを持つ受取先なし)。--allowed-targets 0xAAA...,0xBBB...は、それらの受取先へのトランザクションのみを受け付けます(最大16件。この場合、コントラクト作成は拒否されます)。例:
qorechaind tx pqc open-evm-window 7200 20 1000qor --native-only --from mykey \
--chain-id qorechain-diana --gas 400000 --fees 60000uqor --generate-only > window.json
--allowed-targetsが制限するのは、ウィンドウが触れてよいコントラクトとトークンの種類であり、金額ではありません。列挙されたトークンは、approveを含め、そのトークンの任意の金額を受け付け、列挙されたコントラクトは、そのコードと既存の承認が許す範囲で何でも動かせるため、汎用のフォワーダーやルーターのコントラクトを列挙しないでください。ウィンドウが制限するのは EVM レーン(古典署名)のトランザクションだけで、ハイブリッド PQC 署名された Cosmos メッセージ(クロス VM 呼び出しや authz など)はその対象外です。
メインネットでは、ウィンドウを開くのに約180,000ガスを使用しました。QoreXでは、同じ手順は設定 → セキュリティ → EVMアクセスウィンドウ(アプリ)、またはEVMアクセスウィンドウボタン(拡張機能)です。ウィンドウを開くとアカウントのnonceが進むため、ウォレットでEVMトランザクションを準備する前にウィンドウを開いてください。
ステップ3 — 残りを確認する:
qorechaind query pqc evm-window qor1youraddress...
curl -s https://api-testnet.qore.host/qorechain/pqc/v1/evm_window/qor1youraddress...
ウィンドウのないアドレスに対しても、RESTの応答は失敗せず、found: falseを返します。フィールドはfound、live、opened_height、expiry_height、max_txs、used_txs、max_value、used_value、remaining_blocks、remaining_txs、remaining_valueです(uqorの整数で、文字列として返されます)。メインネットではhttps://api.qore.hostを使用してください。
ステップ4 — 通常どおりEVMレーンを使う。 MetaMaskやお使いのツールからいつもどおり送信します。各トランザクションは、ウィンドウからトランザクションスロットを1つと、(金額 + 最大手数料)を消費します。
ウィンドウを早めに閉じる。 クラシック鍵が漏えいした疑いがある場合は、ウィンドウを閉じてください。ウィンドウがまだ受け付けていたものは、次のブロックから拒否されます。ウィンドウを閉じると、保留中のEIP-7702委任の同意も取り消されます(v3.2.2以降。アカウントのコードを変更するtype-4トランザクションは、ポスト量子のauthorize-evm-delegationによる同意があった後にのみ受け付けられます)。
qorechaind tx pqc close-evm-window --from mykey --chain-id qorechain-diana \
--gas 400000 --fees 60000uqor --generate-only > close.json
qorechaind tx pqc cosign close.json --from mykey --pqc-key mypqc --chain-id qorechain-diana
エラー
| 表示される内容 | 意味 | 対処 |
|---|---|---|
no open EVM authorisation window; open one with MsgOpenEVMWindow ...(モジュールpqc、code 26) | このアカウントにウィンドウがない | ステップ2 |
... has no registered post-quantum key; the EVM lane requires one(EVMレーンではcode 26、ウィンドウを開こうとした場合はcode 28) | ML-DSA鍵が登録されていない | ステップ1 |
the EVM authorisation window for ... does not admit this transaction (remaining: ...)(code 27) | 期限切れまたは使い切り。メッセージにどの制限かが表示される | 新しいウィンドウを開く |
invalid EVM authorisation window(code 28) | 制限値が範囲外(blocks 1–17,280、max-txs 1–1,000、max-value > 0) | 引数を修正する |
コードからは、QoreChain SDKと@qorechain/wallet-adapterがウィンドウの開閉メッセージを組み立て、ウィンドウの状態を読み取ることができます。SDKドキュメントを参照してください。
ウィンドウが適用されるのはEVMレーンのみです。Cosmosレーンのトランザクションは、すべてのトランザクションですでにハイブリッド署名を伴っており、ウィンドウを一度も開かなければEVMトランザクションは拒否されますが、それ以外は何も変わりません。
SVM RPCの使用
QoreChainのSVM実行環境は、ポート8899でSolana互換のRPCインターフェースを公開しています。SVMトランザクションレーンは現在ネットワーク全体で無効化されているため、現時点で利用できるのはこれらの読み取りメソッドです。
現在のスロットの取得
curl -s -X POST http://localhost:8899 \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "getSlot",
"id": 1
}' | jq '.result'
アカウント残高の取得
curl -s -X POST http://localhost:8899 \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "getBalance",
"params": ["YourSVMPublicKey"],
"id": 1
}' | jq '.result'
よく使うCLIパターン
qorechaind CLIを使用する際、以下のフラグが頻繁に使われます。
| フラグ | 説明 | 例 |
|---|---|---|
--chain-id | 対象チェーンを指定します | --chain-id qorechain-diana |
--fees | uqor単位のトランザクション手数料(ガス上限 × 0.1以上) | --fees 40000uqor |
--from | 署名鍵の名前またはアドレス | --from mykey |
--output | レスポンス形式 | --output json |
--node | 接続先のRPCエンドポイント | --node tcp://localhost:26657 |
--gas | トランザクションのガス上限 | --gas 400000(または--gas auto) |
--gas-adjustment | 見積もりガスの乗数 | --gas-adjustment 1.5 |
--gas-prices | --feesの代わりにガス価格を指定 | --gas-prices 0.1uqor |
--generate-only | 未署名のトランザクションを出力します(tx pqc cosignの前に必要) | --generate-only |
-y | 確認プロンプトをスキップ | -y |
例:一般的なフラグをすべて使用した完全なコマンド
qorechaind tx bank send mykey qor1recipient... 500000uqor \
--chain-id qorechain-diana \
--gas 400000 --fees 60000uqor \
--node tcp://localhost:26657 \
--output json \
--generate-only > tx.json
qorechaind tx pqc cosign tx.json --from mykey --pqc-key mypqc --chain-id qorechain-diana
次のステップ
初めてのトランザクション送信が完了しました。QoreChainが提供する他の機能もご覧ください。
- ステーキングとデリゲーション — QORをステークしてネットワークの安全性維持に貢献し、ステーキング報酬を受け取る
- アセットのブリッジ — チェーン間でアセットを移動する
- EVM開発 — QoreChain上にSolidityスマートコントラクトをデプロイする