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.

Session Gas Tanks

# Session Gas Tanks

Summary: Session Gas Tanks allow agents to execute paid intents without constant user intervention. By pre-funding a tank and delegating spending authority, agents can operate autonomously within strict budget limits.

Status: Deep-dive guide

Topics:
- Session Gas Tank mechanics
- Delegated spending rules
- Budget isolation
- Real-time settlement

Packages:
- tdm-sdk

Commands:
- tdm fuel
- tdm connect

Session Gas Tanks

A Session Gas Tank is a dedicated fund for an agent or a specific task. It enables Delegated spending, allowing the Contour Runtime to authorize payments on behalf of the user within predefined limits.

How it works

01.Pre-funding: User deposits funds into a Tank (e.g., via tdm fuel).
02.Delegation: User authorizes a specific Agent or Contour to spend from that Tank.
03.Execution: Agent calls intents; Gateway debits the Tank in real-time.
04.Enforcement: If the limit is hit, the Contour Runtime blocks further intents.

CLI Operations

gas-tank-cli.sh

# Fund your main tank
tdm fuel --amount 10

# Check runtime state
tdm status

# Apply a reviewed rule pack
tdm rules install tdm-payable-protocol

SDK Integration

Developers can manage tanks programmatically using the tdm-sdk. This is useful for multi-agent systems where each agent needs its own isolated budget.

session-tanks.ts

import { createSessionTanksClient } from "tdm-sdk/session-tanks"

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

// Create a sub-tank for a specific agent
const tank = await tanks.createSubTank({
  publicKey: agentPubKey,
  limitUsd: "2.00",
})