issuers, keys, attestations, verify, audit y receipts. No asuma que cada API pública tiene un método de conveniencia en este paquete; use la referencia de operación y client.request cuando sea apropiado.
Configurar autenticación
service, no apiKey. Para una operación de usuario, use auth: { type: 'bearer', token } con un token de usuario válido. tenantId no autentica ni cambia de espacio de trabajo. No use autenticación solo de inquilino.
Acuñar
Utilice un emisor existente y una clave disponible para la firma del lado del servidor. Utilice bytes originales codificados o entrada estructuradaschema y claims.
payload_b64url con schema: "attestation" y claims: { subject: "demo-record" }; nunca envíe ambos modos. El registro de clave pública por sí solo no aprovisiona una clave privada de firma.
Reintentos y manejo de respuestas
El cliente agrega un encabezado de idempotencia a las solicitudes POST y PUT. Una nueva llamada de método genera una nueva clave, por lo que no es un reintento seguro de una escritura anterior incierta a menos que conserve y pase la misma clave.client.request acepta una opción idempotencyKey. Los reintentos automáticos se limitan a lecturas y escrituras de atestación/recibo compatibles con una clave explícita; las escrituras arbitrarias no se reproducen simplemente porque se proporcionó una clave.
Inspeccione la verificación verdict y reasons. Una promesa resuelta o un HTTP 200 por sí solos no son un resultado de verificación válido. Haga coincidir la versión del paquete instalado con sus declaraciones de tipo; el código fuente recién corregido no es evidencia de que una versión instalada anterior contenga las correcciones.
Consulte el ejemplo HTTP directo para una integración independiente de dependencias y la referencia de API para el contrato actual.
