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 Quick Start

# TDM Quick Start

Summary: Quick start workflow for the public TDM developer stack. This page starts with copy-paste Base and Solana builders, then shows how to install tdm-sdk, protect a route, and add MCP session-state checks when needed.

Status: Public quick start documentation

Topics:
- TDM SDK quick start
- OnchainKit quick start
- Solana Wallet Adapter quick start
- TDM CLI onboarding
- AgentPay interoperability
- framework-mode route charging
- x402-aware runtime setup
- MCP session-state runtime
- protocol-first non-JS path
- tdm_get_session_state
- AI agent payment infrastructure

Packages:
- tdm-sdk
- bundled-mcp-runtime
- tdm-agentpay

Commands:
- npm install tdm-sdk
- POST /authorize
- tdm connect
- tdm mcp
- tdm fuel
- tdm sweep
- tdm sweep status
- tdm stats
- tdm mcp serve

Quick Start

Start with a real builder path, not a theory dump. The fastest public TDM route is: pick your wallet stack for Base or Solana, protect one route with framework-mode or the HTTP contract, and only then add CLI, MCP, or payout setup as needed.

AI + SEO Overview

Fastest path into the official TDM stack

This page is designed for both developers and AI systems looking for the official quick start path for tdm-sdk, Base builders using OnchainKit or wagmi, Solana builders using Wallet Adapter, the tdm CLI, the bundled MCP runtime, AgentPay interoperability, framework-mode setup, protocol-first non-JS integration, and the first paid flow.

Main packages

tdm-sdk
OnchainKit / wagmi
Solana Wallet Adapter
bundled MCP runtime
tdm-agentpay

Search topics

TDM quick start
Base builder quick start
Solana builder quick start
tdm-sdk quick start
TDM CLI setup
MCP session-state quick start
protocol-first integrations
AI agent payments

Core commands

POST /authorize
tdm connect
tdm fuel
tdm sweep
tdm sweep status
tdm mcp
tdm mcp serve

First Green Path

Get One Real Flow Working First

If you only want one working result today, stay on this page and pick the starter that matches your stack. You do not need to bounce between SDK, HTTP, and checkout docs before the first request goes green.

Web App

Protect One Route

Use the current web-first path when your app already runs in Next.js, Hono, Express, or another JS runtime.

framework-mode-basic.ts

import { chargeFetchHandler, createFetchHookClient } from "tdm-sdk"

const hooks = createFetchHookClient({
  baseUrl: process.env.TDM_GATEWAY_URL ?? "https://tdm.todealmarket.com",
})

export const "text-[#ffd166] font-semibold">POST = chargeFetchHandler(
  {
    operation: "demo:route",
    resourceId: "demo:route",
    priceUsd: "0.05",
    tokenResolver: (request) =>
      request.headers.get("x-tdm-token") ?? "demo-user",
    hooks,
  },
  async () => Response.json({ ok: true }),
)

Open SDK Reference

Protocol-First

Call POST /authorize Directly

Use this when you are integrating from Python, Go, Java, Rust, C, or C++ and want the canonical payment gate first.

authorize.http

"text-[#ffd166] font-semibold">POST https://tdm.todealmarket.com/authorize
Content-Type: application/json

{
  "requestId": "req_demo_1",
  "tokenOrUuid": "demo-user",
  "operation": "demo:authorize",
  "priceUsd": "0.05"
}

Open HTTP Contract

Buyer Flow

Create A Hosted Checkout Session

Use this when buyers should pay in the browser and you do not want to ship a custom payment UI first.

checkout-basic.ts

import { createCheckoutClient } from "tdm-sdk/checkout"

const checkout = createCheckoutClient({
  baseUrl: process.env.TDM_GATEWAY_URL ?? "https://tdm.todealmarket.com",
})

const session = await checkout.createSession({
  resourceId: "res_demo_123",
  chain: "solana",
})

