Skip to main content

POST /api/tally/envelopes/:tokenId/export

MethodPOST
Path/api/tally/envelopes/:tokenId/export
GroupTally Protocol
Authauthenticated session — you must own the coin
Sourceshared/api-core/src/routes/tallyProtocol.ts

What it does

Turns a coin you own into a bearer package. Atomically escrows the coin (status='bearer', spend_seq++) so your online wallet can no longer spend it, then returns a self-describing, offline-verifiable package.

Call it

curl -X POST https://zeqsdk.com/api/tally/envelopes/ZT-<slug>-<zeqond>-<hash>/export \
-H "Authorization: Bearer <session>" --cookie "zeq_auth_token=<session>"

Returns

{
"ok": true,
"coin": {
"kind": "zeq-coin", "token_id": "ZT-…", "token_hash": "…",
"value_zeq": 6, "home_origin": "https://zeqsdk.com",
"node_sig": "…", "node_pubkey": "…", "node_sig_alg": "ed25519",
"spend_seq": 1, "bearer_ticket": "…", "exported_by": "ZEQ…",
"export_zeqond": 2294640396
}
}

Encrypt the coin object with a PIN (HiteCrypto) to produce a .ZEQ file, or base64url it into a zeqcoin:v2: QR / NFC claim link. Redeem with POST /api/tally/coins/redeem.