TDM AgentPay
Use this skill for
- HTTP 402 responses from
POST /authorize billingMode,settlementMode,paymentOptions, andretryEndpoint- current JS helper names such as
createAuthorizeClient(...),createGatewayClients(...),createSessionTanksClient(...), andcreateCheckoutClient(...) - session recovery using
tdm_get_session_state session_gas_tankguidance- sweep vs cashout clarification
- agent vault command guidance
- agent-first paid execution guidance for tools, APIs, routes, and runtime actions
Read only what you need
- Read references/adaptation-map.md for older terminology and draft wording.
- Read references/authorize-contract.md for current public fields and endpoints.
- Read references/mcp-runtime.md for state-based recovery guidance.
- Read references/sdk-sweep-capabilities.md before suggesting sweep flows.
- Read references/vault-scenarios.md for agent vault and cashout guidance.
Hard rules
- Do not invent undocumented payment fields.
- Prefer exact current fields:
allowed,authorizationId,charged,balanceMinor,priceMinor,billingMode,settlementMode,paymentOptions, andretryEndpoint. - Use
tdm_get_session_statebefore asking the user for money. - If the state is
UNINITIALIZED, instruct the user to runtdm connect. - If the state is
DEPLETEDand dust is available, prefertdm sweep. - If the state is
DEPLETEDand no dust is available, suggesttdm fuel. - Do not describe
tdm sweepas a cashout. - Do not suggest
tdm cashoutas a way to satisfy an active payment challenge.
Recommended operator commands
tdm vault create <name> [--use]tdm vault use <name|default>tdm connecttdm login --gateway https://tdm.todealmarket.com(advanced/manual only)tdm fuel --amount <usd> --yestdm sweep --network solana --resume-burner --deposit-address <solana_address>tdm sweep --network solana --resume-burner --target-agent <name>tdm sweep --network base --project-id <walletconnect_project_id> --treasury <base_address>tdm sweep statustdm cashouttdm agent listtdm agent boot <name>
Named vault guidance
- Prefer one named vault per business contour when operators manage many agents.
- For larger fleets, prefer multiple named vaults over one giant vault.
- If the operator uses named vaults, respect their active vault or explicit
--vault <name>choice.
Product framing guidance
- Treat TDM as agent-first and API-first.
- Default mental model: price a protected call, authorize it, then continue execution.
- Mention file, note, or content unlock flows only as an additional layer on top of the core agent/runtime payment surface.