菜单
Activate when the user needs Tokamak Network contract addresses, works with upgradeable proxy contracts (XxxProxy/XxxLogic pattern), handles TON/WTON token conversion, or deploys Solidity contracts targeting Tokamak infrastructure.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
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.
| name | tokamak-contracts |
| description | Activate when the user needs Tokamak Network contract addresses, works with upgradeable proxy contracts (XxxProxy/XxxLogic pattern), handles TON/WTON token conversion, or deploys Solidity contracts targeting Tokamak infrastructure. |
| license | MIT |
| metadata | {"author":"tokamak-network","version":"1.0.0"} |
Patterns, addresses, and gotchas for developing Solidity contracts on Tokamak Network infrastructure.
All Tokamak upgradeable contracts use XxxProxy + XxxLogic:
XxxProxy ← interact with THIS (holds storage/state)
XxxLogic ← ABI source only (stateless implementation)
// WRONG: calling the Logic contract directly
SeigManagerLogic logic = SeigManagerLogic(LOGIC_ADDRESS);
logic.stakeOf(layer2, account); // reads wrong storage!
// CORRECT: call the Proxy with the Logic's ABI
SeigManagerLogic seigManager = SeigManagerLogic(PROXY_ADDRESS);
seigManager.stakeOf(layer2, account); // reads proxy's storage
XxxProxy stores all state variables and delegates calls to XxxLogic# Get the implementation address from a proxy
cast storage <PROXY_ADDRESS> 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc --rpc-url https://eth.llamarpc.com
Detailed proxy pattern internals: See references/proxy-pattern.md
| Property | TON | WTON |
|---|---|---|
| Decimals | 18 (WAD) | 27 (RAY) |
| Use case | Wallet balance, transfers | Staking, governance, internal math |
| Conversion | WTON.swapFromTON(amount) | WTON.swapToTON(amount) |
// WRONG: sending TON directly to staking
depositManager.deposit(layer2, tonAmount); // fails or wrong amount
// CORRECT: convert TON→WTON first, then deposit
wton.swapFromTON(tonAmount);
wton.approve(address(depositManager), wtonAmount);
depositManager.deposit(layer2, wtonAmount);
| Contract | Address |
|---|---|
| TON | 0x2be5e8c109e2197D077D13A82dAead6a9b3433C5 |
| WTON | 0xc4A11aaf6ea915Ed7Ac194161d2fC9384F15bff2 |
| SeigManagerProxy | 0x0b55a0f463b6defb81c6063973763951712d0e5f |
| DepositManagerProxy | 0x0b58ca72b12f01fc05f8f252e226f3e2089bd00e |
| Layer2RegistryProxy | 0x0b3E174A2170083e770D5d4Cf56774D221b7063e |
| PowerTONProxy | 0x970298189050aBd4dc4F119ccae14ee145ad9371 |
| Contract | Address |
|---|---|
| TON | 0xa30fe40285b8f5c0457dbc3b7c8a280373c40044 |
| WTON | 0x79e0d92670106c85e9067b56b8f674340dca0bbd |
| SeigManagerProxy | 0x2320542ae933FbAdf8f5B97cA348c7CeDA90fAd7 |
| DepositManagerProxy | 0x90ffcc7F168DceDBEF1Cb6c6eB00cA73F922956F |
Full JSON address lists: See references/addresses-mainnet.json and references/addresses-sepolia.json
Verify that contract addresses are live and return expected values:
bash /mnt/skills/user/tokamak-contracts/scripts/verify-addresses.sh [network]
| Repository | Solidity | Tooling |
|---|---|---|
| ton-staking-v2 | 0.5.12 | Truffle |
| tokamak-dao-contracts | 0.5.12 | Truffle |
| tokamak-thanos | 0.8.x | Hardhat/Foundry |
| CrossTrade | 0.8.x | Hardhat |
Be aware that older contracts (staking, DAO) use Solidity 0.5.x patterns:
require with string messages)# Thanos L2 contracts (ABIs, deploy configs, genesis)
npm install @tokamak-network/thanos-contracts
# Thanos SDK (CrossChainMessenger, gas estimation)
npm install @tokamak-network/thanos-sdk
# Staking math library
npm install @tokamak-network/tokamak-staking-lib
import { ethers } from "ethers";
const provider = new ethers.JsonRpcProvider("https://eth.llamarpc.com");
// Always use PROXY address with LOGIC ABI
const seigManager = new ethers.Contract(
"0x0b55a0f463b6defb81c6063973763951712d0e5f", // Proxy
["function stakeOf(address,address) view returns (uint256)"],
provider
);
const staked = await seigManager.stakeOf(layer2, account);
console.log(ethers.formatUnits(staked, 27)); // 27 decimals!
# EIP-1967 implementation slot
cast storage <ADDRESS> 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc
# Non-zero result = proxy contract