position state

ErrSpoofedRealm

GetPositionCount

GetPositionCount returns the total number of positions.

GetPositionIDs

GetPositionIDs returns a paginated list of position IDs.

GetPosition

GetPosition returns the position data for a given position ID.

IsBurned

IsBurned returns whether a position has been burned.

IsInRange

IsInRange returns whether a position's ticks are within the current price range.

GetPositionTokenBalances

GetPositionTokenBalances returns the token0 balance of a position.

GetPositionToken0Balance

GetPositionToken1Balance

GetPositionFeeGrowthInside0LastX128

GetPositionFeeGrowthInside0LastX128 returns the last recorded fee growth inside for token0.

GetPositionFeeGrowthInside1LastX128

GetPositionFeeGrowthInside1LastX128 returns the last recorded fee growth inside for token1.

GetPositionFeeGrowthInsideLastX128

GetPositionFeeGrowthInsideLastX128 returns the last recorded fee growth inside for both tokens.

GetPositionLiquidity

GetPositionLiquidity returns the liquidity amount of a position.

GetPositionOperator

GetPositionPoolKey

GetPositionPoolKey returns the pool key of a position.

GetPositionTickLower

GetPositionTickLower returns the lower tick of a position.

GetPositionTickUpper

GetPositionTickUpper returns the upper tick of a position.

GetPositionTicks

GetPositionTicks returns the lower and upper ticks of a position.

GetPositionTokensOwed0

GetPositionTokensOwed0 returns the amount of token0 owed to a position.

GetPositionTokensOwed1

GetPositionTokensOwed1 returns the amount of token1 owed to a position.

GetPositionTokensOwed

GetPositionTokensOwed returns the amount of tokens owed to a position.

GetUnclaimedFee

GetUnclaimedFee returns the unclaimed fees for both tokens of a position.

GetPositionOwner

clonePosition

cloneUint64Slice

Position

Position represents a liquidity position in a pool. Each position tracks the amount of liquidity, fee growth, and tokens owed to the position owner. All uint256 fields are stored as decimal strings to reduce realm object overhead.

isZeroStr

NewPosition

NewPositionsTree

NewPositionsTree allocates the positions BP-tree under /r/gnoswap/position's realm context (the realm that declares Position).

Mint

Mint creates a new liquidity position NFT. Parameters: - token0: path of the first token - token1: path of the second token - fee: pool fee tier - tickLower: lower tick boundary - tickUpper: upper tick boundary - amount0Desired: desired amount of token0 - amount1Desired: desired amount of token1 - amount0Min: minimum amount of token0 - amount1Min: minimum amount of token1 - deadline: transaction deadline - mintTo: recipient of the position NFT - referrer: referrer address for reward tracking Returns: - uint64: position ID - string: liquidity amount - string: amount of token0 added - string: amount of token1 added

IncreaseLiquidity

IncreaseLiquidity adds liquidity to an existing position. Parameters: - positionId: ID of the position - amount0DesiredStr: desired amount of token0 - amount1DesiredStr: desired amount of token1 - amount0MinStr: minimum amount of token0 - amount1MinStr: minimum amount of token1 - deadline: transaction deadline Returns: - uint64: position ID - string: new liquidity amount - string: amount of token0 added - string: amount of token1 added - string: pool path

DecreaseLiquidity

DecreaseLiquidity removes liquidity from a position. Parameters: - positionId: ID of the position - liquidityStr: amount of liquidity to remove - amount0MinStr: minimum amount of token0 - amount1MinStr: minimum amount of token1 - deadline: transaction deadline Returns: - uint64: position ID - string: removed liquidity amount - string: amount of token0 removed - string: amount of token1 removed - string: pool path - string: net amount of token0 after fees - string: net amount of token1 after fees

Reposition

Reposition changes the tick range of a position. Parameters: - positionId: ID of the position - tickLower: new lower tick boundary - tickUpper: new upper tick boundary - amount0DesiredStr: desired amount of token0 - amount1DesiredStr: desired amount of token1 - amount0MinStr: minimum amount of token0 - amount1MinStr: minimum amount of token1 - deadline: transaction deadline Returns: - uint64: position ID - string: new liquidity amount - int32: new lower tick - int32: new upper tick - string: amount of token0 used - string: amount of token1 used

CollectFee

CollectFee collects accumulated fees from a position. Parameters: - positionId: ID of the position Returns: - uint64: position ID - string: amount of token0 collected - string: amount of token1 collected - string: pool path - string: token0 path - string: token1 path

SetPositionOperator

SetPositionOperator sets an operator for a position. Parameters: - positionId: ID of the position - operator: address of the operator

domainPath

kvStore

versionManager

implementation

init.39

initializeDomainStore

getImplementation

updateImplementation

StoreKey

StoreKeyPositions

// Positions

StoreKeyPositionNextID

// Position next ID

positionStore

NewPositionStore

NewPositionStore creates a new protocol fee store instance with the provided KV store. This function is used by the upgrade system to create storage instances for each implementation.

IPosition

IPositionManager

IPositionGetter

IPositionStore

RegisterInitializer

RegisterInitializer registers a new position implementation version. This function is called by each version (v1, v2, etc.) during initialization to register their implementation with the proxy system. The initializer function creates a new instance of the implementation using the provided positionStore interface. Security: Only contracts within the domain path can register initializers. Each package path can only register once to prevent duplicate registrations.

UpgradeImpl

UpgradeImpl switches the active position implementation to a different version. This function allows seamless upgrades from one version to another without data migration or downtime. Security: Only admin or governance can perform upgrades. The new implementation must have been previously registered via RegisterInitializer.

GetImplementationPackagePath

GetImplementationPackagePath returns the package path of the currently active implementation.