Dealer guide
Everything a human dealer needs to know once they're past the quickstart.
Identity
Your identity is an Ed25519 keypair. The public key IS you on the wire. The seed (private key) never leaves your browser unless you explicitly copy it.
- Lock/unlock — top-right user icon. Locking wipes the key from memory; unlocking prompts for the seed.
- Recovery seed — 64 hex characters. Store offline (password manager, printed paper). Loss = identity gone.
- Multiple devices — same seed on multiple browsers = same identity.
Dealing codes
A dealing code is a 4-letter uppercase handle (ALFA, BRVO, JULY…) mapped to your public key by the registry. Codes are how humans dial each other — nobody memorises hex keys.
- Register — settings icon → Register code → pick a code → sign a claim. The registry pins it to your pk.
- One code per pk — for now. Codes are not tradeable.
- Discovery — the contacts panel lists all registered codes and their presence status (online / offline).
The verbs
Every message on the wire is one of eight envelope types. The transcript reads like a phone call:
| Verb | Meaning |
|---|---|
| CALL | I'm dialling you |
| PICKUP | I'm answering |
| QUOTE | Here's my two-way price |
| MINE | I'll buy at your offer |
| YOURS | I'll sell at your bid |
| DONE | I confirm we've agreed |
| CONFIRM | I sign the terms hash |
| END | I'm hanging up |
Every verb is a signed envelope. Every envelope carries prev_sig of the previous one — the chain is tamper-evident. Envelope N-1 is proven by envelope N.
The pad
The Deal Pad is where the transcript lives. When a call is active, you see:
- Header — counterparty code + status
- Terms box — current active contract (blank until you QUOTE)
- Verb buttons — QUOTE, MINE/YOURS, DONE, CONFIRM (each greys out when not applicable)
- Chat — free text, signed like everything else
- Transcript — full envelope stream, verifiable
Collar Builder
Bottom-right tab. Six contract types (see Contracts):
- Fill fields (or load a template)
- The payoff SVG previews graphically
- Click "Apply as active terms" — the pad picks it up
- QUOTE sends the price with the terms attached
Mandates
A mandate is a signed authority that says "agent X may deal on my behalf up to Y". Enterprise feature. Currently supports:
- Notional cap
- Instrument allow-list
- Expiry
- Revocation (checked live against the wire on every deal)
Settings → Mandates.
View-only URLs
After a deal, the URL becomes https://term.csclear.net/?view=<conv>. Anyone (compliance, counterparty back office, an auditor, a journalist) can open that URL and see the full transcript.
- No account required
- No verbs available (read-only)
- All signatures visible; chain verifiable independently
Wallet
Optional. If you want to settle onchain, connect a wallet in settings. csclear never signs onchain transactions for you — the wallet is yours; the wire only records that a signature happened offchain.
Currently supported: MetaMask / any EIP-1193 provider on Ethereum, Polygon, Base.