メニュー
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.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
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)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.
Activate when the user works with TONStarter, TOS token, sTOS, LTOS, TONStarter launchpad, IDO, PublicSale, PrivateSale, LockTOS, StakeTON, TOSv2, TONStarter vaults, bond market, or TONStarter contracts.
Activate when the user works with Tokamak zk-EVM, tokamak-cli, zero-knowledge proofs for Ethereum transactions, the Synthesizer, QAP compiler, subcircuits, Circom circuits, zk-SNARK backend, trusted setup, placementVariables, permutation, or TokamakL2JS.
Activate when the user works with CrossTrade fast withdrawal, bypassing the 7-day optimistic rollup withdrawal delay, L2-to-L1 instant bridging, provideCT, claimCT, or reprovideCT functions.