# CapyPad Protocol Specification (Full Architecture & Multi-Chain Reference)

> System Documentation, Smart Contract Specifications, Virtual Bonding Curve Mathematics, and Multi-Chain Integration Guides for CapyPad (capypad.fun).

---

## 1. System Overview

CapyPad is an institutional-grade, multi-chain fair-launch bonding curve launchpad and high-frequency trading terminal natively deployed across:
1. **Base (Ethereum L2, Chain ID 8453)**
2. **Solana (High-Speed Layer 1)**
3. **Robinhood Chain (Arbitrum Orbit Rollup, Chain ID 4663)**

The protocol allows permissionless token creation with zero liquidity requirements, bonding curve trading with anti-snipe safeguards, automated graduation with permanent LP burn, and 20% instant on-chain affiliate fee sharing.

---

## 2. Multi-Chain Execution Parameters

### 2.1 Base Mainnet (8453 / 0x2105)
- **Settlement Assets**: Native ETH, Canonical WETH (`0x4200000000000000000000000000000000000006`), Native USDC (`0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`).
- **Bonding Curve Mechanism**: Constant Product AMM ($x \cdot y = k$).
- **USDC Curves**: 4,000 USDC virtual reserve, initial market cap $2,004, graduation target 20,000 USDC ($69,000 mcap).
- **ETH Curves**: 2.0 ETH virtual reserve, initial market cap ~$5,300, graduation target 8.0 ETH ($69,000 mcap).
- **Graduation Target**: Uniswap V2 / Aerodrome.
- **LP Burn Target**: `0x000000000000000000000000000000000000dEaD`.

### 2.2 Solana Mainnet-Beta
- **Settlement Assets**: Native SOL, USDY.
- **Bonding Curve Mechanism**: Meteora Dynamic DLMM / CPMM AMM.
- **Curve Parameters**: 30 SOL initial virtual reserve, graduation target 85 SOL.
- **Routing**: Jupiter v6 Aggregator API.
- **Graduation Target**: Meteora DLMM Dynamic Pool.
- **LP Burn Target**: Permanent LP token incineration.

### 2.3 Robinhood Chain L2 Mainnet (4663 / 0x1237)
- **Settlement Assets**: Native ETH, WETH (`0x0Bd7D308f8E1639FAb988df18A8011f41EAcAD73`), USDG (`0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168`).
- **Curve Parameters**: 2.0 ETH virtual reserve, graduation target 8.0 ETH.
- **Graduation Target**: Uniswap V2 Mainnet Router (`0x548D1ffE1BD2F5E0c97589E62261320B5B092E10`).
- **LP Burn Target**: `0x000000000000000000000000000000000000dEaD`.

---

## 3. Verified Smart Contract Registry

### 3.1 Base Mainnet (Chain ID 8453)
| Component | Contract Address |
| :--- | :--- |
| **CapyV2Factory** | `0xC3b20d5DD3B9E89a3e9Ae9fAF41D399DD39D47e3` |
| **CapyV2FeeEscrow** | `0x4aF656F5D17bDEe3185E788AC2E24393F110A3D4` |
| **CapyV2BuybackVault** | `0x935cc57c0106cDf677EB13b941222e1D8fDB843d` |
| **CapyV2Deployer** | `0x45D07A326e17B61693d23eFF1B97EA078Aa4e6cD` |
| **Uniswap V2 Router** | `0x4752ba5DBc23f44D87826276BF6Fd6b1C372aD24` |
| **Aerodrome Router** | `0xcF77a3Ba9A5CA399B7c97c74d54e5b1Beb874E43` |
| **Base Native USDC** | `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913` |
| **Base Canonical WETH**| `0x4200000000000000000000000000000000000006` |
| **$BCAPY (Flagship)** | `0x33c97a2fa042f5f0c162c132d7586a0279e9f20b` |
| **$BCAPY Curve** | `0xc7d562540d33d6f304f01c0746c13972335eec31` |
| **Protocol Treasury** | `0x3eF368806fa91e16C2775A155a937C0Da81F0Bc2` |

### 3.2 Solana Mainnet-Beta
| Component | Account / Public Key |
| :--- | :--- |
| **Meteora DLMM Program**| `LBUZKhRxPF3XUpBCjp4YzTKgLccjZhTSDM9YuVaPwxo` |
| **Jupiter v6 Router** | `JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4` |
| **SPL Token Program** | `TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA` |
| **Associated Token Program** | `ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL` |

