# 🛡️ ToshLock – PEPU L2 Token Locking Platform

By [TOSH](https://paragraph.com/@tosh) · 2025-08-22

---

### What it is

**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**.

* * *

🔧 Key Functionalities
----------------------

### ✅ Lock Tokens Securely

*   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.
    

### 📦 Multiple Locks per Token

*   A single token can have **multiple independent locks**, each with:
    
    *   Owner wallet
        
    *   Amount locked
        
    *   Label / name
        
    *   Unlock date
        

### 👑 Creator Recognition

*   Dashboard highlights **the token creator wallet** (from explorer history).
    
*   Makes it clear if the **project owner themselves** has committed tokens.
    

### 🔍 Distribution Transparency

*   Anyone can see:
    
    *   % of supply locked
        
    *   Breakdown across wallets
        
    *   Unlock timelines
        

### 🔥 Burn-Adjusted Supply

*   ToshLock automatically subtracts balances from **known burn/dead addresses**.
    
*   Locked % is calculated against the **real circulating supply**, not totalSupply.
    

### 👛 Wallet-Specific Locks

*   Drill down by wallet: view **only the locks owned by a specific address**.
    
*   Useful for tracking team wallets or whale commitments.
    

* * *

📊 ToshDashboard – Visual Explorer
==================================

### What it is

**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
    

* * *

🔑 Key Functionalities
----------------------

### 🔎 Token Search

*   Search by **contract address, symbol, or name**
    
*   Combines cached data + live explorer lookups
    

### 🪪 Token Overview Card

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
    

### 📊 Lock Summary

*   Total number of active locks
    
*   Total locked amount (human-readable)
    
*   % of circulating supply locked
    
*   Largest locker’s share
    

### 📋 Lock Table

*   Paginated & sortable
    
*   Shows every lock with:
    
    *   Unlock date/time
        
    *   Locked amount
        
    *   Lock label
        
    *   Owner wallet (explorer link; creator flagged 👑)
        
    *   Lock ID
        

### 👝 Wallet Explorer

*   Enter a wallet to see only **that wallet’s locks** for a token
    
*   Shows current status (⏳ active / ✅ unlocked)
    

### 🔗 Interactive Links

*   **“Open Dashboard”** → deep link to token page
    
*   **“Lock More”** → shortcut to lock more tokens directly in ToshLock
    

* * *

📈 ToshRank – Lock Rankings
===========================

### What it is

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

* * *

🔑 Key Functionalities
----------------------

*   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
        

* * *

🚀 Usage Workflow
=================

### Token Creator / Team

1.  Deploy token
    
2.  Lock part of the supply in **ToshLock** (team tokens, liquidity, etc.)
    
3.  Share the ToshDashboard/ToshRank links with the community
    

### Investors / 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
        

### Telegram Bot (Companion)

*   Same queries inside Telegram chats
    
*   Quickly share lock dashboards & wallet breakdowns with the community
    

* * *

🔑 Benefits
===========

*   **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](https://www.toshtech.xyz/toshlock.html)\= the smart contract lock mechanism
    
*   [ToshDashboard](https://www.toshtech.xyz/toshdashboard.html) = the visual explorer & transparency layer
    
*   [ToshRank](https://www.toshtech.xyz/toshrank.html)\= the ranking/leaderboard across all projects

---

*Originally published on [TOSH](https://paragraph.com/@tosh/toshlock-pepu-l2-token-locking-platform)*