Skip to main content

Documentation Index

Fetch the complete documentation index at: https://tech.ramses.xyz/llms.txt

Use this file to discover all available pages before exploring further.

​
Introduction

This guide will cover how to collect fees from a liquidity position on the Ramses V3 protocol. It is based on the collecting fees code example, found in the Uniswap code examples repository. To run this example, check out the examples’s README and follow the setup instructions.
If you need a briefer on the SDK and to learn more about how these guides connect to the examples repository, please visit our background page!
In the Ramses V3 protocol, liquidity positions are represented using non-fungible tokens. In this guide we will use the NonfungiblePositionManager class to help us mint a liquidity position for the USDC - DAI pair. We will then attempt to collect any fees that the position has accrued from those trading against our provisioned liquidity. The inputs to our guide are the two tokens that we are pooling for, the amount of each token we are pooling for, the Pool fee and the max amount of accrued fees we want to collect for each token. The guide will cover:
  1. Setting up our fee collection
  2. Submitting our fee collection transaction
At the end of the guide, given the inputs above, we should be able to collect the accrued fees (if any) of a minted position with the press of a button and see the change reflected in our position and the balance of our tokens. For this guide, the following packages are used: The core code of this guide can be found in collectFees().
This guide assumes you are familiar with our Minting a Position guide. A minted position is required to add or remove liquidity from, so the buttons will be disabled until a position is minted.Also note that we do not need to give approval to the RamsesV3PositionManager to transfer our tokens as we will have already done that when minting our position.

​
Setting up our fee collection

All of the fee collecting logic can be found in the collectFees function. Notice how the Collect Fees button is disabled until a position is minted. This happens because there will be no fees to collect unless there is a position whose liquidity has been traded against. To start, we fetch the position from the RamsesV3PositionManager Contract to get the fees we are owed: 
import { ethers } from 'ethers'
import JSBI from 'jsbi'
...

const nfpmContract = new ethers.Contract(NONFUNGIBLE_POSITION_MANAGER_ADDRESS, provider)
const position = nfpmContract.positions(positionId)
Next, we construct an options object of type CollectOptions that holds the data about the fees we want to collect: 
import { CurrencyAmount } from '@uniswap/sdk-core'

const collectOptions: CollectOptions = {
  tokenId: positionId,
  expectedCurrencyOwed0: CurrencyAmount.fromRawAmount(
    CurrentConfig.tokens.token0,
    JSBI.BigInt(position.tokensOwed0)
  ),
  expectedCurrencyOwed1: CurrencyAmount.fromRawAmount(
    CurrentConfig.tokens.token1,
    JSBI.BigInt(position.tokensOwed1)
  ),
  recipient: address,
}
Read more about fetching position info here. Similar to the other functions exposed by the RamsesV3PositionManager, we pass the tokenId and the recipient of the fees, which in this case is our function’s input position id and our wallet’s address. The other two CurrencyAmount parameters (expectedCurrencyOwed0 and expectedCurrencyOwed1) define the maximum amount of currency we expect to get collect through accrued fees of each token in the pool. We set these through our guide’s configuration. In a real world scenario, we can fetch the amount of fees that are owed to the Position through the positions() function of the RamsesV3PositionManager Contract. We fetch the position info like in this code snippet taken from the Fetching Positions guide: 
const positionInfos = callResponses.map((position) => {
    return {
        tickLower: position.tickLower,
        tickUpper: position.tickUpper,
        liquidity: JSBI.BigInt(position.liquidity),
        feeGrowthInside0LastX128: JSBI.BigInt(position.feeGrowthInside0LastX128),
        feeGrowthInside1LastX128: JSBI.BigInt(position.feeGrowthInside1LastX128),
        tokensOwed0: JSBI.BigInt(position.tokensOwed0),
        tokensOwed1: JSBI.BigInt(position.tokensOwed1),
  }
})
The tokensOwed0 and tokensOwed1 values are the fees owed. In this example, we have the values hardcoded in the config.ts file.

​
Submitting our fee collection transaction

Next, we get the call parameters for collecting our fees from our RamsesV3PositionManager using the constructed CollectOptions: 
const { calldata, value } =
  RamsesV3PositionManager.collectCallParameters(collectOptions)
The function above returns the calldata and value required to construct the transaction for collecting accrued fees. Now that we have both the calldata and value we needed for the transaction, we can build and execute the it: 
const transaction = {
  data: calldata,
  to: NONFUNGIBLE_POSITION_MANAGER_CONTRACT_ADDRESS,
  value: value,
  from: address,
  maxFeePerGas: MAX_FEE_PER_GAS,
  maxPriorityFeePerGas: MAX_PRIORITY_FEE_PER_GAS,
}

const txRes = await wallet.sendTransaction(transaction)
After pressing the button, if someone has traded against our position, we should be able to note how the balance of USDC and DAI increases as we collect fees.

​
Next Steps

The previous guides detail all the atomic steps needed to create and manage positions. However, these approaches may not use all of your desired currency. To ensure you are using your full funds while minimizing gas prices, check out our guide on Swapping and Adding Liquidity in a single transaction!