Sign In With QoreChain: verificación en el servidor

SIWQ es un mensaje de inicio de sesión al estilo EIP-4361 firmado por la clave secp256k1 de la cuenta (ADR-36) y por su clave ML-DSA-87. Formato: Sign In With QoreChain v1.

Flujo

1. El servidor emite un nonce de un solo uso para la sesión.
2. El cliente construye el mensaje con createSiwqMessage y la cartera lo firma con signSiwq (o produce la parte clásica con signArbitrary y la parte ML-DSA-87 con pqSign sobre siwqPqSignBytes(message)).
3. El servidor verifica con verifySiwqWithChain, que comprueba el mensaje, el nonce, el dominio, los tiempos, que la clave clásica controla la dirección y la firma ML-DSA-87 contra la clave registrada en la cadena para la dirección (consulta Verificación).

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.

Cuentas solo clásicas

verifySiwq rechaza un inicio de sesión sin la parte ML-DSA-87 a menos que se pase requirePq: false. Acepta inicios de sesión solo clásicos únicamente si tu servicio no necesita la garantía post-cuántica.

Hay un servidor ejecutable en examples/siwq-server.