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

ウォレットのセットアップ

QoreChain は、ネイティブ・EVM・SVM の各実行環境にわたって複数のウォレットタイプをサポートしています。ユースケースに合ったウォレットを選択してください。

注記

以下の値は、qorechain-vladi メインネット(EVM チェーン ID 9801、2026 年 6 月 7 日より稼働中)と qorechain-diana テストネット(EVM チェーン ID 9800)の両方を対象としています。両ネットワークの公開エンドポイントはネットワークに記載されています。

Keplr ウォレット​

Keplr は、QoreChain のネイティブトランザクション、ステーキング、ガバナンスに推奨されるウォレットです。

QoreChain をカスタムチェーンとして追加する​

Keplr を開き、Settings > Add Custom Chain に移動して、次の値を入力します。

項目メインネットテストネット
チェーン名QoreChainQoreChain Diana Testnet
チェーン IDqorechain-vladiqorechain-diana
RPC URLhttps://rpc.qore.hosthttps://rpc-testnet.qore.host
REST URLhttps://api.qore.hosthttps://api-testnet.qore.host
Bech32 プレフィックスqorqor
コインデノムQORQOR
コイン最小デノムuqoruqor
小数点桁数66
コインタイプ(BIP-44)118118

チェーンを追加すると、Keplr はアカウント用の qor1... アドレスを生成します。

ガス価格の下限

ネットワークの最低ガス価格は 0.1uqor です。Keplr のガス価格ステップを設定する場合(例:suggestChain 経由)は、0.1 以上の値を使用してください(推奨の low/average/high:0.1 / 0.15 / 0.25)。下限を下回る価格で署名されたトランザクションは拒否されます。

MetaMask(EVM)​

MetaMask を使うと、QoreChain の EVM 実行環境とやり取りできます。Solidity コントラクトのデプロイ、ERC-20 トークンの管理、使い慣れた Ethereum ツールの利用が可能です。

QoreChain をカスタムネットワークとして追加する​

MetaMask を開き、Settings > Networks > Add Network に移動して、次の値を入力します。

項目メインネットテストネット
ネットワーク名QoreChainQoreChain Diana Testnet
RPC URLhttps://evm.qore.hosthttps://evm-testnet.qore.host
チェーン ID98019800
通貨シンボルQORQOR
ブロックエクスプローラー URLhttps://explore.qore.networkhttps://explore.qore.network

ネイティブ QOR は EVM インターフェイス上では 18 桁の小数(wei 方式)を持ちます。接続後は、MetaMask を使って EVM トランザクションへの署名、デプロイ済みスマートコントラクトとのやり取り、QoreChain 上の ERC-20 トークンの管理ができます。

ワンコールでのネットワーク登録​

dApp 向けには、npm で公開されている @qorechain/wallet-adapter および @qorechain/connect パッケージが、ユーザーのウォレットへの QoreChain の登録をワンコールで行います。EIP-3085 経由で MetaMask にネットワーク追加を促し(EVM レール上の正しい 18 桁小数のネイティブ QOR を含む)、Keplr のガス価格ステップも設定します。

npm install @qorechain/wallet-adapter @qorechain/connect
import { addQoreEvmToWallet } from "@qorechain/wallet-adapter";

await addQoreEvmToWallet(); // prompts MetaMask with QoreChain's EVM network params

1 つのアカウント、3 つのアドレス(統合アカウント)​

チェーンバージョン v3.1.83 以降、QoreChain のアカウントは 3 つのエンコーディングを持つ 1 つの 20 バイトのアイデンティティです:qor1…(Native)、0x…(EVM)、base58 形式(SVM)。アカウントは単一の残高を保持し、eth ネイティブアカウントの場合は、Native パスで必須となるポスト量子ハイブリッド署名を含め、1 つの鍵で 3 つのレーンすべてに署名します。

@qorechain/wallet-adapter を使ってコードで統合ウォレットを生成できます。

import { generateQoreWallet } from "@qorechain/wallet-adapter";

const w = await generateQoreWallet();          // or walletFromMnemonic(mnemonic)
console.log(w.addresses.cosmos);               // qor1...
console.log(w.addresses.evm);                  // 0x... (same identity)
console.log(w.addresses.svm);                  // base58 (same identity)
// Native-lane sends use signHybridEth (classical eth_secp256k1 + ML-DSA-87 hybrid).

3 つの形式のいずれに送金しても、資金は同じ残高に着金します。

リンクされたウォレット:支出鍵としての Phantom と MetaMask​

