@compass-labs/api-sdk 2.2.55 → 2.2.56-rc.0

package/openapi_prepped_for_speakeasy.json

@@ -6455,7 +6455,7 @@
           "Global Markets Perps"
         ],
         "summary": "Deposit USDC to global markets perps account",
-        "description": "Prepare a USDC deposit from Arbitrum via EIP-2612 Permit.\n\nReturns EIP-712 typed data for the user to sign off-chain (no gas needed).\nAfter signing, send the permit signature to the deposit/execute endpoint,\nwhere a gas sponsor calls batchedDepositWithPermit on the HL Bridge2.",
+        "description": "Prepare a USDC deposit from Arbitrum via EIP-2612 Permit.\n\nReturns EIP-712 typed data for the user to sign off-chain (no gas needed).\nCompass does NOT broadcast the bridge tx \u2014 the integrator's own sponsor\nwallet calls batchedDepositWithPermit on the HL Bridge2 contract on\nArbitrum after the user signs. See api_docs/v2/Products/Global-Markets.mdx\n\"Deposit USDC\" section for the bridge-broadcast code.",
         "operationId": "v2_global_markets_perps_deposit",
         "requestBody": {
           "content": {
@@ -6492,6 +6492,49 @@
         "x-speakeasy-name-override": "global_markets_perps_deposit"
       }
     },
