NonfungiblePositionManager

Mantle ERC-721 NFT

0x9c3bde004b6383f296112536b1e3612e9229d98d

Solidity v0.7.6+commit.7338295f

Non-fungible token collection.

🤖

通过你的 AI 查询此合约

引用： 0x9c3bde004b6383f296112536b1e3612e9229d98d

示例提示词： "Tell me the current state of mantle/0x9c3bde004b6383f296112536b1e3612e9229d98d"

还没有接入 AI？→ mcp.smarts.md

Mantle 在 Smarts 上是仅文档链：源代码和 ABI 已索引，但当前不提供实时链上数据（状态、最新事件、管理员画像）。AI 代理仍可通过 MCP 调用 get_contract_info 和 get_contract_source。

概览

读取函数

写入函数

事件

读取函数

DOMAIN_SEPARATOR() view

The domain separator used in the permit signature

返回值

名称	类型	描述
—	bytes32	The domain seperator used in encoding of permit signature

PERMIT_TYPEHASH() view

The permit typehash used in the permit signature

返回值

名称	类型	描述
—	bytes32	The typehash for the permit

WETH9() view

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

返回值

名称	类型	描述
—	address	Returns the address of WETH9

balanceOf(owner: address) view

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

开发者： Returns the number of tokens in ``owner``'s account.

参数

名称	类型	描述
owner	address	Address whose NFT balance will be returned.✨ AI

返回值

名称	类型	描述
—	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

开发者： 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.

返回值

名称	类型	描述
—	string	The base URI string prefixed to token IDs to form each token's metadata URI.✨ AI

factory() view

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

返回值

名称	类型	描述
—	address	The contract address

getApproved(tokenId: uint256) view

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

开发者： Returns the account approved for `tokenId` token. Requirements: - `tokenId` must exist.

参数

名称	类型	描述
tokenId	uint256	ID of the NFT to query approval for.✨ AI

返回值

名称	类型	描述
—	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

开发者： Returns if the `operator` is allowed to manage all of the assets of `owner`. See {setApprovalForAll}

参数

名称	类型	描述
owner	address	Address of the token owner.✨ AI
operator	address	Address being queried for approval to manage owner's tokens.✨ AI

返回值

名称	类型	描述
—	bool	True if operator is approved to manage all of owner's NFTs; otherwise false.✨ AI

name() view

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

开发者： See {IERC721Metadata-name}.

返回值

名称	类型	描述
—	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

开发者： Returns the owner of the `tokenId` token. Requirements: - `tokenId` must exist.

参数

名称	类型	描述
tokenId	uint256	ID of the NFT to query.✨ AI

返回值

名称	类型	描述
—	address	Address that currently owns the specified tokenId.✨ AI

positions(tokenId: uint256) view

Returns the information about a position by the position's key

参数

名称	类型	描述
tokenId	uint256

返回值

名称	类型	描述
nonce	uint96	_liquidity The amount of liquidity in the position, Returns feeGrowthInside0LastX128 fee growth of token0 inside the tick range as of the last mint/burn/poke, Returns feeGrowthInside1LastX128 fee growth of token1 inside the tick range as of the last mint/burn/poke, Returns tokensOwed0 the computed amount of token0 owed to the position as of the last mint/burn/poke, Returns tokensOwed1 the computed amount of token1 owed to the position as of the last mint/burn/poke
operator	address
token0	address
token1	address
fee	uint24
tickLower	int24
tickUpper	int24
liquidity	uint128
feeGrowthInside0LastX128	uint256
feeGrowthInside1LastX128	uint256
tokensOwed0	uint128
tokensOwed1	uint128

supportsInterface(interfaceId: bytes4) view

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

开发者： 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.

参数

名称	类型	描述
interfaceId	bytes4	The ERC-165 interface identifier (4-byte selector) to query.✨ AI

返回值

名称	类型	描述
—	bool	True if the contract implements the interface with the given ID, otherwise false.✨ AI

symbol() view

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

开发者： See {IERC721Metadata-symbol}.

返回值

名称	类型	描述
—	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

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

参数

名称	类型	描述
index	uint256	Zero-based index into the collection of all minted tokens.✨ AI

返回值

名称	类型	描述
—	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

开发者： 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.

参数

名称	类型	描述
owner	address	Address whose tokens are being queried.✨ AI
index	uint256	Zero-based index into the owner's list of tokens.✨ AI

返回值

名称	类型	描述
—	uint256	The uint256 token ID at the given owner index.✨ AI

tokenURI(tokenId: uint256) view

Return the metadata URI for the NFT with the given tokenId.✨ AI

