KLAYswap
English
English
  • Introduction
  • Protocol Overview
  • Core Concept
  • KLAYswap Advantages
  • Risk & Security
  • Privacy Policy
  • Audit
  • TOKENOMICS
    • KSP
      • KSP TOKENOMICS
      • Automation of KSP distribution rate
        • Voting policy on passing governance
        • KSP distribution ratio reflection policy
      • KSP Allocation
  • PRODUCT
    • SWAP
    • Single-side Deposit
      • Detailed policy of Single Deposit
    • Pair Deposit
    • V3 Pair Deposit
      • V2 to V3 Migration
        • V2 to V3 Migration Guide
        • V2 to V3 Migration Policy
      • V3 Pair Deposit
        • V3 Deposit Guide
        • V3 pair Deposit Policy
      • V3 to V3 Migration
        • V3 to V3 Migration Guide
        • V3 to V3 Migration Policy
      • V3 Pair Withdraw
        • V3 Withdraw Guide
        • V3 Withdraw Policy
    • Plus Deposit
      • Detailed policy of Plus Deposit
    • Long/Short Position Deposit
      • Open and Close Long/Short Positions
        • Open Short Positions
        • Open Long Positions
        • Remove Long Position
        • Remove Short Position
      • Position Deposit Details Policy
    • KSP Staking & Voting
      • Staking, Pool Voting Policy
    • Governance
      • Governance Voting Policy
    • Drops
    • Ecopot
    • Pool Airdrop
    • APR & APY
      • TVL
      • Pool
      • Staking
    • Interest rate
  • DEVELOPERS
    • Contract
      • Factory
      • Exchange
      • PoolVoting
      • VotingKSP
      • Treasury
      • Distribution
      • Governor
      • SinglePool
      • SinglePool Factory
      • PlusPool
      • PlusPool Factory
      • Store
      • Utils
      • Single/Plus Utils
      • Helper
      • EcoPotVoting
      • EcoPot
      • V3
        • V3Factory
        • V3Pool
        • NonfungiblePositionManager
        • NonfungibleTokenPositionDescriptor
        • V3SwapRouter
        • V3Migrator
        • V3Estimator
        • PositionMigrator
        • V3Treasury
        • V3AirdropOperator
        • UniversalRouter
    • Airdrop
      • Set Airdrop Operator
      • Start Airdrop
    • EcoPot
      • Set EcoPot
      • Start EcoPot
  • HOW-TO GUIDES
    • KLAYswap Guide
    • How to add liquidity on KLAYswap
    • [Burrito Wallet] How to deposit assets using mobile devices?
    • How to create a liquidity pool on KLAYswap
    • How to stake and vote on KLAYswap
    • How to deposit assets
      • Deposit Klaytn-based assets
      • Deposit Ethereum-based assets
      • Deposit XRP
    • FAQ
  • KLAYswap
  • Orbit Bridge
  • KLAYswap git
  • Orbit Bridge git
  • KLAYswap audit report
Powered by GitBook
On this page
  • Code
  • Address
  • Events, Read-Only Functions, and State-Changing Functions

Was this helpful?

  1. DEVELOPERS
  2. Contract
  3. V3

NonfungiblePositionManager

PreviousV3PoolNextNonfungibleTokenPositionDescriptor

Last updated 1 year ago

Was this helpful?

This contract wraps KLAYswap V3 positions in the ERC721 non-fungible token interface

Code

Github Link: (Will be updated after official launch)

Address

  • Cypress :

Events, Read-Only Functions, and State-Changing Functions

Events

IncreaseLiquidity

event IncreaseLiquidity(
    uint256 indexed tokenId, 
    uint128 liquidity, 
    uint256 amount0, 
    uint256 amount1
);

Emitted when liquidity is increased for a position NFT

Also emitted when a token is minted

Parameters:

Name
Type
Description

tokenId

uint256

The ID of the token for which liquidity was increased

liquidity

uint128

