Tensor NFT Marketplace

List and manage NFTs on Tensor Trade

Interact with Tensor Trade marketplace to list and manage NFTs. This implementation provides functionality for listing NFTs for sale and canceling existing listings.

Core Features

1. Listing Management

   • List NFTs for sale
   • Cancel listings
   • Price setting
   • Ownership verification

2. Token Account

   • Associated token validation
   • Ownership checks
   • Balance verification
   • Account creation

Usage

List NFT for Sale

// List NFT
const signature = await agent.methods.tensorListNFT(
  new PublicKey("nft-mint-address"),
  1.5  // Price in SOL
);

Cancel Listing

// Cancel listing
const signature = await agent.methods.tensorCancelListing(
  new PublicKey("nft-mint-address")
);

Example Prompts

Natural Language Prompts

"List my NFT for 2 SOL on Tensor"

"Cancel my NFT listing on Tensor"

"Put NFT up for sale at 1.5 SOL"

"Remove NFT listing from marketplace"

LangChain Tool Prompts

List NFT

{
  "nftMint": "nft-mint-address",
  "price": 1.5
}

Cancel Listing

{
  "nftMint": "nft-mint-address"
}

Implementation Details

Listing Process

interface ListingParams {
  nftMint: PublicKey;      // NFT mint address
  nftSource: PublicKey;    // Token account
  owner: PublicKey;        // Owner address
  price: BN;              // Price in lamports
  tokenProgram: PublicKey; // Token program ID
  payer: PublicKey;       // Transaction payer
}

// Price conversion
const priceInLamports = new BN(price * 1e9);

Ownership Verification

// Get Associated Token Account
const ata = await getAssociatedTokenAddress(
  nftMint, 
  ownerAddress
);

// Verify ownership
const tokenAccount = await getAccount(
  connection,
  ata
);

if (!tokenAccount || tokenAccount.amount <= 0) {
  throw new Error("NFT not owned");
}

Error Handling

try {
  const tx = await agent.methods.tensorListNFT(mint, price);
} catch (error) {
  if (error.message.includes("NFT not found")) {
    // Handle missing NFT
  } else if (error.message.includes("Invalid mint")) {
    // Handle invalid address
  }
}

Best Practices

1. Listing Management

   • Verify ownership first
   • Check token accounts
   • Validate prices
   • Monitor transactions

2. Token Handling

   • Verify mint addresses
   • Check balances
   • Validate accounts
   • Handle permissions

3. Transaction Processing

   • Build transactions properly
   • Include all signers
   • Handle timeouts
   • Monitor status

Common Issues

1. Listing Issues

   • Invalid mint address
   • NFT not owned
   • Price formatting
   • Account mismatch

2. Cancellation Issues

   • Listing not found
   • Permission denied
   • Network errors
   • Transaction failures

3. Account Issues

   • Missing ATA
   • Zero balance
   • Wrong owner
   • Program mismatch

Response Format

Success Response

{
  status: "success",
  message: "NFT listed successfully",
  transaction: "transaction-signature",
  price: 1.5,
  nftMint: "mint-address"
}

Error Response

{
  status: "error",
  message: "Error message",
  code: "ERROR_CODE"
}

SDK Integration

TensorSwap SDK Setup

const provider = new AnchorProvider(
  connection,
  wallet,
  AnchorProvider.defaultOptions()
);

const tensorSwapSdk = new TensorSwapSDK({ provider });

Transaction Building

// Build transaction
const { tx } = await tensorSwapSdk.list(params);

// Create and send transaction
const transaction = new Transaction();
transaction.add(...tx.ixs);
return await connection.sendTransaction(
  transaction,
  [wallet, ...tx.extraSigners]
);

Advanced Features

1. Custom Token Programs

   • SPL Token support
   • Program validation
   • Account creation
   • Balance management

2. Authorization

   • Auth data handling
   • Permission checks
   • Signature validation
   • Access control

3. Price Management

   • Lamport conversion
   • Price validation
   • Fee calculation
   • Slippage protection

Resources

• Tensor Documentation
• TensorSwap SDK
• SPL Token
• Solana Web3.js