@metamask/transaction-pay-controller 22.6.3 → 22.8.0

package/dist/strategy/server/ServerStrategy.d.mts

@@ -0,0 +1,15 @@
+import type { PayStrategy, PayStrategyExecuteRequest, PayStrategyGetQuotesRequest, TransactionPayQuote } from "../../types.mjs";
+import type { ServerQuote } from "./types.mjs";
+/**
+ * Pay strategy that routes quote, submit, and status requests through the
+ * MetaMask intents API. Supports both gasless (delegated server-execute) and
+ * non-gasless (TransactionController-submitted) execution paths. Gated by the
+ * `payStrategies.server.enabled` remote feature flag.
+ */
+export declare class ServerStrategy implements PayStrategy<ServerQuote> {
+    supports(request: PayStrategyGetQuotesRequest): boolean;
+    getQuotes(request: PayStrategyGetQuotesRequest): Promise<TransactionPayQuote<ServerQuote>[]>;
+    getBatchTransactions(): Promise<[]>;
+    execute(request: PayStrategyExecuteRequest<ServerQuote>): ReturnType<PayStrategy<ServerQuote>['execute']>;
+}
+//# sourceMappingURL=ServerStrategy.d.mts.map

package/dist/strategy/server/ServerStrategy.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServerStrategy.d.mts","sourceRoot":"","sources":["../../../src/strategy/server/ServerStrategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,yBAAyB,EACzB,2BAA2B,EAC3B,mBAAmB,EACpB,wBAAoB;AAIrB,OAAO,KAAK,EAAE,WAAW,EAAE,oBAAgB;AAE3C;;;;;GAKG;AACH,qBAAa,cAAe,YAAW,WAAW,CAAC,WAAW,CAAC;IAC7D,QAAQ,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO;IAKjD,SAAS,CACb,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,mBAAmB,CAAC,WAAW,CAAC,EAAE,CAAC;IAIxC,oBAAoB,IAAI,OAAO,CAAC,EAAE,CAAC;IAInC,OAAO,CACX,OAAO,EAAE,yBAAyB,CAAC,WAAW,CAAC,GAC9C,UAAU,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,CAAC;CAQnD"}

package/dist/strategy/server/ServerStrategy.mjs

@@ -0,0 +1,31 @@
+import { getPayStrategiesConfig } from "../../utils/feature-flags.mjs";
+import { getServerQuotes } from "./server-quotes.mjs";
+import { submitServerQuotes } from "./server-submit.mjs";
+/**
+ * Pay strategy that routes quote, submit, and status requests through the
+ * MetaMask intents API. Supports both gasless (delegated server-execute) and
+ * non-gasless (TransactionController-submitted) execution paths. Gated by the
+ * `payStrategies.server.enabled` remote feature flag.
+ */
+export class ServerStrategy {
+    supports(request) {
+        const config = getPayStrategiesConfig(request.messenger);
+        return config.server.enabled;
+    }
+    async getQuotes(request) {
+        return getServerQuotes(request);
+    }
+    async getBatchTransactions() {
+        return [];
+    }
+    async execute(request) {
+        try {
+            return await submitServerQuotes(request);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            throw new Error(`Server submit: ${message}`);
+        }
+    }
+}
+//# sourceMappingURL=ServerStrategy.mjs.map

package/dist/strategy/server/ServerStrategy.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServerStrategy.mjs","sourceRoot":"","sources":["../../../src/strategy/server/ServerStrategy.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,sBAAsB,EAAE,sCAAkC;AACnE,OAAO,EAAE,eAAe,EAAE,4BAAwB;AAClD,OAAO,EAAE,kBAAkB,EAAE,4BAAwB;AAGrD;;;;;GAKG;AACH,MAAM,OAAO,cAAc;IACzB,QAAQ,CAAC,OAAoC;QAC3C,MAAM,MAAM,GAAG,sBAAsB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACzD,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,SAAS,CACb,OAAoC;QAEpC,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,oBAAoB;QACxB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,KAAK,CAAC,OAAO,CACX,OAA+C;QAE/C,IAAI,CAAC;YACH,OAAO,MAAM,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,MAAM,IAAI,KAAK,CAAC,kBAAkB,OAAO,EAAE,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;CACF","sourcesContent":["import type {\n  PayStrategy,\n  PayStrategyExecuteRequest,\n  PayStrategyGetQuotesRequest,\n  TransactionPayQuote,\n} from '../../types';\nimport { getPayStrategiesConfig } from '../../utils/feature-flags';\nimport { getServerQuotes } from './server-quotes';\nimport { submitServerQuotes } from './server-submit';\nimport type { ServerQuote } from './types';\n\n/**\n * Pay strategy that routes quote, submit, and status requests through the\n * MetaMask intents API. Supports both gasless (delegated server-execute) and\n * non-gasless (TransactionController-submitted) execution paths. Gated by the\n * `payStrategies.server.enabled` remote feature flag.\n */\nexport class ServerStrategy implements PayStrategy<ServerQuote> {\n  supports(request: PayStrategyGetQuotesRequest): boolean {\n    const config = getPayStrategiesConfig(request.messenger);\n    return config.server.enabled;\n  }\n\n  async getQuotes(\n    request: PayStrategyGetQuotesRequest,\n  ): Promise<TransactionPayQuote<ServerQuote>[]> {\n    return getServerQuotes(request);\n  }\n\n  async getBatchTransactions(): Promise<[]> {\n    return [];\n  }\n\n  async execute(\n    request: PayStrategyExecuteRequest<ServerQuote>,\n  ): ReturnType<PayStrategy<ServerQuote>['execute']> {\n    try {\n      return await submitServerQuotes(request);\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      throw new Error(`Server submit: ${message}`);\n    }\n  }\n}\n"]}

package/dist/strategy/server/constants.cjs

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SERVER_POLLING_INTERVAL = exports.SERVER_URL_BASE = void 0;
+/**
+ * Default base URL for the server intents API.
+ * Override via `payStrategies.server.baseUrl` remote feature flag.
+ */
+exports.SERVER_URL_BASE = 'https://intents.api.cx.metamask.io';
+/** Polling interval in milliseconds. */
+exports.SERVER_POLLING_INTERVAL = 2000;
+//# sourceMappingURL=constants.cjs.map

