@pear-protocol/core-sdk 1.13.0 → 1.15.0

package/dist/core/index.d.ts

@@ -2618,7 +2618,18 @@ declare class Core {
         /** Return referral codes owned by the authenticated user and their referrer. */
         status: (headers?: ClientHeaders) => Promise<{
             ownedCodes: string[];
-            referrerUserId?: string | undefined;
+            referrerCode?: string | undefined;
+        }>;
+        /** List users permanently bound to the authenticated referrer. */
+        referees: (query?: HttpTypes.ReferralRefereeListParamsInput, headers?: ClientHeaders) => Promise<{
+            limit: number;
+            count: number;
+            referees: {
+                tradeCount: number;
+                address?: `0x${string}` | undefined;
+                referredAt?: number | undefined;
+            }[];
+            nextCursor?: string | undefined;
         }>;
     };
     savedBaskets: {
@@ -3475,147 +3486,7 @@ declare class Core {
                 }[] | undefined;
             };
         }>;
-        closeAll: (body: HttpTypes.CreateTradeCloseAll, headers?: ClientHeaders) => Promise<{
-            executions: ({
-                id: string;
-                connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
-                status: "CANCELLED" | "ACTIVE" | "COMPLETED" | "IDLE" | "FAILED";
-                createdAt: string;
-                updatedAt: string;
-                intent: "OPEN";
-                orderType: "MARKET";
-                legs: [{
-                    symbol: string;
-                    side: "BUY" | "SELL";
-                    mode: "QUANTITY" | "USD";
-                    amount: string;
-                    reduceOnly: boolean;
-                }, ...{
-                    symbol: string;
-                    side: "BUY" | "SELL";
-                    mode: "QUANTITY" | "USD";
-                    amount: string;
-                    reduceOnly: boolean;
-                }[]];
-                error?: string | undefined;
-                orders?: {
-                    id: string;
-                    connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
-                    status: "CANCELLED" | "PENDING" | "PARTIAL" | "FILLED" | "REJECTED";
-                    createdAt: string;
-                    updatedAt: string;
-                    type: "MARKET";
-                    symbol: string;
-                    side: "BUY" | "SELL";
-                    reduceOnly: boolean;
-                    quantity: string;
-                    price: string;
-                    filledQuantity: string;
-                    error?: string | undefined;
-                    filledPrice?: string | undefined;
-                }[] | undefined;
-            } | {
-                id: string;
-                connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
-                status: "CANCELLED" | "ACTIVE" | "COMPLETED" | "IDLE" | "FAILED";
-                createdAt: string;
-                updatedAt: string;
-                intent: "ADJUST";
-                orderType: "MARKET";
-                position: {
-                    id: string;
-                    exposure: Record<string, `-${string}` | `+${string}`>;
-                };
-                legs: [{
-                    symbol: string;
-                    side: "BUY" | "SELL";
-                    mode: "QUANTITY" | "USD";
-                    amount: string;
-                    reduceOnly: boolean;
-                }, ...{
-                    symbol: string;
-                    side: "BUY" | "SELL";
-                    mode: "QUANTITY" | "USD";
-                    amount: string;
-                    reduceOnly: boolean;
-                }[]];
-                error?: string | undefined;
-                orders?: {
-                    id: string;
-                    connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
-                    status: "CANCELLED" | "PENDING" | "PARTIAL" | "FILLED" | "REJECTED";
-                    createdAt: string;
-                    updatedAt: string;
-                    type: "MARKET";
-                    symbol: string;
-                    side: "BUY" | "SELL";
-                    reduceOnly: boolean;
-                    quantity: string;
-                    price: string;
-                    filledQuantity: string;
-                    error?: string | undefined;
-                    filledPrice?: string | undefined;
-                }[] | undefined;
-            } | {
-                id: string;
-                connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
-                status: "CANCELLED" | "ACTIVE" | "COMPLETED" | "IDLE" | "FAILED";
-                createdAt: string;
-                updatedAt: string;
-                intent: "CLOSE";
-                orderType: "MARKET";
-                position: {
-                    id: string;
-                    exposure: Record<string, `-${string}` | `+${string}`>;
-                };
-                error?: string | undefined;
-                orders?: {
-                    id: string;
-                    connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
-                    status: "CANCELLED" | "PENDING" | "PARTIAL" | "FILLED" | "REJECTED";
-                    createdAt: string;
-                    updatedAt: string;
-                    type: "MARKET";
-                    symbol: string;
-                    side: "BUY" | "SELL";
-                    reduceOnly: boolean;
-                    quantity: string;
-                    price: string;
-                    filledQuantity: string;
-                    error?: string | undefined;
-                    filledPrice?: string | undefined;
-                }[] | undefined;
-            } | {
-                id: string;
-                connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
-                status: "CANCELLED" | "ACTIVE" | "COMPLETED" | "IDLE" | "FAILED";
-                createdAt: string;
-                updatedAt: string;
-                intent: "REVERSE";
-                orderType: "MARKET";
-                position: {
-                    id: string;
-                    exposure: Record<string, `-${string}` | `+${string}`>;
-                };
-                error?: string | undefined;
-                orders?: {
-                    id: string;
-                    connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
-                    status: "CANCELLED" | "PENDING" | "PARTIAL" | "FILLED" | "REJECTED";
-                    createdAt: string;
-                    updatedAt: string;
-                    type: "MARKET";
-                    symbol: string;
-                    side: "BUY" | "SELL";
-                    reduceOnly: boolean;
-                    quantity: string;
-                    price: string;
-                    filledQuantity: string;
-                    error?: string | undefined;
-                    filledPrice?: string | undefined;
-                }[] | undefined;
-            })[];
-        }>;
+        closeAll: (body: HttpTypes.CreateTradeCloseAll, headers?: ClientHeaders) => Promise<Record<string, never>>;
         setLeverage: (body: HttpTypes.SetLeverage, headers?: ClientHeaders) => Promise<Record<string, never>>;
     };
     triggers: {

package/dist/core/index.js

@@ -375,6 +375,14 @@ class Core {
         method: "GET",
         headers
       });
