PROPOSE_SWAP — Group 8, Code 96
Open a swap: trade a root-coin for a coin already on the suspect. No authority move, no epoch dependency.
Design-stage — parameters are a first draft
Field sizes are drafted from raidax/ideas_for_suspect_raida_servers.txt (Addenda 5–7) and are not final or implementation-verified. The body is encrypted per the header ENC_CODE; see below.
Phase II — later
This command is Phase II: convenience, recovery, or optimization that is not required for the first working move. Optional swap fast-path.
How it works
Having found a swap offer (see LIST_SWAPPABLE), this command opens a proposed trade: “I will give my coin on the root in exchange for that coin on the suspect.” The user names the coin they are offering and the coin they want, proving ownership of their side.
The server returns a reference for the proposed swap, which is then completed by EXECUTE_SWAP. Splitting propose and execute keeps the actual exchange atomic and lets both sides line up before any coin changes hands.
Direction & encryption
- Direction: client → counterparty
- ENC_CODE: 1 (coin AN)
Request Body parameters
| Field | Bytes | Description |
|---|---|---|
| CH (challenge) | 16 | Standard challenge / replay protection (per header convention). |
| my_DN | 1 | Denomination offered. |
| my_SN | 4 | Serial number offered. |
| want_DN | 1 | Denomination wanted. |
| want_SN | 4 | Serial number wanted. |
| EOF | 2 | Terminator (0x3E3E). |
Response Body parameters
| Field | Bytes | Description |
|---|---|---|
| swap_ref | 4 | Handle to execute the swap. |