# Folks Finance xChain App Documentation Overview

Folks Finance's xChain App is a decentralized finance (DeFi) platform that offers seamless cross-chain lending and borrowing services. Utilizing a hub-and-spoke architecture, the protocol provides efficient and user-friendly access to liquidity across multiple blockchains. 

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

<table data-view="cards"><thead><tr><th align="center"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td align="center">xLending</td><td><a href="/pages/PhWK8WzKYGHaEZIskjln">/pages/PhWK8WzKYGHaEZIskjln</a></td></tr><tr><td align="center">Architecture</td><td><a href="/pages/4y9irYqRYYGZ7jqubC7z">/pages/4y9irYqRYYGZ7jqubC7z</a></td></tr><tr><td align="center">User account</td><td><a href="/pages/iVk6k4cYgiqvJREVfpZp">/pages/iVk6k4cYgiqvJREVfpZp</a></td></tr><tr><td align="center">User Guide</td><td><a href="/pages/G9KlPtkvI16iE08nKDcs">/pages/G9KlPtkvI16iE08nKDcs</a></td></tr><tr><td align="center">Techincal Details</td><td><a href="/pages/BGIqqUjRNhAaIsdWNE0V">/pages/BGIqqUjRNhAaIsdWNE0V</a></td></tr><tr><td align="center">Developers</td><td><a href="/pages/9dGWaVQGafM756cEOerP">/pages/9dGWaVQGafM756cEOerP</a></td></tr><tr><td align="center">Security measures</td><td><a href="/pages/xlqwf9RAy38ciJosojPk">/pages/xlqwf9RAy38ciJosojPk</a></td></tr><tr><td align="center">FAQ</td><td><a href="/pages/IQJ7KGTXmFqoykokoHUO">/pages/IQJ7KGTXmFqoykokoHUO</a></td></tr><tr><td align="center">Contact and Support</td><td><a href="/pages/0pEbq8PeCENZObM8fN3D">/pages/0pEbq8PeCENZObM8fN3D</a></td></tr></tbody></table>


# xLending

The initial product of the protocol is xLending, which enhances capital efficiency and user experience for crosschain lending markets through a [hub-and-spoke model](/xlending/architecture). This allows for seamless interactions across multiple blockchain networks.

### **Benefits of Hub and Spoke Model**

* **Capital Efficiency:** All liquidity is available irrespective of which chain the user is on, maximizing capital efficiency.
* **User Convenience:** Users can interact with the protocol from their favorite wallet and familiar chains, lowering the barriers to entry.
* **Cross-Chain Collateralization:** Users can use funds deposited on one chain as collateral to borrow on another, enhancing the flexibility and usability of the protocol.

### Cross-chain Messaging

Cross-chain messaging is a critical component of Folks Finance, enabling secure and efficient communication between the hub and spoke chains. This ensures that transactions are consistent and reliable across different blockchain networks.

