@torvainchain/marketplace

High-performance NFT and game asset marketplace SDK for TorvainChain. Build on-chain storefronts, integrate in-game RPG asset trading hubs, manage listing prices, and execute secure purchases.

Features

• Storefront & RPG Trade Hub Actions: Query contract listings, active offers, and historical sales.
• On-Chain Listing: Lock game assets (CW721) in the marketplace vault with fixed TVN price.
• On-Chain Atomic Purchase: Combine bank transfers and CW721 transfers in one unified operation.

Installation

npm install @torvainchain/marketplace

Quick Start

1. Querying Marketplace Items

import { TorvainMarketplaceClient } from '@torvainchain/marketplace';

const marketClient = new TorvainMarketplaceClient('https://rpc.torvainchain.com', 'torv1_marketplace_contract...');

const activeListings = await marketClient.getActiveListings();
console.log(`Listed Items count: ${activeListings.length}`);

2. Listing an NFT for Sale

import { TorvainSigningMarketClient } from '@torvainchain/marketplace';

const signingMarket = await TorvainSigningMarketClient.connect(
  'https://rpc.torvainchain.com',
  signerAddress,
  offlineSigner,
  'torv1_marketplace_contract...'
);

// List Epic Item ID "sword-101" for 25 TVN
const listingTx = await signingMarket.listNft(
  'torv1_game_assets_contract...',
  'sword-101',
  '25000000' // Price in utvn (25 TVN)
);
console.log('Item listed! Tx Hash:', listingTx.transactionHash);

3. Purchasing an Item (Atomic Transaction)

// Buyer purchases listed Epic Item "sword-101"
const buyTx = await signingMarket.purchaseNft(
  'torv1_game_assets_contract...',
  'sword-101',
  '25000000' // utvn cost
);
console.log('Purchase Confirmed! NFT transferred atomically to buyer. Tx Hash:', buyTx.transactionHash);

License

Licensed under the Apache License, Version 2.0.