+    "/v2/global_markets_perps/deposit/sponsor_prepare": {
+      "post": {
+        "tags": [
+          "Global Markets Perps"
+        ],
+        "summary": "Build the Bridge2 deposit tx from a signed permit",
+        "description": "Build the Arbitrum tx that completes a USDC deposit to HL.\n\nTakes the EIP-2612 permit signature returned by /deposit and returns\na fully-encoded `Bridge2.batchedDepositWithPermit` call. The integrator's\nsponsor wallet (`sender`) broadcasts the returned tx \u2014 Compass does not\nbroadcast and does not hold gas keys.",
+        "operationId": "v2_global_markets_perps_deposit_sponsor_prepare",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/GlobalMarketsPerpsDepositSponsorPrepareRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Successful Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GlobalMarketsPerpsDepositSponsorPrepareResponse"
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "Validation Error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            }
+          }
+        },
+        "x-speakeasy-name-override": "global_markets_perps_deposit_sponsor_prepare"
+      }
+    },
     "/v2/global_markets_perps/withdraw": {
       "post": {
         "tags": [
@@ -14134,17 +14177,17 @@
         "properties": {
           "permit": {
             "$ref": "#/components/schemas/PermitTypedDataResponse-Output",
-            "description": "EIP-712 typed data for the USDC permit \u2014 user signs this off-chain"
+            "description": "EIP-712 typed data for the USDC permit \u2014 user signs this off-chain."
           },
           "amount_raw": {
             "type": "integer",
             "title": "Amount Raw",
-            "description": "USDC amount in raw units (6 decimals)"
+            "description": "USDC amount in raw 6-decimal units. Pass this and the signature to /deposit/sponsor_prepare."
           },
           "destination": {
             "type": "string",
             "title": "Destination",
-            "description": "Global Markets Perps Safe address on HyperEVM that receives the deposit on HyperCore"
+            "description": "Address that will be credited on Hyperliquid (equals the deposit owner EOA \u2014 HL keys accounts by EVM address)."
           }
         },
         "type": "object",
@@ -14154,7 +14197,74 @@
           "destination"
         ],
         "title": "GlobalMarketsPerpsDepositResponse",
-        "description": "EIP-2612 permit data for the user to sign, plus deposit metadata.\n\nAfter the user signs the permit, the gas sponsor calls\nbatchedDepositWithPermit on the Hyperliquid Bridge2 contract."
+        "description": "EIP-2612 permit data the user signs to authorize a USDC bridge deposit.\n\nAfter signing, submit the signature to /v2/global_markets_perps/deposit/sponsor_prepare\nto get a ready-to-broadcast Arbitrum tx that calls Bridge2.batchedDepositWithPermit.\nThe integrator's sponsor wallet broadcasts that tx \u2014 Compass does not broadcast."
+      },
+      "GlobalMarketsPerpsDepositSponsorPrepareRequest": {
+        "properties": {
+          "owner": {
+            "type": "string",
+            "title": "Owner",
+            "description": "The user's EOA address on Arbitrum (the permit signer).",
+            "example": "0x01E62835dd7F52173546A325294762143eE4a882"
+          },
+          "amount_raw": {
+            "type": "integer",
+            "exclusiveMinimum": 0.0,
+            "title": "Amount Raw",
+            "description": "USDC amount in raw 6-decimal units, as returned by /deposit.",
+            "example": 100000000
+          },
+          "deadline": {
+            "type": "integer",
+            "exclusiveMinimum": 0.0,
+            "title": "Deadline",
+            "description": "Permit deadline (unix seconds), as returned in the permit.message from /deposit.",
+            "example": 1747097383
+          },
+          "signature": {
+            "type": "string",
+            "title": "Signature",
+            "description": "The user's EIP-2612 permit signature (65-byte hex, 0x-prefixed or raw).",
+            "example": "0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"
+          },
+          "sender": {
+            "type": "string",
+            "title": "Sender",
+            "description": "Sponsor wallet address that will broadcast the returned tx (used for `from` and nonce).",
+            "example": "0x4A83b4413CF41C3244027e1590E35a0F48403F0c"
+          }
+        },
+        "type": "object",
+        "required": [
+          "owner",
+          "amount_raw",
+          "deadline",
+          "signature",
+          "sender"
+        ],
+        "title": "GlobalMarketsPerpsDepositSponsorPrepareRequest",
+        "description": "Take a user's signed EIP-2612 USDC permit and build an Arbitrum tx\nthat calls Bridge2.batchedDepositWithPermit.\n\nThe customer broadcasts the returned tx from their own sponsor wallet \u2014\nCompass does not hold gas keys (non-custodial).",
+        "example": {
+          "owner": "0x01E62835dd7F52173546A325294762143eE4a882",
+          "amount_raw": 100000000,
+          "deadline": 1747097383,
+          "signature": "0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
+          "sender": "0x4A83b4413CF41C3244027e1590E35a0F48403F0c"
+        }
+      },
+      "GlobalMarketsPerpsDepositSponsorPrepareResponse": {
+        "properties": {
+          "transaction": {
+            "$ref": "#/components/schemas/UnsignedTransaction",
+            "description": "Unsigned Arbitrum tx calling Bridge2.batchedDepositWithPermit. Sign and broadcast from `sender`."
+          }
+        },
+        "type": "object",
+        "required": [
+          "transaction"
+        ],
+        "title": "GlobalMarketsPerpsDepositSponsorPrepareResponse",
+        "description": "Fully-encoded Arbitrum tx that completes a HL Bridge2 deposit.\n\nBroadcast `transaction` from the `sender` wallet supplied in the request.\nAfter the receipt confirms, verify a USDC `Transfer` event was emitted \u2014\nBridge2 can silently no-op without reverting."
       },
       "GlobalMarketsPerpsEnableUnifiedAccountRequest": {
         "properties": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compass-labs/api-sdk",
-  "version": "2.2.55",
+  "version": "2.2.56-rc.0",
   "author": "royalnine",
   "type": "module",
   "tshy": {

package/src/funcs/globalMarketsPerpsGlobalMarketsPerpsDeposit.ts

@@ -33,8 +33,10 @@ import { Result } from "../types/fp.js";
  * Prepare a USDC deposit from Arbitrum via EIP-2612 Permit.
  *
  * Returns EIP-712 typed data for the user to sign off-chain (no gas needed).
- * After signing, send the permit signature to the deposit/execute endpoint,
- * where a gas sponsor calls batchedDepositWithPermit on the HL Bridge2.
+ * Compass does NOT broadcast the bridge tx — the integrator's own sponsor
+ * wallet calls batchedDepositWithPermit on the HL Bridge2 contract on
+ * Arbitrum after the user signs. See api_docs/v2/Products/Global-Markets.mdx
+ * "Deposit USDC" section for the bridge-broadcast code.
  */
 export function globalMarketsPerpsGlobalMarketsPerpsDeposit(
   client: CompassApiSDKCore,

package/src/funcs/globalMarketsPerpsGlobalMarketsPerpsDepositSponsorPrepare.ts

@@ -0,0 +1,181 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { CompassApiSDKCore } from "../core.js";
+import { encodeJSON } from "../lib/encodings.js";
+import { matchStatusCode } from "../lib/http.js";
+import * as M from "../lib/matchers.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import * as components from "../models/components/index.js";
+import { CompassAPISDKError } from "../models/errors/compassapisdkerror.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import * as errors from "../models/errors/index.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * Build the Bridge2 deposit tx from a signed permit
+ *
+ * @remarks
+ * Build the Arbitrum tx that completes a USDC deposit to HL.
+ *
+ * Takes the EIP-2612 permit signature returned by /deposit and returns
+ * a fully-encoded `Bridge2.batchedDepositWithPermit` call. The integrator's
+ * sponsor wallet (`sender`) broadcasts the returned tx — Compass does not
+ * broadcast and does not hold gas keys.
+ */
+export function globalMarketsPerpsGlobalMarketsPerpsDepositSponsorPrepare(
+  client: CompassApiSDKCore,
+  request: components.GlobalMarketsPerpsDepositSponsorPrepareRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    components.GlobalMarketsPerpsDepositSponsorPrepareResponse,
+    | errors.HTTPValidationError
+    | CompassAPISDKError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: CompassApiSDKCore,
+  request: components.GlobalMarketsPerpsDepositSponsorPrepareRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      components.GlobalMarketsPerpsDepositSponsorPrepareResponse,
+      | errors.HTTPValidationError
+      | CompassAPISDKError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) =>
+      components.GlobalMarketsPerpsDepositSponsorPrepareRequest$outboundSchema
+        .parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = encodeJSON("body", payload, { explode: true });
+
+  const path = pathToFunc("/v2/global_markets_perps/deposit/sponsor_prepare")();
+
+  const headers = new Headers(compactMap({
+    "Content-Type": "application/json",
+    Accept: "application/json",
+  }));
+
+  const secConfig = await extractSecurity(client._options.apiKeyAuth);
+  const securityInput = secConfig == null ? {} : { apiKeyAuth: secConfig };
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "v2_global_markets_perps_deposit_sponsor_prepare",
+    oAuth2Scopes: null,
+
+    resolvedSecurity: requestSecurity,
+
+    securitySource: client._options.apiKeyAuth,
+    retryConfig: options?.retries
+      || client._options.retryConfig
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
+  };
+
+  const requestRes = client._createRequest(context, {
+    security: requestSecurity,
+    method: "POST",
+    baseURL: options?.serverURL,
+    path: path,
+    headers: headers,
+    body: body,
+    userAgent: client._options.userAgent,
+    timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
+  }, options);
+  if (!requestRes.ok) {
+    return [requestRes, { status: "invalid" }];
+  }
+  const req = requestRes.value;
+
+  const doResult = await client._do(req, {
+    context,
+    isErrorStatusCode: (statusCode: number) =>
+      matchStatusCode({ status: statusCode } as Response, ["4XX", "5XX"]),
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req }];
+  }
+  const response = doResult.value;
+
+  const responseFields = {
+    HttpMeta: { Response: response, Request: req },
+  };
+
+  const [result] = await M.match<
+    components.GlobalMarketsPerpsDepositSponsorPrepareResponse,
+    | errors.HTTPValidationError
+    | CompassAPISDKError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(
+      200,
+      components.GlobalMarketsPerpsDepositSponsorPrepareResponse$inboundSchema,
+    ),
+    M.jsonErr(422, errors.HTTPValidationError$inboundSchema),
+    M.fail("4XX"),
+    M.fail("5XX"),
+  )(response, req, { extraFields: responseFields });
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}

