ポスト量子署名
qorechain-pqc は、QoreChain を支えるオープンソースかつ標準規格のみに準拠したポスト量子暗号ライブラリです。ウォレット、インテグレーター、ツール開発者に対して、チェーンが使用しているものと全く同じプリミティブを 6 つの言語で、一貫した単一の API として提供し、共通のクロス言語テストベクタスイートによってバイト互換性が証明されています。
このライブラリは、最終確定した NIST 標準の監査済み実装をラップしています。独自方式を発明することはありません。非標準の変種こそが相互運用性を壊す原因です(ある場所で生成された署名が別の場所で検証できなくなります)。すべてのバインディングは同一のテストベクタで検証されているため、ある言語で生成された ML-DSA 署名は他のすべての言語で検証でき、ML-KEM の共有秘密は 6 言語すべてで一致し、SHAKE-256 のダイジェストも同一になります。
- リポジトリ:
github.com/qorechain/qorechain-pqc - ライセンス: Apache-2.0
プリミティブ
| プリミティブ | 標準規格 | 役割 | レベル(デフォルトは太字) |
|---|---|---|---|
| ML-DSA | FIPS-204 | デジタル署名 | 44 · 65 · 87 |
| ML-KEM | FIPS-203 | 鍵カプセル化 | 512 · 768 · 1024 |
| SHAKE-256 | FIPS-202 | 拡張可能出力ハッシュ | — |
これらは QoreChain がプロトコルレベルで実行しているものと同じプリミティブです。すなわち ML-DSA-87 (Dilithium-5) 署名、ML-KEM-1024 鍵カプセル化、そしてデフォルトのアプリケーションハッシュとしての SHAKE-256 です。チェーンがこれらをどのように使用しているかはポスト量子セキュリティを参照してください。
サイズ(バイト)
サイズとセキュリティの予算に応じてセキュリティレベルを選択してください。
| 方式 | セキュリティ | 公開鍵 | 署名 / 暗号文 |
|---|---|---|---|
| ML-DSA-44 | L2 | 1312 | 2420 |
| ML-DSA-65 | L3 | 1952 | 3309 |
| ML-DSA-87 | L5 | 2592 | 4627 |
| ML-KEM-512 | L1 | 800 | 768 |
| ML-KEM-768 | L3 | 1184 | 1088 |
| ML-KEM-1024 | L5 | 1568 | 1568 |
NIST 標準を小さくして、なお標準のままでいることはできません。ML-DSA-87 の鍵・署名サイズおよびバイト列は固定されており、これを「最適化」すると他のどの実装でも検証できない非標準の変種が生まれます。オンチェーンのフットプリントを縮小するには、方式そのものを改変するのではなく、後述のレバーを使用してください。
対応言語とパッケージ
すべての言語が同じ API を公開しており、それぞれ異なる監査済み実装に支えられています。これこそがバイト互換性を保証する仕組みです — 独立したバックエンド同士が標準規格の上で一致するのです。
| 言語 | パッケージ | インストール | バックエンド |
|---|---|---|---|
| JavaScript / TypeScript | @qorechain/pqc (npm) | npm i @qorechain/pqc | @noble/post-quantum |
| Rust | qorechain-pqc (crates.io) | cargo add qorechain-pqc | fips204 · fips203 · sha3 |
| Python | qorechain-pqc (PyPI) | pip install qorechain-pqc(インポートは qorpqc) | liboqs-python |
| Go | github.com/qorechain/qorechain-pqc/go | go get github.com/qorechain/qorechain-pqc/go | Cloudflare CIRCL |
| C | c/(静的ライブラリ + ヘッダー) | リポジトリからビルド | liboqs + OpenSSL |
| Java | io.github.qorechain:qorechain-pqc (Maven Central) | io.github.qorechain:qorechain-pqc:0.2.3 | Bouncy Castle |
JavaScript、Rust、Python、Go、Java の各バインディングはすべてバージョン 0.2.3 として公開済みです(npm、crates.io、PyPI、v0.2.3 としての Go モジュールプロキシ、Maven Central。2026年10月21日に確認)。上記のコマンドでインストールできます。Python ディストリビューションは qorechain-pqc としてインストールされますが、インポート名は qorpqc です。Java パッケージは io.github.qorechain:qorechain-pqc:0.2.3(Bouncy Castle バックエンド)です。バージョン 0.2.0 でバージョン対応の hybridSignBytes(後述)が追加され、0.2.1 でメインネットの v2 への切り替えを示すアップグレード名が修正され、0.2.2 で hedged 署名と決定論的署名に関するドキュメントとコメントが修正されました(チェーンは両方を受け入れます。JavaScript バインディングでは、コード上で変わったのはバージョン定数だけです)。0.2.3 で暗号関連の依存ライブラリ(Java では Bouncy Castle、JavaScript では @noble/post-quantum)が更新されました(出力は同一です)。0.2.1 以降を使用してください。C バインディングは静的ライブラリ + ヘッダーであり、github.com/qorechain/qorechain-pqc からご自身でビルドします。
決定論的署名(デフォルト)
バージョン 0.1.1 以降(およびそれ以降のすべてのリリース)、sign() は 6 つのバインディングすべてで決定論的 ML-DSA 変種(FIPS-204 §3.4、署名乱数が 32 バイトのゼロであるもの)を生成します。チェーンは、hedged か決定論的かにかかわらず、有効な FIPS-204 ML-DSA-87 署名をすべて受け入れます。検証手順は両者で同一であり、秘密鍵なしに検証者が両者を区別することはできません。バインディングがデフォルトで決定論的に署名するのは、同じトランザクションが常に同じ署名と同じ tx ハッシュになり、すべてのバインディングが共有テストベクタと一致するようにするためです。
重要な事実:
- 決定論的な出力は、同じ鍵とメッセージに対して 6 つのバインディングすべてでバイト単位で同一です。共有のクロス言語テストベクタによって固定されています。
- hedged 署名は、各バインディングで明示的なオプトインとして引き続き利用できます(例: JavaScript では
{hedged: true}、Rust ではsign_hedged、Java ではmldsaSignHedged、Python ではsign(..., hedged=True))。hedged 署名も有効な FIPS-204 署名としてチェーンに受け入れられます。違いは、署名のたびに署名、したがって tx ハッシュが変わることだけです。 - JavaScript バインディングのバージョン 0.1.0 はデフォルトで hedged 署名を行っていました。それらの署名もオンチェーンで有効です。共有ベクタと一致する再現可能な署名が必要な場合は 0.1.1 にアップグレードしてください。
鍵の登録
すべてのアカウントは、ML-DSA-87 公開鍵を一度だけ、明示的に登録します。自動登録はありません。後続のハイブリッドトランザクションに埋め込まれた公開鍵(たとえば SDK の includePqcPublicKey オプション)は拡張に含まれて運ばれますが、鍵を登録しません。最初の登録は、従来型の署名で署名できる唯一の Cosmos レーンのトランザクションであり、新規アカウントが最初の鍵をブートストラップできるようになっています。すでに鍵を持つアカウントは、以降のすべての鍵メッセージにハイブリッド署名をしなければなりません。リリース版の qorechaind(公開ソースからビルドしたバイナリは署名できません。ソースからのビルドを参照)、QoreX、または SDK の ensurePqcRegistered で実行してください:
# 1. Create a key. It is stored unencrypted under ~/.qorechaind/pqc/mypqc.dilithium (mode 0600) and the public key hex is printed.
qorechaind tx pqc gen-key mypqc
# 2. Register the public key on your account (classical-signed, because the account has no key yet).
# --pqc-key mypqc also attaches the optional proof of possession (see below).
qorechaind tx pqc register-key-v2 dilithium5 <printed-pubkey-hex> hybrid --pqc-key mypqc \
--from mykey --chain-id qorechain-vladi --gas 600000 --fees 60000uqor -y
# 3. Verify.
qorechaind query pqc account <address>
--gas は明示的に設定してください。2,592 バイトの公開鍵はデフォルトの 200,000 ガスを超えることがあり(メインネットでの登録はおよそ 220,000〜310,000 を消費しています。所有証明付きの登録はさらに 4,627 バイトの署名を 1 つ運ぶため、約 46,000 ガス多くかかります)、手数料は少なくとも gas × 0.1 uqor 必要です。そのため --gas 600000 には --fees 60000uqor 以上が必要です。従来の形式 qorechaind tx pqc register-key <pubkey-hex> hybrid は Dilithium-5 では同等です。それ以降は、各 Cosmos レーンのトランザクションを --generate-only で構築し、qorechaind tx pqc cosign で署名します。鍵ファイルはアカウントのポスト量子署名鍵です。読み取れる人は誰でも従来型の鍵と合わせてアカウントの副署名ができてしまうため、ニーモニックと同様にバックアップしてください(ニーモニックから再導出できます。後述)。
登録済みの鍵は、EVM トランザクションを送信するための 2 つの要件のうちの 1 つ目でもあります。2 つ目は開いている EVM 認可ウィンドウです。
登録時にチェーンが確認する内容(メインネット v3.2.3 以降)
v3.2.3 アップグレード(2026年10月20日にブロック高 3,662,051 でメインネットに適用)以降、チェーンは鍵の長さが正しいかどうかだけでなく、鍵そのものを確認します:
| ルール | 拒否(codespace pqc) |
|---|---|
key_type は hybrid または pqc_only でなければなりません。classical_only はポスト量子鍵を登録せず、アカウントが再び署名できなくなってしまいます | コード 230 |
| ポスト量子保護を提供しない鍵(誰も秘密を必要としない縮退した鍵)は、登録、ローテーション、移行のいずれでも拒否されます | コード 230 |
| アカウントが以前に使用した鍵は、再登録することも、その鍵へローテーションで戻すこともできません(アカウントは廃止された鍵を記憶しています) | コード 232 |
| 登録に含まれる従来型の鍵は、署名者自身の圧縮 secp256k1 鍵でなければなりません(v3.2.2 以降) | コード 45 |
| 任意の所有証明は、存在する場合は検証に通らなければなりません | コード 231 |
| すでに鍵を保持しているアカウントは、以降のすべての鍵メッセージ(登録、移行)にハイブリッド署名をしなければなりません。使用可能な鍵を持たないレコードの修復のみ、従来型でも構いません | コード 234 |
| アルゴリズムの廃止や無効化によって、チェーンが有効な署名アルゴリズムを失うことはあってはなりません | コード 233 |
さらに v3.2.3 以降、どの鍵メッセージ(MsgRegisterPQCKey、MsgRegisterPQCKeyV2、MsgRotatePQCKey、MsgMigratePQCKey)も、authz を通じてアカウントに代わって送信することはできません。トランザクションが運べるハイブリッド署名拡張は最大1 つです。そして、登録済みの鍵を持たないアカウントは、検証対象のないハイブリッド拡張をもはや添付できません(拡張がまったくない場合と全く同様に、通過できるのは登録のみです)。
所有証明(任意)
登録では、登録者が新しい鍵の秘密を保持していることを証明することもできます。鍵は qorechain-pqc-pop-v1|<chain-id>|<algorithm id>|<address>|<public key hex> に署名し(アルゴリズム ID は ML-DSA-87 では 1、公開鍵は小文字の 16 進数)、その署名を MsgRegisterPQCKeyV2 の proof_of_possession フィールドに入れます。CLI では、register-key-v2 ... --pqc-key <name> がこれを構築して添付します。TypeScript SDK 0.9.0 では、ネットワークが v3.2.3 を適用した後は ensurePqcRegistered が自動的に証明を添付します(signProofOfPossession / verifyProofOfPossession で手動で作成・検証することもできます)。@qorechain/chain-bridge 0.2.3 も、cosmosRest を渡した場合は同様に動作します。@qorechain/wallet-adapter(0.4.0)と 0.9.0 より前の SDK リリースは添付しないため、それらを通じた登録には所有証明が含まれませんが、チェーンはそれでも受け入れます。チェーンは所有証明が存在する場合にそれを検証し、検証に通らなければ登録を拒否します(コード 231)。証明のない登録は、メインネットでは引き続き受け入れられます。メッセージにはチェーン、アルゴリズム、アカウント、鍵が明記されているため、それらのうち 1 つのために作られた証明は、別のものについては何も証明しません。
所有フラグとブリッジバリデーター(v3.2.4)。 アカウントレコードは、そのアカウントの現在の鍵が証明済みかどうかを報告します(GET /qorechain/pqc/v1/account/{address} の possession_proven)。鍵が検証済みの所有証明つきで登録された場合、またはローテーションによって設定された場合(新しい鍵がローテーションに署名することで、それが証明されます)は true となり、証明なしで登録したアカウントでは false のままです。このフラグは、誰が送信または受信できるかには何の影響も与えません。ブリッジバリデーターの登録には、さらにバリデーターのポスト量子鍵の所有証明が必要で(登録の proof_of_possession。鍵は qorechain-pqc-pop-v1|<chain-id>|1|<validator address>|<public key hex> に署名し、CLI では --pqc-key を使用します)、同じ鍵を 2 つのブリッジバリデーターが登録することはできません。クロスチェーンブリッジ自体は本番稼働していません。どちらの変更も、テストネットでは 2026年10月19日から、メインネットでは 2026年10月23日から有効です(v3.2.4、ガバナンス提案 13 により高さ 3,742,566 で適用)。
拒否コード(codespace pqc)
| コード | 意味 |
|---|---|
| 20 | ハイブリッド署名が必要です。トランザクションに PQC 拡張がありません(免除されるのは最初の登録と、鍵を持たないアカウントによる unjail のみです) |
| 21 | ML-DSA-87 部分が検証に通りませんでした。下記を参照してください |
| 26, 27, 28 | EVM レーン: 開いているウィンドウがない、または鍵がない / ウィンドウが使い切られた / ウィンドウの範囲が無効です。EVM 開発を参照してください |
| 45 | 登録に含まれる従来型の鍵が、署名者自身の圧縮 secp256k1 鍵ではありません |
| 60, 61 | EIP-7702 の委任: この委任に対するポスト量子の同意がありません / 委任リクエストが無効です |
| 62, 63 | 委任されたアカウントに、そのアクションを対象とするウィンドウがありません / Ethereum トランザクションは EVM レーンでのみ実行されます |
| 230 | 脆弱な鍵、または classical_only の登録 |
| 231 | 所有証明が検証に通りません |
| 232 | この鍵はこのアカウントで以前に使用されています |
| 233 | 有効な署名アルゴリズムが残らなくなります |
| 234 | 鍵を持つアカウントによる鍵の保守にはハイブリッド署名が必要です |
pqc コード 21(hybrid_verify_failed)のトラブルシューティング
コード 21 は、ハイブリッド署名の ML-DSA-87 部分が、アカウントに登録された鍵に対して検証されなかったことを意味します。hedged と決定論的のどちらで署名したかが原因になることは決してありません。次の順に確認してください:
- sign-bytes のバージョン。 PQC 署名は v1 または v2 の sign-bytes を対象とし、ネットワークは各高さで正確に 1 つの形式だけを検証します。
qorechain-dianaはv3.1.98アップグレードで v2 に切り替わり、qorechain-vladiはv3.2.0アップグレードで切り替わります。それ以降に生まれたチェーンはジェネシスから v2 です。現在の SDK はネットワークごとに形式を選択します。独自に構築した署名器は、どのアップグレードが適用済みかをノードに問い合わせる必要があります(アカウントと PQC 署名 を参照)。 - v2 sign-bytes 内のチェーン ID。 v2 はチェーン ID を束縛するため、
qorechain-diana用に作成した署名はqorechain-vladiでは検証されず、その逆も同様です。 - 古い PQC ライブラリ。 標準化前(FIPS-204 以前)のビルドは、標準準拠の検証器が拒否する署名を生成します。
qorechain-pqc0.1.1 以降を使用してください。 - 誤った鍵。 公開鍵はアカウントに登録されたものでなければなりません(
GET /qorechain/pqc/v1/account/{address})。別の導出方法で作った鍵(例えばアドレスに束縛された導出ではなく、旧来のブリッジ導出shake256(mnemonic))は有効に署名しますが一致しません。正規の鍵へ移行するには 鍵のローテーション を参照してください。
決定論的な鍵導出と復元
エコシステム標準の導出方式は、ML-DSA-87 鍵をアカウントに結び付けるため、アカウントのニーモニックのみから復元可能です:
seed = SHAKE-256("qorechain:pqc:v1|" + cosmosAddress + "|" + mnemonic)
(publicKey, secretKey) = mldsa.keygen(seed)
公開済みのすべてのツール(@qorechain/wallet-adapter、@qorechain/sdk、@qorechain/chain-bridge ≥0.1.1)がこの同じ鍵を導出するため、どのツールを使っても 1 つのニーモニックからは 1 つの鍵が生成されます。CLI で鍵を復元するには(ニーモニックは stdin から入力):
# the mnemonic is read from stdin; keep it out of shell history by redirecting from a file you delete afterwards
qorechaind tx pqc recover-key mykey qor1youraddress... < mnemonic.txt
# legacy tooling derivation (shake256(mnemonic) only, unbound to the address):
qorechaind tx pqc recover-key mykey qor1youraddress... --derivation bridge < mnemonic.txt
復元された秘密鍵は、tx pqc cosign で使用するために、暗号化されていない 16 進数(モード 0600)として <home>/pqc/mykey.dilithium に書き込まれます。
鍵ローテーション(同一アルゴリズム内)
チェーンバージョン v3.1.85 以降、MsgRotatePQCKey によってアカウントの ML-DSA-87 鍵を同一アルゴリズム内でローテーションできます — 以前は登録は一度きりであり、MigratePQCKey はアルゴリズム間の移行のみを扱っていました。レガシー導出の鍵を正規のアドレス結合導出方式に移行する場合や、危殆化した鍵を廃止する場合に使用してください。
ローテーションは二重署名されます。すなわち、旧鍵と新鍵の両方が、ドメイン分離されたメッセージ "qorechain-pqc-rotate-v1|chainId|algorithm|account|oldPubHex|newPubHex" に署名します。リプレイは構造的に不可能です — ローテーション完了後は旧鍵が登録済みの鍵と一致しなくなるため、同じメッセージを再適用することはできません。ローテーションはルート鍵のみの操作であり(オーセンティケーターに委任することは決してできません)、トランザクション自体は依然として旧鍵によるハイブリッド署名が行われ、現在の所有権を証明します。
ワンショット CLI(ニーモニックは stdin から入力。旧鍵を復元し、新鍵を導出または生成し、二重署名してブロードキャストします):
# migrate a legacy-derived key to the canonical derivation (mnemonic on stdin):
qorechaind tx pqc rotate-key --old-derivation bridge --new-derivation adapter \
--from mykey --chain-id qorechain-vladi --gas 600000 --fees 60000uqor -o json -y < mnemonic.txt
# rotate to a brand-new random key (compromise recovery); --new-key-out is required and is written before anything is sent:
qorechaind tx pqc rotate-key --old-derivation adapter --new-random --new-key-out mykey-new \
--from mykey --chain-id qorechain-vladi --gas 600000 --fees 60000uqor -o json -y < mnemonic.txt
ローテーションは 2,592 バイトの鍵 2 つと署名 3 つを運ぶため、送金よりもはるかに多くのガスが必要です。明示的な --gas 600000 と、少なくとも 60,000 uqor の手数料を維持してください。--new-key-out なしの --new-random は拒否されます(ノードリリース v3.2.1 以降)。これにより、ローテーションによって新しい鍵を失った状態になることはありません。
コード上では、@qorechain/wallet-adapter(≥0.1.7)および @qorechain/sdk(≥0.7.0)が同じフローを公開しています(同期処理で、メッセージと両方の鍵ペアを返します):
import { rotatePqcKeyMsgFromMnemonic } from "@qorechain/wallet-adapter";
// Builds the dual-signed MsgRotatePQCKey migrating shake256(mnemonic) -> canonical:
const { msg, oldKeypair, newKeypair } = rotatePqcKeyMsgFromMnemonic({
account: "qor1youraddress...", mnemonic, chainId: "qorechain-vladi",
});
// Sign & broadcast `msg` with the account's normal hybrid signer, using `oldKeypair` for the envelope's PQC signature.
SDK 0.9.0 以降と @qorechain/wallet-adapter 0.4.0 以降のローテーションヘルパーは、レガシー導出を新しい鍵として使うことを拒否します(アカウントに束縛されていないため)。レガシー鍵を旧鍵として使うことは引き続き可能です。ローテーションが成功すると、新しい鍵での署名は成功し(code 0)、古い鍵は拒否されます(pqc code 21)。v3.2.3 以降、ローテーションは(移行と同様に)ポスト量子保護を提供しない新しい鍵(コード 230)とアカウントが以前に使用した鍵(コード 232)を拒否し、authz を通じて送信することもできません。
チェーン v3.2.7: マルチシグ、テキスト署名、検証ガス
以下の項目は 2026年11月6日から qorechain-diana で稼働しています(ノードリリース v3.2.7、ブロック高 9,594,600)と、2026年11月12日から qorechain-vladi(ブロック高 4,164,600、ガバナンス提案 16)で稼働しています。メインネットでは、スイッチ pqc-multisig、pqc-verify-gas-calibrated、evm-window-used-event が有効です(2026年11月12日に GET /qorechain/pqc/v1/protocol_features から読み取り。機能は合計 101 個)。テキスト署名は v3.2.7 のバイナリに含まれており、スイッチは不要です。@qorechain/sdk 0.12.0 と @qorechain/rdk 0.8.0 のパッケージには、マルチシグやテキスト署名の項目のビルダーがないため(2026年11月7日に確認)、これらにはノードの CLI と REST を使用してください。
ハイブリッド k-of-n マルチシグ。 従来型のマルチシグアカウントは、それに従うポスト量子の署名者集合を持てるようになりました。新しいメッセージ /qorechain.pqc.v1.MsgRegisterPQCMultisig が集合を登録します。ポスト量子のメンバーと鍵は、従来型マルチシグのメンバーと現在の鍵に従います。任意のアドレスの登録内容は GET /qorechain/pqc/v1/multisig/{address} で読み取れます。登録された集合のないアドレスには 200 と {"found":false,"multisig":null} で応答します(2026年11月7日にテストネットで読み取り。メインネットでは2026年11月12日に、登録された集合のないアドレスに対して同じ経路が同じボディの 200 で応答しました)。プロトコル機能 pqc-multisig は両ネットワークで有効です(GET /qorechain/pqc/v1/protocol_features)。
検証ガス。 トランザクション内のポスト量子署名の検証には、測定に基づいて調整された固定の 2,000 ガスがかかります(ML-DSA-87 の検証はフリートサーバー上で secp256k1 より約 1.8 倍遅い)。機能 pqc-verify-gas-calibrated は両ネットワークで有効です。
ハードウェアウォレットとウェブウォレット(SIGN_MODE_TEXTUAL)。 qorechaind tx pqc cosign は、ポスト量子拡張付きの SIGN_MODE_TEXTUAL で署名できます。これはハードウェアウォレットが必要とするモードです。ウェブウォレットには、ノードが署名対象のドキュメントを提供します。トランザクションを tx_bytes または tx_json として /qorechain/pqc/v1/textual_sign_doc に POST してください。2026年11月7日に、テストネットのゲートウェイは空のボディに 400(tx_bytes or tx_json is required)、GET に 501 で応答したため、POST を使用してください。2026年11月12日には、メインネットのゲートウェイが空の POST に同じメッセージの 400 で応答したため、この経路はメインネットでも提供されています。このページのために、ハードウェアウォレットでのエンドツーエンドの署名は実行していません。特定のデバイスが対応していると想定しないでください。
EVM ウィンドウのイベント。 ポスト量子の認可ウィンドウを消費する EVM トランザクションは、イベント pqc_evm_window_used(属性 source)を発行するようになりました。機能 evm-window-used-event は両ネットワークで有効です。
一貫した API
すべての言語が同じインターフェースを提供します:
keygen() -> (publicKey, secretKey)
sign(secretKey, message) -> signature
verify(publicKey, message, signature) -> bool
kem.keygen() -> (publicKey, secretKey)
kem.encapsulate(publicKey) -> (cipherText, sharedSecret)
kem.decapsulate(secretKey, cipherText)-> sharedSecret
shake256(data, outLen=32) -> digest
クイックスタート (JavaScript / TypeScript)
import { mldsa, mlkem, shake256, pubkeyHash } from '@qorechain/pqc';
// ML-DSA-87 signatures
const { publicKey, secretKey } = mldsa.keygen();
const sig = mldsa.sign(secretKey, message);
mldsa.verify(publicKey, message, sig); // true
// ML-KEM-1024 key encapsulation
const { publicKey: ek, secretKey: dk } = mlkem.keygen();
const { cipherText, sharedSecret } = mlkem.encapsulate(ek);
mlkem.decapsulate(dk, cipherText); // === sharedSecret
// SHAKE-256 + blockchain helpers
shake256(data, 32); // 32-byte digest
pubkeyHash(publicKey, 20); // pay-to-pubkey-hash
デフォルトが要件に合わない場合は、レベル別のエクスポートが利用できます: mldsa44/65/87 および mlkem512/768/1024(mldsa / mlkem は L5 のデフォルトです)。
Rust、Go、C、Python、Java の各バインディングもこれを正確に踏襲しています。例:
// Rust
use qorechain_pqc::mldsa::default as mldsa;
let (pk, sk) = mldsa::keygen()?;
let sig = mldsa::sign(&sk, msg)?;
assert!(mldsa::verify(&pk, msg, &sig));
// Go
pk, sk, _ := pqc.MLDSA.Keygen()
sig, _ := pqc.MLDSA.Sign(sk, msg)
pqc.MLDSA.Verify(pk, msg, sig) // true
ブロックチェーンヘルパー
生のプリミティブに加えて、このライブラリはインテグレーターが QoreChain のアカウントおよびトランザクションとやり取りするために必要な 2 つのヘルパーを公開しています。
pubkeyHash(pk, len=20)
pay-to-pubkey-hash 登録用ヘルパーです。公開鍵の短い(20〜32 バイトの)SHAKE-256 ハッシュを生成します。パターンは次のとおりです: アカウント状態には pubkeyHash のみを保存し、完全な公開鍵はトランザクション内で要求します。これにより、1〜2.5 KB の鍵サイズに関係なく、アカウント状態は小さいまま保たれます。
hybridSignBytes(version, chainId, bodyWithoutPqcExt, authInfo)
QoreChain のウォレット互換なハイブリッド拡張 sign-bytes フレーミングです。ハイブリッドトランザクションの PQC 側を構成するために ML-DSA-87 (Dilithium-5) で署名すべきバイト列を、正確に生成します。形式は 2 つあり、ネットワークは各高さでそのうち正確に 1 つを検証します。v1 = BE32(len B0) ‖ B0 ‖ BE32(len A) ‖ A、v2 = "qorechain-pqc-hybrid-v2" ‖ BE64(len chainId) ‖ chainId ‖ BE32(len B0) ‖ B0 ‖ BE32(len A) ‖ A です(B0 は PQC 拡張を除いたトランザクションボディ、A は auth info)。2 つの公開ネットワークはどちらも v2 です。このライブラリは純粋関数なので、形式は呼び出し側が選択します。ノードに GET /cosmos/upgrade/v1beta1/applied_plan/{name} で v3.2.0(メインネットのアップグレード名)と v3.1.98(テストネットの以前の名前)の両方を問い合わせ、どちらかの高さが 0 より大きければ v2 を使用します。signBytesVersionForApplied と signBytesVersionFor(chainId, height) がこのルールを実装しています(@qorechain/pqc 0.2.1 以降を使用してください。0.1.x の 2 引数形式は例外を投げます)。
これは、ウォレットとインテグレーターが cosmos トランザクションパス上で必須のハイブリッド署名を生成するために使用する部品です。現行のチェーンバージョンでは、ハイブリッド署名はデフォルトで必須です(hybrid_signature_mode = required、allow_classical_fallback = false)。cosmos パスのすべてのトランザクションは、従来型の secp256k1 署名に加えて Dilithium-5 署名を伴わなければなりません。強制モデルについてはポスト量子セキュリティを参照してください。
従来型の secp256k1 署名は標準の sign bytes(PQC 拡張を含まない)に対して計算され、ML-DSA-87 署名は計算されたのち PQCHybridSignature 拡張として添付されます。従来型の sign bytes が拡張を含まないため、検証者が PQC 部分を理解するかどうかに関係なく、従来型署名は有効なままです。
このハイブリッド署名を生成する方法は 3 つあります:
- CLI —
qorechaind tx pqc cosignがトランザクションに Dilithium-5 の副署名を添付してブロードキャストします(事前にqorechaind tx pqc gen-keyを実行し、鍵を登録しておきます)。リリース版バイナリにのみ含まれています。トランザクションコマンドを参照してください。 - QoreChain SDK —
buildHybridTx/signAndBroadcastHybrid(sign-bytes の形式が解決されるようrestを渡します)が TypeScript、Python、Go、Rust、Java で同等の処理を行います。TypeScript では、client.connectTx(signer, { pqcKeypair })(SDK 0.9.0 以降。現在のリリースは 0.13.0)がすべてのトランザクションをハイブリッド署名します。先に鍵を登録してください(上記参照)。SDK アカウントと PQC 署名を参照してください。 qorechain-pqcを直接使用 — サポートされている 6 言語のいずれかで SDK 外のツールを構築する場合は、hybridSignBytesで sign bytes をフレーミングし、mldsa.signで Dilithium-5 署名を生成してください。
オンチェーンフットプリントの最適化
ML-DSA の鍵と署名は、従来型の基準からすると大きなサイズです。標準規格のバイト列は固定されているため、オンチェーンのフットプリントを小さく保つ方法は、以下の 3 つのレバーを使うことです — いずれも標準規格そのものを改変しません:
- セキュリティレベルを意図的に選択する。 ML-DSA-65 (L3) の署名は ML-DSA-87 (L5) より約 28% 小さく、それでも非常に強力です。ML-KEM-768 の暗号文は 1024 よりも小さくなります。ユースケースごとに選択してください。
- Pay-to-pubkey-hash。 アカウント状態には
pubkeyHash(pk)(SHAKE-256 の 20〜32 バイト)のみを保存し、完全な公開鍵はトランザクション内で要求します。鍵サイズに関係なく、アカウント状態は小さいまま保たれます。 - 署名の検証後破棄。 署名はトランザクション(ブロックデータ)内に存在しなければなりませんが、永続的な状態ツリーに書き込んではなりません。
なぜ Falcon がないのか? FN-DSA (Falcon) を使えばより小さい署名が得られますが、意図的に除外されています。FN-DSA は FIPS-206 のドラフト(未確定)であり、標準規格のみを扱うライブラリは最終確定した標準だけを出荷するためです。FIPS-206 が最終確定した時点で再検討される可能性があります。
関連ページ
- ポスト量子セキュリティ — チェーンがこれらのプリミティブをどう使用し、ハイブリッド署名をどう強制しているか。
- トランザクションコマンド —
tx pqc gen-key/tx pqc cosignの CLI フロー。 - SDK アカウントと PQC 署名 — QoreChain SDK からの鍵管理とハイブリッド署名。
- ウォレットセットアップ — PQC 対応アカウントの作成と管理。