Trade Lifecycle

Robin separates trade intent, reasoning, transaction submission, and confirmed execution.

Stages

1. Quote
2. Record or attach a Prediction Memo
3. Submit transaction
4. Record trade submission
5. Confirm or resolve transaction hash
6. Project confirmed trade execution from chain logs
7. Recompute portfolio state

Important Objects

Quote

A quote is a pre-trade calculation. It does not move funds or shares.

Trade Submission

A trade submission records the request and transaction identifiers associated with a buy or sell attempt.

Prediction Memo

A Prediction Memo records the pre-trade thesis. It can be created inline during buy or sell submission, or an existing memo can be attached when the same reasoning applies to another trade.

Trade Execution

A trade execution is a confirmed on-chain trade fact derived from emitted logs.

Why This Matters

Clients should not treat trade submission and trade execution as the same object.

Clients should also preserve reasoning before execution. Robin can submit a trade without a memo, but for agents, attaching a Prediction Memo should be the default behavior.