+    },
+    /** List users permanently bound to the authenticated referrer. */
+    referees: async (query, headers) => {
+      return await this.client.fetch(`/referrals/referees`, {
+        method: "GET",
+        headers,
+        query
+      });
     }
   };
   savedBaskets = {

package/dist/utils.d.ts

@@ -8,7 +8,8 @@ declare function normalizeResponseData(resp: Response, reqHeaders: Headers): Pro
 declare class FetchError extends Error {
     status: number | undefined;
     statusText: string | undefined;
-    constructor(message: string, statusText?: string, status?: number);
+    errorCode: string | undefined;
+    constructor(message: string, statusText?: string, status?: number, errorCode?: string);
 }
 declare function gzipJson(value: unknown): Promise<Blob>;
 

package/dist/utils.js

@@ -27,7 +27,7 @@ async function normalizeResponseData(resp, reqHeaders) {
   }
   if (resp.status >= 300) {
     const jsonError = await resp.json().catch(() => ({}));
-    throw new FetchError(jsonError.message ?? resp.statusText, resp.statusText, resp.status);
+    throw new FetchError(jsonError.message ?? resp.statusText, resp.statusText, resp.status, jsonError.errorCode);
   }
   if (resp.status === 204 || resp.status === 205) {
     return null;
@@ -45,10 +45,13 @@ async function normalizeResponseData(resp, reqHeaders) {
 class FetchError extends Error {
   status;
   statusText;
-  constructor(message, statusText, status) {
+  // Machine-readable contract code from the server's error envelope (e.g. SYNC_CREATE_FILLS_TOO_RECENT).
+  errorCode;
+  constructor(message, statusText, status, errorCode) {
     super(message);
     this.statusText = statusText;
     this.status = status;
+    this.errorCode = errorCode;
   }
 }
 async function gzipJson(value) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pear-protocol/core-sdk",
-  "version": "1.13.0",
+  "version": "1.15.0",
   "description": "Pear Protocol Core SDK",
   "private": false,
   "type": "module",
@@ -22,17 +22,19 @@
   "scripts": {
     "build": "tsup",
     "clean": "rm -rf dist .turbo",
+    "test": "vitest run",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@pear-protocol/types": "^1.17.0",
-    "@pear-protocol/utils": "^0.5.0",
+    "@pear-protocol/types": "^1.20.0",
+    "@pear-protocol/utils": "^0.5.1",
     "qs": "^6.14.0"
   },
   "devDependencies": {
     "@backend/typescript-config": "workspace:*",
     "@types/qs": "^6.14.0",
     "tsup": "8.5.1",
-    "typescript": "5.9.3"
+    "typescript": "5.9.3",
+    "vitest": "4.1.2"
   }
 }