@taplid/client
Advanced tools
+2
-2
| { | ||
| "name": "@taplid/client", | ||
| "version": "0.5.13", | ||
| "version": "0.5.14", | ||
| "description": "Official Node.js SDK for the hosted Taplid audit API.", | ||
@@ -38,3 +38,3 @@ "keywords": [ | ||
| "dependencies": { | ||
| "@taplid/contract": "0.5.13" | ||
| "@taplid/contract": "0.5.14" | ||
| }, | ||
@@ -41,0 +41,0 @@ "engines": { |
+25
-2
@@ -53,4 +53,16 @@ # @taplid/client | ||
| Treat the audit ID like a share link. Retrieval is a public lookup, not a cryptographic signature or tamper-proof attestation. | ||
| Treat the audit ID like a share link. Retrieval is a public lookup. Hosted audit results include an `attestation` object, which is the cryptographic proof layer. | ||
| ## Signed attestations | ||
| Hosted Taplid audit responses include an `attestation` object. It is an ES256-signed proof that Taplid issued the decision for the audited input and returned public result. | ||
| Public verification keys are available at: | ||
| ```text | ||
| https://api.taplid.com/.well-known/jwks.json | ||
| ``` | ||
| The `attestation.token` can be verified against the JWKS public key. The signed payload includes the `auditId`, `auditMode`, `decision`, `trustScore`, `inputHash`, and `resultHash`. | ||
| ## HTTP API Example | ||
@@ -162,3 +174,13 @@ | ||
| }, | ||
| "requestId": "aud_XXX" | ||
| "requestId": "aud_XXX", | ||
| "attestation": { | ||
| "alg": "ES256", | ||
| "kid": "taplid-es256-2026-06", | ||
| "typ": "JWT", | ||
| "issuer": "https://api.taplid.com", | ||
| "issuedAt": "2026-06-12T21:28:52.000Z", | ||
| "inputHash": "91f5884c9a9be6152e6d75534df82dada5965e7905bc80eca95df02970c6f3b1", | ||
| "resultHash": "f95e77eb3224d987fa0baf35b5ee4c4e04029960cdcd6fd16c9171ffad929a7e", | ||
| "token": "eyJhbGciOiJFUzI1NiIsImtpZCI6InRhcGxpZC1lczI1Ni0yMDI2LTA2IiwidHlwIjoiSldUIn0..." | ||
| } | ||
| } | ||
@@ -185,2 +207,3 @@ ``` | ||
| - **requestId** - server-assigned request id for support and tracing | ||
| - **attestation** - ES256 signed proof that Taplid issued this decision for the audited input and returned public result | ||
@@ -187,0 +210,0 @@ |
52174
2.17%221
11.62%+ Added
- Removed
Updated