package/src/lib/config.ts

@@ -62,7 +62,7 @@ export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "0.0.1",
   sdkVersion: "2.0.0",
-  genVersion: "2.884.11",
+  genVersion: "2.885.0",
   userAgent:
-    "speakeasy-sdk/typescript 2.0.0 2.884.11 0.0.1 @compass-labs/api-sdk",
+    "speakeasy-sdk/typescript 2.0.0 2.885.0 0.0.1 @compass-labs/api-sdk",
 } as const;

package/src/models/components/globalmarketsperpsdepositresponse.ts

@@ -13,12 +13,13 @@ import {
 } from "./permittypeddataresponseoutput.js";
 
 /**
- * EIP-2612 permit data for the user to sign, plus deposit metadata.
+ * EIP-2612 permit data the user signs to authorize a USDC bridge deposit.
  *
  * @remarks
  *
- * After the user signs the permit, the gas sponsor calls
- * batchedDepositWithPermit on the Hyperliquid Bridge2 contract.
+ * After signing, submit the signature to /v2/global_markets_perps/deposit/sponsor_prepare
+ * to get a ready-to-broadcast Arbitrum tx that calls Bridge2.batchedDepositWithPermit.
+ * The integrator's sponsor wallet broadcasts that tx — Compass does not broadcast.
  */
 export type GlobalMarketsPerpsDepositResponse = {
   /**
@@ -26,11 +27,11 @@ export type GlobalMarketsPerpsDepositResponse = {
    */
   permit: PermitTypedDataResponseOutput;
   /**
-   * USDC amount in raw units (6 decimals)
+   * USDC amount in raw 6-decimal units. Pass this and the signature to /deposit/sponsor_prepare.
    */
   amountRaw: number;
   /**
-   * Global Markets Perps Safe address on HyperEVM that receives the deposit on HyperCore
+   * Address that will be credited on Hyperliquid (equals the deposit owner EOA — HL keys accounts by EVM address).
    */
   destination: string;
 };

