aftermath-ts-sdk 5.1.1 → 6.0.0-dev.abf3dae

package/dist/index.js

@@ -2816,9 +2816,9 @@ var init_caller = __esm({
           if (this.apiBaseUrl === void 0) {
             throw new Error("no apiBaseUrl: unable to fetch data");
           }
-          const safeUrl = this.apiBaseUrl.slice(-1) === "/" ? this.apiBaseUrl.slice(0, -1) : this.apiBaseUrl;
-          const endpointSegment = this.apiEndpoint ? `${this.apiEndpoint}/` : "";
-          return `${safeUrl}/${endpointSegment}${this.apiUrlPrefix + (url === "" ? "" : "/")}${url}`;
+          const baseUrl = this.apiBaseUrl.replace(_Caller.TRAILING_SLASHES_REGEX, "");
+          const path = [this.apiEndpoint, this.apiUrlPrefix, url].map((segment) => segment.replace(/^\/+|\/+$/g, "")).filter(Boolean).join("/");
+          return `${baseUrl}/${path}`;
         };
         /**
          * Stores an access token on this caller for later requests.
@@ -3064,19 +3064,10 @@ var init_caller = __esm({
           if (this.apiBaseUrl === void 0) {
             throw new Error("no apiBaseUrl: unable to open websocket");
           }
-          const baseHttp = this.apiBaseUrl.replace(
-            _Caller.TRAILING_SLASHES_REGEX,
-            ""
+          return this.urlForApiCall(path2).replace(
+            _Caller.HTTP_PROTOCOL_REGEX,
+            "ws$1://"
           );
-          const baseWs = baseHttp.replace(_Caller.HTTP_PROTOCOL_REGEX, "ws$1://");
-          const endpointSegment = this.apiEndpoint ? `${this.apiEndpoint}/` : "";
-          const prefix = `${endpointSegment}${this.apiUrlPrefix}`;
-          const normalizedPrefix = prefix.replace(
-            _Caller.TRAILING_SLASHES_REGEX,
-            ""
-          );
-          const normalizedPath = path2.startsWith("/") ? path2.slice(1) : path2;
-          return `${baseWs}/${normalizedPrefix}${normalizedPath ? `/${normalizedPath}` : ""}`;
         };
         const url = buildWsUrl(path);
         const ws = new WebSocket(url);
@@ -14989,6 +14980,35 @@ var init_perpetuals = __esm({
           marketIds
         });
       }
+      /**
+       * Fetch daily realized PnL and funding for one or more accounts, bucketed
+       * by UTC calendar day from account creation through today.
+       *
+       * @param inputs.accountIds - 1 to 50 account IDs to query.
+       *
+       * @returns `ApiPerpetualsAccountsPnlCalendarResponse` containing one
+       * calendar per distinct account.
+       *
+       * @remarks
+       * If `accountIds` is empty, this returns `{ accounts: [] }` without making an API call.
+       *
+       * @example
+       * ```ts
+       * const { accounts } = await perps.getAccountsPnlCalendar({
+       *   accountIds: [123n],
+       * });
+       * ```
+       */
+      async getAccountsPnlCalendar(inputs) {
+        if (inputs.accountIds.length <= 0) {
+          return {
+            accounts: []
+          };
+        }
+        return this.fetchApi("accounts/pnl-calendar", {
+          accountIds: inputs.accountIds
+        });
+      }
       // =========================================================================
       //  Ownership Queries
       // =========================================================================
@@ -15134,6 +15154,34 @@ var init_perpetuals = __esm({
       getMarkets24hrStats(inputs) {
         return this.fetchApi("markets/24hr-stats", inputs);
       }
+      /**
+       * Fetch the category and tag labels that group markets in a picker UI.
+       *
+       * The response is the vocabulary behind `PerpetualsMarketMetadata.category`
+       * and `PerpetualsMarketMetadata.tags`: every market names exactly one of
+       * these categories, and each of its tags is declared under that category.
+       * Both lists come back in display order.
+       *
+       * The labels are configuration rather than a fixed enum, so resolve a
+       * market's metadata against this response instead of hard-coding them.
+       *
+       * @param abortSignal - Optional cancellation signal.
+       * @returns `ApiPerpetualsMarketsCategoriesResponse` containing `categories`.
+       *
+       * @remarks
+       * `categories` is empty when the backing static configuration is unavailable.
+       * Treat that as "no grouping" and show every market rather than rendering an
+       * empty picker.
+       *
+       * @example
+       * ```ts
+       * const { categories } = await perps.getMarketsCategories();
+       * // [{ name: "Crypto", tags: ["Layer 1", "DeFi", ...] }, ...]
+       * ```
+       */
+      getMarketsCategories(abortSignal) {
+        return this.fetchApi("markets/categories", {}, abortSignal);
+      }
       // =========================================================================
       //  Prices
       // =========================================================================
@@ -15468,7 +15516,7 @@ var init_perpetuals = __esm({
        * collect fees on orders placed on behalf of the user. Once revoked, the integrator
        * will no longer be able to submit orders with integrator fees for this account.
        * The user can re-approve the integrator at any time by calling
-       * `getCreateIntegratorConfigTx` again.
+       * `getCreateBuilderCodeIntegratorConfigTx` again.
        *
        * The resulting transaction must be signed by the account owner and executed on-chain.
        *
@@ -15497,86 +15545,6 @@ var init_perpetuals = __esm({
           }
         );
       }
-      /**
-       * Build a transaction to initialize an integrator's global fee vault.
-       *
-       * This endpoint creates a transaction that initializes the global vault where an
-       * integrator's fees accumulate across all markets. This is a one-time setup that
-       * must be performed before the integrator can claim fees. The integrator's identity
-       * is taken from the transaction sender on-chain.
-       *
-       * The resulting transaction must be signed by the integrator and executed on-chain.
-       *
-       * @param inputs - {@link ApiPerpetualsBuilderCodesCreateIntegratorVaultTxBody}.
-       * @returns `SdkTransactionResponse` with `tx`.
-       *
-       * @example
-       * ```ts
-       * const tx = await perps.getCreateBuilderCodeIntegratorVaultTx({});
-       * ```
-       */
-      async getCreateBuilderCodeIntegratorVaultTx(inputs) {
-        const { tx, ...otherInputs } = inputs;
-        return this.fetchApiTxObject(
-          "builder-codes/transactions/create-integrator-vault",
-          {
-            ...otherInputs,
-            txKind: await this.api?.Transactions().fetchBase64TxKindFromTx({ tx })
-          },
-          void 0,
-          {
-            txKind: true
-          }
-        );
-      }
-      /**
-       * Build a transaction to claim accumulated integrator fees from a vault.
-       *
-       * This endpoint creates a transaction that allows an integrator to claim the fees
-       * they have earned from orders placed on behalf of users. Fees accumulate in the
-       * integrator's global vault (across all markets) and can be claimed at any moment.
-       * The fees are proportional to the taker volume generated by the users' orders that
-       * the integrator submitted.
-       *
-       * If a `recipientAddress` is provided, the claimed fees will be automatically
-       * transferred to that address. Otherwise, the coin outputs are exposed as transaction
-       * arguments for further use in the transaction (one per non-zero collateral balance).
-       *
-       * The resulting transaction must be signed by the integrator and executed on-chain.
-       *
-       * @param inputs - {@link ApiPerpetualsBuilderCodesClaimIntegratorVaultFeesTxBody}.
-       * @returns `ApiPerpetualsBuilderCodesClaimIntegratorVaultFeesTxResponse` containing
-       *   `txKind` and optionally `coinOutArgs`.
-       *
-       * @example
-       * ```ts
-       * // Claim with automatic transfer to recipient
-       * const response = await perps.getClaimBuilderCodeIntegratorVaultFeesTx({
-       *   integratorId: 7,
-       *   recipientAddress: "0x...",
-       * });
-       *
-       * // Claim with coin outputs for further use
-       * const response = await perps.getClaimBuilderCodeIntegratorVaultFeesTx({
-       *   integratorId: 7,
-       * });
-       * // response.coinOutArgs can be used in subsequent transaction commands
-       * ```
-       */
-      async getClaimBuilderCodeIntegratorVaultFeesTx(inputs) {
-        const { tx, ...otherInputs } = inputs;
-        return this.fetchApiTxObject(
-          "builder-codes/transactions/claim-integrator-vault-fees",
-          {
-            ...otherInputs,
-            txKind: await this.api?.Transactions().fetchBase64TxKindFromTx({ tx })
-          },
-          void 0,
-          {
-            txKind: true
-          }
-        );
-      }
       // =========================================================================
       //  Builder Codes Inspections
       // =========================================================================
@@ -15611,41 +15579,6 @@ var init_perpetuals = __esm({
       async getBuilderCodeIntegratorConfig(inputs) {
         return this.fetchApi("builder-codes/integrator-config", inputs);
       }
-      /**
-       * Fetch accumulated integrator vault fees.
-       *
-       * This endpoint queries the total fees an integrator has earned and accumulated in
-       * their global vault, grouped by collateral coin type. Integrators earn fees
-       * proportional to the taker volume generated by orders they submit on behalf of
-       * users. These fees can be claimed at any time using
-       * {@link getClaimBuilderCodeIntegratorVaultFeesTx}.
-       *
-       * This information is useful for:
-       * - Displaying total claimable fees to integrators in dashboards
-       * - Monitoring fee accrual across collateral types
-       * - Determining whether fees are ready to be claimed
-       *
-       * @param inputs - {@link ApiPerpetualsBuilderCodesIntegratorVaultsBody}.
-       * @returns `ApiPerpetualsBuilderCodesIntegratorVaultsResponse` containing
-       *   a vector of per-collateral vault data with accumulated fees.
-       *
-       * @example
-       * ```ts
-       * const vaultFees = await perps.getBuilderCodeIntegratorVaults({
-       *   integratorId: 7,
-       * });
-       *
-       * for (const vault of vaultFees.integratorVaults) {
-       *   console.log(`${vault.collateralCoinType}: ${vault.fees} collateral units claimable`);
-       * }
-       *
-       * const totalFeesUsd = vaultFees.integratorVaults.reduce((sum, vault) => sum + vault.feesUsd, 0);
-       * console.log(`Total claimable (USD): ${totalFeesUsd}`);
-       * ```
-       */
-      async getBuilderCodeIntegratorVaults(inputs) {
-        return this.fetchApi("builder-codes/integrator-vaults", inputs);
-      }
       // =========================================================================
       //  Public Static Helpers
       // =========================================================================
@@ -15892,14 +15825,14 @@ var init_perpetuals = __esm({
         };
       }
       /**
-       * Open a market-candles websocket stream for a single market/interval:
-       * `/perpetuals/ws/market-candles/{market_id}/{interval_ms}`.
+       * Open a market-candles subscription for a single market/interval on
+       * `/perpetuals/ws/updates`.
        *
        * The stream emits {@link PerpetualsWsCandleResponseMessage} messages,
        * typically containing the latest candle for the specified interval.
        *
        * @param args.marketId - Market ID to subscribe to.
-       * The input contains the candle interval in milliseconds.
+       * @param args.interval - Timeframe label such as `"1m"` or `"1h"`.
        * @param args.onMessage - Handler for incoming candle updates.
        * @param args.onOpen - Optional hook called when the websocket opens.
        * @param args.onError - Optional hook called on websocket error.
@@ -15911,7 +15844,7 @@ var init_perpetuals = __esm({
        * ```ts
        * const stream = perps.openMarketCandlesWebsocketStream({
        *   marketId: "0x...",
-       *   intervalMs: 60_000,
+       *   interval: "1m",
        *   onMessage: ({ lastCandle }) => console.log(lastCandle),
        * });
        * ```
@@ -17840,7 +17773,6 @@ var init_packages = __esm({
   "src/packages/index.ts"() {
     "use strict";
     init_auth2();
-    init_auth2();
     init_coin2();
     init_farms2();
     init_faucet2();