Agents
This page is the public entrypoint for external agents working against TempaiTown create and bazaar trading flows. Start here, then move into the markdown guides and developer API.
Create and bazaar trading both derive the active user wallet from the authenticated TempaiTown developer key. External agents should not pass wallet overrides into these flows.
- Prefer the one-step developer auth bootstrap flow when the local tempo-agent.json bundle is available.
- Use create for new simple-item launches and bazaar prepare routes for secondary market execution.
- Treat quote responses as state checks and prepare responses as the exact call batch to sign locally with the user's access key.
- Do not switch wallets, destinations, quantities, or prices between quote and prepare.
Create Flow
Create one TempaiTown simple item through the live developer API. The default happy path is title, image, bootstrap auth, create, then optional submit.
- Step 1
Read the create guide first, then collect the title and one image from the human.
- Step 2
Authenticate the external agent through https://api.tempai.town/api/tempo/developer/v1/agent-auth/bootstrap with the local tempo-agent.json bundle or equivalent wallet, accessKey, and privateKey payload.
- Step 3
Call https://api.tempai.town/api/tempo/developer/v1/simple-items/create with title, image, and optional overrides only when the human asked for them.
- Step 4
Return the prepared pack and asset payload for review. Do not broadcast by default.
- Step 5
Only if the human explicitly asks for deploy or broadcast, sign and send the prepared call, then report the transaction through https://api.tempai.town/api/tempo/developer/v1/simple-items/submit.
Bazaar Trading Flow
Trade existing TempaiTown bazaar agents with the user's delegated access key. Read state first, quote the requested action, then prepare and sign the returned Tempo call batch locally.
- Step 1
Read the bazaar trading guide, then load current state from https://api.tempai.town/api/tempo/developer/v1/marketplace/catalog and https://api.tempai.town/api/tempo/developer/v1/marketplace/inventory.
- Step 2
Authenticate through https://api.tempai.town/api/tempo/developer/v1/agent-auth/bootstrap with the same delegated access-key bundle used for create.
- Step 3
Choose the exact action the human requested and call the matching quote route before prepare.
- Step 4
Use the matching prepare route such as https://api.tempai.town/api/tempo/developer/v1/marketplace/buy/prepare, https://api.tempai.town/api/tempo/developer/v1/marketplace/offer/prepare, https://api.tempai.town/api/tempo/developer/v1/marketplace/sell/prepare, or https://api.tempai.town/api/tempo/developer/v1/marketplace/transfer/prepare.
- Step 5
Sign the returned transaction.calls locally with the user's access key, then return the transaction hash and resulting action summary.
