@basedone/core 0.1.10 → 0.2.1

package/dist/react.mjs

@@ -0,0 +1,31 @@
+import { InstrumentClient } from './chunk-VBC6EQ7Q.mjs';
+import './chunk-4UEJOM6W.mjs';
+import { createContext, useMemo, useContext } from 'react';
+import { jsx } from 'react/jsx-runtime';
+
+var InstrumentContext = createContext(null);
+function InstrumentsProvider({
+  spotMeta,
+  allPerpsMeta,
+  children
+}) {
+  const client = useMemo(
+    () => new InstrumentClient(spotMeta, allPerpsMeta).init(),
+    [spotMeta, allPerpsMeta]
+  );
+  return /* @__PURE__ */ jsx(InstrumentContext.Provider, { value: client, children });
+}
+function useInstruments() {
+  const client = useContext(InstrumentContext);
+  if (!client) {
+    throw new Error(
+      "useInstruments must be used within an InstrumentsProvider"
+    );
+  }
+  return client;
+}
+function useInstrumentsOptional() {
+  return useContext(InstrumentContext);
+}
+
+export { InstrumentsProvider, useInstruments, useInstrumentsOptional };

package/dist/{spotMeta-OD7S6HGW.mjs → spotMeta-GHXX7C5M.mjs}

@@ -1,4 +1,4 @@
-import "./chunk-4UEJOM6W.mjs";
+import './chunk-4UEJOM6W.mjs';
 
 // lib/meta/data/mainnet/spotMeta.json
 var universe = [
@@ -2179,6 +2179,15 @@ var universe = [
     name: "@257",
     index: 257,
     isCanonical: false
+  },
+  {
+    tokens: [
+      398,
+      0
+    ],
+    name: "@258",
+    index: 258,
+    isCanonical: false
   }
 ];
 var tokens = [
@@ -2189,7 +2198,10 @@ var tokens = [
     index: 0,
     tokenId: "0x6d1e7cde53ba9467b783cb7c530ce054",
     isCanonical: true,
-    evmContract: null,
+    evmContract: {
+      address: "0x6b9e773128f453f5c2c60935ee2de2cbc5390a24",
+      evm_extra_wei_decimals: -2
+    },
     fullName: null,
     deployerTradingFeeShare: "0.0"
   },
@@ -6683,7 +6695,10 @@ var tokens = [
     index: 381,
     tokenId: "0xbd6af8c18f3e56d2da95a3c81d18e814",
     isCanonical: false,
-    evmContract: null,
+    evmContract: {
+      address: "0x99603f5cb890faca5cc5495ccc74391cdffa28bc",
+      evm_extra_wei_decimals: 10
+    },
     fullName: "Funnel BNB",
     deployerTradingFeeShare: "1.0"
   },
@@ -6882,7 +6897,10 @@ var tokens = [
     index: 398,
     tokenId: "0xec43194f64d555bdaef5afb5b6c6c686",
     isCanonical: false,
-    evmContract: null,
+    evmContract: {
+      address: "0xa51dc81944a15623874981181a99d6c56b20ed56",
+      evm_extra_wei_decimals: 11
+    },
     fullName: "Stable",
     deployerTradingFeeShare: "1.0"
   },
@@ -6946,8 +6964,5 @@ var spotMeta_default = {
   universe,
   tokens
 };
-export {
-  spotMeta_default as default,
-  tokens,
-  universe
-};
+
+export { spotMeta_default as default, tokens, universe };

package/dist/{spotMeta-PCN4Z4R3.mjs → spotMeta-IBBUP2SG.mjs}

@@ -1,4 +1,4 @@
-import "./chunk-4UEJOM6W.mjs";
+import './chunk-4UEJOM6W.mjs';
 
 // lib/meta/data/testnet/spotMeta.json
 var universe = [
@@ -10648,6 +10648,24 @@ var universe = [
     name: "@1378",
     index: 1378,
     isCanonical: false
+  },
+  {
+    tokens: [
+      1498,
+      0
+    ],
+    name: "@1379",
+    index: 1379,
+    isCanonical: false
+  },
+  {
+    tokens: [
+      1498,
+      1452
+    ],
+    name: "@1380",
+    index: 1380,
+    isCanonical: false
   }
 ];
 var tokens = [
@@ -27531,14 +27549,44 @@ aa	aaa\\aaaaaa"aaaa'aaaaa{}`,
     evmContract: null,
     fullName: "$WASH launchpad 2025-12-02T20:17:18.214Z",
     deployerTradingFeeShare: "1.0"
+  },
+  {
+    name: "RNSZPK",
+    szDecimals: 0,
+    weiDecimals: 10,
+    index: 1496,
+    tokenId: "0x699de51e4fc0e6d7a6e450d2c3d92a1a",
+    isCanonical: false,
+    evmContract: null,
+    fullName: "$WASH launchpad 2025-12-04T03:17:21.132Z",
+    deployerTradingFeeShare: "1.0"
+  },
+  {
+    name: "VENAHX",
+    szDecimals: 1,
+    weiDecimals: 9,
+    index: 1497,
+    tokenId: "0x43513901b952fcb6d8d5697ce17fa58f",
+    isCanonical: false,
+    evmContract: null,
+    fullName: "$WASH launchpad 2025-12-05T10:17:24.096Z",
+    deployerTradingFeeShare: "1.0"
+  },
+  {
+    name: "LMB",
+    szDecimals: 2,
+    weiDecimals: 8,
+    index: 1498,
+    tokenId: "0x9f416264220c915ec41b6c4c0b11fab1",
+    isCanonical: false,
+    evmContract: null,
+    fullName: "LMB",
+    deployerTradingFeeShare: "1.0"
   }
 ];
 var spotMeta_default = {
   universe,
   tokens
 };
