@quantabit/order-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,138 @@
+# @quantabit/order-sdk
+
+> QuantaBit Order SDK - Order creation, management, and status flow
+
+## 📦 Installation
+
+```bash
+npm install @quantabit/order-sdk
+# or
+yarn add @quantabit/order-sdk
+```
+
+## 🚀 Quick Start
+
+### 1. Setup Provider
+
+```jsx
+import { OrderProvider } from "@quantabit/order-sdk";
+import "@quantabit/order-sdk/styles.css";
+
+function App() {
+  return (
+    <OrderProvider
+      apiUrl="https://api.example.com/v1"
+      token="your-auth-token"
+      language="en"
+      onOrderPay={(result) => console.log("Payment:", result)}
+    >
+      <YourComponent />
+    </OrderProvider>
+  );
+}
+```
+
+### 2. Using Components
+
+```jsx
+import { OrderCard, OrderList } from '@quantabit/order-sdk';
+
+// Order card
+<OrderCard
+  order={orderData}
+  onPay={(order) => handlePay(order)}
+  onDetail={(order) => navigateToDetail(order.id)}
+/>
+
+// Order list
+<OrderList
+  showFilter
+  onPay={(order) => handlePay(order)}
+  onDetail={(order) => navigateToDetail(order.id)}
+/>
+```
+
+### 3. Using Hooks
+
+```jsx
+import { useOrder } from "@quantabit/order-sdk";
+
+function MyComponent() {
+  const {
+    orders, // Order list
+    currentOrder, // Current order details
+    stats, // Order statistics
+    loading,
+    createOrder, // Create order
+    loadOrders, // Load order list
+    cancelOrder, // Cancel order
+    payOrder, // Pay order
+    confirmReceive, // Confirm receipt
+  } = useOrder();
+
+  return <div>...</div>;
+}
+```
+
+## 📚 Components
+
+| Component   | Description                                        |
+| ----------- | -------------------------------------------------- |
+| `OrderCard` | Order card (product list, amount, status, actions) |
+| `OrderList` | Order list (status filtering, pagination)          |
+
+## 📖 Type Definitions
+
+```javascript
+import { OrderStatus, OrderType, PaymentMethod } from "@quantabit/order-sdk";
+
+// Order status
+OrderStatus.PENDING; // Pending payment
+OrderStatus.PAID; // Paid
+OrderStatus.PROCESSING; // Processing
+OrderStatus.SHIPPED; // Shipped
+OrderStatus.COMPLETED; // Completed
+OrderStatus.CANCELLED; // Cancelled
+
+// Order types
+OrderType.GOODS; // Physical goods
+OrderType.SERVICE; // Service
+OrderType.VIRTUAL; // Virtual goods
+OrderType.SUBSCRIPTION; // Subscription
+```
+
+## 🧮 Utility Functions
+
+```javascript
+import {
+  canPay,
+  canCancel,
+  formatPrice,
+  getPaymentRemaining,
+} from "@quantabit/order-sdk";
+
+// Check if order can be paid/cancelled
+const payable = canPay(order);
+const cancelable = canCancel(order);
+
+// Format price
+formatPrice(99.9, "CNY"); // ¥99.90
+
+// Calculate payment remaining time
+const remaining = getPaymentRemaining(order.expire_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)