PaintSwap icon

PaintSwap

Interact with PaintSwap NFT marketplace

Actions10

Buy NFT

AI-generated

Overview

This node operation allows users to buy an NFT from the PaintSwap marketplace. It supports specifying the marketplace listing ID, quantity, and optionally fetching NFT details before purchase. Users can choose the wallet source (credential wallet or custom private key) and configure gas settings, including manual gas limits and fees. It also supports transaction management features like manual nonce, retry attempts, and fee boosts. This operation is useful for automating NFT purchases on PaintSwap within workflows, such as buying specific NFTs programmatically or integrating NFT purchases into larger automation processes.

Use Case Examples

  1. Automatically purchase a specific NFT listing by providing the marketplace ID and quantity.
  2. Buy an NFT using a custom private key for a one-time transaction without storing the key in credentials.
  3. Estimate gas costs for buying an NFT without executing the transaction to optimize fees.

Properties

Name Meaning
Marketplace ID The ID of the marketplace listing to buy, used to identify the specific NFT listing to purchase.
Quantity Quantity of NFTs to purchase, usually 1 for ERC721 tokens.
Get NFT Details First Whether to retrieve NFT details from the marketplace before purchase, recommended for accuracy.
Provide Manual Parameters on Failure Whether to use manual parameters if automatic listing lookup fails, allowing fallback to manual input.
NFT Address The address of the NFT contract, required if not fetching details automatically.
Token ID The ID of the token being purchased, required if not fetching details automatically.
Price (ETH) The price to pay in ETH for the NFT, required if not fetching details automatically.
Wallet Source Choose which wallet to use for this transaction: credential wallet or input private key.
Private Key The private key to use for this specific transaction, required if using custom key wallet source.
Gas Settings How gas settings should be determined: auto estimated or manual.
Gas Limit Gas limit for the transaction, used if manual gas settings are selected.
Max Fee Per Gas (Gwei) Maximum fee per gas in Gwei, used if manual gas settings are selected.
Max Priority Fee Per Gas (Gwei) Maximum priority fee per gas in Gwei, used if manual gas settings are selected.
No Execution, Estimate Gas Only When enabled, only estimates gas required for the transaction without executing it.
Transaction Management Settings for managing the transaction such as manual nonce, max retry attempts, and replacement fee boost percentage.

Output

JSON

  • json - The JSON output contains the result of the buy NFT operation, including transaction details or error messages if the operation fails.

Dependencies

  • Requires an Ethereum RPC URL and private key credentials for wallet access and transaction signing.

Troubleshooting

  • If the automatic NFT details lookup fails and manual parameters are not provided, the purchase will fail. Enable 'Provide Manual Parameters on Failure' to avoid this.
  • Incorrect private key format or missing '0x' prefix can cause wallet initialization errors. Ensure the private key is correctly formatted.
  • Gas settings misconfiguration can lead to failed transactions or excessive fees. Use auto gas estimation or carefully set manual gas parameters.
  • Network or RPC provider issues can cause transaction failures or timeouts. Verify RPC URL and network connectivity.

Links

Discussion