package/dist/strategy/server/constants.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.cjs","sourceRoot":"","sources":["../../../src/strategy/server/constants.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACU,QAAA,eAAe,GAAG,oCAAoC,CAAC;AAEpE,wCAAwC;AAC3B,QAAA,uBAAuB,GAAG,IAAI,CAAC","sourcesContent":["/**\n * Default base URL for the server intents API.\n * Override via `payStrategies.server.baseUrl` remote feature flag.\n */\nexport const SERVER_URL_BASE = 'https://intents.api.cx.metamask.io';\n\n/** Polling interval in milliseconds. */\nexport const SERVER_POLLING_INTERVAL = 2000;\n"]}

package/dist/strategy/server/constants.d.cts

@@ -0,0 +1,8 @@
+/**
+ * Default base URL for the server intents API.
+ * Override via `payStrategies.server.baseUrl` remote feature flag.
+ */
+export declare const SERVER_URL_BASE = "https://intents.api.cx.metamask.io";
+/** Polling interval in milliseconds. */
+export declare const SERVER_POLLING_INTERVAL = 2000;
+//# sourceMappingURL=constants.d.cts.map

package/dist/strategy/server/constants.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.cts","sourceRoot":"","sources":["../../../src/strategy/server/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,eAAe,uCAAuC,CAAC;AAEpE,wCAAwC;AACxC,eAAO,MAAM,uBAAuB,OAAO,CAAC"}

package/dist/strategy/server/constants.d.mts

@@ -0,0 +1,8 @@
+/**
+ * Default base URL for the server intents API.
+ * Override via `payStrategies.server.baseUrl` remote feature flag.
+ */
+export declare const SERVER_URL_BASE = "https://intents.api.cx.metamask.io";
+/** Polling interval in milliseconds. */
+export declare const SERVER_POLLING_INTERVAL = 2000;
+//# sourceMappingURL=constants.d.mts.map

package/dist/strategy/server/constants.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.mts","sourceRoot":"","sources":["../../../src/strategy/server/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,eAAe,uCAAuC,CAAC;AAEpE,wCAAwC;AACxC,eAAO,MAAM,uBAAuB,OAAO,CAAC"}

package/dist/strategy/server/constants.mjs

@@ -0,0 +1,8 @@
+/**
+ * Default base URL for the server intents API.
+ * Override via `payStrategies.server.baseUrl` remote feature flag.
+ */
+export const SERVER_URL_BASE = 'https://intents.api.cx.metamask.io';
+/** Polling interval in milliseconds. */
+export const SERVER_POLLING_INTERVAL = 2000;
+//# sourceMappingURL=constants.mjs.map

package/dist/strategy/server/constants.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.mjs","sourceRoot":"","sources":["../../../src/strategy/server/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,oCAAoC,CAAC;AAEpE,wCAAwC;AACxC,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC","sourcesContent":["/**\n * Default base URL for the server intents API.\n * Override via `payStrategies.server.baseUrl` remote feature flag.\n */\nexport const SERVER_URL_BASE = 'https://intents.api.cx.metamask.io';\n\n/** Polling interval in milliseconds. */\nexport const SERVER_POLLING_INTERVAL = 2000;\n"]}

package/dist/strategy/server/perps.cjs

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeServerPerpsRequest = exports.isServerPerpsDepositRequest = exports.SERVER_HYPERCORE_USDC_PERPS_ADDRESS = void 0;
+const bignumber_js_1 = require("bignumber.js");
+const constants_1 = require("../../constants.cjs");
+/**
+ * Shared 20-byte sentinel address emitted by the server strategy to flag a
+ * Hyperliquid perps deposit. Backend providers translate this to their own
+ * on-chain destination (e.g. Relay's 16-byte HyperCore USDC sentinel, Across's
+ * native USDC-PERPS token at the same address).
+ */
+exports.SERVER_HYPERCORE_USDC_PERPS_ADDRESS = '0x2100000000000000000000000000000000000000';
+const HYPERLIQUID_BRIDGE_ADDRESS_LOWER = '0x2df1c51e09aecf9cacb7bc98cb1742757f163df7';
+const HYPERLIQUID_BRIDGE_CALLDATA_FRAGMENT = HYPERLIQUID_BRIDGE_ADDRESS_LOWER.slice(2);
+/**
+ * Detect whether a quote request represents a Hyperliquid perps deposit by
+ * sniffing the parent transaction calldata for a reference to the Hyperliquid
+ * bridge contract. Transaction type is intentionally NOT consulted so that any
+ * caller funnelling a bridge deposit through Pay is supported.
+ *
+ * @param request - Quote request from the transaction-pay controller.
+ * @param transaction - Parent transaction whose calldata is inspected.
+ * @returns Whether the request matches a Hyperliquid bridge deposit.
+ */
+function isServerPerpsDepositRequest(request, transaction) {
+    if (request.isPostQuote === true ||
+        request.targetChainId !== constants_1.CHAIN_ID_ARBITRUM ||
+        request.targetTokenAddress.toLowerCase() !==
+            constants_1.ARBITRUM_USDC_ADDRESS.toLowerCase()) {
+        return false;
+    }
+    return transactionDataReferencesBridge(transaction);
+}
+exports.isServerPerpsDepositRequest = isServerPerpsDepositRequest;
+/**
+ * Translate a Hyperliquid perps-deposit quote request into the HyperCore
+ * direct-deposit shape with a provider-agnostic sentinel destination. Backend
+ * providers detect the sentinel and rewrite it to their respective on-chain
+ * destinations.
+ *
+ * Transaction pay starts from the parent on-chain asset (Arbitrum USDC,
+ * 6 decimals); HyperCore expects an 8-decimal amount, so the target amount is
+ * shifted accordingly.
+ *
+ * @param request - Quote request from the transaction-pay controller.
+ * @param transaction - Parent transaction whose calldata is inspected.
+ * @returns Normalized request, or the original request if not a perps deposit.
+ */
+function normalizeServerPerpsRequest(request, transaction) {
+    if (!isServerPerpsDepositRequest(request, transaction)) {
+        return request;
+    }
+    return {
+        ...request,
+        targetAmountMinimum: new bignumber_js_1.BigNumber(request.targetAmountMinimum)
+            .shiftedBy(constants_1.HYPERCORE_USDC_DECIMALS - constants_1.USDC_DECIMALS)
+            .toFixed(0),
+        targetChainId: constants_1.CHAIN_ID_HYPERCORE,
+        targetTokenAddress: exports.SERVER_HYPERCORE_USDC_PERPS_ADDRESS,
+    };
+}
+exports.normalizeServerPerpsRequest = normalizeServerPerpsRequest;
+function transactionDataReferencesBridge(transaction) {
+    const fragments = [
+        transaction.txParams?.to,
+        ...(transaction.nestedTransactions ?? []).map((tx) => tx.to),
+    ];
+    return fragments.some((value) => typeof value === 'string' &&
+        value.toLowerCase().includes(HYPERLIQUID_BRIDGE_CALLDATA_FRAGMENT));
+}
+//# sourceMappingURL=perps.cjs.map

