Documentation
The Pairo Protocol
Lifecycle, curve mechanics, currency system and developer architecture.
Introduction
Pairo is a permissionless token launch and trading protocol built on Robinhood Chain. It combines token deployment, market initialization, automated price discovery and liquidity formation into a single protocol.
What is Pairo?
Unlike launch systems where every market uses one universal denomination, Pairo allows creators to permanently select a supported currency denomination when creating their market. Each denomination operates as an independent economic compartment with its own reserve environment.
Core Concepts
- TOKEN
- A fixed-supply token created through Pairo.
- PAIRO CURRENCY
- The permanent denomination selected for a token's market.
- BONDING CURVE
- The automated market used during initial price discovery.
- VIRTUAL RESERVES
- Pricing-state variables used by the constant-product market.
- GRADUATION
- Transition from bonding-curve discovery into decentralized liquidity.
- PROTOCOL-CONTROLLED LIQUIDITY
- Post-graduation liquidity governed by predefined protocol rules.
Quick Start
1. Connect a MetaMask wallet on Robinhood Chain. 2. Open /launch and configure your token. 3. Select a permanent market currency. 4. Review and deploy once contracts are live. Creation is currently preview-only — the button state is COMING SOON.
Architecture
Pairo coordinates token creation, supply allocation, currency denomination, bonding-curve pricing, trading fees, launch protection, graduation and post-graduation liquidity. Markets operate according to predefined smart-contract rules. Exact implementation parameters should be sourced from deployed protocol contracts and configuration — they are not invented by this frontend.
Token Creation
Creators provide a token name, ticker, artwork, market currency, an optional creator fee and an optional initial purchase. After execution, Pairo initializes the token's market automatically with a fixed supply of 1,000,000,000 — 800,000,000 to the initial curve and 200,000,000 reserved for graduation liquidity.
Pairo Currency
Pairo Currency units are on-chain protocol assets associated with external exchange-rate references. They are not bank deposits, balances held by financial institutions, government-issued currency, insured deposits, or guaranteed fiat redemption claims.
Bonding Curve
Pairo uses a constant-product market: x × y = k where x is the virtual token reserve, y is the virtual currency reserve and k is the constant product. Buying decreases available curve inventory and increases implied token price; selling adjusts the curve according to its mathematical state.
Exact curve parameters (initial reserves, fee accounting, graduation condition) are defined by deployed contracts — CONFIGURED BY PROTOCOL.
Virtual Reserves
Virtual reserves are pricing-state variables that let the curve express a consistent price path from the first trade without requiring an externally seeded liquidity pool.
Trading
Trading happens against the bonding curve until graduation. Output estimates, price impact and fees are computed from the curve's current state. The trading interface is available at /token/[address].
Fees
Base trading fee: 1%. Creator: 70% of the base fee. Protocol: 30% of the base fee. Additional creator fee: optional, within protocol-defined limits.
Launch Protection
Launch → High Charge → Early Market, Declining Charge → Normal Market, 0%. The charge begins high and progressively declines to zero. Exact starting percentage and duration: CONFIGURED BY PROTOCOL. Creator bundled initial purchases are exempt.
Graduation
Graduation occurs only when the protocol-defined market condition is satisfied. At graduation: market reserves transition into liquidity, 200M reserved tokens are introduced into the liquidity structure, DEX liquidity is established, bonding-curve trading ends, and the market transitions to post-graduation trading.
Post-Graduation Liquidity
Graduation liquidity is controlled according to predefined protocol rules. The creator cannot simply withdraw the initial liquidity position at discretion. This reduces discretionary liquidity-removal risk but does not eliminate market risk.
Token Lifecycle
- 01CREATE
- 02CURRENCY SELECTION
- 03TOKEN DEPLOYMENT
- 04BONDING CURVE
- 05TRADING
- 06MARKET DISCOVERY
- 07GRADUATION CONDITION
- 08LIQUIDITY TRANSITION
- 09POST-GRADUATION MARKET
Market State
A market's state includes its denomination, virtual reserves, tokens distributed, curve progress, fee configuration and graduation status. The frontend models these through clean interfaces (Token, Market, CurveState, GraduationState) so demo data can be replaced with live protocol data.
Events
Contract event specifications will be published with the deployed protocol contracts. This section is intentionally left unspecified until then.
Integration Guide
Integrators should read market state from the deployed protocol contracts and never from this preview frontend. Canonical protocol parameters are kept in a single configuration module (lib/protocol.ts) and separated from demo market data.
Wallet Integration
The interface connects via MetaMask (window.ethereum) on Robinhood Chain. Wallet connection is genuine; protocol interactions remain preview-only and never request transactions, approvals or signatures.
Protocol Parameters
- NETWORK
- Robinhood Chain
- SUPPLY
- 1B
- INITIAL MARKET
- 800M
- LIQUIDITY ALLOCATION
- 200M
- BASE FEE
- 1%
- CREATOR SHARE
- 70%
- PROTOCOL SHARE
- 30%
- CURVE
- Constant Product + Virtual Reserves
- CURRENCY
- Selected Permanently at Launch
- LAUNCH PROTECTION
- Temporary + Declining
- GRADUATION
- Protocol-defined
- LIQUIDITY
- Protocol-controlled
Glossary
- Denomination
- The permanent currency unit a token's market is priced in.
- Curve inventory
- Curve tokens available to buyers at the current state.
- Graduation condition
- The protocol-defined market condition required to graduate.
- Launch protection
- A temporary declining charge applied to purchases after launch.
Risk Disclosure
- Market volatility — token prices can move sharply in either direction.
- Loss of capital — participants may lose some or all of the assets they commit.
- Liquidity risk — markets may thin out, increasing slippage and price impact.
- Smart-contract vulnerabilities — protocol contracts may contain undiscovered flaws.
- Exchange-rate reference risk — currency-unit pricing depends on external references.
- Network risk — Robinhood Chain outages or congestion affect all markets.
- Creator/project risk — permissionless creation means anyone can launch anything.
- Regulatory risk — the treatment of protocol assets may change.
- Speculative risk — most tokens created permissionlessly fail.
Participants should only use assets they are prepared to lose.