Snip721Tx..::..BatchTransferNft Method
BatchTransferNft is used to perform multiple token transfers. The message sender may specify a list of tokens to transfer to one recipient address
in each Transfer object, and any memo provided will be applied to every token transferred in that one Transfer object.
The message sender may provide multiple Transfer objects to perform transfers to multiple addresses, providing a different memo for each address if desired.
Each individual transfer of a token will show separately in transaction histories. The message sender must have permission
to transfer all the tokens listed (either by being the owner or being granted transfer approval) and every listed token_id must be valid.
A contract may use the VerifyTransferApproval query to verify that it has permission to transfer all the tokens.
If the message sender does not have permission to transfer any one of the listed tokens, the entire message will fail(no tokens will be transferred)
and the error will provide the ID of the first token encountered in which the sender does not have the required permission.
If any token transfer involves a recipient address that is the same as its current owner, the contract will throw an error.
Any token that is transferred to a new owner will have its single-token approvals cleared.
This implementation will throw an error if trying to transfer a SNIP-722 non-transferable token.
Namespace:
SecretNET.NFTAssembly: SecretNET.NFT (in SecretNET.NFT.dll)
Syntax
public Task<SingleSecretTx<BatchTransferNftResponse>> BatchTransferNft( MsgBatchTransferNft msg, Nullable<TxOptions> txOptions )
Public Function BatchTransferNft ( _ msg As MsgBatchTransferNft, _ txOptions As Nullable(Of TxOptions) _ ) As Task(Of SingleSecretTx(Of BatchTransferNftResponse))
public: Task<SingleSecretTx<BatchTransferNftResponse^>^>^ BatchTransferNft( MsgBatchTransferNft^ msg, Nullable<TxOptions^> txOptions )
Parameters
- msg
- Type: SecretNET.NFT..::..MsgBatchTransferNft
The MSG.
- txOptions
- Type: Nullable<(Of <(<'TxOptions>)>)>
The tx options.