@quantabit/nft-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,162 @@
+# @quantabit/nft-sdk
+
+> QuantaBit NFT SDK - NFT minting, transferring, display, and digital collectible management
+
+## ✨ Features
+
+- 🎨 **NFT Marketplace** - Browse, buy, and sell NFTs
+- ⛏️ **Minting** - Create and mint new NFTs
+- 🏷️ **Rarity System** - Common, Rare, Epic, Legendary classifications
+- 🔨 **Auctions** - Timed auction with bidding support
+- ❤️ **Favorites** - NFT wishlist and collection management
+- 🌍 **Multi-Language** - Built-in Chinese/English translations
+
+## 📦 Installation
+
+```bash
+npm install @quantabit/nft-sdk
+# or
+yarn add @quantabit/nft-sdk
+```
+
+## 🚀 Quick Start
+
+### 1. Using Components
+
+```jsx
+import {
+  NftMarketplace,
+  NftGrid,
+  NftCard,
+  NftDetail,
+  MyNftsPage,
+  AuctionCard,
+} from '@quantabit/nft-sdk';
+
+// Full NFT marketplace
+<NftMarketplace />
+
+// NFT grid
+<NftGrid
+  columns={4}
+  onNftClick={(nft) => viewDetail(nft)}
+  showFilters
+/>
+
+// NFT card
+<NftCard
+  nft={nftData}
+  onBuy={(nft) => handleBuy(nft)}
+  showRarity
+/>
+
+// NFT detail page
+<NftDetail nftId="nft_123" onBuy={() => handleBuy()} />
+
+// My NFTs page
+<MyNftsPage onNftClick={(nft) => viewDetail(nft)} />
+
+// Auction card
+<AuctionCard
+  auction={auctionData}
+  onBid={(amount) => handleBid(amount)}
+  showCountdown
+/>
+```
+
+### 2. Using Hooks
+
+```jsx
+import {
+  useNfts,
+  useNftDetail,
+  useMyNfts,
+  useFavoriteNfts,
+  useBuyNft,
+  useMintNft,
+  useNftAuction,
+} from "@quantabit/nft-sdk";
+
+function MyComponent() {
+  const { nfts, loading, loadNfts, filters } = useNfts();
+  const { nft, loadDetail } = useNftDetail("nft_123");
+  const { myNfts, loadMyNfts } = useMyNfts();
+  const { favorites, toggleFavorite } = useFavoriteNfts();
+  const { buyNft, buying } = useBuyNft();
+  const { mintNft, minting } = useMintNft();
+  const { auction, placeBid, bids } = useNftAuction("auction_123");
+
+  return <div>...</div>;
+}
+```
+
+### 3. API Client
+
+```javascript
+import { nftApi } from "@quantabit/nft-sdk";
+
+// Browse NFTs
+const nfts = await nftApi.getNfts({ page: 1, limit: 20 });
+
+// Get NFT detail
+const nft = await nftApi.getNftDetail("nft_123");
+
+// Get my NFTs
+const myNfts = await nftApi.getMyNfts();
+
+// Buy NFT
+await nftApi.buyNft("nft_123");
+
+// Mint new NFT
+await nftApi.mintNft({
+  name: "My NFT",
+  description: "A unique digital collectible",
+  image: imageFile,
+  rarity: "epic",
+});
+```
+
+## 📚 Components
+
+| Component        | Description                                       |
+| ---------------- | ------------------------------------------------- |
+| `NftMarketplace` | Complete NFT marketplace with browsing and search |
+| `NftGrid`        | NFT grid layout with filters and pagination       |
+| `NftCard`        | Single NFT card with image, rarity, and price     |
+| `NftDetail`      | NFT detail page with attributes and history       |
+| `MyNftsPage`     | User's NFT collection page                        |
+| `AuctionCard`    | Auction card with countdown and bid history       |
+
+## 📖 Type Definitions
+
+```javascript
+import { NftRarity, NftStatus } from "@quantabit/nft-sdk";
+
+// NFT rarity
+NftRarity.COMMON; // Common
+NftRarity.RARE; // Rare
+NftRarity.EPIC; // Epic
+NftRarity.LEGENDARY; // Legendary
+
+// NFT status
+NftStatus.MINTED; // Minted
+NftStatus.LISTED; // Listed for sale
+NftStatus.SOLD; // Sold
+NftStatus.TRANSFERRED; // Transferred
+NftStatus.BURNED; // Burned
+```
+
+## 📄 License
+
+MIT License
+
+
+
+---
+
+## 🌐 Brand & Links
+- Official Mainnet: [QuantaBit Chain](https://qbitchain.io/)
+- Developer Platform: [Developer Platform](https://developer.quantabit.io/)
+- Open Platform: [Open Platform](https://open.quantabit.io/)
+- Payment Platform: [Pay Platform](https://pay.qbitwallet.io/)
+- Feedback: [Feedback](https://xwin.live/qbit)