UNI-V3-POS

Ethereum ERC-721 NFT Browse chains

0xc36442b4a4522e871399cd717abdd847ab11fe88

Proxy implementation: 0xc36442b4a4522e871399cd717abdd847ab11fe88

Solidity v0.7.6+commit.7338295f

Non-fungible token collection.

🤖
Query this contract from your AI
Reference: univ3-nftmanager-eth 0xc36442b4a4522e871399cd717abdd847ab11fe88
Sample prompt: "Tell me the current state of univ3-nftmanager-eth"
No AI wired up yet? → mcp.smarts.md · Browse chains

Admin & Risk

Who can change the rules?

Detected upgradeable and mintable controls from the verified ABI.

Upgradeable Mintable

Current controls

Implementation
0xc36442b4a4522e871399cd717abdd847ab11fe88 ↗ Etherscan → smarts proxy

Overview

Read Functions
17
Write Functions
21
Events
6

Read Functions

Block #25,493,974 · just now
DOMAIN_SEPARATOR() view → 0x24ea63bbfcb16de2524c7c24322b6cbc39cb2d08881bce770af4771e6b1ad117

The domain separator used in the permit signature

Returns

Name Type Description
bytes32 The domain seperator used in encoding of permit signature
PERMIT_TYPEHASH() view → 0x49ecf333e5b8c95c40fdafc95c1ad136e8914a8fb55e9dc8bb01eaa83a2df9ad

The permit typehash used in the permit signature

Returns

Name Type Description
bytes32 The typehash for the permit
WETH9() view → 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2

Returns the address of the WETH9 token used by this NonfungiblePositionManager.✨ AI

Returns

Name Type Description
address Returns the address of WETH9
balanceOf(owner: address) view

Returns the number of NFTs owned by the given address.✨ AI

dev: Returns the number of tokens in ``owner``'s account.

Parameters

Name Type Description
owner address Address whose NFT balance will be returned.✨ AI

Returns

Name Type Description
uint256 The number of NFTs owned by the address.✨ AI
baseURI() pure

Return the base URI used to construct each token's metadata URI.✨ AI

dev: Returns the base URI set via {_setBaseURI}. This will be automatically added as a prefix in {tokenURI} to each token's URI, or to the token ID if no specific URI is set for that token ID.

Returns

Name Type Description
string The base URI string prefixed to token IDs to form each token's metadata URI.✨ AI
factory() view → 0x1f98431c8ad98523631ae4a59f267346ea31f984

The contract that deployed the pool, which must adhere to the IUniswapV3Factory interface

Returns

Name Type Description
address The contract address
getApproved(tokenId: uint256) view

Return the address approved to transfer the specified NFT token.✨ AI

dev: Returns the account approved for `tokenId` token. Requirements: - `tokenId` must exist.

Parameters

Name Type Description
tokenId uint256 ID of the NFT to query approval for.✨ AI

Returns

Name Type Description
address The address approved to transfer the NFT, or the zero address if no approval exists.✨ AI
isApprovedForAll(owner: address, operator: address) view

Check whether an operator is approved to manage all tokens owned by the given owner.✨ AI

dev: Returns if the `operator` is allowed to manage all of the assets of `owner`. See {setApprovalForAll}

Parameters

Name Type Description
owner address Address of the token owner.✨ AI
operator address Address being queried for approval to manage owner's tokens.✨ AI

Returns

Name Type Description
bool True if operator is approved to manage all of owner's NFTs; otherwise false.✨ AI
name() view → Uniswap V3 Positions NFT-V1

Returns the name of the ERC-721 token used to identify position NFTs.✨ AI

dev: Returns the token collection name.

Returns

Name Type Description
string The ERC-721 token name string for the NonfungiblePositionManager NFTs.✨ AI
ownerOf(tokenId: uint256) view

Returns the owner address of the NFT with the given tokenId.✨ AI

dev: Returns the owner of the `tokenId` token. Requirements: - `tokenId` must exist.

Parameters

Name Type Description
tokenId uint256 ID of the NFT to query.✨ AI

Returns

