PALS Protocol
Technical documentation for the creator-token marketplace on Robinhood Chain.
Architecture
PALS is a specialized interface operating on top of the Pons v2 bonding curve protocol deployed natively to Robinhood Chain. The system enables creators to launch personal tokens paired against either native ETH or fractionalized Real-World Assets (RWAs).
At its core, PALS introduces a custom Gate Factory overlay that enforces continuous self-ownership requirements before any creator fees can be swept from the core protocol fee escrow.
Robinhood Chain Config
The marketplace operates exclusively on the Robinhood Chain mainnet.
- Network name
- Robinhood Chain
- Chain ID
- 4663 (0x1237)
- Native currency
- Ether (ETH), 18 decimals
- RPC URL
- https://rpc.mainnet.chain.robinhood.com/
- Explorer
- https://robinhoodchain.blockscout.com
- Multicall3
- 0xcA11bde05977b3631167028862bE2a173976CA11
Canonical Pons v2 Contracts
PALS utilizes the canonical Pons v2 deployment. All creator tokens and bonding curves are directly instantiated through the PonsV2LaunchFactory.
0x7eD598BcEf8bd9Edd8C97A195C6d13f40801EC7eDeployed at block 268418460xd3afeb2a57f70ef218aa82451c51b2fb0416ac9e0x42df2a798f82289e177311362e8f5ccc45c1219c0xe5e702641ea86f4ae6cc3cdaed2b886f976be044Club/Gate Trust Model
Unlike vanilla Pons v2 launches where creator fees are sent directly to an EOA, PALS wraps every token launch in a Self-Ownership Fee Gate.
The Gate Factory (0x83cd60bc5f34ac2ffabc88462a4411700ffc227a) immutably binds a unique Gate contract to the creator prior to the token launch. The Pons Factory configures the Gate as the creatorFeeRecipient.
All trading fees allocated to the creator accumulate in the global Pons Fee Escrow under the Gate's address, forcing the creator to abide by the Gate's staking rules to ever withdraw their earnings.
Creator Launch Flow
- 1Pair selection: The creator selects either native ETH or a pre-approved RWA asset as the quote token.
- 2Gate deployment: The creator calls
deployGate. The factory derives a deployment salt from the creator and supplied salt, then usesCREATE2to deploy a gate with immutable Pons factory, escrow, creator, and threshold configuration. - 3Launch registration: The creator calls canonical Pons
launchTokenwith token metadata, launch-config ID, pair token, expected economics hash, and the predicted gate ascreatorFeeRecipient. - 4Binding: After launch, the creator calls
bindCreatorToken. The gate verifies the Pons record exists, the deployer is the original creator, the curve is deployed, and the fee recipient is the gate; the registry then maps the token to that bound gate.
ETH & RWA Pairs
A token's pair determines its quote reserve asset. ETH is represented as the zero address (0x0000...0000). PALS supports fractionalized Real-World Assets (RWAs) as quote tokens for creators targeting traditional equity economies.
0xd0601ce157db5bdc3162bbac2a2c8af5320d9eec0x4a0e65a3eccec6dbe60ae065f2e7bb85fae35eea0x2e0847e8910a9732eb3fb1bb4b70a580adad4fe30x322f0929c4625ed5bad873c95208d54e1c003b2d0x1b0e319c6a659f002271b69db8a7df2f911c153e0xaf3d76f1834a1d425780943c99ea8a608f8a93f90x117cc2133c37b721f49de2a7a74833232b3b4c0c0x5fc5360d0400a0fd4f2af552add042d716f1d168Buy/Sell Mechanics
Trading is fully automated by the Pons bonding curve. Users interact via buy() and sell() methods. The internal pricing function relies on a virtual/phantom quote reserve injected at launch to define the starting price and liquidity depth.
The pair-specific graduationThreshold is denominated in the quote asset's smallest units. When Pons reports the curve ready to graduate, its phase and liquidity migration behavior are governed by canonical Pons v2 — not by PALS.
Fee Lifecycle
Curve fees are determined by the canonical Pons launch configuration. The curve exposes pending quote-fee and creator-tax balances; PALS does not modify the bonding-curve pricing formula.
- Pending on the curve: Quote fees and creator-tax balances accrue in the canonical curve.
- Sweep: The immutable creator calls
sweepCreatorFees(minBuybackTokensOut)through the gate. The gate invokes the bound curve'ssweepFees, moving the fee accounting into canonical Pons escrow. - Claim: Native ETH uses
claimFromFeeEscrow; token-paired launches useclaimTokenFromFeeEscrow. Both claims require the seven-day eligibility test at execution time.
Escrow credits belong to the gate address, not directly to the creator wallet. The gate checks eligibility before pulling the full corresponding escrow ledger balance and forwarding it to the creator-selected recipient.
Staking & Self-Ownership
Sweeping curve balances into escrow and claiming escrowed funds are separate actions. A creator may sweep through the bound gate, but cannot claim or withdraw gate-held value until they demonstrate continuous self-ownership for 7 consecutive days.
The 7-day rule
The Gate requires a requiredStake (usually 100 bps / 1% of total supply). When a creator stakes enough tokens into the Gate, a qualifyingSince timestamp is recorded. If at any block their stake falls below the requirement, eligibility is instantly revoked and the timer resets to zero. Only when block.timestamp >= qualifyingSince + 7 days does isEligible() return true.
Wallet & Image Security
Non-custodial architecture: PALS is entirely non-custodial. Private keys never leave the browser extension (MetaMask, Rabby, etc). All blockchain interactions rely on EIP-1193 standard providers.
Asset integrity: Club image uploads are authorized with a fresh wallet signature. The API validates the recovered signer, upload purpose, timestamp, nonce, media type, and size before writing to private storage; public image responses are immutable. The permanent production origin is used in launch metadata so on-chain URLs never depend on a temporary preview hostname.
API & RPC Behavior
To maintain high availability and circumvent public node rate-limits, frontend reads are multiplexed through a backend proxy at /api/robinhood-rpc.
Blockscout logs (used to detect recent token launches) are proxied through /api/pons/factory-logs. Wallet interactions (writes) bypass the proxy and submit directly to the chain via the user's provider to guarantee transaction integrity.
- Multicall batch
- PONS_MULTICALL_BATCH_SIZE = 24,000 bytes
- Launch cache
- LAUNCH_CACHE_TTL = 60,000 ms
Contract Reference
Full reference of deployed PALS infrastructure.
0x83cd60bc5f34ac2ffabc88462a4411700ffc227a0x3ddfbdc8f21be9f736bf5681bbc6e3a61d84ac267c1dad2e666d080ffac63f78Launch & Security Caveats
- Factory verification: The client rigorously verifies the Pons v2 factory runtime hash (
0x89a27da6...). If the chain RPC attempts to present a modified factory, the interface will gracefully lock out transactions. - No migration: Once a token is deployed via the Gate Factory, the binding cannot be undone. You cannot transfer fee-claiming rights to a secondary address without migrating the private key of the creator EOA.
- Proxy trust: Read proxies only provide data availability, not security. Trust assumptions rely entirely on verifiable contract state on Robinhood Chain.
Troubleshooting
Transaction reverted: "Not eligible"
You attempted to sweep fees before your 7-day continuous stake elapsed. Ensure your stake hasn't dropped below the required threshold at any point.
Wrong network
Wallets must be strictly bound to Robinhood Chain (ID 4663). Use the switch network button in the header if you are connected to Ethereum Mainnet.
Risk Disclosures
Cryptocurrency tokens, bonding curves, and fractionalized real-world assets are experimental technologies subject to extreme price volatility. PALS is a permissionless interface interacting with smart contracts on a public blockchain. We do not provide financial advice. The value of any creator token can go to zero. Bonding curves contain inherent slippage and front-running risks. By interacting with these contracts, you acknowledge that you are fully responsible for your own funds, your own wallet security, and your own due diligence.