package/src/models/components/globalmarketsperpsdepositsponsorpreparerequest.ts

@@ -0,0 +1,76 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+
+/**
+ * Take a user's signed EIP-2612 USDC permit and build an Arbitrum tx
+ *
+ * @remarks
+ * that calls Bridge2.batchedDepositWithPermit.
+ *
+ * The customer broadcasts the returned tx from their own sponsor wallet —
+ * Compass does not hold gas keys (non-custodial).
+ */
+export type GlobalMarketsPerpsDepositSponsorPrepareRequest = {
+  /**
+   * The user's EOA address on Arbitrum (the permit signer).
+   */
+  owner: string;
+  /**
+   * USDC amount in raw 6-decimal units, as returned by /deposit.
+   */
+  amountRaw: number;
+  /**
+   * Permit deadline (unix seconds), as returned in the permit.message from /deposit.
+   */
+  deadline: number;
+  /**
+   * The user's EIP-2612 permit signature (65-byte hex, 0x-prefixed or raw).
+   */
+  signature: string;
+  /**
+   * Sponsor wallet address that will broadcast the returned tx (used for `from` and nonce).
+   */
+  sender: string;
+};
+
+/** @internal */
+export type GlobalMarketsPerpsDepositSponsorPrepareRequest$Outbound = {
+  owner: string;
+  amount_raw: number;
+  deadline: number;
+  signature: string;
+  sender: string;
+};
+
+/** @internal */
+export const GlobalMarketsPerpsDepositSponsorPrepareRequest$outboundSchema:
+  z.ZodType<
+    GlobalMarketsPerpsDepositSponsorPrepareRequest$Outbound,
+    z.ZodTypeDef,
+    GlobalMarketsPerpsDepositSponsorPrepareRequest
+  > = z.object({
+    owner: z.string(),
+    amountRaw: z.number().int(),
+    deadline: z.number().int(),
+    signature: z.string(),
+    sender: z.string(),
+  }).transform((v) => {
+    return remap$(v, {
+      amountRaw: "amount_raw",
+    });
+  });
+
+export function globalMarketsPerpsDepositSponsorPrepareRequestToJSON(
+  globalMarketsPerpsDepositSponsorPrepareRequest:
+    GlobalMarketsPerpsDepositSponsorPrepareRequest,
+): string {
+  return JSON.stringify(
+    GlobalMarketsPerpsDepositSponsorPrepareRequest$outboundSchema.parse(
+      globalMarketsPerpsDepositSponsorPrepareRequest,
+    ),
+  );
+}

