@metamask-previews/sentinel-api-service 0.0.0-preview-d34fa10c8

package/dist/sentinel-api-service.mjs

@@ -0,0 +1,312 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _SentinelApiService_instances, _SentinelApiService_fetch, _SentinelApiService_clientId, _SentinelApiService_clientVersion, _SentinelApiService_environmentDomain, _SentinelApiService_jsonRpc, _SentinelApiService_getHeaders, _SentinelApiService_resolveUrl, _SentinelApiService_getNetwork, _SentinelApiService_buildUrl;
+import { BaseDataService } from "@metamask/base-data-service";
+import { handleWhen, HttpError } from "@metamask/controller-utils";
+import { validate } from "@metamask/superstruct";
+import { BASE_URL_TEMPLATE, DEFAULT_ENVIRONMENT, ENDPOINT_NETWORKS, ENDPOINT_SMART_TRANSACTIONS, ENVIRONMENT_DOMAIN, NETWORKS_STALE_TIME_MS, NETWORKS_SUBDOMAIN, RPC_METHOD_SEND_RELAY, RPC_METHOD_SIMULATE, serviceName } from "./constants.mjs";
+import { SentinelApiResponseValidationError, SentinelChainNotSupportedError, SentinelJsonRpcError } from "./errors.mjs";
+import { projectLogger, createModuleLogger } from "./logger.mjs";
+import { SentinelSmartTransactionResponseStruct, SentinelNetworkRegistryStruct, SentinelRelaySubmitResponseStruct, SentinelSimulationResponseStruct } from "./structs.mjs";
+const log = createModuleLogger(projectLogger, serviceName);
+const MESSENGER_EXPOSED_METHODS = [
+    'getNetworks',
+    'simulateTransactions',
+    'submitRelayTransaction',
+    'getSmartTransaction',
+];
+/**
+ * Data service that centralises all interactions with the MetaMask Sentinel
+ * API (`tx-sentinel-<network>.api.cx.metamask.io`).
+ *
+ * It exposes one method per Sentinel endpoint:
+ * - {@link SentinelApiService.getNetworks} — the supported-network registry
+ * (`/networks`), cached since it is stable and identical across subdomains.
+ * - {@link SentinelApiService.simulateTransactions} — transaction simulation
+ * (`infura_simulateTransactions`), used by `@metamask/transaction-controller`
+ * and `@metamask/transaction-pay-controller`.
+ * - {@link SentinelApiService.submitRelayTransaction} — gas station relay
+ * submission (`eth_sendRelayTransaction`), used by the extension and mobile.
+ * - {@link SentinelApiService.getSmartTransaction} — smart-transaction status
+ * lookup (`/smart-transactions/{uuid}`).
+ *
+ * Consumers derive higher-level concerns (whether a chain supports simulation
+ * or relay, polling loops, etc.) from the raw endpoint responses.
+ */
+export class SentinelApiService extends BaseDataService {
+    /**
+     * Constructs a new SentinelApiService.
+     *
+     * @param options - The constructor options. See
+     * {@link SentinelApiServiceOptions}.
+     * @param options.messenger - The messenger suited for this service.
+     * @param options.fetch - The `fetch` function to use for requests. Defaults
+     * to the global `fetch`.
+     * @param options.environment - The Sentinel API environment to target
+     * (`dev`, `uat`, or `prod`). Defaults to `prod`.
+     * @param options.clientId - Identifier for the calling client (for example
+     * `extension` or `mobile`), sent as the `X-Client-Id` header.
+     * @param options.clientVersion - Version of the calling client, sent as the
+     * `X-Client-Version` header when provided.
+     * @param options.queryClientConfig - Configuration for the underlying
+     * TanStack Query client.
+     * @param options.policyOptions - Options to pass to `createServicePolicy`.
+     * Retries are disabled by default (`maxRetries: 0`) to preserve the
+     * single-attempt behaviour of the clients this service replaces; pass
+     * `maxRetries` here to opt in.
+     */
+    constructor({ messenger, fetch: fetchFunction = globalThis.fetch, environment = DEFAULT_ENVIRONMENT, clientId, clientVersion, queryClientConfig = {}, policyOptions = {}, }) {
+        super({
+            name: serviceName,
+            messenger,
+            queryClientConfig,
+            policyOptions: {
+                // Disable retries by default so the service is behaviourally
+                // backwards-compatible with the single-request clients it replaces.
+                // Callers can override via `policyOptions.maxRetries`.
+                maxRetries: 0,
+                retryFilterPolicy: handleWhen((error) => !(error instanceof SentinelApiResponseValidationError) &&
+                    !(error instanceof SentinelChainNotSupportedError) &&
+                    !(error instanceof SentinelJsonRpcError)),
+                ...policyOptions,
+            },
+        });
+        _SentinelApiService_instances.add(this);
+        _SentinelApiService_fetch.set(this, void 0);
+        _SentinelApiService_clientId.set(this, void 0);
+        _SentinelApiService_clientVersion.set(this, void 0);
+        _SentinelApiService_environmentDomain.set(this, void 0);
+        __classPrivateFieldSet(this, _SentinelApiService_fetch, fetchFunction, "f");
+        __classPrivateFieldSet(this, _SentinelApiService_environmentDomain, ENVIRONMENT_DOMAIN[environment], "f");
+        __classPrivateFieldSet(this, _SentinelApiService_clientId, clientId, "f");
+        __classPrivateFieldSet(this, _SentinelApiService_clientVersion, clientVersion, "f");
+        this.messenger.registerMethodActionHandlers(this, MESSENGER_EXPOSED_METHODS);
+        log('Initialized');
+    }
+    /**
+     * Fetches the Sentinel supported-network registry. The result is cached, as
+     * the registry is stable and identical across network subdomains.
+     *
+     * @returns The network registry, keyed by decimal chain ID.
+     */
+    async getNetworks() {
+        const url = `${__classPrivateFieldGet(this, _SentinelApiService_instances, "m", _SentinelApiService_buildUrl).call(this, NETWORKS_SUBDOMAIN)}${ENDPOINT_NETWORKS}`;
+        const result = await this.fetchQuery({
+            queryKey: [`${this.name}:getNetworks`],
+            staleTime: NETWORKS_STALE_TIME_MS,
+            queryFn: async () => {
+                const headers = await __classPrivateFieldGet(this, _SentinelApiService_instances, "m", _SentinelApiService_getHeaders).call(this);
+                log('getNetworks', 'Request', url);
+                const response = await __classPrivateFieldGet(this, _SentinelApiService_fetch, "f").call(this, url, { headers });
+                if (!response.ok) {
+                    throw new HttpError(response.status, `Sentinel API: Networks request failed with status '${response.status}'`);
+                }
+                const json = await response.json();
+                const [error] = validate(json, SentinelNetworkRegistryStruct);
+                if (error) {
+                    throw new SentinelApiResponseValidationError(`Sentinel API: Malformed response from networks endpoint: ${error.message}`);
+                }
+                log('getNetworks', 'Response', json);
+                return json;
+            },
+        });
+        return result;
+    }
+    /**
+     * Simulates transactions against the Sentinel API via
+     * `infura_simulateTransactions`. Not cached, since each request body is
+     * unique and stale simulations must not be reused.
+     *
+     * @param chainId - The chain ID to simulate on.
+     * @param request - The simulation request.
+     * @param options - Additional options.
+     * @param options.getUrl - Optional callback that receives the default
+     * Sentinel URL resolved for the chain and returns the URL to use instead.
+     * Lets consumers rewrite the request URL (for example to route through the
+     * MetaMask Shield proxy) without the service knowing about those concerns.
+     * @returns The simulation response.
+     */
+    async simulateTransactions(chainId, request, options = {}) {
+        const defaultUrl = await __classPrivateFieldGet(this, _SentinelApiService_instances, "m", _SentinelApiService_resolveUrl).call(this, chainId, 'confirmations');
+        const url = options.getUrl ? await options.getUrl(defaultUrl) : defaultUrl;
+        const result = await this.fetchQuery({
+            queryKey: [`${this.name}:simulateTransactions`, chainId, request, url],
+            staleTime: 0,
+            queryFn: async () => {
+                log('simulateTransactions', 'Request', url, request);
+                const rpcResult = await __classPrivateFieldGet(this, _SentinelApiService_instances, "m", _SentinelApiService_jsonRpc).call(this, url, RPC_METHOD_SIMULATE, [
+                    request,
+                ]);
+                const [error] = validate(rpcResult, SentinelSimulationResponseStruct);
+                if (error) {
+                    throw new SentinelApiResponseValidationError(`Sentinel API: Malformed response from simulation endpoint: ${error.message}`);
+                }
+                log('simulateTransactions', 'Response', rpcResult);
+                return rpcResult;
+            },
+        });
+        return result;
+    }
+    /**
+     * Submits a signed relay (gas station) transaction to the Sentinel API via
+     * `eth_sendRelayTransaction`. Not cached.
+     *
+     * @param request - The relay submit request.
+     * @returns The relay submit response containing the tracking UUID.
+     */
+    async submitRelayTransaction(request) {
+        const url = await __classPrivateFieldGet(this, _SentinelApiService_instances, "m", _SentinelApiService_resolveUrl).call(this, request.chainId, 'relayTransactions');
+        const result = await this.fetchQuery({
+            queryKey: [`${this.name}:submitRelayTransaction`, request],
+            staleTime: 0,
+            queryFn: async () => {
+                log('submitRelayTransaction', 'Request', url, request);
+                const rpcResult = await __classPrivateFieldGet(this, _SentinelApiService_instances, "m", _SentinelApiService_jsonRpc).call(this, url, RPC_METHOD_SEND_RELAY, [
+                    request,
+                ]);
+                const [error] = validate(rpcResult, SentinelRelaySubmitResponseStruct);
+                if (error) {
+                    throw new SentinelApiResponseValidationError(`Sentinel API: Malformed response from relay submit endpoint: ${error.message}`);
+                }
+                log('submitRelayTransaction', 'Response', rpcResult);
+                return rpcResult;
+            },
+        });
+        return result;
+    }
+    /**
+     * Looks up the state of a submitted smart transaction by UUID against the
+     * `/smart-transactions/{uuid}` endpoint. Performs a single request; callers
+     * own any polling loop. Not cached.
+     *
+     * @param request - The smart-transaction lookup request.
+     * @returns The response envelope containing the smart transaction(s)
+     * associated with the requested UUID.
+     */
+    async getSmartTransaction(request) {
+        const { chainId, uuid } = request;
+        const baseUrl = await __classPrivateFieldGet(this, _SentinelApiService_instances, "m", _SentinelApiService_resolveUrl).call(this, chainId, 'relayTransactions');
+        const url = `${baseUrl}${ENDPOINT_SMART_TRANSACTIONS}/${uuid}`;
+        const result = await this.fetchQuery({
+            queryKey: [`${this.name}:getSmartTransaction`, chainId, uuid],
+            staleTime: 0,
+            queryFn: async () => {
+                const headers = await __classPrivateFieldGet(this, _SentinelApiService_instances, "m", _SentinelApiService_getHeaders).call(this);
+                log('getSmartTransaction', 'Request', url);
+                const response = await __classPrivateFieldGet(this, _SentinelApiService_fetch, "f").call(this, url, { headers });
+                if (!response.ok) {
+                    throw new HttpError(response.status, `Sentinel API: Smart-transaction request failed with status '${response.status}'`);
+                }
+                const json = await response.json();
+                const [error] = validate(json, SentinelSmartTransactionResponseStruct);
+                if (error) {
+                    throw new SentinelApiResponseValidationError(`Sentinel API: Malformed response from smart-transactions endpoint: ${error.message}`);
+                }
+                log('getSmartTransaction', 'Response', json);
+                return json;
+            },
+        });
+        return result;
+    }
+}
+_SentinelApiService_fetch = new WeakMap(), _SentinelApiService_clientId = new WeakMap(), _SentinelApiService_clientVersion = new WeakMap(), _SentinelApiService_environmentDomain = new WeakMap(), _SentinelApiService_instances = new WeakSet(), _SentinelApiService_jsonRpc = 
+/**
+ * Performs a JSON-RPC POST to the Sentinel API and returns the `result`.
+ *
+ * @param url - The URL to post to.
+ * @param method - The JSON-RPC method name.
+ * @param params - The JSON-RPC params.
+ * @returns The `result` field of the JSON-RPC response.
+ */
+async function _SentinelApiService_jsonRpc(url, method, params) {
+    const headers = await __classPrivateFieldGet(this, _SentinelApiService_instances, "m", _SentinelApiService_getHeaders).call(this);
+    const response = await __classPrivateFieldGet(this, _SentinelApiService_fetch, "f").call(this, url, {
+        method: 'POST',
+        headers: {
+            ...headers,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({
+            id: '1',
+            jsonrpc: '2.0',
+            method,
+            params,
+        }),
+    });
+    if (!response.ok) {
+        throw new HttpError(response.status, `Sentinel API: JSON-RPC request '${method}' failed with status '${response.status}'`);
+    }
+    const responseJson = (await response.json());
+    if (responseJson.error) {
+        const { code, message } = responseJson.error;
+        throw new SentinelJsonRpcError(`Sentinel API: JSON-RPC error: ${message}`, code);
+    }
+    if (responseJson.result === undefined) {
+        throw new SentinelJsonRpcError('Sentinel API: JSON-RPC response missing result', -32603);
+    }
+    return responseJson.result;
+}, _SentinelApiService_getHeaders = 
+/**
+ * Builds the outbound headers for a Sentinel request: the client identity
+ * headers plus a best-effort `Authorization` bearer token. Token retrieval
+ * failures are swallowed so unauthenticated requests still proceed.
+ *
+ * @returns The headers to attach to the request.
+ */
+async function _SentinelApiService_getHeaders() {
+    const headers = {};
+    if (__classPrivateFieldGet(this, _SentinelApiService_clientId, "f") !== undefined) {
+        headers['X-Client-Id'] = __classPrivateFieldGet(this, _SentinelApiService_clientId, "f");
+    }
+    if (__classPrivateFieldGet(this, _SentinelApiService_clientVersion, "f") !== undefined) {
+        headers['X-Client-Version'] = __classPrivateFieldGet(this, _SentinelApiService_clientVersion, "f");
+    }
+    try {
+        const token = await this.messenger.call('AuthenticationController:getBearerToken');
+        if (token) {
+            headers.Authorization = `Bearer ${token}`;
+        }
+    }
+    catch (error) {
+        // Proceed without auth if token retrieval fails.
+        log('getHeaders', 'Auth token unavailable, proceeding unauthenticated', error);
+    }
+    return headers;
+}, _SentinelApiService_resolveUrl = 
+/**
+ * Resolves the Sentinel URL for a chain, asserting the required capability.
+ *
+ * @param chainId - The chain ID to resolve a URL for.
+ * @param capability - The capability flag that must be enabled.
+ * @returns The resolved base URL.
+ */
+async function _SentinelApiService_resolveUrl(chainId, capability) {
+    const network = await __classPrivateFieldGet(this, _SentinelApiService_instances, "m", _SentinelApiService_getNetwork).call(this, chainId);
+    if (!network?.[capability]) {
+        throw new SentinelChainNotSupportedError(chainId, capability);
+    }
+    return __classPrivateFieldGet(this, _SentinelApiService_instances, "m", _SentinelApiService_buildUrl).call(this, network.network);
+}, _SentinelApiService_getNetwork = 
+/**
+ * Looks up a single network entry from the registry by chain ID.
+ *
+ * @param chainId - The chain ID to look up.
+ * @returns The network entry, or undefined if not present.
+ */
+async function _SentinelApiService_getNetwork(chainId) {
+    const registry = await this.getNetworks();
+    const chainIdDecimal = BigInt(chainId).toString(10);
+    return registry[chainIdDecimal];
+}, _SentinelApiService_buildUrl = function _SentinelApiService_buildUrl(subdomain) {
+    return BASE_URL_TEMPLATE.replace('{0}', subdomain).replace('{1}', __classPrivateFieldGet(this, _SentinelApiService_environmentDomain, "f"));
+};
+//# sourceMappingURL=sentinel-api-service.mjs.map

package/dist/sentinel-api-service.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sentinel-api-service.mjs","sourceRoot":"","sources":["../src/sentinel-api-service.ts"],"names":[],"mappings":"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","sourcesContent":["import { BaseDataService } from '@metamask/base-data-service';\nimport { handleWhen, HttpError } from '@metamask/controller-utils';\nimport { validate } from '@metamask/superstruct';\nimport type { Hex, Json } from '@metamask/utils';\n\nimport {\n  BASE_URL_TEMPLATE,\n  DEFAULT_ENVIRONMENT,\n  ENDPOINT_NETWORKS,\n  ENDPOINT_SMART_TRANSACTIONS,\n  ENVIRONMENT_DOMAIN,\n  NETWORKS_STALE_TIME_MS,\n  NETWORKS_SUBDOMAIN,\n  RPC_METHOD_SEND_RELAY,\n  RPC_METHOD_SIMULATE,\n  serviceName,\n} from './constants';\nimport {\n  SentinelApiResponseValidationError,\n  SentinelChainNotSupportedError,\n  SentinelJsonRpcError,\n} from './errors';\nimport { projectLogger, createModuleLogger } from './logger';\nimport {\n  SentinelSmartTransactionResponseStruct,\n  SentinelNetworkRegistryStruct,\n  SentinelRelaySubmitResponseStruct,\n  SentinelSimulationResponseStruct,\n} from './structs';\nimport type {\n  SentinelApiServiceMessenger,\n  SentinelApiServiceOptions,\n  SentinelNetwork,\n  SentinelNetworkRegistry,\n  SentinelRelaySubmitRequest,\n  SentinelRelaySubmitResponse,\n  SentinelSimulationRequest,\n  SentinelSimulationResponse,\n  SentinelSmartTransactionRequest,\n  SentinelSmartTransactionResponse,\n} from './types';\n\nconst log = createModuleLogger(projectLogger, serviceName);\n\nconst MESSENGER_EXPOSED_METHODS = [\n  'getNetworks',\n  'simulateTransactions',\n  'submitRelayTransaction',\n  'getSmartTransaction',\n] as const;\n\n/**\n * Data service that centralises all interactions with the MetaMask Sentinel\n * API (`tx-sentinel-<network>.api.cx.metamask.io`).\n *\n * It exposes one method per Sentinel endpoint:\n * - {@link SentinelApiService.getNetworks} — the supported-network registry\n * (`/networks`), cached since it is stable and identical across subdomains.\n * - {@link SentinelApiService.simulateTransactions} — transaction simulation\n * (`infura_simulateTransactions`), used by `@metamask/transaction-controller`\n * and `@metamask/transaction-pay-controller`.\n * - {@link SentinelApiService.submitRelayTransaction} — gas station relay\n * submission (`eth_sendRelayTransaction`), used by the extension and mobile.\n * - {@link SentinelApiService.getSmartTransaction} — smart-transaction status\n * lookup (`/smart-transactions/{uuid}`).\n *\n * Consumers derive higher-level concerns (whether a chain supports simulation\n * or relay, polling loops, etc.) from the raw endpoint responses.\n */\nexport class SentinelApiService extends BaseDataService<\n  typeof serviceName,\n  SentinelApiServiceMessenger\n> {\n  readonly #fetch: typeof fetch;\n\n  readonly #clientId?: string;\n\n  readonly #clientVersion?: string;\n\n  readonly #environmentDomain: string;\n\n  /**\n   * Constructs a new SentinelApiService.\n   *\n   * @param options - The constructor options. See\n   * {@link SentinelApiServiceOptions}.\n   * @param options.messenger - The messenger suited for this service.\n   * @param options.fetch - The `fetch` function to use for requests. Defaults\n   * to the global `fetch`.\n   * @param options.environment - The Sentinel API environment to target\n   * (`dev`, `uat`, or `prod`). Defaults to `prod`.\n   * @param options.clientId - Identifier for the calling client (for example\n   * `extension` or `mobile`), sent as the `X-Client-Id` header.\n   * @param options.clientVersion - Version of the calling client, sent as the\n   * `X-Client-Version` header when provided.\n   * @param options.queryClientConfig - Configuration for the underlying\n   * TanStack Query client.\n   * @param options.policyOptions - Options to pass to `createServicePolicy`.\n   * Retries are disabled by default (`maxRetries: 0`) to preserve the\n   * single-attempt behaviour of the clients this service replaces; pass\n   * `maxRetries` here to opt in.\n   */\n  constructor({\n    messenger,\n    fetch: fetchFunction = globalThis.fetch,\n    environment = DEFAULT_ENVIRONMENT,\n    clientId,\n    clientVersion,\n    queryClientConfig = {},\n    policyOptions = {},\n  }: SentinelApiServiceOptions) {\n    super({\n      name: serviceName,\n      messenger,\n      queryClientConfig,\n      policyOptions: {\n        // Disable retries by default so the service is behaviourally\n        // backwards-compatible with the single-request clients it replaces.\n        // Callers can override via `policyOptions.maxRetries`.\n        maxRetries: 0,\n        retryFilterPolicy: handleWhen(\n          (error) =>\n            !(error instanceof SentinelApiResponseValidationError) &&\n            !(error instanceof SentinelChainNotSupportedError) &&\n            !(error instanceof SentinelJsonRpcError),\n        ),\n        ...policyOptions,\n      },\n    });\n\n    this.#fetch = fetchFunction;\n    this.#environmentDomain = ENVIRONMENT_DOMAIN[environment];\n    this.#clientId = clientId;\n    this.#clientVersion = clientVersion;\n\n    this.messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n\n    log('Initialized');\n  }\n\n  /**\n   * Fetches the Sentinel supported-network registry. The result is cached, as\n   * the registry is stable and identical across network subdomains.\n   *\n   * @returns The network registry, keyed by decimal chain ID.\n   */\n  async getNetworks(): Promise<SentinelNetworkRegistry> {\n    const url = `${this.#buildUrl(NETWORKS_SUBDOMAIN)}${ENDPOINT_NETWORKS}`;\n\n    const result = await this.fetchQuery({\n      queryKey: [`${this.name}:getNetworks`],\n      staleTime: NETWORKS_STALE_TIME_MS,\n      queryFn: async (): Promise<Json> => {\n        const headers = await this.#getHeaders();\n\n        log('getNetworks', 'Request', url);\n\n        const response = await this.#fetch(url, { headers });\n\n        if (!response.ok) {\n          throw new HttpError(\n            response.status,\n            `Sentinel API: Networks request failed with status '${response.status}'`,\n          );\n        }\n\n        const json: Json = await response.json();\n\n        const [error] = validate(json, SentinelNetworkRegistryStruct);\n        if (error) {\n          throw new SentinelApiResponseValidationError(\n            `Sentinel API: Malformed response from networks endpoint: ${error.message}`,\n          );\n        }\n\n        log('getNetworks', 'Response', json);\n\n        return json;\n      },\n    });\n\n    return result as unknown as SentinelNetworkRegistry;\n  }\n\n  /**\n   * Simulates transactions against the Sentinel API via\n   * `infura_simulateTransactions`. Not cached, since each request body is\n   * unique and stale simulations must not be reused.\n   *\n   * @param chainId - The chain ID to simulate on.\n   * @param request - The simulation request.\n   * @param options - Additional options.\n   * @param options.getUrl - Optional callback that receives the default\n   * Sentinel URL resolved for the chain and returns the URL to use instead.\n   * Lets consumers rewrite the request URL (for example to route through the\n   * MetaMask Shield proxy) without the service knowing about those concerns.\n   * @returns The simulation response.\n   */\n  async simulateTransactions(\n    chainId: Hex,\n    request: SentinelSimulationRequest,\n    options: { getUrl?: (defaultUrl: string) => string | Promise<string> } = {},\n  ): Promise<SentinelSimulationResponse> {\n    const defaultUrl = await this.#resolveUrl(chainId, 'confirmations');\n    const url = options.getUrl ? await options.getUrl(defaultUrl) : defaultUrl;\n\n    const result = await this.fetchQuery({\n      queryKey: [`${this.name}:simulateTransactions`, chainId, request, url],\n      staleTime: 0,\n      queryFn: async (): Promise<Json> => {\n        log('simulateTransactions', 'Request', url, request);\n\n        const rpcResult = await this.#jsonRpc(url, RPC_METHOD_SIMULATE, [\n          request,\n        ]);\n\n        const [error] = validate(rpcResult, SentinelSimulationResponseStruct);\n        if (error) {\n          throw new SentinelApiResponseValidationError(\n            `Sentinel API: Malformed response from simulation endpoint: ${error.message}`,\n          );\n        }\n\n        log('simulateTransactions', 'Response', rpcResult);\n\n        return rpcResult;\n      },\n    });\n\n    return result as unknown as SentinelSimulationResponse;\n  }\n\n  /**\n   * Submits a signed relay (gas station) transaction to the Sentinel API via\n   * `eth_sendRelayTransaction`. Not cached.\n   *\n   * @param request - The relay submit request.\n   * @returns The relay submit response containing the tracking UUID.\n   */\n  async submitRelayTransaction(\n    request: SentinelRelaySubmitRequest,\n  ): Promise<SentinelRelaySubmitResponse> {\n    const url = await this.#resolveUrl(request.chainId, 'relayTransactions');\n\n    const result = await this.fetchQuery({\n      queryKey: [`${this.name}:submitRelayTransaction`, request],\n      staleTime: 0,\n      queryFn: async (): Promise<Json> => {\n        log('submitRelayTransaction', 'Request', url, request);\n\n        const rpcResult = await this.#jsonRpc(url, RPC_METHOD_SEND_RELAY, [\n          request,\n        ]);\n\n        const [error] = validate(rpcResult, SentinelRelaySubmitResponseStruct);\n        if (error) {\n          throw new SentinelApiResponseValidationError(\n            `Sentinel API: Malformed response from relay submit endpoint: ${error.message}`,\n          );\n        }\n\n        log('submitRelayTransaction', 'Response', rpcResult);\n\n        return rpcResult;\n      },\n    });\n\n    return result as unknown as SentinelRelaySubmitResponse;\n  }\n\n  /**\n   * Looks up the state of a submitted smart transaction by UUID against the\n   * `/smart-transactions/{uuid}` endpoint. Performs a single request; callers\n   * own any polling loop. Not cached.\n   *\n   * @param request - The smart-transaction lookup request.\n   * @returns The response envelope containing the smart transaction(s)\n   * associated with the requested UUID.\n   */\n  async getSmartTransaction(\n    request: SentinelSmartTransactionRequest,\n  ): Promise<SentinelSmartTransactionResponse> {\n    const { chainId, uuid } = request;\n    const baseUrl = await this.#resolveUrl(chainId, 'relayTransactions');\n    const url = `${baseUrl}${ENDPOINT_SMART_TRANSACTIONS}/${uuid}`;\n\n    const result = await this.fetchQuery({\n      queryKey: [`${this.name}:getSmartTransaction`, chainId, uuid],\n      staleTime: 0,\n      queryFn: async (): Promise<Json> => {\n        const headers = await this.#getHeaders();\n\n        log('getSmartTransaction', 'Request', url);\n\n        const response = await this.#fetch(url, { headers });\n\n        if (!response.ok) {\n          throw new HttpError(\n            response.status,\n            `Sentinel API: Smart-transaction request failed with status '${response.status}'`,\n          );\n        }\n\n        const json: Json = await response.json();\n\n        const [error] = validate(json, SentinelSmartTransactionResponseStruct);\n        if (error) {\n          throw new SentinelApiResponseValidationError(\n            `Sentinel API: Malformed response from smart-transactions endpoint: ${error.message}`,\n          );\n        }\n\n        log('getSmartTransaction', 'Response', json);\n\n        return json;\n      },\n    });\n\n    return result as unknown as SentinelSmartTransactionResponse;\n  }\n\n  /**\n   * Performs a JSON-RPC POST to the Sentinel API and returns the `result`.\n   *\n   * @param url - The URL to post to.\n   * @param method - The JSON-RPC method name.\n   * @param params - The JSON-RPC params.\n   * @returns The `result` field of the JSON-RPC response.\n   */\n  async #jsonRpc(url: string, method: string, params: Json[]): Promise<Json> {\n    const headers = await this.#getHeaders();\n\n    const response = await this.#fetch(url, {\n      method: 'POST',\n      headers: {\n        ...headers,\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify({\n        id: '1',\n        jsonrpc: '2.0',\n        method,\n        params,\n      }),\n    });\n\n    if (!response.ok) {\n      throw new HttpError(\n        response.status,\n        `Sentinel API: JSON-RPC request '${method}' failed with status '${response.status}'`,\n      );\n    }\n\n    const responseJson = (await response.json()) as {\n      error?: { code?: number; message?: string };\n      result?: Json;\n    };\n\n    if (responseJson.error) {\n      const { code, message } = responseJson.error;\n      throw new SentinelJsonRpcError(\n        `Sentinel API: JSON-RPC error: ${message}`,\n        code,\n      );\n    }\n\n    if (responseJson.result === undefined) {\n      throw new SentinelJsonRpcError(\n        'Sentinel API: JSON-RPC response missing result',\n        -32603,\n      );\n    }\n\n    return responseJson.result;\n  }\n\n  /**\n   * Builds the outbound headers for a Sentinel request: the client identity\n   * headers plus a best-effort `Authorization` bearer token. Token retrieval\n   * failures are swallowed so unauthenticated requests still proceed.\n   *\n   * @returns The headers to attach to the request.\n   */\n  async #getHeaders(): Promise<Record<string, string>> {\n    const headers: Record<string, string> = {};\n\n    if (this.#clientId !== undefined) {\n      headers['X-Client-Id'] = this.#clientId;\n    }\n\n    if (this.#clientVersion !== undefined) {\n      headers['X-Client-Version'] = this.#clientVersion;\n    }\n\n    try {\n      const token = await this.messenger.call(\n        'AuthenticationController:getBearerToken',\n      );\n      if (token) {\n        headers.Authorization = `Bearer ${token}`;\n      }\n    } catch (error: unknown) {\n      // Proceed without auth if token retrieval fails.\n      log(\n        'getHeaders',\n        'Auth token unavailable, proceeding unauthenticated',\n        error,\n      );\n    }\n\n    return headers;\n  }\n\n  /**\n   * Resolves the Sentinel URL for a chain, asserting the required capability.\n   *\n   * @param chainId - The chain ID to resolve a URL for.\n   * @param capability - The capability flag that must be enabled.\n   * @returns The resolved base URL.\n   */\n  async #resolveUrl(\n    chainId: Hex,\n    capability: 'confirmations' | 'relayTransactions',\n  ): Promise<string> {\n    const network = await this.#getNetwork(chainId);\n\n    if (!network?.[capability]) {\n      throw new SentinelChainNotSupportedError(chainId, capability);\n    }\n\n    return this.#buildUrl(network.network);\n  }\n\n  /**\n   * Looks up a single network entry from the registry by chain ID.\n   *\n   * @param chainId - The chain ID to look up.\n   * @returns The network entry, or undefined if not present.\n   */\n  async #getNetwork(chainId: Hex): Promise<SentinelNetwork | undefined> {\n    const registry = await this.getNetworks();\n    const chainIdDecimal = BigInt(chainId).toString(10);\n    return registry[chainIdDecimal];\n  }\n\n  /**\n   * Builds a Sentinel base URL for the given network subdomain, targeting the\n   * environment this service was constructed with.\n   *\n   * @param subdomain - The network subdomain (for example `ethereum-mainnet`).\n   * @returns The full base URL.\n   */\n  #buildUrl(subdomain: string): string {\n    return BASE_URL_TEMPLATE.replace('{0}', subdomain).replace(\n      '{1}',\n      this.#environmentDomain,\n    );\n  }\n}\n"]}

package/dist/structs.cjs

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SentinelSmartTransactionResponseStruct = exports.SentinelRelaySubmitResponseStruct = exports.SentinelSimulationResponseStruct = exports.SentinelNetworkRegistryStruct = void 0;
+const superstruct_1 = require("@metamask/superstruct");
+/**
+ * Validates a single network entry from the `/networks` registry. Uses `type`
+ * (loose) validation so that additional fields returned by the API do not
+ * cause rejection; only the fields we depend on are asserted.
+ */
+const SentinelNetworkStruct = (0, superstruct_1.type)({
+    network: (0, superstruct_1.string)(),
+    confirmations: (0, superstruct_1.optional)((0, superstruct_1.boolean)()),
+    chainID: (0, superstruct_1.optional)((0, superstruct_1.number)()),
+    relayTransactions: (0, superstruct_1.optional)((0, superstruct_1.boolean)()),
+    smartTransactions: (0, superstruct_1.optional)((0, superstruct_1.boolean)()),
+    sendBundle: (0, superstruct_1.optional)((0, superstruct_1.boolean)()),
+});
+/**
+ * Validates the `/networks` registry response (a map keyed by decimal chain
+ * ID).
+ */
+exports.SentinelNetworkRegistryStruct = (0, superstruct_1.record)((0, superstruct_1.string)(), SentinelNetworkStruct);
+/**
+ * Validates a simulated-transaction result. Loose to tolerate the many
+ * optional fields the API may return.
+ */
+const SentinelSimulationResponseTransactionStruct = (0, superstruct_1.type)({
+    error: (0, superstruct_1.optional)((0, superstruct_1.string)()),
+});
+/**
+ * Validates the top-level simulation response. Only the `transactions` array
+ * is required by consumers.
+ */
+exports.SentinelSimulationResponseStruct = (0, superstruct_1.type)({
+    transactions: (0, superstruct_1.array)(SentinelSimulationResponseTransactionStruct),
+});
+/**
+ * Validates the response from submitting a relay transaction.
+ */
+exports.SentinelRelaySubmitResponseStruct = (0, superstruct_1.type)({
+    uuid: (0, superstruct_1.string)(),
+});
+/**
+ * Validates a single entry in the smart-transactions endpoint response.
+ */
+const SentinelSmartTransactionStruct = (0, superstruct_1.type)({
+    hash: (0, superstruct_1.optional)((0, superstruct_1.string)()),
+    status: (0, superstruct_1.string)(),
+    errorReason: (0, superstruct_1.optional)((0, superstruct_1.nullable)((0, superstruct_1.string)())),
+});
+/**
+ * Validates the smart-transactions endpoint response body (a list of
+ * transactions).
+ */
+exports.SentinelSmartTransactionResponseStruct = (0, superstruct_1.type)({
+    transactions: (0, superstruct_1.array)(SentinelSmartTransactionStruct),
+});
+//# sourceMappingURL=structs.cjs.map

package/dist/structs.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"structs.cjs","sourceRoot":"","sources":["../src/structs.ts"],"names":[],"mappings":";;;AAAA,uDAS+B;AAE/B;;;;GAIG;AACH,MAAM,qBAAqB,GAAG,IAAA,kBAAI,EAAC;IACjC,OAAO,EAAE,IAAA,oBAAM,GAAE;IACjB,aAAa,EAAE,IAAA,sBAAQ,EAAC,IAAA,qBAAO,GAAE,CAAC;IAClC,OAAO,EAAE,IAAA,sBAAQ,EAAC,IAAA,oBAAM,GAAE,CAAC;IAC3B,iBAAiB,EAAE,IAAA,sBAAQ,EAAC,IAAA,qBAAO,GAAE,CAAC;IACtC,iBAAiB,EAAE,IAAA,sBAAQ,EAAC,IAAA,qBAAO,GAAE,CAAC;IACtC,UAAU,EAAE,IAAA,sBAAQ,EAAC,IAAA,qBAAO,GAAE,CAAC;CAChC,CAAC,CAAC;AAEH;;;GAGG;AACU,QAAA,6BAA6B,GAAG,IAAA,oBAAM,EACjD,IAAA,oBAAM,GAAE,EACR,qBAAqB,CACtB,CAAC;AAEF;;;GAGG;AACH,MAAM,2CAA2C,GAAG,IAAA,kBAAI,EAAC;IACvD,KAAK,EAAE,IAAA,sBAAQ,EAAC,IAAA,oBAAM,GAAE,CAAC;CAC1B,CAAC,CAAC;AAEH;;;GAGG;AACU,QAAA,gCAAgC,GAAG,IAAA,kBAAI,EAAC;IACnD,YAAY,EAAE,IAAA,mBAAK,EAAC,2CAA2C,CAAC;CACjE,CAAC,CAAC;AAEH;;GAEG;AACU,QAAA,iCAAiC,GAAG,IAAA,kBAAI,EAAC;IACpD,IAAI,EAAE,IAAA,oBAAM,GAAE;CACf,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,8BAA8B,GAAG,IAAA,kBAAI,EAAC;IAC1C,IAAI,EAAE,IAAA,sBAAQ,EAAC,IAAA,oBAAM,GAAE,CAAC;IACxB,MAAM,EAAE,IAAA,oBAAM,GAAE;IAChB,WAAW,EAAE,IAAA,sBAAQ,EAAC,IAAA,sBAAQ,EAAC,IAAA,oBAAM,GAAE,CAAC,CAAC;CAC1C,CAAC,CAAC;AAEH;;;GAGG;AACU,QAAA,sCAAsC,GAAG,IAAA,kBAAI,EAAC;IACzD,YAAY,EAAE,IAAA,mBAAK,EAAC,8BAA8B,CAAC;CACpD,CAAC,CAAC","sourcesContent":["import {\n  array,\n  boolean,\n  nullable,\n  number,\n  optional,\n  record,\n  string,\n  type,\n} from '@metamask/superstruct';\n\n/**\n * Validates a single network entry from the `/networks` registry. Uses `type`\n * (loose) validation so that additional fields returned by the API do not\n * cause rejection; only the fields we depend on are asserted.\n */\nconst SentinelNetworkStruct = type({\n  network: string(),\n  confirmations: optional(boolean()),\n  chainID: optional(number()),\n  relayTransactions: optional(boolean()),\n  smartTransactions: optional(boolean()),\n  sendBundle: optional(boolean()),\n});\n\n/**\n * Validates the `/networks` registry response (a map keyed by decimal chain\n * ID).\n */\nexport const SentinelNetworkRegistryStruct = record(\n  string(),\n  SentinelNetworkStruct,\n);\n\n/**\n * Validates a simulated-transaction result. Loose to tolerate the many\n * optional fields the API may return.\n */\nconst SentinelSimulationResponseTransactionStruct = type({\n  error: optional(string()),\n});\n\n/**\n * Validates the top-level simulation response. Only the `transactions` array\n * is required by consumers.\n */\nexport const SentinelSimulationResponseStruct = type({\n  transactions: array(SentinelSimulationResponseTransactionStruct),\n});\n\n/**\n * Validates the response from submitting a relay transaction.\n */\nexport const SentinelRelaySubmitResponseStruct = type({\n  uuid: string(),\n});\n\n/**\n * Validates a single entry in the smart-transactions endpoint response.\n */\nconst SentinelSmartTransactionStruct = type({\n  hash: optional(string()),\n  status: string(),\n  errorReason: optional(nullable(string())),\n});\n\n/**\n * Validates the smart-transactions endpoint response body (a list of\n * transactions).\n */\nexport const SentinelSmartTransactionResponseStruct = type({\n  transactions: array(SentinelSmartTransactionStruct),\n});\n"]}

package/dist/structs.d.cts

@@ -0,0 +1,63 @@
+/**
+ * Validates the `/networks` registry response (a map keyed by decimal chain
+ * ID).
+ */
+export declare const SentinelNetworkRegistryStruct: import("@metamask/superstruct").Struct<Record<string, {
+    network: string;
+    confirmations?: boolean | undefined;
+    chainID?: number | undefined;
+    relayTransactions?: boolean | undefined;
+    smartTransactions?: boolean | undefined;
+    sendBundle?: boolean | undefined;
+}>, null>;
+/**
+ * Validates the top-level simulation response. Only the `transactions` array
+ * is required by consumers.
+ */
+export declare const SentinelSimulationResponseStruct: import("@metamask/superstruct").Struct<{
+    transactions: {
+        error?: string | undefined;
+    }[];
+}, {
+    transactions: import("@metamask/superstruct").Struct<{
+        error?: string | undefined;
+    }[], import("@metamask/superstruct").Struct<{
+        error?: string | undefined;
+    }, {
+        error: import("@metamask/superstruct").Struct<string | undefined, null>;
+    }>>;
+}>;
+/**
+ * Validates the response from submitting a relay transaction.
+ */
+export declare const SentinelRelaySubmitResponseStruct: import("@metamask/superstruct").Struct<{
+    uuid: string;
+}, {
+    uuid: import("@metamask/superstruct").Struct<string, null>;
+}>;
+/**
+ * Validates the smart-transactions endpoint response body (a list of
+ * transactions).
+ */
+export declare const SentinelSmartTransactionResponseStruct: import("@metamask/superstruct").Struct<{
+    transactions: {
+        status: string;
+        hash?: string | undefined;
+        errorReason?: string | null | undefined;
+    }[];
+}, {
+    transactions: import("@metamask/superstruct").Struct<{
+        status: string;
+        hash?: string | undefined;
+        errorReason?: string | null | undefined;
+    }[], import("@metamask/superstruct").Struct<{
+        status: string;
+        hash?: string | undefined;
+        errorReason?: string | null | undefined;
+    }, {
+        hash: import("@metamask/superstruct").Struct<string | undefined, null>;
+        status: import("@metamask/superstruct").Struct<string, null>;
+        errorReason: import("@metamask/superstruct").Struct<string | null | undefined, null>;
+    }>>;
+}>;
+//# sourceMappingURL=structs.d.cts.map

package/dist/structs.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structs.d.cts","sourceRoot":"","sources":["../src/structs.ts"],"names":[],"mappings":"AAyBA;;;GAGG;AACH,eAAO,MAAM,6BAA6B;;;;;;;SAGzC,CAAC;AAUF;;;GAGG;AACH,eAAO,MAAM,gCAAgC;;;;;;;;;;;;EAE3C,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iCAAiC;;;;EAE5C,CAAC;AAWH;;;GAGG;AACH,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;;;EAEjD,CAAC"}

package/dist/structs.d.mts

@@ -0,0 +1,63 @@
+/**
+ * Validates the `/networks` registry response (a map keyed by decimal chain
+ * ID).
+ */
+export declare const SentinelNetworkRegistryStruct: import("@metamask/superstruct").Struct<Record<string, {
+    network: string;
+    confirmations?: boolean | undefined;
+    chainID?: number | undefined;
+    relayTransactions?: boolean | undefined;
+    smartTransactions?: boolean | undefined;
+    sendBundle?: boolean | undefined;
+}>, null>;
+/**
+ * Validates the top-level simulation response. Only the `transactions` array
+ * is required by consumers.
+ */
+export declare const SentinelSimulationResponseStruct: import("@metamask/superstruct").Struct<{
+    transactions: {
+        error?: string | undefined;
+    }[];
+}, {
+    transactions: import("@metamask/superstruct").Struct<{
+        error?: string | undefined;
+    }[], import("@metamask/superstruct").Struct<{
+        error?: string | undefined;
+    }, {
+        error: import("@metamask/superstruct").Struct<string | undefined, null>;
+    }>>;
+}>;
+/**
+ * Validates the response from submitting a relay transaction.
+ */
+export declare const SentinelRelaySubmitResponseStruct: import("@metamask/superstruct").Struct<{
+    uuid: string;
+}, {
+    uuid: import("@metamask/superstruct").Struct<string, null>;
+}>;
+/**
+ * Validates the smart-transactions endpoint response body (a list of
+ * transactions).
+ */
+export declare const SentinelSmartTransactionResponseStruct: import("@metamask/superstruct").Struct<{
+    transactions: {
+        status: string;
+        hash?: string | undefined;
+        errorReason?: string | null | undefined;
+    }[];
+}, {
+    transactions: import("@metamask/superstruct").Struct<{
+        status: string;
+        hash?: string | undefined;
+        errorReason?: string | null | undefined;
+    }[], import("@metamask/superstruct").Struct<{
+        status: string;
+        hash?: string | undefined;
+        errorReason?: string | null | undefined;
+    }, {
+        hash: import("@metamask/superstruct").Struct<string | undefined, null>;
+        status: import("@metamask/superstruct").Struct<string, null>;
+        errorReason: import("@metamask/superstruct").Struct<string | null | undefined, null>;
+    }>>;
+}>;
+//# sourceMappingURL=structs.d.mts.map

package/dist/structs.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structs.d.mts","sourceRoot":"","sources":["../src/structs.ts"],"names":[],"mappings":"AAyBA;;;GAGG;AACH,eAAO,MAAM,6BAA6B;;;;;;;SAGzC,CAAC;AAUF;;;GAGG;AACH,eAAO,MAAM,gCAAgC;;;;;;;;;;;;EAE3C,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iCAAiC;;;;EAE5C,CAAC;AAWH;;;GAGG;AACH,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;;;EAEjD,CAAC"}

package/dist/structs.mjs

@@ -0,0 +1,55 @@
+import { array, boolean, nullable, number, optional, record, string, type } from "@metamask/superstruct";
+/**
+ * Validates a single network entry from the `/networks` registry. Uses `type`
+ * (loose) validation so that additional fields returned by the API do not
+ * cause rejection; only the fields we depend on are asserted.
+ */
+const SentinelNetworkStruct = type({
+    network: string(),
+    confirmations: optional(boolean()),
+    chainID: optional(number()),
+    relayTransactions: optional(boolean()),
+    smartTransactions: optional(boolean()),
+    sendBundle: optional(boolean()),
+});
+/**
+ * Validates the `/networks` registry response (a map keyed by decimal chain
+ * ID).
+ */
+export const SentinelNetworkRegistryStruct = record(string(), SentinelNetworkStruct);
+/**
+ * Validates a simulated-transaction result. Loose to tolerate the many
+ * optional fields the API may return.
+ */
+const SentinelSimulationResponseTransactionStruct = type({
+    error: optional(string()),
+});
+/**
+ * Validates the top-level simulation response. Only the `transactions` array
+ * is required by consumers.
+ */
+export const SentinelSimulationResponseStruct = type({
+    transactions: array(SentinelSimulationResponseTransactionStruct),
+});
+/**
+ * Validates the response from submitting a relay transaction.
+ */
+export const SentinelRelaySubmitResponseStruct = type({
+    uuid: string(),
+});
+/**
+ * Validates a single entry in the smart-transactions endpoint response.
+ */
+const SentinelSmartTransactionStruct = type({
+    hash: optional(string()),
+    status: string(),
+    errorReason: optional(nullable(string())),
+});
+/**
+ * Validates the smart-transactions endpoint response body (a list of
+ * transactions).
+ */
+export const SentinelSmartTransactionResponseStruct = type({
+    transactions: array(SentinelSmartTransactionStruct),
+});
+//# sourceMappingURL=structs.mjs.map

package/dist/structs.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"structs.mjs","sourceRoot":"","sources":["../src/structs.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,OAAO,EACP,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,MAAM,EACN,MAAM,EACN,IAAI,EACL,8BAA8B;AAE/B;;;;GAIG;AACH,MAAM,qBAAqB,GAAG,IAAI,CAAC;IACjC,OAAO,EAAE,MAAM,EAAE;IACjB,aAAa,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;IAClC,OAAO,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;IAC3B,iBAAiB,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;IACtC,iBAAiB,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;IACtC,UAAU,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;CAChC,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,MAAM,CACjD,MAAM,EAAE,EACR,qBAAqB,CACtB,CAAC;AAEF;;;GAGG;AACH,MAAM,2CAA2C,GAAG,IAAI,CAAC;IACvD,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;CAC1B,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,IAAI,CAAC;IACnD,YAAY,EAAE,KAAK,CAAC,2CAA2C,CAAC;CACjE,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,IAAI,CAAC;IACpD,IAAI,EAAE,MAAM,EAAE;CACf,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,8BAA8B,GAAG,IAAI,CAAC;IAC1C,IAAI,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;IACxB,MAAM,EAAE,MAAM,EAAE;IAChB,WAAW,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;CAC1C,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,sCAAsC,GAAG,IAAI,CAAC;IACzD,YAAY,EAAE,KAAK,CAAC,8BAA8B,CAAC;CACpD,CAAC,CAAC","sourcesContent":["import {\n  array,\n  boolean,\n  nullable,\n  number,\n  optional,\n  record,\n  string,\n  type,\n} from '@metamask/superstruct';\n\n/**\n * Validates a single network entry from the `/networks` registry. Uses `type`\n * (loose) validation so that additional fields returned by the API do not\n * cause rejection; only the fields we depend on are asserted.\n */\nconst SentinelNetworkStruct = type({\n  network: string(),\n  confirmations: optional(boolean()),\n  chainID: optional(number()),\n  relayTransactions: optional(boolean()),\n  smartTransactions: optional(boolean()),\n  sendBundle: optional(boolean()),\n});\n\n/**\n * Validates the `/networks` registry response (a map keyed by decimal chain\n * ID).\n */\nexport const SentinelNetworkRegistryStruct = record(\n  string(),\n  SentinelNetworkStruct,\n);\n\n/**\n * Validates a simulated-transaction result. Loose to tolerate the many\n * optional fields the API may return.\n */\nconst SentinelSimulationResponseTransactionStruct = type({\n  error: optional(string()),\n});\n\n/**\n * Validates the top-level simulation response. Only the `transactions` array\n * is required by consumers.\n */\nexport const SentinelSimulationResponseStruct = type({\n  transactions: array(SentinelSimulationResponseTransactionStruct),\n});\n\n/**\n * Validates the response from submitting a relay transaction.\n */\nexport const SentinelRelaySubmitResponseStruct = type({\n  uuid: string(),\n});\n\n/**\n * Validates a single entry in the smart-transactions endpoint response.\n */\nconst SentinelSmartTransactionStruct = type({\n  hash: optional(string()),\n  status: string(),\n  errorReason: optional(nullable(string())),\n});\n\n/**\n * Validates the smart-transactions endpoint response body (a list of\n * transactions).\n */\nexport const SentinelSmartTransactionResponseStruct = type({\n  transactions: array(SentinelSmartTransactionStruct),\n});\n"]}