チェーンバージョン v3.1.85 以降、dApp 内で QoreChain アカウントから支出するためにルート鍵を晒す必要はありません。Phantom(ed25519)または MetaMask(その Ethereum アドレスによる、personal_sign 経由)の鍵を、アカウントのオーセンティケーターとして登録できます。スコープ付きの権限、支出上限、有効期限、即時失効を備え、dApp のバックエンドがリレーする送金を承認できます。モデル全体とコードについてはリンクされたウォレットのオーセンティケーターを、エンドツーエンドの例については SDK オーセンティケーターガイドを参照してください。

Solana ウォレット(SVM)​

QoreChain の SVM 実行環境は標準的な Solana ツールと互換性があり、アカウントのネイティブ QOR 残高は SVM インターフェイス上で直接参照できます(lamports 単位、9 桁の小数。1 uqor = 1,000 lamports)。Solana 互換のウォレットまたはライブラリを接続してください。

@solana/web3.js の使用​

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

// Public read-only endpoint (or http://localhost:8899 on your own node)
const connection = new Connection("https://svm.qore.host");
const slot = await connection.getSlot();
console.log("Current slot:", slot);

公開 SVM エンドポイントは読み取り専用です。トランザクションの送信には自前のノードが必要です。詳細は SVM 開発を参照してください。

PQC 対応ウォレット(Cosmos パスでは必須)​

QoreChain は cosmos トランザクションパスにおいてハイブリッドなポスト量子暗号(PQC)を必須としています。現行のチェーンバージョン(v3.1.82)時点で、ネットワークのデフォルトは hybrid_signature_mode = required かつ allow_classical_fallback = false です。つまり、すべての cosmos パスのトランザクションは、標準の secp256k1(ECDSA)署名に加えて ML-DSA-87(Dilithium-5)署名を含める必要があります。PQC アカウントからの古典署名のみの cosmos トランザクションは拒否されます。

Cosmos トランザクションにはハイブリッド PQC 拡張が必要

cosmos パスで通常の古典的トランザクションを送信すると拒否されます。Dilithium-5 署名を PQCHybridSignature トランザクション拡張として添付する必要があります。標準の CosmJS / Keplr ツールは単独ではこの拡張を生成しません。qorechaind tx pqc cosign CLI コマンド、QoreChain SDK のハイブリッド署名(下記参照)、またはコードで自作する場合はオープンソースの qorechain-pqc ライブラリ(hybridSignBytes)を使用してください。唯一の例外は、ジェネシスの gentx と PQC 鍵の登録/移行トランザクションです。

仕組み​

ウォレットは、標準の secp256k1(ECDSA)署名と併せて、ML-DSA-87 の PQC 署名をトランザクション拡張として添付します。古典署名は拡張を除外した署名バイト列に対して計算されるため、古典的な検証に対して有効なまま、PQC 署名が量子耐性を提供します。

Dilithium-5 鍵の生成​

ハイブリッド署名用のポスト量子鍵を生成します。

qorechaind tx pqc gen-key

自動登録​

最初のトランザクションに PQC 公開鍵を含めると、QoreChain が自動的にオンチェーンで登録します。個別の登録手順は不要です。(PQC 鍵の登録/移行トランザクション自体はハイブリッド要件から免除されているため、アカウントは最初の鍵をブートストラップできます。)

SDK によるハイブリッド署名​

QoreChain SDK は、includePqcPublicKey: true を指定した buildHybridTx によって準拠した cosmos トランザクションを生成します。これにより Dilithium-5 拡張が添付され、自動登録用の公開鍵が埋め込まれます。SDK アカウントと PQC 署名を参照してください。

PQC モード​

3 つの強制モードは引き続きガバナンスで制御されます。現在のネットワークデフォルトは Required です。

モード説明
DisabledPQC 検証は無効です。標準署名のみが使用されます。
Optionalトランザクションは PQC 署名を含めることができます。含まれている場合は検証されます。
Required(デフォルト)すべての cosmos パスのトランザクションは有効な PQC 署名を含める必要があります。

有効なモードはチェーンレベルで設定され、ガバナンスを通じて更新できます。

EVM / MetaMask には影響なし

上記の MetaMask(EVM)フローは、ハイブリッド要件の影響を受けません。EVM トランザクションは別個の eth_secp256k1 ante パスを使用し、PQC 拡張を必要としません。

CLI ウォレット​

qorechaind バイナリには、コマンドライン用の組み込み鍵管理システムが含まれています。

新しい鍵の作成​

qorechaind keys add mykey

これにより新しい鍵ペアが生成され、ニーモニックフレーズが表示されます。ニーモニックは安全に保管してください — この鍵を復元する唯一の手段です。

アドレスの表示​

qorechaind keys show mykey -a

これにより qor1... 形式の bech32 アドレスが出力されます。

すべての鍵の一覧表示​

qorechaind keys list

既存の鍵のインポート​

qorechaind keys add mykey --recover

ニーモニックフレーズの入力を求められます。

次のステップ​