1. [**Wormhole**](https://wormhole.com/)
2. [**Chainlink CCIP (Cross-Chain Interoperability Protocol)**](https://chain.link/cross-chain)
3. [**Circle CCTP (Cross-Chain Transfer Protocol)**](https://www.circle.com/en/cross-chain-transfer-protocol)

### Values

* Accessible & Inclusive
* Innovative & Composable
* Transparent & Decentralized
* Community Driven

### Tools

* Lending and Borrowing
* Deposits
* Swaps&#x20;
* Liquid staking (coming soon)


# Architecture

Folks Finance employs a hub-and-spoke architecture to efficiently manage cross-chain interactions. This model ensures liquidity, security, and ease of use across multiple blockchains.

### **Hub and Spoke Structure**

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

1. **Hub Chain:**
   * The hub chain stores the entire state of the protocol. The unified state storage ensures consistency and avoids issues related to asynchronicity and race conditions between chains.
   * All protocol logic and state updates are handled by the hub chain, making it the axis of coordination for all transactions.
2. **Spoke Chains:**
   * Spoke chains act as entry points for users interacting with Folks Finance. They connect outlying blockchains to the central hub chain.
   * Unlike the hub chain, spoke chains do not store any state related to lending functionality. They only maintain state related to communication with the hub chain, thereby simplifying the overall architecture and reducing the risk of inconsistencies.

**Benefits of Hub and Spoke Model**

* **Capital Efficiency:** All liquidity is available irrespective of which chain the user is on, maximizing capital efficiency.
* **User Convenience:** Users can interact with the protocol from their favorite wallet and familiar chains, lowering the barriers to entry.
* **Cross-Chain Collateralization:** Users can use funds deposited on one chain as collateral to borrow on another, enhancing the flexibility and usability of the protocol.

***

### Cross-chain Messaging

Cross-chain messaging is a critical component of Folks Finance, enabling secure and efficient communication between the hub and spoke chains. This ensures that transactions are consistent and reliable across different blockchain networks.

**Key Communication Protocols**

1. **Wormhole:**
   * Wormhole provides a cross-chain messaging protocol that allows secure and efficient communication between the hub and spoke chains.
   * It uses an automatic relayer to send and receive messages, ensuring the integrity and reliability of the data being transferred.
2. **Chainlink CCIP (Cross-Chain Interoperability Protocol):**
   * Chainlink CCIP facilitates cross-chain communication by providing a secure method to send and receive messages between chains.
   * It leverages Chainlink’s decentralized oracle network to ensure the security and accuracy of cross-chain messages.
3. **Circle CCTP (Cross-Chain Transfer Protocol):**
   * Circle CCTP enables cross-chain native USDC transfers, providing a secure and efficient way to transfer USDC between different blockchains.

**Cross-Chain Messaging Architecture**

* **Generic Messaging Protocol (GMP):**
  * The hub chain and spoke chains communicate using GMPs such as Wormhole, Chainlink CCIP, and Circle CCTP.
  * GMPs are responsible for relaying messages between the hub and spoke chains, ensuring that all transactions are accurately recorded and executed.
* **BridgeRouter:**
  * The BridgeRouter abstracts the differences between available GMPs, routing messages to the appropriate protocol based on user specifications and system requirements.
  * It also handles message storage for failed transactions, allowing for retries or reversals as necessary.

**Message Lifecycle**

1. **Sending a Message:**
   * When a user initiates a transaction on a spoke chain, the message is sent to the hub chain using the specified GMP.
   * The message parameters include details such as the adapter ID, destination chain ID, payload, and finality level.
2. **Receiving a Message:**
   * The hub chain receives the message, verifies its integrity, and processes it accordingly.
   * Upon processing, the hub chain may send a return message to the spoke chain to confirm the transaction's completion.
3. **Finality and Security:**
   * Finality is crucial for ensuring that transactions cannot be reversed or altered once confirmed. Folks Finance waits for finality on the spoke chain before relaying messages to the hub chain for critical operations like deposits and repayments.
   * For operations that do not involve value transfer, finality is not required, allowing for immediate message relaying to enhance user experience.

**Cross-Chain Messaging Components**

1. **BridgeMessenger:**
   * An abstract contract that enables inheritors to send and receive messages without needing to know the internal details of the GMPs.
2. **BridgeRouter:**
   * The BridgeRouter abstracts the differences between available GMPs, routing messages to the appropriate protocol based on user specifications and system requirements.
   * Responsibilities include:
     * Routing a requested message to the specified GMP.
     * Forwarding a received message to the desired smart contract.
     * Storing failed messages to be retried or reversed.
3. **Adapters:**
   * Each GMP has its own adapter that implements the necessary interfaces for communication.
   * Example: The WormholeAdapter and CCIPAdapter convert messages to a common format for processing by the BridgeRouter.

**Error Handling and Recovery**

1. **Error Recording:**
   * If a message fails to be processed, the BridgeRouter records the error and stores the message for future action.
2. **Retry and Reverse Functions:**
   * Users have the option to retry failed messages or reverse the operation to return any locked funds back to their original state.

**Detailed Message Lifecycle Example**

1. **Initiating a Transaction:**
   * A user submits an "Invite Address" transaction to the spoke chain, specifying the use of CCIP for cross-chain communication.
   * The spoke chain calls BridgeRouter with the necessary parameters.
2. **Forwarding the Message:**
   * The BridgeRouter verifies the sender and forwards the message to the appropriate adapter (e.g., CCIPAdapter).
   * The adapter processes the message and sends it to the corresponding adapter on the hub chain.
3. **Receiving the Message:**
   * The hub chain adapter receives the message, verifies its integrity, and processes it.
   * The BridgeRouter stores the message details for retry or reversal if necessary.


# User account

Accounts in Folks Finance are designed to manage users' positions and facilitate lending functionality across multiple blockchains. Each account is uniquely identified and allows for efficient cross-chain operations.

**Account Structure**

* **Unique Identifier:** Each account has a unique `bytes32` identifier.
* **Blockchain Addresses:** Accounts are managed using blockchain addresses, uniquely identified by the tuple `(chain identifier, chain address)`.

**Key Features**

1. **Single Address per Chain:**
   * Each account can have at most one address registered per spoke chain. This simplification ensures that operations are streamlined and user-friendly.
   * For example, if a user is borrowing ETH, they will receive it in their registered Ethereum address without needing to specify which address to use.
2. **Unique Address Registration:**
   * The same `(chain identifier, chain address)` pair cannot be registered to multiple accounts. This prevents confusion and ensures that users do not unintentionally interact with the wrong account.
   * The concept of inviting and accepting is used to manage address registrations. An existing registered address can invite another address from a different spoke chain to join the account. The invited address must then accept the invitation to be registered.
3. **Delegated Addresses:**
   * To enhance composability and allow other protocols to build on top of Folks Finance, accounts can add "delegated addresses." These addresses can manage accounts from the hub chain.
   * Multiple delegated addresses can be added to a single account, and the same address can be delegated to by multiple accounts. This feature is intended for use by other smart contracts on the hub chain that leverage the Folks Finance protocol.

**Account Operations**

1. **Invite and Accept:**
   * An address from one spoke chain can invite another address from a different spoke chain to join the account.
   * The invitee must accept the invitation for the registration to be completed.
2. **Manage Account:**
   * Once registered, addresses can manage the account, including withdrawing, inviting other addresses, and more.
3. **Delegation:**
   * Delegated addresses are given privileges to manage the account, allowing for seamless integration with other protocols and services.

**Security Considerations**

* **Denial of Service Protection:**
  * To prevent denial of service attacks, the same `(chain identifier, chain address)` pair cannot be registered to multiple accounts. This ensures that malicious actors cannot add an address to their account to block its use elsewhere.
* **Trusted Integrators:**
  * It is crucial for users to verify the addresses they delegate to. Malicious addresses can steal funds, so users must be cautious and only delegate to trusted integrators.


# Linking and Inviting Addresses

### Linking and Inviting Addresses in Folks Finance

#### Difference Between Inviting and Linking an Address in Folks Finance

In the Folks Finance cross-chain lending protocol, inviting and linking an address are interrelated mechanisms used for account management. Linking is a streamlined frontend process for adding an address that the user owns, whereas inviting is a more generalized concept that can also involve addresses controlled by other individuals. Here is a detailed explanation of both processes and their differences:&#x20;

**Linking an Address**

**Definition:**

Linking an address is a frontend process designed to streamline the addition of an address that the user owns to the Folks Finance lending account by automating the inviting and accepting steps.

* Linking addresses is the simplest way to connect user account to different chains with minimal hassle.

Process:

1. Linking:

* A user submits a "link address" transaction from a spoke chain.
* This transaction is immediately relayed to the hub chain, and the hub chain updates its state with the new information.

**Example Use Case:**

* A user wants to link their Polygon address to their Folks Finance account on the hub chain to allow for quick management and transactions across chains.

#### Inviting an Address (available soon)

**Definition:**

Inviting an address is a process where an existing registered address of an account can invite another address from a different spoke chain to join the account. This invited address can be controlled by another person. The invitee must then accept the invitation for the registration to be completed.\
\
Inviting addresses is useful for:

* Connecting an address which is hosted in a different wallet, like your mobile phone vs. desktop browser wallets.
* Creating collaborative accounts with friends or colleagues.

**Process:**

1. **Invitation:**

* An existing address within an account initiates an invitation to another address.
* This invitation is sent through a cross-chain message from the spoke chain of the inviting address to the hub chain.

2. **Acceptance:**

* The invited address must accept the invitation for it to become registered to the account.
* Once accepted, the invited address gains the same permissions and management capabilities as the original address.

**Example Use Case:**

* A user on the Ethereum blockchain invites a friend’s Binance Smart Chain address to help manage their Folks Finance account. The Binance Smart Chain address must accept this invitation to gain management rights.


# Getting started


# Creating an account

{% hint style="info" %}
Accounts in Folks Finance are designed to manage users' positions and facilitate lending functionality across multiple blockchains. Each account is uniquely identified and allows for efficient cross-chain operations. To learn more: [User account](/xlending/user-account)
{% endhint %}

1. Click on the User section on the top right of the app.

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

2. Click on Create Account.

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

3. Select your preferred chain&#x20;

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

3. Click on Create Account and sign with your wallet&#x20;


# Link/Invite address

### Link address

1. Click on Link address.

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

2. Select the chain you wish to link to the account you are connected with.

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

3. Write the address you wish to link to the account you are connected with.

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

4. Confirm and sign with your wallet.
5. Click on Sync chain.

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

6. Click Complete linking and sign with your wallet.

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

#### Make your first deposit:

{% content-ref url="/pages/3ak9oWchJH6Au1GAOgWQ" %}
[Depositing Assets](/user-guide/depositing-assets)
{% endcontent-ref %}

### Invite address (available soon)&#x20;


# Faucet list (testnet)

{% embed url="<https://testnet.xapp.folks.finance/>" %}

To get started with Folks Finance xChain app Testnet you need testnet tokens. Here is a guide on how to get them.

### What is a Faucet?

A faucet is a tool that dispenses a small amount of testnet tokens to users for free. These tokens can be used to execute transactions and test various functionalities on the Folks Finance testnet.

### How to Use the Faucet

To start using the faucet and claim your testnet tokens, simply follow the URLs provided below. Each link will guide you to a specific faucet where you can request tokens for different blockchain testnets supported by Folks Finance.

{% embed url="<https://faucets.chain.link/>" %}

{% embed url="<https://www.infura.io/faucet/sepolia>" %}

{% embed url="<https://www.alchemy.com/faucets/ethereum-sepolia>" %}

{% embed url="<https://core.app/tools/testnet-faucet/?subnet=c&token=c>" %}

{% embed url="<https://faucet.circle.com/>" %}
Circle Faucet
{% endembed %}

{% embed url="<https://console.optimism.io/faucet>" %}

{% embed url="<https://cloud.google.com/application/web3/faucet/ethereum/sepolia>" %}

{% embed url="<https://faucet.quicknode.com/drip>" %}

{% embed url="<https://portal.cdp.coinbase.com/products/faucet>" %}

{% embed url="<https://www.bnbchain.org/en/testnet-faucet>" %}


# Connecting Wallets

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

1. Navigate to the Folks Finance application.
2. Select the Connect Wallet button.
3. Choose your preferred wallet provider and follow the prompts to connect.


# Depositing Assets

{% embed url="<https://www.youtube.com/watch?v=ybyMYNW0gdg>" %}

1. Select the chain you want to deposit on&#x20;

<figure><img src="/files/8z8Ew4yZQAHLrGIASPZq" alt=""><figcaption></figcaption></figure>

2. Select the token you want to deposit and click on Deposit

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

{% hint style="info" %}
Deposit operations performed on spoke chains may require more time to be executed than usual. This has been due to the Waiting Delay.&#x20;

Definition:\
*Waiting Relay indicates that a transaction has been initiated from a spoke chain and is awaiting delivery to the hub chain via the Generic Messaging Protocol (GMP) such as Wormhole or Chainlink CCIP. For certain operations like deposits, collateralization, and repayments, the waiting time is longer as it requires achieving finality on the spoke chain where the operation was initiated. The Waiting Relay is necessary because it avoids potential risks such as double spending by ensuring that a transaction has been fully confirmed on the source chain before proceeding.*
{% endhint %}

3. Insert the amount you want to deposit, click on Deposit, and sign with your wallet

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


# Borrowing Assets

{% embed url="<https://youtu.be/OwOOL3zxyLQ>" %}

1. On the top right corner of the Loan section, click on Create New Loan.

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

2. Write the name of your loan, click on Create Loan, and sign with your wallet.

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

3. Click on Manage to handle your loan.

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

4. Before borrowing an asset you need collateral. To collateralize an asset click on Collateralize in the Available to Collateralize table.

{% hint style="info" %}
Collateralizing an asset on spoke chains may require more time to be executed than usual. This has been due to the Waiting Delay.&#x20;

Definition:\
*Waiting Relay indicates that a transaction has been initiated from a spoke chain and is awaiting delivery to the hub chain via the Generic Messaging Protocol (GMP) such as Wormhole or Chainlink CCIP. For certain operations like deposits, collateralization, and repayments, the waiting time is longer as it requires achieving finality on the spoke chain where the operation was initiated. The Waiting Relay is necessary because it avoids potential risks such as double spending by ensuring that a transaction has been fully confirmed on the source chain before proceeding.*
{% endhint %}

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

5. Type in the amount you want to collateralize and sign with your wallet

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

6. Now you can borrow assets. To borrow an asset click on Borrow in the Available to Borrow table

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

7. Type in the amount you want to borrow, choose between Variable and Stable APY, click on Borrow, and sign with your wallet

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


# Closing Loans

### Repay a loan

{% embed url="<https://youtu.be/HpFqEXfiZfY>" %}

1. On the loan page click on Manage next to the loan you want to repay.

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

2. Go to the Borrow table and click on Repay next to the asset you want to repay.

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

3. Type in the amount you want to repay, click on Repay, and sign with your wallet.

{% hint style="info" %}
Repaying an asset on spoke chains may require more time to be executed than usual. This has been due to the Waiting Delay.&#x20;

Definition:\
*Waiting Relay indicates that a transaction has been initiated from a spoke chain and is awaiting delivery to the hub chain via the Generic Messaging Protocol (GMP) such as Wormhole or Chainlink CCIP. For certain operations like deposits, collateralization, and repayments, the waiting time is longer as it requires achieving finality on the spoke chain where the operation was initiated. The Waiting Relay is necessary because it avoids potential risks such as double spending by ensuring that a transaction has been fully confirmed on the source chain before proceeding.*
{% endhint %}

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

### Reduce collateral

{% embed url="<https://youtu.be/EbsGRpokDRs>" %}

1. Go to the Collateral table and click on Reduce next to the asset you want to withdraw.

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

2. Type in the amount you want to withdraw, click on Reduce, and sign with your wallet.

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


# Withdrawing Assets

{% embed url="<https://www.youtube.com/watch?v=V8g1rk_G6Jg>" %}

1. Go to Your Deposit section and click on Withdraw next to the asset you want to withdraw&#x20;

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

2. Type in the amount you want to withdraw, click on withdraw, and sign with your wallet

<figure><img src="/files/61wbe0JZ7SvIC2zXC5N5" alt=""><figcaption></figcaption></figure>


# Swaps

Folks Finance swaps are powered by [Li.Fi](https://li.fi/), a leading liquidity aggregation protocol offering cross-chain token swaps. With this integration, users can swap assets across multiple blockchains directly within the Folks Finance platform, providing a unified and efficient experience.

#### Benefits of Li.Fi Integration

1. Aggregated Liquidity and Transaction costs: \
   Li.Fi sources liquidity from multiple providers to ensure users receive optimal swap rates with minimized slippage. This approach not only improves execution efficiency but also helps users save on transaction costs.
2. Cross-Chain Swaps:\
   With Li.Fi, users can easily swap assets across multiple blockchains in a single transaction, without needing to manage multiple wallets or bridges.
3. Efficiency and Simplicity:\
   Instead of using multiple platforms for cross-chain swaps, or borrowing, everything is streamlined through Folks Finance, making it easier for users to interact with DeFi from a single hub.

#### How to Swap

{% embed url="<https://youtu.be/ebg2NMIJcsU>" %}

1. Connect your wallet
2. Click on Swap from the header
3. Select token and chain from and to you wish to perform the swap
4. Click on Exchange, follow the instruction, and sign with your wallet

{% hint style="info" %}
For a detailed explanation of how Li.Fi works, visit their official documentation: [Li.Fi Docs](https://docs.li.fi/).
{% endhint %}


# Liquid staking

## Coming soon


# Interest Rate Model

The interest rate model in Folks Finance is designed to dynamically balance supply and demand, ensuring competitive rates for both borrowers and depositors. This model is crucial for maintaining the stability and efficiency of the lending protocol.

**Key Concepts**

1. **Utilization Ratio (U):**
   * The utilization ratio measures how much of the available pool of assets has been borrowed compared to the total deposited.
   * Formula: $$U = \frac{\text{Total Borrowed}}{\text{Total Deposited}}$$
2. **Variable and Stable Interest Rates:**
   * **Variable Interest Rate:** This rate fluctuates according to the utilization ratio.
   * **Stable Interest Rate:** This rate is fixed at the time of borrowing but can be rebalanced to ensure the protocol’s stability.

**Interest Rate Calculations**

1. **Variable Borrow Interest Rate** $$i\_{vb}$$**:**
   * The variable interest rate depends on the utilization ratio and is calculated using the following formulas:
     * If $$U\_t < U\_{Opt}$$ : $$i\_{vb}(t) = R\_{v0} + \frac{U\_t}{U\_{Opt}} \times R\_{v1}$$
     * If $$U\_t \geq U\_{Opt}$$ : $$i\_{vb}(t) = R\_{v0} + R\_{v1} + \frac{U\_t - U\_{Opt}}{1 - U\_{Opt}} \times R\_{v2}$$
2. **Stable Borrow Interest Rate**  $$i\_{sb}$$ **:**
   * The stable interest rate is calculated similarly but includes additional parameters to handle the ratio of stable borrows:
     * If $$U\_t \leq U\_{Opt}$$  :  $$i\_{sb}(t) = R\_{v1} + R\_{s0} \left(\frac{U\_t}{U\_{Opt}}\right) \times R\_{s1}$$
     * If $$U\_t > U\_{Opt}$$ : $$i\_{sb}(t) = (R\_{v1} + R\_{s0}) + R\_{s1} + \frac{U\_t - U\_{Opt}}{1 - U\_{Opt}} \times R\_{s2}$$
3. **Rebalancing Stable Rates:**
   * To maintain protocol stability, stable rates may need rebalancing under specific conditions:
     * **Rebalancing Down:** When the current stable rate exceeds the pool’s current stable rate by a defined margin.
     * **Rebalancing Up:** When the utilization ratio and deposit interest rate meet certain thresholds.

**Deposit Interest Rate**

1. **Calculation:**
   * The deposit interest rate, earned by depositors, is derived from the interest paid by borrowers.
   * Formula: $$i\_d(t) = U\_t \times i\_b(t) \times (1 - RR)$$
   * $$i\_b(t)$$ is the overall borrow interest rate, which is a weighted average of variable and stable borrow rates.
   * ( RR ) is the retention rate, representing the protocol's fee.
2. **Borrow Interest Amount** $$O\_{sb}$$**:**
   * The stable borrow interest amount is the sum of the stable borrowed amounts multiplied by their respective interest rates.
   * Formula: $$O\_{sb}(t) = \sum B\_i \times i\_{sb}(i)$$

**Collateral and Borrow Limits**

1. **Collateral Factor (CF):**
   * The collateral factor determines how much a user can borrow against their collateral, expressed as a percentage.
   * Example: USDC might have a CF of 80%, meaning $10 of USDC allows borrowing up to $8 in value.
2. **Borrow Amount Calculation:**
   * The borrowable amount (BA) is calculated based on the user's collateral balance, the price of the collateral, and the collateral factor.
   * Formula: $$BA(t) = \sum (A\_{t\_i} \times P\_i \times CF\_i)$$
3. **Borrow Factor (BF):**
   * The borrow factor adjusts the effective borrowed amount to account for asset volatility.
   * Example: BTC might have a BF of 110%, meaning $10 borrowed is effectively $11 due to its volatility.

## **Rebalancing**

Although a user locks in a borrow interest rate when stable borrowing, under certain conditions, it may be necessary to rebalance their borrow interest rate. Rebalancing means that the user’s stable borrow interest rate is updated to the pool’s current stable interest rate $$i\_{sb\_t}$$

To rebalance the stable rate down, the user’s loan stable rate $$i\_{sb\_{old}}$$ needs to be greater than the current stable rate $$i\_{sb\_t}$$ plus a delta, for instance, ∆=20%.

$$
i\_{sb\_{old}} \geq i\_{sb\_t} \cdot (1 + \Delta)
$$

To rebalance the stable rate up, two conditions have to be met at the same time. The first requires the utilization ratio to be greater than or equal to a given threshold, for instance, $$U\_{RU}=95%$$%. The second requires the deposit interest rate to be less than or equal to a given percentage of the max variable interest rate, for instance $$DIR\_{RU}=25$$%.

$$
U\_t \geq U\_{RU}
$$

$$
i\_{d\_t} \leq DIR\_{RU} \left( R\_{v\_0} + R\_{v\_1} + R\_{v\_2} \right)
$$


# Liquidation Process

The liquidation process in Folks Finance ensures the stability and security of the protocol by managing under-collateralized loans. This process involves third parties who liquidate these loans, receiving incentives for maintaining protocol health.

### How Does Liquidation Work?

1. The protocol detects an under-collateralized position.
2. A liquidator repays part of the loan on behalf of the borrower.
3. In exchange, they receive a portion of the borrower’s collateral — with a bonus.

### When Does Liquidation Happen?

Liquidation occurs when the total borrowed amount exceeds the borrowable amount. It happens when someone who borrowed doesn’t have enough collateral to cover their loan anymore due to price changes or the accumulation of borrow interests:

<details>

<summary>Formula: <span class="math">TB(t) > BA(t) </span></summary>

Where:

* $$TB(t)$$ is the total borrowed amount at time t.
* $$BA(t)$$ is the borrowable amount at time t.

</details>

### Who Handles Liquidation?

Third-party liquidators intervene to repay a portion of the borrower’s outstanding debt when a position becomes under-collateralized. In exchange, they receive a corresponding amount of the borrower’s collateral, along with a liquidation bonus as compensation.

**Liquidation Bonus:**

Liquidators receive a bonus for repaying the under-collateralized position.

Example: A liquidation bonus of 10% means that if $50 is repaid, $55 worth of collateral is seized.

<details>

<summary>Formula:  <span class="math">{collateral.seized}= BtoC_t(x) \times (1 + {liq.bonus})</span></summary>

Where:

* $$x$$ is the amount of the borrowed asset being repaid.
* $$BtoC\_t(x)$$ is the conversion formula from borrow to collateral.
* $${liq.bonus}$$ is the liquidation bonus percentage.

</details>

**Liquidation Fees:**

A portion of the liquidation bonus is retained by the protocol as revenue.

Example: With a liquidation fee of 20%, if the collateral seized is $55, the protocol retains $1 as revenue.

<details>

<summary>Formula: <span class="math">L_t^R = {collateral.seized.as.bonus} \times {liq.fee}</span></summary>

Where:

* $$L\_t^R$$ is the liquidation fee retained by the protocol.
* $${collateral.seized.as.bonus}$$ is the bonus portion of the collateral seized.
* $${liq.fee}$$ is the liquidation fee percentage.

</details>

**Remaining Collateral:**

The remaining collateral after the liquidation fee is retained by the liquidator.

<details>

<summary>Formula: <span class="math">L_t = {collateral.seized} - L_t^R</span></summary>

Where:

* $$L\_t$$ is the remaining collateral retained by the liquidator.

</details>

{% hint style="info" %}
**Liquidations from Spoke Chains**&#x20;

Liquidations from Spoke Chains often fail due to asynchronicity in price updates and the limitation that only one liquidator can act at a time. In Folks Finance, **liquidations are instead processed on the Hub Chain.** Rather than requiring the liquidator to repay the borrow directly from the Spoke Chain, the debt and seized collateral are transferred to them on the Hub Chain, ensuring smoother execution without the need for token recovery in case of failure.
{% endhint %}


# Cross-Chain Messaging

#### Cross-Chain Messaging

Cross-chain messaging is a critical component of Folks Finance, enabling secure and efficient communication between the hub and spoke chains. This ensures that transactions are consistent and reliable across different blockchain networks.

**Key Communication Protocols**

1. **Wormhole:**
   * Wormhole provides a cross-chain messaging protocol that allows secure and efficient communication between the hub and spoke chains.
   * It uses an automatic relayer to send and receive messages, ensuring the integrity and reliability of the data being transferred.
2. **Chainlink CCIP (Cross-Chain Interoperability Protocol):**
   * Chainlink CCIP facilitates cross-chain communication by providing a secure method to send and receive messages between chains.
   * It leverages Chainlink’s decentralized oracle network to ensure the security and accuracy of cross-chain messages.
3. **Circle CCTP (Cross-Chain Transfer Protocol):**
   * Circle CCTP enables cross-chain native USDC transfers, providing a secure and efficient way to transfer USDC between different blockchains.

**Cross-Chain Messaging Architecture**

* **Generic Messaging Protocol (GMP):**
  * The hub chain and spoke chains communicate using GMPs such as Wormhole, Chainlink CCIP, and Circle CCTP.
  * GMPs are responsible for relaying messages between the hub and spoke chains, ensuring that all transactions are accurately recorded and executed.
* **BridgeRouter:**
  * The BridgeRouter abstracts the differences between available GMPs, routing messages to the appropriate protocol based on user specifications and system requirements.
  * It also handles message storage for failed transactions, allowing for retries or reversals as necessary.

**Message Lifecycle**

1. **Sending a Message:**
   * When a user initiates a transaction on a spoke chain, the message is sent to the hub chain using the specified GMP.
   * The message parameters include details such as the adapter ID, destination chain ID, payload, and finality level.
2. **Receiving a Message:**
   * The hub chain receives the message, verifies its integrity, and processes it accordingly.
   * Upon processing, the hub chain may send a return message to the spoke chain to confirm the transaction's completion.
3. **Finality and Security:**
   * Finality is crucial for ensuring that transactions cannot be reversed or altered once confirmed. Folks Finance waits for finality on the spoke chain before relaying messages to the hub chain for critical operations like deposits and repayments.
   * For operations that do not involve value transfer, finality is not required, allowing for immediate message relaying to enhance user experience.

**Cross-Chain Messaging Components**

1. **BridgeMessenger:**
   * An abstract contract that enables inheritors to send and receive messages without needing to know the internal details of the GMPs.
2. **BridgeRouter:**
   * The BridgeRouter abstracts the differences between available GMPs, routing messages to the appropriate protocol based on user specifications and system requirements.
   * Responsibilities include:
     * Routing a requested message to the specified GMP.
     * Forwarding a received message to the desired smart contract.
     * Storing failed messages to be retried or reversed.
3. **Adapters:**
   * Each GMP has its own adapter that implements the necessary interfaces for communication.
   * Example: The WormholeAdapter and CCIPAdapter convert messages to a common format for processing by the BridgeRouter.

**Error Handling and Recovery**

1. **Error Recording:**
   * If a message fails to be processed, the BridgeRouter records the error and stores the message for future action.
2. **Retry and Reverse Functions:**
   * Users have the option to retry failed messages or reverse the operation to return any locked funds back to their original state.

**Detailed Message Lifecycle Example**

1. **Initiating a Transaction:**
   * A user submits an "Invite Address" transaction to the spoke chain, specifying the use of CCIP for cross-chain communication.
   * The spoke chain calls BridgeRouter with the necessary parameters.$$\text{BridgeRouter}( \text{params}, \text{sender}, \text{destinationChainId}, \text{handler}, \text{payload}, \text{finalityLevel}, \text{extraArgs})$$&#x20;
2. **Forwarding the Message:**
   * The BridgeRouter verifies the sender and forwards the message to the appropriate adapter (e.g., CCIPAdapter).
   * The adapter processes the message and sends it to the corresponding adapter on the hub chain.
3. **Receiving the Message:**
   * The hub chain adapter receives the message, verifies its integrity, and processes it.
   * The BridgeRouter stores the message details for retry or reversal if necessary.


# Security Measures

At Folks Finance, security is a top priority, ensuring users' funds are fully protected from potential threats. The protocol incorporates a robust range of security measures to maintain the platform's integrity and reliability.

**Key Security Measures**

**Smart Contract Audits:**

Folks Finance undergoes regular audits by leading security firms to identify and fix vulnerabilities in its smart contracts.

| Audit firm | Link                                                                                                                                                      |
| ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Ottersec   | <https://github.com/Folks-Finance/audits/blob/13f8d8307902e8ff7018fe9b6df0b5668c638863/OtterSec%20-%20Audit%20of%20XChain%20Lending%20-%20May%202024.pdf> |

#### Immunefi audit competition:

Folks Finance performed two Audit competitions on Immunefi:

| Amount    | Results                                                                             |
| --------- | ----------------------------------------------------------------------------------- |
| $ 100,000 | <https://immunefi.com/audit-competition/folksfinance-boost/leaderboard/>            |
| $ 25,000  | <https://immunefi.com/audit-competition/mitigation-audit-folksfinance/leaderboard/> |

**Bug Bounty Programs:**

The platform incentivizes the community to identify and report potential vulnerabilities through bug bounty programs. Folks Finance has stumped up $200,000 as a bounty for hackers who can identify vulnerabilities in the code.

{% embed url="<https://immunefi.com/bug-bounty/folksfinance/information/>" %}

**Rate Limits:**

* To minimize risk and limit potential losses, rate limits are imposed on the maximum amount that can be transferred within a given period.
* This mechanism helps prevent large-scale exploits and ensures controlled value transfer across the protocol.

#### Secure and Reliable Oracles

Folks Finance leverages decentralized oracle like Chainlink and Pyth Network to ensure accurate and tamper-resistant price feeds. These inputs are further validated by internal consistency and freshness checks before being utilized on-chain, mitigating the risk of price manipulation.

#### Asset-Specific Limits

Folks Finance set [Collateral Caps and Borrow Caps](/technical-details/parameters), denominated in USD, for each supported asset to ensure controlled exposure and prevent excessive risk concentration.


# Oracle

Oracle is a crucial component in decentralized finance (DeFi) as it provides external data to smart contracts. \
Folks Finance uses an architecture that provides feeds that are:

* **Secure:** delivered by the most trusted oracle protocols e.g. [Chainlink](https://chain.link/), [Pyth](https://pyth.network/), [DIA](https://www.diadata.org/).
* **Reliable:** the prices, provided by multiple oracles, must be coherent i.e. not differ by more than a certain threshold.
* **Up-to-date:** each price must have been updated within a certain time threshold.

In order to accomplish this, Folks Finance relies on:

* **Chainlink**: a decentralized oracle network that enables smart contracts to interact with real-world data securely. It uses a network of independent oracles to fetch and verify external data, ensuring high security, reliability, and tamper-proof data inputs.
* **Pyth Network**: a specialized oracle network designed to provide high-fidelity, low-latency financial market data to smart contracts. It focuses on delivering real-time price feeds from a consortium of leading trading firms, exchanges, and other financial institutions.&#x20;
* **DIA**: a trustless oracle network that delivers verifiable data feeds to onchain applications, auditable from source to chain. It sources first-party trade data directly from over 100 exchanges and publishes each feed with a fully inspectable methodology, covering both digital assets and tokenized real-world assets.

{% hint style="info" %}
In the [Hub and Spoke model](/xlending/architecture#hub-and-spoke-structure), feeds are only needed in the Hub, where the protocol pools and logics are located. Each pool is directly linked to an asset, and as a result, to its feed. The OracleManager contract allows for the retrieval of an asset's price directly from its pool id, which can then be used in the protocol. This contract interacts with the NodeManager, which is responsible for fetching the feeds from the mentioned oracles and carrying out defined checks such as staleness and price threshold.
{% endhint %}


# Parameters

### Loan Parameters&#x20;

<details>

<summary>General Loan Mode Parameters</summary>

<table><thead><tr><th width="148">Asset</th><th width="132.3671875">Collateral Factor</th><th>Borrow Factor</th><th>Liquidation Bonus</th><th>Liquidation Fee</th><th>Collateral Cap ($)</th><th>Borrow Cap ($)</th></tr></thead><tbody><tr><td>USDC</td><td>80%</td><td>100%</td><td>4%</td><td>10%</td><td>30,000,000</td><td>30,000,000</td></tr><tr><td>USDT</td><td>80%</td><td>100%</td><td>4%</td><td>10%</td><td>30,000,000</td><td>10,000,000</td></tr><tr><td>USDT0</td><td>80%</td><td>100%</td><td>4%</td><td>10%</td><td>30,000,000</td><td>10,000,000</td></tr><tr><td>USDT0 (Monad)</td><td>80%</td><td>100%</td><td>10%</td><td>10%</td><td>2,500,000</td><td>2,500,000</td></tr><tr><td>USDe</td><td>75%</td><td>100%</td><td>6%</td><td>10%</td><td>0</td><td>2,000,000</td></tr><tr><td>sUSDe</td><td>75%</td><td>100%</td><td>10%</td><td>10%</td><td>1,500,000</td><td>0</td></tr><tr><td>savUSD</td><td>60%</td><td>100%</td><td>10%</td><td>10%</td><td>100,000</td><td>0</td></tr><tr><td>AUSD (Avalanche)</td><td>75%</td><td>100%</td><td>6%</td><td>10%</td><td>15,000,000</td><td>15,000,000</td></tr><tr><td>AUSD (Polygon)</td><td>75%</td><td>100%</td><td>6%</td><td>10%</td><td>3,000,000</td><td>3,000,000</td></tr><tr><td>AUSD (Monad)</td><td>70%</td><td>100%</td><td>10%</td><td>10%</td><td>1,000,000</td><td>1,000,000</td></tr><tr><td>pyUSD (Ethereum)</td><td>80%</td><td>100%</td><td>4%</td><td>10%</td><td>10,000,000</td><td>10,000,000</td></tr><tr><td>rlUSD (Ethereum)</td><td>80%</td><td>100%</td><td>4%</td><td>10%</td><td>10,000,000</td><td>10,000,000</td></tr><tr><td>EURC</td><td>77.5%</td><td>100%</td><td>6%</td><td>10%</td><td>2,000,000</td><td>1,500,000</td></tr><tr><td>ETH</td><td>80%</td><td>100%</td><td>5%</td><td>10%</td><td>30,000,000</td><td>30,000,000</td></tr><tr><td>ETH (BNB)</td><td>80%</td><td>100%</td><td>10%</td><td>10%</td><td>10,000,000</td><td>10,000,000</td></tr><tr><td>wETH.e (Avalanche)</td><td>80%</td><td>100%</td><td>5%</td><td>10%</td><td>20,000,000</td><td>20,000,000</td></tr><tr><td>wETH (Polygon)</td><td>80%</td><td>100%</td><td>5%</td><td>10%</td><td>20,000,000</td><td>20,000,000</td></tr><tr><td>wETH (SEI)</td><td>72.5%</td><td>100%</td><td>10%</td><td>10%</td><td>1,000,000</td><td>1,000,000</td></tr><tr><td>wETH (Monad)</td><td>70%</td><td>100%</td><td>10%</td><td>10%</td><td>800,000</td><td>1,000,000</td></tr><tr><td>wstETH (Arbitrum)</td><td>80%</td><td>100%</td><td>10%</td><td>10%</td><td>4,000,000</td><td>4,000,000</td></tr><tr><td>wstETH (Base)</td><td>80%</td><td>100%</td><td>7%</td><td>10%</td><td>10,000,000</td><td>10,000,000</td></tr><tr><td>wstETH (Ethereum)</td><td>80%</td><td>100%</td><td>4%</td><td>10%</td><td>10,000,000</td><td>10,000,000</td></tr><tr><td>wstETH (Polygon)</td><td>75%</td><td>100%</td><td>5%</td><td>10%</td><td>10,000,000</td><td>2,000,000</td></tr><tr><td>weETH (Arbitrum)</td><td>75%</td><td>100%</td><td>8%</td><td>10%</td><td>1,500,000</td><td>1,000,000</td></tr><tr><td>weETH (Base)</td><td>75%</td><td>100%</td><td>10%</td><td>10%</td><td>2,000,000</td><td>2,000,000</td></tr><tr><td>weETH (Ethereum)</td><td>75%</td><td>100%</td><td>4%</td><td>10%</td><td>10,000,000</td><td>10,000,000</td></tr><tr><td>rsETH (Arbitrum)</td><td>75%</td><td>100%</td><td>8%</td><td>10%</td><td>1,000,000</td><td>500,000</td></tr><tr><td>cbETH</td><td>80%</td><td>100%</td><td>7%</td><td>10%</td><td>5,000,000</td><td>5,000,000</td></tr><tr><td>wBTC (Arbitrum)</td><td>75%</td><td>100%</td><td>7%</td><td>10%</td><td>30,000,000</td><td>20,000,000</td></tr><tr><td>wBTC (Ethereum)</td><td>75%</td><td>100%</td><td>5%</td><td>10%</td><td>30,000,000</td><td>30,000,000</td></tr><tr><td>wBTC (Polygon)</td><td>75%</td><td>100%</td><td>7%</td><td>10%</td><td>30,000,000</td><td>20,000,000</td></tr><tr><td>wBTC (SEI)</td><td>75%</td><td>100%</td><td>10%</td><td>10%</td><td>1,000,000</td><td>1,000,000</td></tr><tr><td>wBTC(Monad)</td><td>70%</td><td>100%</td><td>10%</td><td>10%</td><td>500,000</td><td>250,000</td></tr><tr><td>BTC.b</td><td>72.5%</td><td>100%</td><td>6%</td><td>10%</td><td>20,000,000</td><td>20,000,000</td></tr><tr><td>BTCB</td><td>72.5%</td><td>100%</td><td>10%</td><td>10%</td><td>20,000,000</td><td>10,000,000</td></tr><tr><td>cbBTC</td><td>75%</td><td>100%</td><td>10%</td><td>10%</td><td>20,000,000</td><td>5,000,000</td></tr><tr><td>tBTC (Arbitrum)</td><td>75%</td><td>100%</td><td>8%</td><td>10%</td><td>2,500,000</td><td>2,500,000</td></tr><tr><td>solvBTC</td><td>72.5%</td><td>100%</td><td>10%</td><td>10%</td><td>5,000,000</td><td>1,000,000</td></tr><tr><td>YBTC.B</td><td>30%</td><td>100%</td><td>10%</td><td>10%</td><td>50,000</td><td>50,000</td></tr><tr><td>AVAX</td><td>72.5%</td><td>100%</td><td>8%</td><td>10%</td><td>30,000,000</td><td>30,000,000</td></tr><tr><td>sAVAX</td><td>70%</td><td>100%</td><td>10%</td><td>10%</td><td>20,000,000</td><td>5,000,000</td></tr><tr><td>stAVAX</td><td>55%</td><td>100%</td><td>10%</td><td>10%</td><td>3,000,000</td><td>1,000,000</td></tr><tr><td>BNB</td><td>75%</td><td>100%</td><td>10%</td><td>10%</td><td>20,000,000</td><td>10,000,000</td></tr><tr><td>POL</td><td>75%</td><td>100%</td><td>8%</td><td>10%</td><td>35,000,000</td><td>35,000,000</td></tr><tr><td>MATICX</td><td>60%</td><td>100%</td><td>10%</td><td>10%</td><td>1,000,000</td><td>1,000,000</td></tr><tr><td>ARB</td><td>65%</td><td>100%</td><td>10%</td><td>10%</td><td>5,000,000</td><td>5,000,000</td></tr><tr><td>AERO</td><td>65%</td><td>100%</td><td>10%</td><td>10%</td><td>3,500,000</td><td>3,500,000</td></tr><tr><td>JOE</td><td>45%</td><td>100%</td><td>10%</td><td>10%</td><td>500,000</td><td>500,000</td></tr><tr><td>LINK</td><td>70%</td><td>100%</td><td>9%</td><td>10%</td><td>1,000,000</td><td>1,000,000</td></tr><tr><td>wstLINK</td><td>65%</td><td>100%</td><td>10%</td><td>10%</td><td>3,000,000</td><td>0</td></tr><tr><td>Kaito</td><td>55%</td><td>100%</td><td>10%</td><td>10%</td><td>500,000</td><td>500,000</td></tr><tr><td>Virtual</td><td>70%</td><td>100%</td><td>10%</td><td>10%</td><td>5,000,000</td><td>5,000,000</td></tr><tr><td>SEI</td><td>55%</td><td>100%</td><td>10%</td><td>10%</td><td>2,500,000</td><td>2,500,000</td></tr><tr><td>iSEI</td><td>50%</td><td>100%</td><td>10%</td><td>10%</td><td>2,500,000</td><td>2,500,000</td></tr><tr><td>ATH</td><td>55%</td><td>100%</td><td>10%</td><td>10%</td><td>1,500,000</td><td>0</td></tr><tr><td>SYRUP</td><td>65%</td><td>100%</td><td>10%</td><td>10%</td><td>1,500,000</td><td>0</td></tr><tr><td>MON</td><td>50%</td><td>100%</td><td>10%</td><td>10%</td><td>5,000,000</td><td>5,000,000</td></tr><tr><td>sMON</td><td>45%</td><td>100%</td><td>10%</td><td>10%</td><td>150,000</td><td>0</td></tr><tr><td>gMON</td><td>45%</td><td>100%</td><td>10%</td><td>10%</td><td>150,000</td><td>0</td></tr><tr><td>shMON</td><td>45%</td><td>100%</td><td>10%</td><td>10%</td><td>500,000</td><td>0</td></tr></tbody></table>

</details>

<details>

<summary>AVAX Efficiency Loan Mode Parameters </summary>

| Asset  | Collateral Factor | Borrow Factor | Liquidation Bonus | Liquidation Fee | Collateral Cap ($) | Borrow Cap ($) |
| ------ | ----------------- | ------------- | ----------------- | --------------- | ------------------ | -------------- |
| AVAX   | 85%               | 100%          | 4.0%              | 10%             | 30,000,000         | 30,000,000     |
| sAVAX  | 85%               | 100%          | 5.0%              | 10%             | 20,000,000         | 10,000,000     |
| stAVAX | 85%               | 100%          | 5.0%              | 10%             | 3,000,000          | 3,000,000      |

</details>

<details>

<summary>ETH Efficiency Loan Mode Parameters</summary>

| Asset              | Collateral Factor | Borrow Factor | Liquidation Bonus | Liquidation Fee | Collateral Cap ($) | Borrow Cap ($) |
| ------------------ | ----------------- | ------------- | ----------------- | --------------- | ------------------ | -------------- |
| ETH (Arbitrum)     | 90%               | 100%          | 4.0%              | 10%             | 15,000,000         | 10,000,000     |
| ETH (Base)         | 90%               | 100%          | 4.0%              | 10%             | 15,000,000         | 10,000,000     |
| ETH (BNB)          | 90%               | 100%          | 4.0%              | 10%             | 5,000,000          | 1,500,000      |
| ETH (Ethereum)     | 90%               | 100%          | 4.0%              | 10%             | 30,000,000         | 15,000,000     |
| WETH.e (Avalanche) | 90%               | 100%          | 4.0%              | 10%             | 5,000,000          | 3,500,000      |
| wETH (Polygon)     | 90%               | 100%          | 4.0%              | 10%             | 5,000,000          | 3,500,000      |
| wETH (SEI)         | 82.5%             | 100%          | 7.0%              | 10%             | 1,000,000          | 1,000,000      |
| wstETH (Arbitrum)  | 90%               | 100%          | 5.0%              | 10%             | 10,000,000         | 2,000,000      |
| wstETH (Base)      | 85%               | 100%          | 5.0%              | 10%             | 10,000,000         | 10,000,000     |
| wstETH (Ethereum)  | 85%               | 100%          | 4.0%              | 10%             | 10,000,000         | 10,000,000     |
| wstETH (Polygon)   | 85%               | 100%          | 5.0%              | 10%             | 5,000,000          | 4,500,000      |
| weETH (Arbitrum)   | 85%               | 100%          | 6.0%              | 10%             | 500,000            | 0              |
| weETH (Base)       | 85%               | 100%          | 6.0%              | 10%             | 2,000,000          | 2,000,000      |
| weETH (Ethereum)   | 85%               | 100%          | 4.0%              | 10%             | 10,000,000         | 10,000,000     |
| rsETH (Arbitrum)   | 80%               | 100%          | 6.0%              | 10%             | 500,000            | 0              |
| cbETH (Base)       | 90%               | 100%          | 5.0%              | 10%             | 5,000,000          | 5,000,000      |

</details>

<details>

<summary>Stablecoin Efficiency Mode Parameters</summary>

<table><thead><tr><th>Asset</th><th>Collateral Factor</th><th>Borrow Factor</th><th>Liquidation Bonus</th><th>Liquidation Fee</th><th width="153.5234375">Collateral Cap ($)</th><th>Borrow Cap ($)</th></tr></thead><tbody><tr><td>USDC</td><td>90%</td><td>100%</td><td>4.0%</td><td>10%</td><td>20,000,000</td><td>20,000,000</td></tr><tr><td>USDT</td><td>90%</td><td>100%</td><td>4.0%</td><td>10%</td><td>20,000,000</td><td>20,000,000</td></tr><tr><td>USDT0</td><td>90%</td><td>100%</td><td>4.0%</td><td>10%</td><td>20,000,000</td><td>20,000,000</td></tr><tr><td>USDT0 (Monad)</td><td>85%</td><td>100%</td><td>6.0%</td><td>10%</td><td>10,000,000</td><td>10,000,000</td></tr><tr><td>USDe</td><td>90%</td><td>100%</td><td>4.0%</td><td>10%</td><td>0</td><td>3,000,000</td></tr><tr><td>sUSDe</td><td>90%</td><td>100%</td><td>4.0%</td><td>10%</td><td>3,000,000</td><td>0</td></tr><tr><td>AUSD (Avalanche)</td><td>85%</td><td>100%</td><td>4.0%</td><td>10%</td><td>10,000,000</td><td>10,000,000</td></tr><tr><td>AUSD (Polygon)</td><td>85%</td><td>100%</td><td>4.0%</td><td>10%</td><td>3,000,000</td><td>3,000,000</td></tr><tr><td>AUSD (Monad)</td><td>80%</td><td>100%</td><td>6.0%</td><td>10%</td><td>1,000,000</td><td>200,000</td></tr><tr><td>savUSD</td><td>75%</td><td>100%</td><td>4.0%</td><td>10%</td><td>2,000,000</td><td>0</td></tr><tr><td>rlUSD</td><td>85%</td><td>100%</td><td>4.0%</td><td>10%</td><td>5,000,000</td><td>5,000,000</td></tr><tr><td>pyUSD</td><td>85%</td><td>100%</td><td>4.0%</td><td>10%</td><td>7,500,000</td><td>7,500,000</td></tr></tbody></table>

</details>

<details>

<summary>Polygon Efficiency Mode Parameters</summary>

| POL    | 85% | 100% | 4.0% | 10% | 5,000,000 | 5,000,000 |
| ------ | --- | ---- | ---- | --- | --------- | --------- |
| MATICX | 85% | 100% | 5.0% | 10% | 2,500,000 | 2,000,000 |

</details>

<details>

<summary>Bitcoin Efficiency Mode Parameters</summary>

| Asset             | Collateral Factor | Borrow Factor | Liquidation Bonus | Liquidation Fee | Collateral Cap ($) | Borrow Cap ($) |
| ----------------- | ----------------- | ------------- | ----------------- | --------------- | ------------------ | -------------- |
| wBTC (Ethereum)   | 85%               | 100%          | 4.0%              | 10%             | 30,000,000         | 30,000,000     |
| wBTC (Polygon)    | 85%               | 100%          | 5.0%              | 10%             | 2,500,000          | 2,500,000      |
| wBTC (Arbitrum)   | 85%               | 100%          | 4.0%              | 10%             | 10,000,000         | 10,000,000     |
| wBTC (SEI)        | 80%               | 100%          | 7.0%              | 10%             | 1,000,000          | 1,000,000      |
| wBTC (Monad)      | 75%               | 100%          | 8.0%              | 10%             | 500,000            | 500,000        |
| BTC.b (Avalanche) | 82.5%             | 100%          | 5.0%              | 10%             | 3,000,000          | 3,000,000      |
| BTCB (BSC)        | 82.5%             | 100%          | 6.0%              | 10%             | 5,000,000          | 5,000,000      |
| cbBTC (Base)      | 85%               | 100%          | 6.0%              | 10%             | 10,000,000         | 10,000,000     |
| solvBTC           | 75%               | 100%          | 6.0%              | 10%             | 2,000,000          | 2,000,000      |
| tBTC (Arbitrum)   | 85%               | 100%          | 5.0%              | 10%             | 2,000,000          | 2,000,000      |
| YBTC.B            | 40%               | 100%          | 10.0%             | 10%             | 250,000            | 250,000        |

</details>

<details>

<summary>Sei Efficiency Mode Parameters </summary>

| Asset | Collateral Factor | Borrow Factor | Liquidation Bonus | Liquidation Fee | Collateral Cap ($) | Borrow Cap ($) |
| ----- | ----------------- | ------------- | ----------------- | --------------- | ------------------ | -------------- |
| SEI   | 85%               | 100%          | 4.0%              | 10%             | 0                  | 2,500,000      |
| iSEI  | 80%               | 100%          | 4.0%              | 10%             | 2,500,000          | 0              |

</details>

<details>

<summary>Link Efficiency Loan Parameters</summary>

| Asset   | Collateral Factor | Borrow Factor | Liquidation Bonus | Liquidation Fee | Collateral Cap | Borrow Cap |
| ------- | ----------------- | ------------- | ----------------- | --------------- | -------------- | ---------- |
| LINK    | 85%               | 100%          | 7.0%              | 10%             | 0              | 1,500,000  |
| wstLINK | 85%               | 100%          | 7.0%              | 10%             | 1,500,000      | 0          |

</details>

<details>

<summary>Mon Efficiency Loan Parameters</summary>

| Asset | Collateral Factor | Borrow Factor | Liquidation Bonus | Liquidation Fee | Collateral Cap | Borrow Cap |
| ----- | ----------------- | ------------- | ----------------- | --------------- | -------------- | ---------- |
| MON   | 85%               | 100%          | 5.0%              | 10%             | 0              | 800,000    |
| sMON  | 80%               | 100%          | 5.0%              | 10%             | 350,000        | 0          |
| gMON  | 80%               | 100%          | 5.0%              | 10%             | 350,000        | 0          |
| shMON | 80%               | 100%          | 5.0%              | 10%             | 500,000        | 0          |

</details>

### Pool Parameters

<details>

<summary>Pool parameters </summary>

| Pool               | FL Fee | RR  | (Uopt) | (RV0) | (RV1) | (RV2) | (RS0) | (RS1) | (RS2) | (RS3) | (Oratio) | (URU) | (DIRRU) | (RD) | Deposit Cap ($) | Borrow Cap ($) | Single Stable Borrow Percentage Cap |
| ------------------ | ------ | --- | ------ | ----- | ----- | ----- | ----- | ----- | ----- | ----- | -------- | ----- | ------- | ---- | --------------- | -------------- | ----------------------------------- |
| USDC               | 0.10%  | 10% | 90%    | 0.00% | 7.00% | 40%   | 2%    | 2%    | 100%  | 25%   | 20%      | 95%   | 40%     | 20%  | 150,000,000     | 30,000,000     | 6%                                  |
| USDT               | 0.10%  | 10% | 90%    | 0.00% | 7.00% | 40%   | 2%    | 2%    | 100%  | 25%   | 20%      | 95%   | 40%     | 20%  | 50,000,000      | 10,000,000     | 6%                                  |
| USDT0              | 0.10%  | 10% | 90%    | 0.00% | 5.00% | 40%   | 2%    | 2%    | 100%  | 25%   | 20%      | 95%   | 40%     | 20%  | 50,000,000      | 10,000,000     | 6%                                  |
| USDT0 (Monad)      | 0.10%  | 10% | 85%    | 0.00% | 5.00% | 40%   | 2%    | 2%    | 100%  | 25%   | 20%      | 95%   | 40%     | 20%  | 10,000,000      | 10,000,000     | 6%                                  |
| USDe               | 0.10%  | 10% | 90%    | 0.00% | 6.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 0               | 0              | 5%                                  |
| sUSDe              | 0.10%  | 10% | 50%    | 0.00% | 6.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 1,000,000       | 0              | 5%                                  |
| savUSD             | 0.10%  | 10% | 50%    | 0.00% | 6.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 1,000,000       | 0              | 5%                                  |
| AUSD (Avalanche)   | 0.10%  | 10% | 90%    | 0.00% | 7.00% | 40%   | 2%    | 2%    | 200%  | 25%   | 20%      | 95%   | 40%     | 20%  | 1,500,000       | 1,500,000      | 5%                                  |
| AUSD (Polygon)     | 0.10%  | 10% | 85%    | 0.00% | 7.00% | 50%   | 2%    | 2%    | 200%  | 25%   | 20%      | 95%   | 40%     | 20%  | 500,000         | 500,000        | 5%                                  |
| AUSD (Monad)       | 0.10%  | 10% | 85%    | 0.00% | 7.00% | 50%   | 2%    | 2%    | 200%  | 25%   | 20%      | 95%   | 40%     | 20%  | 500,000         | 500,000        | 5%                                  |
| pyUSD (Ethereum)   | 0.10%  | 10% | 80%    | 0.00% | 6.50% | 50%   | 2%    | 2%    | 100%  | 25%   | 20%      | 95%   | 40%     | 20%  | 30,000,000      | 10,000,000     | 6%                                  |
| rlUSD (Ethereum)   | 0.10%  | 10% | 80%    | 0.00% | 6.50% | 50%   | 2%    | 2%    | 100%  | 25%   | 20%      | 95%   | 40%     | 20%  | 30,000,000      | 10,000,000     | 5%                                  |
| EURC               | 0.10%  | 10% | 80%    | 0.00% | 6.00% | 100%  | 1%    | 1%    | 100%  | 35%   | 20%      | 90%   | 55%     | 20%  | 10,000,000      | 1,500,000      | 5%                                  |
| ETH                | 0.10%  | 10% | 70%    | 0.00% | 2.50% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 150,000,000     | 30,000,000     | 5%                                  |
| ETH (BNB)          | 0.10%  | 10% | 70%    | 0.00% | 2.50% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 50,000,000      | 10,000,000     | 5%                                  |
| wETH.e (Avalanche) | 0.10%  | 10% | 70%    | 0.00% | 2.50% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 75,000,000      | 20,000,000     | 5%                                  |
| wETH (Polygon)     | 0.10%  | 10% | 70%    | 0.00% | 2.50% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 75,000,000      | 20,000,000     | 5%                                  |
| wETH (SEI)         | 0.10%  | 10% | 70%    | 0.00% | 2.50% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 5,000,000       | 1,000,000      | 5%                                  |
| wETH (Monad)       | 0.10%  | 10% | 70%    | 0.00% | 2.50% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 5,000,000       | 2,000,000      | 5%                                  |
| wstETH (Arbitrum)  | 0.10%  | 10% | 70%    | 0.00% | 7.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 20,000,000      | 4,000,000      | 5%                                  |
| wstETH (Base)      | 0.10%  | 10% | 70%    | 0.00% | 7.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 20,000,000      | 10,000,000     | 5%                                  |
| wstETH (Ethereum)  | 0.10%  | 10% | 70%    | 0.00% | 7.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 20,000,000      | 10,000,000     | 5%                                  |
| wstETH (Polygon)   | 0.10%  | 10% | 85%    | 0.00% | 5.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 30,000,000      | 6,500,000      | 5%                                  |
| weETH (Arbitrum)   | 0.10%  | 10% | 45%    | 1.00% | 6.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 0               | 0              | 5%                                  |
| weETH (Base)       | 0.10%  | 10% | 45%    | 1.00% | 6.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 0               | 0              | 5%                                  |
| weETH (Ethereum)   | 0.10%  | 10% | 45%    | 1.00% | 6.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 0               | 0              | 5%                                  |
| rsETH (Arbitrum)   | 0.10%  | 10% | 45%    | 1.00% | 6.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 0               | 0              | 5%                                  |
| cbETH              | 0.10%  | 10% | 80%    | 0.00% | 6.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 30,000,000      | 5,000,000      | 5%                                  |
| wBTC (Arbitrum)    | 0.10%  | 10% | 80%    | 0.00% | 4.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 150,000,000     | 20,000,000     | 5%                                  |
| wBTC (Ethereum)    | 0.10%  | 10% | 80%    | 0.00% | 4.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 150,000,000     | 30,000,000     | 5%                                  |
| wBTC (Polygon)     | 0.10%  | 10% | 80%    | 0.00% | 4.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 150,000,000     | 20,000,000     | 5%                                  |
| wBTC (SEI)         | 0.10%  | 10% | 50%    | 0.00% | 4.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 5,000,000       | 1,000,000      | 5%                                  |
| wBTC (Monad)       | 0.10%  | 10% | 50%    | 0.00% | 4.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 5,000,000       | 1,000,000      | 5%                                  |
| BTC.b              | 0.10%  | 10% | 80%    | 0.00% | 4.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 100,000,000     | 20,000,000     | 5%                                  |
| BTCB               | 0.10%  | 10% | 80%    | 0.00% | 4.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 50,000,000      | 10,000,000     | 5%                                  |
| cbBTC              | 0.10%  | 10% | 80%    | 0.00% | 4.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 50,000,000      | 5,000,000      | 5%                                  |
| tBTC (Arbitrum)    | 0.10%  | 10% | 80%    | 0.00% | 6.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 4,500,000       | 2,500,000      | 5%                                  |
| solvBTC            | 0.10%  | 10% | 45%    | 0.00% | 6.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 5,000,000       | 1,000,000      | 5%                                  |
| YBTC.B             | 0.10%  | 10% | 45%    | 0.00% | 6.00% | 400%  | 1%    | 1%    | 400%  | 35%   | 20%      | 90%   | 55%     | 20%  | 0               | 0              | 5%                                  |
| AVAX               | 0.10%  | 10% | 80%    | 0.00% | 5.50% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 100,000,000     | 50,000,000     | 5%                                  |
| sAVAX              | 0.10%  | 10% | 65%    | 0.00% | 6.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 50,000,000      | 15,000,000     | 5%                                  |
| stAVAX             | 0.10%  | 10% | 50%    | 0.00% | 6.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 5,000,000       | 4,000,000      | 5%                                  |
| tAVAX              | 0.10%  | 10% | 45%    | 1.00% | 6.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 10,000,000      | 0              | 5%                                  |
| tETH               | 0.10%  | 10% | 45%    | 1.00% | 6.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 1,000,000       | 0              | 5%                                  |
| BNB                | 0.10%  | 10% | 50%    | 0.00% | 6.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 50,000,000      | 10,000,000     | 5%                                  |
| POL                | 0.10%  | 10% | 75%    | 0.00% | 4.50% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 50,000,000      | 35,000,000     | 5%                                  |
| MATICX             | 0.10%  | 10% | 90%    | 1.00% | 6.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 30,000,000      | 3,000,000      | 5%                                  |
| ARB                | 0.10%  | 10% | 50%    | 0.00% | 6.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 10,000,000      | 5,000,000      | 5%                                  |
| AERO               | 0.10%  | 10% | 50%    | 0.00% | 6.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 10,000,000      | 3,500,000      | 5%                                  |
| JOE                | 0.10%  | 10% | 45%    | 1.00% | 9.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 5,000,000       | 500,000        | 5%                                  |
| SHIB               | 0.10%  | 10% | 45%    | 1.00% | 9.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 5,000,000       | 1,000,000      | 5%                                  |
| LINK               | 0.10%  | 10% | 45%    | 0.00% | 4.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 10,000,000      | 1,000,000      | 5%                                  |
| wstLINK            | 0.10%  | 10% | 50%    | 0.00% | 6.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 5,000,000       | 0              | 5%                                  |
| Kaito              | 0.10%  | 10% | 30%    | 0.00% | 9.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 2,000,000       | 500,000        | 5%                                  |
| Virtual            | 0.10%  | 10% | 45%    | 0.00% | 9.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 10,000,000      | 5,000,000      | 5%                                  |
| SEI                | 0.10%  | 10% | 80%    | 0.00% | 4.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 5,000,000       | 2,500,000      | 5%                                  |
| iSEI               | 0.10%  | 10% | 50%    | 0.00% | 6.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 5,000,000       | 2,500,000      | 5%                                  |
| ATH                | 0.10%  | 10% | 30%    | 0.00% | 9.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 2,000,000       | 0              | 5%                                  |
| SYRUP              | 0.10%  | 10% | 50%    | 0.00% | 2.00% | 400%  | 1%    | 1%    | 400%  | 35%   | 20%      | 90%   | 55%     | 20%  | 5,000,000       | 0              | 5%                                  |
| MON                | 0.10%  | 10% | 90%    | 0.00% | 5.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 10,000,000      | 6,000,000      | 5%                                  |
| sMON               | 0.10%  | 10% | 50%    | 0.00% | 6.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 5,000,000       | 0              | 5%                                  |
| gMON               | 0.10%  | 10% | 50%    | 0.00% | 6.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 5,000,000       | 0              | 5%                                  |
| shMON              | 0.10%  | 10% | 50%    | 0.00% | 6.00% | 200%  | 1%    | 1%    | 200%  | 35%   | 20%      | 90%   | 55%     | 20%  | 5,000,000       | 0              | 5%                                  |

</details>

### Rate Limits

<details>

<summary>Avalanche</summary>

| Token     | Period | Limit          | Min Limit |
| --------- | ------ | -------------- | --------- |
| USDC      | 1 day  | 1,000,000      | 5,000     |
| USDT\_ava | 1 day  | 1,000,000      | 1%        |
| AVAX      | 1 day  | 20,000         | 1%        |
| sAVAX     | 1 day  | 10,000         | 1%        |
| wETH\_ava | 1 day  | 200            | 1%        |
| BTCb\_ava | 1 day  | 10             | 1%        |
| SolvBTC   | 1 day  | 10             | 0.05      |
| JOE       | 1 day  | 1,000,000      | 1%        |
| ggAVAX    | 1 day  | 10,000         | 1%        |
| SHIB      | 1 day  | 50,000,000,000 | 0.05      |
| aUSD\_ava | 1 day  | 1,000,000      | 1%        |
| savUSD    | 1 day  | 1,000,000      | 1%        |
| YBTC      | 1 day  | 10             | 0.05      |
| USDE      | 1 day  | 1,000,000      | 1%        |
| sUSDE     | 1 day  | 1,000,000      | 1%        |
| EURC      | 1 day  | 2,000,000      | 1%        |
| tETH      | 1 day  | 300            | 1         |
| tAVAX     | 1 day  | 50,000         | 1%        |
| wstLINK   | 1 day  | 100,000        | 500       |

</details>

<details>

<summary>Ethereum</summary>

| Token      | Period | Limit          | Min Limit |
| ---------- | ------ | -------------- | --------- |
| USDC       | 1 day  | 500,000        | 5,000     |
| USDT\_eth  | 1 day  | 500,000        | 5,000     |
| ETH\_eth   | 1 day  | 200            | 1%        |
| wBTC\_eth  | 1 day  | 5              | 1%        |
| SolvBTC    | 1 day  | 5              | 0.05      |
| SHIB       | 1 day  | 25,000,000,000 | 0.05      |
| ATH        | 1 day  | 5,000,000      | 1%        |
| PYUSD      | 1 day  | 500,000        | 1%        |
| RLUSD      | 1 day  | 500,000        | 1%        |
| wstETH     | 1 day  | 150            | 1%        |
| weETH      | 1 day  | 150            | 1%        |
| YBTC       | 1 day  | 10             | 0.05      |
| SYRUP\_eth | 1 day  | 2,500,000      | 1%        |
| tETH       | 1 day  | 300            | 1         |
| wstLINK    | 1 day  | 100,000        | 500       |

</details>

<details>

<summary>Base</summary>

| Token       | Period | Limit          | Min Limit |
| ----------- | ------ | -------------- | --------- |
| USDC        | 1 day  | 500,000        | 5,000     |
| ETH\_base   | 1 day  | 200            | 1%        |
| cbBTC\_base | 1 day  | 5              | 1%        |
| SolvBTC     | 1 day  | 5              | 0.05      |
| SHIB        | 1 day  | 25,000,000,000 | 0.05      |
| AERO        | 1 day  | 400,000        | 1%        |
| cbETH       | 1 day  | 150            | 1%        |
| wstETH      | 1 day  | 150            | 1%        |
| weETH       | 1 day  | 150            | 1%        |
| VIRTUAL     | 1 day  | 250,000        | 1%        |
| KAITO       | 1 day  | 250,000        | 1%        |

</details>

<details>

<summary>BNB Chain</summary>

| Token     | Period | Limit | Min Limit |
| --------- | ------ | ----- | --------- |
| BNB       | 1 day  | 1000  | 1%        |
| ETHB\_bsc | 1 day  | 200   | 1%        |
| BTCB\_bsc | 1 day  | 5     | 1%        |
| SolvBTC   | 1 day  | 5     | 0.05      |

</details>

<details>

<summary>Arbitrum</summary>

| Token      | Period | Limit          | Min Limit |
| ---------- | ------ | -------------- | --------- |
| USDC       | 1 day  | 500,000        | 5,000     |
| USDT0\_arb | 1 day  | 1,000,000      | 5,000     |
| ETH\_arb   | 1 day  | 200            | 1%        |
| ARB        | 1 day  | 1,000,000      | 1%        |
| SolvBTC    | 1 day  | 5              | 0.05      |
| SHIB       | 1 day  | 25,000,000,000 | 0.05      |
| wBTC\_arb  | 1 day  | 5              | 1%        |
| tBTC       | 1 day  | 5              | 1%        |
| wstETH     | 1 day  | 150            | 1%        |
| weETH      | 1 day  | 150            | 1%        |
| rsETH      | 1 day  | 150            | 1%        |
| wstLINK    | 1 day  | 100,000        | 500       |

</details>

<details>

<summary>Polygon</summary>

| Token     | Period | Limit          | Min Limit |
| --------- | ------ | -------------- | --------- |
| USDC      | 1 day  | 500,000        | 5,000     |
| USDT\_pol | 1 day  | 1,000,000      | 1%        |
| POL       | 1 day  | 1,000,000      | 1%        |
| wBTC\_pol | 1 day  | 5              | 1%        |
| wETH\_pol | 1 day  | 200            | 1%        |
| SHIB      | 1 day  | 25,000,000,000 | 0.05      |
| wstETH    | 1 day  | 150            | 1%        |
| LINK      | 1 day  | 25,000         | 1%        |
| MATICX    | 1 day  | 500,000        | 1%        |
| wstLINK   | 1 day  | 100,000        | 500       |
| aUSD\_pol | 1 day  | 1,000,000      | 1%        |

</details>

<details>

<summary>Sei</summary>

| Token      | Period | Limit     | Min Limit |
| ---------- | ------ | --------- | --------- |
| SEI        | 1 day  | 2,000,000 | 1%        |
| iSEI       | 1 day  | 2,000,000 | 1%        |
| USDT0\_sei | 1 day  | 1,000,000 | 1%        |
| wETH\_sei  | 1 day  | 400       | 1%        |
| wBTC\_sei  | 1 day  | 10        | 1%        |

</details>

<details>

<summary>Monad</summary>

|            |        |            |           |
| ---------- | ------ | ---------- | --------- |
| Token      | Period | Limit      | Min Limit |
| MON        | 1 day  | 50,000,000 | 1%        |
| wBTC\_mon  | 1 day  | 5          | 1%        |
| wETH\_mon  | 1 day  | 200        | 1%        |
| sMON       | 1 day  | 25,000,000 | 1%        |
| aUSD\_mon  | 1 day  | 1,000,000  | 1%        |
| USDT0\_mon | 1 day  | 1,000,000  | 1%        |
| gMON       | 1 day  | 25,000,000 | 1%        |

</details>


# Points system

The Folks Finance points system is designed to reward users for engaging with the protocol, encouraging continued participation and long-term usage. Points are accumulated separately for each token type (e.g., USDC, ETH, AVAX), and users can track their total points across different activities and assets.&#x20;

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

### How Points Are Earned

1. Depositing and Collateralizing:

   Users earn points when they deposit assets into the protocol or use their assets as collateral. The more you deposit and the longer you keep your deposit or collateral, the more points you accumulate.
2. Borrowing:

   Points are awarded for borrowing assets from the protocol. The longer the borrowed position is maintained, the more points the user earns.
3. Repaying:

   Users accumulate points by repaying borrowed funds.
4. On-Chain and Social Tasks: \
   Additional points can be earned by completing tasks on-chain or via social platforms like [Galxe](https://app.galxe.com/quest/FolksFinance/GC5j2txPjh) and other integrations.
5. Referral:

   Users can earn points by inviting others to join the platform, with points granted to both the referrer and the referred user.

{% hint style="success" %}
In line with Folks Finance’s cross-chain philosophy, assets that are natively cross-chain are assigned a higher score in the point system. This reflects their unique ability to facilitate interoperability across different blockchain ecosystems, aligning with Folks Finance's mission to support and promote a more connected and efficient DeFi landscape.
{% endhint %}

{% hint style="info" %}
Algorand users get points through the above methods plus the following:

1. Liquid staking:\
   Users earn points by staking ALGO. The more ALGO deposited and the longer it remains staked, the more points are earned. [Stake now](https://app.folks.finance/liquid-staking).
2. Swaps:\
   Users collect points performing swaps through Folks Router aggregator.
3. Flash Loans:\
   Users who performs flash loan are eligible to earn points.&#x20;

### FAQ

1. Can I get points on depositing on Algorand and xChain? Yes, xChain and Algorand points are collected separated and they are merged in a single leaderboard.
2. Will Algorand users who interacted with the Algorand app before the introduction of the points system receive a retroactive drop? Yes.&#x20;
3. Can I link multiple Algorand addresses to my xChain account? Yes.
   {% endhint %}

### Referral system

Folks Finance's referral system is designed to incentivise users to invite other users to the platform by rewarding both the referrer and the referred user. When a new user joins the protocol using a referral link, they earn ‘first sign-ins’ points after creating their first account, and the referrer earns a percentage of the referrer's accumulated points over time. This system encourages community growth and engagement, offering a win-win scenario for both parties, who benefit from increased participation. Referrers can keep track of points earned through referrals directly in their dashboard.

### Leaderboard&#x20;

The leaderboard offers a transparent way to track progress and performance within the Folks Finance Incentives Program. Points accumulated through various activities and contributions are reflected here, allowing participants to see how they rank compared to others.

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


# Interests

### Deposit Boost

To incentivize engagement with the xChain protocol, Folks Finance has introduced a rewards program that distributes token to users who actively deposit assets and/or use them as collateral.

The incentive distribution is managed by a public smart contract, ensuring transparency and automation in the reward process. Rewards are distributed weekly, and users can claim their accumulated rewards directly within the protocol.

The total amount of rewards distributed each week is determined by Folks Finance and may vary over time based on the market strategies and users requests.

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td>Folks Finance has received a total of 13,145 AVAX from Avalanche Foundation, either already distributed or currently being distributed.</td><td><a href="/files/CHsMH8gXkoS2n0I51LmG">/files/CHsMH8gXkoS2n0I51LmG</a></td></tr><tr><td>Folks Finance has received a total of 25,000 USDC from Arbitrum Foundation, either already distributed or currently being distributed.</td><td><a href="/files/056WjLMDbJcFCj6Sq6uF">/files/056WjLMDbJcFCj6Sq6uF</a></td></tr><tr><td>Folks Finance has received an equivalent of 300,000 USD from Polygon Foundation, either already distributed or currently being distributed.</td><td><a href="/files/c7BWAHVE6rpY0zt6vWNE">/files/c7BWAHVE6rpY0zt6vWNE</a></td></tr></tbody></table>

#### How to claim rewards

1. Once the weekly incentives period ends, go to your Deposit or Loan page.
2. Click on Claim Rewards
3. Click on Claim and sign with your wallet.

{% hint style="info" %}
[Click here for a detailed spreadsheet of Folks’ incentive distribution plans.](https://docs.google.com/spreadsheets/d/1b2mH4N4OdIBRKJoXWwtS19IoBhF9oUOavW2rXqUdiZ8/edit?gid=0#gid=0)&#x20;
{% endhint %}

{% hint style="info" %}
Deposits or collateral valued at less than $1 will not be considered for any distributions. Additionally, pending rewards amounting to less than 0.0001 AVAX will not be considered.
{% endhint %}

### Intrinsic APY

Intrinsic APY refers to the yield generated *natively* by the asset itself, independent of any additional rewards provided by Folks Finance.

This may include:

* Staking rewards: If the token supports staking, it can produce protocol-level rewards as part of its native functionality.
* External incentives: Some tokens may receive incentives from third-party protocols or ecosystem programs.


# Contracts

<details>

<summary>Avalanche</summary>

| Name                         | Address                                    |
| ---------------------------- | ------------------------------------------ |
| Spoke Common                 | 0xc03094c4690f3844ea17ef5272bf6376e0cf2ac6 |
| Bridge Router Spoke          | 0xf854ac65a40f1eabfd32e6d4c7d0e1c4b1753cc5 |
| USDC Spoke Address           | 0xcd68014c002184707eae7218516cb0762a44fddf |
| AVAX Spoke Address           | 0xe69e068539ee627bab1ce878843a6c76484cbd2c |
| sAVAX Spoke Address          | 0x23a96d92c80e8b926da40e574d615d9e806a87f6 |
| wETH Spoke Address           | 0x0e563b9fe6d9ef642bdba20d53ac5137eb0d78dc |
| BTCb Spoke Address           | 0xef7a6ebede2ad558db8c36df65365b209e5d57dc |
| SolvBTC Spoke Address        | 0x9e4456f0d03a263653E01EdFC8C1447A8c3E1a5a |
| JOE Spoke Address            | 0x3b1C2eC8B7cdE241E0890C9742C14dD7867aA812 |
| ggAVAX Spoke Address         | 0xe53189D00D1b4F231A2a208a7967E0dCaE8Db073 |
| aUSD Spoke Address           | 0x666aea026bC606220ec6eb83a83D81881fA48e0f |
| savUSD Spoke Address         | 0xe396E1246B7341Eb6EDA05DCfef9EaB9E661f80C |
| USDt Spoke Address           | 0x66dD1c6bEAdFFcA88365BAdE7928323672323d11 |
| YBTCB Spoke Address          | 0x24dB057615203c0f27F0968452A0f2327e6bC86F |
| SHIB Spoke Address           | 0x93FD598238377BDcad1712B7FeDA421a02527d7B |
| USDe Spoke Address           | 0x07C911b5a1657126B14C25e697E3d00f3a134A23 |
| sUSDe Spoke Address          | 0x1C7EC7198F297119D4e9f359d91127c8B2f9A9D2 |
| EURC Spoke Address           | 0xe47285cc79A8de62DFaED52Abe919B87973294C8 |
| tETH Spoke Address           | 0xFdf0BF117FF6fdB98af9bFcEDF303aF64A09fF58 |
| tAVAX Spoke Address          | 0x0aeE2B84bd3E280CFcc9325917bFA0Bb20F3cdC6 |
| wstLINK Spoke Address        | 0x8C893de1f682813eaE6c6dBAA2BCaD7e795bc015 |
| Hub                          | 0xb39c03297e87032ff69f4d42a6698e4c4a934449 |
| Bridge Router Hub            | 0xfc828c500c90e63134b2b73537cc6cadff4ce695 |
| Hub Adapter                  | 0xcda75578328d0cb0e79db7797289c44fa02a77ad |
| Wormhole Data Adapter        | 0xeb48a1ee43b91959a1686b70b7cd482c65de69c9 |
| Wormhole CCTP Adapter        | 0x5c60f12838b8e3eeb525f299cd7c454c989dd04e |
| CCIP Data Adapter            | 0xc7bc4a43384f84b8fc937ab58173edab23a4c3cd |
| CCIP Token Adapter           | 0x5f2F4771B7dc7e2F7E9c1308B154E1e8957ecAB0 |
| Account Manager              | 0x12Db9758c4D9902334C523b94e436258EB54156f |
| Loan Manager                 | 0xf4c542518320f09943c35db6773b2f9feb2f847e |
| USDC Pool                    | 0x88f15e36308ED060d8543DA8E2a5dA0810Efded2 |
| AVAX Pool                    | 0x0259617bE41aDA4D97deD60dAf848Caa6db3F228 |
| sAVAX Pool                   | 0x7033105d1a527d342bE618ab1F222BB310C8d70b |
| ETH (eth) Pool               | 0xB6DF8914C084242A19A4C7fb15368be244Da3c75 |
| ETH (base) Pool              | 0x51958ed7B96F57142CE63BB223bbd9ce23DA7125 |
| wETH (ava) Pool              | 0x795CcF6f7601edb41E4b3123c778C56F0F19389A |
| wBTC (ava) Pool              | 0x9936812835476504D6Cf495F4F0C718Ec19B3Aff |
| BTCb (ava) Pool              | 0x1C51AA1516e1156d98075F2F64e259906051ABa9 |
| cbBTC (base) Pool            | 0x9eD81F0b5b0E9b6dE00F374fFc7f270902576EF7 |
| BNB (bcs) Pool               | 0x89970d3662614a5A4C9857Fcc9D9C3FA03824fe3 |
| ETHB (bsc) Pool              | 0x18031B374a571F9e060de41De58Abb5957cD5258 |
| BTCB (bsc) Pool              | 0xC2FD40D9Ec4Ae7e71068652209EB75258809e131 |
| ETH (arb) Pool               | 0x44E0d0809AF8Ee37BFb1A4e75D5EF5B96F6346A3 |
| ARB (arb) Pool               | 0x1177A3c2CccDb9c50D52Fc2D30a13b2c3C40BCF4 |
| SolvBTC Pool                 | 0x307bCEC89624660Ed06C97033EDb7eF49Ab0EB2D |
| JOE Pool                     | 0x5e5a2007a8D613C4C98F425097166095C875e6eE |
| ggAVAX Pool                  | 0xAdA5Be2A259096fd11D00c2b5c1181843eD008DC |
| POL Pool                     | 0x481cF0c02BF17a33753CE32f1931ED9990fFB40E |
| WBTC (pol) Pool              | 0x7054254933279d93D97309745AfbFF9310cdb570 |
| WETH (pol) Pool              | 0x88Ae56886233C706409c74c3D4EA9A9Ac1D65ab2 |
| aUSD Pool                    | 0xc7DdB440666c144c2F27a3a5156D636Bacfc769C |
| savUSD Pool                  | 0xE6B7713854620076B5716E2743262D315bf8609D |
| WBTC (arb) Pool              | 0x3445055F633fEF5A64F852aaCD6dA76143aCA109 |
| tBTC (arb) Pool              | 0xdd9eFBf83572f5387381aD3A04b1318221d545A2 |
| wstETH (arb) Pool            | 0x9f0c0aDEc9fd4ef946aCe1e2b4F32e49aE45C8F3 |
| weETH (arb) Pool             | 0x78B4e5cda33C898b546dB7925162879E7bd2A9d1 |
| rsETH (arb) Pool             | 0x60f2682Ab38e3C9a51b07fbd69f42Ad2Cfe731db |
| wstETH (pol) Pool            | 0xD77b920A9c05B3e768FEaE0bcB5839cd224328fE |
| LINK (pol) Pool              | 0x84C420D5e077cF0ed8a20c44d803C380172eD5D5 |
| MaticX (pol) Pool            | 0x59023eFDB22B9d8b2C7aeD842aC1fd2f6110e5B5 |
| ATH (eth) Pool               | 0x391201cEC4F80e69C87Dee364d599c1FCAE3c363 |
| pyUSD (eth) Pool             | 0x279b3E185F64e99141d4CE363657A5F3B5B32Fb9 |
| rlUSD (eth) Pool             | 0x7178bF2a8A50153549e0d95A4C6Cb816448840F0 |
| wstETH (eth) Pool            | 0xe7897052FAC4bfF9EB3ABc073CBC1e17Fce5709C |
| weETH (eth) Pool             | 0x4E6dD5E35638008cdB1E9004F3E952bCDd920E6D |
| AERO (base) Pool             | 0xb5327c35E083248E3a0f79122FaB3b6018e5584a |
| cbETH (base) Pool            | 0x0b09E1Ffd28040654021A85A49284597F3d0e41C |
| wstETH (base) Pool           | 0xC96820695217c7dd8F696f8892de76F7a48432CB |
| weETH (base) Pool            | 0xf727EC8D6e565328f2cf0Ff8aC4e7c9e7f8d24B2 |
| VIRTUAL (base) Pool          | 0x331a1938f94af7bB41d57691119Aee416495202a |
| KAITO (base) Pool            | 0x04C8B9d8AF87a6D670B646125B2D99740D8eBa5E |
| aUSD (pol) Pool              | 0x34f1BA5808EB5Bf60c9B1C343d86e410466F4860 |
| USDt (ava) Pool              | 0xA1E1024c49c77297bA6367F624cFbEFC80E697c6 |
| USDt (eth) Pool              | 0xf51a72b92cB9C16376Da04f48eF071c966B9C50B |
| USDt (pol) Pool              | 0x11f82b5Ea7408Ff257F6031E6A3e29203557A1DD |
| USDT0 (arb) Pool             | 0x1b5a1dCe059E6069Ed33C3656826Ad04bE536465 |
| SEI (sei) Pool               | 0x63EFdA4bf91Ba13D678C58AF47304e6180dD46DF |
| iSEI (sei) Pool              | 0x2B7995fd223dCf3A660Cc5a514349E3fa7B16168 |
| USDT0 (sei) Pool             | 0x213299AC40Ce76117C2c4B13945D9d935686BB85 |
| WETH (sei) Pool              | 0x9A102080970043B96773c15E6520d182565C68Ff |
| WBTC (sei) Pool              | 0x7Cd4afD7F4DB51A0bF06Bf4630752A5B28e0B6C1 |
| YBTCB Pool                   | 0x13A21bC65844CD530098Ab15431c57078ea90737 |
| SYRUP (eth) Pool             | 0xD4F87eb6cc8795e727F7DbC1e2C6c3452ad0010c |
| USDe (ava) Pool              | 0x5431e7f480C4985e9C3FaAcd3Bd1fc7143eAdEFa |
| sUSDe (ava) Pool             | 0x94307E63eF02Cf9B39894553f14b21378Ef20adB |
| SHIB Pool                    | 0x9f59642C6733397dF5c2696D3Ac9ceb431b1b573 |
| EURC (ava) Pool              | 0x3F87F3B301f031ba59C479EDF067621DcC72DDca |
| tETH Pool                    | 0x5FE123B659FC5242f46884C37550F05Ef08C816a |
| tAVAX (ava) Pool             | 0x3F63A6401e6354a486e6a38127409fD16e222B59 |
| wstLINK Pool                 | 0x42Bb92684e72707030F59C48FBe5A222A0d8b387 |
| MON Pool                     | 0x10a4481F79aAC209aC6c2959B785F2e303912Dc5 |
| wBTC (mon) Pool              | 0xdc887aCFe154BF0048Ae15Cda3693Ab2C237431A |
| wETH (mon) Pool              | 0xD7Ff49751DAF42Bf7AFC4fF5C958d4bea48358D3 |
| sMON Pool                    | 0x5562d84f9891288fc72aaB1d857797c7275Fcedb |
| aUSD (mon) Pool              | 0x4fb4c3A33cBe855C5d87078c1BbBe5f371417faC |
| USDT0 (mon) Pool             | 0xd9D50D4F73f61A306b47e5BdC825E98cd11139dc |
| gMON Pool                    | 0x0b4e69C4890a88acA90E7e71dB76619C3AaCD79D |
| shMON Pool                   | 0x398715A6011391B2B7fD1fF66BB26c126E5d4aAC |
| Bridge Router Hub Reward     | 0x347d342F12fA57b6231c82867f964Edfa4eD1431 |
| Hub Adapter Reward           | 0xc02AdA9fdd113c2e76A86121fb1e69540E02B29c |
| Wormhole Data Adapter Reward | 0x3291FCf6Ca62939fc432Debe6cbB2a838F755D34 |
| CCIP Data Adapter Reward     | 0x97592Dc676D6051Bf813f663B717cfD6B177eEFF |
| Hub Reward V1                | 0x7c532A6209350cF27EfC3D06E82E35ACFd362C7C |
| Hub Reward V2                | 0x3E85a56C2202Ec067EB4Ac090db3e8149dA46d19 |
| Spoke Manager Reward V2      | 0x8a8b9386dFd63931284545dB62374b48180f0111 |
| Bridge Router Spoke Reward   | 0x57d849B4D40536F587f2A9048DC8fE2a1d00dA88 |
| Spoke Common Reward V2       | 0x7fD21802709f2f180EE1982F56E58533f3031aCa |
| AVAX Spoke Reward V2         | 0x2aa8FeE178A79182C4b7c61EfeB4227Cb8843915 |
| GGP Spoke Reward V2          | 0xb14f2576BE100CFE3B274233091A841f1E040604 |

</details>

<details>

<summary>Base</summary>

| Name                         | Address                                    |
| ---------------------------- | ------------------------------------------ |
| Spoke Common                 | 0xc7bc4a43384f84b8fc937ab58173edab23a4c3cd |
| Bridge Router Spoke          | 0xfc828c500c90e63134b2b73537cc6cadff4ce695 |
| Wormhole Data Adapter        | 0xf854ac65a40f1eabfd32e6d4c7d0e1c4b1753cc5 |
| Wormhole CCTP Adapter        | 0xcda75578328d0cb0e79db7797289c44fa02a77ad |
| CCIP Data Adapter            | 0xeb48a1ee43b91959a1686b70b7cd482c65de69c9 |
| CCIP Token Adapter           | 0x5c60f12838b8e3eeb525f299cd7c454c989dd04e |
| USDC Spoke Address           | 0xf4c542518320f09943c35db6773b2f9feb2f847e |
| ETH Spoke Address            | 0xe3b0e4db870aa58a24f87d895c62d3dc5cd05883 |
| cbBTC Spoke Address          | 0x50d5Bb3Cf57D2fB003b602A6fD10F90baa8567EA |
| SolvBTC Spoke Address        | 0xe0C45Ab4295E96eC1259D787E2eD22C16a3D0d8f |
| AERO Spoke Address           | 0x7Ace2Bc1C79954B56C65C7B326035C4468ac12BB |
| cbETH Spoke Address          | 0x31A324D233AB3E73A6e1039D64907bBb2742606C |
| wstETH Spoke Address         | 0x7c7961E590B7e005540B72238b739ae513B605fB |
| weETH Spoke Address          | 0x8D9aad601f384C596B9e2b9124a73b278DB4C51C |
| VIRTUAL Spoke Address        | 0x9009c929873f0e68dbc253b16aC4c3E4426E6E35 |
| KAITO Spoke Address          | 0x123f831a762A165107EE2e07416f4AA713dA9bFD |
| SHIB Spoke Address           | 0x3eF10e94B4309415ebd8c1680CA3a5eE5Df9aCD7 |
| Bridge Router Spoke Reward   | 0x271141304e6eF06ada0c32D22aeB0BaA52ee06Df |
| Wormhole Data Adapter Reward | 0x517690D219B8A05Aa5eA1E141bD6252c515B9F9b |
| CCIP Data Adapter Reward     | 0xD0652FA3C9e918C86C72Ca9B85be65620f1D6e3F |
| Spoke Common Reward V2       | 0xd97AF2ff3A44427e4a412FeD0Cb8eBCbF09D4AE3 |

</details>

<details>

<summary>Ethereum</summary>

| Name                         | Address                                    |
| ---------------------------- | ------------------------------------------ |
| Spoke Common                 | 0xc7bc4A43384f84B8FC937Ab58173Edab23a4c3cD |
| Bridge Router Spoke          | 0xFc828C500c90E63134B2B73537cC6cADfF4Ce695 |
| Wormhole Data Adapter        | 0xF854AC65A40f1EabFD32E6D4C7d0E1c4B1753Cc5 |
| Wormhole CCTP Adapter        | 0xCda75578328D0CB0e79dB7797289c44fa02a77ad |
| CCIP Data Adapter            | 0xeB48a1eE43B91959A1686b70B7Cd482c65DE69c9 |
| CCIP Token Adapter           | 0x5C60f12838b8E3EEB525F299cD7C454c989dd04e |
| USDC Spoke Address           | 0xF4c542518320F09943C35Db6773b2f9FeB2F847e |
| ETH Spoke Address            | 0xe3B0e4Db870aA58A24f87d895c62D3dc5CD05883 |
| wBTC Spoke Address           | 0xb39c03297E87032fF69f4D42A6698e4c4A934449 |
| SolvBTC Spoke Address        | 0xD4f7fA03A4E8063825840C083Abb42CE327a3a38 |
| ATH Spoke Address            | 0x91461B9117B3644609EeB0889ecc89Cab4644bb2 |
| pyUSD Spoke Address          | 0xff785fb7BfBbe03eD09089f73151AE563B211723 |
| rlUSD Spoke Address          | 0x7967B0fe720E676f41640855a203B409cEcc8f92 |
| wstETH Spoke Address         | 0xB3ABD8cc35619b907F3f2E974Fe3d43956AA7cda |
| weETH Spoke Address          | 0x63BCB60165E7EC30F03883Fcb800AEf304EE7eEa |
| USDt Spoke Address           | 0x12d4FeDD9cE1b4d7dB90b07366284ac1675a5a90 |
| YBTCB Spoke Address          | 0x21c624a73ba4F4f23F8F5C6F3e67161a0bE7eCC2 |
| SYRUP Spoke Address          | 0x3aEa5E1f27935Ed59424F35Ea801420d804219E4 |
| SHIB Spoke Address           | 0xB7AB35580A6F609B8e9f9CFa28B4A4E9464D7884 |
| tETH Spoke Address           | 0x5162ACbe83d50fae95fB6a9e878a7E6734Bf8cFa |
| wstLINK Spoke Address        | 0x61C80bA6f7e284C87D0E9A238b2859B4C33a69dd |
| Bridge Router Spoke Reward   | 0x4701FD475D90365A64A1C58fA8932bfA83f4D48F |
| Wormhole Data Adapter Reward | 0x00db8119B1c919747da91d5fC2b3950bd79Ec0ce |
| CCIP Data Adapter Reward     | 0x0B8C6eC1495068ABE2A25fB4e63b652d83467572 |
| Spoke Common Reward V2       | 0xC6c682B1D8c7B402c6ED8AbA3a6238EB956C38CC |

</details>

<details>

<summary>Binance Smart Chain</summary>

| Name                         | Address                                    |
| ---------------------------- | ------------------------------------------ |
| Spoke Common                 | 0xc7bc4A43384f84B8FC937Ab58173Edab23a4c3cD |
| Bridge Router Spoke          | 0xCda75578328D0CB0e79dB7797289c44fa02a77ad |
| Wormhole Data Adapter        | 0xeB48a1eE43B91959A1686b70B7Cd482c65DE69c9 |
| CCIP Data Adapter            | 0x5C60f12838b8E3EEB525F299cD7C454c989dd04e |
| CCIP Token Adapter           | 0x802063A23E78D0f5D158feaAc605028Ee490b03b |
| BNB Spoke Address            | 0x5f2F4771B7dc7e2F7E9c1308B154E1e8957ecAB0 |
| ETH Spoke Address            | 0x4Db12F554623E4B0b3F5bAcF1c8490D4493380A5 |
| BTCB Spoke Address           | 0x12Db9758c4D9902334C523b94e436258EB54156f |
| SolvBTC Spoke Address        | 0x7218Bd1050D41A9ECfc517abdd294FB8116aEe81 |
| YBTCB Spoke Address          | 0xCD7eE494fa616FDbE38Aa0A9355E20b7215108Bf |
| SHIB Spoke Address           | 0x0700B2cB26688C035bd5dBbdA070Be408c20779c |
| Bridge Router Spoke Reward   | 0x57D77FD37670e22188d1c92D7cEc931bccf074A4 |
| Wormhole Data Adapter Reward | 0x37d761883a01e9F0B0d7fe59EEC8c21D94393CDD |
| CCIP Data Adapter Reward     | 0x1b2a8d56967d00700DD5C94E27B1a116a1deF8Df |
| Spoke Common Reward V2       | 0x531490B7674ef239C9FEC39d2Cf3Cc10645d14d4 |

</details>

<details>

<summary>Arbitrum</summary>

| Name                         | Address                                    |
| ---------------------------- | ------------------------------------------ |
| Spoke Common                 | 0x57D77FD37670e22188d1c92D7cEc931bccf074A4 |
| Bridge Router Spoke          | 0x4Db12F554623E4B0b3F5bAcF1c8490D4493380A5 |
| Wormhole Data Adapter        | 0x12Db9758c4D9902334C523b94e436258EB54156f |
| Wormhole CCTP Adapter        | 0x802063A23E78D0f5D158feaAc605028Ee490b03b |
| CCIP Data Adapter            | 0x7218Bd1050D41A9ECfc517abdd294FB8116aEe81 |
| CCIP Token Adapter           | 0x0700B2cB26688C035bd5dBbdA070Be408c20779c |
| USDC Spoke Address           | 0xF4c542518320F09943C35Db6773b2f9FeB2F847e |
| ETH Spoke Address            | 0x37d761883a01e9F0B0d7fe59EEC8c21D94393CDD |
| ARB Spoke Address            | 0x1b2a8d56967d00700DD5C94E27B1a116a1deF8Df |
| SolvBTC Spoke Address        | 0x531490B7674ef239C9FEC39d2Cf3Cc10645d14d4 |
| WBTC Spoke Address           | 0x2d1c07209696456b7901949fdf81037016d541A5 |
| tBTC Spoke Address           | 0xDF2da9288C4D0aDF6c52CCbb5062b8C73fb19111 |
| wstETH Spoke Address         | 0x74416b0121DAadFeb2A9C2306827CCf80a6EE097 |
| weETH Spoke Address          | 0x624363570A6b6Fee5531CcA341b794B286Af091c |
| rsETH Spoke Address          | 0xC0a3536E0b6799014A14664bA4370BBd5D0c7590 |
| USDT0 Spoke Address          | 0xe69e068539Ee627bAb1Ce878843a6C76484CBd2c |
| SHIB Spoke Address           | 0x2e6e4603536078bd7661338F06FB93cf6F9b7A98 |
| wstLINK Spoke Address        | 0x23a96D92C80E8b926dA40E574d615d9e806A87F6 |
| Bridge Router Spoke Reward   | 0xDf34f43ba8045CAb5c8A9a7589d5B5066C708aF3 |
| Wormhole Data Adapter Reward | 0x048E47EDdEF06C7f672d6b16D978ad38EC41A9Ec |
| CCIP Data Adapter Reward     | 0xF14535dB61b2993264e16Daed208A7603E749cdC |
| Spoke Common Reward V2       | 0x6BC1439b7663820daCeBc8E8B9a5BA29201ed352 |
| USDC Spoke Reward V2         | 0x88f15e36308ED060d8543DA8E2a5dA0810Efded2 |
| USDT0 Spoke Reward V2        | 0x0259617bE41aDA4D97deD60dAf848Caa6db3F228 |

</details>

<details>

<summary>Polygon</summary>

| Name                         | Address                                    |
| ---------------------------- | ------------------------------------------ |
| Spoke Common                 | 0x5f2F4771B7dc7e2F7E9c1308B154E1e8957ecAB0 |
| Bridge Router Spoke          | 0xF854AC65A40f1EabFD32E6D4C7d0E1c4B1753Cc5 |
| Wormhole Data Adapter        | 0xCda75578328D0CB0e79dB7797289c44fa02a77ad |
| Wormhole CCTP Adapter        | 0xeB48a1eE43B91959A1686b70B7Cd482c65DE69c9 |
| CCIP Data Adapter            | 0x5C60f12838b8E3EEB525F299cD7C454c989dd04e |
| CCIP Token Adapter           | 0xc7bc4A43384f84B8FC937Ab58173Edab23a4c3cD |
| USDC Spoke Address           | 0xA95CF7000376eD50c99832de9CCb5cAc41bfCbf0 |
| POL Spoke Address            | 0x4Db12F554623E4B0b3F5bAcF1c8490D4493380A5 |
| WBTC Spoke Address           | 0x1A40208E9506E08a6f62DbCCf8de7387743179E9 |
| WETH Spoke Address           | 0x2e6e4603536078bd7661338F06FB93cf6F9b7A98 |
| wstETH Spoke Address         | 0xa526f90c0CAab6A0E6085830e75b084cd3c84000 |
| LINK Spoke Address           | 0x63ad90A703e95e39be7CB9e460C2b05870c982B8 |
| MaticX Spoke Address         | 0xCB66564d0cF3D28B26a1b6D4eCb830D6E216a75a |
| aUSD Spoke Address           | 0xaB07AfCf16fecdCC3D83dB7513c7839aEd626322 |
| USDt Spoke Address           | 0xf2ee689fd3f7A7358bEDA46f83E7968Ad894abF0 |
| wstLINK Spoke Address        | 0x59A6e720f91a6709a088B2001dc71fC417Fb5361 |
| Bridge Router Spoke Reward   | 0xDf34f43ba8045CAb5c8A9a7589d5B5066C708aF3 |
| Wormhole Data Adapter Reward | 0x048E47EDdEF06C7f672d6b16D978ad38EC41A9Ec |
| CCIP Data Adapter Reward     | 0xF14535dB61b2993264e16Daed208A7603E749cdC |
| Spoke Common Reward V2       | 0x6BC1439b7663820daCeBc8E8B9a5BA29201ed352 |
| POL Spoke Reward V2          | 0xCD7eE494fa616FDbE38Aa0A9355E20b7215108Bf |

</details>

<details>

<summary>Sei</summary>

| Name                         | Address                                    |
| ---------------------------- | ------------------------------------------ |
| Spoke Common                 | 0xc7bc4A43384f84B8FC937Ab58173Edab23a4c3cD |
| Bridge Router Spoke          | 0xF854AC65A40f1EabFD32E6D4C7d0E1c4B1753Cc5 |
| Wormhole Data Adapter        | 0xCda75578328D0CB0e79dB7797289c44fa02a77ad |
| CCIP Data Adapter            | 0xeB48a1eE43B91959A1686b70B7Cd482c65DE69c9 |
| CCIP Token Adapter           | 0x5C60f12838b8E3EEB525F299cD7C454c989dd04e |
| SEI Spoke Address            | 0x5f2F4771B7dc7e2F7E9c1308B154E1e8957ecAB0 |
| iSEI Spoke Address           | 0x4Db12F554623E4B0b3F5bAcF1c8490D4493380A5 |
| USDT0 Spoke Address          | 0x12Db9758c4D9902334C523b94e436258EB54156f |
| WETH Spoke Address           | 0x802063A23E78D0f5D158feaAc605028Ee490b03b |
| WBTCSpoke Address            | 0x7218Bd1050D41A9ECfc517abdd294FB8116aEe81 |
| Bridge Router Spoke Reward   | 0x0700B2cB26688C035bd5dBbdA070Be408c20779c |
| Wormhole Data Adapter Reward | 0x57D77FD37670e22188d1c92D7cEc931bccf074A4 |
| CCIP Data Adapter Reward     | 0x37d761883a01e9F0B0d7fe59EEC8c21D94393CDD |
| Spoke Common Reward V2       | 0x1b2a8d56967d00700DD5C94E27B1a116a1deF8Df |
| SEI Spoke Reward V2          | 0x531490B7674ef239C9FEC39d2Cf3Cc10645d14d4 |

</details>

<details>

<summary>Monad</summary>

| Name                         | Address                                    |
| ---------------------------- | ------------------------------------------ |
| Spoke Common                 | 0xc7bc4A43384f84B8FC937Ab58173Edab23a4c3cD |
| Bridge Router Spoke          | 0xF854AC65A40f1EabFD32E6D4C7d0E1c4B1753Cc5 |
| Wormhole Data Adapter        | 0x37d761883a01e9F0B0d7fe59EEC8c21D94393CDD |
| CCIP Data Adapter            | 0xeB48a1eE43B91959A1686b70B7Cd482c65DE69c9 |
| CCIP Token Adapter           | 0x5C60f12838b8E3EEB525F299cD7C454c989dd04e |
| MON Spoke Address            | 0x531490B7674ef239C9FEC39d2Cf3Cc10645d14d4 |
| wBTC Spoke Address           | 0xF4c542518320F09943C35Db6773b2f9FeB2F847e |
| wETH Spoke Address           | 0xe3B0e4Db870aA58A24f87d895c62D3dc5CD05883 |
| sMON Spoke Address           | 0xb39c03297E87032fF69f4D42A6698e4c4A934449 |
| aUSD Spoke Address           | 0xC30107a8e782E98Fe890f0375afa4185aeEa3356 |
| USDT0 Spoke Address          | 0xB1e2939b501B73F4cFEf6a9FB0aa89a75F1774EE |
| gMON Spoke Address           | 0x9105CEEbaf43EF6B80dF1b66BEfFd5F98A036c36 |
| shMON Spoke Address          | 0x1A40208E9506E08a6f62DbCCf8de7387743179E9 |
| Bridge Router Spoke Reward   | 0x5f2F4771B7dc7e2F7E9c1308B154E1e8957ecAB0 |
| Wormhole Data Adapter Reward | 0x1b2a8d56967d00700DD5C94E27B1a116a1deF8Df |
| CCIP Data Adapter Reward     | 0x12Db9758c4D9902334C523b94e436258EB54156f |
| Spoke Common Reward V2       | 0x802063A23E78D0f5D158feaAc605028Ee490b03b |
| FOLKS Spoke Reward V2        | 0x7218Bd1050D41A9ECfc517abdd294FB8116aEe81 |

</details>

### Token

<details>

<summary>Avalanche</summary>

| USDC      | 0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E |
| --------- | ------------------------------------------ |
| AVAX      | NATIVE                                     |
| sAVAX     | 0x2b2C81e08f1Af8835a78Bb2A90AE924ACE0eA4bE |
| wETH\_ava | 0x49D5c2BdFfac6CE2BFdB6640F4F80f226bc10bAB |
| BTCb\_ava | 0x152b9d0FdC40C096757F570A51E494bd4b943E50 |
| SolvBTC   | 0xbc78D84Ba0c46dFe32cf2895a19939c86b81a777 |
| JOE       | 0x6e84a6216eA6dACC71eE8E6b0a5B7322EEbC0fDd |
| ggAVAX    | 0xA25EaF2906FA1a3a13EdAc9B9657108Af7B703e3 |
| aUSD\_ava | 0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a |
| savUSD    | 0x06d47F3fb376649c3A9Dafe069B3D6E35572219E |
| USDT\_ava | 0x9702230A8Ea53601f5cD2dc00fDBc13d4dF4A8c7 |
| YBTCB     | 0x2cd3CdB3bd68Eea0d3BE81DA707bC0c8743D7335 |
| SHIB      | 0x2f643d728926C20269f0A04931dd7b4b6B650204 |
| USDe      | 0x5d3a1Ff2b6BAb83b63cd9AD0787074081a52ef34 |
| sUSDe     | 0x211Cc4DD073734dA055fbF44a2b4667d5E5fE5d2 |
| EURC      | 0xc891eb4cbdeff6e073e859e987815ed1505c2acd |
| tETH      | 0xd09ACb80C1E8f2291862c4978A008791c9167003 |
| tAVAX     | 0x14A84F1a61cCd7D1BE596A6cc11FE33A36Bc1646 |
| wstLINK   | 0x601486C8Fdc3aD22745b01c920037d6c036A38B9 |

</details>

<details>

<summary>Ethereum</summary>

| USDC        | 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 |
| ----------- | ------------------------------------------ |
| ETH\_eth    | NATIVE                                     |
| wBTC\_eth   | 0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599 |
| SolvBTC     | 0x7A56E1C57C7475CCf742a1832B028F0456652F97 |
| ATH\_eth    | 0xbe0Ed4138121EcFC5c0E56B40517da27E6c5226B |
| pyUSD\_eth  | 0x6c3ea9036406852006290770BEdFcAbA0e23A0e8 |
| rlUSD\_eth  | 0x8292Bb45bf1Ee4d140127049757C2E0fF06317eD |
| wstETH\_eth | 0x7f39C581F595B53c5cb19bD0b3f8dA6c935E2Ca0 |
| weETH\_eth  | 0xCd5fE23C85820F7B72D0926FC9b05b43E359b7ee |
| USDT\_eth   | 0xdAC17F958D2ee523a2206206994597C13D831ec7 |
| YBTCB       | 0x2cd3CdB3bd68Eea0d3BE81DA707bC0c8743D7335 |
| SHIB        | 0x95aD61b0a150d79219dCF64E1E6Cc01f0B64C4cE |
| tETH        | 0xD11c452fc99cF405034ee446803b6F6c1F6d5ED8 |
| wstLINK     | 0x911D86C72155c33993d594B0Ec7E6206B4C803da |

</details>

<details>

<summary>Base</summary>

| USDC          | 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 |
| ------------- | ------------------------------------------ |
| ETH\_base     | NATIVE                                     |
| cbBTC\_base   | 0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf |
| SolvBTC       | 0x3B86Ad95859b6AB773f55f8d94B4b9d443EE931f |
| AERO\_base    | 0x940181a94A35A4569E4529A3CDfB74e38FD98631 |
| cbETH\_base   | 0x2Ae3F1Ec7F1F5012CFEab0185bfc7aa3cf0DEc22 |
| wstETH\_base  | 0xc1CBa3fCea344f92D9239c08C0568f6F2F0ee452 |
| weETH\_base   | 0x04C0599Ae5A44757c0af6F9eC3b93da8976c150A |
| VIRTUAL\_base | 0x0b3e328455c4059EEb9e3f84b5543F74E24e7E1b |
| KAITO\_base   | 0x98d0baa52b2D063E780DE12F615f963Fe8537553 |
| SHIB          | 0x9Ded28d9EC69F97efd718CE768dc39D78fd014F8 |

</details>

<details>

<summary>BSC</summary>

| Name      | Address                                    |
| --------- | ------------------------------------------ |
| BNB       | NATIVE                                     |
| ETHB\_bsc | 0x2170Ed0880ac9A755fd29B2688956BD959F933F8 |
| BTCB\_bsc | 0x7130d2A12B9BCbFAe4f2634d864A1Ee1Ce3Ead9c |
| SolvBTC   | 0x4aae823a6a0b376De6A78e74eCC5b079d38cBCf7 |
| YBTCB     | 0x2cd3CdB3bd68Eea0d3BE81DA707bC0c8743D7335 |
| SHIB      | 0xEc59dE82FFf1959E92b91daB975e4564FC3447cC |

</details>

<details>

<summary>Arbitrum</summary>

| USDC        | 0xaf88d065e77c8cC2239327C5EDb3A432268e5831 |
| ----------- | ------------------------------------------ |
| ETH\_arb    | NATIVE                                     |
| ARB         | 0x912CE59144191C1204E64559FE8253a0e49E6548 |
| SolvBTC     | 0x3647c54c4c2C65bC7a2D63c0Da2809B399DBBDC0 |
| wBTC\_arb   | 0x2f2a2543B76A4166549F7aaB2e75Bef0aefC5B0f |
| tBTC\_arb   | 0x6c84a8f1c29108F47a79964b5Fe888D4f4D0dE40 |
| wstETH\_arb | 0x5979D7b546E38E414F7E9822514be443A4800529 |
| weETH\_arb  | 0x35751007a407ca6FEFfE80b3cB397736D2cf4dbe |
| rsETH\_arb  | 0x4186BFC76E2E237523CBC30FD220FE055156b41F |
| USDT0\_arb  | 0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9 |
| SHIB        | 0xB359155378FF5E2837f12ed0bee5168123c88ACC |
| wstLINK     | 0x3106E2e148525b3DB36795b04691D444c24972fB |

</details>

<details>

<summary>Polygon</summary>

| USDC        | 0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359 |
| ----------- | ------------------------------------------ |
| POL         | NATIVE                                     |
| wBTC\_pol   | 0x1BFD67037B42Cf73acF2047067bd4F2C47D9BfD6 |
| wETH\_pol   | 0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619 |
| wstETH\_pol | 0x03b54A6e9a984069379fae1a4fC4dBAE93B3bCCD |
| LINK\_pol   | 0x53E0bca35eC356BD5ddDFebbD1Fc0fD03FaBad39 |
| MaticX      | 0xfa68FB4628DFF1028CFEc22b4162FCcd0d45efb6 |
| aUSD\_pol   | 0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a |
| USDT\_pol   | 0xc2132D05D31c914a87C6611C10748AEb04B58e8F |
| wstLINK     | 0xc271A17DB5cE6F53745A3F466077Ec816bC20a9C |

</details>

<details>

<summary>Sei</summary>

| Name       | Address                                    |
| ---------- | ------------------------------------------ |
| SEI        | NATIVE                                     |
| iSEI       | 0x5Cf6826140C1C56Ff49C808A1A75407Cd1DF9423 |
| USDT0\_sei | 0x9151434b16b9763660705744891fA906F660EcC5 |
| wETH\_sei  | 0x160345fC359604fC6e70E3c5fAcbdE5F7A9342d8 |
| wBTC\_sei  | 0x0555E30da8f98308EdB960aa94C0Db47230d2B9c |

</details>

<details>

<summary>Monad</summary>

| Name       | Address                                    |
| ---------- | ------------------------------------------ |
| MON        | NATIVE                                     |
| wBTC\_mon  | 0x0555E30da8f98308EdB960aa94C0Db47230d2B9c |
| wETH\_mon  | 0xEE8c0E9f1BFFb4Eb878d8f15f368A02a35481242 |
| sMON       | 0xA3227C5969757783154C60bF0bC1944180ed81B9 |
| aUSD\_mon  | 0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a |
| USDT0\_mon | 0xe7cd86e13AC4309349F30B3435a9d337750fC82D |
| gMON       | 0x8498312A6B3CbD158bf0c93AbdCF29E6e4F55081 |
| shMON      | 0x1B68626dCa36c7fE922fD2d55E4f631d962dE19c |

</details>


# Constants

<details>

<summary>Chain IDs</summary>

| Chain     | ID  |
| --------- | --- |
| AVALANCHE | 100 |
| ETHEREUM  | 101 |
| BASE      | 102 |
| BSC       | 103 |
| ARBITRUM  | 104 |
| POLYGON   | 106 |
| SEI       | 107 |
| MONAD     | 108 |

</details>

<details>

<summary>Loan Types </summary>

| Loan Type              | ID |
| ---------------------- | -- |
| DEPOSIT                | 1  |
| GENERAL                | 2  |
| AVAX\_EFFICIENCY       | 3  |
| ETH\_EFFICIENCY        | 4  |
| STABLECOIN\_EFFICIENCY | 5  |
| POL\_EFFICIENCY        | 6  |
| BTC\_EFFICIENCY        | 7  |
| SEI\_EFFICIENCY        | 8  |
| LINK\_EFFICIENCY       | 9  |
| MON\_EFFICIENCY        | 10 |

</details>

<details>

<summary>Pool IDs</summary>

| Pool          | ID |
| ------------- | -- |
| USDC          | 1  |
| AVAX          | 2  |
| sAVAX         | 3  |
| ETH\_eth      | 4  |
| ETH\_base     | 5  |
| wETH\_ava     | 6  |
| wBTC\_eth     | 7  |
| BTCb\_ava     | 8  |
| cbBTC\_base   | 9  |
| BNB           | 10 |
| ETHB\_bsc     | 11 |
| BTCB\_bsc     | 12 |
| ETH\_arb      | 13 |
| ARB           | 14 |
| SolvBTC       | 15 |
| JOE           | 16 |
| ggAVAX        | 17 |
| POL           | 19 |
| wBTC\_pol     | 20 |
| wETH\_pol     | 21 |
| aUSD\_ava     | 22 |
| savUSD        | 23 |
| wBTC\_arb     | 24 |
| tBTC\_arb     | 25 |
| wstETH\_arb   | 26 |
| weETH\_arb    | 27 |
| rsETH\_arb    | 28 |
| wstETH\_pol   | 29 |
| LINK\_pol     | 30 |
| MaticX        | 31 |
| ATH\_eth      | 32 |
| pyUSD\_eth    | 33 |
| rlUSD\_eth    | 34 |
| wstETH\_eth   | 35 |
| weETH\_eth    | 36 |
| AERO\_base    | 37 |
| cbETH\_base   | 38 |
| wstETH\_base  | 39 |
| weETH\_base   | 40 |
| VIRTUAL\_base | 41 |
| KAITO\_base   | 42 |
| aUSD\_pol     | 43 |
| USDT\_ava     | 44 |
| USDT\_eth     | 45 |
| USDT\_pol     | 46 |
| USDT0\_arb    | 47 |
| SEI           | 48 |
| iSEI          | 49 |
| USDT0\_sei    | 50 |
| wETH\_sei     | 51 |
| wBTC\_sei     | 52 |
| YBTCB         | 53 |
| SYRUP\_eth    | 54 |
| USDe\_ava     | 55 |
| sUSDe\_ava    | 56 |
| EURC\_ava     | 57 |
| tETH          | 58 |
| tAVAX         | 59 |
| wstLINK       | 60 |
| MON           | 61 |
| wBTC\_mon     | 62 |
| wETH\_mon     | 63 |
| sMON          | 64 |
| aUSD\_mon     | 66 |
| USDT0\_mon    | 67 |
| gMON          | 68 |
| shMON         | 69 |

</details>

<details>

<summary>Reward Token IDs</summary>

| Reward Token | ID |
| ------------ | -- |
| AVAX         | 1  |
| GoGoPool     | 2  |
| USDC\_arb    | 3  |
| POL          | 4  |
| USDT0\_arb   | 5  |
| SEI          | 6  |
| FOLKS\_mon   | 7  |

</details>


# SDK

Designed with flexibility and ease of use in mind, the SDK provides all the necessary tools and documentation to interact with Folks Finance’s xChain app protocol.

{% embed url="<https://github.com/Folks-Finance/folks-finance-xchain-js-sdk>" %}


# Disclaimer, Privacy Policy and T\&Cs

### Disclaimer

FOLKS FINANCE is an open-source, non-custodial decentralised protocol comprised exclusively of autonomous smart contracts deployed on public blockchains (the “Protocol”). The Protocol is permissionless and ownerless by design and is not operated, managed, or controlled by any person or entity. The Protocol is not a financial, payment, investment, banking, lending, borrowing, deposit-taking, custody, brokerage, or money-transmission service in any jurisdiction.

Any terminology used on this website or within related interfaces, including without limitation “loan”, “borrow”, “lend”, “debt”, “deposit”, “collateral”, “liquidation”, “LTV” or similar expressions, is used solely as a technical or functional reference in a decentralised software context and does not carry the legal or regulatory meaning those terms may have in traditional or regulated financial environments.

The Protocol is not designed for, and must not be used with, tokenised securities or other “security tokens” (or assets that are marketed or structured as such). The Protocol does not provide or operate any payment or money-transmission service and is not intended to facilitate person-to-person payments or third-party payments as a protocol feature. Any token movements occur solely as a technical consequence of user-initiated interactions with smart contracts and the underlying blockchain.

Governance of the Protocol and its ongoing development are fostered by the FOLKS FINANCE PRIVATE FOUNDATION (the “Foundation”), a non-profit foundation. The $FOLKS token (and any other protocol-related tokens) is issued and administered by the Foundation through its subsidiary FOLKS INTERNATIONAL LTD. Neither the Foundation nor FOLKS INTERNATIONAL LTD operates or controls the Protocol’s smart contracts.

This website and the non-custodial graphical user interface enabling interaction with the Protocol are developed and maintained by BLOCKBOX LLC, acting as a software development and maintenance provider engaged by the Foundation. BLOCKBOX LLC does not own, control, manage, or operate the Protocol or its smart contracts. Access to the website/interface may be restricted or blocked (including by geography, sanctions screening, or risk controls) at the interface level only; such measures do not imply control over, nor do they modify, the Protocol.

BLOCKBOX LLC is a Virtual Asset Service Provider licensed and regulated in the Kutaisi FEZ (Georgia). Separately and independently from the Protocol, BLOCKBOX LLC operates a distinct, partially centralised application under its own terms, which may offer additional proprietary features/services and may also provide an alternative interface to access the Protocol. Any custodial or partially centralised features (if any) exist only within that separate application and are legally and operationally independent from the Protocol.

The website/interface may link to or integrate third-party services; any services provided by third parties are governed solely by the relevant third parties’ terms and are outside the Protocol. Nothing on this website constitutes legal, financial, investment, or regulatory advice, nor an offer or solicitation of any kind.

Privacy Policy

{% embed url="<https://docsend.com/view/apwfndk7p7k63wwd>" %}

Folks Finance DeFi Terms & Conditions

{% embed url="<https://docsend.com/view/j3anzuz9pt79rxmm>" %}

FOLKS token Term & Conditions

{% embed url="<https://docsend.com/view/tjmjstnf49gd8rsc>" %}

Folks Finance App Term & Conditions

{% embed url="<https://docsend.com/view/x3ch7agna8utmcz6>" %}


# FAQ

**General Questions**

**Q: What is Folks Finance?**&#x20;

A: Folks Finance is a decentralized finance (DeFi) platform that offers cross-chain lending and borrowing services, utilizing a hub-and-spoke architecture to provide efficient liquidity and seamless cross-chain interactions.

**Q: How does the cross-chain functionality work?**&#x20;

A: Folks Finance uses a hub-and-spoke model, where the hub chain stores the entire state of the protocol, and spoke chains act as entry points for users. Cross-chain communication is facilitated using protocols like Wormhole, Chainlink CCIP, and Circle CCTP.

**Q: What are the main features of Folks Finance?**&#x20;

A: Key features include cross-chain lending and borrowing, unified liquidity pools, advanced lending options like collateral swaps, and an innovative incentive model designed for sustainability.

**Q: What is "Waiting relay"?**

A: Waiting Relay indicates that a transaction has been initiated from a spoke chain and is awaiting delivery to the hub chain via the Generic Messaging Protocol (GMP) such as Wormhole or Chainlink CCIP. For certain operations like deposits, collateralization, and repayments, the waiting time is longer as it requires achieving finality on the spoke chain where the operation was initiated. The Waiting Relay is necessary because it avoids potential risks such as double spending by ensuring that a transaction has been fully confirmed on the source chain before proceeding.

**Account Management**

**Q: What is the difference between inviting and linking an address?**&#x20;

A: Inviting an address requires the invited address to accept the invitation to gain access, providing extra security. Linking an address adds the address immediately without needing approval, offering quick access. Linking addresses is the easiest way to connect chains from the same wallet. Inviting addresses is useful when connecting chains from different wallets.

**Q: How do I invite an address to my account?**&#x20;

A: Navigate to the account management section, send an invitation to the desired address, and wait for the address to accept the invitation.

**Q: How do I link an address to my account?**&#x20;

A: Submit a "link address" transaction from your spoke chain, and the address will be added immediately without needing further approval.

**Lending and Borrowing**

**Q: How are interest rates determined?**&#x20;

A: Interest rates are dynamically adjusted based on the utilization ratio. Borrowers can choose between variable and stable interest rates.

**Q: What is the utilization ratio?**&#x20;

A: The utilization ratio measures how much of the available pool of assets has been borrowed compared to the total deposited.

$$
U = \frac{\text{Total Borrowed}}{\text{Total Deposited}}
$$

**Q: How does the liquidation process work?**&#x20;

A: Liquidation occurs when the total borrowed amount exceeds the borrowable amount. Liquidators repay the under-collateralized position and receive a bonus in the form of collateral.

**Security**

**Q: What security measures are in place?**&#x20;

A: Folks Finance employs regular smart contract audits, bug bounty programs, rate limits on value transfers, and comprehensive error handling and recovery mechanisms to ensure the safety and integrity of the platform.

**Q: What are rate limits?**&#x20;

A: Rate limits define the maximum value that can be transferred out of the protocol within a specified period to minimize risk and potential losses.

**Technical Details**

**Q: How does cross-chain communication ensure finality?**&#x20;

A: For operations like deposits and repayments, finality is awaited on the spoke chain before relaying messages to the hub chain to prevent transaction reversal or alteration.

**Miscellaneous**

**Q: Is there a minimum amount required to use Folks Finance?**&#x20;

A: There is no minimum amount required, making the platform accessible to everyone.


# Contact and Support

1. &#x20;Getting Started

If you're new to Folks Finance, start by exploring our [Getting Started](/user-guide/getting-started) Guide which provides step-by-step instructions on setting up your account, connecting wallets, and navigating the platform.

***

2. &#x20;Frequently Asked Questions (FAQ)

For quick answers to common questions, visit our [FAQ Page](/support/faq). This section covers a wide range of topics including account management, lending and borrowing, security measures, and more.

***

3. Academy

Folks Finance built a Video tutorial platform to facilitate learning the basics of blockchain, DeFi, and how to manage your digital assets.

{% embed url="<https://academy.folks.finance/>" %}

***

4. &#x20;Community Support

Join our community to get help, share experiences, and discuss all things related to Folks Finance.

* **Community Forum:** Engage with other users on our [Community Forum](https://forum.folks.finance/).
* **Discord Channel:** Join our Discord server for real-time support and discussions. [Join Discord](https://discord.com/invite/folksfinance).
* **Reddit:** Participate in discussions on our [Reddit page](https://www.reddit.com/r/FolksFinance/).

***

5. Technical Support

For technical issues or more detailed assistance, you can reach out to our support team:

* **Email Support:** Contact us via email at <help@folks.finance>.
* **Live Chat:** Coming soon..

***

6. &#x20;Contact Us

For general inquiries, partnerships, or media requests, please contact us through the following channels:

* **General Inquiries:** [help@folks.finance ](mailto:help@folks.finance)
* **Partnerships or Media Requests:** <marketing@folks.finance>

***

7. Social Media

Stay updated with the latest news, updates, and announcements from Folks Finance by following us on social media:

* **X:** [Follow us on X](https://x.com/FolksFinance)
* **LinkedIn:** [Connect on LinkedIn](https://www.linkedin.com/company/folksfinance/)
* **Medium:** [Read our articles on Medium](https://folksfinance.medium.com/)
* **YouTube:** [Subscribe to our YouTube channel](https://www.youtube.com/c/FolksFinance/)
* **Instagram**: [Follow us on Instagram](https://www.instagram.com/folksfinance/)
* **Telegram**: [Join us on Telegram](https://t.me/FolksfinanceOfficial/)

***

8. &#x20;Feedback

Your feedback is invaluable to us. If you have any suggestions, comments, or ideas on how we can improve, please let us know:

* **Email:** Send your feedback directly to <help@folks.finance>.

***


# Community treasury

Folks Finance believes that transparency is a key pillar, so we have given the users the opportunity to always keep track of the protocol revenue.

The treasury is used to cover potential hacks and other operations, subject to community approval.Click on the links below ⤵️ to have a look.

{% embed url="<https://snowtrace.io/address/0x4095f3c4bF6D6505Bd32cFFE0918863Ebb6b2Df2>" %}

#### Where the revenue comes from? <a href="#where-the-revenue-comes-from" id="where-the-revenue-comes-from"></a>

Folks Finance revenue comes from different sources:

* borrow interests,
* liquidation fees,
* liquidation bots,
* Liquid staking fees (soon),
* swap fees.


# FOLKS

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

The FOLKS token is the native asset of the Folks Finance protocol. Following the protocol’s crosschain architecture, FOLKS uses the[ NTT standard](https://wormhole.com/products/native-token-transfers) and is native on multiple chains. This means there’s only one token across all networks (no wrapping, no synthetic copies). \
\
Currently, FOLKS is natively live on: Avalanche, Ethereum, Base, BNB Chain, Arbitrum, Polygon, Algorand, and Sei Network.\
\
More native deployments will follow based on the Folks Finance chain integrations roadmap.&#x20;

{% content-ref url="/pages/oQwcqXhKW00ZlfQLRnIa" %}
[Tokenomics](/folks-token/tokenomics)
{% endcontent-ref %}

{% content-ref url="/pages/sJREvtqbIYYygTmzJBgE" %}
[Airdrop](/folks-token/airdrop)
{% endcontent-ref %}

{% content-ref url="/pages/9YoldfCVbiawKJOg8S9Q" %}
[How to bridge FOLKS](/folks-token/how-to-bridge-folks)
{% endcontent-ref %}

{% content-ref url="/pages/cIsiyyxTNhPZzluQxO81" %}
[Utilities](/folks-token/utilities)
{% endcontent-ref %}


# Tokenomics

FOLKS is the native token of Folks Finance—powering perks, utilities, and governance.

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

The total supply of $FOLKS is fixed at 50,000,000 tokens.

* Community — 35.00%\
  Airdrops, User Incentives
* Ecosystem Growth — 24.73%\
  Liquidity, Partnerships, Marketing, Exchanges
* Seed Supporters — 21.83%\
  Long-term supporters who supported the protocol’s infancy.
* Strategic Supporters — 4.94%\
  Partners providing capital and strategic alignment.
* Core Contributors — 10.00%\
  The core contributors building and maintaining Folks Finance.
* Advisors — 3.50%\
  Experts guiding strategy, growth, and institutional expansion.

At TGE, 12,700,475 $FOLKS (25.40%) are unlocked, consisting of:

* Community (Airdrop): 0.67%/3.29%\*
* Ecosystem Growth: 24.73%\*\*

\* The total allocated to the airdrop upon TGE is 3.29%. Of that, around 0.67% (Unlocked Community Airdrop) represents an estimated value based on a projected ratio of 25% of users opting for instant claim versus 75% selecting the linear unlock option.\
\*\* The Ecosystem Growth allocation follows a projected distribution plan designed to sustain long-term ecosystem expansion.

#### Community Initial Allocation

To cement community ownership from the start, a portion of the total 35% community allocation has been reserved for direct distribution to early participants.

Airdrop Season 1 Eligibility includes (snapshot taken on October 24th, at around 11:00am UTC):

* Users with Folks Points: 3% of total supply&#x20;
* Founders Pass NFT holders: 0.16%
* Partner campaigns participants: 0.13% total, distributed as follows:\
  \- Okx Wallet: 0.05%\
  \- Airaa: 0.025%\
  \- Gate Wallet: 0.02%\
  \- Zerion Wallet: 0.02%\
  \- Galxe: 0.01%\
  \- Haha Wallet: 0.005%\
  \- Orbiter: 0.001%

The remaining portion of the community allocation will be released through future airdrop seasons and incentive programs.

#### Long‑Term Design

* Community allocations: Season 1 airdrops with instant claims or optional unlock, future airdrops, incentives, and campaigns.
* Ecosystem Growth: multi‑chain expansion, integrations, liquidity support, listings, and co‑marketing.
* Lock & linear unlocking: 12–30 months for Investors, Team, and Advisors to align incentives and reduce short‑term volatility.

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

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


# Airdrop

Claim your token here:

{% embed url="<https://claim.folks.finance/en>" %}

The Folks Finance airdrop is designed to reward the most active and engaged users while ensuring a fair and inclusive distribution for the entire community.

***

#### Distribution Methodology

Season 1 of the airdrop distributes 1,646,479 FOLKS tokens (3,29% of total supply), allocated across several eligibility criteria: Folks Points, Founders Pass NFT holders, and partner campaign winners (Okx Wallet, Haha Wallet, Zerion Wallet, Gate Wallet, Airaa mindshare campaign, Orbiter campaign, Galxe campaign).

Snapshot was taken on October 24th, 2025, at \~11:00 UTC. Points or NFTs obtained after this snapshot already count toward eligibility for future seasons.

Folks Points allocations are determined by users’ performance in the Leaderboard campaign, using a natural logarithm function to balance score disparities between top and mid-tier participants. Minimum eligibility is 1,000,000 points.

Each Founders Pass NFT grants 30 $FOLKS, cumulative by quantity. Addresses that also have ≥ 1 M points receive a bonus based on their NFT tier:

* 1 or more Silver NFTs → +10 $FOLKS
* 1 or more Gold NFTs → +20 $FOLKS
* 1 or more Black NFTs → +30 $FOLKS

If an NFT was held before the snapshot but is not linked to an xChain account or Algorand address, the allocation doesn’t show in the checker and won’t be possible to claim manually, but will be airdropped directly to that wallet shortly after claim goes live.

Partner campaign and NFT allocations are not subject to the Instant / Linear Unlock claim options — they are fully claimable immediately in both cases.

Rewards from Zerion Wallet and the Airaa mindshare campaign will be distributed directly by them. Follow their official channels for updates.

***

#### Claiming Options

Eligible users receive the airdrop full amount only if they decide to opt for a 3-month linear unlock. Alternatively, users have the option to instant claim and receive a partial amount.

The claim window (for both options) runs from November 6, 14:00 UTC to December 16, 13:00 UTC.\
For clarity, in the examples we will use a scenario where User A is eligible for a total airdrop allocation of 100 FOLKS.

**Instant Claim**\
Users receive 20% of their allocation immediately, with no further action required after claiming.

E.g. User A decides to Instant Claim and receives only 20 FOLKS from the total 100 FOLKS allocation.

**Linear Unlock Claim**

Users receive 10% of their allocation immediately, and the remaining 90% unlocks linearly over 90 days from the beginning of the unlock period.\
The unlock period runs from December 16th, 2025, at 14:00 UTC to March 16th, 2026, at 14:00 UTC, users can claim unlocked tokens at any time during this period.\
The claiming window will close on March 31st, 2026, at 14:00 UTC. Any unclaimed tokens after this date will be lost.

E.g. User A decides to opt for the Linear Unlock Claim. They receive 10 FOLKS immediately, then 1 FOLKS per day over the 90-day unlock period.<br>

{% hint style="warning" %}
**General warnings:**

* Users must choose between Instant Claim and Linear Unlock Claim before December 16, 2025, at 13:00 UTC. Failure to make a choice by this deadline results in permanent loss of the entire airdrop allocation.
* Once a claim option is selected and confirmed, it cannot be changed.
* The Linear Unlock period begins on December 16, 2025, at 14:00 UTC, and continues for 90 days until March 16, 2026, at 14:00 UTC.
* Once the unlock period ends, users have until March 31, 2026, at 14:00 UTC to claim any remaining unlocked tokens. Any unclaimed tokens after this date will be permanently lost.
  {% endhint %}

#### List of the contracts the user interacts with for the airdrop:

* Avalanche: 0xf1af32bD9978eC0Fcbc2b382EA8a28aa3c595c39
* Ethereum, Base, Arbitrum, BNB Chain, Polygon, Sei EVM: 0xEA87695E4b95109F333997Aa9B306dcA9EBFa69B
* Algorand 3301499411

FOLKS token:

* Avalanche, Ethereum, Base, Arbitrum, BNB Chain, Polygon, Sei EVM: 0xFF7F8F301F7A706E3CfD3D2275f5dc0b9EE8009B
* Algorand 3203964481


# How to bridge FOLKS

{% embed url="<https://xportal.folks.finance/>" %}

<figure><img src="/files/3UFocOC5G2nmFDuyyOzs" alt=""><figcaption></figcaption></figure>

1. Connect your EVM wallet&#x20;
2. Select the destination chain&#x20;
3. Enter the destination address&#x20;
4. Select the network where you want to receive the tokens&#x20;
5. Select how you want to pay the gas fees (native token or in $FOLKS)&#x20;
6. Click on “Review & Bridge”
7. Click on “Confirm Transfer”&#x20;
8. Wait for your tokens to land on your destination chain&#x20;


# Utilities

FOLKS holders can now unlock fee discounts when swapping on Folks Finance. This is applied to: &#x20;

* Algorand swaps via Folks Router
* Crosschain swaps via LiFi protocol on xChain

Discounts are based on FOLKS holding&#x20;

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

{% hint style="warning" %}
Warning: some of the following utilities might still not be live
{% endhint %}

* **Folks Finance Governance** — enables certain active users to steer elements of future protocol development.
* **Folks xPortal Discounted Fees** — applied to bridging fees on xPortal (powered by Wormhole NTT).
* **xGov Voting** — participate in xGov proposal votes on Algorand.
* **Liquidity Incentives** — boost rewards for active market participation.
* **Mobile App and Debit Card Perks** — discounted fees and tiered perks related to Folks Mobile.&#x20;
* **Future Utilities** — additional use cases and expanded token utility will be introduced progressively, especially with the launch of Folks xChain V2.