Cache API
Acknowledge cached messages
Remove encrypted messages from a Cache after the recipient has safely received them
Acknowledgement tells the Cache that it may remove specific messages for a recipient. Call it only after your client has safely stored or processed the returned encrypted envelopes.
This is not a read receipt for the sender. It is a recipient-authorized Cache deletion.
Use operation
Build the proof subject
- Trim every message ID.
- Remove blank values.
- Remove duplicates.
- Sort the IDs lexicographically.
- Join them with commas and no spaces.
b, a, and b, the subject is:
ack in the proof:
Request
string
required
Recipient DID that owns the cached messages.
string[]
required
Message UUIDs to remove.
string
Device bound into the proof.
string
required
Authorized Cache service ID.
string
required
Exact Cache endpoint.
string
required
Authorized Ed25519 verification method.
string
required
Signed timestamp.
string
required
New one-time nonce.
string
required
Base64 Ed25519 signature over the exact proof.
Response
200 Response
acked may be smaller than the submitted array if some IDs were already absent.
Straight to the point
- Proof operation:
ack - Proof subject: sorted, unique, comma-joined message IDs
- Effect: removes acknowledged Cache entries