开发者： See {IERC721Metadata-tokenURI}.

参数

名称	类型	描述
tokenId	uint256	ID of the ERC-721 token to fetch metadata for.✨ AI

返回值

名称	类型	描述
—	string	A string containing the token metadata URI (typically an HTTP(s) or IPFS URL).✨ AI

totalSupply() view

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

开发者： Returns the total amount of tokens stored by the contract.

返回值

名称	类型	描述
—	uint256	Total number of tokens currently tracked by the contract (ERC-721 total supply).✨ AI

写入函数

approve(to: address, tokenId: uint256) nonpayable

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

开发者： 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.

参数

名称	类型	描述
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

Burn liquidity from the sender and account tokens owed for the liquidity to the position

开发者： Fees must be collected separately via a call to #collect

参数

名称	类型	描述
tokenId	uint256

collect(params: tuple) payable

Collects tokens owed to a position

开发者： Does not recompute fees earned, which must be done either via mint or burn of any amount of liquidity. Collect must be called by the position owner. To withdraw only token0 or only token1, amount0Requested or amount1Requested may be set to zero. To withdraw all tokens owed, caller may pass any value greater than the actual tokens owed, e.g. type(uint128).max. Tokens owed may be from accumulated swap fees or burned liquidity.

参数

名称	类型	描述
params	tuple

返回值

名称	类型	描述
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

开发者： This method can be bundled with others via IMulticall for the first action (e.g. mint) performed against a pool

参数

名称	类型	描述
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

返回值

名称	类型	描述
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

参数

名称	类型	描述
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

返回值

名称	类型	描述
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`

参数

名称	类型	描述
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

返回值

名称	类型	描述
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

Adds liquidity for the given recipient/tickLower/tickUpper position

开发者： The caller of this method receives a callback in the form of IUniswapV3MintCallback#uniswapV3MintCallback in which they must pay any token0 or token1 owed for the liquidity. The amount of token0/token1 due depends on tickLower, tickUpper, the amount of liquidity, and the current price.

参数

名称	类型	描述
params	tuple

返回值

名称	类型	描述
tokenId	uint256	amount0 The amount of token0 that was paid to mint the given amount of liquidity. Matches the value in the callback
liquidity	uint128	amount1 The amount of token1 that was paid to mint the given amount of liquidity. Matches the value in the callback
amount0	uint256
amount1	uint256

multicall(data: bytes[]) payable

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

开发者： The `msg.value` should not be trusted for any method callable from multicall.

参数

名称	类型	描述
data	bytes[]	The encoded function data for each of the calls to make to this contract

返回值

名称	类型	描述
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

参数

名称	类型	描述
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`

开发者： 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

开发者： 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.

参数

名称	类型	描述
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

参数

名称	类型	描述
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`

开发者： The `owner` is always msg.sender and the `spender` is always address(this).

参数

名称	类型	描述
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

开发者： The `owner` is always msg.sender and the `spender` is always address(this)

参数

名称	类型	描述
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

开发者： 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.

参数

名称	类型	描述
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`

开发者： 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

参数

名称	类型	描述
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

开发者： 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.

参数

名称	类型	描述
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

开发者： The amountMinimum parameter prevents malicious contracts from stealing the token from users

参数

名称	类型	描述
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

开发者： 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.

参数

名称	类型	描述
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.

开发者： 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.

参数

名称	类型	描述
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.

开发者： The amountMinimum parameter prevents malicious contracts from stealing WETH9 from users.

参数

名称	类型	描述
amountMinimum	uint256	The minimum amount of WETH9 to unwrap
recipient	address	The address receiving ETH

事件

Approval(owner: address, approved: address, tokenId: uint256)

名称	类型	已索引
owner	address	✓
approved	address	✓
tokenId	uint256	✓

ApprovalForAll(owner: address, operator: address, approved: bool)

名称	类型	已索引
owner	address	✓
operator	address	✓
approved	bool

Collect(tokenId: uint256, recipient: address, amount0: uint256, amount1: uint256)

Emitted when fees are collected by the owner of a position

名称	类型	已索引	描述
tokenId	uint256	✓
recipient	address
amount0	uint256		The amount of token0 fees collected
amount1	uint256		The amount of token1 fees collected

DecreaseLiquidity(tokenId: uint256, liquidity: uint128, amount0: uint256, amount1: uint256)

Emitted when liquidity is decreased for a position NFT

名称	类型	已索引	描述
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

名称	类型	已索引	描述
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)

名称	类型	已索引
from	address	✓
to	address	✓
tokenId	uint256	✓