package/dist/strategy/server/perps.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"perps.cjs","sourceRoot":"","sources":["../../../src/strategy/server/perps.ts"],"names":[],"mappings":";;;AAEA,+CAAyC;AAEzC,mDAMyB;AAGzB;;;;;GAKG;AACU,QAAA,mCAAmC,GAC9C,4CAAmD,CAAC;AAEtD,MAAM,gCAAgC,GACpC,4CAA4C,CAAC;AAE/C,MAAM,oCAAoC,GACxC,gCAAgC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAE5C;;;;;;;;;GASG;AACH,SAAgB,2BAA2B,CACzC,OAGC,EACD,WAAqE;IAErE,IACE,OAAO,CAAC,WAAW,KAAK,IAAI;QAC5B,OAAO,CAAC,aAAa,KAAK,6BAAiB;QAC3C,OAAO,CAAC,kBAAkB,CAAC,WAAW,EAAE;YACtC,iCAAqB,CAAC,WAAW,EAAE,EACrC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,+BAA+B,CAAC,WAAW,CAAC,CAAC;AACtD,CAAC;AAjBD,kEAiBC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAgB,2BAA2B,CACzC,OAAqB,EACrB,WAAqE;IAErE,IAAI,CAAC,2BAA2B,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,CAAC;QACvD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO;QACL,GAAG,OAAO;QACV,mBAAmB,EAAE,IAAI,wBAAS,CAAC,OAAO,CAAC,mBAAmB,CAAC;aAC5D,SAAS,CAAC,mCAAuB,GAAG,yBAAa,CAAC;aAClD,OAAO,CAAC,CAAC,CAAC;QACb,aAAa,EAAE,8BAAkB;QACjC,kBAAkB,EAAE,2CAAmC;KACxD,CAAC;AACJ,CAAC;AAhBD,kEAgBC;AAED,SAAS,+BAA+B,CACtC,WAAqE;IAErE,MAAM,SAAS,GAA2B;QACxC,WAAW,CAAC,QAAQ,EAAE,EAAE;QACxB,GAAG,CAAC,WAAW,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;KAC7D,CAAC;IAEF,OAAO,SAAS,CAAC,IAAI,CACnB,CAAC,KAAK,EAAE,EAAE,CACR,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC,CACrE,CAAC;AACJ,CAAC","sourcesContent":["import type { TransactionMeta } from '@metamask/transaction-controller';\nimport type { Hex } from '@metamask/utils';\nimport { BigNumber } from 'bignumber.js';\n\nimport {\n  ARBITRUM_USDC_ADDRESS,\n  CHAIN_ID_ARBITRUM,\n  CHAIN_ID_HYPERCORE,\n  HYPERCORE_USDC_DECIMALS,\n  USDC_DECIMALS,\n} from '../../constants';\nimport type { QuoteRequest } from '../../types';\n\n/**\n * Shared 20-byte sentinel address emitted by the server strategy to flag a\n * Hyperliquid perps deposit. Backend providers translate this to their own\n * on-chain destination (e.g. Relay's 16-byte HyperCore USDC sentinel, Across's\n * native USDC-PERPS token at the same address).\n */\nexport const SERVER_HYPERCORE_USDC_PERPS_ADDRESS =\n  '0x2100000000000000000000000000000000000000' as Hex;\n\nconst HYPERLIQUID_BRIDGE_ADDRESS_LOWER =\n  '0x2df1c51e09aecf9cacb7bc98cb1742757f163df7';\n\nconst HYPERLIQUID_BRIDGE_CALLDATA_FRAGMENT =\n  HYPERLIQUID_BRIDGE_ADDRESS_LOWER.slice(2);\n\n/**\n * Detect whether a quote request represents a Hyperliquid perps deposit by\n * sniffing the parent transaction calldata for a reference to the Hyperliquid\n * bridge contract. Transaction type is intentionally NOT consulted so that any\n * caller funnelling a bridge deposit through Pay is supported.\n *\n * @param request - Quote request from the transaction-pay controller.\n * @param transaction - Parent transaction whose calldata is inspected.\n * @returns Whether the request matches a Hyperliquid bridge deposit.\n */\nexport function isServerPerpsDepositRequest(\n  request: Pick<\n    QuoteRequest,\n    'isPostQuote' | 'targetChainId' | 'targetTokenAddress'\n  >,\n  transaction: Pick<TransactionMeta, 'txParams' | 'nestedTransactions'>,\n): boolean {\n  if (\n    request.isPostQuote === true ||\n    request.targetChainId !== CHAIN_ID_ARBITRUM ||\n    request.targetTokenAddress.toLowerCase() !==\n      ARBITRUM_USDC_ADDRESS.toLowerCase()\n  ) {\n    return false;\n  }\n\n  return transactionDataReferencesBridge(transaction);\n}\n\n/**\n * Translate a Hyperliquid perps-deposit quote request into the HyperCore\n * direct-deposit shape with a provider-agnostic sentinel destination. Backend\n * providers detect the sentinel and rewrite it to their respective on-chain\n * destinations.\n *\n * Transaction pay starts from the parent on-chain asset (Arbitrum USDC,\n * 6 decimals); HyperCore expects an 8-decimal amount, so the target amount is\n * shifted accordingly.\n *\n * @param request - Quote request from the transaction-pay controller.\n * @param transaction - Parent transaction whose calldata is inspected.\n * @returns Normalized request, or the original request if not a perps deposit.\n */\nexport function normalizeServerPerpsRequest(\n  request: QuoteRequest,\n  transaction: Pick<TransactionMeta, 'txParams' | 'nestedTransactions'>,\n): QuoteRequest {\n  if (!isServerPerpsDepositRequest(request, transaction)) {\n    return request;\n  }\n\n  return {\n    ...request,\n    targetAmountMinimum: new BigNumber(request.targetAmountMinimum)\n      .shiftedBy(HYPERCORE_USDC_DECIMALS - USDC_DECIMALS)\n      .toFixed(0),\n    targetChainId: CHAIN_ID_HYPERCORE,\n    targetTokenAddress: SERVER_HYPERCORE_USDC_PERPS_ADDRESS,\n  };\n}\n\nfunction transactionDataReferencesBridge(\n  transaction: Pick<TransactionMeta, 'txParams' | 'nestedTransactions'>,\n): boolean {\n  const fragments: (string | undefined)[] = [\n    transaction.txParams?.to,\n    ...(transaction.nestedTransactions ?? []).map((tx) => tx.to),\n  ];\n\n  return fragments.some(\n    (value) =>\n      typeof value === 'string' &&\n      value.toLowerCase().includes(HYPERLIQUID_BRIDGE_CALLDATA_FRAGMENT),\n  );\n}\n"]}

