菜单
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.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/tokamak-network/agent-skills --skill tokamak-contracts命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 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 | 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