REST / gRPC エンドポイント
QoreChain はプログラムからのアクセス向けに、3つの主要なインターフェースを提供しています。
| インターフェース | デフォルトポート | プロトコル | 説明 |
|---|---|---|---|
| REST | 1317 | HTTP/1.1 | REST ゲートウェイ (Cosmos SDK API サーバー) |
| gRPC | 9090 | HTTP/2 | Protobuf エンコードの gRPC サービス |
| RPC | 26657 | HTTP + WS | QoreChain コンセンサスエンジン RPC |
すべての REST エンドポイントは JSON を返します。gRPC エンドポイントは Protocol Buffers を使用し、任意の gRPC クライアントで利用できます。RPC インターフェースはコンセンサスレベルのクエリとトランザクションのブロードキャストを提供します。
これらのインターフェースは、qorechain-vladi メインネット(2026年6月7日より稼働中)と qorechain-diana テストネットの両方で利用できます。テストネットはノードリリース v3.2.8(テストネットのガバナンスにより 2026年11月12日にブロック高 9,929,500 で適用。その前の v3.2.7 は 2026年11月6日にブロック高 9,594,600 で適用)を、メインネットは v3.2.7 を実行しており、1 リリース遅れています。メインネットは v3.2.7 を 2026年11月12日にブロック高 4,164,600 で適用しました(ガバナンス提案 16。その前に、v3.2.6 は 2026年11月4日にブロック高 4,020,000 でガバナンス提案 15 により、v3.2.5 は 2026年10月29日にブロック高 3,906,833 で提案 14 により、v3.2.4 は 2026年10月23日にブロック高 3,742,566 で適用)。テストネットは v3.2.5 を 2026年10月26日にブロック高 8,890,800 で、v3.2.6 を 2026年10月27日にブロック高 8,970,638 で、v3.2.7 をブロック高 9,594,600 で、v3.2.8 をブロック高 9,929,500 で適用しました。メインネットはまだ v3.2.8 を適用していません。リリースで追加されたルートやフィールドは、そのネットワークがリリースを適用して初めて現れます。以下で 2026年11月4日と記したルートの確認は、v3.2.6 へのアップグレード後に公開メインネットホストに対して行いました。v3.2.7 と記したルートは 2026年11月7日に公開テストネットホストで、また、メインネットが v3.2.7 を適用した後の 2026年11月12日に公開メインネットホストで確認しました(いずれもルーティングされています。各ルートの注記を参照)。以下のベース URL はローカルで実行中のノードを前提としています。公開ホスト型エンドポイントは https://api.qore.host / https://api-testnet.qore.host(REST)と https://rpc.qore.host / https://rpc-testnet.qore.host(RPC)で、ネットワークに掲載されています。公開の gRPC エンドポイントはありません。ホスト名 grpc.qore.host と grpc-testnet.qore.host は存在しないため、gRPC が必要な場合は自分のノードを実行してください。
ベース URL
REST: http://localhost:1317
gRPC: localhost:9090
RPC: http://localhost:26657
存在するルート
QoreChain 固有のモジュールは /qorechain/<module>/v1/... プレフィックス配下の REST として公開されており、REST ルートがあるのは以下に挙げるモジュールだけです。その他のモジュールは gRPC のみで利用できます(gRPC 専用モジュールを参照)。標準の Cosmos SDK、EVM、QoreChain Native のルートは標準ルートに記載しています。
存在しないルートは、HTTP 501 と {"code":12,"message":"Not Implemented"} で応答します。これはルートが提供されていないことを意味し、クエリの結果が空だったという意味ではありません。/qorechain/ プレフィックスのない短縮パス(例: /bridge/v1/chains や /pqc/v1/params)は提供されません。存在するルートで未知のレコードを指定すると、HTTP 404 と {"code":5,"message":"... not found"} が返ります。
以下の例は公開メインネットのホストを使用しています。テストネットでは https://api-testnet.qore.host に置き換えてください。サンプルの値は 2026年10月20日から27日の間に実際のネットワークから読み取ったもので、時間とともに変化します。レスポンスの形を示すものとしてご利用ください。v3.2.4 リリースでは、いくつかのルートとフィールドが追加されました。これらは以下で v3.2.4 と表記しており、テストネットでは 2026年10月19日から、メインネットでは 2026年10月23日から提供されています。v3.2.5 リリース(メインネットでは 2026年10月29日から、テストネットでは 2026年10月26日から)では、クロス VM のパラメータ・メッセージのルートとネイティブ鍵レジストリのルートが追加され、v3.2.5 と表記しています。v3.2.6 リリース(テストネットでは 2026年10月27日から、メインネットでは 2026年11月4日から)ではさらに追加されており、v3.2.6 と表記しています。メインネットのホストは 2026年11月4日にこれらに 200 で応答しました(例外は該当箇所に記載)。古いリリースのままのノードは、新しいルートに 501 で応答します。v3.2.7 リリース(テストネットでは 2026年11月6日から、メインネットでは 2026年11月12日から)では、v3.2.7 と表記したルートが追加されました。PQC マルチシグとテキスト署名、ステーキング APR、SVM クラスター識別情報です。
PQC モジュール
| メソッド | エンドポイント | 説明 |
|---|---|---|
| GET | /qorechain/pqc/v1/account/{address} | アカウントのポスト量子鍵の登録状況(found、鍵タイプ、アルゴリズム) |
| GET | /qorechain/pqc/v1/evm_window/{address} | アカウントの EVM レーン認可ウィンドウと、その残り |
| GET | /qorechain/pqc/v1/evm_limits | 適用中の EVM ガス上限(1 トランザクションあたり 30,000,000)。テストネットのみ、v3.2.8 以降。メインネットは v3.2.8 を適用しておらず 501 で応答します(2026年11月12日に確認) |
| GET | /qorechain/pqc/v1/evm_delegation_consent/{address} | アカウントの EIP-7702 委任の同意、現在の委任、EVM ノンス(v3.2.2 以降) |
| GET | /qorechain/pqc/v1/protocol_features | v3.2.4(テストネットでは 2026年10月19日から、メインネットでは 2026年10月23日から。古いノードでは 501)。バイナリが認識しているすべてのプロトコル機能と、enabled、known、staged フラグ |
| GET | /qorechain/pqc/v1/kem/{address} | v3.2.5(メインネットでは 2026年10月29日から、テストネットでは 2026年10月26日から、両ネットワークで提供。古いノードでは 501)。ネイティブ鍵レジストリにアドレスに対して登録された ML-KEM 暗号化鍵。未登録の場合は {"found":false,"key":null} |
| GET | /qorechain/pqc/v1/params | v3.2.6(テストネットでは 2026年10月27日から、メインネットでは 2026年11月4日から。古いノードでは 501)。モジュールパラメータ |
| GET | /qorechain/pqc/v1/multisig/{address} | v3.2.7(テストネットでは 2026年11月6日から、メインネットでは 2026年11月12日から。古いノードでは 501)。アドレスのハイブリッドのポスト量子マルチシグ記録。未登録の場合は {"found":false,"multisig":null} |
| POST | /qorechain/pqc/v1/textual_sign_doc | v3.2.7(テストネットでは 2026年11月6日から、メインネットでは 2026年11月12日から。古いノードでは 501。GET も 501 で応答)。ウェブウォレットが表示して署名するための、トランザクションの SIGN_MODE_TEXTUAL ドキュメントを生成します(下記参照) |
パスのセグメントは単数形の account である点に注意してください。/qorechain/pqc/v1/stats のルートはありません(qorechaind query pqc stats を使用してください)。/qorechain/pqc/v1/params は v3.2.6 から提供され、2026年11月4日に両ネットワークで 200 を返しました(メインネットでは pqc_primary が true、allow_classical_fallback が false、min_security_level が 5、default_signature_algo_name が dilithium5、hybrid_signature_mode_name が required)。v3.2.6 より古いノードでは、代わりに qorechaind query pqc params を使用してください。
PQC マルチシグとテキスト署名(v3.2.7)
v3.2.7 以降(テストネットでは 2026年11月6日から、メインネットでは 2026年11月12日から。メインネットではブロック高 4,164,600 から pqc-multisig プロトコル機能が有効)、アカウントはハイブリッドのポスト量子 k-of-n マルチシグを持てます。メッセージは /qorechain.pqc.v1.MsgRegisterPQCMultisig で、ポスト量子の集合はアカウントの現在の従来型マルチシグのメンバーと鍵に従います。GET /qorechain/pqc/v1/multisig/{address} は登録内容を返します。2026年11月7日に、マルチシグのないアカウントに対して 200 と {"found":false,"multisig":null} を返しました(このルートには有効な qor1... アドレスが必要で、不正な形式のものは 400 で応答します)。メインネットではこのルートは 2026年11月12日から提供されています(無効なアドレスのリクエストは 400 で応答し、ルートがマウントされていることが分かります)。テストネットにはまだマルチシグが登録されていないため、登録済みマルチシグのレコードのフィールドはここでは確認していません。
POST /qorechain/pqc/v1/textual_sign_doc は、SIGN_MODE_TEXTUAL で署名するハードウェアウォレットとウェブウォレット向けです。JSON ボディには tx_json(未署名トランザクションを JSON 文字列にしたもの)または tx_bytes(base64)に加えて、chain_id、account_number、sequence、public_key(@type と key を持つ Any)を含めます。レスポンスには sign_bytes(base64、署名対象のドキュメント)と、デバイスが表示する行のリストである screens(title、content、indent、expert)が含まれます。メインネットでは 2026年11月12日に空の JSON ボディが 400 で応答したため、このルートはそこでマウントされています。トランザクションのないボディは 400(tx_bytes or tx_json is required)で応答し、メッセージがない、または 32 を超えるメッセージを含むトランザクションは拒否されます。コマンドラインでは、v3.2.7 から qorechaind tx pqc cosign がテキスト署名モードに対応しています(トランザクションコマンドを参照)。
curl -s https://api.qore.host/qorechain/pqc/v1/multisig/qor1... # or api-testnet.qore.host
curl -s -X POST https://api.qore.host/qorechain/pqc/v1/textual_sign_doc \
-H 'content-type: application/json' -d @request.json
ポスト量子署名の検証に課されるガスは、v3.2.7 から 1 回の検証につき一律 2,000 ガスです(テストネットでは 2026年11月6日から、メインネットでは 2026年11月12日から、スイッチ pqc-verify-gas-calibrated)。バージョン履歴を参照してください。
curl -s https://api.qore.host/qorechain/pqc/v1/account/qor1...
{
"found": true,
"account": {
"address": "qor1...",
"public_key": "<base64 ML-DSA-87 public key>",
"algorithm_id": 1,
"algorithm_name": "dilithium5",
"ecdsa_pubkey": null,
"key_type": "hybrid",
"created_at_height": "209015",
"migration_public_key": null,
"migration_algorithm_id": 0,
"classical_key_source": "auth_account"
}
}
classical_key_source は ecdsa_pubkey の出所を示します。stored(登録時に渡された鍵)、auth_account(何も保存されていないため、アカウント自身のオンチェーン公開鍵)、または none です。v3.2.4 以降(テストネットでは 2026年10月19日から、メインネットでは 2026年10月23日から)は、レコードに "possession_proven": false も含まれます。これは、検証済みの所有証明とともに鍵が登録されると true になります。古いリリースのノードは、このフィールドを報告しません。
鍵が登録されていないアカウントは {"found": false, "account": null} を返します。アカウントが送信前に鍵を登録する必要があるかどうかは、found で判断してください。
curl -s https://api.qore.host/qorechain/pqc/v1/evm_window/qor1...
{
"found": false,
"live": false,
"opened_height": "0",
"expiry_height": "0",
"max_txs": "0",
"used_txs": "0",
"max_value": "",
"used_value": "",
"remaining_blocks": "0",
"remaining_txs": "0",
"remaining_value": "",
"native_only": false,
"allowed_targets": []
}
このルートは、ウィンドウのないアドレスに対しても失敗せず、found: false を返します。v3.2.0 以降、EVM レーンは、登録済みの PQC 鍵を持ちかつウィンドウが開いているアカウントからのトランザクションのみを受け付けます。live は、現在の高さでウィンドウがあと1件以上のトランザクションを受け付ける間は true です。remaining_blocks、remaining_txs、remaining_value は、どの上限が最も使い果たされそうかを示します。値は文字列として返される uqor 単位の整数です。v3.2.3 以降、ウィンドウにはスコープを持たせることができます。native_only(通常の QOR 送金のみ)と allowed_targets(列挙された受取先のみ。触れてよいコントラクトとトークンを制限するもので、金額は制限しません)です。EVM レーンの仕組みについては EVM 開発を参照してください。
curl -s https://api.qore.host/qorechain/pqc/v1/evm_delegation_consent/qor1...
{
"found": false,
"live": false,
"delegate": "",
"granted_height": "0",
"expiry_height": "0",
"current_delegate": "",
"nonce": "0"
}
アカウントの EIP-7702 委任は、そのアカウント自身のポスト量子同意(MsgAuthorizeEVMDelegation)がある場合にのみ有効になります。found と live は、delegate に対する記録済みでまだ使用可能な同意を報告します。current_delegate はアカウントが現在設定している委任、nonce はその EVM ノンスです。
Bridge モジュール
Bridge モジュールの読み取り専用ステートは /qorechain/bridge/v1/... 配下の REST として公開されています(チェーンバージョン v3.1.77 以降、実際のオンチェーン JSON を提供)。Bridge の config は例えば min_validators=10 や attestation_threshold=7 を報告します。
| メソッド | エンドポイント | 説明 |
|---|---|---|
| GET | /qorechain/bridge/v1/config | 現在の Bridge モジュール設定 |
| GET | /qorechain/bridge/v1/chains | 登録済みのブリッジチェーンをすべて一覧表示 |
| GET | /qorechain/bridge/v1/chains/{chain_id} | 特定のブリッジ済みチェーンの詳細 |
| GET | /qorechain/bridge/v1/validators | 登録済みのブリッジバリデーターを一覧表示 |
| GET | /qorechain/bridge/v1/validators/{address} | 特定のブリッジバリデーターの詳細 |
| GET | /qorechain/bridge/v1/operations | ブリッジ操作を一覧表示 |
| GET | /qorechain/bridge/v1/operations/{id} | 特定のブリッジ操作の詳細 |
curl -s https://api.qore.host/qorechain/bridge/v1/config
{
"config": {
"min_validators": 10,
"attestation_threshold": 7,
"challenge_period_secs": "86400",
"large_transfer_threshold": "100000000000",
"enabled": true
}
}
chains/{chain_id} は、{"chain": {"chain_id": "ethereum", "name": "Ethereum", "chain_type": "evm", "bridge_contract": "0x000…0", "status": "pending", "min_confirmations": 12, ...}} のようなエントリを1件返します。
設定済みの37のブリッジチェーンはすべて、両ネットワークで "status": "pending" を報告しており、validators と operations は空のリストです。これらのルートはモジュールの設定を示すものであり、現時点でアセットをブリッジできることを意味するものではありません。ブリッジアーキテクチャを参照してください。
Multilayer モジュール
Multilayer モジュールの完全なクエリサービスは /qorechain/multilayer/v1/... 配下の REST として公開されています(チェーンバージョン v3.1.80 以降)。これには2つのステートアンカー読み取りクエリが含まれます。anchor/{layer_id} はレイヤーの最新の決済アンカーを返し、anchors/{layer_id} はそのアンカー履歴を返します。各アンカーには、その正規化されたフィールドに対する ML-DSA-87 (Dilithium-5) 署名が付与されているため、クライアントはアンカーを取得して独立に検証できます。これが Rollup Development Kit の決済レシートのオンチェーンでの基盤となっています。
| メソッド | エンドポイント | 説明 |
|---|---|---|
| GET | /qorechain/multilayer/v1/params | 現在の Multilayer モジュールパラメータ |
| GET | /qorechain/multilayer/v1/layers | 登録済みのレイヤーをすべて一覧表示 |
| GET | /qorechain/multilayer/v1/layers/{layer_id} | 特定のレイヤーの詳細 |
| GET | /qorechain/multilayer/v1/anchor/{layer_id} | レイヤーの最新のステートアンカー |
| GET | /qorechain/multilayer/v1/anchors/{layer_id} | レイヤーのステートアンカー履歴 |
| GET | /qorechain/multilayer/v1/routing-stats | レイヤー間のトランザクションルーティング統計 |
StateAnchorView には layer_id、layer_height、state_root、validator_set_hash、main_chain_height、anchored_at、pqc_aggregate_signature、transaction_count、compressed_state_proof が含まれます。v3.2.2 以降、署名対象のメッセージは v2 アンカーメッセージです。ドメインタグ qorechain-multilayer-anchor-v2 に続いて、チェーン ID、レイヤー ID、レイヤー高、ステートルート、バリデーターセットのハッシュ、トランザクション数、圧縮ステート証明が並び、可変長の各フィールドには 8 バイトのビッグエンディアンの長さが前置されます(以前の v1 メッセージにはチェーン ID も長さの前置もなかったため、署名がすべてのチェーンで有効でした)。これはレイヤー作成者の登録済み PQC 鍵に対して検証されます。qorechaind query rdk anchor-sign-bytes は、ロールアップバッチに対するこのバイト列を出力します。アンカーのないレイヤーは、anchor/{layer_id} からは HTTP 404(no anchor for layer ...)を返し、anchors/{layer_id} からは空のリスト({"anchors": []})を返します。
curl -s https://api.qore.host/qorechain/multilayer/v1/params
{
"params": {
"max_sidechains": "10",
"max_paychains": "50",
"min_anchor_interval": "100",
"max_anchor_interval": "1000",
"default_challenge_period": "86400",
"min_sidechain_stake": "1000000000",
"min_paychain_stake": "100000000",
"routing_enabled": true,
"routing_confidence_threshold": "0.6",
"cross_layer_fee_bundling": true
}
}
本稿執筆時点では、両ネットワークとも layers は空のリストです。サンプルはメインネットのレスポンスです。テストネットでは max_sidechains は 64 です(ビルダーイベントのためにガバナンス提案 16 で引き上げられ、2026年10月25日に可決)。
Burn モジュール
Burn モジュールの読み取り専用ステートは /qorechain/burn/v1/... 配下の REST として公開されています。Burn の params には例えば gas_burn_rate=0.30 が含まれます。
| メソッド | エンドポイント | 説明 |
|---|---|---|
| GET | /qorechain/burn/v1/params | 現在の Burn モジュールパラメータ |
| GET | /qorechain/burn/v1/stats | 累積 Burn 総量(ソース別内訳) |
| GET | /qorechain/burn/v1/records | 最近の Burn レコードを一覧表示 |
| GET | /qorechain/burn/v1/milestone | Burn マイルストーンの進捗(累積トランザクション数) |
| GET | /qorechain/burn/v1/stranded_rewards | 取り分けられ、まだガバナンスによって解放されていないステーカーの取り分 |
curl -s https://api.qore.host/qorechain/burn/v1/stats
{
"stats": {
"total_burned": "31574710367921",
"burns_by_source": {
"gas_fee": "31574710282421",
"failed_tx": "85500",
"milestone": "0",
"amm": "0",
"xqore_penalty": "0"
},
"last_burn_height": "3666968"
}
}
実際のレスポンスにはすべての Burn ソース(ai_service、amm、auto_buyback、bridge_fee、contract_create、failed_tx、gas_fee、milestone、rollup_create、tge、treasury_buyback、xqore_penalty、さらに v3.2.4 からは staking_tier_penalty(Staking Tier ロックの早期解除ペナルティで、Burn されます))が列挙されます。サンプルは一部を省略しています。金額は uqor 単位です。failed_tx は v3.2.2 アップグレード以降ゼロではありません。このアップグレードで、失敗したトランザクションの Burn が実際に課金された手数料に対して適用されるようになりました。v3.2.3 以降、古い Burn ごとの records は削除されるため、records は全履歴ではなく最近の範囲です。stats の合計は累積値です。
curl -s https://api.qore.host/qorechain/burn/v1/stranded_rewards
{ "reserved": "0", "released": "10500542706858", "initialized": true, "snapshot_height": "2981742" }
reserved は解放されずに残っている分、released はガバナンスがすでに移動した分、snapshot_height は準備金を記録した v3.2.0 アップグレードの高さです。上記の値は 2026年10月23日に読み取ったものです。ガバナンスは最初の金額(6,693,045.921330 QOR)を 2026年10月19日に解放し、v3.2.3 アップグレードは残りの準備金をその時点の高さで再計算し(3,807,496.785528 QOR)、ガバナンス提案 12 がその金額を解放しました(可決、投票は 2026年10月21日に終了)。そのため準備金は現在空で、released の合計は 10,500,542.706858 QOR です。最新の値を読み取ってください。トークノミクスを参照してください。
Abstract Account モジュール
Abstract Account のクエリサービスは /qorechain/abstractaccount/v1/... 配下の REST として公開されており(チェーンバージョン v3.1.85 以降)、これにはハードコーディングなしでオーセンティケーターのスコープを検証するためのパーミッションスキーマが含まれます。
| メソッド | エンドポイント | 説明 |
|---|---|---|
| GET | /qorechain/abstractaccount/v1/config | モジュール設定(機能プローブ: enabled) |
| GET | /qorechain/abstractaccount/v1/accounts | アブストラクトアカウントを一覧表示 |
| GET | /qorechain/abstractaccount/v1/accounts/{address} | 指定アドレスのアブストラクトアカウントの状態(なければ 404) |
| GET | /qorechain/abstractaccount/v1/permission_schema | schema_version、permissions、msg_permissions、key_management_msgs、lane_rules |
| GET | /qorechain/abstractaccount/v1/auth_nonce/{address}/{pubkey_hex} | v3.2.4(テストネットでは 2026年10月19日から、メインネットでは 2026年10月23日から。古いノードでは 501)。リンク済みオーセンティケーター鍵が次に署名すべきシーケンス(nonce、linked) |
curl -s https://api.qore.host/qorechain/abstractaccount/v1/config
{ "config": { "enabled": false, "max_session_keys": 10, "max_spending_rules": 5, "default_session_ttl": "86400" } }
上記のサンプルはメインネットのレスポンスです。メインネットでは enabled は false(accounts は空のリスト)であるため、リンク済みウォレットからの支出などのアブストラクトアカウント機能はメインネットでは利用できません。テストネットでは、ガバナンス提案 18(2026年10月27日可決)以降 enabled は true で、accounts にはこれまでに作成されたアカウントが一覧されます(2026年10月27日に確認)。このモジュールに依存する前に、config.enabled を機能プローブとして使用してください。アカウントアブストラクションを参照してください。
AMM モジュール
| メソッド | エンドポイント | 説明 |
|---|---|---|
| GET | /qorechain/amm/v1/params | 現在の AMM パラメータ(ベーシスポイント単位の手数料、上限) |
| GET | /qorechain/amm/v1/pools | プールを一覧表示 |
| GET | /qorechain/amm/v1/pools/{pool_id} | 1つのプール(不明な場合は 404) |
| GET | /qorechain/amm/v1/pools/{pool_id}/lp/{address} | プール内におけるアドレスの LP トークン残高 |
| GET | /qorechain/amm/v1/pool_by_denoms?denom_a=&denom_b= | denom ペアのプールを検索(なければ 404) |
| GET | /qorechain/amm/v1/quote/exact_in?pool_id=&denom_in=&amount_in= | 見積もり: 入力額を指定した場合の出力額 |
| GET | /qorechain/amm/v1/quote/exact_out?pool_id=&denom_out=&amount_out= | 見積もり: 出力額を指定した場合に必要な入力額 |
curl -s https://api.qore.host/qorechain/amm/v1/params
{
"params": {
"swap_fee_bps": 30,
"protocol_fee_bps": 10,
"min_liquidity": "1000",
"max_pools_per_creator": 50,
"lp_token_decimals": 6,
"pool_creation_fee": "100000000",
"max_swap_impact_bps": 500,
"enabled": true
}
}
7つの AMM ルートはすべて両ネットワークで応答します(2026年10月27日に確認)。本稿執筆時点では、どちらのネットワークにもプールは存在しません({"pools": []})。一致するものがない入力に対する応答は次のとおりです。不明な ID を指定した pools/{pool_id} は HTTP 404 を返します({"code":5,"message":"pool 1 not found"})。ペアのプールがない pool_by_denoms は 404 を返します(no pool for uqor/foo)。不明なプールに対する見積もりは HTTP 400 と {"code":3,"message":"pool not found"} を返します。LP ポジションのないアドレスに対する pools/{pool_id}/lp/{address} は {"balance":"0"} を返します(アドレスは有効な qor1 bech32 アドレスである必要があり、そうでない場合は 400)。2つの見積もりルートと pool_by_denoms は入力をクエリ文字列から読み取るため、パラメータが必要です。amount_in / amount_out がないと 400(invalid amount_in / invalid amount_out)で応答します。
テストネットでは、プールに必要な2つ目の denom が利用できます。ガバナンスが登録した3つのテストトークンです。テストネットのテストトークン(Fest)を参照してください。メインネットには同等のものはなく、バンクの denom は uqor のみです。
Licence モジュール
| メソッド | エンドポイント | 説明 |
|---|---|---|
| GET | /qorechain/license/v1/check/{grantee}/{feature_id} | grantee がその機能の有効な付与を保有しているかどうか(なければ 404) |
| GET | /qorechain/license/v1/holders/{feature_id} | 機能に対するすべての付与 |
| GET | /qorechain/license/v1/list/{grantee} | アドレスが保有するすべての付与 |
付与(LicenseView)には grantee、feature_id、expires_at、granted_at、granted_by、suspended、metadata があります。check は active も返します。一致するものがない list または holders クエリは {"licenses": []} を返します。付与のないアドレスに対する check は、HTTP 404 と {"code":5,"message":"no license for <grantee>/<feature_id>"} を返します。
curl -s https://api.qore.host/qorechain/license/v1/holders/lightnode_operator
{
"licenses": [
{
"grantee": "qor1...",
"feature_id": "lightnode_operator",
"expires_at": "0",
"granted_at": "3536305",
"granted_by": "qor1...",
"suspended": false,
"metadata": "",
"active": true
}
]
}
expires_at: "0" は、付与の有効期限がないことを意味します。v3.2.3 以降、ガバナンスはこれらのライセンスを付与するライセンス権限者を置き換えることができます(MsgUpdateAuthority)。すでに行われた付与はそのまま残ります。
Light Node モジュール
| メソッド | エンドポイント | 説明 |
|---|---|---|
| GET | /qorechain/lightnode/v1/params | 登録、ハートビート、報酬のパラメータ |
| GET | /qorechain/lightnode/v1/stats | total_registered、total_active、total_rewards、last_reward_height |
| GET | /qorechain/lightnode/v1/nodes | 登録済みのライトノードを一覧表示 |
| GET | /qorechain/lightnode/v1/node/{address} | 1つのノード(未登録の場合は {"node": null, "found": false}) |
| GET | /qorechain/lightnode/v1/rewards/{address} | オペレーターアドレスに蓄積された報酬(accumulated_rewards) |
| GET | /qorechain/lightnode/v1/reward_pool | 報酬プールの会計(balance、reserved、outstanding、payable、distributable、max_reward_per_block_per_node、max_reward_per_month_per_node、initialized) |
curl -s https://api.qore.host/qorechain/lightnode/v1/params
{
"registration_fee": "1000000",
"heartbeat_interval": "1000",
"min_delegated_stake": "1000000000",
"reward_share": "0.030000000000000000",
"min_uptime_for_rewards": "0.800000000000000000",
"max_light_nodes": "10000",
"heartbeat_grace_period": "100"
}
curl -s https://api.qore.host/qorechain/lightnode/v1/reward_pool
{
"balance": "5645408555",
"reserved": "5645276228",
"outstanding": "130077",
"payable": "0",
"max_reward_per_block_per_node": "1713",
"distributable": "2250",
"initialized": true,
"max_reward_per_month_per_node": "2000000000",
"monthly_cap_active": true,
"last_distribution_time": "1792775155",
"last_distribution_height": "3744000"
}
reserved はプールのうち留保されていて、ガバナンス投票でしか動かせない部分です。ノードごとの上限は uqor 単位です。max_reward_per_block_per_node はブロックごとの上限で、v3.2.3 以降は max_reward_per_month_per_node(2000000000 uqor = 30 日あたり 2,000 QOR)が月ごとの上限となり、ブロック時間と稼働率に応じて按分されるため、ブロックの生成速度に左右されなくなりました。上限は約束された金額ではありません。サンプルは、ガバナンスが以前の準備金を解放した後(提案 8、2026年10月19日)の、2026年10月23日に読み取った実際のメインネットのレスポンスです。v3.2.4 以降(テストネットでは 2026年10月19日から、メインネットでは 2026年10月23日から)は、レスポンスに monthly_cap_active、last_distribution_time、last_distribution_height も含まれ、ノードの上限はそのノード自身の登録時から始まります。
チェーンは、有効な lightnode_operator ライセンスの付与がないライトノード登録を拒否します(holders/lightnode_operator で付与を一覧できます)。2026年10月27日時点で、stats はメインネットとテストネットの両方で "total_registered": "1" を報告しています。プログラムの状況についてはライトノードを参照してください。
RDK モジュール
Rollup Development Kit のクエリサービスは /qorechain/rdk/v1/... 配下の REST として公開されています(チェーンバージョン v3.2.2 以降。v3.2.0 と v3.2.1 では gRPC のみでした)。
| メソッド | エンドポイント | 説明 |
|---|---|---|
| GET | /qorechain/rdk/v1/params | モジュールパラメータ |
| GET | /qorechain/rdk/v1/rollups | ロールアップを一覧表示 |
| GET | /qorechain/rdk/v1/rollup/{rollup_id} | 1つのロールアップ(不明な場合は 404) |
| GET | /qorechain/rdk/v1/latest_batch/{rollup_id} | ロールアップの最新の決済バッチ |
| GET | /qorechain/rdk/v1/batch/{rollup_id}/{batch_index} | 1つの決済バッチ |
| GET | /qorechain/rdk/v1/batches/{rollup_id} | ロールアップのバッチをインデックス順に(ページネーション付き) |
| GET | /qorechain/rdk/v1/blob/{rollup_id}/{blob_index} | 1つのデータアベイラビリティ blob レコード |
curl -s https://api.qore.host/qorechain/rdk/v1/params
{
"params": {
"max_rollups": 100,
"min_stake_for_rollup": "10000000000",
"rollup_creation_burn_rate": "0.01",
"default_challenge_window": "604800",
"max_da_blob_size": "2097152",
"blob_retention_blocks": "432000",
"max_batches_per_block": 10
}
}
本稿執筆時点では、両ネットワークとも rollups は空のリストであるため、ロールアップごとのルートは 404 で応答します(例: {"code":5,"message":"rollup foo not found"})。default_challenge_window は秒単位で表されます(604800)。v3.2.4 以降、新たに送信されたバッチのオプティミスティックのチャレンジウィンドウはブロック時間で計測されます。テストネットではブロック高 8,337,253(2026年10月19日)から、メインネットではブロック高 3,742,566(2026年10月23日)からです。アップグレード前は、チェーンは秒単位の値を 1 ブロックあたり 6 秒の固定でブロック数に換算していました。テストネットでは、ビルダーイベントのためにガバナンス提案 17(2026年10月27日可決)が default_challenge_window を 3600(1時間)に、max_rollups を 200 に設定したため、上記のサンプル(メインネット)とは異なります。本稿執筆時点では、テストネットでも rollups は空のままです。
v3.2.7(テストネットでは 2026年11月6日から。rdk-zk-verification-key スイッチはメインネットで 2026年11月12日からオン): ZK ロールアップは MsgSetVerificationKey で検証鍵を登録でき(後から MsgUpdateVerificationKey で変更可能)、鍵のないロールアップへの ZK バッチは手数料が支払われる前に拒否されます。これらはメッセージでありクエリではありません。登録済みの鍵を読み取る REST ルートはなく(それらしいパスは 2026年11月7日に 501 で応答しました)、テストネットには ZK ロールアップが登録されていない(rollups が空。メインネットも 2026年11月4日の最終確認時点では登録なし)ため、登録はここではエンドツーエンドでは確認していません。バージョン履歴を参照してください。
Inflation モジュール
発行の設定と進捗は /qorechain/inflation/v1/... 配下の REST として公開されています(チェーンバージョン v3.2.2 以降)。CLI コマンドでは利用できません。
| メソッド | エンドポイント | 説明 |
|---|---|---|
| GET | /qorechain/inflation/v1/params | 発行パラメータ: emission_mode、fixed_epoch_emission、max_total_emission、epoch_length、enabled |
| GET | /qorechain/inflation/v1/epoch_info | 進捗: current_epoch、block_start、next_epoch_height、total_minted、max_total_emission、remaining_emission |
curl -s https://api.qore.host/qorechain/inflation/v1/params
curl -s https://api.qore.host/qorechain/inflation/v1/epoch_info
メインネットでは、emission_mode は "fixed"、fixed_epoch_emission は "86000000000"(1エポックあたり 86,000 QOR)、epoch_length は "43200" ブロック、max_total_emission は "590000000000000"(590,000,000 QOR、累積の上限)です。これらはガバナンス提案 10(2026年10月19日可決)で設定されました。新しい固定額を使用する最初のエポックはブロック 3,672,000 から始まり、epoch_info は進行中のエポックとこれまでにミントされた量を示します。レスポンス内の schedule リストは元の schedule モードに属するもので、固定モードのエポックがミントする量を表すものではありません。すべての金額は uqor 単位です。テストネットは、それとは異なる独自の値を報告します。v3.2.4 からは、3つ目のモード target_apy があり、target_apy_bps フィールドを持ちます(テストネットでは 2026年10月19日から、メインネットでは 2026年10月23日から)。ネットワークがこのモードに切り替わるのは、そのネットワーク自身のガバナンス投票によってのみです。そのため、そのような投票が可決されるまでメインネットは fixed のままです(2026年10月27日に確認: まだ fixed)。テストネットは独自のガバナンス(提案 14、2026年10月20日可決)で target_apy に切り替わっており、本稿執筆時点で "emission_mode": "target_apy" を報告しています。epoch_info は累積上限にすでに到達していることを示しています(remaining_emission は 0)。
Gas Abstraction モジュール
| メソッド | エンドポイント | 説明 |
|---|---|---|
| GET | /qorechain/gasabstraction/v1/config | 受け入れ可能な手数料トークン、プレミアム、ブロックごとの変換上限 |
| GET | /qorechain/gasabstraction/v1/conversion_rate?denom= | 手数料トークン1単位が uqor でいくらの価値か、および usable かどうか |
| GET | /qorechain/gasabstraction/v1/float | 変換フロートのアドレス、残高、このブロックでの使用量 |
curl -s https://api.qore.host/qorechain/gasabstraction/v1/config
{
"config": {
"enabled": true,
"native_denom": "uqor",
"accepted_tokens": [
{ "denom": "uqor", "conversion_rate": "1.0", "price_source": "", "rate_expiry_height": "0",
"pool_id": "0", "min_liquidity": "", "max_deviation_bps": 0 }
],
"premium_bps": 300,
"max_tip_multiplier": 3,
"float_min": "0",
"block_conversion_cap": "0"
}
}
受け入れリストには、両ネットワークともネイティブの uqor のみが含まれているため、手数料は uqor で支払われ、変換は行われません。ガバナンスはトークンを追加します(プール、最小流動性、時間加重価格とスポット価格の最大乖離とともに)。そのようなトークンで支払われた手数料は QOR フロートを通じて変換され、AMM プールを通じて補充されます。?denom= なしの conversion_rate は 500(denom is required)で応答します。
RL Consensus モジュール(v3.2.6)
rlconsensus モジュールの REST ゲートウェイは v3.2.6 で追加されました。qorechain-diana テストネットは 2026年10月27日にブロック高 8,970,638 で、メインネットは 2026年11月4日にブロック高 4,020,000 でこれを適用しました。2026年11月4日の時点で、以下の7つのルートはすべて、テストネットと同様に公開メインネットホストでも HTTP 200 で応答し、パラメータは不要です。v3.2.6 より前は 501({"code":12,"message":"Not Implemented"})で応答し、このモジュールには gRPC のみで到達できました。
| メソッド | エンドポイント | 説明 |
|---|---|---|
| GET | /qorechain/rlconsensus/v1/agent | エージェントの状態: mode、current_epoch、total_steps、last_observation_at、last_action_at、circuit_breaker_active、blocks_since_revert |
| GET | /qorechain/rlconsensus/v1/params | モジュールパラメータ: 観測間隔、エージェントモード、ステップ上限、サーキットブレーカーのウィンドウとしきい値、報酬の重み、デフォルトのブロック時間、ガス価格、バリデーターセットのサイズ |
| GET | /qorechain/rlconsensus/v1/observation | 最新の観測ベクトル(height と 25 個の values) |
| GET | /qorechain/rlconsensus/v1/reward | 最新の報酬シグナルとその構成要素 |
| GET | /qorechain/rlconsensus/v1/policy | 保存されているポリシーネットワーク: epoch、updated_at、weight_count(重み自体は返されません) |
| GET | /qorechain/rlconsensus/v1/applied_params | エージェントが適用済みとして保持している値: block_time_ms、gas_limit、gas_price_floor、pool_weight_rpos、pool_weight_dpos |
| GET | /qorechain/rlconsensus/v1/last_action | エージェントが直近のステップで提案したアクション: height、mode、5 個の values、applied |
curl -s https://api-testnet.qore.host/qorechain/rlconsensus/v1/agent
curl -s https://api-testnet.qore.host/qorechain/rlconsensus/v1/last_action
{ "mode": "shadow", "current_epoch": "1", "total_steps": "209", "last_observation_at": "8975660",
"last_action_at": "8975660", "circuit_breaker_active": false, "blocks_since_revert": "0" }
{ "height": "8975660", "mode": "shadow", "values": ["-0.334711810000000000", "-0.500000000000000000",
"0.000000000000000000", "0.000000000000000000", "0.000000000000000000"], "applied": false }
上記のサンプルはテストネットのものです。メインネット(2026年11月4日に確認)では、エージェントは conservative モードで、current_epoch は 0、total_steps は 0、circuit_breaker_active は false です。policy は weight_count が 0(保存済みポリシーなし)を返し、last_action は空(height が 0、applied が false)で、applied_params はデフォルト値です。エージェントは observation_interval ブロック(10)ごとに1ステップを実行します。shadow モードではアクションを計算して記録するだけで何も適用しないため、applied は false で、applied_params はデフォルト値のままです(block_time_ms は 5000、gas_price_floor は 100、プールの重みは 0.40 と 0.35)。テストネットでは、エージェントはガバナンス提案 29(2026年10月27日可決)により、保存済みポリシーとともにシャドウモードで起動されました。circuit_breaker_active は false です。メインネットはエージェントをまだ開始していません。金額と値は文字列です。このリリースでは、適用された値は参考情報です。チェーン上の唯一の読み取り側は、読み取り専用の rlConsensusParams プリコンパイルです。対応する gRPC メソッドは AgentStatus、Params、Observation、Reward、Policy、AppliedParams、LastAction(サービス qorechain.rlconsensus.v1.Query)で、CLI コマンドはクエリコマンドにあります。
Staking Tiers モジュール(v3.2.4)
Staking Tiers モジュールは v3.2.4 の一部です。これらのルートは、テストネットでは 2026年10月19日から、メインネットでは 2026年10月23日から提供されています(ガバナンス提案 13、ブロック高 3,742,566)。古いリリースのノードは、これらに 501 で応答します。
| メソッド | エンドポイント | 説明 |
|---|---|---|
| GET | /qorechain/stakingtier/v1/params | ロックティア、最小ロック額、早期アンロックのペナルティ |
| GET | /qorechain/stakingtier/v1/locks/{holder} | 保有者のロック、各ロックが現在どれだけ発生しているか、請求可能な額 |
| GET | /qorechain/stakingtier/v1/pool | ボーナスプール: 残高、未払い額、余剰、直近の決済 |
| GET | /qorechain/stakingtier/v1/apr | v3.2.7(テストネットでは 2026年11月6日から、メインネットでは 2026年11月12日から。古いノードでは 501)。基本のステーキングレートとティアボーナス |
| GET | /qorechain/stakingtier/v1/apr/{delegator} | v3.2.7(同じ提供状況)。1 人の委任者についての同じ情報: ライトノードボーナスの状況、委任、実効レート |
params は3つのロック期間(3、6、12 か月)とそのパラメータ、および min_lock_amount("10000000" uqor、10 QOR)を列挙します。ロックは tx stakingtier lock で行います(トランザクションコマンドを参照)。
APR ルート(v3.2.7)。 2026年11月12日に、メインネットのルートは source が emission、bonus_enabled が true、max_total_apy_bps が 2500 で 200 を返し、委任者のルートは無効なアドレスに対して 400 を返しました。GET /qorechain/stakingtier/v1/apr は、base(gross_base_apr_bps、source、computed_height、bonus_enabled、max_total_apy_bps)、base_apr_bps、tiers のリスト(3、6、12 か月について、bonus_bps が 150、300、500 で、実効値を併記)、そしてライトノードとバリデーターのボーナス(light_node_bonus_bps 200、validator_bonus_bps 300)を返します。2026年11月7日の時点で、テストネットの基本レートは 0(source は fees_only)だったため、ティアボーナスだけが 0 以外でした。プールのルートはボーナスプールを報告します。委任のないアドレスに対しては、委任者のルートは空の delegations リストと実効レート 0 で 200 を返します。すべての数値は、チェーンが直近の決済で計算した内容をベーシスポイントで読み取ったものです。保証されるものではなく、手数料や資金状況によって変わり、いかなるリターンの約束でもありません。
Reputation モジュール
Reputation モジュールの REST ルートはチェーン v3.2.6 で追加され、両ネットワーク(テストネットでは 2026年10月27日から、メインネットでは 2026年11月4日から)で提供されています。2026年11月4日に公開メインネットホストで確認したところ、/qorechain/reputation/v1/params、/validators、/validator/{address} はすべて 200 で応答しました。v3.2.6 より前は、/qorechain/reputation/v1/... のすべてのルートが HTTP 501({"code":12,"message":"Not Implemented"})で応答し、このモジュールには gRPC のみで到達できました。
| メソッド | エンドポイント | 説明 |
|---|---|---|
| GET | /qorechain/reputation/v1/params | スコアの重み(alpha、beta、gamma、delta)、lambda、min_score |
| GET | /qorechain/reputation/v1/validator/{address} | 1 つのバリデーターのレコード。{address} は qorvaloper1... のオペレーターアドレス、または qorvalcons1... のコンセンサスアドレスです。フィールドには composite_score、stake_score、performance_score、contribution_score、time_score、uptime_blocks、missed_blocks、last_updated_height が含まれます。404 はそのバリデーターにまだスコアがないことを意味し、オペレーターアドレスでもコンセンサスアドレスでもない文字列には 400 が返ります |
| GET | /qorechain/reputation/v1/validators | スコアが付いたすべてのバリデーターのレコード(reputations) |
スコアは 0 から 1 の間の 10 進文字列です。ライトノードは、バリデーターごとのルートを読み取り、委任先のバリデーターが min_reputation を下回ったときに警告します(報酬とモニタリングを参照)。同じルートは両方の公開ホストで動作します。
SVM クラスター識別情報(v3.2.7)
| メソッド | エンドポイント | 説明 |
|---|---|---|
| GET | /qorechain/svm/v1/cluster_info | v3.2.7(テストネットでは 2026年11月6日から、メインネットでは 2026年11月12日から。古いノードでは 501)。SVM クラスターの識別情報: chain_id、genesis_hash、caip2_chain_id(Wallet Standard のチェーン ID)、derivation、execution_enabled |
2026年11月7日に、テストネットは genesis_hash として 6Z9pa53SwiprqiAoNCqqUdj5c3C4P1zRw31gQVnF4Czj、caip2_chain_id として solana:6Z9pa53SwiprqiAoNCqqUdj5c3C4P1zR、execution_enabled として false を返しました。ジェネシスハッシュはチェーン ID から導出されます(固定ラベルとチェーン ID の SHA-256 を base58 でエンコードしたもの)ので、安定しています。同じ値は SVM JSON-RPC の getGenesisHash と getVersion にもあります(JSON-RPC Solana 互換を参照)。SVM はオフのままで、execution_enabled は false です。2026年11月12日に、メインネットは chain_id として qorechain-vladi、genesis_hash として 4LQ9znKk8J3C8YBz2unNdqRCC35ZXvSiFN9YGJNwu3er、caip2_chain_id として solana:4LQ9znKk8J3C8YBz2unNdqRCC35ZXvSi、execution_enabled として false を付けて 200 を返しました。メインネットでも SVM レーンはオフのままです。
gRPC 専用モジュール
メインネット(ノードリリース v3.2.7 は 2026年11月12日から。モジュール一覧は 2026年11月4日に v3.2.6 で確認したもので、svm の行は除く)では、これらのモジュールには gRPC の Query サービスはありますが、表の例外を除き REST ルートはありません。サービス名は qorechain.<module>.v1.Query の形式です。
| モジュール | gRPC クエリメソッド(メインネット、チェーンバージョン v3.2.7) |
|---|---|
ai | Config, Stats |
crossvm | PendingMessages(v3.2.5 以降は REST でも提供: Params は /qorechain/crossvm/v1/params、Message は /qorechain/crossvm/v1/message/{id}) |
reputation | Params(v3.2.6 以降は REST でも提供。Reputation モジュールを参照) |
rlconsensus | AgentStatus, Params, Observation, Reward, Policy, AppliedParams, LastAction(v3.2.6 以降は REST でも提供) |
svm | Slot, Account, Program(v3.2.7 では両ネットワークで ClusterInfo が追加され、REST でも提供。SVM クラスター識別情報を参照) |
qca | Config |
rlconsensus のクエリは、v3.2.6 以降両ネットワークで REST で提供されています(AppliedParams と LastAction の2つのメソッドが追加)。RL Consensus モジュールを参照してください。自分のノードに対して grpcurl を使用するか、CLI クエリコマンドを使用してください。rdk のクエリは REST でも利用できます(RDK モジュールを参照)。v3.2.2 より前は gRPC のみでした。
xQORE、BTC リステーキング(Babylon)、FairBlock の各モジュールには、現在のリリースではクエリサービス自体がなく、REST でも gRPC でも利用できません。v3.2.2 より前はクエリサービスがなかったインフレーションモジュールとガスアブストラクションモジュールは、REST で提供されています(Inflation モジュールと Gas Abstraction モジュールを参照)。
標準ルート
標準の Cosmos SDK、IBC、EVM、QoreChain Native の REST ルートも提供されています。両ネットワークで確認済みの例を示します。
| エンドポイント | 説明 |
|---|---|
/cosmos/bank/v1beta1/supply | 総供給量 |
/cosmos/bank/v1beta1/balances/{address} | アカウント残高 |
/cosmos/staking/v1beta1/validators | バリデーター |
/cosmos/staking/v1beta1/params | ステーキングパラメータ |
/cosmos/distribution/v1beta1/params | ディストリビューションパラメータ |
/cosmos/gov/v1/params/voting | ガバナンスパラメータ |
/cosmos/slashing/v1beta1/params | スラッシングパラメータ |
/cosmos/upgrade/v1beta1/current_plan, /applied_plan/{name} | 保留中 / 適用済みのアップグレード(メインネットでは applied_plan/v3.2.3 が {"height":"3662051"} を返します) |
/cosmos/circuit/v1/disable_list | ネットワーク全体で無効化されたメッセージタイプ |
/cosmos/base/node/v1beta1/config | ノードの最低ガス価格(両ネットワークで 0.1uqor) |
/cosmos/base/tendermint/v1beta1/blocks/latest | 最新ブロック |
/cosmos/tx/v1beta1/txs, /txs/{hash}, /txs/block/{height} | トランザクションの検索 / 参照 / ブロック別 |
/cosmos/evm/vm/v1/params | EVM モジュールパラメータ |
/cosmos/evm/feemarket/v1/params | EVM フィーマーケットパラメータ |
/cosmwasm/wasm/v1/codes/params | QoreChain Native のアップロード/インスタンス化の権限 |
/ibc/apps/transfer/v1/params | IBC 転送パラメータ |
/ibc/core/client/v2/counterparty_info/{client_id} | v3.2.6。クライアントに登録された IBC v2 のカウンターパーティ(なければ 404) |
/ibc/core/client/v2/config/{client_id} | v3.2.6。IBC v2 クライアント設定(allowed_relayers) |
/cosmos/evm/erc20/v1/token_pairs, /token_pairs/{token} | ERC20 トークンペア(テストネット: 3つの Fest テストトークンと1つの IBC トークン、メインネット: なし) |
QoreChain Native のプレフィックスは /cosmwasm/wasm/v1/... です。/cosmos/wasm/v1/... は提供されていません。
IBC v2 クライアントルート(v3.2.6)
IBC v2 クライアントのクエリサービスはこれまでも gRPC で提供されていましたが、REST ルートはありませんでした。v3.2.6 でこれらがマウントされます。リレイヤーは、ここからクライアントのカウンターパーティを読み取ります。どちらのルートもパスにクライアント ID を取ります(例: 07-<type>-0)。空の ID は 400 で応答します。テストネットでは 2026年10月27日に、メインネットでは 2026年11月4日に確認:
| ルート | テストネット | メインネット(v3.2.6) |
|---|---|---|
/ibc/core/client/v2/counterparty_info/{client_id} | カウンターパーティとともに 200。登録されていないクライアントには 404(client 07-<type>-0 counterparty not found)。空の ID は 400 で応答 | 同じ形: カウンターパーティのないクライアントには 404(client 07-tendermint-0 counterparty not found)(メインネットにはまだ IBC クライアントがありません) |
/ibc/core/client/v2/config/{client_id} | 200、{"config":{"allowed_relayers":[]}}(空のリストは任意のリレイヤーを意味します) | 200、{"config":{"allowed_relayers":[]}} |
/ibc/core/channel/v2/clients/{client_id}/next_sequence_send、/packet_commitments、およびその他の IBC v2 チャネルルート | 応答する(クライアントに記録がなければ 404、コミットメントは空のリストで 200) | 応答する、同じ形(2026年11月4日に確認) |
IBC v1 のルート(/ibc/core/client/v1/...、/ibc/core/channel/v1/...)は両ネットワークで応答します。本稿執筆時点で、テストネットには IBC クライアントが1つ、開いている転送チャネルが1つ(channel-0、IBC 建てのトークン1つ)あり、メインネットには IBC クライアント、チャネル、IBC 建てトークンはありません。レート制限モジュールは /Stride-Labs/ibc-rate-limiting/ratelimit/ratelimits で応答し、08-wasm のチェックサム一覧は /ibc/lightclients/wasm/v1/checksums で応答します。両ネットワークで、前者は空の rate_limits リスト(制限は設定されていません)を、後者は空の checksums リストを返します。メインネットは 2026年11月4日にどちらにも 200 で応答しました(v3.2.6 より前は 501)。パケット転送のクエリルート /ibc/apps/packetforward/v1/params はメインネットで 501 で応答しました。そのための公開ルートは見つからなかったため、メインネットでは REST でその設定を読み取れません。
テストネットのテストトークン(Fest)
以下の3つのトークンは qorechain-diana テストネットにのみ存在します。これらはビルダー向けのテストトークンで、価値はなく、メインネットには ERC20 トークンペアが一切ありません(2026年10月27日に確認: token_pairs は空で、バンクの供給量は uqor のみです)。ガバナンスは 2026年10月27日にこれらを ERC20 トークンペアとして登録しました(提案 26)。
テストネットでは、登録された ERC20 トークンはバンクコインとしても存在するため、保有、送信、そして AMM プールの2つ目の denom として使用できます。バンクの denom は erc20: に続けてコントラクトアドレスを EIP-55 の大文字小文字混在チェックサム形式で記したもので、denom 文字列は大文字と小文字が区別されます。すべて小文字の表記は別の文字列であり、見つかりません。
| トークン | コントラクトアドレス | バンク denom | 小数桁数 |
|---|---|---|---|
| fUSD (FestUSD) | 0x97143B771D34ddb9130b807b135Ae675A5a963CA | erc20:0x97143B771D34ddb9130b807b135Ae675A5a963CA | 6 |
| fETH (FestETH) | 0x02292293c13880a26242690eb70a0e42B8E91c28 | erc20:0x02292293c13880a26242690eb70a0e42B8E91c28 | 18 |
| fBTC (FestBTC) | 0x4604e7E45b2ecdbfbDc157103f5B2b62cb16451A | erc20:0x4604e7E45b2ecdbfbDc157103f5B2b62cb16451A | 8 |
# the three tokens and their display names / decimals
curl -s https://api-testnet.qore.host/cosmos/bank/v1beta1/denoms_metadata
# one denom: the case matters (this returns the metadata, the lowercase spelling returns 404)
curl -s "https://api-testnet.qore.host/cosmos/bank/v1beta1/denoms_metadata/erc20:0x97143B771D34ddb9130b807b135Ae675A5a963CA"
# the ERC20 token pairs, and the supply of one denom
curl -s https://api-testnet.qore.host/cosmos/evm/erc20/v1/token_pairs
curl -s "https://api-testnet.qore.host/cosmos/bank/v1beta1/supply/by_denom?denom=erc20:0x97143B771D34ddb9130b807b135Ae675A5a963CA"
denoms_metadata は各トークンを、symbol が fUSD / fETH / fBTC、display が FestUSD / FestETH / FestBTC、小数桁数が表示単位の指数として一覧します。残高クエリ(/cosmos/bank/v1beta1/balances/{address})は、保有者の残高のうち変換済みの部分を erc20:... denom の下に表示します。まだ EVM 側に保有されているトークンは、ERC20 コントラクト自身の balanceOf に表示されます。2つの形式間の変換は MsgConvertERC20(EVM からバンクへ)と MsgConvertCoin(バンクから EVM へ)で行い、MsgConvertERC20 の送信者は qor1 bech32 アドレスで記述する必要があります。EVM 開発を参照してください。
gRPC リフレクション
自分で実行しているノードは、ポート 9090 で gRPC を提供します。サーバーリフレクションが有効な場合、grpcurl などのツールで利用可能なサービスを検出できます。
grpcurl -plaintext localhost:9090 list
特定のサービスをクエリするには次のようにします。
grpcurl -plaintext -d '{"address":"qor1..."}' localhost:9090 qorechain.pqc.v1.Query/Account
qorechain.pqc.v1.Query にはv3.2.3 のノードで Account、EVMWindow、EVMDelegationConsent の3つのメソッドがあり、v3.2.4 から(テストネットでは 2026年10月19日から、メインネットでは 2026年10月23日から)4つ目の ProtocolFeatures があります。Params メソッドは v3.2.6 で追加されます(テストネットでは 2026年10月27日から、メインネットでは 2026年11月4日から)。v3.2.6 より古いノードには Params メソッドはありません。リリース v3.2.7(両ネットワーク)では、PQC マルチシグとテキスト署名で説明したマルチシグとテキストドキュメントのルートが追加されます。
認証
すべての REST および gRPC エンドポイントは、デフォルトでは認証なしでアクセスできます。本番環境にデプロイする場合は、ノードの前段にリバースプロキシ(Nginx や Caddy など)を配置し、TLS 終端とアクセス制御を行ってください。