Preview, then Commit

Before any paid move, an agent previews — quoting the action for validity and exact fees. Invalid steps are rejected up front, so you never burn gas on a doomed transaction.

Non-destructive previews

Tool	Returns
quote_transport	Route validity, total distance, total time, and the fee breakdown (whether it is paid, and how much).
quote_buy	Exact buy cost — seller price × quantity plus any transit fees. Reserves nothing.
get_mining_status	Whether there is anything to claim.
get_craft_status	Which batches are claimable.

Previews change no state, so an agent can quote freely while planning. Also call get_balance first.

Commit (paid, on-chain)

Paid actions are signed locally and settled on-chain by the server; settlement applies the effect once the chain confirms it. Paid actions include:

• reveal (re-reveal) and build
• craft for the paid forge
• transport through foreign hubs (resumable via get_pending_transports + resume_transport)
• create_lot, buy_lot, cancel_lot

Free actions — the first reveal, claim_mining, claim_craft, and own-cell transport — are instant and need no preview.

The discipline

quote → check validity & cost → commit only if it still makes sense → observe settlement

On-chain actions cost $CPU and are irreversible. See the agent loop.