@pear-protocol/core-sdk 2.0.0 → 2.1.0

package/dist/auth/index.d.ts

@@ -47,7 +47,7 @@ declare class Auth {
         refreshToken: string;
         user: {
             id: string;
-            role: "basic" | "pro";
+            role: "basic" | "pro" | "vault";
             providerId: string | null;
             loginMethod: "email" | "evm_wallet" | "oauth" | "x";
         };
@@ -77,7 +77,7 @@ declare class Auth {
         refreshToken: string;
         user: {
             id: string;
-            role: "basic" | "pro";
+            role: "basic" | "pro" | "vault";
             providerId: string | null;
             loginMethod: "email" | "evm_wallet" | "oauth" | "x";
         };
@@ -91,7 +91,7 @@ declare class Auth {
     logout(headers?: ClientHeaders): Promise<void>;
     me(headers?: ClientHeaders): Promise<{
         id: string;
-        role: "basic" | "pro";
+        role: "basic" | "pro" | "vault";
         providerId: string | null;
         loginMethod: "email" | "evm_wallet" | "oauth" | "x";
         identities: {
@@ -102,7 +102,7 @@ declare class Auth {
     }>;
     apiKeyMe(headers?: ClientHeaders): Promise<{
         id: string;
-        role: "basic" | "pro";
+        role: "basic" | "pro" | "vault";
         scope: "read" | "read_write";
         authMethod: "api_key";
     }>;

package/dist/core/index.d.ts

@@ -14,6 +14,7 @@ declare class Core {
                 id: string;
                 alias: string;
                 connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                kind: "vault" | "eoa";
                 exchangeIdentifier: string;
                 createdAt: string;
                 updatedAt: string;
@@ -32,6 +33,7 @@ declare class Core {
                 id: string;
                 alias: string;
                 connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                kind: "vault" | "eoa";
                 exchangeIdentifier: string;
                 createdAt: string;
                 updatedAt: string;
@@ -50,6 +52,7 @@ declare class Core {
                 id: string;
                 alias: string;
                 connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                kind: "vault" | "eoa";
                 exchangeIdentifier: string;
                 createdAt: string;
                 updatedAt: string;
@@ -70,6 +73,7 @@ declare class Core {
                 id: string;
                 alias: string;
                 connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                kind: "vault" | "eoa";
                 exchangeIdentifier: string;
                 createdAt: string;
                 updatedAt: string;
@@ -91,6 +95,7 @@ declare class Core {
                 id: string;
                 alias: string;
                 connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                kind: "vault" | "eoa";
                 exchangeIdentifier: string;
                 createdAt: string;
                 updatedAt: string;
@@ -119,6 +124,7 @@ declare class Core {
                 id: string;
                 alias: string;
                 connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                kind: "vault" | "eoa";
                 exchangeIdentifier: string;
                 createdAt: string;
                 updatedAt: string;
@@ -141,6 +147,7 @@ declare class Core {
                 id: string;
                 alias: string;
                 connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                kind: "vault" | "eoa";
                 exchangeIdentifier: string;
                 createdAt: string;
                 updatedAt: string;
@@ -164,6 +171,7 @@ declare class Core {
                 id: string;
                 alias: string;
                 connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                kind: "vault" | "eoa";
                 exchangeIdentifier: string;
                 createdAt: string;
                 updatedAt: string;
@@ -182,6 +190,69 @@ declare class Core {
             };
         }>;
         restore: (id: string, headers?: ClientHeaders) => Promise<void>;
+        createVault: (body: HttpTypes.CreateVaultTradeAccountInput, headers?: ClientHeaders) => Promise<{
+            account: {
+                id: string;
+                alias: string;
+                connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                kind: "vault" | "eoa";
+                exchangeIdentifier: string;
+                createdAt: string;
+                updatedAt: string;
+                metadata?: {
+                    agentWalletAddress: string;
+                    isSubaccount: boolean;
+                    mainAccountAddress: string;
+                } | {
+                    l1_address: string;
+                } | undefined;
+                deletedAt?: string | undefined;
+            };
+        }>;
+        getVaultStatus: (vaultAddress: string, headers?: ClientHeaders) => Promise<{
+            status: {
+                exists: false;
+            } | {
+                exists: true;
+                tradeAccountId: string;
+                account: {
+                    id: string;
+                    alias: string;
+                    connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                    kind: "vault" | "eoa";
+                    exchangeIdentifier: string;
+                    createdAt: string;
+                    updatedAt: string;
+                    metadata?: {
+                        agentWalletAddress: string;
+                        isSubaccount: boolean;
+                        mainAccountAddress: string;
+                    } | {
+                        l1_address: string;
+                    } | undefined;
+                    deletedAt?: string | undefined;
+                };
+            };
+        }>;
+        refreshVault: (vaultAddress: string, headers?: ClientHeaders) => Promise<{
+            account: {
+                id: string;
+                alias: string;
+                connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                kind: "vault" | "eoa";
+                exchangeIdentifier: string;
+                createdAt: string;
+                updatedAt: string;
+                metadata?: {
+                    agentWalletAddress: string;
+                    isSubaccount: boolean;
+                    mainAccountAddress: string;
+                } | {
+                    l1_address: string;
+                } | undefined;
+                deletedAt?: string | undefined;
+            };
+        }>;
     };
     fee: {
         get: (query?: HttpTypes.QuoteFeeParamsInput, headers?: ClientHeaders) => Promise<{
@@ -5110,6 +5181,10 @@ declare class Core {
             })[];
         }>;
         setLeverage: (body: HttpTypes.SetLeverage, headers?: ClientHeaders) => Promise<Record<string, never>>;
+        /** Add or remove margin from an isolated position without changing its size. */
+        adjustIsolatedMargin: (body: HttpTypes.AdjustIsolatedMargin, headers?: ClientHeaders) => Promise<{
+            adjustmentId: string;
+        }>;
     };
     triggers: {
         list: (query: HttpTypes.TriggerListParamsInput, headers?: ClientHeaders) => Promise<{
@@ -7388,7 +7463,7 @@ declare class Core {
             profile: {
                 id: string;
                 displayName: string;
-                role: "basic" | "pro";
+                role: "basic" | "pro" | "vault";
                 address: string | null;
                 email: string | null;
                 emailVerified: boolean;

package/dist/core/index.js

@@ -61,7 +61,26 @@ class Core {
         method: "POST",
         headers
       });
-    }, "restore")
+    }, "restore"),
+    createVault: /* @__PURE__ */ __name(async (body, headers) => {
+      return await this.client.fetch(`/trade-accounts/vault`, {
+        method: "POST",
+        headers,
+        body
+      });
+    }, "createVault"),
+    getVaultStatus: /* @__PURE__ */ __name(async (vaultAddress, headers) => {
+      return await this.client.fetch(`/trade-accounts/vault/${vaultAddress}`, {
+        method: "GET",
+        headers
+      });
+    }, "getVaultStatus"),
+    refreshVault: /* @__PURE__ */ __name(async (vaultAddress, headers) => {
+      return await this.client.fetch(`/trade-accounts/vault/${vaultAddress}/refresh`, {
+        method: "POST",
+        headers
+      });
+    }, "refreshVault")
   };
   fee = {
     // Resolves the trading fee and connector fee recipient for the caller's selected trade account.
@@ -631,7 +650,15 @@ class Core {
         headers,
         body
       });
-    }, "setLeverage")
+    }, "setLeverage"),
+    /** Add or remove margin from an isolated position without changing its size. */
+    adjustIsolatedMargin: /* @__PURE__ */ __name(async (body, headers) => {
+      return await this.client.fetch(`/margin`, {
+        method: "POST",
+        headers,
+        body
+      });
+    }, "adjustIsolatedMargin")
   };
   triggers = {
     list: /* @__PURE__ */ __name(async (query, headers) => {

package/dist/index.d.ts

@@ -8,6 +8,8 @@ export * from '@pear-protocol/utils';
 export { FetchError } from './utils.js';
 import './http.js';
 
+/** Header that makes a request act as a Pear vault (see `SDKConfig.getVaultAddress`). */
+declare const VAULT_ADDRESS_HEADER = "pear-vault-address";
 declare class PearSDK {
     auth: Auth;
     core: Core;
@@ -15,4 +17,4 @@ declare class PearSDK {
     constructor(config: SDKConfig);
 }
 
-export { External, PearSDK as default };
+export { External, VAULT_ADDRESS_HEADER, PearSDK as default };

package/dist/index.js

@@ -10,6 +10,7 @@ export { FetchError } from './utils';
 
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const VAULT_ADDRESS_HEADER = "pear-vault-address";
 class PearSDK {
   static {
     __name(this, "PearSDK");
@@ -161,10 +162,16 @@ class PearSDK {
         client.useResponse(apiKeyAuthMiddleware);
       }
     }
-    if (config.getTradeAccountId) {
+    if (config.getTradeAccountId || config.getVaultAddress) {
       const getTradeAccountId = config.getTradeAccountId;
+      const getVaultAddress = config.getVaultAddress;
       client.useRequest(async (request, next) => {
-        const tradeAccountId = getTradeAccountId();
+        const vaultAddress = getVaultAddress?.();
+        if (vaultAddress) {
+          request.headers.set(VAULT_ADDRESS_HEADER, vaultAddress);
+          return next();
+        }
+        const tradeAccountId = getTradeAccountId?.();
         if (tradeAccountId) {
           request.headers.set("x-trade-account-id", tradeAccountId);
         }
@@ -192,4 +199,4 @@ function readBearerCredential(request) {
 }
 __name(readBearerCredential, "readBearerCredential");
 
-export { PearSDK as default };
+export { VAULT_ADDRESS_HEADER, PearSDK as default };

package/dist/types.d.ts

@@ -62,6 +62,17 @@ type SDKConfig = {
      * Example: () => localStorage.getState().activeTradeAccountId
      */
     getTradeAccountId?: () => string | null;
+    /**
+     * Pear vault address getter (used in both modes). When it returns an address the
+     * request carries the `pear-vault-address` header and acts as that vault: the
+     * backend authorizes the caller as the vault's owner/trader and resolves the
+     * vault's own trade account, so the trade-account header is not sent. For a
+     * one-off call without this hook, pass `{ [VAULT_ADDRESS_HEADER]: address }` as
+     * the call's headers.
+     *
+     * Example: () => useSessionStore.getState().activeVault?.address ?? null
+     */
+    getVaultAddress?: () => string | null;
     /**
      * Default attribution client code (client_ids.code). When set, it is
      * auto-added to the body of trade / trigger / schedule / rebalance requests

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pear-protocol/core-sdk",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Pear Protocol Core SDK",
   "private": false,
   "type": "module",
@@ -26,7 +26,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@pear-protocol/types": "^2.0.0",
+    "@pear-protocol/types": "^2.1.0",
     "@pear-protocol/utils": "^1.0.0",
     "qs": "^6.14.0"
   },