The amount by which liquidity for the NFT position was increased

amount0

uint256

The amount of token0 that was paid for the increase in liquidity

amount1

uint256

The amount of token1 that was paid for the increase in liquidity

DecreaseLiquidity

event DecreaseLiquidity(
    uint256 indexed tokenId, 
    uint128 liquidity, 
    uint256 amount0, 
    uint256 amount1
);

Emitted when liquidity is decreased for a position NFT

Name
Type
Description

tokenId

uint256

The ID of the token for which liquidity was decreased

liquidity

uint128

The amount by which liquidity for the NFT position was decreased

amount0

uint256

The amount of token0 that was accounted for the decrease in liquidity

amount1

uint256

The amount of token1 that was accounted for the decrease in liquidity

Collect

event Collect(
    uint256 indexed tokenId, 
    address recipient,
    uint256 amount0, 
    uint256 amount1,
    uint256 reward
);

Emitted when tokens are collected for a position NFT

The amounts reported may not be exactly equivalent to the amounts transferred, due to rounding behavior

Name
Type
Description

tokenId

uint256

The ID of the token for which underlying tokens were collected

recipient

address

The address of the account that received the collected tokens

amount0

uint256

The amount of token0 owed to the position that was collected

amount1

uint256

The amount of token1 owed to the position that was collected

Parameter Structs

struct MintParams {
    address token0;
    address token1;
    uint24 fee;
    int24 tickLower;
    int24 tickUpper;
    uint256 amount0Desired;
    uint256 amount1Desired;
    uint256 amount0Min;
    uint256 amount1Min;
    address recipient;
    uint256 deadline;
}

struct IncreaseLiquidityParams {
   uint256 tokenId;
   uint256 amount0Desired;
   uint256 amount1Desired;
   uint256 amount0Min;
   uint256 amount1Min;
   uint256 deadline;
}

struct DecreaseLiquidityParams {
    uint256 tokenId;
    uint128 liquidity;
    uint256 amount0Min;
    uint256 amount1Min;
    uint256 deadline;
}

struct CollectParams {
    uint256 tokenId;
    address recipient;
    uint128 amount0Max;
    uint128 amount1Max;
}

Read-Only Functions

function positions(
    uint256 tokenId
) external view returns (
    uint96 nonce, 
    address operator, 
    address token0, 
    address token1, 
    uint24 fee, 
    int24 tickLower, 
    int24 tickUpper, 
    uint128 liquidity, 
    uint256 feeGrowthInside0LastX128, 
    uint256 feeGrowthInside1LastX128, 
    uint128 tokensOwed0, 
    uint128 tokensOwed1
)

Returns the position information associated with a given token ID.

Throws if the token ID is not valid.

Name
Type
Description

tokenId

uint256

The ID of the token that represents the position

Name
Type
Description

nonce

uint96

The nonce for permits

operator

address

The address that is approved for spending

token0

address

The address of the token0 for a specific pool

token1

address

The address of the token1 for a specific pool

fee

uint24

The fee associated with the pool

tickLower

int24

The lower end of the tick range for the position

tickUpper

int24

The higher end of the tick range for the position

liquidity

uint128

The liquidity of the position

feeGrowthInside0LastX128

uint256

The fee growth of token0 as of the last action on the individual position

feeGrowthInside1LastX128

uint256

The fee growth of token1 as of the last action on the individual position

tokensOwed0

uint128

The uncollected amount of token0 owed to the position as of the last computation

tokensOwed1

uint128

The uncollected amount of token1 owed to the position as of the last computation

positionRewards

function positionRewards(uint256 tokenId)
external
view
returns (
    uint256 rewardGrowthInsideLastX128,
    uint128 reward,
    uint128 fee0Sum,
    uint128 fee1Sum,
    uint128 rewardSum
);
Name
Type
Description

tokenId

uint256

The ID of the token that represents the position

Return Values:

Name
Type
Description

rewardGrowthInsideLastX128

uint256

