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

Sign In With QoreChain（SIWQ）、バージョン 1

ステータス: メッセージフォーマットのバージョン 1 について安定。ソース: spec/siwq-v1.md。

SIWQ により、QoreChain アカウントは、自身の鍵を制御していることをオフチェーンの サービスに証明できます。メッセージは EIP-4361 と Sign In With Solana の レイアウトに従い、QoreChain のアドレスとチェーン ID に合わせて調整されています。 署名は 2 つの部分から成ります。Keplr 互換ウォレットが signArbitrary で生成できる ADR-36 secp256k1 署名と、アカウントの登録済み耐量子鍵による ML-DSA-87（FIPS 204） 署名です。

メッセージ​

${scheme://}${domain} wants you to sign in with your QoreChain account:
${address}

${statement}

URI: ${uri}
Version: 1
Chain ID: ${chain-id}
Nonce: ${nonce}
Issued At: ${issued-at}
Expiration Time: ${expiration-time}
Not Before: ${not-before}
Request ID: ${request-id}
Resources:
- ${resources[0]}
- ${resources[1]}
...
  • 行は単一の \n で区切られ、末尾の改行はありません。
  • scheme:// は省略可能です。domain は、要求元サイトの RFC 3986 オーソリティ （ホストと、省略可能なポート）です。
  • address は、アカウントの qor1 bech32 形式です。
  • ステートメント行は省略可能です。省略した場合、EIP-4361 と同様に、アドレスの後に 空行が 2 行続きます。
  • Version は 1 です。Chain ID は、qorechain-vladi のような QoreChain の チェーン ID です。
  • Nonce は、サーバーが選ぶ 8 文字以上の英数字で、使い捨てです。
  • タイムスタンプは RFC 3339 / ISO 8601 です。
  • Expiration Time、Not Before、Request ID、Resources は省略可能で、この順序で 現れます。

検証者は、パースしたフィールドを再レンダリングし、バイト単位で一致しないメッセージを 拒否しなければなりません。

署名​

{
  "signatureType": "ml-dsa-87-hybrid",
  "classical": { "keyType": "secp256k1", "publicKey": "<base64>", "signature": "<base64>" },
  "pq": { "algorithmId": 1, "signature": "<base64>" }
}

従来型の部分（ADR-36）​

アカウントの secp256k1 鍵が、キーをソートし空白を含めずにシリアライズした下記の amino JSON 署名ドキュメントに署名します。data は UTF-8 メッセージの base64、 signer は qor1 アドレスです。

{"account_number":"0","chain_id":"","fee":{"amount":[],"gas":"0"},"memo":"","msgs":[{"type":"sign/MsgSignData","value":{"data":"...","signer":"qor1..."}}],"sequence":"0"}

ダイジェストは、secp256k1 アカウントでは SHA-256、eth_secp256k1 アカウントでは KECCAK-256 です。署名は 64 バイトの r || s、low-S です。publicKey は 33 バイトの 圧縮鍵で、keyType のもとで address に導出される必要があります。

耐量子の部分​

pq.signature = ML-DSA-87.Sign(sk, UTF-8("qorechain-siwq-v1|" + message))

ドメインプレフィックスにより、サインイン署名がトランザクション署名として使われること も、その逆も防がれます（ドメイン分離 を参照）。

pq の部分がない場合、signatureType は secp256k1 になります。検証者は、従来型 のみのアカウントを明示的に受け入れる場合を除き、そのようなサインインを拒否すべきです。

検証​

検証者は、次の順序で確認しなければなりません。

  1. メッセージがパースでき、正規形式であること。
  2. domain が、リクエストの送信元ドメインと等しいこと。
  3. nonce が、サーバーがこのセッション用に発行したナンスと等しく、そのナンスが以前 に使用されていないこと。
  4. Chain ID が期待されるネットワークであること。
  5. Expiration Time が未来であり、Not Before と Issued At が未来でないこと （わずかな時計のずれは許容）。
  6. 従来型の公開鍵が address に導出され、ADR-36 署名が検証されること。
  7. ML-DSA-87 署名が、クライアントから提供された鍵ではなく、address に対して チェーン上に登録されている公開鍵（/qorechain/pqc/v1/account/{address}） のもとで検証されること。

テストベクター​

vectors/qoresign-v1.json の siwq フィールドです。 テストベクターを参照してください。