@basedone/core 0.1.10 → 0.2.1

package/lib/meta/data/mainnet/spotMeta.json

@@ -2177,6 +2177,15 @@
       "name": "@257",
       "index": 257,
       "isCanonical": false
+    },
+    {
+      "tokens": [
+        398,
+        0
+      ],
+      "name": "@258",
+      "index": 258,
+      "isCanonical": false
     }
   ],
   "tokens": [
@@ -2187,7 +2196,10 @@
       "index": 0,
       "tokenId": "0x6d1e7cde53ba9467b783cb7c530ce054",
       "isCanonical": true,
-      "evmContract": null,
+      "evmContract": {
+        "address": "0x6b9e773128f453f5c2c60935ee2de2cbc5390a24",
+        "evm_extra_wei_decimals": -2
+      },
       "fullName": null,
       "deployerTradingFeeShare": "0.0"
     },
@@ -6681,7 +6693,10 @@
       "index": 381,
       "tokenId": "0xbd6af8c18f3e56d2da95a3c81d18e814",
       "isCanonical": false,
-      "evmContract": null,
+      "evmContract": {
+        "address": "0x99603f5cb890faca5cc5495ccc74391cdffa28bc",
+        "evm_extra_wei_decimals": 10
+      },
       "fullName": "Funnel BNB",
       "deployerTradingFeeShare": "1.0"
     },
@@ -6880,7 +6895,10 @@
       "index": 398,
       "tokenId": "0xec43194f64d555bdaef5afb5b6c6c686",
       "isCanonical": false,
-      "evmContract": null,
+      "evmContract": {
+        "address": "0xa51dc81944a15623874981181a99d6c56b20ed56",
+        "evm_extra_wei_decimals": 11
+      },
       "fullName": "Stable",
       "deployerTradingFeeShare": "1.0"
     },

package/lib/meta/data/testnet/meta.json

@@ -505,9 +505,7 @@
       "szDecimals": 0,
       "name": "WIF",
       "maxLeverage": 5,
