ToshLock is a smart-contract powered token locker for the Pepu chain.
It lets project owners, teams, and communities lock their tokens in a transparent, verifiable, and trust-building way.

All lock data is public: visible via on-chain queries, the Pepu explorer API, and the ToshDashboard / ToshRank UI.

• Any PEPU L2 ERC20 token can be locked until a chosen unlock time.

• Locks are enforced by the ToshLock smart contract — no one can bypass them.

• A single token can have multiple independent locks, each with:

  • Owner wallet

  • Amount locked

  • Label / name

  • Unlock date

• Dashboard highlights the token creator wallet (from explorer history).

• Makes it clear if the project owner themselves has committed tokens.

• Anyone can see:

  • % of supply locked

  • Breakdown across wallets

  • Unlock timelines

• ToshLock automatically subtracts balances from known burn/dead addresses.

• Locked % is calculated against the real circulating supply, not totalSupply.

• Drill down by wallet: view only the locks owned by a specific address.

• Useful for tracking team wallets or whale commitments.

ToshDashboard is the front-end explorer for ToshLock.
It turns raw contract data into a visual, easy-to-read dashboard.

Powered by:

• Direct on-chain RPC queries

• Explorer API

• Cached market data

• Search by contract address, symbol, or name

• Combines cached data + live explorer lookups

Shows all the essentials at a glance:

• Token logo & name

• Symbol & contract address (with explorer link)

• Market cap & price (from cached pools data)

• Creator wallet & creation transaction

• Swap link to PepuSwap

• Total number of active locks

• Total locked amount (human-readable)

• % of circulating supply locked

• Largest locker’s share

• Paginated & sortable

• Shows every lock with:

  • Unlock date/time

  • Locked amount

  • Lock label

  • Owner wallet (explorer link; creator flagged 👑)

  • Lock ID

• Enter a wallet to see only that wallet’s locks for a token

• Shows current status (⏳ active / ✅ unlocked)

• “Open Dashboard” → deep link to token page

• “Lock More” → shortcut to lock more tokens directly in ToshLock

ToshRank is the ranking & leaderboard module.
It aggregates all ToshLock data into a chain-wide view of locked projects.

• Displays all tokens with active locks

• Shows:

  • Locked % (progress bar)

  • Next unlock date

  • Market cap / TVL

  • Circulating vs burned vs total supply (with % precision, e.g. X.0000%)

• Sortable by TVL, locked %, or token index

• Mobile-first card layout with:

  • Token logo

  • Social links (Website, X, Telegram)

  • “Active Locks” quick link

1. Deploy token

2. Lock part of the supply in ToshLock (team tokens, liquidity, etc.)

3. Share the ToshDashboard/ToshRank links with the community

1. Visit ToshDashboard or ToshRank

2. Search for the token by symbol or contract address

3. Verify instantly:

   • How much supply is locked

   • If the creator wallet has locked tokens

   • Unlock timelines

   • Distribution across wallets

• Same queries inside Telegram chats

• Quickly share lock dashboards & wallet breakdowns with the community

• Transparency: All lock data is on-chain & public

• Trust Building: Teams prove they can’t dump early

• Accessibility: Dashboards & bots make lock data easy for anyone

• Community Tools: Integration in social channels brings visibility

👉 In short:

• ToshLock= the smart contract lock mechanism

• ToshDashboard = the visual explorer & transparency layer

• ToshRank= the ranking/leaderboard across all projects