The reward growth as of the last action on the individual position

reward

uint128

The uncollected amount of reward

fee0Sum

uint128

The cumulated amountof fee0

fee1Sum

uint128

The cumulated amountof fee1

rewardSum

uint128

The collected amount of reward

  function getApproved() public view returns (address)

Returns the account approved for tokenId token. Requirements:

  • tokenId must exist.

  function tokenURI(uint256 tokenId) public view returns (string)

Returns a URI describing a particular token ID

Name
Type
Description

tokenId

uint256

The ID of the token that represents the minted position

A base64 string with the URI data.

  function baseURI() public returns (string)

State-Changing Functions

function mint(
    struct INonfungiblePositionManager.MintParams params
) external returns (
    uint256 tokenId, 
    uint128 liquidity, 
    uint256 amount0, 
    uint256 amount1
)

Creates a new position wrapped in a NFT

Call this when the pool does exist and is initialized. Note that if the pool is created but not initialized a method does not exist, i.e. the pool is assumed to be initialized.

Name
Type
Description

params

struct INonfungiblePositionManager.MintParams

The params necessary to mint a position, encoded as MintParams in calldata

Name
Type
Description

tokenId

uint256

The ID of the token that represents the minted position

liquidity

uint128

The amount of liquidity for this position

amount0

uint256

The amount of token0

amount1

uint256

The amount of token1

function increaseLiquidity(
    struct INonfungiblePositionManager.IncreaseLiquidityParams params
) external returns (
    uint128 liquidity, 
    uint256 amount0, 
    uint256 amount1
)

Increases the amount of liquidity in a position, with tokens paid by the msg.sender

Name
Type
Description

params

struct INonfungiblePositionManager.IncreaseLiquidityParams

The params necessary to increase liquidity on the position, encoded as IncreaseLiquidityParams in calldata

Name
Type
Description

liquidity

uint128

The new liquidity amount as a result of the increase

amount0

uint256

The amount of token0 to achieve resulting liquidity

amount1

uint256

The amount of token1 to achieve resulting liquidity

function decreaseLiquidity(
    struct INonfungiblePositionManager.DecreaseLiquidityParams params
) external returns (uint256 amount0, uint256 amount1)

Decreases the amount of liquidity in a position and accounts it to the position

Name
Type
Description

params

struct INonfungiblePositionManager.DecreaseLiquidityParams

The params necessary to decrease liquidity on the position, encoded as IncreaseLiquidityParams in calldata

Name
Type
Description

amount0

uint256

The amount of token0 accounted to the position's tokens owed

amount1

uint256

The amount of token1 accounted to the position's tokens owed

function collect(
    struct INonfungiblePositionManager.CollectParams params
) external returns (uint256 amount0, uint256 amount1)

Collects up to a maximum amount of fees owed to a specific position to the recipient

Name
Type
Description

params

struct INonfungiblePositionManager.CollectParams

The params necessary to collect, encoded as CollectParams in calldata

recipient The account that should receive the tokens, amount0Max The maximum amount of token0 to collect, amount1Max The maximum amount of token1 to collect

Name
Type
Description

amount0

uint256

The amount of fees collected in token0

amount1

uint256

The amount of fees collected in token1

function burn(uint256 tokenId) external

Burns a token ID, which deletes it from the NFT contract. The token must have 0 liquidity and all tokens must be collected first.

Name
Type
Description

tokenId

uint256

The ID of the token that is being burned

Parameters:

Parameters:

MintParams

IncreaseLiquidityParams

DecreaseLiquidityParams

CollectParams

positions

Parameters:

Return Values:

Parameters:

getApproved

tokenURI

Parameters:

Return Values:

baseURI

mint

Parameters:

Return Values:

increaseLiquidity

Parameters:

Return Values:

decreaseLiquidity

Parameters:

Return Values:

collect

Parameters:

Return Values:

burn

Parameters:

0x51D233B5aE7820030A29c75d6788403B8B5d317B
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​