Name Type Description
address Address that currently owns the specified tokenId.✨ AI
positions(tokenId: uint256) view

Returns the position information associated with a given token ID.

dev: Throws if the token ID is not valid.

Parameters

Name Type Description
tokenId uint256 The ID of the token that represents the position

Returns

Name Type Description
nonce uint96 nonce The nonce for permits
operator address operator The address that is approved for spending
token0 address token0 The address of the token0 for a specific pool
token1 address token1 The address of the token1 for a specific pool
fee uint24 fee The fee associated with the pool
tickLower int24 tickLower The lower end of the tick range for the position
tickUpper int24 tickUpper The higher end of the tick range for the position
liquidity uint128 liquidity The liquidity of the position
feeGrowthInside0LastX128 uint256 feeGrowthInside0LastX128 The fee growth of token0 as of the last action on the individual position
feeGrowthInside1LastX128 uint256 feeGrowthInside1LastX128 The fee growth of token1 as of the last action on the individual position
tokensOwed0 uint128 tokensOwed0 The uncollected amount of token0 owed to the position as of the last computation
tokensOwed1 uint128 tokensOwed1 The uncollected amount of token1 owed to the position as of the last computation
supportsInterface(interfaceId: bytes4) view

Report whether the contract implements the interface specified by the provided ERC-165 interfaceId.✨ AI

dev: Returns true if this contract implements the interface defined by `interfaceId`. See the corresponding https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section] to learn more about how these ids are created. This function call must use less than 30 000 gas.

Parameters

Name Type Description
interfaceId bytes4 The ERC-165 interface identifier (4-byte selector) to query.✨ AI

Returns

Name Type Description
bool True if the contract implements the interface with the given ID, otherwise false.✨ AI
symbol() view → UNI-V3-POS

Returns the ERC-721 token symbol that identifies this NonfungiblePositionManager NFT collection.✨ AI

dev: Returns the token collection symbol.

Returns

Name Type Description
string The token symbol string for this NFT collection.✨ AI
tokenByIndex(index: uint256) view

Returns the token ID at the given index in the full NFT collection.✨ AI

dev: Returns a token ID at a given `index` of all the tokens stored by the contract. Use along with {totalSupply} to enumerate all tokens.

Parameters

Name Type Description
index uint256 Zero-based index into the collection of all minted tokens.✨ AI

Returns

Name Type Description
uint256 The token ID (uint256) stored at the specified index.✨ AI
tokenOfOwnerByIndex(owner: address, index: uint256) view

Returns the token ID owned by an address at a specific index.✨ AI

dev: Returns a token ID owned by `owner` at a given `index` of its token list. Use along with {balanceOf} to enumerate all of ``owner``'s tokens.

Parameters

Name Type Description
owner address Address whose tokens are being queried.✨ AI
index uint256 Zero-based index into the owner's list of tokens.✨ AI

Returns

Name Type Description
uint256 The uint256 token ID at the given owner index.✨ AI
tokenURI(tokenId: uint256) view

Produces the URI describing a particular token ID for a position manager

dev: Note this URI may be a data: URI with the JSON contents directly inlined

Parameters

Name Type Description
tokenId uint256 The ID of the token for which to produce a description, which may not be valid

Returns

Name Type Description
string The URI of the ERC721-compliant metadata
totalSupply() view → 1,195,044

Returns the total number of NFT positions tracked by the contract.✨ AI

dev: Returns the total amount of tokens stored by the contract.

Returns

Name Type Description
uint256 Total number of tokens currently tracked by the contract (ERC-721 total supply).✨ AI

Write Functions

approve(to: address, tokenId: uint256) nonpayable

Approve an address to transfer the specified NFT tokenId on the caller's behalf.✨ AI

dev: Gives permission to `to` to transfer `tokenId` token to another account. The approval is cleared when the token is transferred. Only a single account can be approved at a time, so approving the zero address clears previous approvals. Requirements: - The caller must own the token or be an approved operator. - `tokenId` must exist. Emits an {Approval} event.

Parameters

Name Type Description
to address Address that will be allowed to transfer the token.✨ AI
tokenId uint256 Identifier of the NFT to grant transfer approval for.✨ AI
burn(tokenId: uint256) payable

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

