# Overview

### **Introduction to Scribe**

Scribe is an innovative, community-driven decentralized exchange (DEX) built on the Scroll Network. Our mission is to provide a highly efficient and customizable trading platform that supports sustainable liquidity and growth for new and existing protocols. Leveraging the advanced capabilities of Scroll, Scribe aims to deliver a seamless and secure trading experience.

### **Network**

Scribe is deployed on the Scroll Network, a native zkEVM Layer 2 solution for Ethereum. Scroll extends Ethereum’s capabilities through zero-knowledge (zk) proofs and EVM compatibility, ensuring high security, scalability, and decentralization.

#### **Key Features of the Scroll Network**

* **Scalability**: Scroll uses zkRollups to aggregate numerous transactions into a single Rollup block, which significantly enhances transaction throughput and reduces costs. This makes Scroll more accessible and responsive, supporting a larger user base compared to Ethereum alone​ ([Scroll Docs](https://docs.scroll.io/en/getting-started/overview/))​​ ([Scroll](https://scroll.io/blog/protocol-upgrade-bridging-cost-reduction#:~:text=URL%3A%20https%3A%2F%2Fscroll.io%2Fblog%2Fprotocol,100))​.
* **Security**: The Scroll network leverages zero-knowledge proofs to ensure that all transactions on the network are valid and follow the rules of Ethereum. These cryptographic proofs are published to Ethereum, allowing the network to benefit from Ethereum’s security while enhancing its own decentralization and censorship resistance​ ([Scroll Docs](https://docs.scroll.io/en/getting-started/overview/))​​ ([Scroll](https://scroll.io/blog/zkevm#:~:text=URL%3A%20https%3A%2F%2Fscroll,100))​.
* **Compatibility**: Scroll is fully EVM-compatible, meaning that any application built on Ethereum can be seamlessly deployed on Scroll without modification. This ensures a smooth transition for developers and users familiar with the Ethereum ecosystem​ ([Scroll Docs](https://docs.scroll.io/en/technology/))​.
* **Efficiency**: Recent protocol upgrades on Scroll have significantly improved cost efficiency, particularly for bridging assets from Ethereum to Scroll. This reduction in bridging costs makes it economically viable for a wider range of users and applications​ ([Scroll](https://scroll.io/blog/protocol-upgrade-bridging-cost-reduction#:~:text=URL%3A%20https%3A%2F%2Fscroll.io%2Fblog%2Fprotocol,100))​.

#### **Objectives**

At Scribe, our focus is on building a thriving ecosystem that supports the needs of our community and the protocols within it. We aim to provide tools that enable deep, sustainable liquidity and offer a high degree of flexibility for users and builders alike. Scribe is committed to supporting new protocols by providing the tools they need to launch, bootstrap liquidity, and sustain their growth in a decentralized and community-driven manner.

**Advanced AMM**

Scribe's Automated Market Maker (AMM) is designed to provide efficient and flexible trading solutions. The AMM V3 and V4 versions offer dynamic, adaptable liquidity pools that cater to both volatile and stable assets, ensuring optimal trading conditions and reducing slippage for users.

* **AMM V3**: This version introduces dynamic directional fees that adjust based on market conditions, optimizing trading costs and enhancing liquidity depth. Users can benefit from improved capital efficiency and more accurate pricing mechanisms.
* **AMM V4**: Building on the innovations of V3, AMM V4 further enhances user experience by integrating advanced features such as multi-hop swaps, improved liquidity aggregation, and customizable fee structures. This ensures that traders and liquidity providers can maximize their returns while maintaining minimal risks.

**Yield Optimization**

Scribe offers robust yield farming opportunities through yield-bearing positions represented by non-fungible staked positions (spNFTs). These positions enable users to earn rewards while maintaining flexibility in managing their assets. Scribe's staking strategies are designed to enhance capital efficiency and provide diverse earning opportunities.

**Launchpad**

The Scribe Launchpad is designed to support new projects by providing a platform for decentralized and transparent fundraising. By leveraging Scribe's community-driven ecosystem, projects can achieve a successful launch and integrate seamlessly into the Scroll Network.

* **Community-Driven**: Scribe's Launchpad emphasizes community involvement, allowing users to participate in governance decisions and support the growth of new projects.
* **Sustainable Growth**: Projects launched on Scribe benefit from tools that ensure long-term sustainability, including liquidity bootstrapping, community engagement strategies, and ongoing support from the Scribe team.

**Security and Transparency**

Scribe prioritizes the security of its users by implementing rigorous security measures and maintaining full transparency in its operations. The platform undergoes regular audits and engages in community-driven bug bounty programs to identify and address potential vulnerabilities.


# ?! FAQ

Explore FAQs on Scribe DEX for quick answers on liquidity, swap fees, earnings, and platform use, helping you navigate and maximize your DeFi experience


# Liquidity & Yield Farming

### V4 <a href="#v4" id="v4"></a>

How does V4 manual mode function?

V4 Concentrated liquidity allows liquidity providers on Scribe to set custom price ranges for their tokens instead of evenly distributing them across the entire price range. This means that liquidity providers can concentrate their capital on specific price ranges where they believe there will be more trading activity, while still providing liquidity across a broader range of prices rather than the entire price range. In other words, concentrated liquidity allows providing liquidity for specific prices you like, instead of sharing all your liquidity across the whole range.

The unique aspect of Scribe vs typical v3 concentrated liquidity comes from Algebra's integral system which allows for the usage of custom plugins (hooks) that can be invoked before or after certain activity.

More info on plugins (hooks) can be found on the Algebra docs portal at:

[![Logo](https://651545192-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQ0xXWotbDRlc7WzSWZQV%2Ficon%2Fxg9MNapuZeqMCAq5NKCJ%2Flogo.png?alt=media\&token=060c9496-1462-4f17-8b88-034eea5da7c7)Algebra Integral | Algebra Integral](https://docs.algebra.finance/algebra-integral-documentation/overview-faq/algebra-integral)

Example of the mechanics:

For volatile pair, an LP could provide liquidity for a price range of $1.10 - $1.30. This means that liquidity would only be used within that price range, allowing for more targeted liquidity provision

In a stable pair, a liquidity provider may opt to allocate their capital only to the range of $0.995-$1.005. This can result in deeper liquidity for traders around the mid-price, and the LP can earn more trading fees using their capital

#### **Merkl** <a href="#merkl" id="merkl"></a>

Merkl is a mechanism to incentivize Scribe's V4 manual liquidity positions.

From the user's point of view, the process is quite simple; If the pair of your position is incentivized with market maker rewards, you will receive additional rewards on top of the trading fees that are harvestable in the positions section of the DApp's interface.

#### How should price ranges be selected? <a href="#how-should-price-ranges-be-selected" id="how-should-price-ranges-be-selected"></a>

* Consider how much prices are likely to move during the lifetime of your position
* Be willing to actively manage the position as the market changes
* Take into account the economics of the transactions required to manage the position
* If prices move outside your specified range, your position will be concentrated in one asset and you won't earn trading fees until prices return to the range
* Providing liquidity across the full range is an option, but it will result in a lower rate of return than a narrower range

#### Range presets <a href="#range-presets" id="range-presets"></a>

![](https://docs.kim.exchange/~gitbook/image?url=https%3A%2F%2F148554750-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FYy9qLYhKl62g2m4dBbTR%252Fuploads%252FpHiokjIRSjuF6DKOkG7L%252Fimage.png%3Falt%3Dmedia%26token%3D63067001-26f8-4af0-a50f-ce442aa84df7\&width=768\&dpr=4\&quality=100\&sign=ac51d34b\&sv=1)

1. **Full range** - Liquidity is provided across the entire price range of the asset being traded. This can be useful for assets that have a wide trading range or are subject to high volatility
2. **Wide range** - Liquidity is concentrated in a wider price range. This can be useful for assets with moderate volatility, as it provides sufficient liquidity across a range of prices
3. **Common range** - Liquidity is concentrated in both the buy and sell range around the current market price
4. **Narrow range** Liquidity is concentrated in a specific price range, usually close to the current market price. This can be useful for assets that have relatively stable prices, as it reduces the amount of capital required to provide liquidity while still maintaining efficient trading

**Is my position liquidated if the price exceeds my price range?**

If the price of a trading pair goes beyond the range that you set for your LP, then your position will only consist of the less valuable asset in that pair.

For instance, if your price range for ETH/USDC is 555-1555, and ETH drops to 550, then your balance will only be in ETH. On the other hand, if ETH increases to 1560, then your balance will only be in USDC

When the price remains outside of your specified range, your position will be in an out of range mode, which means that you will not earn any fees until the price returns to your set range.

**How are fees earned and distributed in concentrated liquidity pools?**

Fees are earned from swap transactions that occur within the specified price range set by the liquidity providers. These fees are automatically distributed proportionally to the liquidity providers based on the amount of liquidity they have contributed and the time they have been in the pool. For manual mode, pending rewards are harvestable on the V4 position management panel - when it comes to auto mode the LP fees auto-compounding in the LP.


# Protocol Earnings

### **Liquidity Provision on Scribe DEX** <a href="#liquidity-provision-on-kim-dex" id="liquidity-provision-on-kim-dex"></a>

1. **What is Liquidity Provision?**
   * Liquidity provision involves depositing a pair of tokens into a pool to facilitate trading on the platform.
   * By providing liquidity, users contribute to the overall health and efficiency of the exchange.
2. **Benefits for Liquidity Providers**
   * Liquidity providers earn a portion of the transaction fees generated from trades in the pool.
   * They play a crucial role in ensuring enough liquidity for smooth trading operations.

#### **Swap Fees APR (Annual Percentage Rate)** <a href="#swap-fees-apr-annual-percentage-rate" id="swap-fees-apr-annual-percentage-rate"></a>

1. **Understanding Swap Fees**
   * Each swap (trade) on Scribe DEX incurs a transaction fee of 0.3%.
   * This fee is a key revenue source for liquidity providers.
2. **Distribution of Swap Fees**
   * The entirety of the 0.3% transaction fee is distributed directly to the providers of the liquidity pool involved in the swap.
   * This distribution is proportional to each provider's share in the pool.
3. **APR Calculation**
   * The Annual Percentage Rate (APR) for liquidity providers is calculated based on annualized total fees earned from swaps.
   * This rate represents the potential earnings a liquidity provider can expect over a year based on current trading volumes and fee structures.

#### **Critical Considerations for Earning Through Liquidity Provision** <a href="#critical-considerations-for-earning-through-liquidity-provision" id="critical-considerations-for-earning-through-liquidity-provision"></a>

1. **Pool Selection**: Consider the trading volume and token stability factors when choosing liquidity pools.
2. **Risk Assessment**: Be aware of impermanent loss, especially in volatile market conditions.
3. **Active Management**: Regularly monitor and adjust your liquidity provision strategy to optimize earnings.

Participating in liquidity provision on Scribe DEX offers a compelling opportunity to earn from swap fees. For v4 pools, fees are adaptive based on the volatility of the pair and ranges from 0.01% - 1.5%. For v2 pools, 0.3% transaction fee on swaps, entirely allocated to liquidity providers, is an incentive for contributing to the platform's liquidity. By understanding the dynamics of swap fees APR and selecting suitable pools, users can effectively earn passive income while supporting the ecosystem of Scribe DEX. Consider the associated risks and manage your investments actively for the best results.


# What is Impermanent Loss ?

Understanding Impermanent Loss in Automated Market Makers (AMM) and its Impact on Scribe DEX Liquidity Providers

Impermanent loss is crucial for anyone participating in liquidity provision on Automated Market Makers (AMM) like Scribe DEX. This phenomenon can affect the value of your investment in a liquidity pool, especially in volatile market conditions. Understanding impermanent loss is crucial for effective liquidity management.

**What is Impermanent Loss?** Impermanent loss occurs when the price of tokens in a liquidity pool changes compared to their price at the time of deposit. Essentially, it's the difference in value between holding tokens in the pool versus holding them in your wallet. If the prices return to their original levels, the loss is 'impermanent' as the value realigns. However, if prices remain changed, the loss becomes permanent.

**Key Points:**

1. **Price Deviation**: The greater the change in price of the tokens from the time of deposit, the higher the potential impermanent loss.
2. **Volatility Consideration**: Tokens with high volatility are more prone to impermanent loss.
3. **Fee Compensation**: Trading fees earned from providing liquidity can offset impermanent loss but may not always cover it entirely.

**Strategies to Mitigate Impermanent Loss:**

1. **Asset Correlation**: Choosing highly correlated assets might reduce the risk of impermanent loss.
2. **Pool Size and Volume Analysis**: Larger pools with high trading volumes generally have lower impermanent loss risk. Use Scribe DEX's analytics tools for this analysis.
3. **Regular Monitoring**: Monitor market conditions and adjust your liquidity strategy as necessary.

Impermanent loss is a fundamental risk in liquidity provision on platforms like Scribe DEX. While trading fees can help mitigate this loss, understanding its mechanics and actively managing your investment can significantly influence the outcome. Being informed and proactive is critical to navigating the complexities of AMM liquidity provision.

[<br>](https://docs.kim.exchange/get-started/faq/protocol-earnings)


# Smart Contract Security and Features

Scribe DEX is committed to providing its users with a secure and efficient trading experience. By leveraging expertly crafted intelligent contracts and implementing advanced security measures, Scribe DEX ensures the safety and optimization of your investments. This knowledge-based article overviews Scribe DEX's platform's critical security features and functionalities.

**Robust Smart Contract Development** Scribe DEX's smart contracts are developed by seasoned professionals who deeply understand the industry. The development process prioritizes the following aspects:

1. **Security**: Ensuring the highest level of safety for user funds and transactions.
2. **Efficiency**: Optimizing contract performance for smooth and cost-effective operations.
3. **Scalability**: Designing contracts to support a growing number of users and transactions.

**Comprehensive Security Audits** To validate the security and integrity of its smart contracts, Scribe DEX has undergone a thorough audit by Quantstamp, a leading firm in smart contract security. Quantstamp audit services are renowned for their sophistication and thoroughness, assuring the robustness of Scribe DEX's contracts. Users interested in reviewing the detailed audit report can access it through the provided link on Scribe DEX's website.

To further bolster the protocol's security, Scribe DEX has implemented multisig, short for multi-signature, a type of digital signature that combines multiple unique signatures. This ensures that funds stored on a multi-signature address can only be accessed when two or more signatures are provided simultaneously. Using multisig wallets provides an additional layer of security, and by utilizing multisig, we can avoid the problems often associated with single-key wallets


# AMM

Scribe's Automated Market Maker (AMM) is a cornerstone of our decentralized exchange, designed to provide efficient, flexible, and innovative trading solutions. By leveraging the advanced capabilities of the Scroll Network, Scribe's AMM delivers optimal trading conditions for both traders and liquidity providers.&#x20;


# AMM V4 Features

Scribe’s Automated Market Maker (AMM) V4 is powered by Algebra, bringing a suite of advanced features designed to optimize trading and liquidity provision on the platform. The integration with Algebra enhances the functionality and efficiency of Scribe’s AMM, making it a robust and flexible solution for both traders and liquidity providers.

**Multi-Hop Swaps**

One of the key features of AMM V4 is the introduction of multi-hop swaps. This functionality allows users to trade between assets that do not have a direct liquidity pool. The system automatically identifies the optimal route through multiple pools to execute the trade. This feature broadens the range of trading pairs available to users, facilitating efficient price discovery across different liquidity pools. Consequently, traders can benefit from improved liquidity and better trading outcomes, making it easier to execute complex trades without incurring significant slippage.

**Improved Liquidity Aggregation**

AMM V4 enhances liquidity aggregation by pooling liquidity from various sources, including external aggregators. This ensures that traders always have access to the best available liquidity, reducing the likelihood of slippage and ensuring better trade execution. The improved liquidity aggregation mechanism consolidates liquidity, making it more robust and resilient to market fluctuations, ultimately providing a more stable trading environment for users.

**Customizable Fee Structures**

Another significant feature of AMM V4 is the ability to set customizable fee structures. Liquidity providers can tailor their fee strategies based on market conditions and personal preferences. This flexibility allows providers to optimize their earnings while maintaining competitive trading fees for users. By enabling customizable fees, Scribe’s AMM V4 empowers liquidity providers to adapt their strategies dynamically, enhancing their profitability and aligning with market trends.

**Advanced Risk Management**

AMM V4 incorporates advanced risk management tools to protect liquidity providers from impermanent loss and other market risks. These tools include automated rebalancing and hedging mechanisms, which help maintain the stability and profitability of liquidity positions. By minimizing exposure to market risks, these features ensure that liquidity providers can achieve more consistent returns, making Scribe’s AMM a more attractive platform for capital investment.

**Enhanced User Experience**

The user experience in AMM V4 is significantly improved with an intuitive interface and advanced analytics tools. Users have access to real-time performance data, detailed reporting, and insights that help them make informed trading and liquidity provision decisions. The user-friendly design ensures that even new users can navigate the platform easily and take advantage of its advanced features.

**Permissionless Protocol Interaction**

AMM V4 is fully permissionless, allowing any protocol to interact with Scribe without requiring approval or intervention. This open and decentralized approach fosters innovation and interoperability within the ecosystem. New protocols can seamlessly integrate with Scribe’s AMM, driving growth and diversification, and contributing to a more vibrant and dynamic DeFi environment.

**Algebra-Enhanced Features**

Algebra brings several advanced capabilities to Scribe’s AMM V4. These include non-linear price curves, which allow for more flexible and efficient liquidity management. Time-Weighted Average Price (TWAP) oracles provide more accurate pricing data, enhancing the reliability of trades and liquidity positions. Real-time liquidity management tools ensure that liquidity is dynamically adjusted to reflect market conditions and user demand, resulting in a more responsive and efficient trading environment.

**Fee Handling**

Fee handling in AMM V4 is sophisticated, with real-time fee adjustments and optimized fee distribution mechanisms. Fees collected from trades can be set at different levels based on the liquidity provider’s strategy and market conditions. This ensures fair and flexible rewards for liquidity providers while maintaining competitive trading conditions for users. By leveraging Algebra’s advanced fee handling capabilities, Scribe’s AMM V4 ensures that liquidity providers are adequately compensated for their contributions, fostering a healthy and sustainable liquidity ecosystem.


# V4 Add Liquidity (Concentrated)

V4 enables liquidity providers to concentrate their capital within specific price ranges, leading to increased liquidity at preferred prices.

To provide liquidity to V4, navigate to the **Earn** tab, select **Liquidity** and choose **V4:**

<figure><img src="https://docs.kim.exchange/~gitbook/image?url=https%3A%2F%2F148554750-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FYy9qLYhKl62g2m4dBbTR%252Fuploads%252FL5KXq3Z4Zst13vizJP18%252Fimage.png%3Falt%3Dmedia%26token%3D261edf81-6f4c-47aa-a8b1-82f7776c318d&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=5aa7826b&#x26;sv=1" alt=""><figcaption></figcaption></figure>

1. Select a pair

![](https://docs.kim.exchange/~gitbook/image?url=https%3A%2F%2F148554750-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FYy9qLYhKl62g2m4dBbTR%252Fuploads%252Fdm3Dj38IEEAdOwfxxMJE%252Fimage.png%3Falt%3Dmedia%26token%3Da4ea134d-630f-46a0-be2f-5c76ffc377ac\&width=768\&dpr=4\&quality=100\&sign=177d6bbb\&sv=1)

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

![](https://docs.kim.exchange/~gitbook/image?url=https%3A%2F%2F148554750-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FYy9qLYhKl62g2m4dBbTR%252Fuploads%252FWLEhUX0fuE1EAiyAGkjG%252Fimage.png%3Falt%3Dmedia%26token%3Dc2a5d021-27d2-434f-a6e0-a591e588fb06\&width=768\&dpr=4\&quality=100\&sign=25e69051\&sv=1)

Unlike regular farms, Market Maker incentives are distributed via Merkl, which checks onchain data for incentivized pools using an offchain script.

These rewards are given out every **6 hours**, depending on how many tokens you've earned and the fees your position has collected during that time. Therefore, the narrower the range, the higher the market maker's rewards.

*The exact distribution formula for market maker rewards:*

<figure><img src="https://docs.kim.exchange/~gitbook/image?url=https%3A%2F%2F148554750-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FYy9qLYhKl62g2m4dBbTR%252Fuploads%252FgMlNtO4dRkBE920r4xBi%252Fimage.png%3Falt%3Dmedia%26token%3Dc9c29d03-a7ac-4acf-a1df-22912dec6085&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=33eb4af2&#x26;sv=1" alt=""><figcaption></figcaption></figure>

For more specific information about how the mechanism works, you can refer to [Merkl documentation](https://docs.angle.money/merkl/lp-guide).

1. Select a mode

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

* Manual mode is tailored for experienced liquidity providers, granting them control over the price ranges of the liquidity they provide
* Auto mode employs focused liquidity management strategies, handling the intricate task of adjusting price ranges for users (future addition to platform)

In auto mode users can select a Automated Liquidity Management provider and select a strategy.

<figure><img src="https://docs.kim.exchange/~gitbook/image?url=https%3A%2F%2F148554750-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FYy9qLYhKl62g2m4dBbTR%252Fuploads%252Ft7HANQn4e1kqVEfeY0HO%252Fimage.png%3Falt%3Dmedia%26token%3D01646f70-1605-4c24-8a36-ba544165b85f&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=bb84996a&#x26;sv=1" alt=""><figcaption></figcaption></figure>

More details about the strategy can be seen on the right panel with details about the ALM and the selected strategy:

<figure><img src="https://docs.kim.exchange/~gitbook/image?url=https%3A%2F%2F148554750-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FYy9qLYhKl62g2m4dBbTR%252Fuploads%252Fl82RrDlhA8Cg7jzY1jm4%252Fimage.png%3Falt%3Dmedia%26token%3Dbf5451f4-6122-406c-8d1e-a618ba04ccf9&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=6166a50b&#x26;sv=1" alt=""><figcaption></figcaption></figure>

When liquidity is provided through **manual** mode, positions are created as **LP only** and can earn trading fees and market maker rewards


# Manual Mode (LP Only

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

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

<figure><img src="https://docs.kim.exchange/~gitbook/image?url=https%3A%2F%2F148554750-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FYy9qLYhKl62g2m4dBbTR%252Fuploads%252FOBFzrVMqBRaipFw8pGRT%252Fimage.png%3Falt%3Dmedia%26token%3D2f0d0ed8-7025-4d4b-b39b-89d0658214b0&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=e7c465c6&#x26;sv=1" alt=""><figcaption></figcaption></figure>

<figure><img src="https://docs.kim.exchange/~gitbook/image?url=https%3A%2F%2F148554750-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FYy9qLYhKl62g2m4dBbTR%252Fuploads%252FqFcFCIp79s0IHccVAuHY%252Fimage.png%3Falt%3Dmedia%26token%3D3637f3e7-859c-40b8-ab2d-ab91e017a2cf&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=d88e3f0a&#x26;sv=1" alt=""><figcaption></figcaption></figure>

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

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

**Input amounts**

Input the amount in one box, and the other box will automatically display the corresponding amount. The ratio between the two amounts depends on your price range relative to the market price. If your price range is closer to one side of the market price, you will provide more of that asset. If you click the **Full range** button, you can provide liquidity across the full range

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

![](https://docs.kim.exchange/~gitbook/image?url=https%3A%2F%2F148554750-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FYy9qLYhKl62g2m4dBbTR%252Fuploads%252FqCq9udenX4BXgj8GMlMS%252Fimage.png%3Falt%3Dmedia%26token%3Dbad3ae97-d617-44d8-9040-acd773a6441d\&width=768\&dpr=4\&quality=100\&sign=f99d6510\&sv=1)

**Approve and Add liquidity**

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

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

**Earn and manage**

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

You can oversee and monitor your positions by clicking on **View existing positions** after successfully providing liquidity or navigating to the **Earn** tab, then selecting **Positions** and finally choosing **LP V4.**

**Unbind / Add Liquidity and Harvest**

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

* Market maker rewards: harvest your pending incentives *(It will only appear on the interface once you have pending rewards to harvest)*
* Unbind: withdraw liquidity
* Add: add more liquidity to your position
* Harvest: harvest your pending rewards

#### What does the Burn Position button signify when unwrapping V3 LP? <a href="#what-does-the-burn-position-button-signify-when-unwrapping-v3-lp" id="what-does-the-burn-position-button-signify-when-unwrapping-v3-lp"></a>

The Burn position feature allows you to entirely liquidate your V4 position. Not burning position when closing can be useful if you intend to add liquidity again in the future using the same parameters. If you decide not to burn a position, it will remain empty and available for a future liquidity deposit. If you burn it you will get back the assets that you originally paired and the position will be burned

#### Single-sided liquidity provision <a href="#single-sided-liquidity-provision" id="single-sided-liquidity-provision"></a>

Single-sided liquidity feature in V4 allows liquidity providers to deposit a single asset instead of both assets in a trading pair. This feature is intended to give liquidity providers more flexibility and reduce the risk associated with providing liquidity.

**Key points to think about for signle-sided liquidity provision in V4:**

* Single-sided liquidity providing allows liquidity providers to deposit only one asset instead of both assets in a trading pair
* V4 uses the current price of the assets to calculate the correct amount of the other asset needed to create the trading pair
* Single-sided liquidity providing can reduce the risk associated with providing liquidity since liquidity providers don't have to worry about the value of both assets in the trading pair
* Liquidity providers can still earn trading fees even if they only provide one asset to the pool

Single-sided liquidity providing is useful for liquidity providers who may not have both assets on hand or want to reduce their risk exposure


# Scribe Staked Position NFTs (spNFT)

Scribe introduces Staked Position NFTs (spNFTs), a unique and innovative feature designed to enhance the flexibility and efficiency of liquidity provisioning and yield farming. These non-fungible tokens encapsulate staked positions within Scribe’s AMM, providing users with a versatile way to manage and maximize their earnings.

**Overview of spNFTs**

Staked Position NFTs (spNFTs) are advanced, non-fungible tokens that represent a user’s staked positions in Scribe’s liquidity pools. Unlike traditional liquidity provision methods, spNFTs allow for greater flexibility, transferability, and advanced management of staked assets. This novel approach provides users with a powerful tool to optimize their participation in the Scribe ecosystem.

## **Key Features and Benefits**

**Flexibility and Customization**

One of the standout features of spNFTs is the level of customization they offer. Users can tailor their staked positions according to their preferred risk and return profiles. This includes defining specific parameters such as asset pairs, price ranges, and staking duration. This customization enables liquidity providers to align their strategies with market conditions and personal investment goals, thereby optimizing returns.

**Transferability**

spNFTs are fully transferable, which means users can buy, sell, or trade their staked positions on secondary markets. This transferability adds a new layer of liquidity and utility to staked assets. It allows users to liquidate their positions or acquire additional positions without the need to unstake assets directly from the liquidity pools. This feature provides enhanced flexibility in managing liquidity and investment strategies.

**Enhanced Capital Efficiency**

spNFTs facilitate concentrated liquidity provision, allowing users to allocate assets within specific price ranges. This concentration maximizes capital efficiency and increases potential returns from liquidity provision. By focusing liquidity in targeted price ranges, providers can achieve higher profitability with less capital, while traders benefit from deeper liquidity and reduced slippage.

**Advanced Management Tools**

Scribe offers advanced analytics and management tools for spNFT holders. These tools include real-time performance tracking, automated rebalancing, and risk management features. With these tools, users can make informed decisions about their staked positions, dynamically adjust their strategies, and maximize their earnings. The enhanced management capabilities ensure that users can respond effectively to market changes and optimize their participation in the Scribe ecosystem.


# Yield Farming and Rewards

Holders of spNFTs are eligible to participate in Scribe’s yield farming programs and earn additional rewards. These rewards can come in the form of native Scribe tokens or other incentivized assets. This dual-earning potential from both trading fees and yield farming rewards significantly enhances the overall return on investment for liquidity providers.


# Detailed Breakdown of spNFT Functionality

**Creation and Customization**

Creating spNFTs involves staking assets in Scribe’s liquidity pools and defining the parameters for the staked positions. Users can customize their spNFTs by choosing the asset pair, setting the price range for concentrated liquidity, and specifying the staking duration. This process allows for a high degree of personalization, enabling users to tailor their investments to their specific strategies.

**Transfer and Trade**

Once created, spNFTs can be transferred or traded on secondary markets. Users can list their spNFTs for sale, purchase additional spNFTs, or trade with other users. Scribe integrates with various NFT marketplaces to facilitate seamless trading, ensuring liquidity and accessibility for all users. This feature provides an added layer of flexibility, allowing users to manage their investments dynamically.

**Earning and Rewards Distribution**

spNFT holders earn a portion of the trading fees generated by the liquidity pool in which their assets are staked. These earnings are distributed proportionally based on the share of the liquidity provided. Additionally, spNFT holders can earn rewards through Scribe’s yield farming programs. These rewards are periodically distributed and can be claimed or reinvested into new or existing spNFTs, further compounding the returns.


# Use Cases and Strategies

**Diversified Liquidity Provision**

Users can create multiple spNFTs with different asset pairs and price ranges to diversify their liquidity provision. This strategy mitigates risk and maximizes returns across various market conditions. For example, a user might stake assets in both stablecoin pools and volatile asset pools, spreading their risk while taking advantage of different market opportunities.

**Active Trading and Management**

Active traders can use spNFTs to manage their liquidity positions dynamically. By regularly adjusting their price ranges and rebalancing their assets, traders can optimize their returns and minimize losses. For instance, a trader might adjust the price range of their spNFTs based on market trends and predictions, ensuring their assets are always positioned for maximum efficiency.

**Long-Term Yield Farming**

Long-term investors can stake their assets in spNFTs and participate in yield farming programs to earn additional rewards. This strategy focuses on steady, compounded returns over time. An investor might stake assets in a long-term yield farming pool, earning Scribe tokens as rewards and reinvesting them into new spNFTs for compounded growth.


# xScribe Plugins

Scribe introduces a flexible and extensible framework through Plugins, which are contracts linked to the xScribe contract. These Plugins enhance the functionality of the Scribe ecosystem by offering additional features and capabilities. Some Plugins are developed natively by the Scribe team, while others are integrated by third-party developers from the broader ecosystem. This section provides a detailed overview of the Plugins available within the Scribe platform.

**1. Overview of Plugins**

Plugins are modular contracts designed to extend the core functionality of the xScribe contract. They provide a range of features, from financial tools to governance enhancements, enabling users to customize and optimize their interaction with the Scribe ecosystem.

**2. Types of Plugins**

**a. Native Plugins**

* **Description**: Native Plugins are developed directly by the Scribe team. These plugins are designed to offer core enhancements and functionalities that integrate seamlessly with the Scribe platform.
* **Examples**:
  * **Dividends Plugin**: This plugin allows xScribe holders to earn dividends from platform revenues. It distributes a portion of the fees and profits generated by Scribe back to the token holders.
  * **Yield Booster Plugin**: The Yield Booster plugin enhances yield farming rewards for xScribe holders. It increases the yield earned on staked assets, providing additional incentives for users to participate in the ecosystem.
  * **Future Native Plugins**: The Scribe team is continually developing new plugins to introduce additional features and improvements to the platform.

**b. Ecosystem Plugins**

* **Description**: Ecosystem Plugins are developed by third-party developers from the Scribe ecosystem. These plugins leverage the open and permissionless nature of the Scribe platform, allowing for innovative integrations and enhancements.
* **Examples**:
  * **Custom Yield Strategies**: Developers can create plugins that introduce new yield farming strategies, allowing users to diversify and optimize their staking approaches.
  * **Governance Tools**: Ecosystem developers can integrate governance-related plugins that enhance the voting and decision-making processes within the Scribe DAO.
  * **Financial Instruments**: Plugins that offer new financial instruments, such as options, futures, or leveraged positions, can be integrated to provide advanced trading capabilities.


# Rewards and Yield Boosters

**a. Dividends Plugin**

* **Description**: The Dividends Plugin allocates a portion of Scribe's platform revenues to xScribe holders. This includes trading fees, protocol fees, and other revenue streams generated by the Scribe ecosystem.
* **Benefits**: xScribe holders receive regular dividend payouts, providing a passive income stream and incentivizing long-term holding of xScribe tokens.
* **Distribution**: Dividends are distributed proportionally based on the amount of xScribe held by each user. The distribution frequency and specific payout mechanisms are determined by the Scribe governance process.

**b. Yield Booster Plugin**

* **Description**: The Yield Booster Plugin is designed to enhance the rewards earned from yield farming activities. It increases the yield rates for xScribe holders who participate in designated liquidity pools and farming programs.
* **Benefits**: By boosting the yield rates, this plugin incentivizes more users to stake their assets and provide liquidity, thereby enhancing the overall liquidity and stability of the Scribe platform.
* **Activation**: To activate the Yield Booster Plugin, users need to link it to their xScribe contract and meet certain criteria, such as staking a minimum amount of tokens or participating in specific pools.


# Community Plugins

**a. Integration and Development**

* **Description**: Community Plugins are developed by third-party developers within the Scribe ecosystem. These plugins can introduce a wide range of functionalities, from new financial instruments to enhanced governance tools.
* **Development Process**: Developers create plugins using Scribe's open and permissionless framework. Once a plugin is developed, it can be proposed for integration into the Scribe platform through the governance process.
* **Approval and Deployment**: Proposed plugins undergo a review and approval process by the Scribe DAO. Upon approval, the plugins are deployed and made available to all users.

**b. Examples of Community Plugins**

* **Custom Yield Strategies**: Plugins that offer new and innovative yield farming strategies, allowing users to diversify their approaches and optimize returns.
* **Governance Enhancements**: Tools and mechanisms that improve the governance process, such as advanced voting systems, delegation features, and governance analytics.
* **Advanced Financial Instruments**: Plugins that introduce sophisticated financial products, including options, futures, leveraged positions, and more, enhancing the trading capabilities within the Scribe ecosystem.


# Integration and Usage

**a. Integration Process**

* **For Native Plugins**: Native Plugins are automatically available to all xScribe holders. Users can activate and utilize these plugins through the Scribe interface, with no additional setup required.
* **For Ecosystem Plugins**: Ecosystem Plugins require integration by the developers. Once a plugin is developed, it can be proposed for integration into the Scribe platform. After passing a review and approval process, the plugin becomes available to all users.

**b. User Interaction**

* **Accessing Plugins**: Users can access and manage plugins through the Scribe dashboard. The dashboard provides a comprehensive list of available plugins, along with detailed descriptions and usage instructions.
* **Activating Plugins**: To activate a plugin, users need to link it to their xScribe contract. This process involves a few simple steps, such as approving the plugin contract and configuring any necessary settings.
* **Managing Plugins**: Users can monitor and adjust their active plugins through the dashboard. This includes tracking performance metrics, adjusting configurations, and deactivating plugins as needed.


# Benefits of Plugins

**a. Enhanced Functionality**

* **Description**: Plugins provide additional features and capabilities that enhance the core functionality of the Scribe platform. They allow users to tailor their experience to meet specific needs and preferences.
* **Examples**: Earning dividends, boosting yield farming rewards, and accessing advanced financial instruments.

**b. Flexibility and Customization**

* **Description**: The modular nature of plugins allows for a high degree of flexibility and customization. Users can select and configure plugins to suit their individual strategies and goals.
* **Examples**: Custom yield strategies, governance tools, and personalized financial setups.

**c. Community-Driven Innovation**

* **Description**: Ecosystem Plugins foster community-driven innovation by enabling third-party developers to contribute to the Scribe platform. This encourages a diverse range of ideas and solutions, driving continuous improvement and growth.
* **Examples**: New financial instruments, innovative yield farming strategies, and enhanced governance mechanisms.


# Launchpad

Scribe's Launchpad is designed to facilitate the seamless introduction of new projects into the Scribe ecosystem. Drawing inspiration from Camelot's Launchpad, Scribe's platform offers a comprehensive and community-driven approach to project launches. This section provides a detailed overview of the Scribe Launchpad, its features, and the process involved.

The Scribe Launchpad is a decentralized platform that enables new projects to raise funds, bootstrap liquidity, and build a community. By leveraging the robust infrastructure of the Scroll Network, the Launchpad ensures a secure and efficient environment for project launches.


# Key Features

The Launchpad features several critical components designed to support new projects effectively. It is decentralized and permissionless, allowing any project to participate without requiring central approval, fostering an inclusive and open ecosystem that encourages innovation. The community-driven aspect of the Launchpad ensures that projects launched are supported by the Scribe community through governance and participation, aligning new projects with the interests of Scribe users. Additionally, the Launchpad includes mechanisms for liquidity bootstrapping, such as Initial DEX Offerings (IDOs) and liquidity mining programs, which help projects establish a solid liquidity foundation from the outset.

The Launchpad offers significant benefits for both projects and investors. Projects gain exposure and support from Scribe’s vibrant community, immediate liquidity through IDOs and liquidity mining, and ongoing development support. Investors benefit from early access to promising new projects, potential significant returns, and active participation in shaping the Scribe ecosystem through community governance.


# Launch Process

The launch process on the Scribe Launchpad involves several stages. Projects interested in launching must first submit an application detailing their vision, team, and roadmap. This application is then reviewed by the Scribe community and team. If the project passes the initial review, it is presented for a governance vote where community members use their governance tokens to decide whether to support the project. Approved projects can then participate in fundraising events, such as IDOs, where investors purchase tokens at a set price, with the funds raised used to bootstrap liquidity and development. Projects can also implement liquidity mining programs to incentivize users to provide liquidity, further strengthening their market presence.


# Participation Guide

For projects, Scribe provides a step-by-step guide to navigate the application and launch process, offering resources and support to ensure successful integration into the Scribe ecosystem. For investors, the Launchpad offers opportunities to participate in IDOs by connecting their wallets, reviewing available projects, and purchasing tokens during fundraising events. Investors can also participate in liquidity mining programs to earn additional rewards by providing liquidity to newly launched projects.


# SCRIBE Token

**Name: SCRIBE Token**&#x20;

**Ticker: SCRIBE**

**Chain: SCROLL**

**Max supply: 1,000,000,000 SCRIBE**

**Contract:**&#x20;

SCRIBE is Scribe's native token. It can be earned as yield rewards on [incentivized staking positions](/protocol/scribe-staked-position-nfts-spnft/yield-farming-and-rewards).


# xSCRIBE Token

**Name: Scribe Escrowed Token**&#x20;

**Ticker: xSCRIBE**

**Chain: SCROLL**

**Contract:**&#x20;

**Overview of xSCRIBE**

xSCRIBE is a non-transferable escrowed governance token, directly corresponding to staked SCRIBE. This unique token plays a vital role in the Scribe ecosystem, offering a range of functionalities and benefits for its holders. It can be earned from yield-generating staking positions (spNFTs) or through direct SCRIBE conversion. By holding and staking xSCRIBE, users gain access to various rewards, including governance participation, yield enhancements, and dividends.

**Earning xSCRIBE**

There are two primary methods to earn xSCRIBE: yield-generating staking positions and direct SCRIBE conversion. Yield-generating staking positions (spNFTs) allow users to stake their assets and earn rewards, with a portion of these rewards distributed as xSCRIBE. This method encourages active participation in liquidity provision and yield farming. Additionally, users can convert their SCRIBE directly into xSCRIBE, incentivizing long-term commitment to the platform.

**Central Use Case of xSCRIBE**

The primary use case for xSCRIBE is its allocation to various Plugins. Users stake xSCRIBE into the token contract and assign the deposited amount to specific plugins, receiving various benefits in return. This flexible system allows users to enhance their governance influence, boost their yield farming rewards, or earn dividends from the platform’s revenue streams.

**Benefits of xSCRIBE Allocation**

Allocating xSCRIBE to governance-related plugins empowers users to have a significant influence on platform decisions, including voting on proposals and protocol upgrades. Yield-boosting plugins enhance yield farming rewards for staked assets, optimizing returns for liquidity providers. Additionally, dividend-generating plugins allow users to earn a share of the platform’s revenue, providing a steady income stream for long-term holders and stakers.

**Managing xSCRIBE**

Users can easily stake their xSCRIBE through the Scribe interface, selecting from a range of available plugins. The interface provides detailed information on the benefits and requirements of each plugin, ensuring a user-friendly staking and allocation process. Users can also monitor their staked xSCRIBE and adjust allocations as needed, providing flexibility in managing governance and reward strategies.


# How to use xSCRIBE

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

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

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

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

A default 0.5% fee will be applied when deallocating xSCRIBE.

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

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


# Conversion - Redeeming

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

## SCRIBE > xSCRIBE conversion <a href="#grail-greater-than-xgrail-conversion" id="grail-greater-than-xgrail-conversion"></a>

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

Get xSCRIBE

## xSCRIBE > SCRIBE redeem <a href="#xgrail-greater-than-grail-redeem" id="xgrail-greater-than-grail-redeem"></a>

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

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

If the selected vesting duration is lower than the maximum (ratio < 1:1), the unclaimed excess SCRIBE is burned

## **Cancel redeem** <a href="#cancel-redeem" id="cancel-redeem"></a>

Any xSCRIBE redeeming process can be freely interrupted at any time by the user.

Any cancelled redeem before its end will void the whole process. User will retrieve its entire amount of redeeming xSCRIBE, and no SCRIBE.


# Distribution

## SCRIBE Allocation

Coming soon


# Protocol Earnings


# Deflationary Mechanics


# Audits

**Comprehensive Security Audits** To validate the security and integrity of its smart contracts, Scribe DEX has undergone a thorough audit by Zellic, a leading firm in smart contract security. Zellic audit services are renowned for their sophistication and thoroughness, assuring the robustness of Scribe DEX's contracts. Users interested in reviewing the detailed audit report can access it [here](https://github.com/scribe-dex/public-reports/tree/main/audits).

To further bolster the protocol's security, Scribe DEX has implemented multisig, short for multi-signature, a type of digital signature that combines multiple unique signatures. This ensures that funds stored on a multi-signature address can only be accessed when two or more signatures are provided simultaneously. Using multisig wallets provides an additional layer of security, and by utilizing multisig, we can avoid the problems often associated with single-key wallets.

**Our V4 AMM** is based on the Algebra Integral solution. For audits related to this protocol component consult the [following page](https://docs.algebra.finance/algebra-integral-documentation/algebra-integral-technical-reference/audits).


# Community & Social

You're never alone on your crypto journey. Join the Scribe community - ask questions, go full degen, and get your problems solved (your on-chain problems, nothing beyond that) in our [Discord](https://discord.gg/scribeprotocol).

To keep up to date, follow us on [X here](https://x.com/ScribeDEX).

For the giga-geeks, monitor our in-house team of geeks code contributions on the Scribe Github.


# AMM V4


# Factory


# Non Fungible Position Manager


# Base Plugin V1 Factory


# Swap Router


# Subgraph


