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.

Local Setup & Session State

# Local Setup & Session State

Summary: Guidance for understanding the current TDM preview stack. Focus on local setup, session checks, CLI behavior, and conservative documentation for public integrations.

Status: Documentation

Topics:
- local SDK setup
- session state
- TDM CLI setup
- public integration guidance
- AI agent payments

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

Commands:
- tdm doctor
- tdm connect
- tdm fuel
- tdm sweep
- tdm stats

Local Setup & Session State

Understand the public local setup flow for the current TDM preview: SDK behavior, saved CLI context, and session-readiness checks.

The Runtime State Posture

TDM supports local-first developer flows while also exposing documented external payment behavior for charging, Session Gas Tank balances, and seller credits.

1. Initialize your local TDM environment

Terminal

tdm doctor
tdm connect
tdm status

2. Wrap your execution logic

make-payable.ts

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

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

const run = makePayable(async () => {
  // logic...
}, {
  operation: 'demo:run',
  tokenOrUuid: 'demo-token',
  hooks,
})

3. Choose the charging mode

billing-modes.json

{
  "account": "debit the user's main balance",
  "session_gas_tank": "debit a prepaid session tank with signed session authorization"
}

4. Use runtime recovery flows when needed

Recovery

tdm sweep --network solana --resume-burner --deposit-address <solana_address>
tdm sweep status
tdm stats

What escrow means in the current stack

Buyer State

Buyers can run on main balance or on a prepaid Session Gas Tank that is topped up ahead of time.

Seller State

Successful charges accumulate seller credits first, then move into the payout flow when the publisher requests withdrawal.

Platform State

Platform fee accounting is recorded in the same authorize transaction, keeping the hot path atomic without forcing every request to reopen the whole settlement cycle.

Positioning guidance

suggested-wording.txt

TDM should be documented publicly through its SDK, built-in CLI, documented authorize flow, Session Gas Tank mode, seller payout flow, MCP runtime, and agent-facing interoperability materials.

import { createFetchHookClient, makePayable } from 'tdm-sdk' const hooks = createFetchHookClient({ baseUrl: process.env.TDM_GATEWAY_URL ?? 'https://tdm.todealmarket.com', }) const run = makePayable(async () => { // logic... }, { operation: 'demo:run', tokenOrUuid: 'demo-token', hooks, })