QoreChainに5分でデプロイ
このページは、QoreChainを一度も使ったことのないSolidity開発者向けです。FoundryまたはHardhat、そしてMetaMaskで使っているのと同じリカバリーフレーズはそのまま使えます。新しく必要になるのは、短い承認ウィンドウだけです。QoreChainはすべてのアカウントをポスト量子鍵で保護しますが、Ethereumトランザクションにはそれを載せられません。そのため、まず上限付きのウィンドウを開き、それが開いている間は通常のEVMトランザクションが受け付けられます。以下の手順はテストネット(qorechain-diana、EVMチェーンID 9800)を使用しており、実際のお金はかかりません。
この手順はテストネットで実行されています。QoreXでウィンドウを開き、同じリカバリーフレーズからFoundryのcastでコントラクトを作成して呼び出しました。forge createとHardhatも同じ種類のEVMトランザクションを送信しますが、この実行には含まれていません。qorechaindのコマンドラインからウィンドウを開く方法も確認済みです。代替手段: コマンドラインを参照してください。
必要なもの
- デプロイに使いたいアカウントのリカバリーフレーズ。QoreXは生の秘密鍵をインポートできません。秘密鍵しかない場合は、代わりにコマンドラインを使用してください。
- QoreChainのウォレットであるQoreX(アプリまたはブラウザ拡張機能)。
- インストール済みのFoundryまたはHardhat。
1. QoreXにcoin-60アカウントを追加する
EVMレーンは eth_secp256k1 鍵(coin type 60)でのみ機能します。標準のsecp256k1 Cosmos鍵(coin type 118、QoreXのデフォルト)は、そのEVMアドレスの署名ができないため、coin-118アカウントで開いたウィンドウはEVMツールには役に立ちません。必要なのはEthereumアカウント(coin 60)です。QoreXでアカウントを開き、Ethereumアカウントを追加(coin 60)をタップします。QoreXは、ウォレット自身のリカバリーフレーズからEthereumパスm/44'/60'で導出します。その0x…アドレスがMetaMaskやFoundryと同じになるのは、それらが同じフレーズを使っている場合に限られます(Foundryの場合は、導出パスm/44'/60'/0'/0/0、インデックス0)。MetaMaskのアカウントが別のフレーズに由来する場合、QoreXには別のアドレスが表示され、そこで開いたウィンドウはデプロイに使う鍵をカバーしません。0x…アドレスは、QoreChain上のqor1…アドレスと同じ鍵です。
このアカウントには独自のアドレスがあるため、次の手順の前に資金を入れ、QoreXで選択してください。MetaMaskまたはDashboardからフレーズを復元するを参照してください。
テスト用に作成したリカバリーフレーズを使い、テスト用のQORのみを入れてください。実際の資金があるアカウントのフレーズを、Foundry、Hardhat、スクリプトに入力しないでください。
2. QoreXをテストネットに切り替える
- アプリ: 設定 → テストネットを使用(開発者向け)。
- ブラウザ拡張機能: ロックを解除し、下部のバージョン番号を7回タップして、テストネット(diana)に切り替えを選びます。
ホームのネットワークバッジがTESTNETに変わります。
3. テストネットのQORを入手する
Dashboardのフォーセットから、0x…またはqor1…アドレス宛てにテストネットのQORをリクエストしてください。アドレスのどちらの形式でも残高は同じです。
4. QoreXでEVMウィンドウを開く
- 拡張機能とアプリ: メインのポップアップまたはホームにある、MetaMask on QoreChainというタイトルのカード(0xマーク付き)。これでEVMアクセスウィンドウ画面が開きます。
- アプリ: 設定 → セキュリティ → EVMアクセスウィンドウからも開けます。
このアカウントにまだポスト量子鍵がない場合、QoreXはこの手順で自動的に登録します。登録費用はアカウントごとに一度だけ0.09 QORで、ウィンドウのトランザクションにはそれとは別にネットワーク手数料がかかります。続いて、3つの制限を選びます。
| 項目 | 範囲 | QoreXのデフォルト |
|---|---|---|
| ブロック数(ウィンドウが開いている期間) | 1〜17,280 | 300 |
| 最大トランザクション数 | 1〜1,000 | 5 |
| 支出上限(QOR単位) | 0より大きい値 | 1 |
支出上限には、各トランザクションの金額に加えて、その最大手数料(ガス上限 × 手数料上限)が計上され、送金額だけではありません。コントラクトのデプロイはQORを移動しませんが、それでも最大手数料が計上されます。Hardhatが送信する3,000,000ガスのデプロイは、約0.64 QORとして計上されます。
デプロイ用のセッションでは、デフォルトでは小さすぎます。妥当な設定は、3,000ブロック(テストネットで約1時間)、20トランザクション、上限10 QORです。セッションが許す範囲でできるだけ小さく保ち、終わったらウィンドウを閉じてください。
ウィンドウを開くと、アカウントのnonceが進みます。デプロイの前に開いてください。それより前に署名されたトランザクションは「nonce too low」で拒否されます。
5. FoundryまたはHardhatでデプロイする
同じ資金入りのcoin-60アカウントの鍵を使用してください。QoreXはFoundryの署名者としては動作しないため、FoundryまたはHardhatには同じリカバリーフレーズから得た鍵を渡します。たとえばFoundryでは、インデックス0で--mnemonicを使います。ネットワークの設定は次のとおりです。
| 設定 | 値 |
|---|---|
| RPC URL | https://evm-testnet.qore.host |
| チェーンID | 9800 |
| 通貨 | QOR、18桁 |
Foundry
export ETH_RPC_URL=https://evm-testnet.qore.host
forge create src/Counter.sol:Counter --private-key $DEPLOYER_KEY --broadcast
cast send <contract> "increment()" --private-key $DEPLOYER_KEY
cast call <contract> "number()(uint256)"
Hardhat
// hardhat.config.js
module.exports = {
solidity: "0.8.24",
networks: {
diana: {
url: "https://evm-testnet.qore.host",
chainId: 9800,
accounts: [process.env.DEPLOYER_KEY],
},
},
};
DEPLOYER_KEY=0x... npx hardhat run scripts/deploy.js --network diana
送信するすべてのトランザクション(デプロイでも呼び出しでも)は、ウィンドウのトランザクション数を1つ消費します。読み取り(cast call、view関数、ガス見積もり)にはウィンドウは不要で、消費もしません。
ウィンドウの確認と期限切れへの対処
ウィンドウは期限切れになります。ブロック数、トランザクション数、または支出上限が尽きると、EVMレーンは次のトランザクションをno open EVM authorisation windowまたはEVM authorisation window exhaustedで拒否します。QoreXで新しいウィンドウを開いてください。新しいウィンドウは古いものを置き換えます。
状態を確認するには、dashboard.qorechain.io/developersのPQ key statusタブ(開発者を参照)か、RESTルートを使用します。
curl -s https://api-testnet.qore.host/qorechain/pqc/v1/evm_window/<qor1-address>
live: trueで、remaining_blocks、remaining_txs、remaining_value(uqor単位)が表示されていれば、ウィンドウは開いています。
代替手段: コマンドライン
qorechaindのリリースバイナリがあれば、QoreXなしで、生の秘密鍵のインポート、そのポスト量子鍵の登録、ウィンドウを開くことまで行えます。これは秘密鍵しか持っていない開発者向けの方法です。gen-keyとcosignはコミュニティビルドには含まれないため、リリースバイナリが必要です。ウィンドウのルールは、EVM開発のEVM承認ウィンドウのセクションにあります。この方法で開いたウィンドウの後にcastでトランザクションを送信する流れは、テストネットで確認済みです。
export QNODE=https://rpc-testnet.qore.host:443
export QCHAIN=qorechain-diana
# import the private key as an eth_secp256k1 key: the qor1... and 0x... addresses are one account
qorechaind keys import-hex deployer <private-key-hex-without-0x> --key-type eth_secp256k1
# register a post-quantum key once per account (back up the .dilithium file)
qorechaind tx pqc gen-key deployer-mldsa
qorechaind tx pqc register-key-v2 dilithium5 <public_key_hex> hybrid --pqc-key deployer-mldsa \
--from deployer --chain-id $QCHAIN --node $QNODE --gas auto --gas-adjustment 1.3 --gas-prices 0.2uqor
# open the window
qorechaind tx pqc open-evm-window 3000 20 10qor --from deployer \
--chain-id $QCHAIN --node $QNODE --gas 400000 --fees 80000uqor --generate-only > window.json
qorechaind tx pqc cosign window.json --from deployer --pqc-key deployer-mldsa \
--chain-id $QCHAIN --node $QNODE
デプロイ用のウィンドウを--native-onlyや--allowed-targetsで絞り込まないでください。どちらもコントラクトの作成を拒否します。これらは、コントラクトが存在するようになった後の、以降のセッション向けです。
テストネットでの違い
- CosmWasmは、テストネットではガバナンスで承認されたコードのみを受け付けるため、独自のコントラクトをそこにアップロードすることはできません。公開されている経路はSolidityです。
- SVMは利用できません。
- メインネットも同じ方法で動作し、チェーンIDは9801、エンドポイントは
https://evm.qore.hostですが、まずはテストネットから始めてください。
よくあるエラー
| メッセージ | 原因 | 対処 |
|---|---|---|
account ... has no registered post-quantum key | アカウントにML-DSA-87鍵がない | QoreXでウィンドウを開く(登録も行われます)か、コマンドラインから登録する |
no open EVM authorisation window | ウィンドウがない、または期限切れ | ウィンドウを開く |
EVM authorisation window exhausted | トランザクション数または支出上限を使い切った | より大きな制限で新しいウィンドウを開く |
nonce too low | 署名した後にウィンドウを開いた | 先にウィンドウを開き、それから送信する |
only replay-protected (EIP-155) Ethereum transactions are accepted | チェーンIDなしで署名されたトランザクション | ネットワーク設定でchainIdを設定する |
次へ: EVM開発、QoreXのセキュリティとリカバリー、開発者。