Parameters

Name Type Description
tokenId uint256 The ID of the token that is being burned
collect(params: tuple) payable

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

Parameters

Name Type Description
params tuple tokenId The ID of the NFT for which tokens are being collected, recipient The account that should receive the tokens, amount0Max The maximum amount of token0 to collect, amount1Max The maximum amount of token1 to collect

Returns

Name Type Description
amount0 uint256 amount0 The amount of fees collected in token0
amount1 uint256 amount1 The amount of fees collected in token1
createAndInitializePoolIfNecessary(token0: address, token1: address, fee: uint24, sqrtPriceX96: uint160) payable

Creates a new pool if it does not exist, then initializes if not initialized

dev: This method can be bundled with others via IMulticall for the first action (e.g. mint) performed against a pool

Parameters

Name Type Description
token0 address The contract address of token0 of the pool
token1 address The contract address of token1 of the pool
fee uint24 The fee amount of the v3 pool for the specified token pair
sqrtPriceX96 uint160 The initial square root price of the pool as a Q64.96 value

Returns

Name Type Description
pool address pool Returns the pool address based on the pair of tokens and fee, will return the newly created pool address if necessary
decreaseLiquidity(params: tuple) payable

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

Parameters

Name Type Description
params tuple tokenId The ID of the token for which liquidity is being decreased, amount The amount by which liquidity will be decreased, amount0Min The minimum amount of token0 that should be accounted for the burned liquidity, amount1Min The minimum amount of token1 that should be accounted for the burned liquidity, deadline The time by which the transaction must be included to effect the change

Returns

Name Type Description
amount0 uint256 amount0 The amount of token0 accounted to the position's tokens owed
amount1 uint256 amount1 The amount of token1 accounted to the position's tokens owed
increaseLiquidity(params: tuple) payable

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

Parameters

Name Type Description
params tuple tokenId The ID of the token for which liquidity is being increased, amount0Desired The desired amount of token0 to be spent, amount1Desired The desired amount of token1 to be spent, amount0Min The minimum amount of token0 to spend, which serves as a slippage check, amount1Min The minimum amount of token1 to spend, which serves as a slippage check, deadline The time by which the transaction must be included to effect the change

Returns

Name Type Description
liquidity uint128 liquidity The new liquidity amount as a result of the increase
amount0 uint256 amount0 The amount of token0 to acheive resulting liquidity
amount1 uint256 amount1 The amount of token1 to acheive resulting liquidity
mint(params: tuple) payable

Creates a new position wrapped in a NFT

dev: 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.

Parameters

Name Type Description
params tuple The params necessary to mint a position, encoded as `MintParams` in calldata

Returns

Name Type Description
tokenId uint256 tokenId The ID of the token that represents the minted position
liquidity uint128 liquidity The amount of liquidity for this position
amount0 uint256 amount0 The amount of token0
amount1 uint256 amount1 The amount of token1
multicall(data: bytes[]) payable

Call multiple functions in the current contract and return the data from all of them if they all succeed

dev: The `msg.value` should not be trusted for any method callable from multicall.

Parameters

Name Type Description
data bytes[] The encoded function data for each of the calls to make to this contract

Returns

Name Type Description
results bytes[] results The results from each of the calls passed in via data
permit(spender: address, tokenId: uint256, deadline: uint256, v: uint8, r: bytes32, s: bytes32) payable

Approve of a specific token ID for spending by spender via signature

Parameters

Name Type Description
spender address The account that is being approved
tokenId uint256 The ID of the token that is being approved for spending
deadline uint256 The deadline timestamp by which the call must be mined for the approve to work
v uint8 Must produce valid secp256k1 signature from the holder along with `r` and `s`
r bytes32 Must produce valid secp256k1 signature from the holder along with `v` and `s`
s bytes32 Must produce valid secp256k1 signature from the holder along with `r` and `v`
refundETH() payable

Refunds any ETH balance held by this contract to the `msg.sender`

dev: Useful for bundling with mint or increase liquidity that uses ether, or exact output swaps that use ether for the input amount
safeTransferFrom(from: address, to: address, tokenId: uint256) nonpayable

