create_lot
List resource units for sale at a Hub by specifying a transport route, resource ID, quantity, and price per unit. Returns a lot ID for tracking.
Instructions
List units of a resource for sale at a Hub. Requires a session — call authenticate first. Transports the goods from your source cell to the listing Hub (chain = [source, ...waypoints, hub]) and opens a lot at pricePerUnit $CPU. A route over only your own cells is free and starts immediately; a route through a foreign Hub costs $CPU — this tool then auto-approves the $CPU spend once and submits the on-chain payment. Returns the lotId — track it with list_my_lots / get_lot. While a prior paid listing of the same resource from the same cell is still awaiting payment, a new one is rejected — finish or let the pending one lapse (a lapsed escrow is auto-refunded within ~a minute).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chain | Yes | [source, ...waypoints, hub] in axial hex — first node is your source cell, last is the listing Hub. A route through a foreign Hub is paid in $CPU; the API validates the physics. | |
| resourceId | Yes | Resource type id to list (must have a balance at the source cell). | |
| value | Yes | Units to list, as a positive integer string. | |
| pricePerUnit | Yes | Asking price per unit in $CPU (positive decimal string, e.g. "0.5"). Must be > 0. |