| name | tonstarter |
| description | 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.
|
| license | MIT |
| metadata | {"author":"tokamak-network","version":"1.0.0"} |
TONStarter
Decentralized launchpad (IDO platform) for Ethereum and Tokamak L2 projects. Built around TOS governance token with tiered access based on staking and lockup duration.
Status: DEPRECATED as of September 2024. Official support ended. Contracts remain on-chain and are community-operable.
Source: https://github.com/tokamak-network/TONStarter
Architecture
TON (Tokamak Network native token)
│
├── TON Staking (via Tokamak DepositManager)
│ └── Rewards: TOS tokens
│
└── TOS Token Ecosystem
├── LTOS (TOSv2) — Index-based staking token, value increases every 8 hours
├── sTOS — Governance token, exponential to lockup duration (TOSv2)
├── Bond Market — Buy TOS at discount with ETH, min 5-day lock
└── Treasury — ETH reserves from bonding revenue
└── Inverse Bond: swap TOS → ETH directly
IDO Participation Flow:
sTOS tier → Snapshot → Whitelist → Public Round 1 → Public Round 2 → Claim
Deprecation Notice
| Date | Event |
|---|
| June 25, 2024 | All TOS mining programs ended |
| September 22, 2024 | tonstarter.tokamak.network and tosv2.tokamak.network shut down |
| Post October 2024 | GitHub repos may be archived |
Contract admin functions set to 0x0000...0000. TOS holders can still redeem TOS → ETH via TreasuryProxy. Community members can redeploy with new admin.
Token Ecosystem
| Token | Role | Decimals |
|---|
| TON | Tokamak Network native, IDO funding | 18 |
| WTON | Wrapped TON (ERC20) | 27 (RAY) |
| TOS | TONStarter governance token (ERC20 + EIP-2612) | 18 |
| LTOS | Index-based staking token (TOSv2) | 18 |
| sTOS | Governance power, exponential to lock duration | 18 |
IDO 5-Step Process
- Snapshot: sTOS holdings captured → tier determined (cannot change after)
- Whitelist: Tier holders register participation intent
- Public Round 1: Whitelisted participants, tier-based allocation
- Public Round 2: Anyone with TON staking can participate
- Claim: Transfer acquired tokens to wallet
Tier System
| Tier | Requirement | Benefit |
|---|
| Tier 1 | TOS + sTOS minimum | Basic allocation |
| Tier 2 | Higher TOS + sTOS | Larger allocation |
| Tier 3 | Even higher | Even larger allocation |
| Tier 4 | TOS + sTOS + minimum TON balance | Maximum allocation + early access |
Key Contracts (Mainnet)
| Contract | Address |
|---|
| TOS Token | 0x409c4d8cd5d2924b9bc5509230d16a61289c8153 |
| Stake1Proxy | 0x8e539e29D80fd4cB3167409A82787f3B80bf9113 |
| StakeTONFactory | 0x8Dde0854A6A6781720E0a4462a8648c89D861b16 |
| LockTOSv2Proxy | 0x3883F75b2BE639F9236eD230dD7202f31eaf38d5 |
| PublicSaleProxy | 0x3B75d3f628C29d357b484EA7d091faEd63419267 |
| SwapProxy | 0x30e65B3A6e6868F044944Aa0e9C5d52F8dcb138d |
| StakeUniswapV3Proxy | 0xC1349A9a33A0682804c390a3968e26E5a2366153 |
Full address list: See references/contract-addresses.md
TOSv2 Upgrade Phases
| Phase | Key Changes |
|---|
| Phase 1 | sTOS: linear → exponential lockup. ETH bond market. Treasury introduced |
| Phase 2 | Uniswap V3 liquidity bonding. Automated market management |
| Phase 3 | Full TOS DAO. Fully decentralized launchpad operations |
Bond Market
- Users buy TOS at discount with ETH
- Acquired TOS auto-locked for minimum 5 days (as LTOS)
- Phase 2 adds Uniswap V3 LP bonding
Vault Types (StakeType)
| StakeType | Name | Description |
|---|
| 0 | TON | TON staking; tokamakStaking() re-stakes to Tokamak L2 |
| 1 | Simple (ETH/ERC20) | ETH or ERC20 staking with TOS rewards |
| 2 | UniswapV3LP | Uniswap V3 LP NFT staking |
Common Mistakes
| Mistake | Fix |
|---|
| Vault creation out of order | Create vaults in shortest staking period first order |
Missing --recursive on clone | git clone --recursive — Uniswap/Plasma submodules required |
| Wrong compile order | Must compile: uniswap3-core → uniswap3-periphery → plasma → truffle |
| Confusing TON-blockchain TONStarter | tokamak-network/tonstarter-contracts (Ethereum/Solidity) ≠ ton-defi-org/tonstarter-contracts (TON/FunC) |
| Calling deprecated frontend | tonstarter.tokamak.network is offline since Sep 2024. Use Etherscan direct interaction |
| Assuming linear sTOS | TOSv2 changed sTOS to exponential lockup scaling — 2x duration ≠ 2x sTOS |
Development Setup
git clone --recursive https://github.com/Onther-Tech/tonstarter-contracts.git
cd tonstarter-contracts && git checkout develop
npm install
npm run compile:uniswap3-core
npm run compile:uniswap3-periphery
npm run compile:plasma
npm run compile:truffle
npm run test:stake.ton
npm run test:stake.tokamak
npm run test:uniswapv3
Related Repositories
| Repository | Role |
|---|
| tokamak-network/TONStarter | Main launchpad (frontend + docs) |
| tokamak-network/tonstarter-contracts | Smart contracts |
| tokamak-network/tonstarter-project-token | IDO project token contracts |
| tokamak-network/tonstarter-docs | Whitepaper and documentation |
Related Skills
- ton-staking: TON/WTON staking and seigniorage (TOS rewards come from here)
- tokamak-contracts: Contract addresses and proxy patterns
- dao-governance: DAO governance (Phase 3 successor)