Safely transfers the NFT tokenId from from to to, invoking onERC721Received on the recipient if it is a contract.✨ AI

dev: Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients are aware of the ERC721 protocol to prevent tokens from being forever locked. Requirements: - `from` cannot be the zero address. - `to` cannot be the zero address. - `tokenId` token must exist and be owned by `from`. - If the caller is not `from`, it must be have been allowed to move this token by either {approve} or {setApprovalForAll}. - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer. Emits a {Transfer} event.

Parameters

Name Type Description
from address Current owner address initiating the transfer.✨ AI
to address Recipient address to receive the NFT.✨ AI
tokenId uint256 Identifier of the NFT to transfer.✨ AI
safeTransferFrom(from: address, to: address, tokenId: uint256, _data: bytes) nonpayable

Safely transfers the NFT tokenId from from to to, invoking onERC721Received on the recipient if it is a contract.✨ AI

dev: Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients are aware of the ERC721 protocol to prevent tokens from being forever locked. Requirements: - `from` cannot be the zero address. - `to` cannot be the zero address. - `tokenId` token must exist and be owned by `from`. - If the caller is not `from`, it must be have been allowed to move this token by either {approve} or {setApprovalForAll}. - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer. Emits a {Transfer} event.

Parameters

Name Type Description
from address Current owner address initiating the transfer.✨ AI
to address Recipient address to receive the NFT.✨ AI
tokenId uint256 Identifier of the NFT to transfer.✨ AI
_data bytes Additional data forwarded to onERC721Received if recipient is a contract.✨ AI
selfPermit(token: address, value: uint256, deadline: uint256, v: uint8, r: bytes32, s: bytes32) payable

Permits this contract to spend a given token from `msg.sender`

dev: The `owner` is always msg.sender and the `spender` is always address(this).

Parameters

Name Type Description
token address The address of the token spent
value uint256 The amount that can be spent of token
deadline uint256 A timestamp, the current blocktime must be less than or equal to this timestamp
v uint8 Must produce valid secp256k1 signature from the holder along with `r` and `s`
r bytes32 Must produce valid secp256k1 signature from the holder along with `v` and `s`
s bytes32 Must produce valid secp256k1 signature from the holder along with `r` and `v`
selfPermitAllowed(token: address, nonce: uint256, expiry: uint256, v: uint8, r: bytes32, s: bytes32) payable

Permits this contract to spend the sender's tokens for permit signatures that have the `allowed` parameter

dev: The `owner` is always msg.sender and the `spender` is always address(this)

Parameters

Name Type Description
token address The address of the token spent
nonce uint256 The current nonce of the owner
expiry uint256 The timestamp at which the permit is no longer valid
v uint8 Must produce valid secp256k1 signature from the holder along with `r` and `s`
r bytes32 Must produce valid secp256k1 signature from the holder along with `v` and `s`
s bytes32 Must produce valid secp256k1 signature from the holder along with `r` and `v`
selfPermitAllowedIfNecessary(token: address, nonce: uint256, expiry: uint256, v: uint8, r: bytes32, s: bytes32) payable

Permits this contract to spend the sender's tokens for permit signatures that have the `allowed` parameter

dev: The `owner` is always msg.sender and the `spender` is always address(this) Can be used instead of #selfPermitAllowed to prevent calls from failing due to a frontrun of a call to #selfPermitAllowed.

Parameters

Name Type Description
token address The address of the token spent
nonce uint256 The current nonce of the owner
expiry uint256 The timestamp at which the permit is no longer valid
v uint8 Must produce valid secp256k1 signature from the holder along with `r` and `s`
r bytes32 Must produce valid secp256k1 signature from the holder along with `v` and `s`
s bytes32 Must produce valid secp256k1 signature from the holder along with `r` and `v`
selfPermitIfNecessary(token: address, value: uint256, deadline: uint256, v: uint8, r: bytes32, s: bytes32) payable

Permits this contract to spend a given token from `msg.sender`

