Skip to main content

Trade

Trade happens at hubs. A seller delivers goods to a hub and lists them; buyers purchase and have the goods delivered to their own cell.

Create a lot​

A seller transports a resource to a hub and lists it at a price per unit (must be greater than zero). The lot becomes OPEN and its goods are held in escrow until sold or cancelled.

  • If delivery to the hub uses only the seller's own cells, it is free and the lot opens immediately.
  • If delivery crosses foreign hubs, the create is a paid, signed on-chain action (it pays transit fees).

Buy a lot​

A buyer purchases any quantity — partial or full — of an OPEN lot, paying in $CPU. A partial buy does not close the lot: its remaining quantity decrements, and many buyers can hold concurrent reservations. Delivery is to the buyer's own cell.

Fees. The buyer pays seller price × quantity in $CPU, plus transit fees for any foreign hubs on the delivery route (a per-unit-per-hub fee with a burned share). Out of the sale itself a protocol burn and the hub sale fee are deducted before the seller is paid — both come out of the sale, not on top of it, so they never change the buyer's total. Use the buy quote to see the exact total before committing — it is non-destructive and reserves nothing.

Hub sale fee​

The hub owner sets a sale fee — a per-resource rate on their own hub. When a lot on that hub sells, the fee is taken out of the seller's proceeds and paid to the hub owner; it is not added to the buyer's price. Alongside it, a protocol burn takes a share of every sale. The exact burn share and the fee cap are in the Economy Reference.

The rate is live: a buy settles at the hub's current rate at the moment of the buy, so changing a hub's fee — or the hub changing hands — re-prices future buys on every open lot. A hub with no rate set is free. The seller is protected by a tolerance: when listing, they cap the fee they'll accept — listing is refused if the rate already exceeds it, and every buy re-checks it. A buy above that cap is refused; within it, the buy settles at the live rate.

Cancel a lot​

A seller can cancel the remaining lot; goods return to the seller (with back-transit fees if foreign hubs are crossed). Abandoned buy reservations are released automatically after a timeout — there is no buyer-facing cancel in this build.

Provisional Lot TTL, anti-dust minimums, and hub-ownership permissioning are not finalized.

The partial-fill race​

Because many buyers can reserve slices of the same lot concurrently, a buyer can commit to a quantity another buyer has already taken — in which case the purchase reverts. Planned The exact handling of this race is an open question. See the Roadmap.