cpu_list_cell
List one of your Cells on the NFT marketplace at your price; the call handles approval, signing, and fee split, and returns the order hash.
Instructions
Publish ONE Cell of yours for sale on the NFT marketplace, in a single call. This is the land market — Cells traded as NFTs for a configured currency — and it is entirely separate from cpu_create_lot, which sells RESOURCES for $CPU inside the game. The call performs the whole action itself: it checks that you are not about to duplicate an order, prepares the order, sends any collection approval your wallet still owes and waits for each receipt, signs the order locally, and publishes it. There is nothing to confirm afterwards. That collection approval is setApprovalForAll: a persistent operator grant over every Cell your wallet holds, not over the one Cell you are listing. It is sent once and then stays in force. price is the GROSS amount a buyer pays, as a base-unit decimal integer STRING (never a number). The marketplace and creator fees are mandatory and come out of that amount: calling this tool authorizes that split, and the result reports platformFee, creatorFee and estimatedProceeds so you can see it. There is no minimum-proceeds input. Pass buyerAddress to reserve the listing for exactly one wallet; pass null to let anyone buy it. The seller is always the authenticated wallet. Retrying is safe: an identical repeated call resumes the same prepared order instead of publishing a second one. If a listing of yours at the same Cell, price and expiry is already active, the call fails with ACTIVE_ORDER_EXISTS rather than duplicating it — cancel that order first if you meant to replace it. The result reports status (completed, or already_completed when the order proved to be published already), the published listing with its orderHash, the fee split, and every approval transaction hash in the order it was broadcast.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| price | Yes | The gross amount a buyer pays, as a positive decimal integer of the currency base units — never a decimal fraction. Marketplace and creator fees are taken out of this amount; the call returns the split and your estimated proceeds. | |
| tokenId | Yes | The Cell to sell, as a decimal token id with no leading zeroes (e.g. "0" or "1234", never "01234"). You must own it. | |
| buyerAddress | No | Reserve the listing for exactly one buyer by passing their address; pass null (or omit it) to let anyone buy it. This never changes which wallet sells — that is always the authenticated wallet. | |
| expirationTime | Yes | The Unix second at which the listing stops being fillable. It must be in the future. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| stage | Yes | ||
| status | Yes | ||
| wallet | Yes | ||
| listing | Yes | ||
| tokenId | Yes | ||
| currency | Yes | ||
| eventType | Yes | ||
| creatorFee | Yes | ||
| grossPrice | Yes | ||
| platformFee | Yes | ||
| approvalTxHashes | Yes | ||
| estimatedProceeds | Yes |