apenft-js-tron 1.0.0

package/README.md

@@ -0,0 +1,1141 @@
+# APENFT SDK
+
+## What is apenft-js-tron?
+"apenft-js-tron" is a SDK for APENFT marketplace base on TRON blockchain and TronLink wallet.
+
+## Table of Contents
+
+- [APENFT SDK](#apenft-sdk)
+  - [What is apenft-js-tron?](#what-is-apenft-js-tron)
+  - [Table of Contents](#table-of-contents)
+  - [Installation](#installation)
+  - [Testnet](#testnet)
+  - [Set Up](#set-up)
+    - [Initialize SDK](#initialize-sdk)
+  - [Asset](#asset)
+    - [Create a Smart Contract](#create-a-smart-contract)
+    - [Mint an NFT](#mint-an-nft)
+    - [Query Assets](#query-assets)
+      - [Query Assets Under an Account](#query-assets-under-an-account)
+      - [Query Collections Under an Account](#query-collections-under-an-account)
+      - [Query NFT details](#query-nft-details)
+  - [Order](#order)
+    - [Create an Order](#create-an-order)
+      - [Fixed Price](#fixed-price)
+      - [Highest Bid](#highest-bid)
+      - [Buy Order](#buy-order)
+      - [Auction Order](#auction-order)
+      - [Lower Price](#lower-price)
+    - [Accept an Order](#accept-an-order)
+      - [Accept and Buy](#accept-and-buy)
+      - [Accept an Offer](#accept-an-offer)
+    - [Cancel an Order](#cancel-an-order)
+      - [Cancel a Listing](#cancel-a-listing)
+      - [Cancel an Offer](#cancel-an-offer)
+    - [Transfer Assets](#transfer-assets)
+    - [Query Orders](#query-orders)
+      - [Query the Listed Prices of an NFT](#query-the-listed-prices-of-an-nft)
+      - [Query the Offer List of an NFT](#query-the-offer-list-of-an-nft)
+      - [Query the Trading History of an NFT](#query-the-trading-history-of-an-nft)
+      - [Query Offers Received](#query-offers-received)
+      - [Query Offers Sent](#query-offers-sent)
+  - [Collection](#collection)
+    - [Query Collections](#query-collections)
+      - [Query the NFT List Under a Collection](#query-the-nft-list-under-a-collection)
+      - [Query a Single Collection](#query-a-single-collection)
+  - [License](#license)
+
+## Installation
+```
+npm install apenft-js-tron
+```
+SDK relies on TronLink wallet for on-chain operations. You also need to install tronweb to run SDK on node.js.
+We recommend switching to Node.js version 16 and above.
+```
+npm install tronweb
+```
+[TronWeb](https://github.com/tronprotocol/tronweb) is a library that allows you to interact with TronNetwork. 
+
+## Testnet
+
+Shasta is the official Tron testnet. To use it use the following endpoint:
+```
+https://api.shasta.trongrid.io
+```
+Get some Shasta TRX at https://www.trongrid.io/shasta and play with it. Anything you do should be explorable on https://shasta.tronscan.org
+
+## Set Up
+
+### Initialize SDK
+
+```js
+import sdk from "apenft-js-tron";
+const { APENFTOrders, APENFTQuery, Network, AssetFactory } = sdk;
+
+/* Initialize tronWeb */
+/* For browser */
+const { tronWeb } = window;
+
+/* For node */
+const tronWeb = new TronWeb({
+  fullHost: "https://api.shasta.trongrid.io",
+  privateKey: "xxxxx-xxxx-xxxxx-xxxxx-xxxxx",
+});
+
+/* Initialize SDK */
+const networkName = Network.Shasta;
+const sdk_orders = new APENFTOrders(tronWeb, { networkName });
+
+const sdk_query = new APENFTQuery(tronWeb, { networkName });
+```
+
+## Asset
+```js
+/* Get asset factory from sdk_orders */
+const sdk_fab = sdk_orders.assetFactory
+
+/* or 
+   new AssetFactory
+*/
+const sdk_fab = new AssetFactory(tronWeb, { networkName })
+
+sdk_fab.createAsset721(...); // create smart contract
+sdk_fab.mint721(...);        // mint NFT
+```
+
+### Create a Smart Contract
+```
+sdk_fab.createAsset721(name,symbol,baseUrl,options)
+```
+
+Instructions:
+```js
+/**
+ * @param {string} name 
+ * @param {string} symbol 
+ * @param {string} baseUrl 
+ * @param {object} [options]  - optional，ref https://developers.tron.network/reference/tronweb-createsmartcontract
+ * @returns {Promise<{txHash,txSend}>} 
+ */
+async createAsset721(name: string, symbol: string, baseUrl: string, options?: any)
+```
+Example:
+```js
+const sdk_fab = ...
+const createRes = await sdk_fab.createAsset721(
+    'MyNFTSymbol',
+    'MyNFTName',
+    ''  // metadata json
+)
+const output = await createRes.txSend.catch((err) => console.log(err))
+
+const nftContract = output.contract_address
+```
+
+### Mint an NFT
+```
+sdk_fab.mint721(nftContract, toAddress,url)
+```
+
+Instructions:
+```js
+/**
+ *
+ * @param {string} assetAddr 
+ * @param {string} to 
+ * @param {string} [url] 
+ * @returns Promise
+ */
+async mint721(assetAddr, to, url)
+```
+Example:
+```js
+const nftContract = ...
+const to = ...
+const url = 'https://gateway.btfs.io/btfs/QmVs42A8YqLffAC75kjQEMxRbzZDdQFKhRiM4agnwNX7u6/BTFS-GenesisNFT-Level-P'
+const defer = await sdk_fab.mint721(nftContract, to, url)
+defer.txSend
+    .on('confirmation', (r) => console.log('confirmation', r))
+    .on('error', (r) => console.log('error', r))
+await defer.txSend
+```
+
+### Query Assets 
+#### Query Assets Under an Account
+```
+APENFTQuery.getAssetsList(account,pagination)
+```
+
+Instructions:
+```js
+/**
+ *
+ * @param {string} account 
+ * * @param {object} pagination 
+ * @returns Promise
+ */
+async APENFTQuery.getAssetsList(account,pagination);
+```
+
+Example:
+```js
+const assetsList = await sdk_query.getAssetsList(
+  "TFrBnJPgZEfXtvauVG9XVLaDEDDo5jtMWV",
+  {
+    first: 100, // min:1 max:100
+    cursor: "",
+  }
+);
+console.log("assetsList", assetsList);
+```
+
+#### Query Collections Under an Account
+```
+APENFTQuery.getCollections(account,pagination)
+```
+
+Instructions:
+```js
+/**
+ *
+ * @param {string} account 
+ * @returns Promise
+ */
+async APENFTQuery.getCollections(account,pagination);
+```
+
+Example:
+```js
+const collectionsList = await sdk_query.getCollections(
+  "TFrBnJPgZEfXtvauVG9XVLaDEDDo5jtMWV",
+  {
+    first: 100, // min:1 max:100
+    cursor: "",
+  }
+);
+console.log("collectionsList", collectionsList);
+```
+
+#### Query NFT details
+```
+APENFTQuery.getAssetDetail(collection,id)
+```
+
+Instructions:
+```js
+/**
+ *
+* @param {string} collection 
+ * @param {string} id 
+ * @returns Promise
+ */
+async APENFTQuery.getAssetDetail(collection,id);
+```
+
+Example:
+```js
+const assetDetail = await sdk_query.getAssetDetail(
+  "TQfujfp9LNU4yRYcAiXcLRmjDuVKQ8U3AJ",
+  "1327"
+);
+console.log("assetDetail", assetDetail);
+```
+
+
+## Order
+### Create an Order
+Initialization:
+```js
+import { APENFTOrders, APENFTQuery, initApprove } from "apenft-js-tron";
+
+let sdk_orders = new APENFTOrders(window.tronWeb, { networkName });
+const sdk_query = new APENFTQuery(window.tronWeb, { networkName });
+```
+- Permission Approval
+NFTs can be traded with the following methods: Fixed Price, Highest Bid, Buy Order, and Auction Order. The wallet address needs to call the approve function when being used for NFT trading for the first time. Every collection needs to be approved only once.
+
+Instructions:
+```js
+/**
+ *
+ * @param {object} APENFTOrders 
+ * @param {string} orderType 
+ * @param {object} orderParams 
+ * @returns Promise
+ */
+async initApprove({ APENFTOrders, orderType, orderParams})
+```
+
+Example:
+```js
+let orderType = "FixPriceOrder";
+let orderParams = {
+  asset: {
+    tokenId: "6",
+    tokenAddress: "TDJLEEDZ5Zr81NQv9jQjWSNtdS9nJyrLD3",
+    schemaName: "ERC721",
+    data: "https://gateway.btfs.io/btfs/QmPXgdwcMFdo2URjHHxvqps8Uz3h8Jvc6zMz1hJFFMwxNX",
+    collection: {
+      transferFeeAddress: "",
+      APENFTSellerFeeBasisPoints: 0,
+    },
+  },
+  quantity: 1,
+  paymentToken: {
+    __typename: "Currency",
+    address: "T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb",
+    symbol: "TRX",
+    decimal: 6,
+    icon: "https://images-testnet.apenft.io/icon/currency/icon-trx.svg",
+    decimals: 6,
+  },
+  listingTime: 1669272864,
+  expirationTime: 1671864854,
+  startAmount: 77,
+  buyerAddress: "",
+};
+await initApprove({ APENFTOrders: sdk_orders, orderType, orderParams });
+```
+
+#### Fixed Price
+Obtain input parameters: 
+```
+APENFTQuery.getFixPriceOrderParams(params)
+```
+Instructions:
+```js
+/**
+ *
+ * @param {object}  params -
+ * {
+ *  collection: string 
+ *  id: string 
+ *  price: number 
+ *  currency: string  
+ *  expirationTime: number // timestamp, milliseconds
+ *  buyerAddress?: string // buyer address, optional
+ * }
+ * @returns Promise
+ */
+async APENFTQuery.getFixPriceOrderParams(params);
+```
+
+Example:
+```js
+const params = {
+  collection: "TQXKjXfTiy9j2qfRXNroZdrrAawu65b72Z",
+  id: "5",
+  price: 20,
+  currency: "USDT",
+  expirationTime: new Date().getTime() + 7 * 24 * 60 * 60 * 1000,
+  buyerAddress: "",
+};
+let orderParams = await sdk_query.getFixPriceOrderParams(params);
+```
+
+```
+APENFTOrders.createSellOrder(orderParams);
+```
+
+Instructions:
+```js
+/**
+ *
+ * @param {object} orderParams
+ * @returns Promise
+ */
+async APENFTOrders.createSellOrder(orderParams);
+```
+
+Example:
+```js
+const params = {
+  collection: "TQXKjXfTiy9j2qfRXNroZdrrAawu65b72Z",
+  id: "5",
+  price: 20,
+  currency: "USDT",
+  expirationTime: new Date().getTime() + 7 * 24 * 60 * 60 * 1000,
+  buyerAddress: "",
+};
+let orderParams = await sdk_query.getFixPriceOrderParams(params);
+
+await sdk_orders.createSellOrder(orderParams);
+```
+
+
+#### Highest Bid
+Obtain input parameters: 
+```
+APENFTQuery.getEnglishAuctionOrderParams(params)
+```
+
+Instructions:
+```js
+/**
+ *
+ * @param {object}  params -
+ * {
+ *  collection: string 
+ *  id: string 
+ *  bidPrice: number 
+ *  reservePrice: number 
+ *  currency: string 
+ *  expirationTime: number // timestamp, milliseconds
+ * }
+ * @returns Promise
+ */
+async APENFTQuery.getEnglishAuctionOrderParams(params);
+```
+
+Example:
+```js
+const params = {
+  collection: "TQXKjXfTiy9j2qfRXNroZdrrAawu65b72Z",
+  id: "5",
+  bidPrice: 20,
+  reservePrice: 100,
+  currency: "USDT",
+  expirationTime: new Date().getTime() + 7 * 24 * 60 * 60 * 1000,
+};
+let orderParams = await sdk_query.getEnglishAuctionOrderParams(params);
+```
+
+```
+APENFTOrders.createAuctionOrder(orderParams);
+```
+Instructions:
+```js
+/**
+ *
+ * @param {object} orderParams
+ * @returns Promise
+ */
+async APENFTOrders.createAuctionOrder(orderParams);
+```
+
+Example:
+```js
+const params = {
+  collection: "TQXKjXfTiy9j2qfRXNroZdrrAawu65b72Z",
+  id: "5",
+  bidPrice: 20,
+  reservePrice: 100,
+  currency: "USDT",
+  expirationTime: new Date().getTime() + 7 * 24 * 60 * 60 * 1000,
+};
+let orderParams = await sdk_query.getEnglishAuctionOrderParams(params);
+
+await sdk_orders.createAuctionOrder(orderParams);
+```
+
+
+#### Buy Order
+Obtain input parameters: 
+```
+APENFTQuery.getMakeOfferOrderOrderParams(params)
+```
+Instructions:
+```js
+/**
+ *
+ * @param {object}  params -
+ * {
+ *  collection: string 
+ *  id: string 
+ *  price: number 
+ *  currency: string 
+ *  expirationTime: number // timestamp, milliseconds
+ * }
+ * @returns Promise
+ */
+async APENFTQuery.getMakeOfferOrderOrderParams(params);
+```
+Example:
+```js
+const params = {
+  collection: "TQFhpAACCPomuW4daSiGTh4SMCvUKtZyNs",
+  id: "105",
+  price: 110,
+  currency: "WTRX",
+  expirationTime: new Date().getTime() + 7 * 24 * 60 * 60 * 1000,
+};
+let orderParams = await sdk_query.getMakeOfferOrderOrderParams(params);
+```
+
+```
+APENFTOrders.createBuyOrder(orderParams)
+```
+Instructions:
+```js
+/**
+ *
+ * @param {object} orderParams 
+ * @returns Promise
+ */
+async APENFTOrders.createBuyOrder(orderParams);
+```
+
+Example:
+```js
+const params = {
+  collection: "TQFhpAACCPomuW4daSiGTh4SMCvUKtZyNs",
+  id: "105",
+  price: 110,
+  currency: "WTRX",
+  expirationTime: new Date().getTime() + 7 * 24 * 60 * 60 * 1000,
+};
+let orderParams = await sdk_query.getMakeOfferOrderOrderParams(params);
+
+await sdk_orders.createBuyOrder(orderParams);
+```
+
+
+#### Auction Order
+Obtain input parameters: 
+```
+APENFTQuery.getEnglishAuctionBiddingOrderParams(params)
+```
+
+Instructions:
+```js
+/**
+ *
+ * @param {object}  params -
+ * {
+ *  collection: string 
+ *  id: string 
+ *  price: number 
+ *  currency: string 
+ * }
+ * @returns Promise
+ */
+async APENFTQuery.getEnglishAuctionBiddingOrderParams(params);
+```
+
+Example:
+```js
+const params = {
+  collection: "TGvAiyw7uT27xVpqHaQ1NM6ZDquEEHQgso",
+  id: "9927",
+  price: 125,
+  currency: "WTRX",
+};
+let orderParams = await sdk_query.getEnglishAuctionBiddingOrderParams(params);
+```
+
+```
+APENFTOrders.createBiddingOrder(orderParams);
+```
+Instructions:
+```js
+/**
+ *
+ * @param {object} orderParams
+ * @returns Promise
+ */
+async APENFTOrders.createBiddingOrder(orderParams);
+```
+Example:
+```js
+const params = {
+  collection: "TGvAiyw7uT27xVpqHaQ1NM6ZDquEEHQgso",
+  id: "9927",
+  price: 125,
+  currency: "WTRX",
+};
+let orderParams = await sdk_query.getEnglishAuctionBiddingOrderParams(params);
+
+await sdk_orders.createBiddingOrder(orderParams);
+```
+
+
+#### Lower Price
+Obtain input parameters: 
+```
+APENFTQuery.getLowerPriceOrderParams(params)
+```
+Instructions:
+```js
+/**
+ *
+ * @param {object}  params -
+ * {
+ *  collection: string
+ *  id: string
+ *  price: number
+ * }
+ * @returns Promise
+ */
+async APENFTQuery.getLowerPriceOrderParams(params);
+```
+Example:
+```js
+const params = {
+  collection: "TL39x7unoU1ivqxac43umyUaFoGzEE2Ens",
+  id: "2",
+  price: 80,
+};
+let orderParams = await sdk_query.getLowerPriceOrderParams(params);
+```
+
+```
+APENFTOrders.createLowerPriceOrder(orderParams)
+```
+Instructions:
+```js
+/**
+ *
+ * @param {object} orderParams 
+ * @returns Promise
+ */
+async APENFTOrders.createLowerPriceOrder(orderParams);
+```
+
+Example:
+```js
+const params = {
+  collection: "TL39x7unoU1ivqxac43umyUaFoGzEE2Ens",
+  id: "2",
+  price: 80,
+};
+let orderParams = await sdk_query.getLowerPriceOrderParams(params);
+
+await sdk_orders.createLowerPriceOrder(orderParams);
+```
+
+
+
+### Accept an Order
+#### Accept and Buy
+Obtain the input parameters of the best ask order：
+```
+APENFTQuery.getAssetBestAskOrderInfo(params)
+```
+Instructions:
+```js
+/**
+ *
+ * @param {string} collection 
+ * @param {string} id 
+ * @returns Promise
+ */
+async APENFTQuery.getAssetBestAskOrderInfo(collection,id);
+```
+
+Example:
+```js
+let bestAskOrder = await sdk_query.getAssetBestAskOrderInfo(
+  "TDczyk1W3jNf62cfeZ5d7CasiVXfwy4xiY",
+  "252"
+);
+```
+
+```
+APENFTOrders.account.orderMatch({ buy, sell })
+```
+Instructions:
+```js
+/**
+ *
+ * @param {object} buyOrder 
+ * @param {object} sellOrder 
+ * @returns Promise
+ */
+async APENFTOrders.account.orderMatch({ buyOrder, sellOrder });
+```
+
+Example:
+```js
+let OrderSide = {
+  0: "Buy",
+  1: "Sell",
+  Buy: 0,
+  Sell: 1,
+};
+let bestAskOrder = await sdk_query.getAssetBestAskOrderInfo(
+  "TDczyk1W3jNf62cfeZ5d7CasiVXfwy4xiY",
+  "252"
+);
+
+const accountAddress = "XXXXXX";
+const signedOrder = sdk_orders.orders.orderFromJSON(bestAskOrder);
+
+let recipientAddress = "";
+if (bestAskOrder.side === OrderSide.Sell) {
+  recipientAddress = accountAddress;
+}
+if (bestAskOrder.side === OrderSide.Buy) {
+  recipientAddress = bestAskOrder.maker;
+}
+
+const { buy, sell } = sdk_orders.orders.makeMatchingOrder({
+  signedOrder,
+  accountAddress: accountAddress,
+  recipientAddress,
+});
+
+await sdk_orders.account.orderMatch({ buy, sell });
+```
+
+
+
+#### Accept an Offer
+Query Offers Received
+```
+APENFTQuery.getReceivedOffers(account,pagination)
+```
+
+Instructions:
+```js
+/**
+ *
+ * @param {string} account 
+ * @param {object} pagination 
+ * @returns Promise
+ */
+async APENFTQuery.getReceivedOffers(account,pagination);
+```
+
+Example:
+```js
+let receivedOffers = await sdk_query.getReceivedOffers(
+  "TFrBnJPgZEfXtvauVG9XVLaDEDDo5jtMWV",
+  {
+    first: 100, // min:1 max:100
+    cursor: "",
+  }
+);
+console.log("receivedOffers", receivedOffers);
+```
+
+```
+APENFTOrders.account.orderMatch({ buy, sell })
+```
+
+Instructions:
+```js
+/**
+ *
+ * @param {object} buyOrder 
+ * @param {object} sellOrder 
+ * @returns Promise
+ */
+async APENFTOrders.account.orderMatch({ buyOrder, sellOrder });
+```
+
+Example:
+```js
+let OrderSide = {
+  0: "Buy",
+  1: "Sell",
+  Buy: 0,
+  Sell: 1,
+};
+// Gets a list of bids received
+const receivedOffers = await sdk_query.getReceivedOffers(
+  "TFrBnJPgZEfXtvauVG9XVLaDEDDo5jtMWV",
+  {
+    first: 100, // min:1 max:100
+    cursor: "",
+  }
+);
+// Choose to accept the NTH bid (a price for an NFT)
+// You can filter an NFT yourself based on the returned data
+const n = 0;
+let bestBidOrder = receivedOffers?.items?.[n]?.bestBidOrder;
+// Current wallet address
+const accountAddress = "XXXXXX";
+const signedOrder = sdk_orders.orders.orderFromJSON(bestBidOrder);
+
+let recipientAddress = "";
+if (bestBidOrder.side === OrderSide.Sell) {
+  recipientAddress = accountAddress;
+}
+if (bestBidOrder.side === OrderSide.Buy) {
+  recipientAddress = bestBidOrder.maker;
+}
+
+const { buy, sell } = sdk_orders.orders.makeMatchingOrder({
+  signedOrder,
+  accountAddress: accountAddress,
+  recipientAddress,
+});
+
+await sdk_orders.account.orderMatch({ buy, sell });
+```
+
+
+### Cancel an Order
+#### Cancel a Listing
+Obtain the input parameters of the best ask order： 
+```
+APENFTQuery.getAssetBestAskOrderInfo(collection,id)
+```
+
+Instructions:
+```js
+/**
+ *
+ * @param {string} collection 
+ * @param {string} id 
+ * @returns Promise
+ */
+async APENFTQuery.getAssetBestAskOrderInfo(collection,id);
+```
+
+Example:
+```js
+const order = await sdk_query.getAssetBestAskOrderInfo(
+  "TL39x7unoU1ivqxac43umyUaFoGzEE2Ens",
+  "2"
+);
+```
+
+```
+APENFTOrders.account.orderCancel(order)
+```
+Instructions:
+```js
+/**
+ *
+ * @param {object} order 
+ * @returns Promise
+ */
+async APENFTOrders.account.orderCancel(order);
+```
+
+Example:
+```js
+const order = await sdk_query.getAssetListingInfo(
+  "TL39x7unoU1ivqxac43umyUaFoGzEE2Ens",
+  "2"
+);
+const _order = sdk_orders.orders.orderFromJSON(order);
+await sdk_orders.account.orderCancel(_order);
+```
+
+
+#### Cancel an Offer
+Query offers sent:
+```
+APENFTQuery.getSentOffers(account,pagination)
+```
+
+Instructions:
+```js
+/**
+ *
+ * @param {string} account 
+ * @param {object} pagination 
+ * @returns Promise
+ */
+async APENFTQuery.getSentOffers(account,pagination);
+```
+
+Example:
+```js
+const sentOffers = await sdk_query.getSentOffers(
+  "TFrBnJPgZEfXtvauVG9XVLaDEDDo5jtMWV",
+  {
+    first: 100, // min:1 max:100
+    cursor: "",
+  }
+);
+console.log("sentOffers", sentOffers);
+```
+
+```
+APENFTOrders.account.orderCancel(order)
+```
+Instructions:
+```js
+/**
+ *
+ * @param {object} order 
+ * @returns Promise
+ */
+async APENFTOrders.account.orderCancel(order);
+```
+
+Example:
+```js
+// Get sent offers
+const sentOffers = await sdk_query.getSentOffers(
+  "TFrBnJPgZEfXtvauVG9XVLaDEDDo5jtMWV",
+  {
+    first: 100, // min:1 max:100
+    cursor: "",
+  }
+);
+console.log("sentOffers", sentOffers);
+
+// Cancel the Nth NFT offer
+const n = 0; 
+let order = sentOffers?.items?.[n];
+const _order = sdk_orders.orders.orderFromJSON(order);
+await sdk_orders.account.orderCancel(_order);
+```
+
+
+### Transfer Assets
+Obtain input parameters： 
+```
+APENFTQuery.getTransferParams(collection,id)
+```
+
+Instructions:
+```js
+/**
+ *
+ * @param {string} collection 
+ * @param {string} id 
+ * @returns Promise
+ */
+async APENFTQuery.getTransferParams(collection,id);
+```
+
+Example:
+```js
+const { metadata, assetData } = await sdk_query.getTransferParams(
+  "TQfujfp9LNU4yRYcAiXcLRmjDuVKQ8U3AJ",
+  "1327"
+);
+```
+
+```
+APENFTOrders.account.assetTransfer(metadata, to)
+```
+
+Instructions:
+```js
+/**
+ *
+ * @param {object} metadata 
+ * @param {string} to 
+ * @returns Promise
+ */
+async APENFTOrders.account.assetTransfer(metadata, to)
+```
+
+Example:
+```js
+const { metadata, assetData } = await sdk_query.getTransferParams(
+  "TQfujfp9LNU4yRYcAiXcLRmjDuVKQ8U3AJ",
+  "1327"
+);
+const { newAsset } = await sdk_orders.getAssetOrderVersion(assetData);
+if (metadata?.asset) {
+  metadata.asset.data = newAsset || "";
+}
+
+let to = "TQzRKbEgp7iSj9fpXX5ghdBHHoh3tEtgwU";
+
+await sdk_orders.account.assetTransfer(metadata, to);
+```
+
+
+
+### Query Orders
+#### Query the Listed Prices of an NFT
+Query the Listed Prices of an NFT:
+```
+APENFTQuery.getAssetListingOrders(collection,id,pagination)
+```
+Instructions:
+```js
+/**
+ *
+ * @param {string} collection 
+ * @param {string} id - id
+ * @param {object} pagination 
+ * @returns Promise
+ */
+async APENFTQuery.getAssetListingOrders(collection,id,pagination);
+```
+
+Example:
+```js
+const listingData = await sdk_query.getAssetListingOrders(
+  "TQfujfp9LNU4yRYcAiXcLRmjDuVKQ8U3AJ",
+  "1327",
+  {
+    first: 100, // min:1 max:100
+    cursor: "",
+  }
+);
+console.log("listingData", listingData);
+```
+
+
+#### Query the Offer List of an NFT
+```
+APENFTQuery.getAssetOffers(collection,id,pagination)
+```
+Instructions:
+```js
+/**
+ *
+ * @param {string} collection 
+ * @param {string} id - id
+ * @param {object} pagination 
+ * @returns Promise
+ */
+async APENFTQuery.getAssetOffers(collection,id,pagination);
+```
+
+Example:
+```js
+const offersData = await sdk_query.getAssetOffers(
+  "TQfujfp9LNU4yRYcAiXcLRmjDuVKQ8U3AJ",
+  "1327",
+  {
+    first: 100, // min:1 max:100
+    cursor: "",
+  }
+);
+console.log("offersData", offerData);
+```
+
+
+#### Query the Trading History of an NFT
+```
+APENFTQuery.getAssetTradingHistory(collection,id,pagination)
+```
+
+Instructions:
+```js
+/**
+ *
+ * @param {string} collection 
+ * @param {string} id - id
+ * @param {object} pagination 
+ * @returns Promise
+ */
+async APENFTQuery.getAssetTradingHistory(collection,id,pagination);
+```
+
+Example:
+```js
+const assetTradingHistory = await sdk_query.getAssetTradingHistory(
+  "TQfujfp9LNU4yRYcAiXcLRmjDuVKQ8U3AJ",
+  "1327",
+  {
+    first: 100, // min:1 max:100
+    cursor: "",
+  }
+);
+console.log("assetTradingHistory", assetTradingHistory);
+```
+
+#### Query Offers Received
+```
+APENFTQuery.getReceivedOffers(account,pagination)
+```
+Instructions:
+```js
+/**
+ *
+ * @param {string} account 
+ * @param {object} pagination 
+ * @returns Promise
+ */
+async APENFTQuery.getReceivedOffers(account,pagination);
+```
+
+Example:
+```js
+const receivedOffers = await sdk_query.getReceivedOffers(
+  "TFrBnJPgZEfXtvauVG9XVLaDEDDo5jtMWV",
+  {
+    first: 100, // min:1 max:100
+    cursor: "",
+  }
+);
+console.log("receivedOffers", receivedOffers);
+```
+
+
+#### Query Offers Sent
+```
+APENFTQuery.getSentOffers(account,pagination)
+```
+Instructions:
+```js
+/**
+ *
+ * @param {string} account 
+ * * @param {object} pagination 
+ * @returns Promise
+ */
+async APENFTQuery.getSentOffers(account,pagination);
+```
+Example:
+```js
+const sentOffers = await sdk_query.getSentOffers(
+  "TFrBnJPgZEfXtvauVG9XVLaDEDDo5jtMWV",
+  {
+    first: 100, // min:1 max:100
+    cursor: "",
+  }
+);
+console.log("sentOffers", sentOffers);
+```
+
+
+## Collection
+### Query Collections
+#### Query the NFT List Under a Collection
+```
+APENFTQuery.getCollectionAssetsList(collection,pagination)
+```
+
+Instructions:
+```js
+/**
+ *
+ * @param {string} collection 
+ * @param {object} pagination 
+ * @returns Promise
+ */
+async APENFTQuery.getCollectionAssetsList(collection,pagination);
+```
+
+Example:
+```js
+const collectionAssetsList = await sdk_query.getCollectionAssetsList(
+  "TQfujfp9LNU4yRYcAiXcLRmjDuVKQ8U3AJ",
+  {
+    first: 100, // min:1 max:100
+    cursor: "",
+  }
+);
+console.log("collectionAssetsList", collectionAssetsList);
+```
+
+####  Query a Single Collection
+```
+APENFTQuery.getSingleCollectionInfo(collection)
+```
+Instructions:
+```js
+/**
+ *
+ * @param {string} collection 
+ * @returns Promise
+ */
+async APENFTQuery.getSingleCollectionInfo(collection);
+```
+Example:
+```js
+const singleCollectionInfo = await sdk_query.getSingleCollectionInfo(
+  "TQfujfp9LNU4yRYcAiXcLRmjDuVKQ8U3AJ"
+);
+console.log("singleCollectionInfo", singleCollectionInfo);
+```
+
+
+
+
+
+## License
+[MIT]()