Tdm Agentpay

TDM AgentPay

Use this skill for

• HTTP 402 responses from POST /authorize
• billingMode, settlementMode, paymentOptions, and retryEndpoint
• current JS helper names such as createAuthorizeClient(...), createGatewayClients(...), createSessionTanksClient(...), and createCheckoutClient(...)
• session recovery using tdm_get_session_state
• session_gas_tank guidance
• 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](references/adaptation-map.md) for older terminology and draft wording.
• Read [references/authorize-contract.md](references/authorize-contract.md) for current public fields and endpoints.
• Read [references/mcp-runtime.md](references/mcp-runtime.md) for state-based recovery guidance.
• Read [references/sdk-sweep-capabilities.md](references/sdk-sweep-capabilities.md) before suggesting sweep flows.
• Read [references/vault-scenarios.md](references/vault-scenarios.md) for agent vault and cashout guidance.

Hard rules

1. Do not invent undocumented payment fields.
2. Prefer exact current fields: allowed, authorizationId, charged, balanceMinor, priceMinor, billingMode, settlementMode, paymentOptions, and retryEndpoint.
3. Use tdm_get_session_state before asking the user for money.
4. If the state is UNINITIALIZED, instruct the user to run tdm connect.
5. If the state is DEPLETED and dust is available, prefer tdm sweep.
6. If the state is DEPLETED and no dust is available, suggest tdm fuel.
7. Do not describe tdm sweep as a cashout.
8. Do not suggest tdm cashout as a way to satisfy an active payment challenge.

Recommended operator commands

• tdm vault create [--use]
• tdm vault use
• tdm connect
• tdm login --gateway https://tdm.todealmarket.com (advanced/manual only)
• tdm fuel --amount --yes
• tdm sweep --network solana --resume-burner --deposit-address
• tdm sweep --network solana --resume-burner --target-agent
• tdm sweep --network base --project-id --treasury
• tdm sweep status
• tdm cashout
• tdm agent list
• tdm agent boot

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 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.

Bundled helpers

• [scripts/fetchx402price.mjs](scripts/fetchx402price.mjs)
• [scripts/runtdmsweep.mjs](scripts/runtdmsweep.mjs)

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: ToDealMarket
• Source: ToDealMarket/tdm-agentpay
• License: MIT
• Homepage: https://todealmarket.com/

Install and usage instructions live in the source repository linked above.