package/src/models/components/globalmarketsperpsdepositsponsorprepareresponse.ts

@@ -0,0 +1,51 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  UnsignedTransaction,
+  UnsignedTransaction$inboundSchema,
+} from "./unsignedtransaction.js";
+
+/**
+ * Fully-encoded Arbitrum tx that completes a HL Bridge2 deposit.
+ *
+ * @remarks
+ *
+ * Broadcast `transaction` from the `sender` wallet supplied in the request.
+ * After the receipt confirms, verify a USDC `Transfer` event was emitted —
+ * Bridge2 can silently no-op without reverting.
+ */
+export type GlobalMarketsPerpsDepositSponsorPrepareResponse = {
+  transaction: UnsignedTransaction;
+};
+
+/** @internal */
+export const GlobalMarketsPerpsDepositSponsorPrepareResponse$inboundSchema:
+  z.ZodType<
+    GlobalMarketsPerpsDepositSponsorPrepareResponse,
+    z.ZodTypeDef,
+    unknown
+  > = z.object({
+    transaction: UnsignedTransaction$inboundSchema,
+  });
+
+export function globalMarketsPerpsDepositSponsorPrepareResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  GlobalMarketsPerpsDepositSponsorPrepareResponse,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      GlobalMarketsPerpsDepositSponsorPrepareResponse$inboundSchema.parse(
+        JSON.parse(x),
+      ),
+    `Failed to parse 'GlobalMarketsPerpsDepositSponsorPrepareResponse' from JSON`,
+  );
+}

package/src/models/components/index.ts

@@ -154,6 +154,8 @@ export * from "./globalmarketsperpscandlesresponse.js";
 export * from "./globalmarketsperpscategory.js";
 export * from "./globalmarketsperpsdepositrequest.js";
 export * from "./globalmarketsperpsdepositresponse.js";
+export * from "./globalmarketsperpsdepositsponsorpreparerequest.js";
+export * from "./globalmarketsperpsdepositsponsorprepareresponse.js";
 export * from "./globalmarketsperpsenableunifiedaccountrequest.js";
 export * from "./globalmarketsperpsenableunifiedaccountresponse.js";
 export * from "./globalmarketsperpsensureleveragerequest.js";

package/src/sdk/globalmarketsperps.ts

@@ -7,6 +7,7 @@ import { globalMarketsPerpsGlobalMarketsPerpsApproveBuilderFee } from "../funcs/
 import { globalMarketsPerpsGlobalMarketsPerpsCancelOrder } from "../funcs/globalMarketsPerpsGlobalMarketsPerpsCancelOrder.js";
 import { globalMarketsPerpsGlobalMarketsPerpsCandles } from "../funcs/globalMarketsPerpsGlobalMarketsPerpsCandles.js";
 import { globalMarketsPerpsGlobalMarketsPerpsDeposit } from "../funcs/globalMarketsPerpsGlobalMarketsPerpsDeposit.js";