package/dist/strategy/server/perps.d.cts

@@ -0,0 +1,36 @@
+import type { TransactionMeta } from "@metamask/transaction-controller";
+import type { QuoteRequest } from "../../types.cjs";
+/**
+ * Shared 20-byte sentinel address emitted by the server strategy to flag a
+ * Hyperliquid perps deposit. Backend providers translate this to their own
+ * on-chain destination (e.g. Relay's 16-byte HyperCore USDC sentinel, Across's
+ * native USDC-PERPS token at the same address).
+ */
+export declare const SERVER_HYPERCORE_USDC_PERPS_ADDRESS: `0x${string}`;
+/**
+ * Detect whether a quote request represents a Hyperliquid perps deposit by
+ * sniffing the parent transaction calldata for a reference to the Hyperliquid
+ * bridge contract. Transaction type is intentionally NOT consulted so that any
+ * caller funnelling a bridge deposit through Pay is supported.
+ *
+ * @param request - Quote request from the transaction-pay controller.
+ * @param transaction - Parent transaction whose calldata is inspected.
+ * @returns Whether the request matches a Hyperliquid bridge deposit.
+ */
+export declare function isServerPerpsDepositRequest(request: Pick<QuoteRequest, 'isPostQuote' | 'targetChainId' | 'targetTokenAddress'>, transaction: Pick<TransactionMeta, 'txParams' | 'nestedTransactions'>): boolean;
+/**
+ * Translate a Hyperliquid perps-deposit quote request into the HyperCore
+ * direct-deposit shape with a provider-agnostic sentinel destination. Backend
+ * providers detect the sentinel and rewrite it to their respective on-chain
+ * destinations.
+ *
+ * Transaction pay starts from the parent on-chain asset (Arbitrum USDC,
+ * 6 decimals); HyperCore expects an 8-decimal amount, so the target amount is
+ * shifted accordingly.
+ *
+ * @param request - Quote request from the transaction-pay controller.
+ * @param transaction - Parent transaction whose calldata is inspected.
+ * @returns Normalized request, or the original request if not a perps deposit.
+ */
+export declare function normalizeServerPerpsRequest(request: QuoteRequest, transaction: Pick<TransactionMeta, 'txParams' | 'nestedTransactions'>): QuoteRequest;
+//# sourceMappingURL=perps.d.cts.map

package/dist/strategy/server/perps.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"perps.d.cts","sourceRoot":"","sources":["../../../src/strategy/server/perps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,yCAAyC;AAWxE,OAAO,KAAK,EAAE,YAAY,EAAE,wBAAoB;AAEhD;;;;;GAKG;AACH,eAAO,MAAM,mCAAmC,eACK,CAAC;AAQtD;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,IAAI,CACX,YAAY,EACZ,aAAa,GAAG,eAAe,GAAG,oBAAoB,CACvD,EACD,WAAW,EAAE,IAAI,CAAC,eAAe,EAAE,UAAU,GAAG,oBAAoB,CAAC,GACpE,OAAO,CAWT;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,YAAY,EACrB,WAAW,EAAE,IAAI,CAAC,eAAe,EAAE,UAAU,GAAG,oBAAoB,CAAC,GACpE,YAAY,CAad"}

package/dist/strategy/server/perps.d.mts

@@ -0,0 +1,36 @@
+import type { TransactionMeta } from "@metamask/transaction-controller";
+import type { QuoteRequest } from "../../types.mjs";
+/**
+ * Shared 20-byte sentinel address emitted by the server strategy to flag a
+ * Hyperliquid perps deposit. Backend providers translate this to their own
+ * on-chain destination (e.g. Relay's 16-byte HyperCore USDC sentinel, Across's
+ * native USDC-PERPS token at the same address).
+ */
+export declare const SERVER_HYPERCORE_USDC_PERPS_ADDRESS: `0x${string}`;
+/**
+ * Detect whether a quote request represents a Hyperliquid perps deposit by
+ * sniffing the parent transaction calldata for a reference to the Hyperliquid
+ * bridge contract. Transaction type is intentionally NOT consulted so that any
+ * caller funnelling a bridge deposit through Pay is supported.
+ *
+ * @param request - Quote request from the transaction-pay controller.
+ * @param transaction - Parent transaction whose calldata is inspected.
+ * @returns Whether the request matches a Hyperliquid bridge deposit.
+ */
+export declare function isServerPerpsDepositRequest(request: Pick<QuoteRequest, 'isPostQuote' | 'targetChainId' | 'targetTokenAddress'>, transaction: Pick<TransactionMeta, 'txParams' | 'nestedTransactions'>): boolean;
+/**
+ * Translate a Hyperliquid perps-deposit quote request into the HyperCore
+ * direct-deposit shape with a provider-agnostic sentinel destination. Backend
+ * providers detect the sentinel and rewrite it to their respective on-chain
+ * destinations.
+ *
+ * Transaction pay starts from the parent on-chain asset (Arbitrum USDC,
+ * 6 decimals); HyperCore expects an 8-decimal amount, so the target amount is
+ * shifted accordingly.
+ *
+ * @param request - Quote request from the transaction-pay controller.
+ * @param transaction - Parent transaction whose calldata is inspected.
+ * @returns Normalized request, or the original request if not a perps deposit.
+ */
+export declare function normalizeServerPerpsRequest(request: QuoteRequest, transaction: Pick<TransactionMeta, 'txParams' | 'nestedTransactions'>): QuoteRequest;
+//# sourceMappingURL=perps.d.mts.map

