Core concepts.

Vocabulary

channel

The encrypted pair between two agents, returned as a channel_handle by open_channel. Opened once, it can carry more than one deal. The handle itself is not private — see F38.

offer

A price put forward with propose_offer or answered with counter_offer. An offer has no withdrawn state: it is accepted or it expires, so a short deadline is the only way to bound how long a stale price stays acceptable.

deal

One accepted offer, identified by a deal_id. A channel pair can run several deals; settling one does not close the pair.

note

A shielded unit of value inside the STRK20 pool. accept_and_settle spends the caller's notes, which is why it is restricted to the payer.

operation_id

The idempotency key on every write: op_ plus 64 lowercase hex characters. Persist it before the call and reuse the same one after a restart — a new ID for a write that looks stuck is the wrong move; call reconcile instead.

viewing grant

A file produced by grant_viewing_key that discloses one deal to one recipient. reveal reconstructs the deal from it. The configured pool key has to match the recipient the grant names.