-export {
-  spotMeta_default as default,
-  tokens,
-  universe
-};
+
+export { spotMeta_default as default, tokens, universe };

package/dist/staticMeta-GM7T3OYL.mjs

@@ -1,4 +1,4 @@
-import "./chunk-4UEJOM6W.mjs";
+import './chunk-4UEJOM6W.mjs';
 
 // lib/meta/data/testnet/staticMeta.json
 var coins = {
@@ -16,8 +16,5 @@ var staticMeta_default = {
   coins,
   dexs
 };
-export {
-  coins,
-  staticMeta_default as default,
-  dexs
-};
+
+export { coins, staticMeta_default as default, dexs };

package/dist/staticMeta-QV2KMX57.mjs

@@ -1,4 +1,4 @@
-import "./chunk-4UEJOM6W.mjs";
+import './chunk-4UEJOM6W.mjs';
 
 // lib/meta/data/mainnet/staticMeta.json
 var coins = {
@@ -18,8 +18,5 @@ var staticMeta_default = {
   coins,
   dexs
 };
-export {
-  coins,
-  staticMeta_default as default,
-  dexs
-};
+
+export { coins, staticMeta_default as default, dexs };

package/ecommerce.ts

@@ -0,0 +1,15 @@
+/**
+ * Ecommerce SDK Entry Point
+ * 
+ * This file provides a separate entry point for the ecommerce SDK,
+ * allowing users to import only ecommerce functionality without
+ * pulling in the entire @basedone/core package.
+ * 
+ * @example
+ * ```typescript
+ * import { CustomerEcommerceClient } from "@basedone/core/ecommerce";
+ * ```
+ */
+
+export * from "./lib/ecommerce";
+

package/index.ts

@@ -4,5 +4,11 @@ export * from "./lib/pup";
 export * from "./lib/constants/tokens";
 export * from "./lib/meta/metadata";
 export * from "./lib/utils/formatter";
+export * from "./lib/utils/flooredDateTime";
+export * from "./lib/utils/time";
 export * from "./lib/hip3/utils";
 export * from "./lib/hip3/market-info";
+export * from "./lib/instrument/client";
+
+// Ecommerce SDK
+export * from "./lib/ecommerce";

package/lib/ecommerce/FLASH_SALES.md

@@ -0,0 +1,340 @@
+# Flash Sales SDK Documentation
+
+This guide shows you how to use the `@basedone/core/ecommerce` SDK to fetch and display active flash sales.
+
+## Overview
+
+Flash sales are time-limited deals with discounted products. The SDK provides a simple method to fetch all currently active flash sales with their products, pricing, and countdown information.
+
+## Installation
+
+```typescript
+import { CustomerEcommerceClient } from "@basedone/core/ecommerce";
+```
+
+## Basic Usage
+
+### Initialize the Client
+
+```typescript
+const client = new CustomerEcommerceClient({
+  baseURL: "https://your-api-domain.com",
+  authToken: "your-auth-token", // Optional for public endpoints
+});
+```
+
+### Fetch Active Flash Sales
+
+```typescript
+// Get all active flash sales
+const result = await client.getActiveFlashSales();
+
+console.log(`Found ${result.flashSales.length} active flash sales`);
+
+// Access the first flash sale
+const featuredSale = result.flashSales[0];
+console.log(`Sale: ${featuredSale.name}`);
+console.log(`Ends at: ${featuredSale.endsAt}`);
+
+// Access countdown timer info
+if (result.timeRemaining) {
+  console.log(`Time remaining: ${result.timeRemaining.remainingSeconds} seconds`);
+}
+```
+
+### With Parameters
+
+```typescript
+// Limit the number of flash sales returned
+const result = await client.getActiveFlashSales({
+  limit: 5, // Maximum 50
+});
+
+// Filter by merchant (optional)
+const result = await client.getActiveFlashSales({
+  limit: 10,
+  merchantId: "merchant_123",
+});
+```
+
+## Response Structure
+
+### ActiveFlashSalesResponse
+
+```typescript
+{
+  flashSales: FlashSale[];        // Array of active flash sales
+  timeRemaining: {                 // Countdown info for featured sale
+    endsAt: string;                // ISO timestamp
+    remainingSeconds: number;       // Seconds until end
+  } | null;
+  serverTime: string;              // Server timestamp for sync
+}
+```
+
+### FlashSale
+
+```typescript
+{
+  id: string;                      // Flash sale ID
+  name: string;                    // Sale name (e.g., "Summer Flash Sale")
+  description?: string;            // Optional description
+  startsAt: string;                // ISO timestamp
+  endsAt: string;                  // ISO timestamp
+  badgeText?: string;              // Badge text (e.g., "Mall")
+  badgeColor?: string;            // Badge color hex (e.g., "#facc15")
+  priority: number;               // Display priority (higher = first)
+  merchant?: {                     // Merchant info (null for admin sales)
+    id: string;
+    name: string;
+  } | null;
+  items: FlashSaleItem[];         // Products in this sale
+}
+```
+
+### FlashSaleItem
+
+```typescript
+{
+  id: string;                      // Item ID
+  productId: string;               // Product ID
+  salePrice: string;               // Sale price in USDC (e.g., "17.90")
+  originalPrice: string;          // Original price in USDC (e.g., "30.00")
+  discountPercent: number;         // Discount percentage (e.g., 42)
+  maxQuantity: number | null;      // Max available (null = unlimited)
+  soldQuantity: number;             // Already sold count
+  remainingQuantity: number | null; // Remaining (null if unlimited)
+  limitPerCustomer: number | null;  // Max per customer
+  product: {                       // Full product details
+    id: string;
+    title: string;
+    description?: string;
+    images: string[];
+    priceUSDC: string;
+    inventory: number | null;
+    soldCount: number;
+    averageRating: number | null;
+    reviewCount: number;
+    merchant?: {
+      id: string;
+      name: string;
+    };
+  };
+}
+```
+
+## Example: Display Flash Sales
+
+```typescript
+import { CustomerEcommerceClient } from "@basedone/core/ecommerce";
+
+const client = new CustomerEcommerceClient({
+  baseURL: "https://api.example.com",
+});
+
+async function displayFlashSales() {
+  try {
+    const result = await client.getActiveFlashSales({ limit: 10 });
+
+    if (result.flashSales.length === 0) {
+      console.log("No active flash sales");
+      return;
+    }
+
+    // Display each flash sale
+    result.flashSales.forEach((sale) => {
+      console.log(`\n⚡ ${sale.name}`);
+      console.log(`   Badge: ${sale.badgeText || "Flash Deal"}`);
+      console.log(`   Ends: ${new Date(sale.endsAt).toLocaleString()}`);
+      console.log(`   Products: ${sale.items.length}`);
+
+      // Display products
+      sale.items.forEach((item) => {
+        console.log(`   - ${item.product.title}`);
+        console.log(`     Original: $${item.originalPrice} → Sale: $${item.salePrice}`);
+        console.log(`     Discount: ${item.discountPercent}% off`);
+        
+        if (item.remainingQuantity !== null) {
+          console.log(`     Only ${item.remainingQuantity} left!`);
+        }
+      });
+    });
+
+    // Display countdown
+    if (result.timeRemaining) {
+      const hours = Math.floor(result.timeRemaining.remainingSeconds / 3600);
+      const minutes = Math.floor((result.timeRemaining.remainingSeconds % 3600) / 60);
+      const seconds = result.timeRemaining.remainingSeconds % 60;
+      console.log(`\n⏰ Time remaining: ${hours}h ${minutes}m ${seconds}s`);
+    }
+  } catch (error) {
+    console.error("Error fetching flash sales:", error);
+  }
+}
+
+displayFlashSales();
+```
+
+## Example: React Component
+
+```typescript
+import { useState, useEffect } from "react";
+import { CustomerEcommerceClient, ActiveFlashSalesResponse } from "@basedone/core/ecommerce";
+
+function FlashSalesList() {
+  const [flashSales, setFlashSales] = useState<ActiveFlashSalesResponse | null>(null);
+  const [loading, setLoading] = useState(true);
+
+  useEffect(() => {
+    const client = new CustomerEcommerceClient({
+      baseURL: process.env.NEXT_PUBLIC_API_URL || "",
+    });
+
+    client
+      .getActiveFlashSales({ limit: 10 })
+      .then((data) => {
+        setFlashSales(data);
+        setLoading(false);
+      })
+      .catch((error) => {
+        console.error("Failed to load flash sales:", error);
+        setLoading(false);
+      });
+  }, []);
+
+  if (loading) return <div>Loading flash sales...</div>;
+  if (!flashSales || flashSales.flashSales.length === 0) {
+    return <div>No active flash sales</div>;
+  }
+
+  return (
+    <div>
+      {flashSales.flashSales.map((sale) => (
+        <div key={sale.id} className="flash-sale-card">
+          <h2>{sale.name}</h2>
+          {sale.badgeText && (
+            <span style={{ backgroundColor: sale.badgeColor || "#f97316" }}>
+              {sale.badgeText}
+            </span>
+          )}
+          <p>Ends: {new Date(sale.endsAt).toLocaleString()}</p>
+          
+          <div className="products">
+            {sale.items.map((item) => (
+              <div key={item.id} className="product-card">
+                <img src={item.product.images[0]} alt={item.product.title} />
+                <h3>{item.product.title}</h3>
+                <div className="pricing">
+                  <span className="original-price">${item.originalPrice}</span>
+                  <span className="sale-price">${item.salePrice}</span>
+                  <span className="discount">-{item.discountPercent}%</span>
+                </div>
+                {item.remainingQuantity !== null && item.remainingQuantity <= 10 && (
+                  <div className="scarcity">Only {item.remainingQuantity} left!</div>
+                )}
+              </div>
+            ))}
+          </div>
+        </div>
+      ))}
+    </div>
+  );
+}
+```
+
+## Example: Countdown Timer
+
+```typescript
+import { useState, useEffect } from "react";
+import { CustomerEcommerceClient } from "@basedone/core/ecommerce";
+
+function CountdownTimer() {
+  const [timeLeft, setTimeLeft] = useState({ hours: 0, minutes: 0, seconds: 0 });
+  const [serverTime, setServerTime] = useState<Date | null>(null);
+
+  useEffect(() => {
+    const client = new CustomerEcommerceClient({
+      baseURL: process.env.NEXT_PUBLIC_API_URL || "",
+    });
+
+    // Fetch flash sales and sync with server time
+    client.getActiveFlashSales().then((result) => {
+      if (result.timeRemaining) {
+        const serverTimeDate = new Date(result.serverTime);
+        setServerTime(serverTimeDate);
+        
+        // Calculate offset for accurate countdown
+        const offset = serverTimeDate.getTime() - Date.now();
+        const endTime = new Date(result.timeRemaining.endsAt).getTime();
+
+        const updateTimer = () => {
+          const now = Date.now() + offset;
+          const remaining = Math.max(0, endTime - now);
+          
+          setTimeLeft({
+            hours: Math.floor(remaining / (1000 * 60 * 60)),
+            minutes: Math.floor((remaining % (1000 * 60 * 60)) / (1000 * 60)),
+            seconds: Math.floor((remaining % (1000 * 60)) / 1000),
+          });
+        };
+
+        updateTimer();
+        const interval = setInterval(updateTimer, 1000);
+        return () => clearInterval(interval);
+      }
+    });
+  }, []);
+
+  return (
+    <div className="countdown">
+      {timeLeft.hours.toString().padStart(2, "0")}:
+      {timeLeft.minutes.toString().padStart(2, "0")}:
+      {timeLeft.seconds.toString().padStart(2, "0")}
+    </div>
+  );
+}
+```
+
+## Error Handling
+
+```typescript
+try {
+  const result = await client.getActiveFlashSales();
+  // Use result...
+} catch (error) {
+  if (error instanceof EcommerceApiError) {
+    console.error("API Error:", error.message);
+    console.error("Status:", error.status);
+  } else {
+    console.error("Unexpected error:", error);
+  }
+}
+```
+
+## Notes
+
+- Flash sales are automatically filtered to only show active sales (between `startsAt` and `endsAt`)
+- The `timeRemaining` field provides countdown info for the featured/first flash sale
+- Use `serverTime` to sync client-side countdown timers accurately
+- Products in flash sales are automatically filtered to only include active products
+- Discount percentages are pre-calculated for convenience
+- The endpoint caches responses for 30 seconds due to time-sensitive nature
+
+## API Endpoint
+
+The SDK method calls:
+```
+GET /api/marketplace/flash-sales/active?limit={limit}&merchantId={merchantId}
+```
+
+## Related Types
+
+```typescript
+import type {
+  ActiveFlashSalesResponse,
+  FlashSale,
+  FlashSaleItem,
+  ListActiveFlashSalesParams,
+} from "@basedone/core/ecommerce";
+```
+