-      "marginTableId": 5,
-      "onlyIsolated": true,
-      "marginMode": "strictIsolated"
+      "marginTableId": 5
     },
     {
       "szDecimals": 1,

package/lib/meta/data/testnet/perpDexs.json

@@ -291,6 +291,12 @@
     "feeRecipient": "0x40008f23a17a1ba9a6f25723a4d06bcd81c33426",
     "assetToStreamingOiCap": [],
     "subDeployers": [
+      [
+        "registerAsset",
+        [
+          "0xb26126e39214f9594802b59515f409479e202f3a"
+        ]
+      ],
       [
         "setOracle",
         [
@@ -446,79 +452,79 @@
     "assetToFundingMultiplier": [
       [
         "vntls:vANDRL",
-        "0.0020000002"
+        "0.005000002"
       ],
       [
         "vntls:vANTHRPC",
-        "0.0025507473"
+        "0.0171374751"
       ],
       [
         "vntls:vBYTED",
-        "0.0024785789"
+        "0.0148191144"
       ],
       [
         "vntls:vCHAIN",
-        "0.002"
+        "0.005"
       ],
       [
         "vntls:vCLUELY",
-        "0.01"
+        "2.0"
       ],
       [
         "vntls:vCOLOSSAL",
-        "0.01"
+        "2.0"
       ],
       [
         "vntls:vCURSOR",
-        "0.01"
+        "2.0"
       ],
       [
         "vntls:vDBRICKS",
-        "0.002004205"
+        "0.0050534663"
       ],
       [
         "vntls:vFIG",
-        "0.01"
+        "2.0"
       ],
       [
         "vntls:vFIGAI",
-        "0.0020037172"
+        "0.0050472398"
       ],
       [
         "vntls:vKRAKEN",
-        "0.01"
+        "0.005"
       ],
       [
         "vntls:vNLINK",
-        "0.01"
+        "2.0"
       ],
       [
         "vntls:vOAI",
-        "0.01"
+        "2.0"
       ],
       [
         "vntls:vPERPLXT",
-        "0.002539593"
+        "0.0167613111"
       ],
       [
         "vntls:vPOLY",
-        "0.01"
+        "2.0"
       ],
       [
         "vntls:vRAMP",
-        "0.0020037948"
+        "0.0050482304"
       ],
       [
         "vntls:vSPACEX",
-        "0.0020003078"
+        "0.0050030981"
       ],
       [
         "vntls:vSTRIPE",
-        "0.01"
+        "2.0"
       ],
       [
         "vntls:vXAI",
-        "0.01"
+        "2.0"
       ]
     ]
   },
@@ -1541,6 +1547,7 @@
       [
         "setOracle",
         [
+          "0x897ee1987787a2cd302ea9d729e5c46ccd302afe",
           "0xa67b36947149a7f2312bffc9d1c859bf12029986"
         ]
       ]
@@ -2125,7 +2132,24 @@
     "deployer": "0x2e3ee3705913258c9a0ecb643571045343d77e1b",
     "oracleUpdater": "0xec6c68168d9fd51bb078acc74722aeff14db220b",
     "feeRecipient": null,
-    "assetToStreamingOiCap": [],
+    "assetToStreamingOiCap": [
+      [
+        "trve:CRZD",
+        "3000000.0"
+      ],
+      [
+        "trve:CS2",
+        "3000000.0"
+      ],
+      [
+        "trve:F1LN",
+        "3000000.0"
+      ],
+      [
+        "trve:PMRT",
+        "3000000.0"
+      ]
+    ],
     "subDeployers": [
       [
         "setOracle",
@@ -2168,7 +2192,16 @@
     "deployer": "0xb38a498cc3f358899a5a7ad67608271b679a4167",
     "oracleUpdater": "0xec6c68168d9fd51bb078acc74722aeff14db220b",
     "feeRecipient": null,
-    "assetToStreamingOiCap": [],
+    "assetToStreamingOiCap": [
+      [
+        "trv:POKE",
+        "3000000.0"
+      ],
+      [
+        "trv:ZARD",
+        "3000000.0"
+      ]
+    ],
     "subDeployers": [
       [
         "setOracle",
@@ -2479,7 +2512,16 @@
     "deployer": "0x9b4989cb2735a1ac906cd99648fe3d84ef4b4d2d",
     "oracleUpdater": "0xec6c68168d9fd51bb078acc74722aeff14db220b",
     "feeRecipient": null,
-    "assetToStreamingOiCap": [],
+    "assetToStreamingOiCap": [
+      [
+        "trov:NDTO",
+        "3000000.0"
+      ],
+      [
+        "trov:NTDO",
+        "3000000.0"
+      ]
+    ],
     "subDeployers": [
       [
         "setOracle",
@@ -2601,7 +2643,16 @@
     "deployer": "0xfe770a17e47717b2e43504cf8f00ced96cf00979",
     "oracleUpdater": "0xec6c68168d9fd51bb078acc74722aeff14db220b",
     "feeRecipient": null,
-    "assetToStreamingOiCap": [],
+    "assetToStreamingOiCap": [
+      [
+        "trvv:BIRKN",
+        "3000000.0"
+      ],
+      [
+        "trvv:WATCH",
+        "3000000.0"
+      ]
+    ],
     "subDeployers": [
       [
         "setOracle",
@@ -2620,7 +2671,16 @@
     "deployer": "0xaaf21c1d7e7da1604c85d3ea93268e91902ba41e",
     "oracleUpdater": "0xec6c68168d9fd51bb078acc74722aeff14db220b",
     "feeRecipient": null,
-    "assetToStreamingOiCap": [],
+    "assetToStreamingOiCap": [
+      [
+        "trvo:BIRKN",
+        "3000000.0"
+      ],
+      [
+        "trvo:WATCH",
+        "3000000.0"
+      ]
+    ],
     "subDeployers": [
       [
         "setOracle",
@@ -2639,7 +2699,20 @@
     "deployer": "0x27f9d24b907b86bce4d2cf1299248421391aa444",
     "oracleUpdater": "0xec6c68168d9fd51bb078acc74722aeff14db220b",
     "feeRecipient": null,
-    "assetToStreamingOiCap": [],
+    "assetToStreamingOiCap": [
+      [
+        "tvr:HRMES",
+        "3000000.0"
+      ],
+      [
+        "tvr:LVMH",
+        "3000000.0"
+      ],
+      [
+        "tvr:RCHMT",
+        "3000000.0"
+      ]
+    ],
     "subDeployers": [
       [
         "setOracle",
@@ -2658,7 +2731,20 @@
     "deployer": "0x2be16138a3ea12e09b38dae749f49accc735fded",
     "oracleUpdater": "0xec6c68168d9fd51bb078acc74722aeff14db220b",
     "feeRecipient": null,
-    "assetToStreamingOiCap": [],
+    "assetToStreamingOiCap": [
+      [
+        "torv:BRBY",
+        "3000000.0"
+      ],
+      [
+        "torv:KRING",
+        "3000000.0"
+      ],
+      [
+        "torv:PRADA",
+        "3000000.0"
+      ]
+    ],
     "subDeployers": [
       [
         "setOracle",
@@ -2677,7 +2763,20 @@
     "deployer": "0x5f120e2aed50caf06e89ece2de71c9f5d30bb866",
     "oracleUpdater": "0xec6c68168d9fd51bb078acc74722aeff14db220b",
     "feeRecipient": null,
-    "assetToStreamingOiCap": [],
+    "assetToStreamingOiCap": [
+      [
+        "tvro:CRPI",
+        "3000000.0"
+      ],
+      [
+        "tvro:GOOS",
+        "3000000.0"
+      ],
+      [
+        "tvro:MONC",
+        "3000000.0"
+      ]
+    ],
     "subDeployers": [
       [
         "setOracle",
@@ -2696,7 +2795,16 @@
     "deployer": "0xab8b0324d63cb39728f8c7502ff3b1a905ae8b0d",
     "oracleUpdater": "0xec6c68168d9fd51bb078acc74722aeff14db220b",
     "feeRecipient": null,
-    "assetToStreamingOiCap": [],
+    "assetToStreamingOiCap": [
+      [
+        "tvor:CPRI",
+        "3000000.0"
+      ],
+      [
+        "tvor:TPR",
+        "3000000.0"
+      ]
+    ],
     "subDeployers": [
       [
         "setOracle",
@@ -2820,5 +2928,43 @@
     "deployerFeeScale": "1.0",
     "lastDeployerFeeScaleChangeTime": "2025-12-02T11:35:58.687904841",
     "assetToFundingMultiplier": []
+  },
+  {
+    "name": "wa",
+    "fullName": "wa:GDR Test DEX",
+    "deployer": "0x47515db2eab01758c740ab220352a34b8d5a3826",
+    "oracleUpdater": "0x47515db2eab01758c740ab220352a34b8d5a3826",
+    "feeRecipient": null,
+    "assetToStreamingOiCap": [],
+    "subDeployers": [
+      [
+        "setOracle",
+        [
+          "0x47515db2eab01758c740ab220352a34b8d5a3826"
+        ]
+      ]
+    ],
+    "deployerFeeScale": "1.0",
+    "lastDeployerFeeScaleChangeTime": "2025-12-03T11:35:21.991486494",
+    "assetToFundingMultiplier": []
+  },
+  {
+    "name": "org",
+    "fullName": "org dex",
+    "deployer": "0xf5e2c3905c402ea494e71248c6c75338b9098cf6",
+    "oracleUpdater": "0xf5e2c3905c402ea494e71248c6c75338b9098cf6",
+    "feeRecipient": null,
+    "assetToStreamingOiCap": [],
+    "subDeployers": [
+      [
+        "setOracle",
+        [
+          "0xf5e2c3905c402ea494e71248c6c75338b9098cf6"
+        ]
+      ]
+    ],
+    "deployerFeeScale": "1.0",
+    "lastDeployerFeeScaleChangeTime": "2025-12-05T11:15:20.928371793",
+    "assetToFundingMultiplier": []
   }
 ]

package/lib/meta/data/testnet/spotMeta.json

@@ -10646,6 +10646,24 @@
       "name": "@1378",
       "index": 1378,
       "isCanonical": false
+    },
+    {
+      "tokens": [
+        1498,
+        0
+      ],
+      "name": "@1379",
+      "index": 1379,
+      "isCanonical": false
+    },
+    {
+      "tokens": [
+        1498,
+        1452
+      ],
+      "name": "@1380",
+      "index": 1380,
+      "isCanonical": false
     }
   ],
   "tokens": [
@@ -27527,6 +27545,39 @@
       "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"
     }
   ]
 }

package/lib/react/InstrumentProvider.tsx

@@ -0,0 +1,69 @@
+"use client";
+
+import { createContext, useContext, useMemo, type ReactNode } from "react";
+import { SpotMeta } from "@nktkas/hyperliquid";
+import { AllPerpsMeta } from "../hip3/market-info";
+import { InstrumentClient } from "../instrument/client";
+
+const InstrumentContext = createContext<InstrumentClient | null>(null);
+
+export interface InstrumentsProviderProps {
+  spotMeta: SpotMeta;
+  allPerpsMeta: AllPerpsMeta;
+  children: ReactNode;
+}
+
+/**
+ * Provides InstrumentClient to the React tree.
+ *
+ * @example
+ * ```tsx
+ * <InstrumentsProvider spotMeta={spotMeta} allPerpsMeta={allPerpsMeta}>
+ *   <App />
+ * </InstrumentsProvider>
+ * ```
+ */
+export function InstrumentsProvider({
+  spotMeta,
+  allPerpsMeta,
+  children,
+}: InstrumentsProviderProps) {
+  const client = useMemo(
+    () => new InstrumentClient(spotMeta, allPerpsMeta).init(),
+    [spotMeta, allPerpsMeta],
+  );
+
+  return (
+    <InstrumentContext.Provider value={client}>
+      {children}
+    </InstrumentContext.Provider>
+  );
+}
+
+/**
+ * Access the InstrumentClient from context.
+ * Must be used within an InstrumentsProvider.
+ *
+ * @example
+ * ```tsx
+ * const client = useInstruments();
+ * const btc = client.getInstrument("BTC");
+ * ```
+ */
+export function useInstruments(): InstrumentClient {
+  const client = useContext(InstrumentContext);
+  if (!client) {
+    throw new Error(
+      "useInstruments must be used within an InstrumentsProvider",
+    );
+  }
+  return client;
+}
+
+/**
+ * Access the InstrumentClient from context, returns null if not in provider.
+ * Useful for optional instrument access.
+ */
+export function useInstrumentsOptional(): InstrumentClient | null {
+  return useContext(InstrumentContext);
+}

package/lib/utils/flooredDateTime.ts

@@ -0,0 +1,55 @@
+// ====== UTC-only rounding utilities ======
+
+type RoundMode = 'floor' | 'round' | 'ceil';
+
+const MIN  = 60_000;
+const HOUR = 60 * MIN;
+const DAY  = 24 * HOUR;
+const WEEK = 7 * DAY;
+
+const opOf = (m: RoundMode) => m === 'ceil' ? Math.ceil : m === 'round' ? Math.round : Math.floor;
+
+interface UtcRoundOptions {
+  mode?: RoundMode;                 // default 'floor'
+  weekStartsOn?: 0|1|2|3|4|5|6;     // only used if stepMs % WEEK === 0; 0=Sun..6=Sat
+  anchorUtc?: number;               // custom UTC anchor (ms). Default 0 or computed for weekStartsOn
+}
+
+/**
+ * Higher-order UTC rounder.
+ * Snaps an instant t to the UTC grid defined by (anchorUtc + k*stepMs).
+ * Formula: anchor + step * op((t - anchor)/step)
+ */
+export function makeUtcRounder(stepMs: number, opts: UtcRoundOptions = {}) {
+  const mode = opts.mode ?? 'floor';
+  const op = opOf(mode);
+
+  // Determine anchor in UTC millis
+  let anchorUtc = opts.anchorUtc ?? 0;
+
+  // If weekly and weekStartsOn provided, anchor to the desired weekday at 00:00 UTC
+  if (stepMs % WEEK === 0 && opts.weekStartsOn !== undefined) {
+    // 1970-01-04T00:00:00Z was a Sunday in UTC
+    const sundayUTC = Date.UTC(1970, 0, 4);
+    anchorUtc = sundayUTC + opts.weekStartsOn * DAY; // e.g., 1 => Monday, 2 => Tuesday, etc.
+  }
+
+  return (t: Date): Date => {
+    const ts = t.getTime(); // UTC ms
+    const snapped = op((ts - anchorUtc) / stepMs) * stepMs + anchorUtc;
+    return new Date(snapped);
+  };
+}
+
+// ---------- Convenience helpers (UTC) ----------
+
+// Floor to arbitrary minute step (UTC)
+export const floorUtcMinutes = (stepMinutes: number) =>
+  makeUtcRounder(stepMinutes * MIN, { mode: 'floor' });
+
+// Floor to hour/day/week (UTC)
+export const floorUtcHour = () => makeUtcRounder(HOUR, { mode: 'floor' });
+export const floorUtcDay  = () => makeUtcRounder(DAY,  { mode: 'floor' });
+export const floorUtcWeek = (weekStartsOn: 0|1|2|3|4|5|6 = 1) =>
+  makeUtcRounder(WEEK, { mode: 'floor', weekStartsOn }); // default Monday-start
+

package/lib/utils/time.ts

@@ -0,0 +1,51 @@
+import { floorUtcWeek } from './flooredDateTime';
+
+export enum DayOfWeek {
+  Sunday = 0,
+  Monday = 1,
+  Tuesday = 2,
+  Wednesday = 3,
+  Thursday = 4,
+  Friday = 5,
+  Saturday = 6,
+}
+
+export interface WeekInfo {
+  weekNumber: number;
+  startDate: Date;
+  endDate: Date;
+}
+
+const WEEK_IN_MS = 7 * 24 * 60 * 60 * 1000;
+
+/**
+ * Gets the latest completed week information.
+ * 
+ * @param currentTimestamp - Optional timestamp in milliseconds. If not provided, uses current time.
+ * @param offset - Optional number of weeks to offset (0 = latest completed week, 1 = previous week, etc.)
+ * @param weekStartsOn - Day of week the week should start on. Defaults to Thursday.
+ * @returns WeekInfo with weekNumber, startDate, and endDate
+ */
+export function getLatestCompletedWeek(
+  currentTimestamp?: number,
+  offset: number = 0,
+  weekStartsOn: DayOfWeek = DayOfWeek.Thursday
+): WeekInfo {
+  const now = new Date(currentTimestamp ?? Date.now());
+
+  // floorUtcWeek floors to the beginning of the week on the specified day.
+  // This gives us the start of the *current* week, which is the end of the *last completed* week.
+  const floorToWeekStart = floorUtcWeek(weekStartsOn as 0|1|2|3|4|5|6);
+  const endDate = new Date(floorToWeekStart(now).getTime() - offset * WEEK_IN_MS);
+  
+  // The start date of the completed week is 7 days before the end date.
+  const startDate = new Date(endDate.getTime() - WEEK_IN_MS);
+
+  // Using a fixed point in time for week 1 calculation for consistency
+  const week1StartDate = new Date(process.env.WEEK1_START_DATE || "2025-12-04T00:00:00Z");
+  const msSinceWeek1 = startDate.getTime() - week1StartDate.getTime();
+  const weekNumber = Math.round(msSinceWeek1 / WEEK_IN_MS) + 1;
+
+  return { weekNumber, startDate, endDate };
+}
+