@quantabit/market-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,125 @@
+# @quantabit/market-sdk
+
+> QuantaBit Market SDK - Product listing, auction, matching, and trading
+
+## 📦 Installation
+
+```bash
+npm install @quantabit/market-sdk
+# or
+yarn add @quantabit/market-sdk
+```
+
+## 🚀 Quick Start
+
+### 1. Setup Provider
+
+```jsx
+import { MarketProvider } from "@quantabit/market-sdk";
+import "@quantabit/market-sdk/styles.css";
+
+function App() {
+  return (
+    <MarketProvider
+      apiUrl="https://api.example.com/v1"
+      token="your-auth-token"
+      language="en"
+      onPurchase={(result) => console.log("Purchase successful:", result)}
+      onBid={(result) => console.log("Bid placed:", result)}
+    >
+      <YourComponent />
+    </MarketProvider>
+  );
+}
+```
+
+### 2. Using Components
+
+```jsx
+import { ListingCard } from "@quantabit/market-sdk";
+
+// Market listing card
+<ListingCard
+  listing={listingData}
+  onBuy={(result) => console.log("Purchase:", result)}
+  onBid={(listing) => openBidModal(listing)}
+  onClick={(listing) => navigateToDetail(listing.id)}
+/>;
+```
+
+### 3. Using Hooks
+
+```jsx
+import { useMarket } from "@quantabit/market-sdk";
+
+function MyComponent() {
+  const {
+    listings, // Market listings
+    myListings, // My listings
+    myPurchases, // My purchases
+    loading,
+    loadListings, // Load market
+    buy, // Buy
+    placeBid, // Place bid
+  } = useMarket();
+
+  return <div>...</div>;
+}
+```
+
+## 📚 Components
+
+| Component     | Description                                                    |
+| ------------- | -------------------------------------------------------------- |
+| `ListingCard` | Market listing card (image, price, auction countdown, actions) |
+
+## 📖 Type Definitions
+
+```javascript
+import { ListingType, ListingStatus, ItemType } from "@quantabit/market-sdk";
+
+// Listing types
+ListingType.FIXED; // Fixed price
+ListingType.AUCTION; // Auction
+ListingType.OFFER; // Make an offer
+
+// Item types
+ItemType.NFT; // NFT
+ItemType.TOKEN; // Token
+ItemType.GOODS; // Physical goods
+ItemType.DIGITAL; // Digital goods
+```
+
+## 🧮 Utility Functions
+
+```javascript
+import {
+  formatPrice,
+  isAuctionEnded,
+  getTimeRemaining,
+} from "@quantabit/market-sdk";
+
+// Format price
+formatPrice(1.5, "ETH"); // Ξ1.5
+
+// Check if auction has ended
+const ended = isAuctionEnded(listing);
+
+// Get remaining time
+const { days, hours, minutes, seconds } = getTimeRemaining(listing.end_at);
+```
+
+## 📄 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)