> For the complete documentation index, see [llms.txt](https://robinperps.gitbook.io/robinperps-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://robinperps.gitbook.io/robinperps-docs/robinperps_whitepaper.md).

# RobinPerps\_Whitepaper

## ROBINPERPS

Adaptive Liquidity, Portfolio Margin, and Risk Governance for On-Chain Perpetual Markets

**Whitepaper Draft v0.1**

July 15, 2026

{% hint style="info" %}
**Positioning:** RobinPerps is designed to integrate perpetual trading, active market making, curated strategy vaults, and on-chain risk governance into one composable derivatives infrastructure layer.
{% endhint %}

## Disclaimer

This document is a draft whitepaper for RobinPerps. It is intended to describe the protocol design, product architecture, risk framework, governance concept, and proposed token economics. It does not constitute financial, investment, legal, tax, accounting, or trading advice. It is not an offer to sell, nor a solicitation to buy, any security, derivative, token, or other asset. All parameters, contract addresses, launch timelines, fees, incentives, token allocations, and governance arrangements are draft concepts and may change after technical implementation, third-party audit, legal review, market testing, and governance approval.

## 1. Executive Summary

RobinPerps is a decentralized trading and liquidity protocol for on-chain perpetual futures markets. The protocol aims to provide high-capital-efficiency leveraged trading, explainable funding rates, transparent margin rules, programmable risk limits, and vault infrastructure for professional liquidity managers in a non-custodial environment.

Unlike many on-chain perpetual protocols that focus only on trade execution, RobinPerps places traders, liquidity providers, curators, liquidators, oracles, insurance reserves, and governance participants into one coherent risk ledger. Each market has explicit definitions for its base asset, quote asset, margin asset, price sources, maximum leverage, funding-rate bounds, position caps, and liquidation parameters.

| Theme           | RobinPerps Design                                                                                                                   |
| --------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| Market scope    | Perpetual futures, leveraged spot exposure, funding-rate strategies, strategy vaults, and later extensible structured-yield markets |
| Liquidity model | Robin Range Liquidity AMM combined with curated professional vaults for both active and passive capital deployment                  |
| Margin          | Isolated margin and portfolio margin, with market-specific initial margin, maintenance margin, and open-interest caps               |
| Price sources   | Multi-source oracle routing, time-weighted prices, deviation controls, and circuit breakers for index and mark prices               |
| Governance      | ROBIN governance, parameter timelocks, Guardian emergency authority, market-listing review, and public risk reports                 |
| Security        | Audits, bug bounties, on-chain monitoring, frontend and DNS protection, insurance reserves, and layered liquidation controls        |

## 2. Vision

RobinPerps aims to become an infrastructure layer for on-chain derivatives markets, enabling any asset that satisfies clear risk standards to support a transparent, tradable, hedgeable, and market-makable perpetual contract market. The protocol is not merely a trading interface. It is a full toolkit for market creation, liquidity management, risk governance, and revenue distribution.

In mature financial markets, participants can build strategies across spot, futures, borrowing rates, options, basis trades, and portfolio margin. On-chain markets are often fragmented across separate protocols, account systems, liquidity pools, and execution surfaces. RobinPerps compresses these capabilities into a unified account and risk framework: traders can express directional views, liquidity providers can choose between active and delegated market making, and governance can list new markets while the risk engine continuously constrains system leverage.

## 3. Problems to Solve

### 3.1 Fragmented Liquidity in On-Chain Perpetuals

Many on-chain perpetual markets depend on a single pool model or on a limited set of external market makers. When volatility rises, one-sided open interest builds up, or market-making capital withdraws, traders may experience wider spreads, failed orders, distorted funding rates, and unstable liquidation prices.

### 3.2 Complex Leverage Workflows

Users who want leveraged spot exposure, funding-rate arbitrage, or delta-neutral yield often need to interact with lending protocols, DEXs, perpetual venues, bridges, and monitoring tools. Each step introduces gas costs, execution risk, slippage, and operational burden.

### 3.3 Opaque Risk Parameters

If maximum leverage, maintenance margin, liquidation penalties, insurance-fund usage, auto-deleveraging rules, and oracle-failure handling are not publicly defined, users cannot evaluate their true risk. RobinPerps treats these parameters as part of each market definition and routes governance changes through transparent delays and announcements.

### 3.4 Passive LP Return and Tail Risk Mismatch

Passive liquidity providers often want exposure to trading fees and funding-rate revenue without managing inventory, directional risk, liquidation conditions, and utilization. Without professional strategy management, LPs may absorb unexpected losses during volatile periods.

## 4. RobinPerps Solution

RobinPerps addresses these problems through four core modules. First, an adaptive liquidity AMM expresses market-making capital across price ranges, funding-rate ranges, and risk capacity. Second, a unified margin account consolidates positions, collateral, unrealized PnL, fees, and risk limits into a single ledger. Third, curated vaults turn professional market-making strategies into accessible capital products. Fourth, governance and security modules make market parameters, upgrades, pauses, and risk disclosures transparent.

{% hint style="info" %}
**Core idea:** Traders should not need to understand every underlying maker order. LPs should not need to manage every market manually. Governance should not operate through opaque parameters. RobinPerps turns these needs into verifiable market definitions and auditable on-chain state.
{% endhint %}

## 5. Market Definition

Each RobinPerps perpetual market is defined by a clear set of parameters. Governance should only list a market when the underlying asset has sufficient price-source quality, liquidity, volatility data, trading demand, and liquidation feasibility.

| Parameter        | Description                                                                                                                                |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| Base Asset       | The traded exposure, such as ETH, BTC, SOL, liquid staking assets, or approved real-world asset exposure                                   |
| Quote Asset      | The asset used to quote contract prices and settle profit and loss, initially expected to be USDC or another approved stable asset         |
| Margin Asset     | The set of assets accepted as collateral, with asset-specific haircuts and maximum concentration limits                                    |
| Index Price      | The external fair price aggregated by the multi-source oracle router                                                                       |
| Mark Price       | The internal price used for unrealized PnL, margin checks, and liquidation decisions, bounded by index price, premium, and inventory rules |
| Funding Interval | The settlement cycle for funding payments, used to anchor perpetual prices near index prices                                               |
| Risk Tier        | A classification based on volatility, liquidity, oracle quality, and market depth                                                          |
| OI Cap           | The maximum open interest for each market and each side, used to prevent excessive concentration risk                                      |

## 6. Core Accounts and Receipts

RobinPerps uses an account-based design while preserving composable receipts where they improve risk isolation, strategy composition, or vault accounting. The protocol does not require every position to become a freely transferable asset. Receipts are created only when they serve a clear operational or composability purpose.

| Receipt | Type                                           | Purpose                                                                                                                         |
| ------- | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| rPOS    | Position receipt / NFT or account sub-position | Records market, direction, notional size, margin, entry price, cumulative funding value, and risk tier                          |
| rLP     | Vault share                                    | Represents a depositor's pro-rata ownership of a strategy vault, redeemable or transferable according to vault rules            |
| rUSD    | Internal accounting unit                       | Standardizes margin, PnL, fees, insurance accounting, and liquidation settlement without requiring a public stablecoin issuance |
| ROBIN   | Governance and utility token                   | Supports governance, staking, fee alignment, parameter participation, and ecosystem contribution rewards                        |

## 7. Trading Flow

{% stepper %}
{% step %}

### Select market and position details

The user selects a market, collateral asset, position direction, leverage level, and slippage limit.
{% endstep %}

{% step %}

### Simulate account risk

The interface or router simulates account equity, initial margin, maintenance margin, estimated funding, and liquidation price.
{% endstep %}

{% step %}

### Submit the transaction

The user submits the transaction, and the ClearingHouse reads the OracleRouter, RiskEngine, and LiquidityEngine state.
{% endstep %}

{% step %}

### Execute and update position state

The protocol executes against the best available liquidity and updates position state, margin, unrealized PnL, and inventory imbalance.
{% endstep %}

{% step %}

### Display readable metrics

The indexer converts on-chain state into readable position, fee, funding-rate, and risk metrics.
{% endstep %}
{% endstepper %}

When market conditions deteriorate, the system first attempts to reduce risk through funding-rate adjustments and position caps. If account equity falls below the required threshold, partial liquidation begins. If the insurance fund cannot cover insolvency after liquidation, auto-deleveraging may be activated as a last-resort mechanism.

## 8. Robin Range Liquidity AMM

The Robin Range Liquidity AMM allows market-making capital to be deployed across defined price ranges, volatility ranges, and inventory ranges. Instead of relying on a static price curve, RobinPerps market-making parameters account for index-price deviation, market inventory, funding rates, open interest, and risk budget.

Market-making strategies can be configured directly by professional liquidity providers or managed through curated vaults. Each quotation range includes capacity, minimum spread, maximum slippage, funding sensitivity, and cancellation delay. Governance may restrict aggressive curves in higher-risk markets to prevent unsafe leverage supply.

### 8.1 Mark Price

The mark price is used for margin and liquidation and should not be manipulable through a short-lived trade price alone. A representative form is: Mark Price = Index Price x (1 + bounded premium + inventory adjustment). The premium reflects time-weighted deviation between perpetual trade prices and the index price, while the inventory adjustment reflects long-short imbalance and maker inventory.

### 8.2 Funding Rate

The funding rate constrains perpetual prices in the absence of an expiry date. RobinPerps funding is designed around three components: price deviation, inventory skew, and utilization. The price-deviation term encourages convergence to the index price, the inventory-skew term incentivizes the weaker side of the market, and the utilization term raises holding costs when liquidity is scarce.

## 9. Margin and Liquidation

The RobinPerps risk engine calculates account equity, collateral haircuts, unrealized PnL, funding payments, pending fees, and risk buffers in one framework. Isolated margin confines risk to a specific position, while portfolio margin allows offsetting exposure within the same account only when asset correlation, liquidity, and oracle quality satisfy governance-approved criteria.

| Metric              | Definition                                                                                      |
| ------------------- | ----------------------------------------------------------------------------------------------- |
| Account Equity      | Discounted collateral value plus unrealized PnL minus fees payable and pending funding payments |
| Initial Margin      | The minimum margin required to open a position, increasing with risk tier and position size     |
| Maintenance Margin  | The minimum equity required to keep a position open before liquidation checks begin             |
| Liquidation Buffer  | Additional reserve used to cover slippage, latency, and keeper execution costs                  |
| Partial Liquidation | A process that closes only enough exposure to restore account health where possible             |
| Insurance Fund      | Protocol reserve used to absorb liquidation shortfalls and extreme market losses                |

Liquidation should be predictable. The protocol first checks account health, then executes partial liquidation, applies liquidation fees, and updates insurance-fund accounting. If an account becomes insolvent, the insurance fund covers the deficit. Auto-deleveraging is reserved for cases where the insurance fund is insufficient.

## 10. User Roles

| Role                   | Actions                                                               | Revenue Source                                              | Primary Risks                                                              |
| ---------------------- | --------------------------------------------------------------------- | ----------------------------------------------------------- | -------------------------------------------------------------------------- |
| Trader                 | Open long or short positions, adjust leverage, and manage margin      | Directional returns, hedging gains, and funding-rate income | Volatility, liquidation, funding costs, and slippage                       |
| Active Market Maker    | Set price ranges, spreads, inventory capacity, and cancellation rules | Trading fees, funding payments, and maker incentives        | Inventory risk, curve misconfiguration, and extreme market moves           |
| Curator                | Manage vault strategies, allocate markets, and adjust risk budgets    | Performance fees, management fees, and reputation           | Strategy underperformance, timelock constraints, and depositor withdrawals |
| Depositor              | Provide capital to vaults and hold rLP shares                         | Vault NAV growth, fee share, and incentives                 | Negative returns, withdrawal queues, and strategy dependency               |
| Liquidator             | Monitor unhealthy accounts and execute liquidations                   | Liquidation rewards                                         | Failed transactions, gas costs, and price movement                         |
| Governance Participant | Vote on parameters, market listings, and fee allocation               | Governance influence and staking rewards                    | Bad decisions, governance attacks, and regulatory uncertainty              |

## 11. Curated Vaults

Curated vaults allow ordinary liquidity providers to delegate capital to professional managers that have been whitelisted by governance and are subject to performance tracking. Curators can allocate capital across markets, price ranges, and inventory directions while retaining reserves for insurance, withdrawals, and rebalancing during high-volatility periods.

Vault strategies must operate under risk constraints such as single-market capacity, maximum leverage supply, allowed asset lists, utilization caps, cancellation delays, emergency liquidation procedures, and performance-fee limits. Material parameter changes should pass through a timelock so depositors have time to evaluate the change and exit before it takes effect.

## 12. Strategy Examples

### 12.1 Directional Trading

Traders can use isolated margin to establish long or short exposure to BTC, ETH, or other approved assets. Before execution, the RobinPerps interface should display estimated liquidation price, funding-rate sensitivity, slippage, position health, and worst-case fee impact.

### 12.2 Funding-Rate Arbitrage

When on-chain perpetual funding is materially higher than comparable centralized or decentralized venues, professional traders may build hedged positions by receiving the rich funding side on RobinPerps while holding opposite exposure elsewhere. This strategy depends on liquidity, funding persistence, and cross-market execution quality.

### 12.3 Market-Making Vault Yield

Depositors can participate in market-making strategies through rLP shares without configuring price ranges or managing inventory directly. Vault returns may come from trading fees, funding payments, inventory rebalancing, and incentives, but vault NAV can decline due to extreme market conditions, strategy errors, or liquidation shortfalls.

### 12.4 Portfolio-Margin Hedging

Within governance-approved correlated asset groups, users may use portfolio margin to reduce redundant collateral. For example, an ETH long and liquid staking token short may receive partial margin offset only when correlation, liquidity, and oracle quality satisfy risk criteria.

## 13. Fee Model

| Fee                   | Charged To                                                | Purpose                                                                       |
| --------------------- | --------------------------------------------------------- | ----------------------------------------------------------------------------- |
| Trading Fee           | Open, close, increase, and decrease-position transactions | Distributed to maker capital, protocol treasury, and insurance reserves       |
| Funding Payment       | Longs and shorts according to market imbalance            | Balances perpetual price, inventory, and risk utilization                     |
| Liquidation Fee       | Liquidated accounts                                       | Compensates liquidators, covers slippage, and replenishes the insurance fund  |
| Vault Performance Fee | Profitable strategy vaults                                | Incentivizes curators to optimize utilization and risk-adjusted returns       |
| Protocol Fee          | A portion of trading, liquidation, or vault revenue       | Funds development, audits, bug bounties, governance, and ecosystem incentives |

## 14. ROBIN Token Economics Draft

ROBIN is the proposed governance and utility token for RobinPerps. The following parameters are draft recommendations, not final issuance commitments. Official parameters should be published only after legal, compliance, market, and governance review.

| Parameter            | Proposed Value                                                                                                               |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| Token Name           | RobinPerps                                                                                                                   |
| Ticker               | ROBIN                                                                                                                        |
| Type                 | Utility and Governance Token                                                                                                 |
| Total Supply         | 1,000,000,000 ROBIN, fixed cap, no assumed inflation                                                                         |
| Initial Circulation  | Approximately 18%, subject to final TGE announcement                                                                         |
| Primary Utility      | Governance, staking, fee alignment, trading and LP incentives, insurance-fund incentives, and ecosystem contribution rewards |
| Cross-chain Standard | May use OFT or another governance-approved cross-chain standard after security review                                        |

| Category              | Share | Suggested Release                                                                               |
| --------------------- | ----- | ----------------------------------------------------------------------------------------------- |
| Community Rewards     | 18%   | Released through trader, LP, liquidator, developer, and community-contribution programs         |
| Ecosystem Incentives  | 27%   | 3-month cliff and 48-month linear release for market bootstrapping and ecosystem partnerships   |
| Liquidity Bootstrap   | 12%   | Released by market depth, maker quality, and risk-performance milestones                        |
| Foundation / Treasury | 15%   | 6-month cliff and 36-month linear release for audits, operations, insurance, and long-term R\&D |
| Team                  | 16%   | 12-month cliff and 36-month linear release aligned with long-term protocol development          |
| Investors             | 10%   | 12-month cliff and 24-30-month linear release                                                   |
| Advisors              | 2%    | 6-month cliff and 24-month linear release                                                       |

ROBIN governance should open progressively. Early governance may be limited to parameter signaling, incentive allocation, and market prioritization. After the protocol demonstrates stable operation, audits, and risk validation, governance can gradually expand to fee switches, cross-chain deployments, insurance-fund policy, and curator whitelisting.

## 15. Governance and Permissions

RobinPerps uses a layered permission model. Ordinary parameters are managed by governance and timelock. Emergency pauses are handled by Guardian authority within a narrow scope. Contract upgrades and market listings require longer delays, multi-signature confirmation, and public risk explanations.

| Authority         | Responsibilities                                                                           | Constraints                                                                |
| ----------------- | ------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------- |
| Governance        | Market listings, fee allocation, core parameters, and long-term roadmap                    | Voting, proposal periods, execution delays, and public records             |
| Guardian          | Emergency pauses, cancellation of dangerous parameter changes, and user-protection actions | Limited to security events or obvious anomalies, with post-event reporting |
| Risk Committee    | Risk tiers, oracle quality, position caps, and margin-parameter recommendations            | Changes enter timelock and remain subject to governance oversight          |
| Curator Whitelist | Approval or removal of strategy-vault managers                                             | Based on performance, risk control, transparency, and safety review        |

## 16. System Architecture

RobinPerps consists of a frontend, indexing service, risk service, and smart contracts. The frontend provides execution and risk visibility. The indexer reads on-chain state and exposes query APIs. The risk service generates parameter recommendations and monitoring alerts. Smart contracts handle the margin ledger, execution, funding, liquidation, vaults, and governance execution.

| Module             | Function                                                                                                       |
| ------------------ | -------------------------------------------------------------------------------------------------------------- |
| ClearingHouse      | Handles opening, closing, increasing, and decreasing positions, funding settlement, and account-equity updates |
| RiskEngine         | Calculates margin, position caps, account health, liquidation triggers, and risk tiers                         |
| OracleRouter       | Aggregates multiple price sources, performs deviation checks, and provides index prices and oracle status      |
| LiquidityEngine    | Manages range liquidity, quote capacity, inventory imbalance, and AMM pricing curves                           |
| VaultFactory       | Creates strategy vaults, tracks rLP shares, and handles deposits, withdrawals, and performance fees            |
| InsuranceFund      | Receives protocol revenue share and absorbs liquidation deficits                                               |
| GovernanceTimelock | Delays parameter and upgrade execution to give users an exit and review window                                 |

## 17. Security Design

The security of a perpetual protocol is not only a smart-contract audit problem. It also includes price sources, frontend integrity, DNS, monitoring, liquidation execution, governance permissions, and market parameters. RobinPerps should complete multiple independent audits before mainnet launch and operate continuous on-chain monitoring and bug-bounty programs after launch.

* **Smart contracts:** unit tests, fuzz tests, formalized key invariants, third-party audits, and public remediation records.
* **Oracles:** multi-source medians, TWAPs, deviation thresholds, heartbeat checks, asset-level circuit breakers, and manual fallback paths.
* **Frontend and DNS:** content-integrity checks, domain locking, monitoring alerts, backup access paths, and clear signing prompts.
* **Governance:** timelocks, minimal permissions, multi-signature execution, bounded Guardian authority, and proposal transparency.
* **Operational monitoring:** alerts for abnormal open interest, funding rates, liquidation failures, insurance-fund changes, oracle deviations, and large parameter changes.

## 18. Risk Disclosure

RobinPerps cannot remove the inherent risks of DeFi and derivatives trading. Users should understand that leverage amplifies losses, perpetual contracts have no expiry date, funding rates may remain unfavorable, oracle data may be delayed or wrong, and liquidity may disappear during extreme markets.

| Risk                | Description                                                                       | Mitigation                                                                          |
| ------------------- | --------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| Liquidation Risk    | Adverse market moves can reduce account equity below maintenance margin           | Risk prompts, isolated margin, partial liquidation, and health monitoring           |
| Liquidity Risk      | Insufficient depth can cause slippage, failed execution, or difficult liquidation | OI caps, maker incentives, vault capacity limits, and circuit breakers              |
| Funding-Rate Risk   | One-sided markets may make funding persistently negative for a position           | Funding caps, pre-trade estimates, and position alerts                              |
| Oracle Risk         | Bad price data can cause incorrect liquidations or PnL calculations               | Multi-source aggregation, deviation checks, circuit breakers, and governance review |
| Smart-Contract Risk | Code defects or attacks can cause loss of funds                                   | Audits, testing, bug bounties, and minimized permissions                            |
| Governance Risk     | Malicious or mistaken proposals can affect market safety                          | Timelocks, Guardian controls, parameter bounds, and public oversight                |
| Curator Risk        | Vault strategies may lose money or perform poorly                                 | Whitelisting, performance disclosure, capacity caps, and redemption mechanisms      |

## 19. Roadmap

| Phase                     | Objective                                                                                                                                        |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| Phase 1: Testnet          | Release simulated trading, core perpetual markets, risk dashboard, developer documentation, and testnet incentives                               |
| Phase 2: Mainnet Beta     | Launch highly liquid markets such as ETH and BTC with isolated margin, insurance reserves, basic liquidation network, and public risk parameters |
| Phase 3: Vaults           | Introduce curated vaults, rLP shares, active market-making strategies, and transparent depositor reporting                                       |
| Phase 4: Portfolio Margin | Enable portfolio margin, correlated-asset hedging, cross-market risk controls, and professional trader APIs                                      |
| Phase 5: ROBIN Governance | Gradually open token governance for market listings, fee allocation, incentives, and cross-chain deployments                                     |

## 20. Conclusion

The core thesis of RobinPerps is that on-chain perpetual markets need more than higher leverage. They need a transparent risk ledger, controllable liquidity, professional capital management, and robust governance. By combining trading, market making, vaults, oracles, liquidation, and governance into one protocol, RobinPerps can offer traders a clearer execution experience while giving LPs and curators a measurable, auditable, and governable infrastructure for risk-adjusted yield.

##


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://robinperps.gitbook.io/robinperps-docs/robinperps_whitepaper.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.