tokamak-cli

name

tokamak-cli

description

Interact with Tokamak Network (TON/WTON tokens, staking, unstaking, withdrawals) using the tokamak-cli tool. Use this skill whenever the user asks about TON or WTON token balances, transfers, approvals, wrapping/unwrapping, staking to Layer2 operators, unstaking, or withdrawing staked tokens. Also use when the user mentions Tokamak Network, TON staking, WTON, Layer2 operators like tokamak1/DSRV/Talken, or wants to check staking status. Even if the user just says 'check my TON balance' or 'stake some tokens', this skill applies.

tokamak-cli — Tokamak Network CLI

A CLI tool for interacting with Tokamak Network's TON and WTON smart contracts on Ethereum.

Quick Start

All amounts are in human-readable TON units (e.g. 100 means 100 TON). The CLI handles internal unit conversion (WAD 1e18 / RAY 1e27) automatically.

Default network is mainnet. Add -n sepolia for testnet.

Read commands (no private key needed)

# Check TON balance
tokamak-cli ton balance <address>

# Check WTON balance
tokamak-cli wton balance <address>

# Check staked TON balance
tokamak-cli stake balance <layer2> <address>

Write commands (require -k <private-key> or PRIVATE_KEY env)

# Transfer TON
tokamak-cli ton transfer <to> <amount> -k <key>

# Stake TON to a Layer2 operator
tokamak-cli stake deposit <layer2> <amount> -k <key>

Command Reference

When the user's request matches a specific operation, run the appropriate command. For details on each command group, read the reference files below.

Level 1 — Token Operations (most common)