tonstarter

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

1. Snapshot: sTOS holdings captured → tier determined (cannot change after)
2. Whitelist: Tier holders register participation intent
3. Public Round 1: Whitelisted participants, tier-based allocation
4. Public Round 2: Anyone with TON staking can participate
5. 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

# Compile in order:
npm run compile:uniswap3-core
npm run compile:uniswap3-periphery
npm run compile:plasma
npm run compile:truffle

# Test:
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)