package/dist/strategy/server/perps.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"perps.d.mts","sourceRoot":"","sources":["../../../src/strategy/server/perps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,yCAAyC;AAWxE,OAAO,KAAK,EAAE,YAAY,EAAE,wBAAoB;AAEhD;;;;;GAKG;AACH,eAAO,MAAM,mCAAmC,eACK,CAAC;AAQtD;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,IAAI,CACX,YAAY,EACZ,aAAa,GAAG,eAAe,GAAG,oBAAoB,CACvD,EACD,WAAW,EAAE,IAAI,CAAC,eAAe,EAAE,UAAU,GAAG,oBAAoB,CAAC,GACpE,OAAO,CAWT;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,YAAY,EACrB,WAAW,EAAE,IAAI,CAAC,eAAe,EAAE,UAAU,GAAG,oBAAoB,CAAC,GACpE,YAAY,CAad"}

package/dist/strategy/server/perps.mjs

@@ -0,0 +1,66 @@
+import { BigNumber } from "bignumber.js";
+import { ARBITRUM_USDC_ADDRESS, CHAIN_ID_ARBITRUM, CHAIN_ID_HYPERCORE, HYPERCORE_USDC_DECIMALS, USDC_DECIMALS } from "../../constants.mjs";
+/**
+ * Shared 20-byte sentinel address emitted by the server strategy to flag a
+ * Hyperliquid perps deposit. Backend providers translate this to their own
+ * on-chain destination (e.g. Relay's 16-byte HyperCore USDC sentinel, Across's
+ * native USDC-PERPS token at the same address).
+ */
+export const SERVER_HYPERCORE_USDC_PERPS_ADDRESS = '0x2100000000000000000000000000000000000000';
+const HYPERLIQUID_BRIDGE_ADDRESS_LOWER = '0x2df1c51e09aecf9cacb7bc98cb1742757f163df7';
+const HYPERLIQUID_BRIDGE_CALLDATA_FRAGMENT = HYPERLIQUID_BRIDGE_ADDRESS_LOWER.slice(2);
+/**
+ * Detect whether a quote request represents a Hyperliquid perps deposit by
+ * sniffing the parent transaction calldata for a reference to the Hyperliquid
+ * bridge contract. Transaction type is intentionally NOT consulted so that any
+ * caller funnelling a bridge deposit through Pay is supported.
+ *
+ * @param request - Quote request from the transaction-pay controller.
+ * @param transaction - Parent transaction whose calldata is inspected.
+ * @returns Whether the request matches a Hyperliquid bridge deposit.
+ */
+export function isServerPerpsDepositRequest(request, transaction) {
+    if (request.isPostQuote === true ||
+        request.targetChainId !== CHAIN_ID_ARBITRUM ||
+        request.targetTokenAddress.toLowerCase() !==
+            ARBITRUM_USDC_ADDRESS.toLowerCase()) {
+        return false;
+    }
+    return transactionDataReferencesBridge(transaction);
+}
+/**
+ * Translate a Hyperliquid perps-deposit quote request into the HyperCore
+ * direct-deposit shape with a provider-agnostic sentinel destination. Backend
+ * providers detect the sentinel and rewrite it to their respective on-chain
+ * destinations.
+ *
+ * Transaction pay starts from the parent on-chain asset (Arbitrum USDC,
+ * 6 decimals); HyperCore expects an 8-decimal amount, so the target amount is
+ * shifted accordingly.
+ *
+ * @param request - Quote request from the transaction-pay controller.
+ * @param transaction - Parent transaction whose calldata is inspected.
+ * @returns Normalized request, or the original request if not a perps deposit.
+ */
+export function normalizeServerPerpsRequest(request, transaction) {
+    if (!isServerPerpsDepositRequest(request, transaction)) {
+        return request;
+    }
+    return {
+        ...request,
+        targetAmountMinimum: new BigNumber(request.targetAmountMinimum)
+            .shiftedBy(HYPERCORE_USDC_DECIMALS - USDC_DECIMALS)
+            .toFixed(0),
+        targetChainId: CHAIN_ID_HYPERCORE,
+        targetTokenAddress: SERVER_HYPERCORE_USDC_PERPS_ADDRESS,
+    };
+}
+function transactionDataReferencesBridge(transaction) {
+    const fragments = [
+        transaction.txParams?.to,
+        ...(transaction.nestedTransactions ?? []).map((tx) => tx.to),
+    ];
+    return fragments.some((value) => typeof value === 'string' &&
+        value.toLowerCase().includes(HYPERLIQUID_BRIDGE_CALLDATA_FRAGMENT));
+}
+//# sourceMappingURL=perps.mjs.map

