!
Beta Environment Notice
TDM is currently in Beta. Exercise caution when handling assets. Use at your own risk.
Fast Export
Switch the current page to Markdown for fast agent reading, or download it as a .md file.
TDM is currently in Beta. Exercise caution when handling assets. Use at your own risk.
Fast Export
Switch the current page to Markdown for fast agent reading, or download it as a .md file.
# TDM Installation Summary: Installation guide for the current TDM public stack, covering tdm-sdk, the tdm CLI, bundled MCP setup, framework-mode JS integrations, protocol-first non-JS access, Session Gas Tank setup, and operator recovery commands. Status: Public installation docs Topics: - TDM SDK installation - tdm CLI setup - MCP runtime installation - tdm login configuration - Session Gas Tank setup - protocol-first integration setup - AI agent payment infrastructure - developer onboarding Packages: - tdm-sdk - bundled-mcp-runtime Commands: - npm install tdm-sdk - npm install -g tdm-sdk - tdm mcp - tdm connect - tdm fuel - tdm sweep - tdm stats
Install the public TDM stack for JS, non-JS, and agent-assisted usage. This page covers tdm-sdk, the tdm CLI, and the bundled MCP runtime path through tdm mcp.
AI + SEO Overview
This page helps developers and AI systems find the official setup flow for tdm-sdk, the tdm CLI, and the bundled MCP runtime path. It covers framework-mode installation, protocol-first integration setup,tdm connect, Session Gas Tank support, seller payout awareness, and operator recovery commands such as tdm fuel and tdm sweep.
In npm examples, npm i is also valid. Use whichever you prefer: npm install tdm-sdk and npm i tdm-sdk are equivalent.
tdm-sdktdmnpm install tdm-sdknpm install -g tdm-sdktdm connecttdm mcptdm fueltdm sweepWhat works today
The current public stack supports framework-mode route wrapping, CLI-driven setup, paid authorization, Session Gas Tank, seller payout requests, MCP session-state checks, and recovery-oriented operator flows such as tdm login, tdm fuel, tdm sweep, tdm sweep status, tdm stats, andtdm doctor, plus local catalog flows such as tdm storage sync, tdm storage watch, and tdm storage publish. It also includes tdm workspace for reusable runtime contexts across vault, storage, settlement, and agent links.
Public API behavior
Some flows require a live TDM service, especially POST /authorize, Session Gas Tank, telemetry, and seller payout handling. Public docs should describe those as external service features, not as purely local behavior.
JS SDK
Best when you want makePayable, framework-mode wrappers, and smart tdm make payable flows.
Protocol-First
Best when you are shipping in Python, Go, Java, Rust, C, or C++ and just need the public HTTP contract.
MCP-Assisted
Best when an AI runtime needs session-state checks, operator escalation guidance, and payment recovery awareness.
tdm CLIThe main public package is tdm-sdk. It includes the SDK surface and the tdm CLI.
The current friendly integration layer ships inside that same package. There is no separate mini npm for authorize, checkout, session tanks, or payouts. Instead, use scoped entrypoints like tdm-sdk/authorize, tdm-sdk/checkout, tdm-sdk/session-tanks, and tdm-sdk/payoutswhen you want a thinner wrapper around the live gateway contract.
The same package also ships a small examples/ folder so your first integration can start from a copy-paste snippet instead of reverse-engineering the whole stack.
If you prefer the short npm alias, npm i tdm-sdk is the same as npm install tdm-sdk. The same applies to the global CLI form: npm i -g tdm-sdk.
The CLI also has a built-in launcher. Run tdm to open it directly, or use tdm / to jump into area browsing. It uses a search-first launcher with optional areas and state strip. We intentionally document tdm / with a space; tdm/ is not a public command form.
Launcher navigation follows normal terminal expectations: Esc goes back, Tab completes, F2/F3/F4 toggle favorites, areas, and the state strip, Left/Right switch home sections, and Ctrl+D closes from the empty home screen. Favorited commands appear in a personal Pinned home section, capped at 9 items so quick-pick keys stay predictable.
The launcher also understands @path and $skill. @path inserts a local file or folder path. $skill inserts the path to an existing local skill file discovered in the current workspace. It does not create a new skill automatically. In normal shells, quote $skill if your shell expands $ on its own.
On a fresh machine, run tdm doctor before onboarding if you want to confirm terminal, keyring, and local runtime prerequisites up front.
For guarded runtime and agent destinations, the public CLI now also exposes one coherent trust path: verify ownership with tdm trust verify, promote approved targets with tdm allowlist add, use --scope vault when one vault needs its own narrower route policy, review policy with tdm allowlist list, and preflight a route with tdm allowlist check.
npm install tdm-sdkpnpm add tdm-sdkbun add tdm-sdknpm install -g tdm-sdktdm
tdm / make
tdm doctor
tdm / storagetdm storage add media ./seller-storage --use
tdm storage import-dir ./products/docs
tdm workspace create seller-lab --storage media --use
tdm storage publish ./products/docs --mode tunnelThe current public MCP path is bundled with tdm-sdk. Use tdm mcp to write or refresh the local .mcp.json, then let your MCP client run tdm mcp serve.
tdm mcptdm mcp serveAfter installation, confirm that the public CLI is available as tdm.
tdm helpThe public workflow starts with tdm connect. Interactive live seller commands can now auto-start that setup when it is still missing, while advanced manual credential editing through tdm login still exists for headless or runtime-only setups.
tdm connect
tdm connect --gateway https://tdm.todealmarket.comLive gateway-bound commands stay on the TDM payment path. In an interactive terminal they can bootstrap missing setup automatically; local preview flows still stay local-only until you intentionally publish them.
tdm fuel --amount 5 --yes
tdm fuel --amount 5 --session-id sess_123 --yestdm make payable ./report.pdf --price 0.05
tdm make payable https://cdn.example.com/report.pdf --price 0.05
tdm make payable ./premium-route.ts --price 0.05 --billing-mode session_gas_tanktdm sweep --network solana --resume-burner --deposit-address <solana_address>
tdm sweep --network solana --resume-burner --target-agent vault1
tdm sweep --network base --project-id wc_xxx --treasury 0xabc...tdm sweep status
tdm stats
tdm stats --agent vault1
tdm analytics export --format csv --dataset daily --days 90 --out analytics-daily.csv