+import { globalMarketsPerpsGlobalMarketsPerpsDepositSponsorPrepare } from "../funcs/globalMarketsPerpsGlobalMarketsPerpsDepositSponsorPrepare.js";
 import { globalMarketsPerpsGlobalMarketsPerpsEnableUnifiedAccount } from "../funcs/globalMarketsPerpsGlobalMarketsPerpsEnableUnifiedAccount.js";
 import { globalMarketsPerpsGlobalMarketsPerpsEnsureLeverage } from "../funcs/globalMarketsPerpsGlobalMarketsPerpsEnsureLeverage.js";
 import { globalMarketsPerpsGlobalMarketsPerpsExecute } from "../funcs/globalMarketsPerpsGlobalMarketsPerpsExecute.js";
@@ -121,8 +122,10 @@ export class GlobalMarketsPerps extends ClientSDK {
    * Prepare a USDC deposit from Arbitrum via EIP-2612 Permit.
    *
    * Returns EIP-712 typed data for the user to sign off-chain (no gas needed).
-   * After signing, send the permit signature to the deposit/execute endpoint,
-   * where a gas sponsor calls batchedDepositWithPermit on the HL Bridge2.
+   * Compass does NOT broadcast the bridge tx — the integrator's own sponsor
+   * wallet calls batchedDepositWithPermit on the HL Bridge2 contract on
+   * Arbitrum after the user signs. See api_docs/v2/Products/Global-Markets.mdx
+   * "Deposit USDC" section for the bridge-broadcast code.
    */
   async globalMarketsPerpsDeposit(
     request: components.GlobalMarketsPerpsDepositRequest,
@@ -135,6 +138,30 @@ export class GlobalMarketsPerps extends ClientSDK {
     ));
   }
 
+  /**
+   * Build the Bridge2 deposit tx from a signed permit
+   *
+   * @remarks
+   * Build the Arbitrum tx that completes a USDC deposit to HL.
+   *
+   * Takes the EIP-2612 permit signature returned by /deposit and returns
+   * a fully-encoded `Bridge2.batchedDepositWithPermit` call. The integrator's
+   * sponsor wallet (`sender`) broadcasts the returned tx — Compass does not
+   * broadcast and does not hold gas keys.
+   */
+  async globalMarketsPerpsDepositSponsorPrepare(
+    request: components.GlobalMarketsPerpsDepositSponsorPrepareRequest,
+    options?: RequestOptions,
+  ): Promise<components.GlobalMarketsPerpsDepositSponsorPrepareResponse> {
+    return unwrapAsync(
+      globalMarketsPerpsGlobalMarketsPerpsDepositSponsorPrepare(
+        this,
+        request,
+        options,
+      ),
+    );
+  }
+
   /**
    * Withdraw USDC from global markets perps account
    *

package/src/types/async.ts

@@ -21,16 +21,17 @@ export type APICall =
 
 export class APIPromise<T> implements Promise<T> {
   readonly #promise: Promise<[T, APICall]>;
-  readonly #unwrapped: Promise<T>;
+  #unwrapped: Promise<T> | null;
 
   readonly [Symbol.toStringTag] = "APIPromise";
 
   constructor(p: [T, APICall] | Promise<[T, APICall]>) {
     this.#promise = p instanceof Promise ? p : Promise.resolve(p);
-    this.#unwrapped =
-      p instanceof Promise
-        ? this.#promise.then(([value]) => value)
-        : Promise.resolve(p[0]);
+    this.#unwrapped = p instanceof Promise ? null : Promise.resolve(p[0]);
+  }
+
+  #getUnwrapped(): Promise<T> {
+    return (this.#unwrapped ??= this.#promise.then(([value]) => value));
   }
 
   then<TResult1 = T, TResult2 = never>(
@@ -55,11 +56,11 @@ export class APIPromise<T> implements Promise<T> {
       | null
       | undefined,
   ): Promise<T | TResult> {
-    return this.#unwrapped.catch(onrejected);
+    return this.#getUnwrapped().catch(onrejected);
   }
 
   finally(onfinally?: (() => void) | null | undefined): Promise<T> {
-    return this.#unwrapped.finally(onfinally);
+    return this.#getUnwrapped().finally(onfinally);
   }
 
   $inspect(): Promise<[T, APICall]> {