package/dist/strategy/server/perps.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"perps.mjs","sourceRoot":"","sources":["../../../src/strategy/server/perps.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,qBAAqB;AAEzC,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,aAAa,EACd,4BAAwB;AAGzB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAC9C,4CAAmD,CAAC;AAEtD,MAAM,gCAAgC,GACpC,4CAA4C,CAAC;AAE/C,MAAM,oCAAoC,GACxC,gCAAgC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAE5C;;;;;;;;;GASG;AACH,MAAM,UAAU,2BAA2B,CACzC,OAGC,EACD,WAAqE;IAErE,IACE,OAAO,CAAC,WAAW,KAAK,IAAI;QAC5B,OAAO,CAAC,aAAa,KAAK,iBAAiB;QAC3C,OAAO,CAAC,kBAAkB,CAAC,WAAW,EAAE;YACtC,qBAAqB,CAAC,WAAW,EAAE,EACrC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,+BAA+B,CAAC,WAAW,CAAC,CAAC;AACtD,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,2BAA2B,CACzC,OAAqB,EACrB,WAAqE;IAErE,IAAI,CAAC,2BAA2B,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,CAAC;QACvD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO;QACL,GAAG,OAAO;QACV,mBAAmB,EAAE,IAAI,SAAS,CAAC,OAAO,CAAC,mBAAmB,CAAC;aAC5D,SAAS,CAAC,uBAAuB,GAAG,aAAa,CAAC;aAClD,OAAO,CAAC,CAAC,CAAC;QACb,aAAa,EAAE,kBAAkB;QACjC,kBAAkB,EAAE,mCAAmC;KACxD,CAAC;AACJ,CAAC;AAED,SAAS,+BAA+B,CACtC,WAAqE;IAErE,MAAM,SAAS,GAA2B;QACxC,WAAW,CAAC,QAAQ,EAAE,EAAE;QACxB,GAAG,CAAC,WAAW,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;KAC7D,CAAC;IAEF,OAAO,SAAS,CAAC,IAAI,CACnB,CAAC,KAAK,EAAE,EAAE,CACR,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC,CACrE,CAAC;AACJ,CAAC","sourcesContent":["import type { TransactionMeta } from '@metamask/transaction-controller';\nimport type { Hex } from '@metamask/utils';\nimport { BigNumber } from 'bignumber.js';\n\nimport {\n  ARBITRUM_USDC_ADDRESS,\n  CHAIN_ID_ARBITRUM,\n  CHAIN_ID_HYPERCORE,\n  HYPERCORE_USDC_DECIMALS,\n  USDC_DECIMALS,\n} from '../../constants';\nimport type { QuoteRequest } from '../../types';\n\n/**\n * Shared 20-byte sentinel address emitted by the server strategy to flag a\n * Hyperliquid perps deposit. Backend providers translate this to their own\n * on-chain destination (e.g. Relay's 16-byte HyperCore USDC sentinel, Across's\n * native USDC-PERPS token at the same address).\n */\nexport const SERVER_HYPERCORE_USDC_PERPS_ADDRESS =\n  '0x2100000000000000000000000000000000000000' as Hex;\n\nconst HYPERLIQUID_BRIDGE_ADDRESS_LOWER =\n  '0x2df1c51e09aecf9cacb7bc98cb1742757f163df7';\n\nconst HYPERLIQUID_BRIDGE_CALLDATA_FRAGMENT =\n  HYPERLIQUID_BRIDGE_ADDRESS_LOWER.slice(2);\n\n/**\n * Detect whether a quote request represents a Hyperliquid perps deposit by\n * sniffing the parent transaction calldata for a reference to the Hyperliquid\n * bridge contract. Transaction type is intentionally NOT consulted so that any\n * caller funnelling a bridge deposit through Pay is supported.\n *\n * @param request - Quote request from the transaction-pay controller.\n * @param transaction - Parent transaction whose calldata is inspected.\n * @returns Whether the request matches a Hyperliquid bridge deposit.\n */\nexport function isServerPerpsDepositRequest(\n  request: Pick<\n    QuoteRequest,\n    'isPostQuote' | 'targetChainId' | 'targetTokenAddress'\n  >,\n  transaction: Pick<TransactionMeta, 'txParams' | 'nestedTransactions'>,\n): boolean {\n  if (\n    request.isPostQuote === true ||\n    request.targetChainId !== CHAIN_ID_ARBITRUM ||\n    request.targetTokenAddress.toLowerCase() !==\n      ARBITRUM_USDC_ADDRESS.toLowerCase()\n  ) {\n    return false;\n  }\n\n  return transactionDataReferencesBridge(transaction);\n}\n\n/**\n * Translate a Hyperliquid perps-deposit quote request into the HyperCore\n * direct-deposit shape with a provider-agnostic sentinel destination. Backend\n * providers detect the sentinel and rewrite it to their respective on-chain\n * destinations.\n *\n * Transaction pay starts from the parent on-chain asset (Arbitrum USDC,\n * 6 decimals); HyperCore expects an 8-decimal amount, so the target amount is\n * shifted accordingly.\n *\n * @param request - Quote request from the transaction-pay controller.\n * @param transaction - Parent transaction whose calldata is inspected.\n * @returns Normalized request, or the original request if not a perps deposit.\n */\nexport function normalizeServerPerpsRequest(\n  request: QuoteRequest,\n  transaction: Pick<TransactionMeta, 'txParams' | 'nestedTransactions'>,\n): QuoteRequest {\n  if (!isServerPerpsDepositRequest(request, transaction)) {\n    return request;\n  }\n\n  return {\n    ...request,\n    targetAmountMinimum: new BigNumber(request.targetAmountMinimum)\n      .shiftedBy(HYPERCORE_USDC_DECIMALS - USDC_DECIMALS)\n      .toFixed(0),\n    targetChainId: CHAIN_ID_HYPERCORE,\n    targetTokenAddress: SERVER_HYPERCORE_USDC_PERPS_ADDRESS,\n  };\n}\n\nfunction transactionDataReferencesBridge(\n  transaction: Pick<TransactionMeta, 'txParams' | 'nestedTransactions'>,\n): boolean {\n  const fragments: (string | undefined)[] = [\n    transaction.txParams?.to,\n    ...(transaction.nestedTransactions ?? []).map((tx) => tx.to),\n  ];\n\n  return fragments.some(\n    (value) =>\n      typeof value === 'string' &&\n      value.toLowerCase().includes(HYPERLIQUID_BRIDGE_CALLDATA_FRAGMENT),\n  );\n}\n"]}

package/dist/strategy/server/server-api.cjs

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getServerStatus = exports.submitServerIntent = exports.fetchServerQuote = void 0;
+const utils_1 = require("@metamask/utils");
+const logger_1 = require("../../logger.cjs");
+const feature_flags_1 = require("../../utils/feature-flags.cjs");
+const log = (0, utils_1.createModuleLogger)(logger_1.projectLogger, 'server-api');
+/**
+ * Fetch a quote from the server intents API.
+ *
+ * @param messenger - Controller messenger.
+ * @param body - Quote request parameters.
+ * @param signal - Optional abort signal that cancels the underlying fetch.
+ * @returns The server quote response.
+ */
+async function fetchServerQuote(messenger, body, signal) {
+    const { server } = (0, feature_flags_1.getPayStrategiesConfig)(messenger);
+    const quoteUrl = `${server.baseUrl}/quote`;
+    log('Fetching quote', { url: quoteUrl });
+    const response = await serverFetch(quoteUrl, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(body),
+        signal,
+    });
+    return (await response.json());
+}
+exports.fetchServerQuote = fetchServerQuote;
+/**
+ * Submit a gasless intent via the server intents API.
+ *
+ * @param messenger - Controller messenger.
+ * @param body - Submit request parameters.
+ * @returns The submit response.
+ */
+async function submitServerIntent(messenger, body) {
+    const { server } = (0, feature_flags_1.getPayStrategiesConfig)(messenger);
+    const submitUrl = `${server.baseUrl}/submit`;
+    log('Submitting intent', { url: submitUrl });
+    const response = await serverFetch(submitUrl, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(body),
+    });
+    return (await response.json());
+}
+exports.submitServerIntent = submitServerIntent;
+/**
+ * Fetch the status of a server intent.
+ *
+ * @param messenger - Controller messenger.
+ * @param params - Status query parameters.
+ * @param params.provider - The provider that the intent was submitted to.
+ * @param params.id - The intent ID.
+ * @param params.hash - Optional transaction hash to include in the status query.
+ * @returns The current status of the intent.
+ */
+async function getServerStatus(messenger, params) {
+    const { server } = (0, feature_flags_1.getPayStrategiesConfig)(messenger);
+    const query = new URLSearchParams({
+        provider: params.provider,
+        id: params.id,
+    });
+    if (params.hash) {
+        query.set('hash', params.hash);
+    }
+    const url = `${server.baseUrl}/status?${query.toString()}`;
+    log('Fetching status', { url });
+    const response = await serverFetch(url, { method: 'GET' });
+    return (await response.json());
+}
+exports.getServerStatus = getServerStatus;
+/**
+ * Fetch a server intents-api endpoint, throwing an error containing the
+ * response body's `message` or `error` field (or status code) on non-OK
+ * responses so the server's actual reason is preserved without leaking the
+ * request URL.
+ *
+ * @param url - The endpoint to fetch.
+ * @param init - Fetch init options.
+ * @returns The successful response.
+ */
+async function serverFetch(url, init) {
+    const response = await fetch(url, init);
+    if (!response.ok) {
+        let detail;
+        try {
+            const body = (await response.json());
+            detail = body.message ?? body.error;
+        }
+        catch {
+            // Body wasn't JSON; fall through to status-only error.
+        }
+        throw new Error(detail ? `${response.status} - ${detail}` : String(response.status));
+    }
+    return response;
+}
+//# sourceMappingURL=server-api.cjs.map

