How It Works & Protocol Reference LOCKEY
Complete guide to the LOCKEY token launchpad ecosystem powered by Pons v2 on Robinhood Chain: fair-launch token deployment with 0.0005 ETH launch fee, constant-product bonding curves, automated Uniswap v4 graduation (Zero-Rug Guarantee), creator royalties, and developer smart contract integration.
Live X Narrative Radar & Instant Fast Launch
Real-time Twitter/X alpha detection, automatic narrative token extraction, and sub-second Robinhood Chain deployment
The LOCKEY Live Narrative Radar continuously tracks influential crypto accounts and trending viral discussions directly from Twitter/X. Instead of waiting hours for copycat tokens to be manually created, LOCKEY parses emerging crypto narratives the second they break and offers an instant Fast Launch flow.
Live stream feeds incoming tweets from top crypto leaders, showing user verification status, follower count, media, and exact publication time.
Our narrative engine automatically parses tweet context to suggest relevant token names and ticker symbols ($TICKER) for immediate community consensus.
Auto-populates media images as token logo, formats tweet quote descriptions with source attribution, and sets the official website URL directly to the tweet post.
- 0.0005 ETH Launch Fee: Affordable, anti-spam deployment fee paid to Robinhood Chain Pons v2 factory.
- Post Link as Official Website: Every token launched from a tweet automatically links to the authentic tweet URL on the token explorer page, preserving provenance.
- Zero 5-Year Lockups: Tokens launched through LOCKEY have no forced 5-year vesting or lockup mechanisms, ensuring 100% fair and dynamic community market-making.
- Instant Snipe Protection: 5-second 99% decaying anti-snipe tax shields human traders from automated MEV bots upon launch.
1. Protocol Overview
Non-custodial token launch and decentralized trading protocol on Robinhood Chain
LOCKEY is a next-generation fair-launch token protocol built natively on Robinhood Chain (Chain ID: 4663). It is designed to solve classic problems found in conventional Web3 launchpads: steep initial liquidity capital requirements, developer rug-pull risks, sniper bot exploitation, and high gas fees.
LOCKEY operates in a strictly non-custodial manner — the platform never holds user private keys or custodial funds. Every token creation, swap transaction, and creator royalty claim is executed directly onchain by Robinhood Chain smart contracts through explicit cryptographic signatures from your Web3 wallet (OKX Wallet, MetaMask, Rabby, etc.).
- Native ETH Gas: Robinhood Chain utilizes native ETH for gas fees, ensuring fractional transaction costs with zero need for volatile gas bridging.
- Fixed Supply (Zero Post-Deployment Minting): Every token has a fixed supply of exactly 1,000,000,000 tokens (18 decimals). There is no backdoor mint function to dilute token holders.
- Permanently Locked Liquidity (Zero-Rug Guarantee): Upon reaching the 4.2 ETH graduation threshold, all liquidity is paired into Uniswap v4 and locked permanently in the Launch Locker contract.
- Transparent & Deterministic AMM Pricing: Token pricing is calculated mathematically using constant-product virtual reserves (x * y = k).
How LOCKEY Works (Step-by-Step)
End-to-end token lifecycle from creation to DEX liquidity graduation
Connect Web3 Wallet
Connect your Web3 wallet (OKX Wallet, MetaMask, or Rabby) to Robinhood Chain (Chain ID: 4663). Ensure you have native ETH for gas fees and trading capital.
Launch Token Instantly (/create)
Provide token name, ticker, description, IPFS logo, and set creator royalty (1% – 5%). The factory atomically mints 1B tokens (80% to curve, 20% to DEX escrow) and immediately redirects you to the live trading page.
Bonding Curve Trading
The public can immediately buy and sell tokens using native ETH. Each swap shifts the spot price algorithmically according to x * y = k with zero initial liquidity funding required.
5-Second Anti-Snipe Protection
In block 0 (first second), sniper bots face a 99% penalty tax paid directly to protocol reserves. The tax rapidly decays to 0% within 5 seconds, shielding human retail traders from MEV exploitation.
DEX Graduation & Permanent LP Lock
Upon reaching the 4.2 ETH liquidity target, curve trading concludes. Accumulated ETH and 200M reserved tokens are seeded into Uniswap v4, and the LP position is permanently locked in Launch Locker (Zero-Rug Guarantee).
Creator Royalties & Instant Claims
Creators earn 0% - 5% on every curve trade. ETH royalties safely accumulate in Fee Escrow and can be withdrawn anytime with a single click via the Creator Dashboard.
3. Token Launch Mechanism
Atomic creation of fixed-supply tokens and AMM bonding curve pools
To launch a new token, navigate to the Create Token page (/create). Specify the following project metadata:
Launch Features & Guarantees:
- Optional Opening Buy: Creators can specify an initial ETH buy amount in the exact atomic transaction to purchase supply before public discovery.
- Instant Auto-Redirect: As soon as the transaction confirms on Robinhood Chain, the frontend listens to the
TokenLaunchedevent log and immediately routes you to the live trading page. - Fixed Supply & Reserved Pool: Entire supply of 1,000,000,000 tokens is minted to the curve; the reserved share is automatically migrated and permanently locked into Uniswap v4 upon graduation.
2. Trading & Bonding Curve Mechanics
Continuous algorithmic pricing and automated swap execution
Every token trades against native ETH in its dedicated Pons bonding curve contract. Prices update deterministically with each transaction based on constant-product virtual reserves:
k = effectiveQuoteReserve * effectiveTokenReservepriceScaled = (effectiveQuoteReserve * 1e18) / effectiveTokenReservemarketCap = (effectiveQuoteReserve * totalSupply) / effectiveTokenReserveHow to Trade on the Platform
1. Enter the amount of native ETH you want to spend.
2. Click Buy with ETH. Tokens are transferred directly into your wallet and spot price adjusts upward.
3. No token approvals are required when spending native ETH!
1. Choose the percentage of tokens you wish to sell (25%, 50%, 75%, or 100% Max).
2. Click Approve Token to authorize the curve contract.
3. Click Sell Token. You receive native ETH directly into your wallet balance and spot price adjusts downward.
On every token page, traders can analyze an interactive real-time price & market cap chart. Below the chart, the Recent On-Chain Activity table displays real-time trades in a compact container with smooth vertical scrolling, sticky headers, and direct verification links to the Robinhood Blockscout Explorer.
3. Anti-Snipe Protection (99% Bot Decaying Tax)
Decaying protection tax during the first 5 seconds after launch
To prevent MEV bots and sniper scripts from extracting capital from human retail buyers on block 0, LOCKEY enforces a mathematical Decaying Snipe Tax directly inside the bonding curve smart contract for the first 5 seconds post-launch:
| Elapsed Time | Snipe Tax | Bot Impact | Retail Recommendation |
|---|---|---|---|
| 0 seconds (Launch Block) | 99.00% | Sniper bot loses 99% of capital to protocol | Wait 2-3 seconds |
| 1 second | 25.00% | Heavy penalty protection | Decays rapidly |
| 2 seconds | 3.00% | Minimal tax | Safe for entry |
| 5+ seconds | 0.00% | Protection concluded | Standard trading fees only (1% - 5%) |
function currentSnipeTaxBps(address recipient) public view override returns (uint256) {
if (isSnipeExempt[recipient]) return 0;
if (block.timestamp >= launchedAt + SNIPE_TAX_DURATION) return 0;
uint256 elapsed = block.timestamp - launchedAt;
if (elapsed == 0) return 9900; // 99%
if (elapsed == 1) return 2500; // 25%
if (elapsed == 2) return 300; // 3%
if (elapsed == 3) return 40; // 0.4%
if (elapsed == 4) return 5; // 0.05%
return 0;
}4. Uniswap v4 DEX Graduation & Zero-Rug Guarantee
Target valuation achievement and automatic DEX liquidity migration
A token officially Graduates once its Market Cap reaches the $20,000 USDC target (10,000 basis points on the bonding curve progress bar).
progressBps = ((currentMarketCap - initialMarketCap) * 10_000) / (graduationMarketCap - initialMarketCap)Upon graduation, the smart contracts orchestrate automated DEX migration with zero manual intervention:
- Curve Closure: The curve status transitions to
GRADUATEDand bonding curve trading stops. - Uniswap v4 Seeding: All accumulated USDC reserves (~$5,000 USDC) plus the 200,000,000 migration reserve tokens are paired directly into a full-range Uniswap v4 pool via
UniswapV4Adapter. - Permanent LP NFT Burn (Zero-Rug Guarantee): Ownership of the Uniswap v4 liquidity position NFT is transferred directly to the dead address (
0x000000000000000000000000000000000000dEaD). Neither creators nor protocol admins can ever withdraw the liquidity. - Burn Remaining Unsold Curve Tokens: Any unsold tokens remaining in the bonding curve are permanently burned to
0xdeadto prevent supply dilution.
5. Fees & Creator Royalties
Transparent and isolated revenue distribution
Every buy and sell trade on the bonding curve generates a fractional liquidity fee denominated in native ETH:
Configured by the creator at launch. Safely accrued in Pons FeeEscrow and withdrawable anytime.
Dedicated to Robinhood Chain RPC node infrastructure maintenance and onchain indexers.
6. Creator Dashboard
Track trading volume and claim accrued ETH royalties with 1 click
Token creators can access the Creator Royalty Fees dashboard (/creator-dashboard) to monitor token metrics.
How to Claim Your Creator Royalties:
- Open Creator Royalty Fees with the same wallet used to launch the token.
- The dashboard automatically reads accumulated ETH balances from the Pons FeeEscrow contract.
- Inspect Total Traded Volume and Claimable Creator Royalties (in native ETH).
- Click Claim Royalties and confirm the transaction in your wallet. ETH royalties arrive directly in your wallet balance!
7. Community Takeovers (CTO)
Decentralized transfer when an original creator steps away
If an original creator becomes inactive or abandons a project, token holders can organize a Community Takeover (CTO). This mechanism empowers the community to update social channels (Twitter, Telegram, Website) and redirect future creator royalties to a community multisig or treasury wallet.
8. Risk Disclosures
Important market considerations and transparency disclosures
- All tokens launched on LOCKEY are user-created and permissionless.
- Token names and tickers can be duplicated by other creators. Always verify the token contract address before trading.
- Cryptocurrency assets are volatile and trading involves market risk. Never trade more than you can afford to lose.
- LOCKEY is decentralized open-source software and does not provide financial or investment advice.
A minimal, verifiable integration surface.
Everything reads directly off onchain smart contracts. Index factory and curve events for a trust-minimized source of truth.
Network
Robinhood Chain Layer-2 with native ETH
| Network | Robinhood Chain (Mainnet) |
| Chain ID | 4663 |
| Native Asset | Ether (ETH) — 18 Decimals |
| Public RPC | https://rpc.mainnet.chain.robinhood.com |
| Explorer | https://robinhoodchain.blockscout.com |
| Fixed Supply | 1,000,000,000 (1 Billion) |
Contracts
Audited Pons v2 protocol contracts on Robinhood Chain
0x7eD598BcEf8bd9Edd8C97A195C6d13f40801EC7e0xe33E9E479dF8802cb0866d5d05258bEc4cF629480xd3AFEB2a57f70eF218Aa82451c51B2fb0416Ac9e0x267444D099b10fB5Ed7c3Cc7B7c767AdcA5749520xE5e702641Ea86F4ae6cC3cDaeD2B886f976Be044Onchain events
Index factory and curve events to derive real-time market data
0xad827b8769af2ee1f1daabe1d3632fbd92475a236001baf1b0fc541ae488facf0x0e6586f818d103e43bbea35a671f1b7e6d8454866f959af81988f61e452b4a730xbea68ab0c22ead8d2f0d2a03d8854ec4ea4d7cccddc1bb3c61bf3c8c6624a56eimport { createPublicClient, http, parseAbiItem } from "viem";
const client = createPublicClient({
chain: {
id: 4663,
name: "Robinhood Chain",
nativeCurrency: { name: "Ether", symbol: "ETH", decimals: 18 },
rpcUrls: { default: { http: ["https://rpc.mainnet.chain.robinhood.com"] } },
},
transport: http(),
});
// Query all token creation logs from the Factory
const launches = await client.getLogs({
address: "0x7eD598BcEf8bd9Edd8C97A195C6d13f40801EC7e",
event: parseAbiItem(
"event TokenLaunched(address indexed token, address indexed curve, address indexed deployer, address pairToken, uint256 launchConfigId, uint256 graduationThreshold)"
),
fromBlock: "earliest",
toBlock: "latest",
});// Determine trade direction from emitted event
const side = event.eventName === "CurveBuy" ? "buy" : "sell";
const trader = side === "buy" ? args.buyer : args.seller;
const volumeEth = Number(args.quoteIn || args.quoteOut) / 1e18;Reading token state
Read metadata and curve parameters directly from the blockchain
import { parseAbi } from "viem";
// Every launched ERC-20 token is self-describing onchain
const tokenAbi = parseAbi([
"function name() view returns (string)",
"function symbol() view returns (string)",
"function decimals() view returns (uint8)",
"function totalSupply() view returns (uint256)",
"function metadataURI() view returns (string)",
]);
const [name, symbol, decimals, totalSupply] = await Promise.all([
client.readContract({ address: tokenAddress, abi: tokenAbi, functionName: "name" }),
client.readContract({ address: tokenAddress, abi: tokenAbi, functionName: "symbol" }),
client.readContract({ address: tokenAddress, abi: tokenAbi, functionName: "decimals" }),
client.readContract({ address: tokenAddress, abi: tokenAbi, functionName: "totalSupply" }),
]);
// Resolve the Bonding Curve address from the Factory
const curveAddress = await client.readContract({
address: "0x7eD598BcEf8bd9Edd8C97A195C6d13f40801EC7e",
abi: parseAbi(["function getCurve(address token) view returns (address)"]),
functionName: "getCurve",
args: [tokenAddress],
});const factoryAbi = parseAbi([
"function tokenRecords(address token) view returns (address token, address curve, address creator, address quoteToken, uint256 createdAt)",
]);
const record = await client.readContract({
address: "0x7eD598BcEf8bd9Edd8C97A195C6d13f40801EC7e",
abi: factoryAbi,
functionName: "tokenRecords",
args: [tokenAddress],
});Pricing and graduation logic
Calculate spot prices, market cap, and graduation progress
const curveAbi = parseAbi([
"function getCurrentPrice() view returns (uint256)",
"function getMarketCap() view returns (uint256)",
"function getProgress() view returns (uint256)",
"function getReserves() view returns ((uint256 virtualQuoteReserve, uint256 virtualTokenReserve, uint256 realQuoteReserve, uint256 realTokenReserve))",
]);
const [priceScaled, marketCapInQuote, progressBps, reserves] = await Promise.all([
client.readContract({ address: curveAddress, abi: curveAbi, functionName: "getCurrentPrice" }),
client.readContract({ address: curveAddress, abi: curveAbi, functionName: "getMarketCap" }),
client.readContract({ address: curveAddress, abi: curveAbi, functionName: "getProgress" }),
client.readContract({ address: curveAddress, abi: curveAbi, functionName: "getReserves" }),
]);
// Price in USDC per token (divided by 1e18)
const priceUsdc = Number(priceScaled) / 1e18;
// Market Cap in USDC dollars (divided by 1e6)
const marketCapUsd = Number(marketCapInQuote) / 1e6;
// Graduation progress percentage (0 to 100%)
const progressPercent = Number(progressBps) / 100;const status = await client.readContract({
address: curveAddress,
abi: parseAbi(["function status() view returns (uint8)"]),
functionName: "status",
});
// 0: BONDING (Trading active on the bonding curve)
// 1: GRADUATED (Curve closed, liquidity migrated to Uniswap V4)
const isGraduated = status === 1;Executing trades (Buy / Sell)
Smart contract interactions for swapping tokens
import { parseUnits } from "viem";
// 1. Fetch quote for buy amount
const buyQuote = await client.readContract({
address: curveAddress,
abi: parseAbi([
"function quoteBuy(uint256 quoteAmountIn) view returns ((uint256 tokensOut, uint256 feeAmount, uint256 priceImpactBps, uint256 newMarketCap))",
]),
functionName: "quoteBuy",
args: [parseUnits("50", 6)], // 50 USDC
});
// 2. Approve USDC transfer
await walletClient.writeContract({
address: "0x0000000000000000000000000000000000000000",
abi: parseAbi(["function approve(address spender, uint256 amount) returns (bool)"]),
functionName: "approve",
args: [curveAddress, parseUnits("50", 6)],
});
// 3. Execute Buy with 1% slippage tolerance
const minTokensOut = (buyQuote.tokensOut * 99n) / 100n;
const deadline = BigInt(Math.floor(Date.now() / 1000) + 1200); // 20 Minutes
await walletClient.writeContract({
address: curveAddress,
abi: parseAbi([
"function buy(uint256 quoteAmountIn, uint256 minTokensOut, uint256 deadline) returns (uint256)",
]),
functionName: "buy",
args: [parseUnits("50", 6), minTokensOut, deadline],
});// 1. Approve launch token
await walletClient.writeContract({
address: tokenAddress,
abi: parseAbi(["function approve(address spender, uint256 amount) returns (bool)"]),
functionName: "approve",
args: [curveAddress, tokenAmountToSell],
});
// 2. Execute Sell
await walletClient.writeContract({
address: curveAddress,
abi: parseAbi([
"function sell(uint256 tokenAmountIn, uint256 minQuoteOut, uint256 deadline) returns (uint256)",
]),
functionName: "sell",
args: [tokenAmountToSell, minQuoteOut, deadline],
});Fee claims and payout
Query and claim creator royalties from FeeManager
const feeManagerAbi = parseAbi([
"function getClaimableCreatorFees(address token, address creator) view returns (uint256)",
"function claimCreatorFees(address token)",
]);
// Read unclaimed creator royalties
const claimable = await client.readContract({
address: "0xd3AFEB2a57f70eF218Aa82451c51B2fb0416Ac9e",
abi: feeManagerAbi,
functionName: "getClaimableCreatorFees",
args: [tokenAddress, creatorAddress],
});
// Claim USDC directly to wallet
if (claimable > 0n) {
await walletClient.writeContract({
address: "0xd3AFEB2a57f70eF218Aa82451c51B2fb0416Ac9e",
abi: feeManagerAbi,
functionName: "claimCreatorFees",
args: [tokenAddress],
});
}Ready to launch your first token?
Deploy a fair-launch token on Robinhood Chain in seconds.
