Official LOCKEY Documentation • Robinhood Chain ID 4663

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.

Gas Asset: Native ETHTotal Supply: 1,000,000,000 FixedGraduation Target: 4.2 ETHLP Liquidity: Automated Uniswap v4 Migration
Flagship Live Feed Engine

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.

01
Real-Time Ingestion

Live stream feeds incoming tweets from top crypto leaders, showing user verification status, follower count, media, and exact publication time.

02
Automated Ticker Parsing

Our narrative engine automatically parses tweet context to suggest relevant token names and ticker symbols ($TICKER) for immediate community consensus.

03
1-Click Fast Launch

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.

Instant Narrative Token Dynamics
  • 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.).

Key Architectural Guarantees
  • 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

01

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.

02

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.

03

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.

04

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.

05

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

06

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:

Token Name & SymbolFull project title and concise ticker (e.g., RobinMoon / MOON).
Token Logo (IPFS)Decentralized asset hosting uploaded automatically via Pinata IPFS.
Description & Social LinksProject story, official X / Twitter, Telegram, and Website URLs.
Creator Royalty (1.00% – 5.00%)Percentage of trading volume paid directly to the creator wallet in native ETH.

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 TokenLaunched event 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:

Constant-Product Invariantk = effectiveQuoteReserve * effectiveTokenReserve
Spot Price Formula (ETH per Token)priceScaled = (effectiveQuoteReserve * 1e18) / effectiveTokenReserve
Total Market CapitalizationmarketCap = (effectiveQuoteReserve * totalSupply) / effectiveTokenReserve

How to Trade on the Platform

Buying Tokens (Buy)

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!

Selling Tokens (Sell)

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.

Real-Time Charts & On-Chain Activity Feed:

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 TimeSnipe TaxBot ImpactRetail Recommendation
0 seconds (Launch Block)99.00%Sniper bot loses 99% of capital to protocolWait 2-3 seconds
1 second25.00%Heavy penalty protectionDecays rapidly
2 seconds3.00%Minimal taxSafe for entry
5+ seconds0.00%Protection concludedStandard trading fees only (1% - 5%)
currentSnipeTaxBps logic in BondingCurve.sol
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).

Progress Calculation FormulaprogressBps = ((currentMarketCap - initialMarketCap) * 10_000) / (graduationMarketCap - initialMarketCap)
Zero-Rug & Anti-Dilution Guarantees on Uniswap v4 Migration:

Upon graduation, the smart contracts orchestrate automated DEX migration with zero manual intervention:

  1. Curve Closure: The curve status transitions to GRADUATED and bonding curve trading stops.
  2. 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.
  3. 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.
  4. Burn Remaining Unsold Curve Tokens: Any unsold tokens remaining in the bonding curve are permanently burned to 0xdead to 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:

Creator Royalty1.00% – 5.00%

Configured by the creator at launch. Safely accrued in Pons FeeEscrow and withdrawable anytime.

Protocol Fee0.50% – 1.00%

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:

  1. Open Creator Royalty Fees with the same wallet used to launch the token.
  2. The dashboard automatically reads accumulated ETH balances from the Pons FeeEscrow contract.
  3. Inspect Total Traded Volume and Claimable Creator Royalties (in native ETH).
  4. 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.

Bonding curve and Uniswap v4 liquidity is 100% immutable and strictly protected from any modification during a CTO.

8. Risk Disclosures

Important market considerations and transparency disclosures

Important Considerations
  • 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.
Developer Reference Surface

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

NetworkRobinhood Chain (Mainnet)
Chain ID4663
Native AssetEther (ETH) — 18 Decimals
Public RPChttps://rpc.mainnet.chain.robinhood.com
Explorerhttps://robinhoodchain.blockscout.com
Fixed Supply1,000,000,000 (1 Billion)

Contracts

Audited Pons v2 protocol contracts on Robinhood Chain

Launch FactoryDeploys each launch, pins economics, drives graduation
0x7eD598BcEf8bd9Edd8C97A195C6d13f40801EC7e
Launch & Buy RouterAtomic create + opening buy router
0xe33E9E479dF8802cb0866d5d05258bEc4cF62948
Fee EscrowHolds claimable creator royalties & protocol balances
0xd3AFEB2a57f70eF218Aa82451c51B2fb0416Ac9e
Launch LockerPermanently locks graduated Uniswap v4 positions
0x267444D099b10fB5Ed7c3Cc7B7c767AdcA574952
Meme HookSingleton Uniswap v4 fee accrual and distribution hook
0xE5e702641Ea86F4ae6cC3cDaeD2B886f976Be044

Onchain events

Index factory and curve events to derive real-time market data

TokenCreated (topic0)
0xad827b8769af2ee1f1daabe1d3632fbd92475a236001baf1b0fc541ae488facf
TokenBought (topic0)
0x0e6586f818d103e43bbea35a671f1b7e6d8454866f959af81988f61e452b4a73
TokenSold (topic0)
0xbea68ab0c22ead8d2f0d2a03d8854ec4ea4d7cccddc1bb3c61bf3c8c6624a56e
Read launches with viem
import { 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",
});
Buy or sell side detection from trade events
// 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

Token metadata and curve address
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],
});
getLaunchedToken record from Factory
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

Price, reserves, and market cap
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;
Graduation status
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

Buy execution (spend USDC to get 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],
});
Sell execution (sell Tokens to get USDC)
// 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

Claiming creator fees with Viem
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.