Locker Services (Group 8)
The live locker and trade-locker surface for escrow-like storage, inspection, transfer, sale listing, and withdrawal.
Overview
Group 8 is broader than the older three-command locker model. The live audited set includes direct download/store flows, trade-locker inspection and removal, sale-oriented commands, and multi-sum storage variants.
Live commands
| Code | Name | Role |
|---|---|---|
| 8 | download | Download locker content. |
| 80 | store | Store value into a locker. |
| 81 | peek_trade_locker | Inspect a trade locker before purchase/removal flows. |
| 82 | store_sum | Store by sum proof. |
| 83 | peek | Inspect standard locker contents. |
| 84 | remove | Withdraw or clear locker contents. |
| 85 | put_for_sale | Offer a locker-backed asset for sale. |
| 86 | list_lockers_for_sale | List lockers that are currently for sale. |
| 87 | buy | Purchase from a sale locker. |
| 88 | store_multiple_sum | Create or fill multiple lockers with summed proofs. |
| 89 | remove_trade_locker | Remove a trade locker. |
| Store command detail | Developer note |
|---|---|
| Per-coin request size | The live 80 store request uses 37 bytes per coin: 1 denomination, 4 serial number, 16 AN, and 16 PAN. |
| PAN suffix rule | The PAN must end in FF FF FF FF for the standard locker store path. |
| Primary statuses | Expect 241 for all pass, 242 for all fail, and 243 when the body carries mixed-result detail. |
Standard lockers
The core developer workflow remains familiar: store value, peek to inspect it, and remove or download when it is time to redeem. The live command set just adds more specialized entry points around that model.
| Core action | Live command |
|---|---|
| Store value | 80 store / 82 store_sum / 88 store_multiple_sum |
| Inspect contents | 83 peek |
| Withdraw contents | 84 remove / 8 download |
Trade lockers and sale flows
The live surface also includes locker-based commerce commands. These are distinct from ordinary peer-to-peer escrow and should be documented as first-class Group 8 operations.
| Trade action | Live command |
|---|---|
| Inspect trade offer | 81 peek_trade_locker |
| List items for sale | 86 list_lockers_for_sale |
| Publish sale | 85 put_for_sale |
| Buy | 87 buy |
| Remove trade locker | 89 remove_trade_locker |