# Home


# Introduction

## **Overview**&#x20;

[Hyperion](https://hyperion.xyz/) is a high-performance platform powered by Aptos’ parallel execution engine. By combining swap aggregation, market-making (CLMM and the upcoming DLMM), and vault strategies into one seamless on-chain experience, Hyperion is building the unified liquidity and trading layer of Aptos.

## Incubation and Support&#x20;

Hyperion is incubated by BlockBooster and is part of Ankaa Accelerator Program.

In May 2025, Hyperion announced its strategic round fundraising led by OKX Ventures, with participation from Aptos Labs, Mirana Ventures and Maelstrom.

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# Contact

Official Website: <https://hyperion.xyz/>

Email: <info@hyperion.xyz>

Twitter: <https://x.com/hyperion_xyz>

Discord: <https://t.co/X2dJYfNd4N>

Telegram Group Chat: <https://t.me/Hyperion_community>&#x20;

Telegram Announcement: <https://t.me/HyperionAptos>

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# Glossary

**AMM:** AMM is the short of automated market maker. It is a blockchain-based smart contract that holds liquidity reserves. Users can either trade against liquidity reserves at prices determined by a specific formula, or provide their liquidity to the liquidity reserves to earn fees generated by ongoing swaps. Usually, AMM particularly refers to the constant product market maker which complies with the classic x\*y=k formula.

**Concentrated Liquidity:** Liquidity that is allocated within a specified price range.

**Concentrated Liquidity Protocol:** A dex or a DeFi protocol that is built with the concentrated liquidity infrastructure.

**Pool:** A smart contract deployed by the factory contract that pairs two types of tokens. A same token pair may have different fee tiers which lead to multiple pools.

**Swap:** Trading one asset to proportional amount of another asset on a dex.

**Swapper:** Users who place and execute swap orders on a dex.

**Liquidity:** Tokens that are stored in a pool contract and are able to be traded against by traders.

**Liquidity Provider:** Also called “LP”. Liquidity providers are those who deposit required tokens into a liquidity pool. Liquidity providers are rewarded with transaction fees as new swaps occur continuously while bearing the volatility risk and other risks of holding the liquidity assets.

**Reserves:** Or say liquidity reserves. The liquidity available in a particular trading pool.

**Position:** In a concentrated liquidity protocol, the liquidity that is added by a user within a custom price range can be called a position or a liquidity position.

**Tick:** The price in a concentrated liquidity protocol is discrete. The price curve of concentrated liquidity is partitioned by a number of ticks. The price ticks also set the borders of a liquidity position.

**Tick Spacing:** Each pool is divided evenly into numerous fractions of liquidity with predefined boundaries called "ticks". A tick spacing of 8 means that each tick is 0.08% larger than the previous tick, and 128 means that each tick is 1.28% larger than the previous tick. Stable pools will use smaller tick spacing to allow for more granular price ranges.

**Range:** Any interval between any two price ticks in a concentrated liquidity protocol.

**Range Order:** Similar to a limit order on an order book market. Single-sided assets are provided as liquidity and are continuously swapped to the desired asset as the spot price crosses the full price range of the position.

**Price Impact:** The difference between the current price and the execution price of a transaction.

**Slippage:** Slippage or price slippage means the possible price change that may occur when a submitted swap transaction is pending.

**Slippage Tolerance:** Slippage tolerance is the largest price change a user would like to accept during the execution of corresponding swap order.

**APR:** The estimated returns on your position based on 24-hour trading activity and token emissions projected over a year. APR does not consider any possible impermanent loss. Past activity is not a guarantee of future returns.

**Impermanent Loss:** Impermanent loss is a temporary loss of funds occurring when providing liquidity. It's a difference between holding an asset versus providing liquidity in that asset due to the unpredictable asset volatility. In a concentrated liquidity protocol, both the yield from trading fees and rewards and possible impermanent loss are amplified.

**Swap Fees:** The fees collected upon swapping, which eventually go to liquidity providers and the protocol.

**Protocol Fees:** A small proportion of swap fees will be reserved by the protocol as protocol fees.

**Liquidity Mining:** Liquidity mining is a process in which crypto holders provide assets to a decentralized exchange as its liquidity in return for token rewards. These rewards commonly stem from trading fees that are accrued from traders swapping tokens.

**Fee-based Liquidity Mining:** This is the underlying model adopted by Hyperion for its liquidity mining. Traditional liquidity mining usually evaluate its reward distribution according to the liquidity amount of a user. In a concentrated liquidity protocol, a higher liquidity amount doesn't necessarily mean better liquidity effectiveness. Therefore, Hyperion distributes its mining rewards based on the actual transaction fee generated by each liquidity position. A greater fee performance deserves higher rewards.

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# Roadmap

<figure><img src="/files/TBSk6VMHSCDvznbjNYjq" alt=""><figcaption></figcaption></figure>

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# Tokens of the Hyperion Platform

The Hyperion platform operates with the Hyperion Token (“RION”) and its derivative token, the Hyperion Escrowed Token (“xRION”) as further explained below.&#x20;

<br>


# RION Token

**Basic Information**

* **Name**: Hyperion Token
* **Ticker**: RION
* **Chain**: Aptos
* **Total Supply (Max)**: 100,000,000 RION
* **Token Contract Address**: 0x435ad41e7b383cef98899c4e5a22c8dc88ab67b22f95e5663d6c6649298c3a9d (Aptos)

### Overview

RION is the native, cryptographically-secure, and fungible token of the Hyperion platform. As a transferable token, RION serves utility functions as specified on the Hyperion platform.&#x20;

RION serves as a versatile utility token, facilitating decentralized exchange and settlement among participants within the Hyperion platform. The primary objective of RION is to provide a secure and efficient means of transaction between platform participants, eliminating the need for intermediaries such as centralized entities or institutions. RION is **not**, and is **not intended to be**, a medium of exchange accepted by the general public (or any section of the public) as payment for goods, services, or the discharge of debt, nor is it intended to be used for any purposes other than those exclusively provided by the issuer.

RION is awarded as an economic incentive to encourage user contributions and participation on the platform, establishing a mutually beneficial structure where participants are fairly rewarded based on their efforts. The distribution of additional RION is strictly dependent on actual usage, activity, and contributions to the platform—such as frequency and volume of transactions. Users who do not actively participate or contribute will not receive RION incentives.

<figure><img src="/files/FlnafHzFAW4K0tgly6Wv" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/jPTa2rrnB9yrIxhnXcEZ" alt=""><figcaption></figcaption></figure>

### Disclaimer

RION does not represent any shareholding, ownership, participation, right, title, or interest in Hyperion, their affiliates, or any other company, enterprise, or undertaking. RION does not entitle token holders to any promise of fees, dividends, revenue, profits, or investment returns, and is not intended to constitute securities in any jurisdiction, including the United States, British Virgin Islands, Hong Kong, Panama, or Singapore. RION may only be utilized within the Hyperion platform, and ownership confers no rights, express or implied, other than the right to use RION to interact with and utilize the Hyperion platform. The secondary market price of RION is not dependent on the efforts of the Hyperion Project contributors, and there are no mechanisms or schemes in place to control or manipulate secondary market pricing. RION holders are not entitled to vote on the operation or management of Hyperion, their affiliates or their assets, nor does RION constitute any equity interest or collective investment scheme. The arrangement is not intended to be any form of joint venture or partnership.

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# xRION Token

**Basic Information**

* **Name**: Hyperion Escrowed Token
* **Ticker**: xRION
* **Chain**: Aptos
* **Collection Address**: TBD

### Overview

xRION is the escrowed, non-transferable governance token of the Hyperion platform. xRION can be obtained by converting RION. xRION enables holders to participate in governance within the Hyperion DAO framework (when the DAO is established), as well as to access certain platform features, such as launchpool participation. Further details on conversion mechanisms are provided below.

### Locking RION → Receiving xRION

* Users **lock RION tokens** for a duration between **1 and 52 weeks**.
* For each locked RION, the user receives: **xRION = Locked Amount × Lock Duration (in weeks)**
  * Example: locking 100 RION for 10 weeks yields **1,000 xRION**.

### Epoch Structure

* Time is divided into **weekly Epochs**.
* Each Epoch runs from **Monday 08:00 UTC → next Monday 08:00 UTC**.
* When a user locks RION, their xRION becomes **active from the nearest upcoming Monday Epoch**. The user’s xRION balance is created and visible. The xRION is counted in the reward pool and begins participating in the weekly distribution.

### Reward Distribution

* Once active, xRION allows the user to participate in **weekly reward distributions**.
* Rewards are claimable **at the end of each Epoch**.
* The **first claim** happens when the initial Epoch (after locking) ends.

### Decay of xRION

* xRION has a **linear weekly decay**:
  * Each week, **xRION decreases by 1 per locked RION**.
  * This continues until the lock period ends.
* After the final week, the user’s RION unlocks and can be withdrawn.

### Extending the Lock

* Users can **extend the lock duration at any time before expiry**.
* By extending, the xRION decay schedule is **recalculated** from the new end date, ensuring continued participation in rewards.

### Example Walkthrough

* Alice locks **100 RION** for **4 weeks**.
* At lock time, her allocation is: **xRION = 100 × 4 = 400 xRION**.
* Since the lock is made on **Wednesday**, her xRION becomes active starting the next **Monday 08:00 UTC**.

**Epoch Rewards & Decay:**

* **Week 0:** Alice has locked 100 RION but "my APR" and "xRION" amount will still be 0 on UI
* **Week 1:** Alice will see "400 xRION" and "my APR" and participate fully in reward distribution.
* **Week 2:** Her balance decays to 300 xRION.
* **Week 3:** Balance is 200 xRION.
* **Week 4:** Balance is 100 xRION. At the end of this Epoch, her lock period ends, and she can withdraw 100 RION.

If Alice chooses to extend her lock by another 8 weeks during Week 2, her xRION will be recalculated based on the new lock period, giving her higher weight in upcoming reward distributions.

### Utilities

* **Staking**:\
  By staking RION, users automatically participate and hold xRION and become eligible for xRION staking rewards. These rewards are supported by the treasury of the Hyperion platform and made available on a discretionary basis – further details on the reward program and updates thereto will be published from time to time via official channels. They are a way to give back to the community, sharing the benefits of the growth of the platform.<br>
* **Governance**:\
  Following the formal establishment of the Hyperion DAO, xRION will enable holders to participate in platform proposals and voting within the DAO. Voting rights will be based on the amount of xRION held, in accordance with the governance framework defined by the DAO (when the DAO is established).<br>
* **Launchpad Participation**:\
  xRION balances may be used as a whitelist requirement or for calculating allocation quotas for launchpool participation on the Hyperion launchpad.

Further utilities for xRION may be introduced as the Hyperion platform evolves.

### Disclaimer

xRION does not represent any shareholding, ownership, participation, right, title, or interest in Hyperion,their affiliates, or any other company, enterprise, or undertaking. xRION does not entitle token holders to any promise of fees, dividends, revenue, profits, or investment returns, and is not intended to constitute securities in any jurisdiction, including the United States, British Virgin Islands, Hong Kong, Panama, or Singapore. xRION may only be utilized within the Hyperion platform, and ownership confers no rights, express or implied, other than the right to use xRION to interact with and utilize the Hyperion platform. The secondary market price of xRION is not dependent on the efforts of the Hyperion Project contributors, and there are no mechanisms or schemes in place to control or manipulate secondary market pricing. xRION holders are not entitled to vote on the operation or management of Hyperion, their affiliates or their assets, nor does xRION constitute any equity interest or collective investment scheme. The arrangement is not intended to be any form of joint venture or partnership. All governance features described herein are subject to the formal establishment of the Hyperion DAO.

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# Concentrated Liquidity

## **Introduction** <a href="#introduction" id="introduction"></a>

The core innovation of Hyperion is allowing concentrated liquidity, whereby users may add their liquidity within custom price ranges. In AMM protocols, which are adopted by most of common decentralized exchanges nowadays, liquidity is distributed uniformly along the entire price curve (0, ∞).

The previous AMM liquidity distribution makes trading available across the full price interval between 0 and infinite upon simple deployment. However, in AMM pools, a significant portion of the liquidity was never utilized by actual transactions, which is a waste of provided liquidity to some extent.

For example, the trading price is usually constant in a stablecoin pair. The liquidity outside its regular price range is rarely touched. In most of mainstream stablecoin trading pools (AMM-based), only less than 1% of their total liquidity are actually being used. The rest of the available liquidity stays idle in the pools all the time.

It’s reasonable for an LP to expect that their liquidity provided can be utilized as much as possible so that they can earn more fees from it. This can be realized with the help of concentrated liquidity. Liquidity providers are able to concentrate their liquidity to their specified price ranges according to the most active price intervals of a particular trading pair. For instance, an LP can choose to add all of their liquidity into the price range (0.995, 1.005) of a stablecoin trading pool. As transactions are happening most actively around the mid-price, these LPs can maximize their liquidity efficiency in this way and earn greater fees from participation.

The liquidity concentration changes the price interval of a user’s liquidity from infinite to finite. For the liquidity that is concentrated to a finite price interval, we can it a position, or a liquidity position. An LP can create multiple positions in a same pool. By setting different price ranges, LPs can simulate different price curves to achieve their custom strategies.

## **Active Liquidity** <a href="#active-liquidity" id="active-liquidity"></a>

Given that a user may set a finite price range for a position, when the asset price goes up and down in a fluctuating market period, the price may exit the price range that is set for the position. In that case, the liquidity in that particular position will not be active and will stop earning fees until the price re-enters the position price range.

If the price of a trading pair increases or decreases in one direction, liquidity providers will gain more of the one token in their positions because it shows more demand for the other token from the swappers. When the price reaches the upper or lower bound of their positions, their entire liquidity will consist of only one asset.

When the price re-enters the range, the liquidity within the position will be active and start earning fees again. The liquidity composition for an active position will be two tokens instead of only one asset type.

LPs have a very high flexibility in concentrated liquidity. They can open as many liquidity positions with their custom price bands as they want and need. The underlying algorithm of concentrated liquidity sets out the mechanism that gives the decision right of the liquidity distribution to the actual market, because most liquidity providers will naturally concentrate their liquidity within the most active price ranges according to the market trends in order to earn more transaction fees.

## **Price Ticks** <a href="#price-ticks" id="price-ticks"></a>

In an AMM model, the price is continuous, while it is sort of different in a concentrated liquidity protocol. The prices in concentrated liquidity positions are discrete. The price curve of concentrated liquidity is partitioned by a number of ticks. A discrete space can be found between each tick and the tick next to it. When we move up and down by one tick, it will show a 0.01% increase or decrease (1 basis point) in price at any point in price space.

We use ticks as borders for every liquidity position. When a liquidity position is opened, it comes with an upper and a lower price tick that are set by liquidity providers.

As the price keeps changing as new swaps are executed, the smart contract tends to consume all the liquidity available in the current tick interval until the next price tick is reached, continually exchanging the outbound asset for the inbound. When a new price tick is reached, the pool contract will immediately switch to the new tick and any dormant liquidity within the newly active tick intervals will be activated.

Although each trading pool has the same number of price ticks in a concentrated liquidity protocol, there are only a part of them serving as active ticks in actual scenarios. There is certain correlation between tick spacing and swap fee tier in a concentrated liquidity smart contract. The lower the fee tier is set, the closer the two nearby active ticks can be. In other words, a higher fee tier can give the pool a wider tick space of potential active price ticks.

For trading pairs that require higher price granularity, like stablecoin pairs, a relatively narrower tick space will be helpful. The price impact during swapping will be more moderate, with the tighter tick spacing, which is exactly what is needed by a stablecoin pool.

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# Fees

## **Swap Fees** <a href="#swap-fees" id="swap-fees"></a>

In our concentrated liquidity protocol, swap fees will be distributed proportionally to all in-range liquidity at the time of the swap transaction. Only the liquidity positions with price ranges that the current spot price lies in have provided liquidity, and therefore become entitled to earn fees. If the price exits a position’s range, the position will be switched to inactive status and no fees can be earned.

Unlike the common AMM contract which will automatically accrue new swap fees into the liquidity pool, in a concentrated liquidity protocol, swap fees are accumulated separately and liquidity providers can claim their fee earnings without withdrawing their liquidity.

It is important to reiterate that the Hyperion protocol simply comprises a set of autonomous smart contracts deployed on Aptos, operated directly by users calling functions on it (which allows them to interact with other users and/or pool their own selected assets in a multi-party peer-to-peer manner). There is no further control by or interaction with the original entity which had deployed the smart contract, which entity solely functions as a provider of technical tools for users, and is not offering any sort of securities product or regulated service nor does it hold any user assets in custody.

## **Fee Tiers** <a href="#fee-tiers" id="fee-tiers"></a>

In our concentrated liquidity protocol, we can set up multiple pools for the same token pair with different fee tiers. Initially, there will be 4 tiers that are allowed by the protocol: 0.01%, 0.05%, 0.25%, 1%.

The setting of multiple fee tiers can better satisfy the needs of different kinds of trading pairs. It also encourages the market to naturally find the most ideal liquidity distribution plan by itself. This gives much more flexibility to both liquidity providers and swappers.

It is reasonable to anticipate that different types of token pairs tend to progress towards particular fee levels according to their asset characteristics and the game between supply and demand from liquidity providers and traders. Assets with low volatility like stablecoins will be more likely to congregate in a pool with the lowest fee tier because it is less risky for LPs to hold these assets and most traders expect their transactions to be executed as close to 1:1 as possible. On the other hand, assets that are rarely traded may gravitate towards a higher fee as liquidity providers are bearing higher risks of holding such high-volatility assets.

## **Protocol Fees** <a href="#protocol-fees" id="protocol-fees"></a>

To maintain a healthy economic model that is beneficial to the project's sustainable project treasury for its long term development, a certain percentage (20% by default) will be taken from swap fees of every transaction on Hyperion as the protocol fee.

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# Swap

Swaps are one of the most common interactions with a DEX. The mechanism of token swap is easy to understand, which is to sell the tokens that are currently owned by the swapper for the proportional amount of the destination tokens. In this process, a small percentage of swap fee will be deducted, which is the incentives to those liquidity providers.

The execution of swaps in the Hyperion protocol supports both AMM and Orderbook models. In the AMM model, swaps are executed against a passive liquidity pool, with liquidity providers earning transaction fees proportional to the active liquidity they contribute. Meanwhile, the Orderbook model follows a first-in-first-out policy, where order timing plays a crucial role in execution priority. This dual approach offers users flexibility, allowing them to choose between automated liquidity provision and direct market orders based on their trading strategy.

## **Price Impact** <a href="#price-impact" id="price-impact"></a>

In an order book market or a CEX, the price impact of an order depends on the size and array of the opening limit buy or sell orders. The final execution price of an order is usually the weighted average price of multiple limit orders.

The price impact in an AMM or in a concentrated liquidity protocol is sort of different. During the swap, the relative value of one token to the other changes dynamically and continuously so the final execution price of a swap lies somewhere between the start price and end price. The price impact for a swap order will be affected by the real-time available liquidity in corresponding price space. The price impact will be much smaller for a given swap size if the liquidity depth at the particular price is higher.

## **Slippage** <a href="#slippage" id="slippage"></a>

A swap user should have seen the term ‘slippage’ or ‘price slippage’ on a DEX before. That is the term that we use to describe the possible price change that may occur during a transaction is pending.

To respond to the possible price change, we adopt the concept of slippage tolerance. Slippage tolerance can be set by a user, which is to determine the largest price impact that the user is willing to accept. If the final execution price is outside of the acceptable slippage range, the transaction will get failed to protect the user’s interests.

A trade that uses assets and tokens that are purchased before paying for them.

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# Liquidity Mining

## Fee-based Liquidity Mining <a href="#fee-based-liquidity-mining" id="fee-based-liquidity-mining"></a>

In a concentrated liquidity protocol, only the liquidity in those positions with active price ranges could be used by transactions, thereby being able to generate transaction fees. The transaction fee performance of a liquidity position reflects its effectiveness and contribution to the protocol. Therefore, one of the most special characteristics of the liquidity mining of Hyperion is that it will distribute its mining rewards to users according to their actual fee performance, instead of based on their liquidity amounts. This requires more active participation if a liquidity provider wants to earn more fees and mining rewards.

As the mining rewards are linearly released, every time there is a new transaction to be executed, the contract will be called to calculate the proportion of fees generated by every single position to the total generated fees of the pool since the last call. The released rewards will be distributed accordingly proportional to each position's generated fees.

This fee-based mining mechanism ensures that the mining rewards will not be diluted by those inactive LPs or users who deliberately allocate liquidity in an invalid price range just for sharing mining incentives. It greatly saves the cost for both the protocol and third party project owners on incentivizing liquidity, which makes the TVL of Hyperion more efficient than other DEXes.

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# Range Order

Powered by the concentrated liquidity algorithm, users can conveniently achieve a lot of advanced trading strategies that are infeasible in AMM DEXes.

By creating a liquidity position with a price range to be set to one side of the spot price, LPs can provide their liquidity with single-sided asset. This allows liquidity providers to simulate limit orders that are very common in those orderbook markets or CEX. The difference is that a limit order is created with a particular predetermined buy or sell price and the order may be filled at some point in the future, while a single-sided liquidity position order in concentrated liquidity protocol comes with a price range. When the spot price enters the preset range of the position, continuous token swap will be activated in the position. If the price has fully crossed the price range of the position, all original assets will be exchanged for the target assets which can be withdrawn by the LP to close the order. We call this type of order mode as range orders.

The roles who place range orders are liquidity providers instead of swappers, so they are regarded as makers who will earn fees when a range order is executed. By creating rational liquidity positions, LPs can easily buy at dips and sell at rallies like professional traders and earn transaction fees at the same time.

## **Order Types Supported by Range Order** <a href="#order-types-supported-by-range-order" id="order-types-supported-by-range-order"></a>

Although the range order trading is quite similar to limit orders in orderbook market, there are still certain differences due to the underlying mechanism of concentrated liquidity protocol. What can be supported by concentrated liquidity range order includes take-profit orders and buy-limit orders.

### **Take-Profit Orders**

For example, the current price of a BTC-USDC pool is 20,000 USDC/BTC and you want to sell your BTC for USDC when BTC price reaches 21,000 USDC/BTC. This is feasible by placing range orders because the price space above the current price is fully denominated in the higher-valued token in a concentrated liquidity pool. You can open a position with a narrow price range like 21,000-21,001 USDC/BTC and add your BTC into the pool. Your order will be filled if the price keeps increasing and crosses your liquidity position.

### **Buy-Limit Orders**

For example, the current price of the BTC-USDC pool is 20,000 USDC/BTC. You predict that the BTC price will rebound if it drops to 19,000, so you plan to buy some BTC with USDC at the price of 19,000. It can be achieved by range orders because the space below the current price is denominated in the lower-valued asset, USDC. You can simply create a position with a price range like 19,000-19,001 USDC/BTC. Your BTC will all be swapped into USDC when the spot price drops and crosses your position price range.

## **Position Management** <a href="#position-management" id="position-management"></a>

One thing to note is that to ensure your range order is completely filled, you need to withdraw your position assets in time after your position range is crossed in case that the spot price re-enters the price range. This can be handled manually or be managed with the help of a third-party position manager protocol that has integrated Hyperion’s smart contract.

Besides, it is up to liquidity providers on how to set the price range of a range order position. Setting a wider price interval may help you earn more transaction fees if price fluctuation is intense within your position range, while you need to bear a higher risk that your order cannot be completely filled if the price reserves before it crosses your full range.

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# Genesis Season

## Introduction

The Drips System rewards users for actively participating in the ecosystem through liquidity provision, trading, and community growth via referrals.

Drips are calculated and accumulated daily based on user actions and can be used to unlock exclusive benefits and incentives within the platform.

## Point Categories & Earning Mechanisms

### **1. Hyperion’s Drips**

Users earn Hyperion Drip through providing liquidity and engaging in trading activity. Drips are calculated daily and rounded down (floor).

#### **A. Liquidity Provision (LP Points)**

| Action                    | Point Calculation | Rule                              |
| ------------------------- | ----------------- | --------------------------------- |
| Provide $100 in liquidity | 5 Points per Day  | Minimum $100 liquidity to qualify |

* **Example Calculation**:
  * Provide $500 in liquidity
  * Points per day: (500 ÷ 100) × 5 = 25 Points

#### **B. Trade Points (Based on Fee Tiers)**

| Fee Tier | Point Calculation                    |
| -------- | ------------------------------------ |
| 0.01%    | 1 Point per $100 in trading volume   |
| 0.05%    | 5 Points per $100 in trading volume  |
| 0.1%     | 10 Points per $100 in trading volume |

* **Example Calculation (Fee Tier 0.05%)**:
  * $1,000 trading volume
  * Points: (1,000 ÷ 100) × 5 = 50 Points

### **2. Invitation Points**

Users are rewarded for inviting others to the platform. Each user is assigned a unique 6-character alphanumeric invitation code. Points are earned from both direct and second-level invitees.

#### **A. Liquidity Referral Rewards**

| Relationship Level   | Point Reward               |
| -------------------- | -------------------------- |
| Direct Invitee       | 20% of LP Points generated |
| Second-Level Invitee | 10% of LP Points generated |

#### **B. Trading Referral Rewards**

| Relationship Level   | Point Reward                  |
| -------------------- | ----------------------------- |
| Direct Invitee       | 20% of Trade Points generated |
| Second-Level Invitee | 10% of Trade Points generated |

* **Example Calculation (Liquidity)**:
  * Direct invitee earns 100 LP Points
  * You receive 20% of 100 = 20 Points
* **Example Calculation (Trade)**:
  * Second-level invitee earns 200 Trade Points
  * You receive 10% of 200 = 20 Points

## Multipliers & Bonus Mechanisms

*Coming Soon*: Drips will introduce point multipliers for consistent participation across trading and liquidity provision, along with seasonal or event-based point boosts.

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# Drip Season 2

## Introduction

DRIPs Season 2 is Hyperion’s upgraded reward system that incentivizes real participation in the ecosystem through trading, liquidity provision, and deeper engagement with the RION token.

DRIPs are calculated and accumulated **daily**, and will later be used to unlock exclusive incentives and airdrop allocations. This season runs from **August 7 - TBD**

***

## Point Categories & Earning Mechanisms

#### Hyperion DRIPs

Users can earn DRIPs in three ways: trading, providing liquidity, and engaging with RION utility. All DRIPs are calculated daily and rounded down.

***

### A. Trade DRIPs (Based on Fees Paid)

Users earn DRIPs based on the trading fees they generate. Each $0.01 in fees contributes to 1 DRIP. Selected pools have different multipliers based on their fee tiers.

#### **Fee Tiers & Multipliers**

<table><thead><tr><th width="194.49609375">Fee Tier</th><th>DRIP Rate</th></tr></thead><tbody><tr><td>0.01%</td><td>1 DRIP per $100 in trading volume</td></tr><tr><td>0.05%</td><td>5 DRIPs per $100 in trading volume</td></tr></tbody></table>

**Eligible Trading Pools:**

* USDT/USDC (0.01%)
* APT/USDC (0.05%)
* APT/USDT (0.05%)
* xBTC/USDC (0.05%)
* APT/xBTC (0.05%)
* WBTC/USDC (0.05%)
* WBTC/xBTC (0.01%)
* APT/WBTC (0.05%)
* APT/kAPT (0.01%)
* APT/goAPT (0.01%)
* USD1/USDC (0.01%)
* sUSDe/USDC (0.01%)

**Example Calculation (APT/USDT Pool, 0.05% Fee Tier):**

$1,000 trading volume → Fee = $0.50 →

DRIPs = $0.50 ÷ $0.01 = 50 DRIPs

***

### B. Liquidity DRIPs (LP Points)

Liquidity providers earn DRIPs based on the size and type of pool they supply liquidity to. Only selected pools are eligible.

#### Pool-Based Reward Rates

<table><thead><tr><th width="286.3984375">Pool</th><th>DRIP Rate</th></tr></thead><tbody><tr><td>USDT/USDC (0.01%)</td><td>1 DRIP per $200 liquidity per day</td></tr><tr><td>Other Liquidity Pools</td><td>1 DRIP per $100 liquidity per day</td></tr></tbody></table>

**Eligible Liquidity Pools:**

* USDT/USDC (0.01%)
* APT/USDC (0.05%)
* APT/USDT (0.05%)
* xBTC/USDC (0.05%)
* APT/xBTC (0.05%)
* WBTC/USDC (0.05%)
* WBTC/xBTC (0.01%)
* APT/WBTC (0.05%)
* APT/kAPT (0.01%)
* APT/goAPT (0.01%)
* USD1/USDC (0.01%)
* sUSDe/USDC (0.01%)

**Example Calculation (APT/USDT Pool):**

Provide $500 liquidity → (500 ÷ 100) × 1 = **5 DRIPs per day**

***

### C. Special Boosts

DRIPs are awarded for trading and LP certain tokens in a limited time period.

#### Boost Details

APT/RION

| Action            | DRIP Reward                        |
| ----------------- | ---------------------------------- |
| Trade             | 3 DRIPs per $0.01 in fees          |
| Provide liquidity | 3 DRIPs per $100 liquidity per day |

Others

| Action            | DRIP Reward                        |
| ----------------- | ---------------------------------- |
| Trade             | 1 DRIPs per $0.01 in fees          |
| Provide liquidity | 1 DRIPs per $100 liquidity per day |

#### Applicable Pairs

* APT/RION (0.3%)
* APT/PACT (0.3%)
* APT/USDC (0.5%)
* sUSDE/USDC (0.01%)
* APT/AMI (0.1%)

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# FAQ

#### 1. Why do different LPs earn very different amounts with the same deposit? <a href="#id-2320" id="id-2320"></a>

Even if two LPs deposit the same token value, they can end up with very different numbers of **LP Units**, and therefore a very different share of active fees. Why?

* **Range width**: A narrower range mints more LP Units per token.
* **Zone location**: Only LP Units inside the *active price zone* count.
* **Competition**: Your share depends on how many other LP Units are active in the same zone.

**Practical Meaning**\
👉 Same token deposit ≠ same LP Units. Narrower ranges generate more LP Units, but only when price is inside that zone. Wider ranges cover more time but dilute your units. Where you park (price zone) and how crowded it is determine how much you actually earn.

#### 2. Why did my rewards drop even though the price stayed in my range? <a href="#id-7112" id="id-7112"></a>

Even if price remains in your chosen range, your earnings can still drop due to:

1. **Competition increasing** → more LPs enter your zone, your share of fees shrinks.
2. **Fee volume changing** → if trading activity slows down, total fees generated in your zone fall.
3. **Subsidies ending or reducing** → if boosted rewards (e.g., drips, incentives) decrease, APR also declines.

**Practical Meaning**\
👉 Even if price never leaves your range, **competition/fees generated/subsidies change directly reduce your fee share**. That’s why Position APR is dynamic: it depends not just on where the price is, but on how many other LPs are active at the same spot.

#### 3. Why did I provide liquidity for one full day but earn almost nothing? <a href="#id-4e9c" id="id-4e9c"></a>

Several factors can cause low earnings despite “being in the pool all day”:

* **Inactive range**: If the price rarely enters your zone, your LP Units don’t count.
* **Wide range**: You mint fewer LP Units per token, diluting your active share.
* **High competition**: Active Pool LP Units are large, shrinking your slice.
* **Low-fee period**: Fees fluctuate; Pool APR is based on historical averages, not your actual day.

**Practical Meaning**\
👉 “Active for a whole day” doesn’t guarantee returns. What matters is **how often the price is inside your range, how concentrated your funds are, and how many others share the zone**. Wide, unfocused ranges look safe, but usually produce very low earnings.


# How to Swap

1. Enter <https://hyperion.xyz/swap> and Connect your Wallet. We support many wallets, such as Mizu Wallet, Petra, OKX Wallet, Nightly, Pontem Wallet,etc. However, we will use Petra as an example to show

<figure><img src="/files/z3byOEMIa6efX4x3kzRN" alt=""><figcaption></figcaption></figure>

2. Choose your target asset and Enter the amount

<figure><img src="/files/6IRk4LlSPtmfMkofyYx9" alt=""><figcaption></figcaption></figure>

3. Set your **Slippage tolerance** for this trade. In this example, we will use a 1% slippage tolerance.

<figure><img src="/files/9gaHU6vQmhRJtbGAjJT0" alt=""><figcaption></figcaption></figure>

4. After everything is set up, confirm the swap to proceed with this transaction and you will receive your target asset in a few seconds.

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# How to Create New Position

1. Check out all the listed trading pools on Hyperion and choose the assets pools that you want to provide liquidity. There are more pools to be shown on our dapp. And then click the "Create New Position" button.

<figure><img src="/files/vQHr3Lkgrk3tUu4a5xF5" alt=""><figcaption></figcaption></figure>

2. Enter the amount of assets on any side of the target liquidity pool.

<figure><img src="/files/C1HCOGPM1IY2kcsFPF4S" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/Av2wrVUFom4EY8l5Ss6k" alt=""><figcaption></figcaption></figure>

3. After you successfully added the liquidity to the target pool, you can find your liquidity in "Position"

<figure><img src="/files/McR5oexpYPM3Z3GT1NKz" alt=""><figcaption></figcaption></figure>

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# How to Add/Remove Liquidity

1. Click ‘Position’ Page to check your position so you will see **‘Add/Remove’** option at the right.

<figure><img src="/files/boYkKpgq1SOPpefKNFKT" alt=""><figcaption></figcaption></figure>

2. Click "Add/Remove" to check your position detail.

<figure><img src="/files/gFyWN32FQ2IP4JZEKZg0" alt=""><figcaption></figcaption></figure>

3. Enter the amount of assets on any side of the target position.Then click the button below and you'll successfully add liquidity.

<figure><img src="/files/AHTaa53v7q1D2iGT16Ue" alt=""><figcaption></figcaption></figure>

4. Click the "Remove" button. You can select the withdrawal ratio in the pop - up window to complete the withdrawal of liquidity.

<figure><img src="/files/XhIZb0BVVsY0oGhidanK" alt=""><figcaption></figcaption></figure>

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# How to Create a New Pool

{% hint style="info" %}
Creating a new market on Hyperion is completely permissionless now (currently live on Aptos). Project owners, token issuers or even community supporters can come onto Hyperion to create a pool for a trading pair if the pool does not exist. Project owners and token issuers are usually persons who are most recommended to conduct the pool creation, because they usually have relatively sufficient initial liquidity to add to the pool, ensuring the pool can handle swaps well from the beginning.
{% endhint %}

1. Under the Liquidity page <https://hyperion.xyz/liquidity>, click “Create Pool” at the top right corner to enter the pool creation procedures. Before you create a new trading pool, you can search or scroll down the page to check if there’s an existing one.

<figure><img src="/files/2HJKdoOQcBOXcgiJ2vQs" alt=""><figcaption></figcaption></figure>

2. When creating a new pool, please specify the pair you would like to set up. Currently only APT token  are accepted as the quote token for a permissionless pool. For the base token, you can select it from the dropdown list or directly input the exact metadata address of your token.

<figure><img src="/files/HSrhHXR1KvDRdykGoB3z" alt=""><figcaption></figcaption></figure>

3. Next, select a fee tier for the pool you are going to create. There are four tiers that are supported now, which are 0.01%, 0.05%, 0.3% and 1% respectively. For most non-stable trading pairs, 0.05% is always the most adopted fee tier. For a relatively rare asset that is rarely traded, 1% can be selected to give enough motivation to LPs. 0.01% and 0.05% are usually used for stable trading pairs. Please select a suitable fee tier for your pool if you want the pool you created to be utilized by more transactions.

<figure><img src="/files/WMV0PMCROID8eLVenSK6" alt=""><figcaption></figcaption></figure>

4. Then, you need to set an initial price for the pool. Please specify a reasonable starting price, otherwise you may need to bear excessive impermanent loss. Besides, you need to set a price range which you want to allocate your initial liquidity into. The initial price must be within the range you selected.

<figure><img src="/files/lFsM4MljeBlxHbc8KMxN" alt=""><figcaption></figcaption></figure>

5. After setting all basic parameters, you need to enter the liquidity amount you want to provide to the pool as initial liquidity. Just input the amount for one of the tokens, the amount for the other one will be automatically calculated according to the starting price and the price range you select.

<figure><img src="/files/DPEcmr7sfxGmWmrTa1pL" alt=""><figcaption></figcaption></figure>

6. You’ve entered all needed parameters, you can confirm to create the pool and approve your wallet to add initial liquidity.
7. After a pool is created, it usually takes a few minutes for the pool to be displayed or searchable on the front end interface of Hyperion. Users will be able to start enjoying swapping and LPing with this new market you just created.

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# How to Place a Limit Order

The **Trigger** function allows users to place **on-chain limit orders** directly within the DEX. Instead of executing at the current market price, users can specify a **target rate** and **execution parameters**.

#### **Key Features**

* **Sell Amount**: The quantity of the selected token to sell (e.g., USDT)
* **Buy Amount**: The amount of the counter token expected at the target rate (e.g., APT).
* **Rate**: The limit price (e.g., 1 APT = 3.981161 USDT).
* **Expiry**: Order validity (e.g., Never, 1 day, 1 week).
* **Execution Fee**: Paid only **upon successful execution**; rewarded to the executor.
* **Gas Fee**: Covers network cost, paid to the executor.
* **Platform Fee**: Charged by the DEX, currently free.

Hyperion is an **open protocol** — anyone can execute Trigger orders and earn the Execution and Gas fees. Users only pay these fees when their orders are successfully executed.

Users create a Trigger order by confirming these parameters. Once the market price reaches the set rate, the trade is executed automatically on-chain.

***

### Guide

1. Select Trigger Mode, On the **Swap page**, choose **Trigger** from the mode selector (highlighted in red). This switches from **Instant Swap** to **Limit Order(Trigger)** functionality.

<figure><img src="/files/5l1PQw45d1xVq3Z8T6Lu" alt=""><figcaption></figcaption></figure>

2. Enter Order Details

* **Selling**: Enter the amount and token you want to sell.
* **Buying**: The system calculates the equivalent amount of the token you will receive.
* **Rate**: Adjust your desired limit price.
* **Expiry**: Set how long the order remains valid (e.g., Never, 1 day, 1 week).

⚠️ **Important:** The *Rate* field defines your execution price.

<figure><img src="/files/Bb3GqaAV7Gy0PwdZEtNb" alt=""><figcaption></figcaption></figure>

3. Create Order

* Review the Trigger Summary, then click **Create Order** (highlighted in red)
* The summary includes:
  * **Sell Amount**
  * **Target Rate**
  * **Expected Buy Amount**
  * **Expiry, Fees, and Gas Costs**

<figure><img src="/files/RVsyGRwKw9KrX5QPILM5" alt=""><figcaption></figcaption></figure>

4. Manage Open Orders

* After submission, your order appears under **Open Orders** (red box).
* Each order displays:
  * Amount
  * Target rate
  * Expected tokens to receive
  * Execution progress
* Options available:
  * **Cancel Order** (individually)
  * **Cancel All** (for batch cancellation)

<figure><img src="/files/UD2o0m5kTcOi1ZgIoPpp" alt=""><figcaption></figcaption></figure>

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# How to Place a Recurring Order

The **Recurring** function enables users to perform **on-chain Dollar-Cost Averaging (DCA)** by scheduling multiple smaller swaps over time, rather than a single lump-sum trade.

#### **Key Features:**

* **Selling**: Choose the token and amount you want to invest.
* **To Buy**: Select the asset you want to accumulate.
* **Every**: Define the frequency of trades (e.g., every 1 minute, 1 hour, 1 day).
* **Over**: Define the total number of scheduled trades (e.g., 2 orders, 10 orders).
* **Price Range (optional) –** Set a minimum and maximum price band. Trades will only execute if the market price remains within this band.
* **Market Rate**: Shows the current exchange rate for reference.
* **Execution Fee**: Paid only when the order is executed, rewarded to the executor.
* **Gas Fee**: Covers network cost, paid to the executor.
* **Platform Fee**: Charged by the DEX, currently free.

Hyperion is an **open protocol** — anyone can execute Trigger orders and earn the Execution and Gas fees. Users only pay these fees when their orders are successfully executed.

Once the frequency, trade count, and price conditions are set, the system automatically executes the Recurring swaps whenever those conditions are met.

***

### Guide

1. Select Recurring ModeOn the Swap page, select **Recurring** (highlighted in red). This switches the interface from *Instant Swap* to *Recurring (DCA scheduling)*.

<figure><img src="/files/cXin5cvvojTDtNvwuPRo" alt=""><figcaption></figcaption></figure>

2. Enter Order Details

* **Selling**: Enter the token and amount you want to invest.
* **To Buy**: Select the token you want to accumulate.
* **Every**: Choose the frequency of each swap (e.g., every 1 minute / 1 day / 1 week).
* **Over**: Define the total number of trades (e.g., 2 orders, 10 orders).
* **Price Range (optional)**: Set a minimum and maximum price — trades only execute within this band.

⚠️ **Important:** The *Every* + *Over* fields determine how your total investment is split over time.

<figure><img src="/files/6JGTTSAtA8jKj74PJxip" alt=""><figcaption></figcaption></figure>

3. Create Order

* Review the **Recurring Summary** before confirming:
  * **Sell Total** (e.g., 100 USDT)
  * **Sell per Order** (e.g., 50 USDT)
  * **To Buy** (expected APT)
  * **Order Interval** (e.g., 1 minute)
  * **Estimated Expiry** (based on frequency × number of orders)
  * **Fees** (Platform Fee = 0, Gas Fee covered)
* Click **Create Order** (red box) to finalize.

<figure><img src="/files/y23P1U0xFkHQvwE6YcW8" alt=""><figcaption></figcaption></figure>

4. Track Recurring Orders

* After confirmation, your Recurring order appears under *Open Orders* (highlighted in red).
* Each scheduled trade executes automatically until all trades are completed.
* You can cancel individual orders or use **Cancel All** anytime.

<figure><img src="/files/6oD4b4LPxJZNsjIhIx9t" alt=""><figcaption></figcaption></figure>

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# APR Calculation for Liquidity Pools and Positions

This page illustrates how individual APRs vary based on the proportion of active liquidity each provider contributes within the fee-generating price bin.

### Formula

Pool APR = (Fees+Rewards) / Active Pool Value

Your Position APR = (Fees+Rewards) \* (Your Active Position LP Units / Active Pool LP Units) / Your Position Value

### Example

Consider a pool with three liquidity providers where the current price is in bin P.

* A deposits $1000 entirely within the active price bin P and receives 1000 active LP units.
* B deposits $1000, spreading it evenly across 100 bins, receiving only 9 active LP units.
* C deposits $1000, but none of the funds falls into bin P, so this position is inactive and receives 0 active LP units.
* The pool generated $100 in fees within bin P.

**APR Calculation:**

* Pool APR = $100/$2000 = 5%
* A's Position APR = $100\* (1000 /1009) / $1000 = 9.91%
* B's Position APR = $100\* (9 /1009) / $1000 = 0.089%
* C's Position APR = $100\* (0 /1009) / $1000 = 0%

Understand the APR Calculation from a real-world example:

<https://hyperionxyz.medium.com/understanding-hyperion-lp-apr-through-a-parking-lot-analogy-061c7a1c4e95>


# Dev Overview


# via Site

## Prod (Mainnet + Prod APIs)&#x20;

{% embed url="<https://hyperion.xyz>" %}

## Test (Testnet + Test APIs)

{% embed url="<https://test.hyperion.xyz/>" %}

Tips for test env:

1. If you want find specific pool, please type the token name via `search input` on the pool page.
2. If you want swap tokens in testnet, please import the tokens at swap token selection dialog manually.

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# via SDK

Please refer to the following modules to learn how to integrate with Hyperion Protocol via our Typescript SDK.

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# Getting Started

## Introduction

The @hyperionxyz/sdk is the official software development kit for Hyperion. It offers developers the tools and resources they need to connect and interact with Hyperion effortlessly. This enables the creation of strong and efficient applications.

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# Prerequisites

## 1. NPM install

```sh
$ pnpm i @aptos-labs/ts-sdk @aptos-labs/script-composer-sdk @hyperionxyz/sdk
```

{% hint style="info" %}
It requires @aptos-labs/ts-sdk ≥ 5.1.0, @aptos-labs/script-composer-sdk ≥ 0.3.1
{% endhint %}

## 2. Setting Up Configuration

> You need create an Aptos Build account, and generate a API key for using Aptos public services. Click <https://build.aptoslabs.com/docs/introduction> to learn more.

Hyperion Typescript SDK now includes a default initialization method that allows for quick generation of the Hyperion SDK configuration. You can utilize the initHyperionSDK method to swiftly initialize the configuration. You have the option to select either 'mainnet' or 'testnet' for the network.

```typescript
import { Network } from "@aptos-labs/ts-sdk";
import { initHyperionSDK } from '@hyperionxyz/sdk'

const sdk = initHyperionSDK({
    network: Network.MAINNET, 
    APTOS_API_KEY: "Your APTOS API key"
})
```

Now, you can start using Hyperion SDK!

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# Features Available

##


# Get pools

## 1. Get all pools

use `sdk.Pool.fetchAllPools`  method.

### Example

```typescript
async function fetchAllPools() {
    const poolItems = await sdk.Pool.fetchAllPools();
    console.log(poolItems)
}
```

## 2. Get pool by poolId

```typescript
async function fetchOnePool() {
    const pool = await sdk.Pool.fetchPoolById({
        poolId: '0xf108...876b5'
    })
}

```

## 3. Get pool by token asset types and feeTier

(from v0.0.7)

```javascript
async function fetchOnePool() {
    const pool = await sdk.Pool.getPoolByTokenPairAndFeeTier({
        token1: '0x1::aptos_coin::AptosCoin',
        token2: '0x6926bff1eab5554fa72ae167ed736acf623ab17fe81ebf2ea0d2138f8c533f77::type::T',
        feeTier: FeeTierIndex["PER_0.01_SPACING_1"],
    })
}
```

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# Get positions

## 1. Get all positions by \`ownerAddress\`

use `sdk.Position.fetchAllPositionsByAddress` method

### Function input params

* `address` : The user account address.

### Example

```typescript
async function fetchPositionsByAddress() {
    const positions = await sdk.Position.fetchAllPositionsByAddress({
        address: '0x7fd8...aedc1'
    })
}

/*
result:
[
    {
  "isActive": true,
  "value": "1.6999804583508067796",
  "subsidy": {
    "claimed": [
      {
        "amount": "15769",
        "amountUSD": "0.00012961559826835815",
        "token": "0xc5bcdea4d8a9f5809c5c945a3ff5698a347afb982c7389a335100e1b0043d115"
      }
    ],
    "unclaimed": [
      {
        "amount": "7859",
        "amountUSD": "0.00006459819816037965",
        "token": "0xc5bcdea4d8a9f5809c5c945a3ff5698a347afb982c7389a335100e1b0043d115"
      }
    ]
  },
  "fees": {
    "claimed": [
      {
        "amount": "0",
        "amountUSD": "0",
        "token": "0x000000000000000000000000000000000000000000000000000000000000000a"
      },
      {
        "amount": "647",
        "amountUSD": "0.00000531811098228345",
        "token": "0xc5bcdea4d8a9f5809c5c945a3ff5698a347afb982c7389a335100e1b0043d115"
      }
    ],
    "unclaimed": [
      {
        "amount": "38",
        "amountUSD": "0.0000031079258626",
        "token": "0x000000000000000000000000000000000000000000000000000000000000000a"
      },
      {
        "amount": "0",
        "amountUSD": "0",
        "token": "0xc5bcdea4d8a9f5809c5c945a3ff5698a347afb982c7389a335100e1b0043d115"
      }
    ]
  },
  "position": {
    "objectId": "0x4b65447d775934596686ef643ad10f3f552b35ff5c2d1bf992c616e4b527fe77",
    "poolId": "0xf1083e26e765506c9360d6b07c1478e6bc40376848b4ee44f4f3c729cf2876b5",
    "tickLower": 22410,
    "tickUpper": 25930,
    "createdAt": "2024-12-23T08:36:50.072Z",
    "pool": {
      "currentTick": 22971,
      "feeRate": "500",
      "feeTier": 1,
      "poolId": "0xf1083e26e765506c9360d6b07c1478e6bc40376848b4ee44f4f3c729cf2876b5",
      "senderAddress": "0xa5647cdb26df359efb506b5e06a320349b34bbc995314a35f3670a98a210afc6",
      "sqrtPrice": "58172517897304752052",
      "token1": "0x000000000000000000000000000000000000000000000000000000000000000a",
      "token2": "0xc5bcdea4d8a9f5809c5c945a3ff5698a347afb982c7389a335100e1b0043d115",
      "token1Info": {
        "assetType": "0x000000000000000000000000000000000000000000000000000000000000000a",
        "bridge": null,
        "coinMarketcapId": "21794",
        "coinType": "0x1::aptos_coin::AptosCoin",
        "coingeckoId": "",
        "decimals": 8,
        "faType": "0xa",
        "hyperfluidSymbol": "APT",
        "logoUrl": "https://hyperfluid.xyz/aptos-token/main/logos/APT.svg",
        "name": "Aptos Coin",
        "symbol": "APT",
        "isBanned": false,
        "websiteUrl": "https://aptosfoundation.org"
      },
      "token2Info": {
        "assetType": "0xc5bcdea4d8a9f5809c5c945a3ff5698a347afb982c7389a335100e1b0043d115",
        "bridge": null,
        "coinMarketcapId": "",
        "coinType": "0x6926bff1eab5554fa72ae167ed736acf623ab17fe81ebf2ea0d2138f8c533f77::type::T",
        "coingeckoId": "",
        "decimals": 6,
        "faType": "0xc5bcdea4d8a9f5809c5c945a3ff5698a347afb982c7389a335100e1b0043d115",
        "hyperfluidSymbol": "hfShaq",
        "logoUrl": "",
        "name": "Shaq",
        "symbol": "hfShaq",
        "isBanned": false,
        "websiteUrl": null
      }
    }
  }
}
]
*/
```

## 2. Get position by \`positionId\`&#x20;

use `sdk.Position.fetchPositionById` method.

### Function input params&#x20;

* `positionId`: Position's id
* `address` : The user account address.

### Example

```typescript
async function fetchPositionById() {
    const pool = await sdk.Position.fetchPositionById({
        positionId: '',
        address: '',
    })
    console.log(pool);
}
```

## 3. Get fee history of the position

use `sdk.Position.fetchFeeHistory` method

### Function input params&#x20;

* `positionId`: Position's id
* `address` : The user account address.

### Example

```typescript
async function fetchFeeHistory() {
    const feeHistory = await sdk.Position.fetchFeeHistory({
        positionId: '',
        address: '',
    })
    console.log(feeHistory);
}
```

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# Get ticks

## 1. Batch get ticks by pool ID

use `sdk.Pool.fetchTicks` method

### Function input params

* `poolId` : The pool object ID.

### Example

```typescript
async function fetchTicksByPoolId() {
    await ticks = await sdk.Pool.fetchTicks({
        poolId: ''
    })
}
```

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# Create pool

## 1. Create a pool with some initial liquidity to be added

use `sdk.pool.createPoolTransactionPayload` method.

### Function input params

* `currencyA`:  coin/fa type of currency token
* `currencyB`:  coin/fa type of currency token
* `currencyAAmount`: the amount about currency A, which used to add liquidity
* `currencyBAmount`: the amount about currency B, which used to add liquidity
* `feeTierIndex`: Fee Rate Tier will affect price precision. Now mainnet exist some different type FeeRateTier, the correspond to different fee rates.

<table data-full-width="true"><thead><tr><th>Tick spacing</th><th>Fee Rate</th><th data-type="number">FeeTierIndex</th></tr></thead><tbody><tr><td>1</td><td>0.01%</td><td>0</td></tr><tr><td>10</td><td>0.05%</td><td>1</td></tr><tr><td>60</td><td>0.3%</td><td>2</td></tr><tr><td>200</td><td>1%</td><td>3</td></tr><tr><td>20</td><td>0.1%</td><td>4</td></tr><tr><td>50</td><td>0.25%</td><td>5</td></tr></tbody></table>

* `currentPriceTick` :  The tick corresponds to the current price.
* `tickLower` :  The tick corresponds to the lower price.
* `tickUpper` :  The tick corresponds to the upper price.

> - SDK provided a util function \`priceToTick\` for the calculation from price to tick.
> - -443636 < `tickLowerIndex` < currentPriceTickIndex<`tickUpperIndex` < 443636, 443636 is a constant, derived from the maximum range representable by the Q32.62 fixed-point number format.
> - Currently, creating a pool requires adding bidirectional liquidity.

* `slippage` :  slippage value. 0.1 means 0.1%

### Example

```typescript

import {
  FeeTierIndex,
  HighestTickByStep,
  LowestTickByStep,
  priceToTick,
} from "@hyperionxyz/sdk"

const currencyAAmount = Math.pow(10, 8);
// currencyA's decimals is 8
// currencyB's decimals is 6
const decimalsRatio = Math.pow(10, 8 - 6);
const feeTierIndex = FeeTierIndex["PER_0.05_SPACING_5"]

// To get the tick boundary of this feeTier
const lowerTick = LowestTickByStep[feeTierIndex];
const upperTick = HighestTickByStep[feeTierIndex];

// 1 -443630 443630
console.log(feeTierIndex, lowerTick, upperTick);

// Or To calculate tick by price
const currentPriceTick = priceToTick({
  price: 995,
  feeTierIndex,
  decimalsRatio,
})

const tickLower = priceToTick({
  price: 992,
  feeTierIndex,
  decimalsRatio,
})

const tickUpper = priceToTick({
  price: 1336,
  feeTierIndex,
  decimalsRatio,
})

const [_, currencyBAmount] = await sdk.Pool.estCurrencyBAmountFromA({
  // address here mus be fa type
  currencyA: "0xa",
  currencyB:
    "0xc5bcdea4d8a9f5809c5c945a3ff5698a347afb982c7389a335100e1b0043d115",
  currencyAAmount,
  feeTierIndex,
  tickLower,
  tickUpper,
  currentPriceTick,
});

const params = {
  currencyA: "0x1::aptos_coin::AptosCoin",
  currencyB:
    "0x6926bff1eab5554fa72ae167ed736acf623ab17fe81ebf2ea0d2138f8c533f77::type::T",
  currencyAAmount,
  currencyBAmount,
  feeTierIndex,
  currentPriceTick,
  tickLower,
  tickUpper,
  slippage: 0.1
};

// generate payload
const payload = await sdk.Pool.createPoolTransactionPayload(params)
// payload example
/*
{
  "function": "0xdd8d1a676801c6789fac9a06b8f6ced76f766c798f7e5ea276f25d80b9aa0af0::router_adapter::create_liquidity_entry",
  "typeArguments": [],
  "functionArguments": [
    // Token A FA type
    '0xa',
    // Token B FA type
    '0xb',
    // feeTierIndex: it can be found from the table above.
    1,
    // Pool Type: a constant value, just set it to false
    false,
    
    // the ticks must be greater and equal to 0
    // If you want to pass a negative integer, please convert it to a unsigned integer.
    // low price's tick
    22410,
    // high price's tick
    25930,
    // current price's tick
    22940,
    // Token A amount
    100000000,
    // Token B amount
    200287120,
    // Token A amount * (1 - slippage)
    99900000,
    // Token B amount * (1 - slippage)
    200086833,
    // Expiration time in second
    4891474469
  ]
}
*/

// or

/*
{
  "function": "0xdd8d1a676801c6789fac9a06b8f6ced76f766c798f7e5ea276f25d80b9aa0af0::router_adapter::create_liquidity_both_coin_entry",
  "typeArguments": [
     "0x1::aptos_coin::AptosCoin",
     "0x6926bff1eab5554fa72ae167ed736acf623ab17fe81ebf2ea0d2138f8c533f77::type::T"
   ],
  "functionArguments": [
    // feeTierIndex: it can be found from the table above.
    1,
    // Pool Type: a constant value, just set it to false
    false,
    
    // the ticks must be greater and equal to 0
    // If you want to pass a negative integer, please convert it to a unsigned integer.
    // low price's tick
    22410,
    // high price's tick
    25930,
    // current price's tick
    22940,
    // Token A amount
    100000000,
    // Token B amount
    200287120,
    // Token A amount * (1 - slippage)
    99900000,
    // Token B amount * (1 - slippage)
    200086833,
    // Expiration time in second
    4891474469
  ]
}
*/
```

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# Add Liquidity

Once you have set a suitable tick range, you can proceed to add liquidity to this position. The quantity composition of tokens you need to add is affected by the current price of the pool and the tick interval you have chosen.

## 1. Create the payload of Add Liquidity&#x20;

use `sdk.Position.addLiquidityTransactionPayload` method

### Function Input params

* `positionId` : The position id.
* `currencyA`:  coin/fa type of currency token
* `currencyB`:  coin/fa type of currency token
* `currencyAAmount`: the amount about currency A, which used to add liquidity
* `currencyBAmount`: the amount about currency B, which used to add liquidity
* `feeRateTier`: Fee Rate Tier will affect price precision. Now mainnet exist some different type FeeRateTier, the correspond to different fee rates.

<table data-full-width="true"><thead><tr><th>Tick spacing</th><th>Fee Rate</th><th data-type="number">FeeTierIndex</th></tr></thead><tbody><tr><td>1</td><td>0.01%</td><td>0</td></tr><tr><td>10</td><td>0.05%</td><td>1</td></tr><tr><td>60</td><td>0.3%</td><td>2</td></tr><tr><td>200</td><td>1%</td><td>3</td></tr><tr><td>20</td><td>0.1%</td><td>4</td></tr><tr><td>50</td><td>0.25%</td><td>5</td></tr></tbody></table>

* `slippage` : slippage value. 0.1 means 0.1%.

### Example

```typescript


const currencyAAmount = Math.pow(10, 8);
// currencyA's decimals is 8
// currencyB's decimals is 6
const decimalsRatio = Math.pow(10, 8 - 6);
const feeTierIndex = FeeTierIndex["PER_0.05_SPACING_5"]

const currentPriceTick = priceToTick({
  price: 995,
  feeTierIndex,
  decimalsRatio,
})

const tickLower = priceToTick({
  price: 992,
  feeTierIndex,
  decimalsRatio,
})

const tickUpper = priceToTick({
  price: 1336,
  feeTierIndex,
  decimalsRatio,
})

const [_, currencyBAmount] = await sdk.Pool.estCurrencyBAmountFromA({
  // address here mus be fa type
  currencyA: "0xa",
  currencyB:
    "0xc5bcdea4d8a9f5809c5c945a3ff5698a347afb982c7389a335100e1b0043d115",
  currencyAAmount,
  feeTierIndex,
  tickLower,
  tickUpper,
  currentPriceTick,
});

const params = {
    positionId: '',
    currencyA: "0x1::aptos_coin::AptosCoin",
    currencyB:
      "0x6926bff1eab5554fa72ae167ed736acf623ab17fe81ebf2ea0d2138f8c533f77::type::T",
    currencyAAmount,
    currencyBAmount,
    slippage: 0.1,
    feeTierIndex,
}

const payload = await sdk.Position.addLiquidityTransactionPayload(params)


```

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# Remove Liquidity

When you want to adjust the liquidity of your position or withdraw liquidity from the position, you can use the following method.

## 1. Remove liquidity by inputting liquidity value

use `sdk.Position.removeLiquidityTransactionPayload` method

### Function Input params

* `positionId` : The pool id
* `currencyA`:  coin/fa type of currency token
* `currencyB`:  coin/fa type of currency token
* `currencyAAmount`: the amount about currency A, which used to remove liquidity
* `currencyBAmount`: the amount about currency B, which used to remove liquidity
* `deltaLiquidity` : remove liquidity amount
* `slippage` : slippage value. 0.1 means 0.1%.
* `recipient` : recipient address

### Exmaple

```typescript

const position = await sdk.Position.fetchPositionById({
  positionId: '',
  address: '',
})

/*
[
  {
    "objectId": "0x4b65447d775934596686ef643ad10f3f552b35ff5c2d1bf992c616e4b527fe77",
    "poolId": "0xf1083e26e765506c9360d6b07c1478e6bc40376848b4ee44f4f3c729cf2876b5",
    "txnTimestamp": "2024-12-23T16:36:49.417659+08:00",
    "currentAmount": 396855612,
    "position": {
      "tickLower": 22410,
      "tickUpper": 25930
    },
    "pool": [
      {
        "currentTick": 22971,
        "feeRate": 500,
        "feeTier": 1,
        "poolId": "0xf1083e26e765506c9360d6b07c1478e6bc40376848b4ee44f4f3c729cf2876b5",
        "senderAddress": "0xa5647cdb26df359efb506b5e06a320349b34bbc995314a35f3670a98a210afc6",
        "sqrtPrice": 58172517897304750000,
        "token1": "0x000000000000000000000000000000000000000000000000000000000000000a",
        "token2": "0xc5bcdea4d8a9f5809c5c945a3ff5698a347afb982c7389a335100e1b0043d115",
        "token1Info": {
          "assetType": "0x000000000000000000000000000000000000000000000000000000000000000a",
          "bridge": null,
          "coinMarketcapId": "21794",
          "coinType": "0x1::aptos_coin::AptosCoin",
          "coingeckoId": "",
          "decimals": 8,
          "faType": "0xa",
          "hyperfluidSymbol": "APT",
          "logoUrl": "https://hyperfluid.xyz/aptos-token/main/logos/APT.svg",
          "name": "Aptos Coin",
          "symbol": "APT",
          "isBanned": false,
          "websiteUrl": "https://aptosfoundation.org"
        },
        "token2Info": {
          "assetType": "0xc5bcdea4d8a9f5809c5c945a3ff5698a347afb982c7389a335100e1b0043d115",
          "bridge": null,
          "coinMarketcapId": "",
          "coinType": "0x6926bff1eab5554fa72ae167ed736acf623ab17fe81ebf2ea0d2138f8c533f77::type::T",
          "coingeckoId": "",
          "decimals": 6,
          "faType": "0xc5bcdea4d8a9f5809c5c945a3ff5698a347afb982c7389a335100e1b0043d115",
          "hyperfluidSymbol": "hfShaq",
          "logoUrl": "",
          "name": "Shaq",
          "symbol": "hfShaq",
          "isBanned": false,
          "websiteUrl": null
        }
      }
    ]
  }
]
*/

const [currencyAAmount, currencyBAmount] = await sdk.Position.fetchTokensAmountByPositionId({
  positionId,
})

const removeRatio = 0.5

const params = {
  positionId,
  currencyA: "0x1::aptos_coin::AptosCoin",
  currencyB:
    "0x6926bff1eab5554fa72ae167ed736acf623ab17fe81ebf2ea0d2138f8c533f77::type::T",
  currencyAAmount: parseInt(currencyAAmount * removeRatio),
  currencyBAmount: parseInt(currencyBAmount * removeRatio),
  deltaLiquidity: parseInt(position[0].currentAmount * removeRatio),
  slippage: 0.1,
  recipient: accountAddress,
}

const payload = await sdk.Position.removeLiquidityTransactionPayload(params)
console.log(payload)
```

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# Fee & Rewards

When you add liquidity within a valid price range, all transaction fees generated within this range will be distributed based on the proportional share of effective liquidity from all positions within the current range. If you intend to harvest transaction fees separately, please follow the method below.

## 1. Fetch Pending Fee Info

You can get all pending/claimed fee info from method `sdk.Position.fetchPositionById` .

## 2. Generate all rewards claim payload

use `sdk.Position.claimAllRewardsTransactionPayload` method

### Function Input Params

* `positionId` : The pool's id
* `recipient` : who will get this fee reward.

### Example

```typescript
const payload = sdk.Position.claimAllRewardsTransactionPayload({
    positionId: '',
    recipient: ''
})
```

## 3. Generate fee claim payload

use `sdk.Position.claimFeeTransactionPayload` method

### Function Input Params

* `positionId` : The pool's id
* `recipient` : who will get this fee reward.

### Example

```typescript
const payload = sdk.Position.claimFeeTransactionPayload({
    positionId: '',
    recipient: ''
})
```

## 4. Generate reward claim payload

use `sdk.Position.claimRewardTransactionPayload` method

### Function Input Params

* `positionId` : The pool's id
* `recipient` : who will get this fee reward.

### Example

```typescript
const payload = sdk.Position.claimRewardTransactionPayload({
    positionId: '',
    recipient: ''
})
```

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# Swap

Before swapping. you should obtain the estimated amount of the other token and ths swap routes.

There are two functions for this preperation.

* `sdk.Swap.estFromAmount`&#x20;
* `sdk.Swap.estToAmount`&#x20;

## Swap

use `sdk.Swap.swapTransactionPayload` method.

### Example

```typescript

const currencyAAmount = Math.pow(10,7)
const { amountOut: currencyBAmount, path: poolRoute} = await sdk.Swap.estToAmount({
  amount: currencyAAmount,
  from: "0xa",
  to: "0xc5bcdea4d8a9f5809c5c945a3ff5698a347afb982c7389a335100e1b0043d115",
  // safeMode
  // if safeMode is true, only few swap token pairs will return path route
  // default: true. support from (v0.0.12)
  safeMode: false
})

/*
{
  
  "amountOut": "10000000", // This is for toAmount
  "amountIn": "1279371", // This is for fromAmount
  
  // swap path route
  "path": [
    "0x0d21c2f5628db619957703e90ab07bcb2b13ad6983da2b5d721f24523cae29ff"
  ]
}
*/

const params = {
  // here must be fa type
  currencyA: '0xa',
  currencyB:
    "0xc5bcdea4d8a9f5809c5c945a3ff5698a347afb982c7389a335100e1b0043d115",
  currencyAAmount,
  currencyBAmount,
  slippage: 0.1,
  poolRoute,
  recipient: '',
}

const payload = await sdk.Swap.swapTransactionPayload(params)
console.log(payload)
```

## Swap with Partnership

use `sdk.Swap.swapWithPartnershipTransactionPayload` method.

(from v0.0.17)

### Example

```typescript

const currencyAAmount = Math.pow(10,7)
const { amountOut: currencyBAmount, path: poolRoute} = await sdk.Swap.estToAmount({
  amount: currencyAAmount,
  from: "0xa",
  to: "0xc5bcdea4d8a9f5809c5c945a3ff5698a347afb982c7389a335100e1b0043d115",
  // safeMode
  // if safeMode is true, only few swap token pairs will return path route
  // default: true. support from (v0.0.12)
  safeMode: false
})

/*
{
  
  "amountOut": "10000000", // This is for toAmount
  "amountIn": "1279371", // This is for fromAmount
  
  // swap path route
  "path": [
    "0x0d21c2f5628db619957703e90ab07bcb2b13ad6983da2b5d721f24523cae29ff"
  ]
}
*/

const params = {
  // here must be fa type
  currencyA: '0xa',
  currencyB:
    '0xc5bcdea4d8a9f5809c5c945a3ff5698a347afb982c7389a335100e1b0043d115',
  currencyAAmount,
  currencyBAmount,
  slippage: 0.1,
  poolRoute,
  partnership: 'your_platform_name'
}

const payload = await sdk.Swap.swapWithPartnershipTransactionPayload(params)
console.log(payload)
```

## Swap via Aggregator

(from v0.0.24)

```typescript
// if from === input, est to token amount by from token amount 
// if to === input,  est from token amount by to token amount
const params = {
  amount: Math.pow(10,7),
  from: '0xa',
  input: '0xa',
  to: '0x357b0b74bc833e95a115ad22604854d6b0fca151cecd94111770e5d6ffc9dc2b',
  slippage: args.slippage,   // 0.1
};

// 1. est amount and get aggregation info
const aggregatorRoutes = await sdk.Swap.estAmountByAggregateSwap(params);
/*
{
  "fromToken": {
    "address": "0x000000000000000000000000000000000000000000000000000000000000000a"
  },
  "toToken": {
    "address": "0x357b0b74bc833e95a115ad22604854d6b0fca151cecd94111770e5d6ffc9dc2b"
  },
  // est amount
  // from -> to: true
  // to -> from : false
  "exactIn": true,
  "feeAmount": "50000",
  "fromTokenAmount": "100000000",
  "minToTokenAmount": "3217167",
  "toTokenAmount": "3249664",
  "quotes": {
    "route": [
      {
        "amountIn": "100000000",
        "amountOut": "3249664",
        "percentage": 100,
        "feeAmount": "50000",
        "routeTaken": [
          {
            "fromToken": {
              "tokenType": "0x000000000000000000000000000000000000000000000000000000000000000a"
            },
            "toToken": {
              "tokenType": "0x357b0b74bc833e95a115ad22604854d6b0fca151cecd94111770e5d6ffc9dc2b"
            },
            "dexName": "Hyperion",
            "poolId": "0x18269b1090d668fbbc01902fa6a5ac6e75565d61860ddae636ac89741c883cbc",
            "a2b": true,
            "sqrtPriceLimit": "4295048016",
            "poolType": "none",
            "amountIn": "100000000",
            "amountOut": "3249664"
          },
          ...
        ]
      },
      ...
    ]
  }
}
*/


// 2. Build transaction and submit
import { BuildScriptComposerTransaction } from '@aptos-labs/script-composer-sdk';
import { AptosConfig } from '@aptos-labs/ts-sdk';

const transaction = await BuildScriptComposerTransaction({
  sender: address,
  aptosConfig: new AptosConfig({
     network: Network.MAINNET,
  }),
  builder: async (builder) => {
    await sdk.Swap.generateAggregateSwapTransactionScript({
      ...aggregatorRoutes,
      builder,
      // custom setting. 
      // Default is 'hyperion-aggregator', if don't set.
      partnershipId?: 'your-platfrom-name/co-activity-name' 
    });

    return builder;
  },
});

// extract the payload
const {
  rawTransaction: { payload },
} = transaction as any;

// submit the transaction
const { hash } = await walletCore?.signAndSubmitTransaction({
  data: {
    bytecode: payload.script.bytecode,
    functionArguments: payload.script.args,
    typeArguments: payload.script.type_args,
  },
});
```

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# Types

## Pools Item

```typescript
interface PoolItem {
  id: string;
  aprUSD: string;
  dailyVolumeUSD: string;
  feesUSD: string;
  tvlUSD: string;
  pool: Pool;
}
```

## Pool

```typescript

interface Pool {
  currentTick: number;
  feeRate: string;
  feeTier: number;
  poolId: string;
  senderAddress: string;
  sqrtPrice: string;
  token1: string;
  token2: string;
  token1Info: TokenInfo;
  token2Info: TokenInfo;
}
```

## TokenInfo

```typescript
interface TokenInfo {
  assetType: string;
  bridge: string | null;
  coinMarketcapId: string;
  coinType: string;
  coingeckoId: string;
  decimals: number;
  faType: string;
  hyperfluidSymbol: string;
  logoUrl: string;
  name: string;
  symbol: string;
  isBanned: boolean;
  websiteUrl: string | null;
}
```

## Fee & Subsidy

```typescript
interface Subsidy {
    claimed: Array<{
        amount: string;
        amountUSD: string;
        token: string;
    }>;
    unclaimed: Array<{
        amount: string;
        amountUSD: string;
        token: string;
    }>;
}

interface Fee {
    claimed: Array<{
        amount: string;
        amountUSD: string;
        token: string;
    }>;
    unclaimed: Array<{
        amount: string;
        amountUSD: string;
        token: string;
    }>;
}
```

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# via Contract

This is an interface contract to help everyone integrate with the Hyperion contract.

{% embed url="<https://github.com/Hyperionxyz/hyperion-interface>" %}

<table><thead><tr><th width="132">Network</th><th width="394">Published address</th></tr></thead><tbody><tr><td>mainnet</td><td>0x8b4a2c4bb53857c718a04c020b98f8c2e1f99a68b0f57389a8bf5434cd22e05c</td></tr><tr><td>testnet</td><td>0x69faed94da99abb7316cb3ec2eeaa1b961a47349fad8c584f67a930b0d14fec7</td></tr></tbody></table>

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# Get Started

## How to depend on this service? <a href="#how-to-depend-on-this-service" id="how-to-depend-on-this-service"></a>

### Dependencies

```
dex-interface = { git = "https://github.com/Hyperfluid/hyperfluid-interface" }

```

### Example

```
[package]
name= "hyperfluid_example"
version = "0.0.1"

[dependencies]
dex-interface = { git = "https://github.com/Hyperfluid/hyperfluid-interface" }

[address]
hyperfluid_example = "0x0"

```

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# Data structure

## Pool

```
    #[resource_group_member(group = aptos_framework::object::ObjectGroup)]
    struct LiquidityPoolV3 has key {
        token_a_liquidity: Object<FungibleStore>,
        token_b_liquidity: Object<FungibleStore>,
        token_a_fee: Object<FungibleStore>,
        token_b_fee: Object<FungibleStore>,
        // the current price
        sqrt_price: u128,
        // liquidity current tick
        liquidity: u128,
        // the current tick
        tick: I32,
        // the most-recently updated index of the observations array
        observation_index: u64,
        // the current maximum number of observations that are being stored
        observation_cardinality: u64,
        // the next maximum number of observations to store, triggered in observations.write
        observation_cardinality_next: u64,
        /// The numerator of fee rate, the denominator is 1_000_000.
        fee_rate: u64,
        // the current protocol fee as a percentage of the swap fee taken on withdrawal
        // the denominator is 1_000_000.
        fee_protocol: u64,
        // whether the pool is locked
        unlocked: bool,
        fee_growth_global_a: u128,
        fee_growth_global_b: u128,
        seconds_per_liquidity_oracle: u128,
        seconds_per_liquidity_incentive: u128,
        position_blacklist: PositionBlackList,
        last_update_timestamp: u64,
        tick_info: SmartTable<I32, TickInfo>,
        tick_map: BitMap,
        tick_spacing: u32,
        protocol_fees: ProtocolFees,
        lp_token_refs: LPTokenRefs,
        max_liquidity_per_tick: u128,
        rewarder_manager: RewarderManager
    }

```

## Position

```
    #[resource_group_member(group = aptos_framework::object::ObjectGroup)]
    struct Info has key {
        // whether inited after migration
        initialized: bool,
        // the amount of liquidity owned by this position
        liquidity: u128,
        tick_lower: I32,
        tick_upper: I32,
        // fee growth per unit of liquidity as of the last update to liquidity or fees owed
        fee_growth_inside_a_last: u128,
        fee_growth_inside_b_last: u128,
        // the fees owed to the position owner in token0/token1
        fee_owed_a: u64,
        fee_owed_b: u64,
        token_a: Object<Metadata>,
        token_b: Object<Metadata>,
        fee_tier: u8,
        rewards: vector<PositionReward>,
    }

```

## Rewarder

```
 struct RewarderManager has store {
        rewarders: vector<Rewarder>,
        last_updated_time: u64,
        pause: bool
    }

    struct Rewarder has copy, drop, store {
        reward_store: Object<FungibleStore>,
        emissions_per_second: u64,
        emissions_per_second_max: u64,
        emissions_per_liquidity_start: u128,
        emissions_per_liquidity_latest: u128,
        user_owed: u64,
        pause: bool
    }

    /// The Position's rewarder record
    struct PositionReward has drop, copy, store {
        emissions_per_liquidity_inside: u128,
        amount_owned: u64,
    }

```

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# Features available


# Create pool

For general pool creation, use the `create_pool` function in the `pool_v3` module.

```
    public fun create_pool(
        token_a: Object<Metadata>,
        token_b: Object<Metadata>,
        fee_tier: u8,
        tick: u32,
    ): Object<LiquidityPoolV3> {
        ...
    }
```

## Function params

* `token_a`: The token A object to add liquidity
* `token_b`: The token B object to add liquidity
* `fee_tier`: fee\_iter will affect price precision, they correspond to different fee rates.
* `tick`: initiailize price for pool

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# Swap

## exact input

For exact input swap, use the `exact_input_swap_entry` function in the router`_v3` module.

```
 public entry fun exact_input_swap_entry(
        user: &signer,
        fee_tier: u8,
        amount_in: u64,
        amount_out_min: u64,
        sqrt_price_limit: u128,
        from_token: Object<Metadata>,
        to_token: Object<Metadata>,
        recipient: address,
        _deadline: u64
    ) {
    ...
    }
```

### Function params

`amount_out_min`: the threshold value of token output.&#x20;

`sqrt_price_limit`: a x64 fixed-point number, indicate price impact limit after swap

`recipient`: output token receiver

## exact output

For exact output swap, use the `exact_output_swap_entry` function in the router`_v3` module.

```
  public entry fun exact_output_swap_entry(
        user: &signer,
        fee_tier: u8,
        amount_in_max: u64,
        amount_out: u64,
        sqrt_price_limit: u128,
        from_token: Object<Metadata>,
        to_token: Object<Metadata>,
        recipient: address,
        _deadline: u64
    ) {
    ...
    }
```

### Function params

`amount_in_max`: the threshold value of token input.&#x20;

`sqrt_price_limit`: a x64 fixed-point number, indicate price impact limit after swap

`recipient`: output token receiver

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# Open position

## Function

For opening empty position , use `open_position`function in `pool_v3` module.

```
    public fun open_position(
        user: &signer,
        token_a: Object<Metadata>,
        token_b: Object<Metadata>,
        fee_tier: u8,
        tick_lower: u32,
        tick_upper: u32,
    ): Object<position_v3::Info> {
        ...
    }

```

`tick_lower`: the lower bound position's liquidity located at

`tick_upper`: the lower bound position's liquidity located at

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# Add liquidity

## Function

For adding liquidity into position , use `add_liquidity` in `pool_v3` module.

```
 public fun add_liquidity(
        user: &signer,
        position: Object<position_v3::Info>,
        liquidity_delta: u128,
        fa_a: FungibleAsset,
        fa_b: FungibleAsset
    ):(u64, u64, FungibleAsset, FungibleAsset) {
       ...
    }
```

`liquidity_delta`: liquidity amount desired to added into position

`fa_a`: token a fungible asset

`fa_b`: token b fungible asset

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# Remove liquidity

## Function

For removing liquidity into position , use remove`_liquidity` in `pool_v3` module.

```
 public fun remove_liquidity(
        user: &signer,
        position: Object<position_v3::Info>,
        liquidity_delta: u128
    ): (Option<FungibleAsset>, Option<FungibleAsset>) {
```

`liquidity_delta`: liquidity amount desired to remove out position

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# Add liquidity (zap in)

## Function

To add liquidity to a position using a single asset (a "zap in" transaction), use the `add_liquidity_single` function in the `router_v3` module.

This function simplifies liquidity provision by allowing a user to provide only one of the two assets in the pair. The contract will automatically swap a portion of the input asset for the other asset to create a balanced liquidity position.

```rust
public entry fun add_liquidity_single(
    lp: &signer,
    lp_object: Object<position_v3::Info>,
    from_a: Object<Metadata>,
    to_b: Object<Metadata>,
    amount_in: u64,
    slippage_numerators: u256,
    slippage_denominator: u256,
    threshold_numerator: u256,
    threshold_denominator: u256
) {
    // ... function body ...
}
```

### Parameters

| Parameter               | Type                        | Description                                                                                                                                              |
| ----------------------- | --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `lp`                    | `&signer`                   | The signer of the transaction, representing the liquidity provider.                                                                                      |
| `lp_object`             | `Object<position_v3::Info>` | The specific liquidity position object to which liquidity will be added.                                                                                 |
| `from_a`                | `Object<Metadata>`          | The metadata of the token you are providing.                                                                                                             |
| `to_b`                  | `Object<Metadata>`          | The metadata of the other token in the liquidity pair.                                                                                                   |
| `amount_in`             | `u64`                       | The total amount of token `from_a` you wish to provide.                                                                                                  |
| `slippage_numerators`   | `u256`                      | The numerator for calculating slippage tolerance on the internal swap. For a 1% slippage, this would be `99`.                                            |
| `slippage_denominator`  | `u256`                      | The denominator for calculating slippage tolerance, typically `100`. Defines the minimum amount of token `to_b` you are willing to accept from the swap. |
| `threshold_numerator`   | `u256`                      | The numerator for the swap ratio threshold. For example, `60`.                                                                                           |
| `threshold_denominator` | `u256`                      | The denominator for the swap ratio threshold, typically `100`. This pair of parameters sets a safety limit on the swap.                                  |

### Detailed Parameter Explanation

#### **Slippage Tolerance (`slippage_numerators` / `slippage_denominator`)**

This controls the price risk during the internal swap.

* **Example**: Setting `slippage_numerators` to `99` and `slippage_denominator` to `100` means you are setting a **1% slippage tolerance**.
* **Meaning**: The transaction will only succeed if the amount of `to_b` received from swapping `from_a` is at least 99% of the expected amount based on the current pool price. This protects you from unfavorable price movements during the transaction.

#### **Swap Ratio Threshold (`threshold_numerator` / `threshold_denominator`)**

This is a critical safety feature to prevent an unbalanced deposit due to poor market prices or low liquidity. It limits the maximum percentage of your input `amount_in` that can be swapped for the other token.

* **Example**: Setting `threshold_numerator` to `60` and `threshold_denominator` to `100` means you allow **at most 60%** of your `amount_in` to be swapped for token `to_b`.
* **Meaning**: If the contract calculates that it needs to swap more than 60% of your input asset to create a balanced position, the transaction will be aborted. This protects you from situations where the pool is heavily imbalanced, which would otherwise cause you to sell a large portion of your input asset at a poor price.


# Remove liquidity (zap out)

## Function

To withdraw liquidity from a position and receive the funds as a single asset (a "zap out" transaction), use the `remove_liquidity_single` function in the `router_v3` module.

This function simplifies the withdrawal process. It takes your liquidity position (composed of two assets), removes it from the pool, and automatically swaps one of the assets for the other, so you receive the entire value in a single, specified token.

```rust
public entry fun remove_liquidity_single(
    lp: &signer,
    lp_object: Object<position_v3::Info>,
    liquidity_delta: u128,
    to_meta: Object<Metadata>,
    slippage_numerators: u256,
    slippage_denominator: u256
) {
    // ... function body ...
}
```

### Parameters

| Parameter              | Type                        | Description                                                                                                                                                                                                             |
| ---------------------- | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `lp`                   | `&signer`                   | The signer of the transaction, representing the liquidity provider who owns the position.                                                                                                                               |
| `lp_object`            | `Object<position_v3::Info>` | The liquidity position object from which you are withdrawing.                                                                                                                                                           |
| `liquidity_delta`      | `u128`                      | The amount of liquidity units to remove. This is **not a token amount** but an abstract `u128` value representing your share in the pool. To withdraw everything, use the full `liquidity` value from your `lp_object`. |
| `to_meta`              | `Object<Metadata>`          | The metadata of the **single token** you wish to receive as output. For example, if your position is APT/USDT, you can specify the USDT metadata here to receive all your funds in USDT.                                |
| `slippage_numerators`  | `u256`                      | The numerator for calculating slippage tolerance on the internal swap required to consolidate your assets. For a 1% slippage, this would be `99`.                                                                       |
| `slippage_denominator` | `u256`                      | The denominator for calculating slippage tolerance, typically `100`. This protects you from unfavorable price changes during the internal swap.                                                                         |

### Detailed Parameter Explanation

#### **Liquidity Delta (`liquidity_delta`)**

This is the most critical parameter to understand correctly.

* **What it is**: `liquidity_delta` represents the "amount of liquidity" you want to remove, which is an abstract unit calculated by the protocol. It is **not** an amount of Token A or Token B.
* **How to get it**: You typically read the current `liquidity` value from your `lp_object` . If you want to withdraw all your funds, you would pass this full value as the `liquidity_delta`. If you only want to withdraw a portion (e.g., 50%), you would pass half of that value.

#### **Slippage Tolerance (`slippage_numerators` / `slippage_denominator`)**

This setting is crucial because the function performs an internal swap.

* **Example**: Imagine your position is in a APT/USDT pool. When you call this function and set `to_meta` to be USDT's metadata, the function does the following:
  1. Removes your proportional share of APT and USDT from the pool.
  2. Internally swaps the APT portion for USDT.
  3. Sends you the total amount of USDT.
* **Meaning**: The slippage tolerance applies to step 2. Setting `slippage_numerators` to `99` and `slippage_denominator` to `100` means you are willing to accept up to 1% negative slippage on the APT-to-USDT swap. If the price impact is worse than that, the transaction will fail, protecting your funds.


# Collect fees

## Function

```
    public fun claim_fees(
        user: &signer,
        position: Object<position_v3::Info>
    ):(FungibleAsset, FungibleAsset) {
    ...
    }
```

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# Collect rewards

## Function

```
    public fun claim_rewards(
        user: &signer,
        position: Object<position_v3::Info>
    ): vector<FungibleAsset> {
        ...
    }
```

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# via API

Hyperion using Graphql API from Alcove

> Endpoint: <https://hyperfluid-api.alcove.pro/v1/graphql>

### Get Pool Stat&#x20;

Return stat info about pool / pools (without param `$poolId`)

```
query MyQuery($poolId: String = "") {
  api {
    getPoolStat(poolId: $poolId) {
      dailyVolumeUSD     // 24 hour volume in USD
      farmAPR            // reward APR, %
      feeAPR             // fee APR, %
      feesUSD            // fee in USD
      id                 // pool id
      tvlUSD             // TVL in USD
      pool {
        currentTick      // current tick
        activeLpAmount   // active lp amount
        feeRate          // fee rata, 100 = 0.01% 
        sqrtPrice        // current sqrt price
        token1           // token1 FA address 
        token2           // token2 FA address
      }
    }
  }
}
```

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# Contract ErrorCode

<table data-header-hidden><thead><tr><th>Module</th><th>Error Code</th><th>Details</th></tr></thead><tbody><tr><td>pool_v3</td><td><p></p><pre><code>100001
</code></pre></td><td><pre><code>ETICK_NOT_EXSIT
</code></pre></td></tr><tr><td>pool_v3</td><td><pre><code>100002
</code></pre></td><td><pre><code>ESWAP_AMOUNT_INVALID
</code></pre></td></tr><tr><td>pool_v3</td><td><pre><code>100003
</code></pre></td><td><pre><code>EPOOL_LOCKED
</code></pre></td></tr><tr><td>pool_v3</td><td><pre><code>100004
</code></pre></td><td><pre><code>ESQRT_PRICE_LIMIT_UNAVAILABLE
</code></pre></td></tr><tr><td>pool_v3</td><td><pre><code>100005
</code></pre></td><td><pre><code>ELIQUIDITY_DELTA_INVALID
</code></pre></td></tr><tr><td>pool_v3</td><td><pre><code><strong>100006
</strong></code></pre></td><td><pre><code>EAMOUNT_A_INPUT_LESS
</code></pre></td></tr><tr><td>pool_v3</td><td><pre><code>100007
</code></pre></td><td><pre><code>EAMOUNT_B_INPUT_LESS
</code></pre></td></tr><tr><td>pool_v3</td><td><pre><code>100008
</code></pre></td><td><pre><code>ENOT_POSITION_OWNER
</code></pre></td></tr><tr><td>pool_v3</td><td><pre><code>100009
</code></pre></td><td><pre><code>ESWAP_ERROR
</code></pre></td></tr><tr><td>pool_v3</td><td><pre><code>100010
</code></pre></td><td><pre><code>EOFFSET_OUT_OF_BOUNDS
</code></pre></td></tr><tr><td>pool_v3</td><td><pre><code>100011
</code></pre></td><td><pre><code>EPOOL_NOT_EXISTS
</code></pre></td></tr><tr><td>pool_v3</td><td><pre><code>100012
</code></pre></td><td><pre><code>EPOSITION_BLOKED
</code></pre></td></tr><tr><td>pool_v3</td><td><pre><code>100013
</code></pre></td><td><pre><code>EINVALID_FEE_RATE
</code></pre></td></tr><tr><td>router_v3</td><td><p></p><pre><code>200001
</code></pre></td><td><pre><code>EAMOUNT_A_TOO_LESS
</code></pre></td></tr><tr><td>router_v3</td><td><p></p><pre><code>200002
</code></pre></td><td><pre><code>EAMOUNT_B_TOO_LESS
</code></pre></td></tr><tr><td>router_v3</td><td><p></p><pre><code>200003
</code></pre></td><td><pre><code>EAMOUNT_OUT_TOO_LESS
</code></pre></td></tr><tr><td>router_v3</td><td><p></p><pre><code>200004
</code></pre></td><td><pre><code>EAMOUNT_IN_TOO_MUCH
</code></pre></td></tr><tr><td>router_v3</td><td><p></p><pre><code>200005
</code></pre></td><td><pre><code>ELIQUIDITY_NOT_IN_CURRENT_REGION
</code></pre></td></tr><tr><td>router_v3</td><td><p></p><pre><code>200006
</code></pre></td><td><pre><code>EMETADATA_NOT_MATCHED
</code></pre></td></tr><tr><td>router_v3</td><td><p></p><pre><code>200007
</code></pre></td><td><pre><code>EOUT_TOKEN_NOT_MATCHED
</code></pre></td></tr><tr><td>router_v3</td><td><p></p><pre><code>200008
</code></pre></td><td><pre><code><strong>EOUT_AMOUNT_TOO_LESS
</strong></code></pre></td></tr><tr><td>router_v3</td><td><p></p><pre><code>200009
</code></pre></td><td><pre><code>EIN_TOKEN_NOT_MATCHED
</code></pre></td></tr><tr><td>position_v3</td><td><p></p><pre><code>300001
</code></pre></td><td><p></p><pre><code>ENOT_POSITION_OWNER
</code></pre></td></tr><tr><td>position_v3</td><td><p></p><pre><code><strong>300002
</strong></code></pre></td><td><p></p><pre><code>EPOSITION_NOT_INITIALIZED
</code></pre></td></tr><tr><td>position_v3</td><td><p></p><pre><code>300003
</code></pre></td><td><p></p><pre><code>EPOSITION_NOT_EMPTY
</code></pre></td></tr><tr><td>tick_math</td><td><p></p><pre><code>500001
</code></pre></td><td><p></p><pre><code>ETICK_LOWER_BIGGER_THAN_UPPER
</code></pre></td></tr><tr><td>tick_math</td><td><p></p><pre><code>500002
</code></pre></td><td><p></p><pre><code>ETICK_LOWER_BEYOND_MINIMUM
</code></pre></td></tr><tr><td>tick_math</td><td><p></p><pre><code>500003
</code></pre></td><td><p></p><pre><code>ETICK_UPPER_BEYOND_MAXIMUM
</code></pre></td></tr><tr><td>tick_math</td><td><p></p><pre><code>500004
</code></pre></td><td><p></p><pre><code>EINVALID_TICK
</code></pre></td></tr><tr><td>tick_math</td><td><pre><code>500004
</code></pre></td><td><p></p><pre><code>EINVALID_SQRT_PRICE
</code></pre></td></tr><tr><td>tick_bitmap</td><td><p></p><pre><code>600001
</code></pre></td><td><p></p><pre><code>ETICK_NOT_SUIT_SPACING
</code></pre></td></tr><tr><td>tick_bitmap</td><td><p></p><pre><code>600002
</code></pre></td><td><p></p><pre><code>EMOD_ERROR
</code></pre></td></tr><tr><td>utils.move</td><td><p></p><pre><code>70001
</code></pre></td><td><p></p><pre><code>EIDENTICAL_TOKENS
</code></pre></td></tr><tr><td>rewarder</td><td><p></p><pre><code>1100001
</code></pre></td><td><p></p><pre><code>EINSUFICIEENT_BALANCE
</code></pre></td></tr><tr><td>rewarder</td><td><p></p><pre><code>1100002
</code></pre></td><td><p></p><pre><code>EINVALID_EMISSION_RATE
</code></pre></td></tr><tr><td>rewarder</td><td><p></p><pre><code>1100003
</code></pre></td><td><p></p><pre><code>EREWARDS_LENGTH_ERR
</code></pre></td></tr><tr><td>rewarder</td><td><p></p><pre><code>1100004
</code></pre></td><td><p></p><pre><code>EREWARD_TOO_LESS_TO_REMOVE
</code></pre></td></tr><tr><td>rewarder</td><td><p></p><pre><code>1100005
</code></pre></td><td><p></p><pre><code>EREWARD_PAUSED
</code></pre></td></tr></tbody></table>

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# Audits

## Hyperion Dex

### MoveBit <a href="#jita" id="jita"></a>

Website: <https://movebit.xyz/>

[Report Link](https://github.com/Hyperionxyz/audits/blob/main/Hyperion%20Audit%20Report.pdf)

## Hyperion Vault

### ExVul

Website: <https://exvul.com/>

[Report Link](https://github.com/Hyperionxyz/audits/blob/main/ExVul%20Smart%20Contract%20Audit%20Report%20for%20Hyperionxyz%20Vaults.pdf)

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# Liquidity Withdrawal Rate Limits

### Overview

Hyperion DEX implements withdrawal rate limits and the Fridge mechanism as a core security measure to protect user assets and platform liquidity.

These mechanisms are primarily designed to mitigate the risk of hacker attacks or other malicious behaviors that could lead to abnormal, large-scale, rapid liquidity withdrawals, which may otherwise threaten the stability of liquidity pools.

By introducing controlled withdrawal limits and a safety buffer mechanism, Hyperion ensures that user funds remain secure, recoverable, and protected, even under extreme or adversarial conditions.

### What is Rate Limiting?

Rate limiting is a protective mechanism that restricts the amount of assets that can be withdrawn from liquidity pools within a specific time period. This helps to:

* Prevent from the market manipulation
* Protect liquidity providers
* Maintain market stability
* Prevent malicious attacks

#### How Rate Limiting Works

Hyperion uses a USD-denominated quota system.

All limited assets are converted into their USD-equivalent value at the time of withdrawal, and the withdrawal amount consumes a USD-based quota

Key characteristics:

1. **USD-Based Accounting**\
   Withdrawals are measured in USD value, not by individual token amounts
2. **Shared Asset Scope**\
   Supported assets, including APT, goAPT, kAPT, amAPT, wBTC, xBTC, aBTC, RION, USDT, USDC sUSDe and USD1, all draw from the same USD-denominated limits
3. **Rolling Window**\
   Limits are calculated over a rolling 24-hour window
4. **Automatic and Manual Recovery**\
   Withdrawal quotas recover gradually over time as the rolling window advances or, the quotas restore a portion immediately by users adding liquidity (depositing LP).

#### Types of Withdrawal Rate Limits

**1. Global USD-Denominated Withdrawal Limit**

* **Scope**:\
  APT, goAPT, kAPT, amAPT, wBTC, xBTC, aBTC, RION, USDT, USDC, sUSDe, USD1
* **Cycle**:\
  24-hour rolling window
* **Limit**:\
  All withdrawals of the above assets—converted to USD—share a **unified platform-wide withdrawal quota**.
* **Effect**:\
  When the global USD-denominated withdrawal limit is reached:
  * Liquidity removal and position-closing operations from **all users** are affected
  * Withdrawn funds are routed into the **Fridge** instead of being immediately received
* **Note**:\
  The Threshold is dynamically adjusted based on platform conditions.

**2. Personal USD-Denominated Withdrawal Limit**&#x20;

* **Scope**:\
  APT, goAPT, kAPT, amAPT, wBTC, xBTC, aBTC, RION, USDT, USDC, sUSEe, USD1
* **Cycle**:\
  24-hour rolling window
* **Limit**:
  * $10,000 USD by default
  * $100,000 USD after activating Hyperauth
* **Effect**:\
  When a personal USD-denominated withdrawal limit is reached:
  * The user must wait for the personal quota to recover, or deposit LP to restore the quota
  * If user insist on withdrawing the funds, withdrawn funds are routed into the **Fridge** instead of being immediately received
* **Interface Reminder**:\
  The interface displays a warning when a withdrawal approaches the personal limit.
* **Note**:\
  The Threshold is dynamically adjusted based on platform conditions.

### What is the Fridge?

The Fridge is a safety mechanism that temporarily stores withdrawn funds when the global USD-denominated withdrawal limit has been reached.

It ensures that funds remain secure and fully claimable once limits recover.

#### How the Fridge Works

1. **Trigger Condition**\
   The Fridge is triggered when the withdrawal limit is reached
2. **Automatic Storage**\
   Affected withdrawal amounts are automatically placed into the Fridge
3. **Freeze Period**\
   Funds are frozen for 24 hours by default.
4. **Claiming Funds**\
   After the freeze period ends, funds can be claimed at any time

> Personal USD-denominated withdrawal limits do not trigger the Fridge.

#### Claiming Funds from the Fridge

**Method 1: Claim All Available Funds**

The simplest way is to claim all unfrozen funds at once:

```
Click the "Claim All Available" button
```

**Method 2: Claim Specific Box**

If you only want to claim specific funds:

```
1. View your fridge box list
2. Find boxes that are unfrozen (showing "Claimable" status)
3. Click the "Claim" button for that box
```

#### Viewing Fridge Status

You can always check:

* **All Fridge Boxes**: Shows detailed information for each box
* **Release Time**: When each box can be claimed
* **Token Information**: Type and amount of frozen tokens
* **Associated Info**: Related pool and position IDs

### Frequently Asked Questions

#### 1. Why was my withdrawal frozen?

Your withdrawal was frozen because it exceeded your Personal Liquidity Withdrawal Limit.

When this limit is reached, a temporary withdrawal freeze is automatically triggered as a security measure.

Please wait 24 hours. After the cooldown period ends, your funds will be automatically unlocked and credited back to your account. No further action is required from your side.

#### 2. How can I avoid being frozen?

* **Balance Operations**: Adding liquidity helps restore personal limits
* **Activate Hyperauth:** After activating Hyperauth, your wallet address will get a far larger personal withdrawal limit of $500,000 USD

#### 3. Can the freeze period be shortened?

* Default freeze period is 24 hours
* In emergencies, please open a ticket and tag admins in Hyperion [Discord](https://discord.com/invite/MYex8tHXtN)

#### 4. Are my funds safe in the fridge?

Yes, absolutely safe:

* Funds are stored in smart contracts
* Only you can claim after unfreezing
* All operations are logged with events
* Administrators can only intervene in emergencies

#### 5. Do withdrawal limits affect all operations?

No, withdrawal limits only affect liquidity removal operations:

* **Not affected**: Trading (Swap), adding liquidity
* **Affected**: Removing liquidity, closing positions

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# Hyperauth (Passkey)

### What is Hyperauth?

HyperAuth lets you link a passkey to your Hyperion account, acting as a second factor for sensitive operations.

When performing high-risk actions like:&#x20;

\- Removing LPs, or&#x20;

\- Claiming frozen or locked assets,

HyperAuth ensures that only you can authorize those transactions — even if someone else has your seed phrase or private key.

### How It Works&#x20;

Hyperauth — it’s fully on-chain.When you set up HyperAuth:

* Your encrypted public key is stored on Aptos.
* Your private key for the passkey remains entirely local to your device.

Each time you attempt a protected action, Hyperion’s smart contract requests verification through your registered passkey. Only after successful verification will the transaction be signed and executed — no servers, no intermediaries, no trust assumptions.Everything happens on-chain, transparently and securely.

### Why It Matters

HyperAuth strengthens the foundation of asset security in DeFi:

On-Chain 2FA — Adds an additional protection layer to critical actions, without compromising decentralization.&#x20;

Self-Sovereign Control — Your passkey stays local; only a public hash is stored on-chain.&#x20;

Protection Against Key Theft — Even if someone gets your wallet key, they can’t access your LPs or frozen assets without your second-factor passkey.

### Guide

Before you start please make sure

* You are operating on your PC (note that Hyperauth is currently only supported by browser wallet extension - it's not available on any mobile device)
* You have few APT in your wallet as gas

1. Click your personal profile **on your PC**

<figure><img src="/files/vQqR3bbGYnn8SB3amYdb" alt=""><figcaption></figcaption></figure>

2. Click the "Shield: icon

<figure><img src="/files/q0ETxo6RJa2lpIUFKPIX" alt=""><figcaption></figcaption></figure>

2. Click "Create Your First Passkey"

<figure><img src="/files/kskpO4X0Ox9DZPotsl3W" alt=""><figcaption></figcaption></figure>

4. Click "Continue"

<figure><img src="/files/5oe2ljFHBBcUI4TOLyCG" alt=""><figcaption></figcaption></figure>

5. Follow the next steps to complete the Hyperauth Creation

### FAQ

#### Since Passkey is not supported on mobile devices, how can I withdraw large amount of liquidity on mobile?

If you want to withdraw in a short period of time an amount larger than $200K USD worth of asset on mobile & without Hyperauth, please directly withdraw.

When the limit is reached, a temporary withdrawal freeze is automatically triggered as a security measure.

Please wait 24 hours. After the cooldown period ends, your funds will be automatically unlocked and credited back to your account. No further action is required from your side.

#### Error "PasskeyError: This device of web browser does not support passkey. Please use a different device or web browser"

First please make sure you are activating Hyperauth from a wallet extension on PC that supports Aptos.

Then please check the following two option in [Google Password Manager](chrome://password-manager/settings)

#### Error "Can't reach Google Password Manager: Can't reach Google Password Manager. Try again in a few minutes"

Please check your internet connection status. If you are using a VPN, please turn it off or switch a node.

#### If my Passkey storage device or Google Account is stolen, are my funds still safe?

Yes. When performing high-risk actions like:&#x20;

\- Removing LPs, or&#x20;

\- Claiming frozen or locked assets,

The operator needs to have both of your wallet private key and Passkey.&#x20;

#### What if I lost my passkey?

Please contact Hyperion dev team for support.&#x20;

Or, you can create another passkey by clicking "Add New Passkey" under another device or google account. If you lost one, you can delete it by another

<figure><img src="/files/xFb8Djjtsd7ZAphqFPyT" alt=""><figcaption></figcaption></figure>


# Passkey Recovery Guide

To enhance the security and accessibility of your Hyperion wallet, we have introduced a new Passkey Recovery Code feature. This guide explains what it is, how it works, and what you need to do to take

### What is the Recovery Code?

The Recovery Code is a unique, one-time code generated to provide a master reset capability for your passkeys. Its primary purpose is to help you regain access to your wallet if you lose all the devices where your passkeys are stored.

If you lose access to all your passkeys, you can use this Recovery Code to **delete all passkeys** associated with your wallet. This action allows you to set up a new passkey and regain control over your wallet and the assets within it, such as your LP positions.

**IMPORTANT:** The Recovery Code is a powerful tool. Treat it with the same level of security as your wallet's private key. Store it in a secure, offline location (like a password manager or a physical safe) where only you can access it.

### How It Works: For New Users

If you are a new user or are creating a passkey for the first time, the process is straightforward:

1. When you create your **very first passkey** for your Hyperion wallet, the system will automatically generate and display your unique Recovery Code.
2. You **must** save this code immediately. You will not be shown this code again.
3. If you ever lose all your passkey-enabled devices, you can navigate to the passkey management page and select the option to recover access using your Recovery Code. This will remove all existing passkeys and allow you to start fresh.

### Attention: For Existing Passkey Users

This Recovery Code feature was introduced recently. If you created your passkey(s) **before this update**, your account **does not have a Recovery Code** associated with it.This means that if you currently lose access to all your devices with existing passkeys, you will be unable to use this new recovery feature. To ensure you are protected, we strongly recommend you take one of the following actions:

#### Recommended Actions for Existing Users

You have two options to secure your account against device loss.

**Option 1: Create a Backup Passkey (Recommended)**

This is the simplest and a highly effective security practice. By creating a second passkey and storing it on a different, trusted device (e.g., a tablet, a secondary phone, or a hardware security key), you create redundancy.

* **How it helps:** If you lose your primary device, you can simply use your backup passkey from the second device to access your wallet and delete the passkey from the lost device.

**Option 2: Re-create Your Passkey to Generate a Recovery Code**

If you wish to utilize the new Recovery Code feature, you will need to reset your current passkey setup.

* **How to do it:**
  1. Go to your wallet's security settings.
  2. **Delete** your existing passkey(s).
  3. **Create a new passkey.** Since this will now be the "first" passkey created after the feature update, the system will generate a new Recovery Code for you.
  4. **Crucially, save this new Recovery Code in a secure location.**

**Warning:** Before choosing this option, ensure you have full access to your wallet and can perform the action of deleting your current passkey. If you have only one passkey and you are unsure about the process, we recommend starting with Option 1 to create a backup first.By taking one of these steps, you can ensure that a lost device doesn't mean lost access to your valuable assets. We encourage all our existing users to review their passkey setup and take action today.


# Brand Asset

{% file src="/files/6Uk8fOP45NtAodUTtxUy" %}

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# Terms of Service

Last Updated: February 17, 2025

These Terms of Service (the “Agreement”) explains the terms and conditions by which you may access and use “[Website](https://hyperion.xyz/)” and any subdomains associated with the Website. You must read this Agreement carefully as it governs your use of the Website. By accessing or using the Website, you signify that you have read, understand, and agree to be bound by this Agreement in its entirety. If you do not agree, you are not authorized to access or use the Website and should not use the Website.<br>

**NOTICE: This Agreement contains important information which impact your rights as to how disputes are resolved. The Website is only available to you — and you should only access the Website — if you agree completely with these terms.**

**Introduction**

The Website provides access to (a) a decentralized protocol on various public blockchains that allow users to trade certain compatible virtual assets (the “Protocol”), among other services. The Website is one, but not the exclusive, means of accessing the Protocol.

To access the Website, you must use a non-custodial wallet software, which allows you to interact with public blockchains. Your relationship with that non-custodial wallet provider is governed by the applicable terms of service of that third party, not this Agreement. Wallets are not operated by, maintained by, or affiliated with us, and we do not have custody or control over the contents of your wallet and have no ability to retrieve or transfer its contents. By connecting your wallet to our Website, you agree to be bound by this Agreement and all of the terms incorporated herein by reference.

**Modification of this Agreement**

We reserve the right, in our sole discretion, to modify this Agreement from time to time. If we make any material modifications, we will notify you by updating the date at the top of the Agreement and by maintaining a current version of the Agreement at [Terms of Service](https://docs.hyperion.xyz/legal-and-compliance/terms-of-service). All modifications will be effective when they are posted, and your continued accessing or use of the Website will serve as confirmation of your acceptance of those modifications. If you do not agree with any modifications to this Agreement, you must immediately stop accessing and using the Website.

**Description of Services provided through the Website**

The Website provides a web or mobile-based means of accessing the Protocol.

**Website for accessing Protocol**

The Website is distinct from the Protocol and is one, but not the exclusive, means of accessing the Protocol. The Protocol comprises of open-source or source-available self-executing smart contracts that are deployed on various public blockchains. Hyperion does not control or operate any version of the Protocol on any blockchain network. By using the Website, you understand that you are not buying or selling virtual assets from us and that we do not operate any liquidity pools on the Protocol or control trade execution on the Protocol. When traders pay fees for trades, those fees accrue to liquidity providers for the Protocol. As a general matter, the Hyperion team is not a liquidity provider into Protocol liquidity pools and liquidity providers are independent third parties.

Not every features of the Website and/or the Protocol is addressed in these Terms. Additional features are subject to other agreements specific to those as published by Hyperion from time to time.

**Eligibility**

To access or use the Website, you must be able to form a legally binding contract with us. Accordingly, you represent that you are at least the age of majority in your jurisdiction (e.g., 18 years old in Hong Kong) and have the full right, power, and authority to enter into and comply with the terms and conditions of this Agreement on behalf of yourself and any company or legal entity for which you may access or use the Website.

You shall not, (and, if you are an entity, the entity is not owned or controlled by any other person who is), acting, directly or indirectly, on behalf of any other person who is, located, ordinarily resident, organized, established, or domiciled in the United States, People’s Republic of China (excluding the Hong Kong Special Administrative Region, Macau Special Administrative Region, and Taiwan), or any country where use of Website and/or the Protocol or related activities is illegal, prohibited, or requires a permit or license. You shall not (and, if you are an entity, the entity is not owned or controlled by any other person who is) acting, directly or indirectly, on behalf of any other person who is in contravention of any applicable laws and regulations, including anti-money laundering regulations or conventions; a person designated as a terrorist or a terrorist associates or a subject of economic or trade sanctions; identified on, or operationally based or domiciled in a country or territory that is included in, any list of prohibited parties under any law or by any nation or government, state or other political subdivision thereof, any entity exercising legislative, judicial or administrative functions of or pertaining to government such as the sanctions lists maintained by the United Kingdom (as are extended to the Cayman Islands by statutory instrument), United Nations (whether through the Security Council, or otherwise), the U.S. government (including the U.S. Treasury Department's Specially Designated Nationals list and Foreign Sanctions Evaders list), or the European Union (EU) or its member states". Finally, you represent that your access and use of the Website will fully comply with all applicable laws and regulations, and that you will not access or use the Website to conduct, promote, or otherwise facilitate any illegal activity.

**Intellectual Property Rights**

Unless expressly stated otherwise in this Terms of Service, Hyperion owns all intellectual property and other rights subsisting in the Website and its contents, including (but not limited to) software, text, images, trademarks, service marks, copyrights, patents, designs, and its “look and feel.”. Subject to the terms of this Agreement, we grant you a limited, revocable, non-exclusive, non-sublicensable, non-transferable licence to access and use our Products solely in accordance with this Agreement. You agree that you will not use, modify, distribute, tamper with, reverse engineer, dissemble, or decompile any of our Products for any purpose other than as expressly permitted pursuant to this Agreement. Except as set forth in this Agreement, we grant you no rights to any of our Products, including any intellectual property rights.

Unlike the Website, the Protocol the comprised entirely of open-source or source-available software running on public blockchains. You understand and acknowledge that the Protocol is not a Product and we do not control the Protocol.

**Additional Rights**

We reserve the following rights, which do not constitute obligations of ours: (a) with or without notice to you, to modify, substitute, eliminate or add to the Website; (b) to review, modify, filter, disable, delete and remove any and all content and information from the Website; and (c) to cooperate with any law enforcement, court or government investigation or order or third party requesting or directing that we disclose information or content or information that you provide.

**Prohibited Activity**

You agree not to engage in, or attempt to engage in, or advocate, encourage or assist any third party in carrying out any of the following categories of prohibited activity in relation to your access and use of the Website:

**Intellectual Property Infringement.**

Activity that infringes on or violates any copyright, trademark, service mark, patent, right of publicity, right of privacy, or other proprietary or intellectual property rights under the law.

**Cyberattack**.

Activity that seeks to interfere with or compromise the integrity, security, or proper functioning of any computer, server, network, personal device, or other information technology system, including (but not limited to) the deployment of viruses and denial of service attacks.

**Fraud and Misrepresentation.**

Activity that seeks to defraud us or any other person or entity, including (but not limited to) providing any false, inaccurate, or misleading information in order to unlawfully obtain the property of another.

**Market Manipulation.**

Activity that violates any applicable law, rule, or regulation concerning the integrity of trading markets, including (but not limited to) the manipulative tactics commonly known as “rug pulls”, pumping and dumping, and wash trading.

**Securities and Derivatives Violations.**

Activity that violates any applicable law, rule, or regulation concerning the trading of securities or derivatives, including (but not limited to) the unregistered offering of securities and the offering of leveraged and margined commodity products to retail customers in the United States.

**Sale of Illegally Obtained Property.**

Buying, selling, or transferring of stolen items, fraudulently obtained items, items taken without authorization, and/or any other illegally obtained items.

**Data Mining or Scraping.**

Activity that involves data mining, robots, scraping, or similar data gathering or extraction methods of content or information from the Website.

**Objectionable Content.**

Activity that involves soliciting information from anyone under the age of 18 or that is otherwise harmful, threatening, abusive, harassing, tortious, excessively violent, defamatory, vulgar, obscene, pornographic, libelous, invasive of another’s privacy, hateful, discriminatory, or otherwise objectionable.

**Any Other Unlawful Conduct.**

Activity that violates any applicable law or another relevant jurisdiction.

**Launchpads**

Notwithstanding our restrictions on eligibility of users under “Eligibility”, in respect of your participation in launches, You represent that you are not located, incorporated or a citizen or resident of the following countries or regions:

the United States of America and its territories (American Samoa, Guam, Puerto Rico, the Northern Mariana Islands, and the U.S. Virgin Islands), People’s Republic of China, Belarus, Bermuda, Burundi, Central African Republic, Cuba, Democratic Republic of Congo, Eritrea, Guinea-Bissau, Iran, Libya, Mali, New Zealand, North Korea, Palestine, Republic of Seychelles, Somalia, South Sudan, Sudan, Syria, Western Sahara, Yemen, Crimea and Sevastopol, Zimbabwe or any other state, country, or jurisdiction where participation in this launch would be illegal according to applicable law.

**Not Registered with the SEC or Any Other Agency**

We are not registered with the U.S. Securities and Exchange Commission as a national securities exchange or in any other capacity. You understand and acknowledge that we do not offer to sell or solicit offers to buy any securities on the Website or broker trading orders on your behalf. We also do not facilitate the execution or settlement of your trades, which occur entirely on the public distributed blockchains like Ethereum. As a result, we do not (and cannot) guarantee market best pricing or best execution through the Website.

**Non-Solicitation; No Investment Advice**

You agree and understand that: (a) all trades you submit through the Website are considered unsolicited, which means that they are solely initiated by you; (b) you have not received any investment advice from us in connection with any trades; and (c) we do not conduct a suitability review of any trades you submit.

We may provide information about tokens on the Website sourced from third-party data partners through features such as rarity scores, token explorer or token lists. We may also provide warning labels for certain tokens. The provision of informational materials does not make trades in those tokens solicited; we are not attempting to induce you to make any purchase as a result of information provided. All such information provided by the Website is for informational purposes only and should not be construed as investment advice or a recommendation that a particular token is a safe or sound investment. You should not take, or refrain from taking, any action based on any information contained on the Website. By providing token information for your convenience, we do not make any investment recommendations to you or opine on the merits of any transaction or opportunity. You alone are responsible for determining whether any investment, investment strategy or related transaction is appropriate for you based on your personal investment objectives, financial circumstances, and risk tolerance.

**Non-Custodial and No Fiduciary Duties**

The Website is a purely non-custodial application, meaning we do not ever have custody, possession, or control of your virtual assets at any time. It further means you are solely responsible for the custody of the cryptographic private keys to the digital asset wallets you hold and you should never share your wallet credentials or seed phrase with anyone. We accept no responsibility for, or liability to you, in connection with your use of a wallet and make no representations or warranties regarding how the Website will operate with any specific wallet. Likewise, you are solely responsible for any associated wallet and we are not liable for any acts or omissions by you in connection with or as a result of your wallet being compromised.

This Agreement is not intended to, and does not, create or impose any fiduciary duties on us. To the fullest extent permitted by law, you acknowledge and agree that we owe no fiduciary duties or liabilities to you or any other party, and that to the extent any such duties or liabilities may exist at law or in equity, those duties and liabilities are hereby irrevocably disclaimed, waived, and eliminated. You further agree that the only duties and obligations that we owe you are those set out expressly in this Agreement.

**Compliance and Tax Obligations**

The Website may not be available or appropriate for use in your jurisdiction. By accessing or using the Website, you agree that you are solely and entirely responsible for compliance with all laws and regulations that may apply to you.

Specifically, your use of the Website or the Protocol may result in various tax consequences, such as income or capital gains tax, value-added tax, goods and services tax, or sales tax in certain jurisdictions. It is your responsibility to determine whether taxes apply to any transactions you initiate or receive and, if so, to report and/or remit the correct tax to the appropriate tax authority.

**Gas Fees**

Blockchain transactions require the payment of transaction fees to the appropriate network (“Gas Fees”). These fees are not levied directly by us, but rather determined by your use of the Protocol and the underlying blockchain communities at large. You understand that we have no control over Gas Fees, (including without limitation, their applicability, payment, amounts, transmission, intended operation and effectiveness) whether related to your use of the Protocol or otherwise. Except as otherwise expressly set forth in the terms of another offer by Hyperion, you will be solely responsible to pay the Gas Fees for any transaction that you initiate. You agree that in no event will Hyperion be responsible to you or any other party of the payment, repayment, refund, disbursement, indemnity, or for any other aspect of your use or transmission of Gas Fees.

**Assumption of Risk**

BY ACCESSING AND USING THE WEBSITE, YOU REPRESENT THAT YOU ARE FINANCIALLY AND TECHNICALLY SOPHISTICATED ENOUGH TO UNDERSTAND THE INHERENT RISKS ASSOCIATED WITH USING CRYPTOGRAPHIC AND BLOCKCHAIN-BASED SYSTEMS, AND THAT YOU HAVE A WORKING KNOWLEDGE OF THE USAGE AND INTRICACIES OF VIRTUAL ASSETS SUCH AS ETHER (ETH), SO-CALLED STABLECOINS, AND OTHER DIGITAL TOKENS SUCH AS THOSE FOLLOWING THE ETHEREUM TOKEN STANDARD (ERC-20), OR STANDARDS OF ANY OTHER DIGITAL TOKENS WHICH ARE TRANSACTED ON HYPERION.

In particular, you understand and agree that your access and use of our Website are subject to certain inherent risks, which without limitations, include:

**High Volatility.**

The markets for these virtual assets are nascent and highly volatile due to risk factors including (but not limited to) adoption, speculation, technology, security, and regulation. You understand that anyone can create a token, including fake versions of existing tokens and tokens that falsely claim to represent projects, and acknowledge and accept the risk that you may mistakenly trade those or other tokens. So-called stablecoins may not be as stable as they purport to be, may not be fully or adequately collateralized, and may be subject to panics and runs. You further acknowledge and accept the risk of selecting to trade in Expert Modes, which can expose you to potentially significant price slippage and higher costs. You are responsible for any losses or missed opportunities resulting from slippage, regardless of your circumstances. You are therefore reminded to review the slippage tolerance level before proceeding with a trade. If you act as a liquidity provider to the Protocol through the Website, you understand that your virtual assets may lose some or all of their value while they are supplied to the Protocol through the Website due to the fluctuation of prices of tokens in a trading pair or liquidity pool. Further, You acknowledge and accept that the cost and speed of transacting with cryptographic and blockchain-based systems such as Ethereum are variable and may increase dramatically at any time.

**Regulatory Uncertainties.**

New or changes in the regulatory regime in different jurisdictions may materially and adversely affect your use of the Website and/or the Protocol, the transfer and the value of the virtual assets available on Hyperion.

**Malfunctions and errors. The transactions are supported by one or more smart contracts on the blockchain. Smart contracts may be subject to malfunctions, errors, including but not limited to programming errors, hacking, theft, or other technological difficulties which may prevent access to or use of your virtual assets.**

**Automatic Transactions and Accidental Transfers. You understand that smart contract transactions automatically execute and settle, and that blockchain-based transactions are irreversible when confirmed. Inputting an incorrect wallet address, wrong chain, leakage of private keys may result in an irrecoverable loss of your virtual assets.**

**Fraudulent Transactions.**

Transactions on the Protocol may be susceptible to mining attacks, hacking, security weakness, fraud, counterfeiting, cyberattacks and other technological difficulties that are beyond our control. The occurrence of such events may result in an irreversible loss of the virtual assets.

Finally, you understand that we do not create, own, or operate cross-chain bridges and we do not make any representation or warranty about the safety or soundness of any cross-chain bridge, including its use for Hyperion governance.

The list of risks set out above is not intended to be comprehensive or exhaustive. In summary, you acknowledge that we are not responsible for any of these variables or risks, do not own or control the Protocol, and cannot be held liable for any resulting losses that you experience while accessing or using the Website. Accordingly, you understand and agree to assume full responsibility for all of the risks of accessing and using the Website to interact with the Protocol. You acknowledge that you should conduct your own due diligence and obtain sufficient independent information to make an informed decision before using our Website or the Protocol.

**Third-Party Resources and Promotions**

The Website may contain references or links to third-party resources, including (but not limited to) information, materials, products, or services, that we do not own or control. In addition, third parties may offer promotions related to your access and use of the Website. We do not approve, monitor, endorse, warrant or assume any responsibility for any such resources or promotions and does not guarantee the accuracy of the information contained therein. If you access any such resources or participate in any such promotions, you do so at your own risk, and you understand that this Agreement does not apply to your dealings or relationships with any third parties. You expressly relieve us of any and all liability arising from your use of any such resources or participation in any such promotions. Unless expressed otherwise, we and such third party resources are independent legal entities, and this Agreement shall not constate any form of agency, partnership or cooperative relationship between the parties. We and such third party resources shall be separately responsible for their respective claims, debts and disputes arising from the performance of their respective contracts and agreement.

**Release of Claims**

You expressly agree that you assume all risks in connection with your access and use of the Website. You further expressly waive and release us from any and all liability, claims, causes of action, or damages arising from or in any way relating to your use of the Website.

**Indemnity**

You agree to hold harmless, release, defend, and indemnify us and our officers, directors, employees, contractors, agents, affiliates, and subsidiaries from and against all claims, damages, obligations, losses, liabilities, costs, and expenses arising from: (a) your access and use of the Website; (b) your violation of any term or condition of this Agreement, the right of any third party, or any other applicable law, rule, or regulation; and (c) any other party's access and use of the Website with your assistance or using any device or account that you own or control.

**No Warranties**

The Website is provided on an "AS IS" and "AS AVAILABLE" basis. TO THE FULLEST EXTENT PERMITTED BY LAW, WE DISCLAIM ANY REPRESENTATIONS AND WARRANTIES OF ANY KIND, WHETHER EXPRESS, IMPLIED, OR STATUTORY, INCLUDING (BUT NOT LIMITED TO) THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. You acknowledge and agree that your use of the Website is at your own risk. We do not represent or warrant that access to the Website will be continuous, uninterrupted, timely, or secure; that the information contained on the Website will be accurate, reliable, complete, or current; or that the Website will be free from errors, defects, viruses, or other harmful elements. No advice, information, or statement that we make should be treated as creating any warranty concerning the Website. We do not endorse, guarantee, or assume responsibility for any advertisements, offers, or statements made by third parties concerning the Website.

Similarly, the Protocol is provided "AS IS", at your own risk, and without warranties of any kind. Although we contributed to the initial code for the Protocol, we do not provide, own, or control or conduct any oversight over the virtual assets, the blockchain network, or the Protocol, which is run autonomously without any headcount by smart contracts deployed on various blockchains. Upgrades and modifications to the Protocol are generally managed in a community-driven way by holders of our governance token (vePOT). No developer or entity involved in creating the Protocol will be liable for any claims or damages whatsoever associated with your use, inability to use, or your interaction with other users of, the Protocol, including any direct, indirect, incidental, special, exemplary, punitive or consequential damages, or loss of profits, cryptocurrencies, tokens, or anything else of value. We do not endorse, guarantee, or assume responsibility for any advertisements, offers, or statements made by third parties concerning the Website.

**Limitation of Liability**

UNDER NO CIRCUMSTANCES SHALL WE OR ANY OF OUR OFFICERS, DIRECTORS, EMPLOYEES, CONTRACTORS, AGENTS, AFFILIATES, OR SUBSIDIARIES BE LIABLE TO YOU FOR ANY INDIRECT, PUNITIVE, INCIDENTAL, SPECIAL, CONSEQUENTIAL, OR EXEMPLARY DAMAGES, INCLUDING (BUT NOT LIMITED TO) DAMAGES FOR LOSS OF PROFITS, GOODWILL, USE, DATA, OR OTHER INTANGIBLE PROPERTY, ARISING OUT OF OR RELATING TO ANY ACCESS OR USE OF THE WEBSITE, NOR WILL WE BE RESPONSIBLE FOR ANY DAMAGE, LOSS, OR INJURY RESULTING FROM HACKING, TAMPERING, OR OTHER UNAUTHORIZED ACCESS OR USE OF THE WEBSITE OR THE INFORMATION CONTAINED WITHIN IT. WE ASSUME NO LIABILITY OR RESPONSIBILITY FOR ANY: (A) ERRORS, MISTAKES, OR INACCURACIES OF CONTENT; (B) FAILUTRE, EXPLOIT, OR VULNERABILITY OF THE WEBSITE OR THE PROTOCOL, YOUR WEB3 UTILITIES, OR THE UNDERLYING BLOCKCHAIN(S) OR RELATED BLOCKCHAIN FUNCTIONALITIES; (C) PERSONAL INJURY OR PROPERTY DAMAGE, OF ANY NATURE WHATSOEVER, RESULTING FROM ANY ACCESS OR USE OF THE WEBSITE; (D) UNAUTHORIZED ACCESS OR USE OF ANY SECURE SERVER OR DATABASE IN OUR CONTROL, OR THE USE OF ANY INFORMATION OR DATA STORED THEREIN; (E) INTERRUPTION OR CESSATION OF FUNCTION RELATED TO THE WEBSITE; (F) BUGS, VIRUSES, TROJAN HORSES, OR THE LIKE THAT MAY BE TRANSMITTED TO OR THROUGH THE WEBSITE; (G) ERRORS OR OMISSIONS IN, OR LOSS OR DAMAGE INCURRED AS A RESULT OF THE USE OF, ANY CONTENT MADE AVAILABLE THROUGH THE WEBSITE; AND (H) THE DEFAMATORY, OFFENSIVE, OR ILLEGAL CONDUCT OF ANY THIRD PARTY.

THE FOREGOING DOES NOT AFFECT ANY LIABILITY THAT CANNOT BE EXCLUDED OR LIMITED UNDER APPLICABLE LAW.

**No Insurance**

You agree that your crypto wallet(s) do not constitute as a checking or savings accounts. We do not provide any kinds of insurance to you against any type of loss, including without limitation, losses due to decrease in value of your virtual assets, assets lost due to a cybersecurity failure, or from your or other individuals’ errors or malfeasance. Most jurisdictions do not regard virtual assets as a legal tender, and most virtual assets are not backed by any government. Neither your virtual assets balance nor any of your transactions via the Protocol are covered by the Hong Kong Deposit Protection Scheme or other similar protections.

**Governing Law and Dispute Resolution**

You agree that the laws of Hong Kong, without regard to principles of conflict of laws, govern this Agreement and any Dispute between you and us. You further agree that the Website shall be deemed to be based solely in Hong Kong, and that although the Website may be available in other jurisdictions, its availability does not give rise to general or specific personal jurisdiction in any forum outside Hong Kong. Any dispute, controversy, difference or claim arising out of or relating to this contract, including the existence, validity, interpretation, performance, breach or termination thereof or any dispute regarding non- contractual obligations arising out of or relating to it shall be referred to and finally resolved by arbitration administered by the Hong Kong International Arbitration Centre (HKIAC) under the HKIAC Administered Arbitration Rules in force when the Notice of Arbitration is submitted. The law of this arbitration clause shall be Hong Kong law. The seat of arbitration shall be Hong Kong. The number of arbitrators shall be three. The arbitration proceedings shall be conducted in English.

**Entire Agreement**

These terms including any supplementary terms to this Terms of Service constitute the entire agreement between you and us with respect to the subject matter hereof. This Agreement supersedes any and all prior or contemporaneous written and oral agreements, communications and other understandings (if any) relating to the subject matter of the terms.

<br>

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# Privacy Policy

Last Updated: April 11, 2025

This Privacy Policy (“Policy”) describes the manner in which Hyperion (“Hyperion”, “we,” or “us”) and our Website at the [Website](https://hyperion.xyz/) use and collect data from individuals. This Policy, which is incorporated into and is subject to the Hyperion Terms of Service, describes the information that we gather from you on the Website, how we use and disclose such information, and the steps we take to protect such information.

### Information We Collect on the Website:

When you use the Website, we may collect information about you, including your name, email address, mailing address, credit card or other billing information.

#### Publicly- available blockchain data:

When you connect your non-custodial blockchain wallet to the Services, we collect and log your publicly-available blockchain address to learn more about your use of the Services and to screen your wallet for any prior illicit activity. We screen your wallet using intelligence provided by leading blockchain analytics providers. Note that blockchain addresses are publicly-available data that are not created or assigned by us or any central party, and by themselves are not personally identifying.

#### Information from localStorage and other tracking technologies.

We and our third-party services providers may access and collect information from localStorage, mobile deviceID, cookies, web beacons, and other similar technologies to provide and personalize the Services and features of the Services for you across sessions. For example, we may use this information to remember tokens you import, star, or add to your shopping bag. We may also use this information to learn about your preferences, your use of the Services, and our interactions with you. Information we collect from these technologies may include things such as browser type, referring/exit pages, operating system, device or browser language, and other device information. We group and analyze these user journeys collectively, in the aggregate, to improve our product user experience.

#### Cookies and Automatically Collected Information.

When you use the Website, we may send one or more cookies – small text files containing a string of alphanumeric characters – to your device. We may use both session cookies and persistent cookies. A session cookie disappears after you close your browser. A persistent cookie remains after you close your browser and may be used by your browser on subsequent visits to the Website. Please review your web browser “Help” file to learn the proper way to modify your cookie settings.

#### Information from other sources.

We may receive information about your wallet address or transactions made through the Services from our service providers in order to comply with our legal obligations and prevent the use of our Services in connection with fraudulent or other illicit activities.

#### Survey or usability information.

If you participate in a survey or usability study with us, we will record any biographical information you directly provide to us (for example, your name, email, and job title), the responses you provide to us, and your interactions with the Services.

#### Correspondence.

We will receive any communications and information you provide directly to us via email, customer support, social media, or another support channel (such as Twitter or Discord), or when you participate in any surveys or questionnaires.

#### Biographical information.

If you apply for a job with us, we collect all information provided through our Jobs form, including name, email phone, work and immigration status, and any other resume, cover letter, or free form text you include.

#### Information you specifically provide us.

If you specifically provide us with information (such as your email address), we may use that information for the purposes described when you provide it to us. We will not attempt to link any information you provide to your wallet address, IP address, or other personal data. You do not need to provide us with any personal data to use the Services.

### How We Use the Information We Collect

We use information we collect on the Website in a variety of ways in providing the Website and operating our business, including the following:

to operate, maintain, enhance and provide all features of the Website;

to provide services and information that you request, to respond to comments and questions and otherwise to provide support to users, and to process and deliver entries and rewards in connection with promotions that may be offered from time to time on the Website;

to understand and analyse the usage trends and preferences of our users, to improve the Website, and to develop new products, services, features, and functionality;

To evaluate system security and stability and to detect, prevent and address fraud, violation of our terms or policies, and/or other harmful or unlawful activity;

to contact you for administrative purposes such as customer service or to send communications, including updates on promotions and events, relating to products and services offered by us and by third parties; or

To meet legal, regulatory or compliance requirements.

We may use cookies and automatically collected information to:

personalize our Website, such as remembering information about you so that you will not have to re-enter it during your visit or the next time you visit the Website;

provide customized advertisements, content, and information;

monitor and analyze the effectiveness of the Website and third-party marketing activities;

monitor aggregate Website usage metrics such as total number of visitors and pages viewed; and

track your entries, submissions, and status in any promotions or other activities on the Website.

We do not sell, share or trade your personal data collected for profit or for any purposes that are not disclosed under this Policy. In particular, we do not share your personal data to third parties for direct marketing purposes without your express consent.

### When We Disclose Information

Except as described in this Policy, we will not disclose information about you that we collect on the Website to third parties without your consent. We may disclose information to third parties if you consent to us doing so, as well as in the following circumstances:

Any information that you voluntarily choose to include in a publicly accessible area of the Website will be available to anyone who has access to that content, including other users.

We work with third party service providers to provide Website, application development, hosting, maintenance, printing, and other services for us. These third parties may have access to or process information about you as part of providing those services for us.

if required to do so by law or in the good-faith belief that such action is necessary to comply with state and federal laws, in response to a court order, judicial or other government subpoena or warrant, or to otherwise cooperate with law enforcement or other governmental agencies.

We also reserve the right to disclose information about you that we believe, in good faith, is appropriate or necessary to: (i) take precautions against liability; (ii) protect ourselves or others from fraudulent, abusive, or unlawful uses or activity; (iii) investigate and defend ourselves against any third-party claims or allegations; (iv) protect the security or integrity of the Website and any facilities or equipment used to make the Website available; or (v) protect our property or other legal rights (including, but not limited to, enforcement of our agreements), or the rights, property, or safety of others.

Information about our users may be disclosed and otherwise transferred to an acquirer, successor, or assignee as part of any merger, acquisition, debt financing, sale of assets, or similar transaction, or in the event of an insolvency, bankruptcy, or receivership in which information is transferred to one or more third parties as one of our business assets.

We may make certain aggregated, automatically-collected, or otherwise non-personal information available to third parties for various purposes, including: (i) compliance with various reporting obligations; (ii) for business or marketing purposes; or (iii) to assist such parties in understanding our users’ interests, habits, and usage patterns for certain programs, content, services, advertisements, promotions, and/or functionality available through the Website.

### Third-Party Websites

The Website may contain features or links to Websites and services provided by third parties. Any information you provide on third-party Websites or services is provided directly to the operators of such services and is subject to those operators’ policies, if any, governing privacy and security, even if accessed through the Website. We are not responsible for the content or privacy and security practices and policies of third-party Websites or services to which links or access are provided through the Website. We encourage you to learn about third parties’ privacy and security policies before providing them with information.

### Children’s Privacy

This Website is not intended for children and we do not knowingly collect data relating to children. If you are under the age of 18 (or below the age of majority in your jurisdiction), you should use our Website only with the involvement and consent of a parent or guardian and should not submit any personal data to us.

### Data Storage

We will not keep your Personal Data longer than it is necessary. We may however be required to retain Personal Data for a longer period of time to ensure we comply with legislative and regulatory requirements. We will review our data retention obligations to ensure we are not retaining data for longer than we are legally obliged to.

### Data Security

We use certain physical, managerial, and technical safeguards that are designed to improve the integrity and security of information that we collect and maintain.

Due to the open nature of the Internet, no data transmission over the Internet, a website, mobile application or via email or other message service can be guaranteed to be secure from unauthorised access. However, we maintain commercially reasonable physical, electronic and procedural safeguards to protect your personal data in accordance with the requirements of data protection legislation. Any transmission of your personal data is at your own risk and we expect that you will use appropriate security measures to protect your personal data. We disclaim any liability for any theft, loss of, damage or unauthorised access of any data or communications. By using our Website, you acknowledge that you understand and agree to assume these risks.

We may suspend your use of part of our services without notice if we suspect or detect any breach of security. You understand and agree that we may deliver electronic notifications about breaches of security to the email address that you provided to us.

#### International Visitors

**THE WEBSITE IS NOT AVAILABLE IN CERTAIN COUNTRIES OR REGION. IN PARTICULAR, THIS WEBSITE IS NOT INTENDED FOR VISITORS LOCATED WITHIN THE UNITED STATES AND IN THE EUROPEAN ECONOMIC AREA.**

#### Cross Border Transfer

Where necessary to deliver our services, your personal data may be transferred outside the country in which you are located or outside Hong Kong, where there may not be in place data protection laws which are substantially similar to, or serve the same purposes as, the Personal Data (Privacy) Ordinance. That means your personal data may not be protected to the same or similar level in Hong Kong.

When we do so, we will use appropriate safeguards such as contractual terms to protect any personal data being transferred.

#### Your Rights

You may, of course, decline to share certain information with us, in which case we may not be able to provide to you some of the features and functionality of the Website. You may update, correct, or delete your account information and preferences at any time by accessing your account preferences page on the Website. If you wish to access or amend any other personal information we hold about you, you may contact us at. Please note that while any changes you make will be reflected in active user databases within a reasonable period of time, we may retain all information you submit for backups, archiving, prevention of fraud and abuse, analytics, satisfaction of legal obligations, or where we otherwise reasonably believe that we have a legitimate reason to do so.

If you receive commercial email from us, you may unsubscribe at any time by following the instructions contained within the email. You may also opt out from receiving commercial email from us by sending your request to us by email or by writing to us at the address given at the end of this policy. We may allow you to view and modify settings relating to the nature and frequency of promotional communications that you receive from us in user account functionality on the Website.

Please be aware that if you opt out of receiving commercial email from us or otherwise modify the nature or frequency of promotional communications you receive from us, it may take up to ten business days for us to process your request, and you may continue receiving promotional communications from us during that period. Additionally, even after you opt out frogdm receiving commercial messages from us, you will continue to receive administrative messages from us regarding the Website.

#### Governing Law

This Privacy Policy and any separate agreements whereby we provide you Services shall be governed by and construed in accordance with the laws of Hong Kong SAR. Any dispute or claim arising out of or in connection with these Terms and Conditions shall be subject to the exclusive jurisdiction of the courts of Hong Kong SAR.

#### Changes and Updates to this Policy

Please revisit this page periodically to stay aware of any changes to this Policy, which we may update from time to time. If we modify this Policy, we will make it available through the Website, and indicate the date of the latest revision. In the event that the modifications materially alter your rights or obligations hereunder, we will make reasonable efforts to notify you of the change. For example, we may send a message to your email address, if we have one on file, or generate a pop-up or similar notification when you access the Website for the first time after such material changes are made. Your continued use of the Website after the revised Policy has become effective indicates that you have read, understood and agreed to the current version of this Policy.

#### Contact Us

If you would like further information on the collection, use, disclosure, transfer or processing of your personal data or the exercise of any of the rights listed above, please address questions and requests to: <info@hyperion.xyz>

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# Legal Disclaimer

PLEASE READ THE ENTIRETY OF THIS "LEGAL AND COMPLIANCE DISCLAIMER" SECTION CAREFULLY. NOTHING HEREIN CONSTITUTES LEGAL, FINANCIAL, BUSINESS OR TAX ADVICE AND YOU ARE STRONGLY ADVISED TO CONSULT YOUR OWN LEGAL, FINANCIAL, TAX OR OTHER PROFESSIONAL ADVISOR(S) BEFORE ENGAGING IN ANY ACTIVITY IN CONNECTION HEREWITH. NEITHER&#x20;

HYPERFLUID LABS FOUNDATION (THE COMPANY), HYPERFLUID ISSUER INC, ANY OF THE PROJECT CONTRIBUTORS (THE HYPERION PROJECT CONTRIBUTORS) WHO HAVE WORKED ON HYPERION (AS DEFINED HEREIN) OR PROJECT TO DEVELOP HYPERION IN ANY WAY WHATSOEVER, ANY DISTRIBUTOR AND/OR VENDOR OF RION AND xRION TOKENS (OR SUCH OTHER RE-NAMED OR SUCCESSOR TICKER CODE OR NAME OF SUCH TOKENS) (THE DISTRIBUTOR), NOR ANY SERVICE PROVIDER SHALL BE LIABLE FOR ANY KIND OF DIRECT OR INDIRECT DAMAGE OR LOSS WHATSOEVER WHICH YOU MAY SUFFER IN CONNECTION WITH ACCESSING THE PAPER, DECK OR MATERIAL RELATING TO HYPERION (THE WHITEPAPER) AVAILABLE ON THE WEBSITE AT <HTTPS://HYPERION.XYZ/> (THE WEBSITE, INCLUDING ANY SUB-DOMAINS THEREON) OR ANY OTHER WEBSITES OR MATERIALS PUBLISHED OR COMMUNICATED BY THE COMPANY OR ITS REPRESENTATIVES FROM TIME TO TIME.

**Project purpose**: You agree that you are acquiring RION token to participate in Hyperion and to obtain services on the ecosystem thereon. The Company, the Distributor and their respective affiliates would develop and contribute to the underlying source code for Hyperion. The Company is acting solely as an arms’ length third party in relation to the RION distribution, and not in the capacity as a financial advisor or fiduciary of any person with regard to the distribution of RION.

**Nature of the Whitepaper**: The Whitepaper is a conceptual paper that articulates some of the main design principles and ideas for the creation of a digital token to be known as RION(including its derivative token, xRION). The Whitepaper and the Website are intended for general informational purposes only and do not constitute a prospectus, an offer document, an offer of securities, a solicitation for investment, any offer to sell any product, item, or asset (whether digital or otherwise), or any offer to engage in business with any external individual or entity provided in said documentation. The information herein may not be exhaustive and does not imply any element of, or solicit in any way, a legally-binding or contractual relationship. There is no assurance as to the accuracy or completeness of such information and no representation, warranty or undertaking is or purported to be provided as to the accuracy or completeness of such information. Where the Whitepaper or the Website includes information that has been obtained from third party sources, the Company, the Distributor, their respective affiliates and/or the Hyperion Project Contributors have not independently verified the accuracy or completeness of such information. Further, you acknowledge that the project development roadmap, platform/network functionality are subject to change and that the Whitepaper or the Website may become outdated as a result; and neither the Company nor the Distributor is under any obligation to update or correct this document in connection therewith.

**Validity of Whitepaper and Website**: Nothing in the Whitepaper or the Website constitutes any offer by the Company, the Distributor, or the Hyperion Project Contributors to sell any RION (as defined herein) nor shall it or any part of it nor the fact of its presentation form the basis of, or be relied upon in connection with, any contract or investment decision. Nothing contained in the Whitepaper or the Website is or may be relied upon as a promise, representation or undertaking as to the future performance of Hyperion. The agreement between the Distributor (or any third party) and you, in relation to any distribution or transfer of RION, is to be governed only by the separate terms and conditions of such agreement.

The information set out in the Whitepaper and the Website is for community discussion only and is not legally binding. No person is bound to enter into any contract or binding legal commitment in relation to the acquisition of RION, and no digital asset or other form of payment is to be accepted on the basis of the Whitepaper or the Website. The agreement for distribution of RION and/or continued holding of RION shall be governed by a separate set of Terms and Conditions or Token Distribution Agreement (as the case may be) setting out the terms of such distribution and/or continued holding of RION (the Terms and Conditions), which shall be separately provided to you or made available on the Website. The Terms and Conditions must be read together with the Whitepaper. In the event of any inconsistencies between the Terms and Conditions and the Whitepaper or the Website, the Terms and Conditions shall prevail.

**Deemed Representations and Warranties**: By accessing the Whitepaper or the Website (or any part thereof), you shall be deemed to represent and warrant to the Company, the Distributor, their respective affiliates, and the Hyperion Project Contributors as follows:

(a) in any decision to acquire any RION, you have not relied and shall not rely on any statement set out in the Whitepaper or the Website;

(b) you shall at your own expense ensure compliance with all laws, regulatory requirements and restrictions applicable to you (as the case may be);

(c) you acknowledge, understand and agree that RION may have no value, there is no guarantee or representation of value or liquidity for RION, and RION is not an investment product nor is it intended for any speculative investment whatsoever;

(d) none of the Company, the Distributor, their respective affiliates, and/or the Hyperion Project Contributors shall be responsible for or liable for the value of RION, the transferability and/or liquidity of RION and/or the availability of any market for RION through third parties or otherwise; and

(e) you acknowledge, understand and agree that you are not eligible to participate in the distribution of RION if you are a citizen, national, resident (tax or otherwise), domiciliary and/or green card or permanent visa holder of a geographic area or country (i) where it is likely that the distribution of RION would be construed as the sale of a security (howsoever named), financial service or investment product and/or (ii) where participation in token distributions is prohibited by applicable law, decree, regulation, treaty, or administrative act (including without limitation the United States of America and the People's Republic of China); and to this effect you agree to provide all such identity verification document when requested in order for the relevant checks to be carried out, where requested.

The Company, the Distributor and the Hyperion Project Contributors do not and do not purport to make, and hereby disclaims, all representations, warranties or undertaking to any entity or person (including without limitation warranties as to the accuracy, completeness, timeliness, or reliability of the contents of the Whitepaper or the Website, or any other materials published by the Company or the Distributor). To the maximum extent permitted by law, the Company, the Distributor, their respective affiliates and service providers shall not be liable for any indirect, special, incidental, consequential or other losses of any kind, in tort, contract or otherwise (including, without limitation, any liability arising from default or negligence on the part of any of them, or any loss of revenue, income or profits, and loss of use or data) arising from the use of the Whitepaper or the Website, or any other materials published, or its contents (including without limitation any errors or omissions) or otherwise arising in connection with the same. Prospective acquirors of RION should carefully consider and evaluate all risks and uncertainties (including financial and legal risks and uncertainties) associated with the distribution of RION, the Company, the Distributor and the Hyperion Project Contributors.

<br>

RION Token: RION are designed to be utilised, and that is the goal of the RION distribution. In particular, it is highlighted that RION:

(a)    does not have any tangible or physical manifestation, and does not have any intrinsic value (nor does any person make any representation or give any commitment as to its value);

(b) is non-refundable and cannot be exchanged for cash (or its equivalent value in any other digital asset) or any payment obligation by the Company, the Distributor or any of their respective affiliates;

(c) does not represent or confer on the token holder any right of any form with respect to the Company, the Distributor (or any of their respective affiliates), or their revenues or assets, including without limitation any right to receive future dividends, revenue, shares, ownership right or stake, share or security, any voting, distribution, redemption, liquidation, proprietary (including all forms of intellectual property or licence rights), right to receive accounts, financial statements or other financial data, the right to requisition or participate in shareholder meetings, the right to nominate a director, or other financial or legal rights or equivalent rights, or intellectual property rights or any other form of participation in or relating to Hyperion, the Company, the Distributor and/or their service providers;

(d) is not intended to represent any rights under a contract for differences or under any other contract the purpose or intended purpose of which is to secure a profit or avoid a loss;

(e) is not intended to be a representation of money (including electronic money), payment instrument, security, commodity, bond, debt instrument, unit in a collective investment or managed investment scheme or any other kind of financial instrument or investment;

(f) is not a loan to the Company, the Distributor or any of their respective affiliates, is not intended to represent a debt owed by the Company, the Distributor or any of their respective affiliates, and there is no expectation of profit nor interest payment; and

(g) does not provide the token holder with any ownership or other interest in the Company, the Distributor or any of their respective affiliates.

Notwithstanding the RION distribution, users have no economic or legal right over or beneficial interest in the assets of the Company, the Distributor, or any of their affiliates after the token distribution.

To the extent a secondary market or exchange for trading RION does develop, it would be run and operated wholly independently of the Company, the Distributor, the distribution of RION and Hyperion. Neither the Company nor the Distributor will create such secondary markets nor will either entity act as an exchange for RION.

**Informational purposes only**: The information set out herein is only conceptual, and describes the future development goals for Hyperion to be developed. In particular, the project roadmap in the Whitepaper is being shared in order to outline some of the plans of the Hyperion Project Contributors, and is provided solely for INFORMATIONAL PURPOSES and does not constitute any binding commitment. Please do not rely on this information in deciding whether to participate in the token distribution because ultimately, the development, release, and timing of any products, features or functionality remains at the sole discretion of the Company, the Distributor or their respective affiliates, and is subject to change. Further, the Whitepaper or the Website may be amended or replaced from time to time. There are no obligations to update the Whitepaper or the Website, or to provide recipients with access to any information beyond what is provided herein.

**Regulatory approval**: No regulatory authority has examined or approved, whether formally or informally, any of the information set out in the Whitepaper or the Website. No such action or assurance has been or will be taken under the laws, regulatory requirements or rules of any jurisdiction. The publication, distribution or dissemination of the Whitepaper or the Website does not imply that the applicable laws, regulatory requirements or rules have been complied with.

Cautionary Note on forward-looking statements: All statements contained herein, statements made in press releases or in any place accessible by the public and oral statements that may be made by the Company, the Distributor and/or the Hyperion Project Contributors, may constitute forward-looking statements (including statements regarding the intent, belief or current expectations with respect to market conditions, business strategy and plans, financial condition, specific provisions and risk management practices). You are cautioned not to place undue reliance on these forward-looking statements given that these statements involve known and unknown risks, uncertainties and other factors that may cause the actual future results to be materially different from that described by such forward-looking statements, and no independent third party has reviewed the reasonableness of any such statements or assumptions. These forward-looking statements are applicable only as of the date indicated in the Whitepaper, and the Company, the Distributor as well as the Hyperion Project Contributors expressly disclaim any responsibility (whether express or implied) to release any revisions to these forward-looking statements to reflect events after such date.

**References to companies and platforms**: The use of any company and/or platform names or trademarks herein (save for those which relate to the Company, the Distributor or their respective affiliates) does not imply any affiliation with, or endorsement by, any third party. References in the Whitepaper or the Website to specific companies and platforms are for illustrative purposes only.

**English language**: The Whitepaper and the Website may be translated into a language other than English for reference purpose only and in the event of conflict or ambiguity between the English language version and translated versions of the Whitepaper or the Website, the English language versions shall prevail. You acknowledge that you have read and understood the English language version of the Whitepaper and the Website.

\
**No distribution**: No part of the Whitepaper or the Website is to be copied, reproduced, distributed or disseminated in any way without the prior written consent of the Company or the Distributor. By attending any presentation on this Whitepaper or by accepting any hard or soft copy of the Whitepaper, you agree to be bound by the foregoing limitations.

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


# Risk Factors

Purchasing services or products Hyperion and/or RION or xRION entail significant risk. We strongly recommend that you carefully review all information in this document, including the following risk factors, or any other document related to the sale of RION or xRION before deciding to purchase RION or xRION and/or perform actions related to RION or xRION. The actual occurrence of any of the following events could have a material adverse effect on the development, business, prospects and results of operations of Hyperion, which may adversely affect your ability to receive rewards from your acquisitions. Many of these factors are contingencies that may or may not occur, and we cannot estimate the likelihood of such contingencies occurring. Although the risks discussed below are not exhaustive and represent only those that we consider to be significant, they may not be the only risks and uncertainties that may be faced by Hyperion. Additional risks not currently known, expected or believed to be immaterial may also have a material adverse effect on the company’s development, business, prospects and results of operations Hyperion, and you may lose a significant portion or all of the price paid to purchase the Hyperion products and/or RION or xRION. Thus, the purchase of Hyperion services or products and/or performing actions related to RION or xRION must be carried out exclusively by individuals who may bear such risks. Before participating, please consider the potential risks carefully and, if necessary, consult with legal, accounting and tax professionals to assess the risk involved.

**Risks of the Token Economy**: The token economy is relatively new, and tokens may potentially be subject to regulations, including restrictions on ownership or use. There is no guarantee that the purchased RION or xRION will increase in value, provide a profit, or achieve sufficient distribution and liquidity to be exchanged for other assets.

**Risks associated with cryptocurrency volatility**: In general, the rate at which any cryptocurrency can be exchanged for other currencies is extremely volatile.

**Risk of uninsured losses**: Unlike traditional financial accounts, RION are not insured by government-backed institutions. Users may purchase private insurance for additional protection. Therefore, if they are lost or the value of the tokens is lost, we do not have a government sponsored insurance company or private insurance company to offer you compensation.

**Risks related to taxation**: Tax characteristics of RION are unclear. You should seek your own tax advice in connection with your purchase of RION and use of the products on Hyperion.

**Risks associated with uncertain regulations and enforcement actions**: The regulatory status of RION and xRION is unclear or unresolved in many jurisdictions. It is difficult to predict how or whether regulators will be able to apply existing regulations to such technology and its applications. Likewise, it is difficult to predict how or whether legislators or regulators will be able to make changes to laws and regulations affecting such technology and its applications. Regulatory actions may negatively impact Hyperion in various ways, including, for example, by determining that the purchase, sale, delivery or use of RION or xRION constitutes an illegal activity or that registration or licensing is required for some or all parties involved in the purchase, sale, delivery or use of RION or xRION.

<sub>The White Paper is for informational purposes only. Nothing in the White Paper constitutes legal, financial or tax advice. Its content may be updated from time to time without express notice. You should seek your own professional advice before engaging in any activity in connection with Hyperion. See</sub> [<sub>Legal Disclaimer</sub>](https://docs.hyperion.xyz/legal-and-compliance/legal-disclaimer)<sub>.</sub>


