メニュー
Activate when the user works with TON staking, WTON, seigniorage, SeigManager, DepositManager, staking balance queries, layer2 operators, or TON/WTON decimal conversion. Covers the ton-staking-v2 system.
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/tokamak-network/agent-skills --skill ton-stakingコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
Activate when the user works with Dust Protocol, stealth transfers, stealth addresses, privacy swaps, DustPool, DustSwap, DustPaymaster, .tok names, ERC-5564, ERC-6538, ZK privacy pools, Poseidon Merkle trees, gasless claims, ERC-4337 stealth accounts, or private payments on Tokamak.
Activate when the user works with Tokamak Private App Channels, zkp-channel-manager, L2 state channels with ZK proof verification, BridgeCore, BridgeDepositManager, BridgeProofManager, BridgeWithdrawManager, channel lifecycle (open/deposit/initialize/transact/close/withdraw), MPT keys, Groth16 channel proofs, or off-chain ERC20 transfers.
Activate when the user asks about Tokamak Network, TON token, WTON, Tokamak ecosystem, L2 on-demand, or needs help choosing which Tokamak skill to use. Provides ecosystem overview and routes to specialized skills.
SKILL.md を表示中
SOC 職業分類に基づく
| name | ton-staking |
| description | Activate when the user works with TON staking, WTON, seigniorage, SeigManager, DepositManager, staking balance queries, layer2 operators, or TON/WTON decimal conversion. Covers the ton-staking-v2 system. |
| license | MIT |
| metadata | {"author":"tokamak-network","version":"1.0.0"} |
TON Staking V2 distributes seigniorage (newly minted TON) to L2 sequencers proportional to each L2's TVL. Stakers deposit TON → convert to WTON → stake on a layer2 operator.
This is the most common source of bugs in Tokamak development.
| Token | Decimals | Unit Name | Example: "100 tokens" |
|---|---|---|---|
| TON | 18 | WAD | 100 * 1e18 |
| WTON | 27 | RAY | 100 * 1e27 |
All staking functions return values in WTON (27 decimals).
// WRONG: dividing by 1e18 to get human-readable
uint256 staked = seigManager.stakeOf(layer2, account);
uint256 humanReadable = staked / 1e18; // WRONG! Off by 1e9
// CORRECT: divide by 1e27 for WTON values
uint256 staked = seigManager.stakeOf(layer2, account);
uint256 humanReadable = staked / 1e27; // Correct
// WRONG: ethers.formatEther (assumes 18 decimals)
const staked = await seigManager.stakeOf(layer2, account);
const display = ethers.formatEther(staked); // WRONG for WTON
// CORRECT: use formatUnits with 27
const staked = await seigManager.stakeOf(layer2, account);
const display = ethers.formatUnits(staked, 27); // Correct
| Contract | Mainnet | Sepolia |
|---|---|---|
| TON | 0x2be5e8c109e2197D077D13A82dAead6a9b3433C5 | 0xa30fe40285b8f5c0457dbc3b7c8a280373c40044 |
| WTON | 0xc4A11aaf6ea915Ed7Ac194161d2fC9384F15bff2 | 0x79e0d92670106c85e9067b56b8f674340dca0bbd |
| SeigManagerProxy | 0x0b55a0f463b6defb81c6063973763951712d0e5f | 0x2320542ae933FbAdf8f5B97cA348c7CeDA90fAd7 |
| DepositManagerProxy | 0x0b58ca72b12f01fc05f8f252e226f3e2089bd00e | 0x90ffcc7F168DceDBEF1Cb6c6eB00cA73F922956F |
Full address list with ABIs: See references/contract-addresses.md
// Get staked amount for account on a specific layer2 (returns WTON, 27 decimals)
function stakeOf(address layer2, address account) external view returns (uint256)
// Get uncommitted seigniorage
function uncommittedStakeOf(address layer2, address account) external view returns (uint256)
// Seigniorage rate
function seigPerBlock() external view returns (uint256)
// Commission rate for a layer2 operator
function commissionRates(address layer2) external view returns (uint256)
// Get the coinage token address for a layer2
function coinages(address layer2) external view returns (address)
// Deposit WTON to a layer2 (must approve WTON first)
function deposit(address layer2, uint256 amount) external
// Request withdrawal (starts 13-day lockup on L1)
function requestWithdrawal(address layer2, uint256 amount) external
// Process pending withdrawal after lockup
function processRequest(address layer2, bool receiveTON) external
1. Acquire TON
2. Swap TON → WTON (WTON contract: swapFromTON)
3. Approve WTON spending to DepositManager
4. Call DepositManager.deposit(layer2, amount)
5. Seigniorage accrues per block automatically
6. To withdraw: requestWithdrawal → wait 13 days → processRequest
Detailed seigniorage math (RAY arithmetic): See references/seigniorage-math.md
Query staking data directly:
# Query staked amount for an address
bash /mnt/skills/user/ton-staking/scripts/query-stake.sh <address>
| Mistake | Fix |
|---|---|
Using formatEther for WTON | Use formatUnits(value, 27) |
| Calling Logic contract directly | Always call the Proxy address |
| Forgetting WTON approval before deposit | wton.approve(depositManager, amount) first |
| Not waiting 13 days for L1 withdrawal | Use CrossTrade for instant withdrawals |
| Assuming TON and WTON are interchangeable | They have different decimals (18 vs 27) |
@tokamak-network/tokamak-staking-lib (seigniorage calculator)