@quantabit/nft-marketplace-sdk 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 QuantaBit Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,39 @@
+# @quantabit/nft-marketplace-sdk
+
+QuantaBit NFT Marketplace SDK offers simplified program wrappers, listing managers, royalty distribution utilities, and bidding state engines for non-fungible tokens on the QuantaBit network.
+
+## Features
+
+- **NFT Listings**: List NFT tokens for sale specifying prices, reserve limits, and custom payout currencies.
+- **Bidding and Auctioning**: Submit bids for active auctions with reserve validation.
+- **Royalty Tracking**: Automatically calculate creator royalty share payments.
+- **React state sync hooks**: Hooks to fetch, listen, and update market listing lists.
+- **Multilingual dictionary**: Built-in support for localized notifications in EN, ZH, JA, and KO.
+
+## Installation
+
+```bash
+npm install @quantabit/nft-marketplace-sdk @quantabit/sdk-config
+```
+
+## Quick Start
+
+```javascript
+import { listNFT, buyNFT, calculateRoyalty } from '@quantabit/nft-marketplace-sdk';
+
+// List NFT for sale
+const listing = await listNFT('mint_address_xxx', 500, 'QBT');
+
+// Buy listed NFT
+const purchase = await buyNFT(listing.listingId, 'buyer_wallet_address');
+
+// Calculate creator royalties
+const royalty = calculateRoyalty(500, 5.0); // 5% royalty on 500 QBT
+```
+
+## Brand & Links
+
+- **Official Website**: [https://quantabit.io](https://quantabit.io)
+- **Documentation**: [https://docs.quantabit.io](https://docs.quantabit.io)
+- **Explorer**: [https://explorer.mg.qbitchain.io](https://explorer.mg.qbitchain.io)
+- **Source Code**: [https://github.com/quantabit-chain/qbit-sdk](https://github.com/quantabit-chain/qbit-sdk)

package/dist/index.cjs

@@ -0,0 +1,170 @@
+'use strict';
+
+var react = require('react');
+var sdkConfig = require('@quantabit/sdk-config');
+
+const messages = {
+  en: {
+    list_success: "NFT listed successfully for sale",
+    buy_success: "NFT purchased successfully",
+    bid_success: "Bid submitted successfully",
+    cancel_success: "Listing cancelled successfully",
+    invalid_price: "Invalid price set for listing",
+    below_reserve_price: "Bid price is below reserve price"
+  },
+  zh: {
+    list_success: "NFT已成功挂单出售",
+    buy_success: "NFT已成功购买",
+    bid_success: "出价已成功提交",
+    cancel_success: "挂单已成功取消",
+    invalid_price: "设置的挂单价格无效",
+    below_reserve_price: "出价低于保留价"
+  },
+  ja: {
+    list_success: "NFTが販売用に正常に出品されました",
+    buy_success: "NFTの購入に成功しました",
+    bid_success: "入札が正常に送信されました",
+    cancel_success: "出品が正常にキャンセルされました",
+    invalid_price: "出品に設定された価格が無効です",
+    below_reserve_price: "入札価格が最低落札価格を下回っています"
+  },
+  ko: {
+    list_success: "NFT가 판매 등록 완료되었습니다",
+    buy_success: "NFT 구매 완료",
+    bid_success: "입찰이 성공적으로 완료되었습니다",
+    cancel_success: "판매 등록 취소 완료",
+    invalid_price: "잘못된 등록 가격입니다",
+    below_reserve_price: "입찰가가 최저 낙찰가보다 낮습니다"
+  }
+};
+let currentLang = null;
+function getLanguage() {
+  return currentLang || sdkConfig.getLanguage() || 'en';
+}
+function setLanguage(lang) {
+  if (messages[lang]) {
+    currentLang = lang;
+  }
+}
+function t(key) {
+  const lang = getLanguage();
+  return messages[lang]?.[key] || messages['en']?.[key] || key;
+}
+
+// 模拟市场活跃挂单
+const LISTINGS = {
+  "list_001": {
+    id: "list_001",
+    mintAddress: "mint_qbit_nft_99",
+    seller: "seller_wallet_a",
+    price: 450,
+    currency: "QBT",
+    reservePrice: 400,
+    royaltyPercent: 5.0,
+    status: "active"
+  },
+  "list_002": {
+    id: "list_002",
+    mintAddress: "mint_qbit_nft_102",
+    seller: "seller_wallet_b",
+    price: 1200,
+    currency: "USDT",
+    reservePrice: 1000,
+    royaltyPercent: 2.5,
+    status: "active"
+  }
+};
+async function listNFT(mintAddress, price, currency = "QBT") {
+  if (price <= 0) {
+    throw new Error(t('invalid_price'));
+  }
+  const listingId = `list_${Math.random().toString(36).substr(2, 9)}`;
+  return {
+    listingId,
+    mintAddress,
+    price,
+    currency,
+    status: "active",
+    message: t('list_success')
+  };
+}
+async function buyNFT(listingId, buyerAddress) {
+  const listing = LISTINGS[listingId];
+  if (!listing) {
+    throw new Error("Listing not found");
+  }
+  const royaltyAmount = calculateRoyalty(listing.price, listing.royaltyPercent);
+  return {
+    txHash: `buy_tx_${Math.random().toString(36).substr(2, 9)}`,
+    listingId,
+    buyerAddress,
+    pricePaid: listing.price,
+    royaltyPaid: royaltyAmount,
+    status: "success",
+    message: t('buy_success')
+  };
+}
+async function placeBid(listingId, bidAmount, bidderAddress) {
+  const listing = LISTINGS[listingId];
+  if (!listing) {
+    throw new Error("Listing not found");
+  }
+  if (bidAmount < listing.reservePrice) {
+    throw new Error(t('below_reserve_price'));
+  }
+  return {
+    txHash: `bid_tx_${Math.random().toString(36).substr(2, 9)}`,
+    listingId,
+    bidderAddress,
+    bidAmount,
+    status: "confirmed",
+    message: t('bid_success')
+  };
+}
+async function cancelListing(listingId) {
+  const listing = LISTINGS[listingId];
+  if (!listing) {
+    throw new Error("Listing not found");
+  }
+  return {
+    txHash: `cancel_tx_${Math.random().toString(36).substr(2, 9)}`,
+    listingId,
+    status: "cancelled",
+    message: t('cancel_success')
+  };
+}
+function calculateRoyalty(price, royaltyPercent) {
+  const amount = price * (royaltyPercent / 100);
+  return parseFloat(amount.toFixed(4));
+}
+function useNftListings() {
+  const [listings, setListings] = react.useState([]);
+  const [loading, setLoading] = react.useState(true);
+  react.useEffect(() => {
+    setLoading(true);
+    const timer = setTimeout(() => {
+      setListings(Object.values(LISTINGS));
+      setLoading(false);
+    }, 400);
+    return () => clearTimeout(timer);
+  }, []);
+  return {
+    listings,
+    loading
+  };
+}
+const SUPPORTED_LANGUAGES = ['en', 'zh', 'ja', 'ko'];
+
+exports.LISTINGS = LISTINGS;
+exports.SUPPORTED_LANGUAGES = SUPPORTED_LANGUAGES;
+exports.buyNFT = buyNFT;
+exports.calculateRoyalty = calculateRoyalty;
+exports.cancelListing = cancelListing;
+exports.getLanguage = getLanguage;
+exports.listNFT = listNFT;
+exports.messages = messages;
+exports.placeBid = placeBid;
+exports.setLanguage = setLanguage;
+exports.t = t;
+exports.useNftListings = useNftListings;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../src/i18n/index.js","../src/index.js"],"sourcesContent":["import { getLanguage as getGlobalLang } from '@quantabit/sdk-config';\n\nexport const messages = {\n  en: {\n    list_success: \"NFT listed successfully for sale\",\n    buy_success: \"NFT purchased successfully\",\n    bid_success: \"Bid submitted successfully\",\n    cancel_success: \"Listing cancelled successfully\",\n    invalid_price: \"Invalid price set for listing\",\n    below_reserve_price: \"Bid price is below reserve price\"\n  },\n  zh: {\n    list_success: \"NFT已成功挂单出售\",\n    buy_success: \"NFT已成功购买\",\n    bid_success: \"出价已成功提交\",\n    cancel_success: \"挂单已成功取消\",\n    invalid_price: \"设置的挂单价格无效\",\n    below_reserve_price: \"出价低于保留价\"\n  },\n  ja: {\n    list_success: \"NFTが販売用に正常に出品されました\",\n    buy_success: \"NFTの購入に成功しました\",\n    bid_success: \"入札が正常に送信されました\",\n    cancel_success: \"出品が正常にキャンセルされました\",\n    invalid_price: \"出品に設定された価格が無効です\",\n    below_reserve_price: \"入札価格が最低落札価格を下回っています\"\n  },\n  ko: {\n    list_success: \"NFT가 판매 등록 완료되었습니다\",\n    buy_success: \"NFT 구매 완료\",\n    bid_success: \"입찰이 성공적으로 완료되었습니다\",\n    cancel_success: \"판매 등록 취소 완료\",\n    invalid_price: \"잘못된 등록 가격입니다\",\n    below_reserve_price: \"입찰가가 최저 낙찰가보다 낮습니다\"\n  }\n};\n\nlet currentLang = null;\n\nexport function getLanguage() {\n  return currentLang || getGlobalLang() || 'en';\n}\n\nexport function setLanguage(lang) {\n  if (messages[lang]) {\n    currentLang = lang;\n  }\n}\n\nexport function t(key) {\n  const lang = getLanguage();\n  return messages[lang]?.[key] || messages['en']?.[key] || key;\n}\n","import { useState, useEffect } from 'react';\nimport { getConfig } from '@quantabit/sdk-config';\nimport { t, setLanguage, getLanguage, messages } from './i18n/index.js';\n\n// 模拟市场活跃挂单\nconst LISTINGS = {\n  \"list_001\": {\n    id: \"list_001\",\n    mintAddress: \"mint_qbit_nft_99\",\n    seller: \"seller_wallet_a\",\n    price: 450,\n    currency: \"QBT\",\n    reservePrice: 400,\n    royaltyPercent: 5.0,\n    status: \"active\"\n  },\n  \"list_002\": {\n    id: \"list_002\",\n    mintAddress: \"mint_qbit_nft_102\",\n    seller: \"seller_wallet_b\",\n    price: 1200,\n    currency: \"USDT\",\n    reservePrice: 1000,\n    royaltyPercent: 2.5,\n    status: \"active\"\n  }\n};\n\nexport async function listNFT(mintAddress, price, currency = \"QBT\") {\n  if (price <= 0) {\n    throw new Error(t('invalid_price'));\n  }\n  \n  const listingId = `list_${Math.random().toString(36).substr(2, 9)}`;\n  \n  return {\n    listingId,\n    mintAddress,\n    price,\n    currency,\n    status: \"active\",\n    message: t('list_success')\n  };\n}\n\nexport async function buyNFT(listingId, buyerAddress) {\n  const listing = LISTINGS[listingId];\n  if (!listing) {\n    throw new Error(\"Listing not found\");\n  }\n  \n  const royaltyAmount = calculateRoyalty(listing.price, listing.royaltyPercent);\n  \n  return {\n    txHash: `buy_tx_${Math.random().toString(36).substr(2, 9)}`,\n    listingId,\n    buyerAddress,\n    pricePaid: listing.price,\n    royaltyPaid: royaltyAmount,\n    status: \"success\",\n    message: t('buy_success')\n  };\n}\n\nexport async function placeBid(listingId, bidAmount, bidderAddress) {\n  const listing = LISTINGS[listingId];\n  if (!listing) {\n    throw new Error(\"Listing not found\");\n  }\n  \n  if (bidAmount < listing.reservePrice) {\n    throw new Error(t('below_reserve_price'));\n  }\n  \n  return {\n    txHash: `bid_tx_${Math.random().toString(36).substr(2, 9)}`,\n    listingId,\n    bidderAddress,\n    bidAmount,\n    status: \"confirmed\",\n    message: t('bid_success')\n  };\n}\n\nexport async function cancelListing(listingId) {\n  const listing = LISTINGS[listingId];\n  if (!listing) {\n    throw new Error(\"Listing not found\");\n  }\n  \n  return {\n    txHash: `cancel_tx_${Math.random().toString(36).substr(2, 9)}`,\n    listingId,\n    status: \"cancelled\",\n    message: t('cancel_success')\n  };\n}\n\nexport function calculateRoyalty(price, royaltyPercent) {\n  const amount = price * (royaltyPercent / 100);\n  return parseFloat(amount.toFixed(4));\n}\n\nexport function useNftListings() {\n  const [listings, setListings] = useState([]);\n  const [loading, setLoading] = useState(true);\n\n  useEffect(() => {\n    setLoading(true);\n    const timer = setTimeout(() => {\n      setListings(Object.values(LISTINGS));\n      setLoading(false);\n    }, 400);\n\n    return () => clearTimeout(timer);\n  }, []);\n\n  return { listings, loading };\n}\n\nexport { t, setLanguage, getLanguage, messages };\nexport const SUPPORTED_LANGUAGES = ['en', 'zh', 'ja', 'ko'];\nexport { LISTINGS };\n"],"names":["messages","en","list_success","buy_success","bid_success","cancel_success","invalid_price","below_reserve_price","zh","ja","ko","currentLang","getLanguage","getGlobalLang","setLanguage","lang","t","key","LISTINGS","id","mintAddress","seller","price","currency","reservePrice","royaltyPercent","status","listNFT","Error","listingId","Math","random","toString","substr","message","buyNFT","buyerAddress","listing","royaltyAmount","calculateRoyalty","txHash","pricePaid","royaltyPaid","placeBid","bidAmount","bidderAddress","cancelListing","amount","parseFloat","toFixed","useNftListings","listings","setListings","useState","loading","setLoading","useEffect","timer","setTimeout","Object","values","clearTimeout","SUPPORTED_LANGUAGES"],"mappings":"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"}

package/dist/index.esm.js

@@ -0,0 +1,157 @@
+import { useState, useEffect } from 'react';
+import { getLanguage as getLanguage$1 } from '@quantabit/sdk-config';
+
+const messages = {
+  en: {
+    list_success: "NFT listed successfully for sale",
+    buy_success: "NFT purchased successfully",
+    bid_success: "Bid submitted successfully",
+    cancel_success: "Listing cancelled successfully",
+    invalid_price: "Invalid price set for listing",
+    below_reserve_price: "Bid price is below reserve price"
+  },
+  zh: {
+    list_success: "NFT已成功挂单出售",
+    buy_success: "NFT已成功购买",
+    bid_success: "出价已成功提交",
+    cancel_success: "挂单已成功取消",
+    invalid_price: "设置的挂单价格无效",
+    below_reserve_price: "出价低于保留价"
+  },
+  ja: {
+    list_success: "NFTが販売用に正常に出品されました",
+    buy_success: "NFTの購入に成功しました",
+    bid_success: "入札が正常に送信されました",
+    cancel_success: "出品が正常にキャンセルされました",
+    invalid_price: "出品に設定された価格が無効です",
+    below_reserve_price: "入札価格が最低落札価格を下回っています"
+  },
+  ko: {
+    list_success: "NFT가 판매 등록 완료되었습니다",
+    buy_success: "NFT 구매 완료",
+    bid_success: "입찰이 성공적으로 완료되었습니다",
+    cancel_success: "판매 등록 취소 완료",
+    invalid_price: "잘못된 등록 가격입니다",
+    below_reserve_price: "입찰가가 최저 낙찰가보다 낮습니다"
+  }
+};
+let currentLang = null;
+function getLanguage() {
+  return currentLang || getLanguage$1() || 'en';
+}
+function setLanguage(lang) {
+  if (messages[lang]) {
+    currentLang = lang;
+  }
+}
+function t(key) {
+  const lang = getLanguage();
+  return messages[lang]?.[key] || messages['en']?.[key] || key;
+}
+
+// 模拟市场活跃挂单
+const LISTINGS = {
+  "list_001": {
+    id: "list_001",
+    mintAddress: "mint_qbit_nft_99",
+    seller: "seller_wallet_a",
+    price: 450,
+    currency: "QBT",
+    reservePrice: 400,
+    royaltyPercent: 5.0,
+    status: "active"
+  },
+  "list_002": {
+    id: "list_002",
+    mintAddress: "mint_qbit_nft_102",
+    seller: "seller_wallet_b",
+    price: 1200,
+    currency: "USDT",
+    reservePrice: 1000,
+    royaltyPercent: 2.5,
+    status: "active"
+  }
+};
+async function listNFT(mintAddress, price, currency = "QBT") {
+  if (price <= 0) {
+    throw new Error(t('invalid_price'));
+  }
+  const listingId = `list_${Math.random().toString(36).substr(2, 9)}`;
+  return {
+    listingId,
+    mintAddress,
+    price,
+    currency,
+    status: "active",
+    message: t('list_success')
+  };
+}
+async function buyNFT(listingId, buyerAddress) {
+  const listing = LISTINGS[listingId];
+  if (!listing) {
+    throw new Error("Listing not found");
+  }
+  const royaltyAmount = calculateRoyalty(listing.price, listing.royaltyPercent);
+  return {
+    txHash: `buy_tx_${Math.random().toString(36).substr(2, 9)}`,
+    listingId,
+    buyerAddress,
+    pricePaid: listing.price,
+    royaltyPaid: royaltyAmount,
+    status: "success",
+    message: t('buy_success')
+  };
+}
+async function placeBid(listingId, bidAmount, bidderAddress) {
+  const listing = LISTINGS[listingId];
+  if (!listing) {
+    throw new Error("Listing not found");
+  }
+  if (bidAmount < listing.reservePrice) {
+    throw new Error(t('below_reserve_price'));
+  }
+  return {
+    txHash: `bid_tx_${Math.random().toString(36).substr(2, 9)}`,
+    listingId,
+    bidderAddress,
+    bidAmount,
+    status: "confirmed",
+    message: t('bid_success')
+  };
+}
+async function cancelListing(listingId) {
+  const listing = LISTINGS[listingId];
+  if (!listing) {
+    throw new Error("Listing not found");
+  }
+  return {
+    txHash: `cancel_tx_${Math.random().toString(36).substr(2, 9)}`,
+    listingId,
+    status: "cancelled",
+    message: t('cancel_success')
+  };
+}
+function calculateRoyalty(price, royaltyPercent) {
+  const amount = price * (royaltyPercent / 100);
+  return parseFloat(amount.toFixed(4));
+}
+function useNftListings() {
+  const [listings, setListings] = useState([]);
+  const [loading, setLoading] = useState(true);
+  useEffect(() => {
+    setLoading(true);
+    const timer = setTimeout(() => {
+      setListings(Object.values(LISTINGS));
+      setLoading(false);
+    }, 400);
+    return () => clearTimeout(timer);
+  }, []);
+  return {
+    listings,
+    loading
+  };
+}
+const SUPPORTED_LANGUAGES = ['en', 'zh', 'ja', 'ko'];
+
+export { LISTINGS, SUPPORTED_LANGUAGES, buyNFT, calculateRoyalty, cancelListing, getLanguage, listNFT, messages, placeBid, setLanguage, t, useNftListings };
+//# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":["../src/i18n/index.js","../src/index.js"],"sourcesContent":["import { getLanguage as getGlobalLang } from '@quantabit/sdk-config';\n\nexport const messages = {\n  en: {\n    list_success: \"NFT listed successfully for sale\",\n    buy_success: \"NFT purchased successfully\",\n    bid_success: \"Bid submitted successfully\",\n    cancel_success: \"Listing cancelled successfully\",\n    invalid_price: \"Invalid price set for listing\",\n    below_reserve_price: \"Bid price is below reserve price\"\n  },\n  zh: {\n    list_success: \"NFT已成功挂单出售\",\n    buy_success: \"NFT已成功购买\",\n    bid_success: \"出价已成功提交\",\n    cancel_success: \"挂单已成功取消\",\n    invalid_price: \"设置的挂单价格无效\",\n    below_reserve_price: \"出价低于保留价\"\n  },\n  ja: {\n    list_success: \"NFTが販売用に正常に出品されました\",\n    buy_success: \"NFTの購入に成功しました\",\n    bid_success: \"入札が正常に送信されました\",\n    cancel_success: \"出品が正常にキャンセルされました\",\n    invalid_price: \"出品に設定された価格が無効です\",\n    below_reserve_price: \"入札価格が最低落札価格を下回っています\"\n  },\n  ko: {\n    list_success: \"NFT가 판매 등록 완료되었습니다\",\n    buy_success: \"NFT 구매 완료\",\n    bid_success: \"입찰이 성공적으로 완료되었습니다\",\n    cancel_success: \"판매 등록 취소 완료\",\n    invalid_price: \"잘못된 등록 가격입니다\",\n    below_reserve_price: \"입찰가가 최저 낙찰가보다 낮습니다\"\n  }\n};\n\nlet currentLang = null;\n\nexport function getLanguage() {\n  return currentLang || getGlobalLang() || 'en';\n}\n\nexport function setLanguage(lang) {\n  if (messages[lang]) {\n    currentLang = lang;\n  }\n}\n\nexport function t(key) {\n  const lang = getLanguage();\n  return messages[lang]?.[key] || messages['en']?.[key] || key;\n}\n","import { useState, useEffect } from 'react';\nimport { getConfig } from '@quantabit/sdk-config';\nimport { t, setLanguage, getLanguage, messages } from './i18n/index.js';\n\n// 模拟市场活跃挂单\nconst LISTINGS = {\n  \"list_001\": {\n    id: \"list_001\",\n    mintAddress: \"mint_qbit_nft_99\",\n    seller: \"seller_wallet_a\",\n    price: 450,\n    currency: \"QBT\",\n    reservePrice: 400,\n    royaltyPercent: 5.0,\n    status: \"active\"\n  },\n  \"list_002\": {\n    id: \"list_002\",\n    mintAddress: \"mint_qbit_nft_102\",\n    seller: \"seller_wallet_b\",\n    price: 1200,\n    currency: \"USDT\",\n    reservePrice: 1000,\n    royaltyPercent: 2.5,\n    status: \"active\"\n  }\n};\n\nexport async function listNFT(mintAddress, price, currency = \"QBT\") {\n  if (price <= 0) {\n    throw new Error(t('invalid_price'));\n  }\n  \n  const listingId = `list_${Math.random().toString(36).substr(2, 9)}`;\n  \n  return {\n    listingId,\n    mintAddress,\n    price,\n    currency,\n    status: \"active\",\n    message: t('list_success')\n  };\n}\n\nexport async function buyNFT(listingId, buyerAddress) {\n  const listing = LISTINGS[listingId];\n  if (!listing) {\n    throw new Error(\"Listing not found\");\n  }\n  \n  const royaltyAmount = calculateRoyalty(listing.price, listing.royaltyPercent);\n  \n  return {\n    txHash: `buy_tx_${Math.random().toString(36).substr(2, 9)}`,\n    listingId,\n    buyerAddress,\n    pricePaid: listing.price,\n    royaltyPaid: royaltyAmount,\n    status: \"success\",\n    message: t('buy_success')\n  };\n}\n\nexport async function placeBid(listingId, bidAmount, bidderAddress) {\n  const listing = LISTINGS[listingId];\n  if (!listing) {\n    throw new Error(\"Listing not found\");\n  }\n  \n  if (bidAmount < listing.reservePrice) {\n    throw new Error(t('below_reserve_price'));\n  }\n  \n  return {\n    txHash: `bid_tx_${Math.random().toString(36).substr(2, 9)}`,\n    listingId,\n    bidderAddress,\n    bidAmount,\n    status: \"confirmed\",\n    message: t('bid_success')\n  };\n}\n\nexport async function cancelListing(listingId) {\n  const listing = LISTINGS[listingId];\n  if (!listing) {\n    throw new Error(\"Listing not found\");\n  }\n  \n  return {\n    txHash: `cancel_tx_${Math.random().toString(36).substr(2, 9)}`,\n    listingId,\n    status: \"cancelled\",\n    message: t('cancel_success')\n  };\n}\n\nexport function calculateRoyalty(price, royaltyPercent) {\n  const amount = price * (royaltyPercent / 100);\n  return parseFloat(amount.toFixed(4));\n}\n\nexport function useNftListings() {\n  const [listings, setListings] = useState([]);\n  const [loading, setLoading] = useState(true);\n\n  useEffect(() => {\n    setLoading(true);\n    const timer = setTimeout(() => {\n      setListings(Object.values(LISTINGS));\n      setLoading(false);\n    }, 400);\n\n    return () => clearTimeout(timer);\n  }, []);\n\n  return { listings, loading };\n}\n\nexport { t, setLanguage, getLanguage, messages };\nexport const SUPPORTED_LANGUAGES = ['en', 'zh', 'ja', 'ko'];\nexport { LISTINGS };\n"],"names":["messages","en","list_success","buy_success","bid_success","cancel_success","invalid_price","below_reserve_price","zh","ja","ko","currentLang","getLanguage","getGlobalLang","setLanguage","lang","t","key","LISTINGS","id","mintAddress","seller","price","currency","reservePrice","royaltyPercent","status","listNFT","Error","listingId","Math","random","toString","substr","message","buyNFT","buyerAddress","listing","royaltyAmount","calculateRoyalty","txHash","pricePaid","royaltyPaid","placeBid","bidAmount","bidderAddress","cancelListing","amount","parseFloat","toFixed","useNftListings","listings","setListings","useState","loading","setLoading","useEffect","timer","setTimeout","Object","values","clearTimeout","SUPPORTED_LANGUAGES"],"mappings":"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"}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@quantabit/nft-marketplace-sdk",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "QuantaBit NFT Marketplace SDK - Listing, bidding, auctioning and royalty distributions for non-fungible assets",
+  "main": "dist/index.cjs",
+  "module": "dist/index.esm.js",
+  "types": "types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./types/index.d.ts",
+      "import": "./dist/index.esm.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "sideEffects": [
+    "*.css"
+  ],
+  "files": [
+    "dist",
+    "types",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "rollup -c",
+    "dev": "rollup -c -w",
+    "test": "jest --passWithNoTests",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/quantabit-chain/qbit-sdk.git",
+    "directory": "packages/nft-marketplace-sdk"
+  },
+  "keywords": [
+    "nft",
+    "marketplace",
+    "auction",
+    "bidding",
+    "royalty",
+    "web3",
+    "react",
+    "quantabit"
+  ],
+  "author": "QuantaBit Team",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "peerDependencies": {
+    "react": ">=17.0.0",
+    "react-dom": ">=17.0.0"
+  },
+  "dependencies": {
+    "@quantabit/sdk-config": "^1.0.10"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "qbit": {
+    "privacy": {
+      "level": "functional",
+      "dataCollection": "Fetches active NFT listings and bids. Stored anonymously on chain.",
+      "gdprCompliant": true,
+      "ccpaCompliant": true
+    }
+  },
+  "homepage": "https://github.com/quantabit-chain/qbit-sdk/tree/main/packages/nft-marketplace-sdk#readme",
+  "bugs": {
+    "url": "https://github.com/quantabit-chain/qbit-sdk/issues"
+  }
+}

package/types/index.d.ts

@@ -0,0 +1,62 @@
+export interface NFTListing {
+  id: string;
+  mintAddress: string;
+  seller: string;
+  price: number;
+  currency: string;
+  reservePrice: number;
+  royaltyPercent: number;
+  status: string;
+}
+
+export interface ListingResult {
+  listingId: string;
+  mintAddress: string;
+  price: number;
+  currency: string;
+  status: string;
+  message: string;
+}
+
+export interface PurchaseResult {
+  txHash: string;
+  listingId: string;
+  buyerAddress: string;
+  pricePaid: number;
+  royaltyPaid: number;
+  status: string;
+  message: string;
+}
+
+export interface BidResult {
+  txHash: string;
+  listingId: string;
+  bidderAddress: string;
+  bidAmount: number;
+  status: string;
+  message: string;
+}
+
+export interface CancellationResult {
+  txHash: string;
+  listingId: string;
+  status: string;
+  message: string;
+}
+
+export function listNFT(mintAddress: string, price: number, currency?: string): Promise<ListingResult>;
+export function buyNFT(listingId: string, buyerAddress: string): Promise<PurchaseResult>;
+export function placeBid(listingId: string, bidAmount: number, bidderAddress: string): Promise<BidResult>;
+export function cancelListing(listingId: string): Promise<CancellationResult>;
+export function calculateRoyalty(price: number, royaltyPercent: number): number;
+
+export function useNftListings(): {
+  listings: NFTListing[];
+  loading: boolean;
+};
+
+export function getLanguage(): string;
+export function setLanguage(lang: string): void;
+export function t(key: string): string;
+export const SUPPORTED_LANGUAGES: string[];
+export const messages: Record<string, Record<string, string>>;