# Overview

Unparalleled access to AI Agents, AI trading strategies, AI Liquidity strategies and DeFi on base.

<figure><img src="https://1334354907-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK1WFnyW0GzxjPAF9IaSq%2Fuploads%2F2ns3NoUDXYELQpwDTzp8%2FIntroducing%20Henjin%20the%20Taiko%20DEX.png?alt=media&amp;token=aca51d1b-437f-4517-887c-91abcc73d516" alt=""><figcaption></figcaption></figure>

[**Henjin**](https://henjin.xyz) is an ecosystem-focused, community-driven DEX and Launchpad built on [**Taiko**](https://taiko.xyz) **and** [**Base**](https://www.base.org/).

Henjin has been built as a highly efficient and customizable protocol, allowing both builders and users to leverage our custom infrastructure for deep, sustainable, and adaptable liquidity. Henjin moves beyond the traditional design of DEXs to focus on offering a tailored approach that prioritises composability.

### Core values & goals

* To provide the Taiko and Base ecosystem with a wide range of innovative features, enabling them to have an extremely high degree of flexibility and control over their own liquidity
* To support new protocols launching on Taiko and Base, providing the tools that enable them to launch, bootstrap liquidity, and sustain their growth
* To make available to all permissionless tools allowing projects of all sizes to leverage our protocol in whatever way suits their needs
* To deliver state-of-the-art functionality that can be easily integrated, built upon, and leveraged by other protocols within the ecosystem
* To apply the real yield narrative to a DEX and liquidity providing - creating innovative emissions strategies that leverage more sustainable tokenomics, aligning incentives with builders, users, and the protocol &#x20;
* To be as decentralized as possible, allowing the community to drive the protocol forward as a DAO, whilst enabling the core team to sustainably build the protocol


# Genesis

Details about the Henjin token (HENAI) raise and token generation event.

<figure><img src="https://1334354907-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK1WFnyW0GzxjPAF9IaSq%2Fuploads%2FT2zWg2Jn55TlQnNOksNS%2Fhenjinx.xyz%20genesis%20launch%20raise.png?alt=media&amp;token=c7be0cf2-71fb-4446-8b35-5039589b5185" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Henjin is designed to be community-driven, and the HENAI token's launch sequence will be a significant factor in achieving that goal. The team remains committed to building the best product possible before seeking funding. The public sale will provide a transparent and fair opportunity for the community to purchase HENAI.
{% endhint %}


# Contact & Official Links

Ways to get in contact with the team and community. All official channels are below, do not fall for scams.

<figure><img src="https://1334354907-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK1WFnyW0GzxjPAF9IaSq%2Fuploads%2FRvPoPieB51tRsxV6MqP4%2FHenjin.xyz%20official%20contact%20and%20social%20media%20channels.png?alt=media&amp;token=3bc9d26d-2e3f-4f7e-b62e-743add03478f" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Below are our official links, channels and email addresses. This list is updated and any other source is fake.
{% endhint %}

### Official links

|                  |                                                |
| ---------------- | ---------------------------------------------- |
| Website          | [**henjin.xyz**](https://henjin.xyz)           |
| Web app          | [**app.henjin.xyz**](https://app.henjin.xyz)   |
| Info & analytics | [**info.henjin.xyz**](https://info.henjin.xyz) |
| Documentation    | [**docs.henjin.xyz**](https://docs.henjin.xyz) |

### Official communication channels

|             |                                                        |
| ----------- | ------------------------------------------------------ |
| Discord     | [**henjin.xyz/discord**](https://henjin.xyz/discord)   |
| X (Twitter) | [**henjin.xyz/twitter**](https://henjin.xyz/twitter)   |
| Telegram    | [**henjin.xyz/telegram**](https://henjin.xyz/telegram) |

### Official email addresses for enquiries

Below are our official links, channels and email addresses. This list is updated and any other source is fake.

{% hint style="info" %}
For faster responses in regards to partnerships, technical support and launchpad inquiries please submit a ticket through our [**discord server**](https://henjin.xyz/discord)**.**
{% endhint %}

|                       |                                                               |
| --------------------- | ------------------------------------------------------------- |
| Partnership enquiries | [**partnerships@henjin.xyz**](mailto:partnerships@henjin.xyz) |
| Media relations       | [**press@henjin.xyz**](mailto:press@henjin.xyz)               |
| Launchpad enquiries   | [**launch@henjin.xyz**](mailto:launch@henjin.xyz)             |
| Careers               | [**careers@henjin.xyz**](mailto:careers@henjin.xyz)           |


# Roadmap Highlights

{% hint style="info" %}
The HenjinAI roadmap is updated quarterly. *Last updated early Q1 2025.*
{% endhint %}

## Q4 2024

* Contracts Audit
* V4 DEX Soft-Launch on Taiko
* First V4 hook PoC (tokemon.fun)
* Incentivized Mainnet Campaign&#x20;
* Initial Partnerships Formed
* First Taiko Trailblazers Campaign

## Q1 2025

* HENAI Token Generation Event
* xHENAI Dividend Plugin
* xHENAI Launchpad Plugin
* Initial Vaults Launch (USDT, USDC, ETH)
* AI Agent Launchpad
* HenjinAI Airdrop
* EVM expansion to Monad
* First AI Agent Launch

## Q2 2025

* AI Agent Directory
* AI Agent Ecosystem Fund
* AI Agent Grants Program
* Ai agent Launch Cohort Campaign
* V4 Hook Marketplace

## H2 2025

* Governance Introduction
* +5 EVM Expansion
* Henjin FM Launch
* V4 Hook Marketplace
* V4 Hook Ecosystem Fund
* +5 EVM Expansion
* Fair Launch Protocol Launch
* No-code AI Agent Infrastructure
* RFP program


# Taiko Guides

Our tailored guides for those wanting to enter the Taiko universe.

{% content-ref url="/pages/Z8nYFFUPp2zJyepFqoN9" %}
[Create a Taiko Wallet](/getting-started/taiko-guides/create-a-taiko-wallet)
{% endcontent-ref %}

{% content-ref url="/pages/8vq5N2HM7KDDCvAM0iPO" %}
[Add Taiko to Wallet](/getting-started/taiko-guides/add-taiko-to-wallet)
{% endcontent-ref %}


# Create a Taiko Wallet

To use Henjin.xyz you will need a Taiko compatible wallet.

<figure><img src="https://1334354907-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK1WFnyW0GzxjPAF9IaSq%2Fuploads%2F0gSs8wtgyWh5fa6X9l6d%2Fhow%20to%20create%20a%20taiko%20wallet.png?alt=media&amp;token=35d8aa4b-ed6e-4ac0-8da7-27690412f6fd" alt=""><figcaption></figcaption></figure>

MetaMask is by far the most popular and free wallet software that is compatible with virtually any Ethereum-based blockchain, including Taiko the home of Henjin. Metamask will allow you to store any assets, buy, as well as connect to any application built on top of an Ethereum-equivalent network, like [**Henjin**](https://henjin.xyz).

{% hint style="info" %}
Over 400 EVM-compatible wallets are available on Henjin. When on the Henjin App, click "Connect Wallet" on the top right of your screen to see the full list.
{% endhint %}

On PC, Metamask is available as a browser extension, and on iOS and Android it is available as an app. Browser extension for PC is available for Chrome, Firefox, Brave, Edge, Opera and Edge.

Our step-by-step tutorial below will help you create your own cryptocurrency wallet (We will use Chrome as an example, but the process is the same for all browsers) The process of creating a wallet on iOS and Android is fairly similar the only difference is that you won’t have to install an extension but an App)

1. Go to [**https://metamask.io**](https://metamask.io/) and click on the download button.
2. On the next page choose on what device you want to install Metamask
3. Click on **Add to chrome**
4. Upon the window pop up click on **Add extension**
5. Once the extension installs, click on **Get started**
6. Click on **Create a wallet**
7. Set a password that will allow you to access the Metamask wallet on the device you are setting it up and click on **Create**
8. Click on **Reveal secret words**

Make sure you store your secret phrase somewhere safe. In the event of a device crash or a browser reset, this is the only way to recover your funds. It is recommended that you write it down. Most people write down their 12-word phrase on a piece of paper and store it in a place where only they can access it. (Make sure you write down the words in the correct order)

In the event that your seed phrase is lost, MetaMask will not be able to assist you in recovering your wallet, and your funds will be lost forever.

Never share your seed phrase or private key with anyone, unless you want them to have full control over your funds.

After you store your secret phrase somewhere safe, click on **Next**

9. Confirm your seed phrase in the correct order and click on **Confirm**
10. Your Metamask wallet is ready for you to use, click on **All done** to access it

You can view your Metamask wallet at any time by clicking on the extension's icon and placing your cursor on the Metamask icon.


# Add Taiko to Wallet

To use Henjin.xyz you will need a Taiko compatible wallet (like Metamask) connected to the Taiko blockchain.

<figure><img src="https://1334354907-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK1WFnyW0GzxjPAF9IaSq%2Fuploads%2FsyOBVhmbh2bFIcXl9FVr%2FHow%20to%20add%20Taiko%20to%20Metamask.png?alt=media&amp;token=4ce30491-0938-46fd-b147-501b47e1a3f4" alt=""><figcaption></figcaption></figure>

Even though you can use other wallets, Metamask is the one we recommend. Throughout this guide, we will assume that you are using the Metamask wallet since it is the one most people use, the process of setting up a wallet should be very similar regardless of the wallet you choose.

### Add Taiko network to Metamask with Chainlist

The easiest way to add Taiko to your wallet is through Chainlist.\
Using the steps below, you can add Taiko to your wallet without typing anything manually.

1. Go to [**https://chainlist.org**](https://chainlist.org/)
2. Click ‘Connect Wallet’ upon notification from your wallet click **Approve**
3. Locate Taiko Mainnet and click **Add to metamask**
4. Upon notification from your wallet click **Approve**
5. In the following popup click **Switch network**
6. You can now use the Taiko network.

### Add Taiko network to Metamask manually

In case you do not wish to interact with the Chainlist website, you can manually add Taiko to your wallet. Below are the steps you need to follow:

1. The first step is to open Metamask and select the network dropdown menu.
2. When the pop-up appears, click **Add Network**
3. The **Add a network** page will open. Add the following details:

* Network name: Taiko Network
* RPC URL : <https://rpc.taiko.xyz>
* Chain ID: <https://chainlist.org/chain/167000>
* Currency symbol: ETH
* Block Explorer URL: <https://taikoblocks.io>

Once you're finished, click **Save**

4. You are now connected to the Taiko network.


# Protocol Overview

An overview of products ran by the Henjin protocol.

<figure><img src="https://1334354907-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK1WFnyW0GzxjPAF9IaSq%2Fuploads%2F8kGEJoQRxukkrUaubLwU%2Fhenjindex-protocol-overview.png?alt=media&amp;token=2d27195b-e63e-467b-b182-2d2bacc082b3" alt=""><figcaption></figcaption></figure>

While the ability to customize pools offers exciting opportunities for users creating them, it also raises concerns regarding security. How can we ensure that custom pools are safe for users, and how can we prevent potential exploitation by malicious actors?

**Henjin v4** provides a comprehensive solution to this challenge, enabling customized pools while maintaining audited security measures.

### **Highly Customizable Features** <a href="#id-6a7a" id="id-6a7a"></a>

Henjin v4 offers an array of customizable options, empowering tailored pools to meet users’ demands. These modular components can also be referred to as hooks, akin to the recent Uni V4 update.

Anyone can select and integrate the modules that best align with their specific requirements, allowing for a customised and secure trading experience. Some notable customization options include:

* ***Dynamic Fees:*** Pool commission rates can be modified as desired, providing flexibility in adapting to market conditions & user preferences. [Read more about dynamic fees](/henjinai-protocol/amm-v4/dynamic-fees).
* ***Built-in Farming:*** Algebra 2.0 facilitates both limited and unlimited-time farming options, enabling decentralized exchanges to design unique farming programs that incentivize liquidity providers and attract more users. [Read more about farming](broken://pages/3pxujNrAkbvfkpRQZBRB).

### AMM (v4)

Henjin v4 formula with concentrated liquidity, dynamic fees and a range of v4 compatible hooks.

{% content-ref url="/pages/YcJvfKN5Nho9Nn9Sm2IL" %}
[AMM (v4)](/henjinai-protocol/amm-v4)
{% endcontent-ref %}

{% content-ref url="/pages/6dhdp3NNqf1l8k2hfhp7" %}
[Dynamic fees](/henjinai-protocol/amm-v4/dynamic-fees)
{% endcontent-ref %}

{% content-ref url="/pages/9pJF8x7DtuhbuGgoyQ8r" %}
[Swap](/henjinai-protocol/amm-v4/swap)
{% endcontent-ref %}

{% content-ref url="/pages/hhxfQIrN3G9EBfm1HmlZ" %}
[Provide Liquidity](/henjinai-protocol/amm-v4/provide-liquidity)
{% endcontent-ref %}

### Hooks (v4)

Henjin v4 hooks are external contracts that execute specific actions at certain points during the execution of a liquidity pool. These hooks enable developers to introduce added features and functionalities to liquidity pools in Henjin v4.

{% content-ref url="/pages/qPJ8SmQLQi90azJRxUin" %}
[Hooks (v4)](/henjinai-protocol/hooks-v4)
{% endcontent-ref %}

### Fair Launches

A transparent and equal opportunity for users to obtain tokens without having to worry about typical price fluctuations associated with the token listing.

{% content-ref url="/pages/SQVNg8Q389Rwm6FNarKL" %}
[Fair Launches](/henjinai-protocol/fair-launches)
{% endcontent-ref %}

### xHENAI Plugins

Contracts linked to the xHENAI contract. Some are native and directly made by the Henjin team (dividends, launchpads and more to come...).

{% content-ref url="/pages/KuFEKKdOsQGlh2aoZ3Go" %}
[xHENAI Plugins](/henjinai-protocol/xhenai-plugins)
{% endcontent-ref %}


# Protocol Earnings

An overview of how protocol earnings are split between various market participants. Everyone can earn a portion of fees generated by the Henjin protocol.

<figure><img src="https://1334354907-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK1WFnyW0GzxjPAF9IaSq%2Fuploads%2F9t7EiWSG4yff2yvBjJXh%2Fhenjindex-protocol-earnings.png?alt=media&amp;token=73af399d-919e-4d5e-aeb4-505c3e89a59c" alt=""><figcaption></figcaption></figure>

### Trading fees (AMM)

Trading fees are split between LPs, HENJ stakers, Operations and Algebra License.

{% hint style="info" %}
Henjin has upgraded to v4. A big part of this upgrade involves dynamic fees on trading pools. Read more about the [dynamic fee model](/henjinai-protocol/amm-v4/dynamic-fees).
{% endhint %}

<figure><img src="https://1334354907-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK1WFnyW0GzxjPAF9IaSq%2Fuploads%2FlozOGWmf56vcLPKJlCnA%2Fhenjin-dex-protocol-earnings-pie-chart.png?alt=media&amp;token=f5ba159b-211a-4ebc-85b3-6a3c7496424a" alt=""><figcaption></figcaption></figure>

### Fair launch fees

2 types of fees are generated through fair launches :&#x20;

* a 5% fee of the total raise sent to the Henjin Treasury ;
* a 3% fee of any referral to fair launch participation (anyone can create a referral link).


# AMM (v4)

Henjin Protocol is a v4 AMM on the Taiko Network.

<figure><img src="https://1334354907-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK1WFnyW0GzxjPAF9IaSq%2Fuploads%2FPgAbuc8iHFM3zjJ7SX92%2Fhenjindex-amm-v4.png?alt=media&amp;token=21eca3a4-11c0-4cbc-9cde-2f47922949fc" alt=""><figcaption></figcaption></figure>

{% content-ref url="/pages/6dhdp3NNqf1l8k2hfhp7" %}
[Dynamic fees](/henjinai-protocol/amm-v4/dynamic-fees)
{% endcontent-ref %}

{% content-ref url="/pages/9pJF8x7DtuhbuGgoyQ8r" %}
[Swap](/henjinai-protocol/amm-v4/swap)
{% endcontent-ref %}

{% content-ref url="/pages/hhxfQIrN3G9EBfm1HmlZ" %}
[Provide Liquidity](/henjinai-protocol/amm-v4/provide-liquidity)
{% endcontent-ref %}


# Dynamic fees

<figure><img src="https://1334354907-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK1WFnyW0GzxjPAF9IaSq%2Fuploads%2Fu4jrXYLiTMdl8FQGbUfY%2FHenjindex-faq.png?alt=media&amp;token=8531bba8-39cf-4428-a135-8b945923871b" alt=""><figcaption></figcaption></figure>

The dynamic fees solution of Henjin v4 is one of its standout features. It offers only one pool with a dynamic fee model that calculates the fee depending on various factors such as volatility and pool volume.&#x20;

[Liquidity Providers (LPs)](/henjinai-protocol/amm-v4/provide-liquidity) can choose custom price range options and find the best conditions for liquidity providing, minimizing price slippage and impermanent loss while maximizing their profits thanks to the higher fees obtained by Liquidity Providers. Thus, LPs can enjoy a more comfortable and easy LP experience.&#x20;

On the other hand, Uniswap v3 has four different pools for every pair with fixed fees, making it difficult for LPs to select the most profitable one. With Henjin v4, LPs are not required to select pools and transfer liquidity between them to earn the highest fee rewards.

### **Capital Efficiency & Returns** <a href="#id-81d4" id="id-81d4"></a>

Henjin v4's dynamic fee model allows LPs to take on more risk by investing in a smaller price range and be fairly rewarded by increasing their LP effectiveness.&#x20;

This approach is more capital-efficient and can provide greater returns to LPs, especially compared to the traditional “x \* y = k” model.&#x20;

By concentrating liquidity on narrower price ranges and using liquidity more efficiently, LPs using Henjin's v4 models with concentrated liquidity and adaptive fees can earn many times more from the same liquidity than those using the x \* y = k model.

### Dynamic Fee Mechanism

To find the optimal commission amount, depending on the nature of the asset's behavior, the following indicators are monitored:

1. Volatility
2. Liquidity
3. Trading Volume

High liquidity is supported by beneficial conditions for providers, which consist of high trading volume with low volatility. In this case, the following situations are possible for providers:

<figure><img src="https://1334354907-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK1WFnyW0GzxjPAF9IaSq%2Fuploads%2F3kefCvvXrvuLzrpPQ2Le%2Fhenjin%20dex%20v4%20dynamic%20fee%20mechanism.png?alt=media&amp;token=0c01b625-8ac7-49a4-b89a-022858d1cfc0" alt=""><figcaption></figcaption></figure>

From this, the following conclusions can be drawn: When the volatility is high, it is necessary to increase the fee to compensate potential losses of liquidity providers; When the volume is low and there is sufficient liquidity, fees should be reduced in order to attract more volume.&#x20;

This is why Henjin offers a complex formula for determining the current fees in the pool, taking into account changes in the parameters of volatility, trading volume and current liquidity.


# Swap

Swapping on Henjin v4 is very simple and doesn't differ from swapping on other AMMs in market.

<figure><img src="https://1334354907-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK1WFnyW0GzxjPAF9IaSq%2Fuploads%2FsDCy6nbLlY5pyc9nBM5J%2Fhenjindex-farms.png?alt=media&amp;token=6539467b-d3c5-4e56-8ddf-1971f7aaa5b3" alt=""><figcaption></figcaption></figure>

### **To swap tokens on Henjin follow these steps**

1. Open the Henjin web app and connect your wallet. Then select the token drop-down.
2. Search for and select the token you wish to swap. You can browse the token list or search for a token by name or contract address.
3. Now you have to select the token you want to swap for. Select the token drop-down.
4. Search for and select the token you wish to swap for. You can browse the token list or search for a token by name or contract address.
5. Enter the amount you would like to swap, receive, or select the “Max” option.

{% hint style="info" %}
The “Max” option automatically inputs the total amount of the token you have available in your wallet for swapping.
{% endhint %}

6. Select “Swap”.
7. Review the swap details, and then select “Confirm Swap”.
8. In your wallet, approve spending for the token you are swapping. This will require a network cost.&#x20;

{% hint style="info" %}
If this is your first time swapping the token with the Henjin protocol, then you’ll need to approve the token in order to trade it.
{% endhint %}

9. In your wallet, sign the message. This transaction will not require a network cost.
10. In your wallet, confirm the swap. This transaction requires network costs.
11. Once confirmed, your swap is submitted to the blockchain and is pending.
12. You will see “Swap success” and a green checkmark on screen when the transaction is successfully completed.

You have now successfully swapped with Henjin! To view your swap on [Taikoblocks](https://taikoblocks.io), you can select “View on Explorer”.

<br>


# Provide Liquidity

<figure><img src="https://1334354907-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK1WFnyW0GzxjPAF9IaSq%2Fuploads%2FZVYlHjQxingkPU8nsyjt%2Fhenjindex-provide-liquidity.png?alt=media&amp;token=cb33a2e8-382a-4ff2-8056-2e9dcf24a8bc" alt=""><figcaption></figcaption></figure>

On Henjin, a liquidity pool is a crowdsourced pool of tokens locked in smart contracts and used to facilitate trades between the assets. Automated market makers (AMM) allow digital assets to be traded in an automatic and permissionless manner through liquidity pools, replacing traditional markets of buyers and sellers.

Henjin v3 enables liquidity providers to concentrate their capital within specific price ranges, leading to increased liquidity at preferred prices. Users can choose to employ both manual mode and auto mode, with the latter automating the adjustment of price ranges.

To provide liquidity on Henjin, navigate to the [**Pools**](https://app.henjin.xyz/pools) tab and click "add liquidity". You can also clock on an existing pool, to see details and then add liquidity.

### **Select a pair**

Start by selecting the pair you want to use for providing liquidity. Take into account factors like trading volume, TVL, and the potential risk of price volatility in the future.&#x20;

Also, check if the pair is incentivized with market maker rewards (v3 manual) which serve as an additional, separate layer of rewards on top of the LP trading fees, or $HENAI incentives (v3 auto).

### **Select a mode**

The mode you choose depends on the specific utility you seek:

* **Manual mode** is tailored for experienced liquidity providers, granting them control over the price ranges of the liquidity they provide
* **Automatic mode** employs focused liquidity management strategies, handling the intricate task of adjusting price ranges for users.&#x20;

{% hint style="info" %}
Refer to the below guides for next steps depending on your choice of mode
{% endhint %}

{% content-ref url="/pages/QgEUvlGp1519j3N5jF8p" %}
[Manual mode](/henjinai-protocol/amm-v4/provide-liquidity/manual-mode)
{% endcontent-ref %}

{% content-ref url="/pages/Iuxn4hlFlKxzatBPQBPs" %}
[Automatic mode](/henjinai-protocol/amm-v4/provide-liquidity/automatic-mode)
{% endcontent-ref %}


# Manual mode

Henjin v3 allows anyone to LP into tading pairs.&#x20;

When setting the range, you may either use four presets or enter the minimum and maximum prices according to your strategy. The smaller the range, the higher the yield, but there is also a greater risk of impermanent loss.

### Set a range

When deciding on a price range, it's important to think about how much you expect prices to change during the time that you're holding your position. You'll also need to think about how much time and effort you're willing to put into managing your position as market conditions change, as well as the costs involved in making those changes.

{% hint style="info" %}
If the price of the assets you're providing liquidity for goes outside of the range you've specified, then your position will become focused on one asset or the other. You won't earn any trading fees until the price returns to within your specified range.
{% endhint %}

Please note that the price you enter will be rounded to the nearest tick. It is not necessary to enter a round number, as this is a characteristic of how ticks function.

### **Input amounts**

Input the amount in one box, and the other box will automatically display the corresponding amount. The ratio between the two amounts depends on your price range relative to the market price.&#x20;

If your price range is closer to one side of the market price, you will provide more of that asset. If you click the **Full range** button, you can provide liquidity across the full range.

Liquidity providers have the option to allocate liquidity on one side of the market, either above or below the current spot price, depending on whether they are provisioning the token with a higher or lower value.

### Approve and add liquidity

To proceed with adding liquidity, start by granting approval. *(This is solely necessary for the initial liquidity provision involving a token).*

Following approval in your wallet, proceed to click on **Add liquidity,** review the provided details, and then click **Add liquidity** once more to execute the transaction from your wallet

### Earn and manage

Your assets are now actively contributing liquidity and accruing trading fees and market maker rewards (depending on whether your position pair is incentivized).

You can oversee and monitor your positions by clicking on a pool and viewing your active positions within that pool after successfully providing liquidity.

### **Remove, add liquidity and collect fees**

On the v3 position management panel, you can view your position data, pending earned fees and incentives. You can also access the following features:

* Market maker rewards : collect your pending incentives *(It will only appear on the interface once you have pending rewards to collcet)*
* Withdraw : withdraw liquidity
* Add : add more liquidity to your position
* Collect fees : collect your pending rewards


# Automatic mode

Henjin provides the opportunity to liquidity providers to set their liquidity to automatic mode through Automated Liquidity Managers. These efficient liquidity strategies remove the need for manually moving around your liquidity ranges,&#x20;

### **Select a provider**

Henjin curates the best ALMs in the market. Current options include :&#x20;

* [ICHI](https://ichi.org/)

### Select a strategy

Each provider has different strategies, here's a summary of available strategies on Henjin :&#x20;

* **The wide-range** strategy will tend to earn less in fees and rewards but may suffer less impermanent loss in a volatile environment. So while it may have less earning potential, it is likely to suffer fewer drawdowns ;&#x20;
* **The narrow-range** strategy will tend to earn more in fees and rewards, but may potentially incur greater losses in a highly volatile market. Narrow-range strategies tend to do well when there is less volatility or when there are high fees and rewards ;&#x20;
* **ALO** strategy is designed to manage both narrow and wide ranges within a single strategy. ALO dynamically allocates liquidity in response to market volatility and fluctuations, aiming for consistent returns and reduced impermanent loss ;
* S**ingle-token deposit** is a concentrated liquidity provision algorithm that generates compelling returns with simple and painless user experience. Users deposit a single token and earn passive returns while the algorithm actively accumulates your preferred token and earns fees.

### Input amounts and approve

To proceed with creating a position, start by granting approval. *(This is solely necessary for the initial liquidity provision involving a token).* Following approval in your wallet, proceed to click on **Create position.**

### Create position & collect fees

Your position is now actively contributing liquidity and earning trading fees. Additionally, it accumulates farming emissions (if emitted for your position's pair).

* To monitor your positions, click **on a pool** after successfully creating a position.
* Note that trading fees auto-compound within the LP. When you withdraw the LP, you will receive the initially paired assets along with earned trading fees

### &#x20; <a href="#grow-any-token" id="grow-any-token"></a>

<br>

<br>

<br>

<br>


# Hooks (v4)

<figure><img src="https://1334354907-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK1WFnyW0GzxjPAF9IaSq%2Fuploads%2FA7jM0bYQadtOcnL52gkk%2Fhenjin-dex-v4-hooks.png?alt=media&amp;token=673f768f-5aea-4208-a32d-8017f9a278b9" alt=""><figcaption></figcaption></figure>

By introducing hooks, Henjin v4 aims to provide a more modular and adaptable framework for DeFi (Decentralized Finance) applications, empowering developers to innovate and tailor the DEX to meet diverse needs and use cases. This flexibility is expected to drive further adoption and evolution of the Henjin protocol within the crypto ecosystem.


# Live v4 hooks

A non-exhaustive list of v4 hooks built by the community and live on Henjin v4 :&#x20;

* [**Tokemon.fun**](https://tokemon.fun) : Dubbed as a pump.fun equivalent on EVM and built as a v4 hook on Henjin, tokemon.fun allows anyone to mint a tradable token within seconds. - [view here](https://tokemon.fun).

{% hint style="info" %}
If you are building a v4 hook and are looking for technical or growth support reach out to us on [Discord](https://henjin.xyz/discord).
{% endhint %}


# How do v4 hooks work ?

With hooks in Henjin v4, developers can create custom logic for various pool actions throughout the pool action lifecycle. For example, custom fee structures, such as dynamic fees based on market conditions or user-specific discounts, can be implemented. Hooks also allow for advanced order types like limit orders, time-weighted average market maker (TWAP) orders, and orders over time, enabling more sophisticated trading strategies.

Moreover, hooks facilitate automated strategies, such as rebalancing or arbitrage bots, directly integrated into the liquidity pool operations. They can enhance security by adding custom withdrawal restrictions or preventing front-running attacks. Additionally, hooks support the creation of incentive programs, rewarding liquidity providers based on market volatility or specific criteria.

The hook contract within the Henjin v4 architecture is designed to be gas efficient, minimizing transaction costs for users. By utilizing hooks, developers can manage large orders and chain limit orders more effectively, ensuring better execution in various market conditions. The pool manager can leverage these hooks to create custom solutions tailored to specific needs, ultimately driving innovation and adoption within the Henjin ecosystem. This modular and adaptable framework empowers developers to build more robust and versatile decentralized finance (DeFi) applications on Henjin v4.


# What is a v4 hook ?

A v4 hook is a concept introduced in Henjin v4, allowing for greater flexibility and customization within the decentralized exchange (DEX). Hooks in Henjin v4 are essentially plugins or customizable smart contract functions added to the core Henjin protocol. These hooks enable developers to extend and modify the behavior of Henjin v4 pools and trading operations, introducing new features or optimizing existing ones.


# Potential uses of  v4 hooks

* **Custom Fee Structures:** Developers can create custom fee mechanisms, such as dynamic fees based on market conditions or user-specific discounts.
* **Advanced Order Types:** Hooks can enable advanced trading features like limit orders, stop-loss orders, or time-weighted average price (TWAP) orders.
* **Automated Strategies:** Automated trading strategies, such as rebalancing or arbitrage bots, can be integrated directly into the liquidity pool operations.
* **Enhanced Security:** Additional security checks or conditions can be enforced, such as preventing front-running attacks or adding custom withdrawal restrictions.
* **Incentive Programs:** Customized incentive structures, such as rewards for providing liquidity during specific times or to specific pools, can be implemented.


# Fair Launches

The launchpads are open to everyone but are structured to prioritize xHENAI holders. However, under certain circumstances, they might become accessible to the general public

<figure><img src="https://1334354907-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK1WFnyW0GzxjPAF9IaSq%2Fuploads%2FJjk42sfbH1qhUOi9QLWr%2Fhenjin-dex-fair-launches.png?alt=media&amp;token=289b9e15-62d0-4e2e-9b55-84575fb3ce97" alt=""><figcaption></figcaption></figure>

### Henjin's custom fair launch model

The fair launch model provides a transparent and equal opportunity for users to obtain tokens without having to worry about typical price fluctuations associated with the token listing. The aim of this model is to ensure that all participants have an equal chance to purchase tokens before they become available on the open market

The sale details, including hardcap, whitelist, and other specifics, are at the discretion of the project team. These details are clarified and provided before each launchpad sale through our [X](https://henjin.xyz/twitter) and [Discord](https://henjin.xyz/discord) server.

### How is the token price determined ?

The price of the offered token depends on whether the sale employs a fixed price or price discovery model. The specifics are always communicated prior to the start of the launchpad.

**Price discovery mechanism example:**

`Price = Total $ raised / sale circullating supply`

* The fair launch auction begins with a set FDV (Fully Diluted Valuation), and a minimum price for each token is established (e.g., $0.1).
* Once the auction raises a predetermined amount (e.g., $1 million), the price discovery phase begins.
* During the price discovery phase, the price of each token continuously increases with every purchase made.

{% hint style="info" %}
Regardless of when you decide to participate, everyone, including whitelisted addresses, will receive tokens at the same final price based on the final valuation of the sale auction unless specified otherwise.
{% endhint %}

### Fair launch scenario without hardcap

A first freak contributes $1000 during the first few minutes of the sale when the token price is $0.1, and second freak contributes $1000 on the last day of the sale when the token price is $0.9. The final valuation of the public sale auction is $1 per token, and both the first and second freak are eligible to claim 1000 tokens each. The token listing starting price will be $1.


# xHENAI Plugins

<figure><img src="https://1334354907-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK1WFnyW0GzxjPAF9IaSq%2Fuploads%2Fl7FXUGbj9Fg31unFcUIm%2Fhenjindex-xhenj-plugins.png?alt=media&amp;token=f8dea7e2-7565-42a5-8a1c-99fa86b4bc0c" alt=""><figcaption></figcaption></figure>

The Henjin team will be releasing more and more xHENAI plugins as the ecosystem evolves.&#x20;

{% hint style="info" %}
xHENAI Plugins are custom-built and **are different** from Henjin v4 hooks.
{% endhint %}

On TGE, there will be 2 plugins available for xHENJ stakers :&#x20;

{% content-ref url="/pages/8MzsbS5BzFHdd1hTHOhf" %}
[xHENAI Dividends Plugin](/henjinai-protocol/xhenai-plugins/xhenai-dividends-plugin)
{% endcontent-ref %}

{% content-ref url="/pages/xEj84Mov9SmuaIDgfBet" %}
[xHENAI Launchpad Plugin](/henjinai-protocol/xhenai-plugins/xhenai-launchpad-plugin)
{% endcontent-ref %}


# xHENAI Dividends Plugin

A portion of [protocol earnings](/henjinai-protocol/protocol-earnings) are redistributed to users who allocated xHENAI to the Dividends plugin.

This dividends distribution can be done in the form of one or more tokens, and happens **continuously** (reward/second), through weekly epochs.

### Epochs

The distribution is based on a weekly epoch logic: every week, a fixed part of the owner-defined accumulated tokens is marked as to be distributed.

The same process is repeated every 7 days.

### Payouts handling

The distribution of those tokens is equally spread over the duration of the epoch, and allocated on a second-basis to every user with a xHENAI allocation on this Dividends plugin, proportionally to their share of the total allocation.

{% hint style="info" %}
In more simpler terms, if we go with the following values:

* a total of 10,000 xHENAI allocated to the dividends plugin
* a daily distribution of 10,000 USDC

If a user has allocated 200 xHENAI to the plugin, he owns 2% of the allocations and will consequently receive 2% of the daily rewards, ie 200 USDC.
{% endhint %}

Dividends are being distributed continuously, users don't need to wait for the end of the epoch to collect them.

### Deallocation

Deallocating xHENAI from this plugin is not subject to any condition, and can be done at any time.


# xHENAI Launchpad Plugin

Users can allocate xHENAI to the Launchpad plugin and take advantage of the benefits offered by projects launching on the Henjin Launchpad, as well as partners who may not launch directly through Henjin but may still want to provide benefits to xHENAI Launchpad plugin allocators.

These benefits may encompass whitelist spots, discounts, airdrops, and other incentives. Specific details regarding upcoming benefits will be shared in advance of each sale through the launchpad plugin app.

{% hint style="info" %}
Holding xHENAI in your wallet won't expose you to benefits; you have to allocate it to the Launchpad plugin
{% endhint %}

### Plugin mechanics

* You will be eligible for benefits from the moment you allocate xHENAI to the plugin
* Once you allocate xHENAI to the Launchpad plugin, a 30-day cooldown timer is triggered, which resets every time you allocate more xHENJ. During this time, you cannot deallocate your xGRAIL
* The deallocation of a portion of allocated xHENAI does not reset the 30-day cooldown timer
* The amount of xHENAI you allocate determines your share of the benefit, so allocating more results in a more significant share
* If the total amount of xHENAI allocated to the plugin increases, each user's share will decrease proportionally; this process works in both directions
* The displayed allocation rate on the interface indicates a minimum, and the final allocation/xHENAI ratio will often be slightly higher. This is because if someone allocates more xHENAI than needed to reach the user cap, the excess allocation is redistributed among other xHENAI allocators
* A snapshot for each benefit is taken at dates specified on the launchpad plugin app but usually takes place 24 hours before the sale begins
* Each launch will provide a unique benefit to xHENAI allocators


# Information

HENAI is HenjinAI's native token. It can be purchased during the HENAI IDO, on a DEX/CX or earned as yield rewards.

Name: **HenjinAI Token**

Ticker: **HENAI**

Chain: **Base**&#x20;

Max supply: **100,000,000 HENAI**&#x20;

Contract: ***TBA***

### **HENAI Details**

{% content-ref url="/pages/aIbSZyB5eSUR3cLNedC8" %}
[Allocation](/henai/allocation)
{% endcontent-ref %}

{% content-ref url="/pages/sKiDpodDh2HWwW5vFmp5" %}
[Distribution](/henai/distribution)
{% endcontent-ref %}

{% content-ref url="/pages/eUqCjOz5rI5PoYFgyD1j" %}
[xHENAI](/henai/xhenai)
{% endcontent-ref %}


# Allocation

### **Genesis in Numbers**

* HENAI Initial Marketcap (Excluding Liquidity) : $1,274,756.94
* HENAI Initial Marketcap (Including Liquidity) : $1,616,944.44
* HENAI Fully Diluted Valuation : $2,500,000.00
* HENAI Initial Circulating Supply (%) : 60.99%

### **Genesis Allocations**

* 50% to the Community distributed upfront (100% unlock on TGE)
* 14% to Protocol Owned Liquidity / CX Liquidity / DEX Liquidity
* 15% to Liquidity incentives

<figure><img src="https://1334354907-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK1WFnyW0GzxjPAF9IaSq%2Fuploads%2FmVE8pMOjKMlABs1g56cU%2Fimage.png?alt=media&amp;token=8a58a1aa-6ff8-40bb-8e1c-dd3e2b1b33b2" alt=""><figcaption></figcaption></figure>


# Distribution

### HENAI Distribution

<table><thead><tr><th width="433">Supply Allocation</th><th>Distribution Schedule</th></tr></thead><tbody><tr><td>Ecosystem Fund (5%)</td><td>Linear distribution over 36 months</td></tr><tr><td>Developer Incentives (5%)</td><td>Linear distribution over 36 months</td></tr><tr><td>POL / CX Liq / DEX Liq (14%)</td><td>-</td></tr><tr><td>Treasury (4%)</td><td>Locked for 12 months then linear unlock over 48 months</td></tr><tr><td>Core Contributors (5%)</td><td>Locked for 12 months then linear unlock over 48 months</td></tr><tr><td>Liquidity Mining (15%)</td><td>Linear distribution over 48 months</td></tr><tr><td>Advisory (2%)</td><td>20% unlock then linear unlock over 6 months</td></tr><tr><td>Community (50%)</td><td>100% unlocked</td></tr></tbody></table>

<figure><img src="https://1334354907-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK1WFnyW0GzxjPAF9IaSq%2Fuploads%2F2HFNxkPqLa8Vph48Anko%2Fimage.png?alt=media&amp;token=8b25a594-34f9-486a-85b0-6b0720bf2fb5" alt=""><figcaption></figcaption></figure>


# xHENAI

Name: **HenjinAI Escrowed Token**

Ticker: **xGRAIL**&#x20;

Chain: **Base**

Contract: ***TBA***

xHENAI is a non-transferable escrowed governance token, corresponding to staked xHENAI. It can be accessed through direct xHENAI conversion.

The central use case for xHENAI is the ability to allocate it to Plugins. The operation consists of staking xHENAI into the token contract and assigning the deposited amount to a plugin in exchange for various benefits.


# How to use xHENAI

xHENAI is illiquid and non-transferable, but can be used through [plugins' allocations](/henjinai-protocol/xhenai-plugins), and in the future on approved (whitelisted) contracts providing additional usages.

### Allocations <a href="#allocations" id="allocations"></a>

Users can freely allocate their available xHENAI to any plugin to take advantage of its benefits. While xHENAI is allocated and consequently deposited on the token contract, **it can't be used for anything else**.

Deallocating allocated xHENAI will withdraw the amount back into the owner's wallet.

{% hint style="info" %}
A default 0.5% fee will be applied when deallocating xHENAI
{% endhint %}

### Transfer <a href="#transfer" id="transfer"></a>

xHENAI is by default non-transferable, except from/to whitelisted addresses. This is made so that essential interactions (like allocations and redemptions with the token contract) and additional usages (for instance with partners specific implementations...) can still be leveraged.

### xHENAI Plugins

{% content-ref url="/pages/8MzsbS5BzFHdd1hTHOhf" %}
[xHENAI Dividends Plugin](/henjinai-protocol/xhenai-plugins/xhenai-dividends-plugin)
{% endcontent-ref %}

{% content-ref url="/pages/xEj84Mov9SmuaIDgfBet" %}
[xHENAI Launchpad Plugin](/henjinai-protocol/xhenai-plugins/xhenai-launchpad-plugin)
{% endcontent-ref %}


# Converting & Redeeming

HENAI and xHENAI are mutually convertible into each other, but the process is different depending on the direction.

### HENAI > xHENAI conversion <a href="#grail-greater-than-xgrail-conversion" id="grail-greater-than-xgrail-conversion"></a>

HENAI can be freely converted into xHENAI at any time. The process is instant, and the ratio is 1:1.

### xHENAI > HENAI redeem

The redemption process to convert xHENAI to HENAI implies vesting, the duration of which is selected by the user. The conversion ratio will increase proportionally with the vesting duration:

* The minimum vesting duration of 15 days will provide a 1:0.5 ratio
* The maximum vesting duration of 6 months will provide a 1:1 ratio

{% hint style="info" %}
If the selected vesting duration is lower than the maximum (ratio < 1:1), the unclaimed excess HENAI is burned.
{% endhint %}


