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

  1. 01CREATE
  2. 02CURRENCY SELECTION
  3. 03TOKEN DEPLOYMENT
  4. 04BONDING CURVE
  5. 05TRADING
  6. 06MARKET DISCOVERY
  7. 07GRADUATION CONDITION
  8. 08LIQUIDITY TRANSITION
  9. 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.