### 3.3 Robinhood Chain L2 (Chain ID 4663)
| Component | Contract Address |
| :--- | :--- |
| **CapyV2Factory** | `0xAe332849022A8B71cc4e1A0F9c5a61172c7aE5EB` |
| **CapySwapRouter** | `0x548D1ffE1BD2F5E0c97589E62261320B5B092E10` |
| **CapyV2FeeEscrow** | `0xc38D3Be2c751325cb764c5f8C2FcA2b765B73189` |
| **CapyV2BuybackVault** | `0x54F5223CAd1beFfc569Dc1Eef96239aD0778D264` |
| **$CAPY (Genesis Token)**| `0xe96e9fc9a9f952f76af14fc585a9625d25ed8304` |
| **$CAPY / WETH LP** | `0x3bc29f9Be714bB5e231CaF453eD9a0A24913589b` |

---

## 4. Virtual Bonding Curve Mathematical Derivation

CapyPad uses a virtual constant product AMM formulation.
Total token supply $S = 1,000,000,000$.
Tokens allocated to curve $X_{\text{curve}} = 800,000,000$.
Tokens reserved for DEX LP $X_{\text{lp}} = 200,000,000$.

Let $x$ be the remaining token supply on the curve, $x_v$ be virtual token offset ($200,000,000$), $y$ be real collected quote reserve, and $y_v$ be virtual quote offset.

$$k = (x + x_v) \cdot (y + y_v)$$

At genesis ($t = 0$):
$x = 800,000,000$, $x + x_v = 1,000,000,000$, $y = 0$, $y + y_v = y_v$.
Hence:
$$k = 1,000,000,000 \cdot y_v$$

At graduation ($t = 1$):
$x = 0$, $x + x_v = 200,000,000$.
The accumulated quote reserve equals $Y_{\text{grad}}$.
$$(200,000,000) \cdot (Y_{\text{grad}} + y_v) = k$$
$$200,000,000 \cdot (Y_{\text{grad}} + y_v) = 1,000,000,000 \cdot y_v$$
$$Y_{\text{grad}} + y_v = 5 \cdot y_v \implies Y_{\text{grad}} = 4 \cdot y_v \implies y_v = \frac{Y_{\text{grad}}}{4}$$

Spot price at any stage:
$$P(x) = \frac{y + y_v}{x + x_v} = \frac{k}{(x + x_v)^2}$$

Initial Spot Price:
$$P_0 = \frac{y_v}{1,000,000,000} = \frac{Y_{\text{grad}}}{4,000,000,000}$$

Graduation Spot Price:
$$P_{\text{grad}} = \frac{Y_{\text{grad}} + y_v}{200,000,000} = \frac{1.25 \cdot Y_{\text{grad}}}{200,000,000} = \frac{25 \cdot Y_{\text{grad}}}{4,000,000,000} = 25 \cdot P_0$$

The graduation spot price is exactly **25x** the initial price, providing a smooth and predictable bonding trajectory.

---

## 5. Fee Schedule & 20% Instant Referral Rebate

CapyPad enforces a **1.0% flat fee** on all swaps during the bonding curve phase.

- **20% (0.20% of trade volume)**: Transferred directly and atomically to the referrer's address. If no referrer is present, the fee flows to the protocol buyback vault.
- **80% (0.80% of trade volume)**: Allocated between protocol treasury and the automated buyback vault.

Referral binding is persistent and non-custodial:
```solidity
function swapExactQuoteForTokens(
    address tokenAddress,
    uint256 minTokensOut,
    address referrer,
    uint256 deadline
) external payable returns (uint256 tokensOut);
```
During execution, `CapyV2FeeEscrow` verifies the referrer address and transfers 20% of `msg.value` (or ERC-20 quote) in the same transaction block.

---

## 6. Security Guarantees & Audit Standards

1. **Zero Pre-Mine**: 100% of the tradeable supply is purchased through the curve.
2. **Permanent LP Destruction**: All LP tokens minted on Uniswap V2 are transferred to `0x000000000000000000000000000000000000dEaD`; Solana DLMM LP positions are incinerated.
3. **No Mint Capabilities**: Token contracts conform to standard fixed-supply specifications with no post-deployment mint function.
4. **Anti-Snipe Guard**: Maximum single-order transaction volume during initial curve blocks capped at 2% of curve supply.