cpu_transport
Atomically move a resource from one of your cells to another along a waypoint chain, with transit fees and a time-delayed delivery that finalizes after arrival.
Instructions
Move a resource between cells along a waypoint chain of tokenIds, on-chain (needs a session — cpu_authenticate first). One atomic move: debits the source, pays the $CPU transit fee for every foreign Hub on the route (auto-approved once) plus gas, and escrows a time-delayed delivery. Source and target must be your own cells past their first completed reveal; the waypoints between them may be Virgin ground (no completed reveal, minted or not), cells of yours, or any cell with a finished Hub, foreign ones included. Each hop must be within radius(from)+radius(to)−1 grid steps, and radius is per cell: a plain cell reaches the move radius, a finished Hub the radius its own tier serves. Recommended flow: cpu_route_network (export the graph and plan over it) or cpu_next_hops (scout waypoints leg by leg) → chain them yourself → cpu_quote_transport (verify fee/ETA) → cpu_transport. Returns the deliveryId and arrival time; the goods credit to the target only after arrival, when you call cpu_finalize_delivery (cpu_list_my_transports shows what is ready). Every foreign finished Hub on the route charges its fee, one standing on ground with no completed reveal included; a route over only your own cells and bare Virgin ground pays none.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | Waypoint chain of cell tokenIds [source, ...intermediate, target]. Source and target must be your own cells past their first completed reveal; every cell between them may be Virgin ground (no completed reveal, minted or not), a cell of yours, or any cell carrying a finished Hub, foreign ones included. Each hop must span at most radius(from)+radius(to)−1 grid steps, and radius is per cell: a plain cell reaches the move radius, a finished Hub the radius its own tier serves (cpu_get_game_config lists the radius of every Hub tier). Scout legal hops with cpu_next_hops and chain them yourself; the Transport contract validates. | |
| amount | Yes | Units to move, as a positive integer string (matches on-map resource balances). | |
| resourceId | Yes | Resource type id to move (must have a balance at the source cell). |