package/dist/strategy/server/server-api.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-api.cjs","sourceRoot":"","sources":["../../../src/strategy/server/server-api.ts"],"names":[],"mappings":";;;AAAA,2CAAqD;AAErD,6CAA6C;AAE7C,iEAAmE;AAUnE,MAAM,GAAG,GAAG,IAAA,0BAAkB,EAAC,sBAAa,EAAE,YAAY,CAAC,CAAC;AAE5D;;;;;;;GAOG;AACI,KAAK,UAAU,gBAAgB,CACpC,SAA4C,EAC5C,IAAwB,EACxB,MAAoB;IAEpB,MAAM,EAAE,MAAM,EAAE,GAAG,IAAA,sCAAsB,EAAC,SAAS,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,GAAG,MAAM,CAAC,OAAO,QAAQ,CAAC;IAE3C,GAAG,CAAC,gBAAgB,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;IAEzC,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE;QAC3C,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;QAC1B,MAAM;KACP,CAAC,CAAC;IAEH,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAwB,CAAC;AACxD,CAAC;AAlBD,4CAkBC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,kBAAkB,CACtC,SAA4C,EAC5C,IAAyB;IAEzB,MAAM,EAAE,MAAM,EAAE,GAAG,IAAA,sCAAsB,EAAC,SAAS,CAAC,CAAC;IACrD,MAAM,SAAS,GAAG,GAAG,MAAM,CAAC,OAAO,SAAS,CAAC;IAE7C,GAAG,CAAC,mBAAmB,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;IAE7C,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,SAAS,EAAE;QAC5C,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;KAC3B,CAAC,CAAC;IAEH,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAyB,CAAC;AACzD,CAAC;AAhBD,gDAgBC;AAED;;;;;;;;;GASG;AACI,KAAK,UAAU,eAAe,CACnC,SAA4C,EAC5C,MAAmE;IAEnE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAA,sCAAsB,EAAC,SAAS,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,IAAI,eAAe,CAAC;QAChC,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,EAAE,EAAE,MAAM,CAAC,EAAE;KACd,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IACD,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC;IAE3D,GAAG,CAAC,iBAAiB,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IAEhC,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAE3D,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAyB,CAAC;AACzD,CAAC;AAnBD,0CAmBC;AAED;;;;;;;;;GASG;AACH,KAAK,UAAU,WAAW,CAAC,GAAW,EAAE,IAAkB;IACxD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAExC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,IAAI,MAA0B,CAAC;QAC/B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAGlC,CAAC;YACF,MAAM,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC;QACtC,CAAC;QAAC,MAAM,CAAC;YACP,uDAAuD;QACzD,CAAC;QACD,MAAM,IAAI,KAAK,CACb,MAAM,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,MAAM,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CACpE,CAAC;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC","sourcesContent":["import { createModuleLogger } from '@metamask/utils';\n\nimport { projectLogger } from '../../logger';\nimport type { TransactionPayControllerMessenger } from '../../types';\nimport { getPayStrategiesConfig } from '../../utils/feature-flags';\nimport type {\n  ServerProviderName,\n  ServerQuoteRequest,\n  ServerQuoteResponse,\n  ServerStatusResponse,\n  ServerSubmitRequest,\n  ServerSubmitResponse,\n} from './types';\n\nconst log = createModuleLogger(projectLogger, 'server-api');\n\n/**\n * Fetch a quote from the server intents API.\n *\n * @param messenger - Controller messenger.\n * @param body - Quote request parameters.\n * @param signal - Optional abort signal that cancels the underlying fetch.\n * @returns The server quote response.\n */\nexport async function fetchServerQuote(\n  messenger: TransactionPayControllerMessenger,\n  body: ServerQuoteRequest,\n  signal?: AbortSignal,\n): Promise<ServerQuoteResponse> {\n  const { server } = getPayStrategiesConfig(messenger);\n  const quoteUrl = `${server.baseUrl}/quote`;\n\n  log('Fetching quote', { url: quoteUrl });\n\n  const response = await serverFetch(quoteUrl, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json' },\n    body: JSON.stringify(body),\n    signal,\n  });\n\n  return (await response.json()) as ServerQuoteResponse;\n}\n\n/**\n * Submit a gasless intent via the server intents API.\n *\n * @param messenger - Controller messenger.\n * @param body - Submit request parameters.\n * @returns The submit response.\n */\nexport async function submitServerIntent(\n  messenger: TransactionPayControllerMessenger,\n  body: ServerSubmitRequest,\n): Promise<ServerSubmitResponse> {\n  const { server } = getPayStrategiesConfig(messenger);\n  const submitUrl = `${server.baseUrl}/submit`;\n\n  log('Submitting intent', { url: submitUrl });\n\n  const response = await serverFetch(submitUrl, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json' },\n    body: JSON.stringify(body),\n  });\n\n  return (await response.json()) as ServerSubmitResponse;\n}\n\n/**\n * Fetch the status of a server intent.\n *\n * @param messenger - Controller messenger.\n * @param params - Status query parameters.\n * @param params.provider - The provider that the intent was submitted to.\n * @param params.id - The intent ID.\n * @param params.hash - Optional transaction hash to include in the status query.\n * @returns The current status of the intent.\n */\nexport async function getServerStatus(\n  messenger: TransactionPayControllerMessenger,\n  params: { provider: ServerProviderName; id: string; hash?: string },\n): Promise<ServerStatusResponse> {\n  const { server } = getPayStrategiesConfig(messenger);\n  const query = new URLSearchParams({\n    provider: params.provider,\n    id: params.id,\n  });\n  if (params.hash) {\n    query.set('hash', params.hash);\n  }\n  const url = `${server.baseUrl}/status?${query.toString()}`;\n\n  log('Fetching status', { url });\n\n  const response = await serverFetch(url, { method: 'GET' });\n\n  return (await response.json()) as ServerStatusResponse;\n}\n\n/**\n * Fetch a server intents-api endpoint, throwing an error containing the\n * response body's `message` or `error` field (or status code) on non-OK\n * responses so the server's actual reason is preserved without leaking the\n * request URL.\n *\n * @param url - The endpoint to fetch.\n * @param init - Fetch init options.\n * @returns The successful response.\n */\nasync function serverFetch(url: string, init?: RequestInit): Promise<Response> {\n  const response = await fetch(url, init);\n\n  if (!response.ok) {\n    let detail: string | undefined;\n    try {\n      const body = (await response.json()) as {\n        message?: string;\n        error?: string;\n      };\n      detail = body.message ?? body.error;\n    } catch {\n      // Body wasn't JSON; fall through to status-only error.\n    }\n    throw new Error(\n      detail ? `${response.status} - ${detail}` : String(response.status),\n    );\n  }\n\n  return response;\n}\n"]}

package/dist/strategy/server/server-api.d.cts

@@ -0,0 +1,35 @@
+import type { TransactionPayControllerMessenger } from "../../types.cjs";
+import type { ServerProviderName, ServerQuoteRequest, ServerQuoteResponse, ServerStatusResponse, ServerSubmitRequest, ServerSubmitResponse } from "./types.cjs";
+/**
+ * Fetch a quote from the server intents API.
+ *
+ * @param messenger - Controller messenger.
+ * @param body - Quote request parameters.
+ * @param signal - Optional abort signal that cancels the underlying fetch.
+ * @returns The server quote response.
+ */
+export declare function fetchServerQuote(messenger: TransactionPayControllerMessenger, body: ServerQuoteRequest, signal?: AbortSignal): Promise<ServerQuoteResponse>;
+/**
+ * Submit a gasless intent via the server intents API.
+ *
+ * @param messenger - Controller messenger.
+ * @param body - Submit request parameters.
+ * @returns The submit response.
+ */
+export declare function submitServerIntent(messenger: TransactionPayControllerMessenger, body: ServerSubmitRequest): Promise<ServerSubmitResponse>;
+/**
+ * Fetch the status of a server intent.
+ *
+ * @param messenger - Controller messenger.
+ * @param params - Status query parameters.
+ * @param params.provider - The provider that the intent was submitted to.
+ * @param params.id - The intent ID.
+ * @param params.hash - Optional transaction hash to include in the status query.
+ * @returns The current status of the intent.
+ */
+export declare function getServerStatus(messenger: TransactionPayControllerMessenger, params: {
+    provider: ServerProviderName;
+    id: string;
+    hash?: string;
+}): Promise<ServerStatusResponse>;
+//# sourceMappingURL=server-api.d.cts.map

package/dist/strategy/server/server-api.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-api.d.cts","sourceRoot":"","sources":["../../../src/strategy/server/server-api.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iCAAiC,EAAE,wBAAoB;AAErE,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACrB,oBAAgB;AAIjB;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,iCAAiC,EAC5C,IAAI,EAAE,kBAAkB,EACxB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,mBAAmB,CAAC,CAc9B;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,iCAAiC,EAC5C,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,oBAAoB,CAAC,CAa/B;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,iCAAiC,EAC5C,MAAM,EAAE;IAAE,QAAQ,EAAE,kBAAkB,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAClE,OAAO,CAAC,oBAAoB,CAAC,CAgB/B"}

package/dist/strategy/server/server-api.d.mts

@@ -0,0 +1,35 @@
+import type { TransactionPayControllerMessenger } from "../../types.mjs";
+import type { ServerProviderName, ServerQuoteRequest, ServerQuoteResponse, ServerStatusResponse, ServerSubmitRequest, ServerSubmitResponse } from "./types.mjs";
+/**
+ * Fetch a quote from the server intents API.
+ *
+ * @param messenger - Controller messenger.
+ * @param body - Quote request parameters.
+ * @param signal - Optional abort signal that cancels the underlying fetch.
+ * @returns The server quote response.
+ */
+export declare function fetchServerQuote(messenger: TransactionPayControllerMessenger, body: ServerQuoteRequest, signal?: AbortSignal): Promise<ServerQuoteResponse>;
+/**
+ * Submit a gasless intent via the server intents API.
+ *
+ * @param messenger - Controller messenger.
+ * @param body - Submit request parameters.
+ * @returns The submit response.
+ */
+export declare function submitServerIntent(messenger: TransactionPayControllerMessenger, body: ServerSubmitRequest): Promise<ServerSubmitResponse>;
+/**
+ * Fetch the status of a server intent.
+ *
+ * @param messenger - Controller messenger.
+ * @param params - Status query parameters.
+ * @param params.provider - The provider that the intent was submitted to.
+ * @param params.id - The intent ID.
+ * @param params.hash - Optional transaction hash to include in the status query.
+ * @returns The current status of the intent.
+ */
+export declare function getServerStatus(messenger: TransactionPayControllerMessenger, params: {
+    provider: ServerProviderName;
+    id: string;
+    hash?: string;
+}): Promise<ServerStatusResponse>;
+//# sourceMappingURL=server-api.d.mts.map

package/dist/strategy/server/server-api.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-api.d.mts","sourceRoot":"","sources":["../../../src/strategy/server/server-api.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iCAAiC,EAAE,wBAAoB;AAErE,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACrB,oBAAgB;AAIjB;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,iCAAiC,EAC5C,IAAI,EAAE,kBAAkB,EACxB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,mBAAmB,CAAC,CAc9B;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,iCAAiC,EAC5C,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,oBAAoB,CAAC,CAa/B;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,iCAAiC,EAC5C,MAAM,EAAE;IAAE,QAAQ,EAAE,kBAAkB,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAClE,OAAO,CAAC,oBAAoB,CAAC,CAgB/B"}