Sign In With QoreChain: Prüfung auf dem Server

SIWQ ist eine Anmeldenachricht im Stil von EIP-4361, signiert mit dem secp256k1-Schlüssel des Kontos (ADR-36) und mit seinem ML-DSA-87-Schlüssel. Format: Sign In With QoreChain v1.

Ablauf

1. Der Server stellt für die Sitzung eine einmalig verwendbare Nonce aus.
2. Der Client baut die Nachricht mit createSiwqMessage, und die Wallet signiert sie mit signSiwq (oder erzeugt den klassischen Teil mit signArbitrary und den ML-DSA-87-Teil mit pqSign über siwqPqSignBytes(message)).
3. Der Server prüft mit verifySiwqWithChain. Das prüft die Nachricht, die Nonce, die Domain, die Zeitangaben, dass der klassische Schlüssel die Adresse kontrolliert, und die ML-DSA-87-Signatur gegen den on-chain registrierten Schlüssel der Adresse (siehe Prüfung).

TypeScript

import { verifySiwqWithChain } from "@qorechain/qoresign/network";

const fields = await verifySiwqWithChain({
  rest: "https://api.qore.host",
  address: body.address,
  message: body.message,
  signature: body.signature,
  domain: "app.example.com",       // the host the request came to
  nonce: session.nonce,            // single use; delete it now
  chainId: "qorechain-vladi",
});
// fields.address is signed in; fields.possessionProven tells whether the key was registered with a proof of possession

Go

import (
    qoresign "github.com/qorechain/qoresign/go"
    "github.com/qorechain/qoresign/go/network"
)

// The network helpers are methods on a client.
client := network.NewClient("https://api.qore.host")

var sig qoresign.SiwqSignature
if err := json.Unmarshal(signatureJSON, &sig); err != nil {
    return err
}
result, err := client.VerifySiwqWithChain(ctx, address, qoresign.VerifySiwqOptions{
    Message:   message,
    Signature: sig,
    Domain:    "app.example.com", // the host the request came to
    Nonce:     issuedNonce,       // the nonce your server issued
    ChainID:   "qorechain-vladi",
})
if qoresign.IsCode(err, qoresign.CodeSiwqExpired) {
    // ask the user to sign in again
}
// result.Address signed in; result.PossessionProven reports how the key was registered.

Nur-klassische Konten

verifySiwq lehnt eine Anmeldung ohne den ML-DSA-87-Teil ab, sofern nicht requirePq: false übergeben wird. Akzeptieren Sie rein klassische Anmeldungen nur, wenn Ihr Dienst die Post-Quanten-Garantie nicht benötigt.

Ein lauffähiger Server befindet sich in examples/siwq-server.