Actions10
List NFT
AI-generatedOverview
This node operation allows users to list an NFT for sale on the PaintSwap NFT marketplace. It supports specifying the NFT contract address, token ID, listing price in ETH, quantity, and duration of the listing. Additional options include search keywords, whether to retrieve the marketplace ID after listing, and advanced listing options such as using a vault for escrow, auction settings, anti-snipe protection, flash auction, NSFW marking, donation settings, and custom listing fees. Users can also choose the wallet source for the transaction, provide a private key, configure gas settings, and manage transaction retries and nonce settings.
Use Case Examples
- A user wants to list their NFT on PaintSwap with a specific price and duration, optionally enabling auction features and donation settings.
- A seller needs to list multiple NFTs with custom listing fees and advanced auction protections.
- A user prefers to input a private key directly for the listing transaction instead of using the credential wallet.
Properties
| Name | Meaning |
|---|---|
| NFT Address | The address of the NFT contract to list the token from. |
| Token ID | The ID of the token to list on the marketplace. |
| Price (ETH) | The listing price in ETH for the NFT. |
| Quantity | Quantity of NFTs to list, usually 1 for ERC721 tokens. |
| Duration (Seconds) | Duration of the listing in seconds, defaulting to approximately 7 days. |
| Search Keywords | Keywords to help find the listing; if empty, the Token ID is used. |
| Retrieve Marketplace ID | Whether to retrieve the marketplace ID after listing, which may cause a delay. |
| Advanced Options | Additional listing options including vault usage, auction settings, anti-snipe protection, flash auction, NSFW marking, donation address and percentage, and custom listing fee. |
| Wallet Source | Choose which wallet to use for the transaction: credential wallet or input private key. |
| Private Key | The private key to use for this specific transaction, required if wallet source is custom key. |
| Gas Settings | How gas settings should be determined: auto estimated or manual. |
| Gas Limit | Gas limit for the transaction, used if gas settings are manual. |
| Max Fee Per Gas (Gwei) | Maximum fee per gas in Gwei, used if gas settings are manual. |
| Max Priority Fee Per Gas (Gwei) | Maximum priority fee per gas in Gwei, used if gas settings are manual. |
| No Execution, Estimate Gas Only | If enabled, only estimates gas required for the transaction without executing it. |
| Transaction Management | Settings for transaction management including manual nonce, max retry attempts, and replacement fee boost percentage. |
Output
JSON
json- The JSON output contains the result of the listing operation, including details such as transaction status, marketplace ID if retrieved, and any relevant metadata returned by the PaintSwap marketplace API.
Dependencies
- PaintSwap NFT marketplace API
- Ethereum JSON RPC provider
- Ethers.js library for blockchain interaction
Troubleshooting
- Common issues include invalid NFT address or token ID, insufficient funds for gas fees, incorrect private key or wallet source selection, and network connectivity problems.
- Error messages may indicate unsupported operations, transaction failures, or gas estimation errors. Users should verify input parameters, wallet credentials, and network settings.
- If the marketplace ID retrieval causes delays, users can disable this option to speed up the listing process.
Links
- PaintSwap Official Website - Official site for the PaintSwap NFT marketplace.
- Ethers.js Documentation - Documentation for the Ethers.js library used for Ethereum blockchain interactions.