dev: The `owner` is always msg.sender and the `spender` is always address(this). Can be used instead of #selfPermit to prevent calls from failing due to a frontrun of a call to #selfPermit

Parameters

Name Type Description
token address The address of the token spent
value uint256 The amount that can be spent of token
deadline uint256 A timestamp, the current blocktime must be less than or equal to this timestamp
v uint8 Must produce valid secp256k1 signature from the holder along with `r` and `s`
r bytes32 Must produce valid secp256k1 signature from the holder along with `v` and `s`
s bytes32 Must produce valid secp256k1 signature from the holder along with `r` and `v`
setApprovalForAll(operator: address, approved: bool) nonpayable

Allow or revoke an operator to manage all NFTs owned by the caller.✨ AI

dev: Approve or remove `operator` as an operator for the caller. Operators can call {transferFrom} or {safeTransferFrom} for any token owned by the caller. Requirements: - The `operator` cannot be the caller. Emits an {ApprovalForAll} event.

Parameters

Name Type Description
operator address Address to grant or revoke permission to manage all caller-owned NFTs.✨ AI
approved bool True to grant operator approval, false to revoke it.✨ AI
sweepToken(token: address, amountMinimum: uint256, recipient: address) payable

Transfers the full amount of a token held by this contract to recipient

dev: The amountMinimum parameter prevents malicious contracts from stealing the token from users

Parameters

Name Type Description
token address The contract address of the token which will be transferred to `recipient`
amountMinimum uint256 The minimum amount of token required for a transfer
recipient address The destination address of the token
transferFrom(from: address, to: address, tokenId: uint256) nonpayable

Transfer a position NFT from one address to another.✨ AI

dev: Transfers `tokenId` token from `from` to `to`. WARNING: Usage of this method is discouraged, use {safeTransferFrom} whenever possible. Requirements: - `from` cannot be the zero address. - `to` cannot be the zero address. - `tokenId` token must be owned by `from`. - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}. Emits a {Transfer} event.

Parameters

Name Type Description
from address Current owner or approved operator address of the token.✨ AI
to address Recipient address that will receive ownership of the token.✨ AI
tokenId uint256 Identifier of the NonfungiblePositionManager NFT to transfer.✨ AI
uniswapV3MintCallback(amount0Owed: uint256, amount1Owed: uint256, data: bytes) nonpayable

Called to `msg.sender` after minting liquidity to a position from IUniswapV3Pool#mint.

dev: In the implementation you must pay the pool tokens owed for the minted liquidity. The caller of this method must be checked to be a UniswapV3Pool deployed by the canonical UniswapV3Factory.

Parameters

Name Type Description
amount0Owed uint256 The amount of token0 due to the pool for the minted liquidity
amount1Owed uint256 The amount of token1 due to the pool for the minted liquidity
data bytes Any data passed through by the caller via the IUniswapV3PoolActions#mint call
unwrapWETH9(amountMinimum: uint256, recipient: address) payable

Unwraps the contract's WETH9 balance and sends it to recipient as ETH.

dev: The amountMinimum parameter prevents malicious contracts from stealing WETH9 from users.

Parameters

Name Type Description
amountMinimum uint256 The minimum amount of WETH9 to unwrap
recipient address The address receiving ETH

Events

Approval(owner: address, approved: address, tokenId: uint256)
Name Type Indexed Description
owner address
approved address
tokenId uint256
ApprovalForAll(owner: address, operator: address, approved: bool)
Name Type Indexed Description
owner address
operator address
approved bool
Collect(tokenId: uint256, recipient: address, amount0: uint256, amount1: uint256)

Emitted when tokens are collected for a position NFT

Name Type Indexed 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
DecreaseLiquidity(tokenId: uint256, liquidity: uint128, amount0: uint256, amount1: uint256)

Emitted when liquidity is decreased for a position NFT

Name Type Indexed 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
IncreaseLiquidity(tokenId: uint256, liquidity: uint128, amount0: uint256, amount1: uint256)

Emitted when liquidity is increased for a position NFT

Name Type Indexed 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
Transfer(from: address, to: address, tokenId: uint256)
Name Type Indexed Description
from address
to address
tokenId uint256