UNI-V3-POS
Ethereum ERC-721 NFT0xc36442b4a4522e871399cd717abdd847ab11fe88
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
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,169,825 · 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
| Name | Type | Description |
|---|---|---|
| — | address | Returns the address of WETH9 |
balanceOf(owner: address)
view
dev: Returns the number of tokens in ``owner``'s account.
Parameters
| Name | Type | Description |
|---|---|---|
| owner | address |
Returns
| Name | Type | Description |
|---|---|---|
| — | uint256 |
baseURI()
pure
→
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 |
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
dev: Returns the account approved for `tokenId` token. Requirements: - `tokenId` must exist.
Parameters
| Name | Type | Description |
|---|---|---|
| tokenId | uint256 |
Returns
| Name | Type | Description |
|---|---|---|
| — | address |
isApprovedForAll(owner: address, operator: address)
view
dev: Returns if the `operator` is allowed to manage all of the assets of `owner`. See {setApprovalForAll}
Parameters
| Name | Type | Description |
|---|---|---|
| owner | address | |
| operator | address |
Returns
| Name | Type | Description |
|---|---|---|
| — | bool |
name()
view
→ Uniswap V3 Positions NFT-V1
dev: Returns the token collection name.
Returns
| Name | Type | Description |
|---|---|---|
| — | string |
ownerOf(tokenId: uint256)
view
dev: Returns the owner of the `tokenId` token. Requirements: - `tokenId` must exist.
Parameters
| Name | Type | Description |
|---|---|---|
| tokenId | uint256 |
Returns
| Name | Type | Description |
|---|---|---|
| — | address |
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
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 |
Returns
| Name | Type | Description |
|---|---|---|
| — | bool |
symbol()
view
→ UNI-V3-POS
dev: Returns the token collection symbol.
Returns
| Name | Type | Description |
|---|---|---|
| — | string |
tokenByIndex(index: uint256)
view
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 |
Returns
| Name | Type | Description |
|---|---|---|
| — | uint256 |
tokenOfOwnerByIndex(owner: address, index: uint256)
view
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 | |
| index | uint256 |
Returns
| Name | Type | Description |
|---|---|---|
| — | uint256 |
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,165,688
dev: Returns the total amount of tokens stored by the contract.
Returns
| Name | Type | Description |
|---|---|---|
| — | uint256 |
Write Functions
approve(to: address, tokenId: uint256)
nonpayable
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 | |
| tokenId | uint256 |
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
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 | |
| to | address | |
| tokenId | uint256 |
safeTransferFrom(from: address, to: address, tokenId: uint256, _data: bytes)
nonpayable
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 | |
| to | address | |
| tokenId | uint256 | |
| _data | bytes |
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
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 | |
| approved | bool |
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
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 | |
| to | address | |
| tokenId | uint256 |
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 | ✓ |