console.log(session)

Open Checkout Docs

CLI Proof

Make One Asset Payable

Use this when you want the fastest live proof from the CLI before wiring TDM deeper into your own runtime.

cli-proof.sh

tdm connect
tdm make payable ./report.pdf --price 0.05
tdm payout wallets status

Open Start Here

Step 1: Install the SDK

The core package is tdm-sdk. It gives you the SDK surface and the tdm CLI.

Short npm form works too: npm i tdm-sdk is equivalent to npm install tdm-sdk, and npm i -g tdm-sdk is equivalent to npm install -g tdm-sdk.

npm

npm install tdm-sdk

global-cli

npm install -g tdm-sdk

Fast path for Base builders

If your app already uses wagmi or OnchainKit, keep that wallet UX. TDM does not require a fake replacement wallet layer. The normal production shape is: wallet on the client, paid route on the server, and POST /authorize behind the fetch-hook client.

base-builder.tsx

"use client"

import { Wallet, ConnectWallet } from "@coinbase/onchainkit/wallet"
import { useAccount } from "wagmi"

export function BaseAgentStarter() {
  const { address, isConnected } = useAccount()

  return (
    <div className="space-y-3">
      <Wallet>
        <ConnectWallet />
      </Wallet>
      <button
        disabled={!isConnected}
        onClick={() => fetch("/api/agent/run", { method: "">POST" })}
      >
        Run paid agent action
      </button>
      {address ? <p>Connected Base wallet: {address}</p> : null}
    </div>
  )
}

app-api-agent-run.ts

import { chargeFetchHandler, createFetchHookClient } from "tdm-sdk"

const hooks = createFetchHookClient({
  baseUrl: "https://tdm.todealmarket.com",
})

export const "text-[#ffd166] font-semibold">POST = chargeFetchHandler(
  {
    operation: "agent:run",
    resourceId: "agent:run",
    priceUsd: "0.01",
    tokenResolver: (request) =>
      request.headers.get("x-tdm-token") ?? "anonymous",
    hooks,
  },
  async () => Response.json({ ok: true }),
)

Fast path for Solana builders

If your stack already uses the Solana Wallet Adapter, keep that too. TDM should look like one more production capability in the app, not a parallel wallet system.

solana-builder.tsx

"use client"

import { useMemo } from "react"
import { ConnectionProvider, WalletProvider } from "@solana/wallet-adapter-react"
import { WalletModalProvider, WalletMultiButton } from "@solana/wallet-adapter-react-ui"
import { PhantomWalletAdapter } from "@solana/wallet-adapter-wallets"

export function SolanaAgentStarter() {
  const wallets = useMemo(() => [new PhantomWalletAdapter()], [])

  return (
    <ConnectionProvider endpoint="https://api.mainnet-beta.solana.com">
      <WalletProvider wallets={wallets} autoConnect>
        <WalletModalProvider>
          <div className="space-y-3">
            <WalletMultiButton />
            <button onClick={() => fetch("/api/agent/run", { method: "">POST" })}>
              Run paid agent action
            </button>
          </div>
        </WalletModalProvider>
      </WalletProvider>
    </ConnectionProvider>
  )
}

solana-recovery.sh

tdm connect
tdm fuel --amount 2 --yes
tdm sweep --network solana --resume-burner --deposit-address <solana_address>
tdm sweep status

Step 2: Connect once for CLI and operator flows

Run the one-time setup flow. It links your wallet and saves local TDM configuration so later commands can reuse it.

connect

tdm connect

launcher-shortcuts

tdm
tdm / make
tdm doctor
tdm / vault

Step 3: Make a route payable

You can still wrap individual functions with makePayable(...), and now you can also use framework-mode helpers over route handlers.

framework-mode.ts

import { chargeFetchHandler, createFetchHookClient } from 'tdm-sdk'

const hooks = createFetchHookClient({
  baseUrl: 'https://tdm.todealmarket.com',
})

export const "text-[#ffd166] font-semibold">POST = chargeFetchHandler(
  {
    operation: 'demo:process',
    priceUsd: '0.10',
    resourceId: 'https://api.example.com/process',
    tokenResolver: (request) => request.headers.get('x-tdm-token') ?? 'anonymous',
    hooks,
  },
  async () => Response.json({ ok: true }),
)

Step 4: Register files, URLs, or code with one CLI command

tdm make payable now detects what you passed in and chooses the right default behavior.

make-payable-cli

tdm 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_tank
tdm make payable ./report.pdf --price 0.05 --mode url --public-url https://cdn.example.com/report.pdf

Step 4B: Turn a local folder into a managed catalog

If you want to sell files from your own machine or server, use named storage roots and publish the synced folder through a local server or quick tunnel first.

seller-catalog-cli

tdm storage add media ./seller-storage --use
tdm storage import-dir ./products/docs --storage media
tdm storage publish ./products/docs --storage media --mode tunnel
tdm workspace create seller-lab --storage media --use
tdm where
tdm status
tdm workspace status
tdm make payable --asset <asset-id> --storage media --price 0.05

Step 5: Save seller payout wallets once

If you plan to sell across both Solana and Base, save your payout wallets once and let later payout requests stay chain-first instead of address-first.

seller-payout-wallets

tdm payout wallets set --solana <solana_address> --base 0xabc...
tdm payout wallets status
tdm payout request --amount 20 --chain solana
tdm payout request --amount 20 --chain base

Step 5: Add MCP session-state checks

For agent runtimes, the current MCP surface is intentionally narrow. The practical pattern is to check session readiness first, then decide whether to continue or ask the operator to intervene.

install-mcp

tdm mcp

run-mcp-server

tdm mcp serve

mcp-decision-flow.ts

const session = await client.callTool({
  name: 'tdm_get_session_state',
  arguments: {},
})

if (session.state === 'UNINITIALIZED') {
  // Ask operator to run: tdm connect
}

if (session.state === 'DEPLETED' && session.dust_tokens_detected) {
  // Suggest: tdm sweep
}

if (session.state === 'FUELED') {
  // Continue paid execution
}

Step 6: Recover session fuel when needed

Use tdm fuel when you want to top up for paid usage and tdm sweep when you want to run supported recovery or cleanup flows for a local setup.

recovery-commands

tdm fuel --amount 5 --yes
tdm sweep --network solana --resume-burner --deposit-address <solana_address>
tdm sweep status
tdm stats

Beta Environment Notice

TDM Quick Start

Quick Start

Fastest path into the official TDM stack

Main packages

Search topics

Core commands

Get One Real Flow Working First

Protect One Route

Call POST /authorize Directly

Create A Hosted Checkout Session

Make One Asset Payable

Step 1: Install the SDK

Fast path for Base builders

Fast path for Solana builders

Step 2: Connect once for CLI and operator flows

Step 3: Make a route payable

Step 4: Register files, URLs, or code with one CLI command

Step 4B: Turn a local folder into a managed catalog

Step 5: Save seller payout wallets once

Step 5: Add MCP session-state checks

Step 6: Recover session fuel when needed

What's next?

TDM Quick Start

Quick Start

Fastest path into the official TDM stack

Main packages

Search topics

Core commands

Get One Real Flow Working First

Protect One Route

Call POST /authorize Directly

Create A Hosted Checkout Session

Make One Asset Payable

Step 1: Install the SDK

Fast path for Base builders

Fast path for Solana builders

Step 2: Connect once for CLI and operator flows

Step 3: Make a route payable

Step 4: Register files, URLs, or code with one CLI command

Step 4B: Turn a local folder into a managed catalog

Step 5: Save seller payout wallets once

Step 5: Add MCP session-state checks

Step 6: Recover session fuel when needed

What's next?