ExchainDocs
DocsAPI

APIReadsDownload the evidence bundle

Download the evidence bundle

Offline evidence bundle of the wallet’s decisions.

GET
/v1/wallets/{walletId}/evidence.zip

A zip to verify the wallet’s decisions offline: README.txt, VERIFY.md, mandate.json, decisions.jsonl, roots.jsonl, publisher.json and one proof per decision. The default window is the last 30 days.

Authorization

headerAuthorizationBearer <token>

Node Token from the Exchain console. Works for wallets this node registered; the node’s network (preprod or mainnet) decides the network of the request. Use a preprod token in the playground.

Path Parameters

walletId*string

Wallet id returned at registration: wal_ and 26 Crockford base32 characters.

Match^wal_[0-9A-HJKMNP-TV-Z]{26}$

Query Parameters

from?string

Start of the window, RFC 3339, inclusive.

Formatdate-time
to?string

End of the window, RFC 3339, exclusive.

Formatdate-time

Response Body

The evidence bundle.

response?fileapplication/zip
Formatbinary
Example Request
curl -X GET 'https://cosign.exchain.network/v1/wallets/wal_01J9XK3M4N5P6Q7R8S9T0V1W2Z/evidence.zip'
Example Response
"string"

Errors

StatusCodeMeaning
400bad_requestfrom or to is not RFC 3339.
401unauthorizedThe bearer credential is missing, unknown or revoked.
404not_foundThe wallet does not exist, this node did not register it, or the read token is for another wallet.
413payload_too_largeThe bundle would exceed 50 MB; narrow from and to.

Every code and what to do about it: Errors and codes.