Letters of disclosure
Answer the auditor. Tell nobody else.
A private bank is not a bank that cannot answer questions. It is one that answers exactly the question asked, to exactly the person asking, and keeps a record that it did. A letter opens one transfer to one reader. The chain keeps the fact and the moment; the figure and the reader stay between you.
- Scoped: one transfer, one reader, revocable by simply not writing the next one
- Verifiable: the reader re-encrypts with your randomness and matches the delta on chain
- Recorded: DisclosureLog.file keeps a timestamped receipt, hashed reader, hashed payload
- Enveloped: sealed to the reader's own key, so only they can open it in transit
- Ranged: "at least this much", proven, with no figure in the letter at all
- Audited: a whole period in one file, complete against the ledger, so an omission shows
transfer 0x7c1e…9b04 (block 18,204,311)
from gwen.bankhaus
to atlas.bankhaus
amount 1,250.00 USDG
randomness 0x12a0…e3f7
check Enc(1,250.00, r, pk_atlas) == recipientDelta ✓
receipt DisclosureLog #41 · 2026-10-06 11:52 UTC
Try one
A letter you can check yourself.
This letter was written in your browser a moment ago for a transfer of 1,250.00 USDG between two fresh keys. Verify it. Then change the amount in the text, even by one cent, and verify again.
- The reader needs no key of their own: re-encrypt and compare
- The sender's view key is not in the letter and cannot be derived from it
- On chain, the reader compares the delta with the transfer's calldata
In an envelope
A letter in the clear tells its figure to whoever holds the text. Seal it to atlas and it becomes an envelope that only atlas's view key opens: not gwen's, not a stranger's, not a mail server's.
Range letters
Prove “at least” without the number.
A landlord wants to know you earn at least 3,000 a month. A bank wants to know you hold at least 50,000. A normal letter would show the figure. A range letter proves the bound and nothing else: it carries no figure and no randomness, only a proof. This one is written here for a transfer of 3,200.00 on paper.
- The reader learns one bit: yes, at least that much
- The same Bulletproof the chain checks, over the difference figure minus threshold
- Ask for more than was paid and no letter can be written at all
How a letter works
You pick the transfer
Every delta you ever sent was built in your browser with a randomness r you kept. The letter is the figure and that r.
The reader checks
They encrypt the figure with your r to the recipient's public key and compare with the delta the chain stores. Equal, or not.
You file the receipt
file(txReference, keccak(reader), keccak(payload)). Anyone can see you answered on that day; nobody can see whom or what.
On chain
function file( string txReference, // which transfer bytes32 viewerHash, // keccak(reader), so receipts cannot be mined for counterparties bytes32 disclosureCommitment // keccak(payload), so the reader can check what they hold ) returns (uint256 receiptId); receiptIdsOf(profile) // your letters, newest last receiptIdsForTransfer(txRef) // every letter about one transfer
Who asks for letters
- Auditors
A year of transfers to one counterparty, opened to one firm, each with a receipt.
- Counterparties
Prove you paid an invoice in full without publishing your balance.
- Courts and regulators
Answer a specific order with a specific figure. The record shows you complied, and when.
- Yourself
Scoped read access for a second device or a tax tool, without handing over the view key.