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

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,280300
最大トランザクション数1〜1,0005
支出上限(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 URLhttps://evm-testnet.qore.host
チェーンID9800
通貨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のセキュリティとリカバリー、開発者。