@rhinestone/sdk 2.0.0-beta.8 → 2.0.0

package/dist/src/clients/json-rpc.js

@@ -0,0 +1,56 @@
+export class JsonRpcClientError extends Error {
+    method;
+    code;
+    data;
+    constructor(input) {
+        super(input.message, input.cause === undefined ? undefined : { cause: input.cause });
+        this.name = 'JsonRpcClientError';
+        this.method = input.method;
+        this.code = input.code;
+        this.data = input.data;
+    }
+}
+let nextRequestId = 1;
+export async function requestJsonRpc(input) {
+    let response;
+    try {
+        response = await input.fetch(input.url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                jsonrpc: '2.0',
+                id: nextRequestId++,
+                method: input.method,
+                params: input.params,
+            }),
+        });
+    }
+    catch (cause) {
+        throw new JsonRpcClientError({
+            method: input.method,
+            message: `JSON-RPC request ${input.method} failed`,
+            cause,
+        });
+    }
+    let envelope;
+    try {
+        envelope = (await response.json());
+    }
+    catch (cause) {
+        throw new JsonRpcClientError({
+            method: input.method,
+            message: `JSON-RPC request ${input.method} returned invalid JSON`,
+            cause,
+        });
+    }
+    if (!response.ok || envelope.error) {
+        throw new JsonRpcClientError({
+            method: input.method,
+            message: envelope.error?.message ??
+                `JSON-RPC request ${input.method} failed with status ${response.status}`,
+            code: envelope.error?.code,
+            data: envelope.error?.data,
+        });
+    }
+    return envelope.result;
+}

package/dist/src/clients/orchestrator/auth.d.ts

@@ -0,0 +1,7 @@
+import type { ResolvedAuth } from '../../config/resolved.js';
+export interface OrchestratorAuthPort {
+    readonly getHeaders: () => Promise<Readonly<Record<string, string>>>;
+    readonly getSubmitHeaders: (intentInput: unknown, sponsored: boolean) => Promise<Readonly<Record<string, string>>>;
+}
+export declare function createOrchestratorAuth(auth: ResolvedAuth): OrchestratorAuthPort;
+//# sourceMappingURL=auth.d.ts.map

package/dist/src/clients/orchestrator/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../../clients/orchestrator/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAEzD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;IACpE,QAAQ,CAAC,gBAAgB,EAAE,CACzB,WAAW,EAAE,OAAO,EACpB,SAAS,EAAE,OAAO,KACf,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;CAC/C;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,YAAY,GACjB,oBAAoB,CA4BtB"}

package/dist/src/clients/orchestrator/auth.js

@@ -0,0 +1,27 @@
+export function createOrchestratorAuth(auth) {
+    if (auth.kind === 'api-key') {
+        const headers = Object.freeze({ 'x-api-key': auth.apiKey });
+        return {
+            getHeaders: async () => headers,
+            getSubmitHeaders: async () => headers,
+        };
+    }
+    const accessToken = async () => typeof auth.accessToken === 'function'
+        ? await auth.accessToken()
+        : auth.accessToken;
+    const headers = async () => ({
+        Authorization: `Bearer ${await accessToken()}`,
+        'x-api-key': 'jwt',
+    });
+    return {
+        getHeaders: headers,
+        getSubmitHeaders: async (intentInput, sponsored) => ({
+            ...(await headers()),
+            ...(sponsored && auth.getIntentExtensionToken
+                ? {
+                    'X-Intent-Extension': `Bearer ${await auth.getIntentExtensionToken(intentInput)}`,
+                }
+                : {}),
+        }),
+    };
+}

package/dist/src/clients/orchestrator/chain-catalog.d.ts

@@ -0,0 +1,36 @@
+import type { WireChainsResponse } from './wire.js';
+export type CatalogToken = {
+    symbol: string;
+    address: string;
+    decimals: number;
+};
+export type ChainInfo = {
+    name: string;
+    testnet: boolean;
+    supportedTokens: 'all' | CatalogToken[];
+    wrappedNativeToken?: CatalogToken;
+};
+export type ChainInfoMap = Record<number, ChainInfo>;
+/**
+ * Read-only view over the chain facts returned by `GET /chains`. Built once per
+ * client (fetched lazily) and read synchronously thereafter.
+ */
+export declare class ChainCatalog {
+    private readonly chains;
+    constructor(chains: ChainInfoMap);
+    getSupportedChainIds(): number[];
+    isSupported(chainId: number): boolean;
+    getChainInfo(chainId: number): ChainInfo | undefined;
+    /**
+     * Whether the chain is a testnet, per the orchestrator's `/chains`. Uses the
+     * catalog's own flag so it is authoritative for every supported chain
+     * (including non-EVM and chains newer than the SDK's viem), rather than
+     * viem's local chain list.
+     */
+    isTestnet(chainId: number): boolean;
+    /** The wrapped-native (e.g. WETH) token for the chain, if advertised. */
+    getWrappedNativeToken(chainId: number): CatalogToken | undefined;
+    getSupportedTokens(chainId: number): 'all' | CatalogToken[] | undefined;
+}
+export declare function parseChains(json: WireChainsResponse): ChainInfoMap;
+//# sourceMappingURL=chain-catalog.d.ts.map

package/dist/src/clients/orchestrator/chain-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-catalog.d.ts","sourceRoot":"","sources":["../../../../clients/orchestrator/chain-catalog.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAA;AAEhD,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,OAAO,CAAA;IAGhB,eAAe,EAAE,KAAK,GAAG,YAAY,EAAE,CAAA;IACvC,kBAAkB,CAAC,EAAE,YAAY,CAAA;CAClC,CAAA;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;AAEpD;;;GAGG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,YAAY;IAEjD,oBAAoB,IAAI,MAAM,EAAE;IAIhC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIrC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAIpD;;;;;OAKG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAInC,yEAAyE;IACzE,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIhE,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,GAAG,YAAY,EAAE,GAAG,SAAS;CAGxE;AAKD,wBAAgB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,YAAY,CAelE"}

package/dist/src/clients/orchestrator/chain-catalog.js

@@ -0,0 +1,67 @@
+// Runtime chain catalog, sourced from the orchestrator's `GET /chains`.
+//
+// This replaces the SDK's bundled `@rhinestone/shared-configs` chain data: the
+// orchestrator is authoritative for chain *facts* (which chains are supported,
+// their tokens, and the wrapped-native token), so the SDK reads them at runtime
+// instead of baking them in at build time. That's what lets a new chain go live
+// without an SDK release.
+//
+// `Chain` objects themselves (rpc/nativeCurrency/formatters, needed for signing
+// and `createPublicClient`) still come from viem — `/chains` can't carry those.
+// The catalog only owns the chain *facts*.
+import { chainIdFromCaip2, isCaip2 } from '../../chains/caip2.js';
+/**
+ * Read-only view over the chain facts returned by `GET /chains`. Built once per
+ * client (fetched lazily) and read synchronously thereafter.
+ */
+export class ChainCatalog {
+    chains;
+    constructor(chains) {
+        this.chains = chains;
+    }
+    getSupportedChainIds() {
+        return Object.keys(this.chains).map(Number);
+    }
+    isSupported(chainId) {
+        return chainId in this.chains;
+    }
+    getChainInfo(chainId) {
+        return this.chains[chainId];
+    }
+    /**
+     * Whether the chain is a testnet, per the orchestrator's `/chains`. Uses the
+     * catalog's own flag so it is authoritative for every supported chain
+     * (including non-EVM and chains newer than the SDK's viem), rather than
+     * viem's local chain list.
+     */
+    isTestnet(chainId) {
+        return this.chains[chainId]?.testnet ?? false;
+    }
+    /** The wrapped-native (e.g. WETH) token for the chain, if advertised. */
+    getWrappedNativeToken(chainId) {
+        return this.chains[chainId]?.wrappedNativeToken;
+    }
+    getSupportedTokens(chainId) {
+        return this.chains[chainId]?.supportedTokens;
+    }
+}
+// Adapter boundary: decode the CAIP-2-keyed wire response into a numeric-keyed
+// `ChainInfoMap`. Entries whose id can't be mapped are skipped rather than
+// failing the whole catalog.
+export function parseChains(json) {
+    const out = {};
+    for (const [key, entry] of Object.entries(json)) {
+        const id = isCaip2(key) ? chainIdFromCaip2(key) : Number(key);
+        if (id === undefined || !Number.isFinite(id))
+            continue;
+        out[id] = {
+            name: entry.name,
+            testnet: entry.testnet,
+            supportedTokens: entry.supportedTokens,
+            ...(entry.wrappedNativeToken
+                ? { wrappedNativeToken: entry.wrappedNativeToken }
+                : {}),
+        };
+    }
+    return out;
+}

package/dist/src/clients/orchestrator/client.d.ts

@@ -0,0 +1,13 @@
+import type { ResolvedSdkConfig } from '../../config/resolved.js';
+import type { OrchestratorAuthPort } from './auth.js';
+import { type FetchPort } from './fetch.js';
+import type { OrchestratorPort } from './port.js';
+export interface OrchestratorClientOptions {
+    readonly url: string;
+    readonly auth: OrchestratorAuthPort;
+    readonly headers?: Readonly<Record<string, string>>;
+    readonly fetch?: FetchPort;
+}
+export declare function createOrchestratorClient(options: OrchestratorClientOptions): OrchestratorPort;
+export declare function createConfiguredOrchestratorClient(config: ResolvedSdkConfig, fetch?: FetchPort): OrchestratorPort;
+//# sourceMappingURL=client.d.ts.map

package/dist/src/clients/orchestrator/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../clients/orchestrator/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAA;AAGlD,OAAO,EAAE,KAAK,SAAS,EAAyB,MAAM,SAAS,CAAA;AAU/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAA;AAM9C,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAA;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IACnD,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAC3B;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,yBAAyB,GACjC,gBAAgB,CA0GlB;AAED,wBAAgB,kCAAkC,CAChD,MAAM,EAAE,iBAAiB,EACzB,KAAK,CAAC,EAAE,SAAS,GAChB,gBAAgB,CAOlB"}

package/dist/src/clients/orchestrator/client.js

@@ -0,0 +1,97 @@
+import { formatCaip2 } from '../../chains/caip2.js';
+import { createOrchestratorAuth } from './auth.js';
+import { ChainCatalog, parseChains } from './chain-catalog.js';
+import { fetchOrchestratorJson } from './fetch.js';
+import { mapIntentRequestToWire, mapIntentStatusFromWire, mapPortfolioFromWire, mapQuoteResponseFromWire, mapSignedIntentToWire, mapSplitRequestToWire, mapSplitResultFromWire, } from './mappers.js';
+const SDK_VERSION = '2.0.0';
+const API_VERSION = '2026-04.blanc';
+export function createOrchestratorClient(options) {
+    const fetchPort = options.fetch ?? globalThis.fetch;
+    const request = async (input) => {
+        const authHeaders = input.submitContext
+            ? await options.auth.getSubmitHeaders(input.submitContext.intentInput, input.submitContext.sponsored)
+            : await options.auth.getHeaders();
+        return fetchOrchestratorJson({
+            fetch: fetchPort,
+            url: new URL(input.path, withTrailingSlash(options.url)).toString(),
+            init: {
+                method: input.method ?? 'GET',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'x-sdk-version': SDK_VERSION,
+                    'x-api-version': API_VERSION,
+                    ...authHeaders,
+                    ...options.headers,
+                },
+                ...(input.body === undefined
+                    ? {}
+                    : { body: JSON.stringify(input.body) }),
+            },
+        });
+    };
+    // Memoized so the chain catalog is fetched at most once per client, lazily on
+    // first use — never at account construction.
+    let chainCatalogPromise;
+    return {
+        createQuote: async (input) => mapQuoteResponseFromWire(await request({
+            path: 'quotes',
+            method: 'POST',
+            body: mapIntentRequestToWire(input),
+        })),
+        submitIntent: async (input, context) => {
+            const value = (await request({
+                path: 'intents',
+                method: 'POST',
+                body: mapSignedIntentToWire(input),
+                ...(context ? { submitContext: context } : {}),
+            }));
+            return { traceId: value.traceId ?? '', intentId: value.intentId ?? '' };
+        },
+        getIntentStatus: async (intentId) => mapIntentStatusFromWire(intentId, await request({ path: `intents/${encodeURIComponent(intentId)}` })),
+        splitIntents: async (input) => mapSplitResultFromWire(await request({
+            path: 'intents/splits',
+            method: 'POST',
+            body: mapSplitRequestToWire(input),
+        })),
+        getPortfolio: async (input) => {
+            const params = new URLSearchParams();
+            for (const chainId of input.chainIds ?? []) {
+                params.append('chainIds', formatCaip2(chainId));
+            }
+            for (const [chainId, tokens] of Object.entries(input.tokens ?? {})) {
+                for (const token of tokens) {
+                    params.append('tokens', `${formatCaip2(Number(chainId))}:${token}`);
+                }
+            }
+            const suffix = params.size > 0 ? `?${params}` : '';
+            return mapPortfolioFromWire(await request({
+                path: `accounts/${input.account}/portfolio${suffix}`,
+            }));
+        },
+        getAppFeeBalances: async () => {
+            const value = (await request({ path: 'app-fees/balances' }));
+            return {
+                withdrawableUsd: value.withdrawableUsd ?? 0,
+                pendingUsd: value.pendingUsd ?? 0,
+            };
+        },
+        getChainCatalog: () => {
+            chainCatalogPromise ??= (async () => {
+                const json = (await request({ path: 'chains' }));
+                return new ChainCatalog(parseChains(json));
+            })();
+            return chainCatalogPromise;
+        },
+    };
+}
+export function createConfiguredOrchestratorClient(config, fetch) {
+    return createOrchestratorClient({
+        url: config.orchestratorUrl,
+        auth: createOrchestratorAuth(config.auth),
+        headers: config.headers,
+        ...(fetch ? { fetch } : {}),
+    });
+}
+function withTrailingSlash(value) {
+    return value.endsWith('/') ? value : `${value}/`;
+}

package/dist/src/clients/orchestrator/errors.d.ts

@@ -0,0 +1,238 @@
+import type { Address, Hex } from 'viem';
+type ErrorCode = 'VALIDATION_ERROR' | 'INSUFFICIENT_LIQUIDITY' | 'NOT_FOUND' | 'UNAUTHORIZED' | 'FORBIDDEN' | 'KEY_SCOPE_DENIED' | 'CONFLICT' | 'UNPROCESSABLE_CONTENT' | 'TOO_MANY_REQUESTS' | 'SETTLEMENT_QUOTE_ERROR' | 'SETTLEMENT_EXECUTION_ERROR' | 'SIMULATION_FAILED' | 'EXTERNAL_SERVICE_TIMEOUT' | 'RELAYER_MARKET_UNAVAILABLE' | 'INTERNAL_ERROR';
+interface ValidationIssue {
+    message: string;
+    context?: Record<string, unknown>;
+}
+interface ErrorDetail {
+    message: string;
+    context?: Record<string, unknown>;
+}
+interface BaseErrorParams {
+    message: string;
+    traceId?: string;
+    statusCode?: number;
+}
+type SimulationAction = 'claim' | 'fill';
+type SimulationRetryHint = 'RE_PREPARE' | 'RETRY_LATER';
+type SimulationErrorCategory = 'QUOTE_EXPIRED' | 'ORDER_EXPIRED' | 'PERMIT_EXPIRED' | 'PERMIT2_NONCE_CONSUMED' | 'EXECUTOR_NONCE_CONSUMED' | 'INVALID_SIGNATURE' | 'INVALID_PERMIT2_SIGNATURE' | 'INVALID_CONTRACT_SIGNATURE' | 'INVALID_SIGNER' | 'INSUFFICIENT_BALANCE' | 'INSUFFICIENT_ALLOWANCE' | 'ACCOUNT_CREATION_FAILED' | 'ACCOUNT_UNAUTHORIZED' | 'ADAPTER_CALL_FAILED' | 'EXECUTION_FAILED' | 'CLAIM_FAILED' | 'ROUTER_PAUSED' | 'ADAPTER_NOT_FOUND' | 'PANIC' | 'REQUIRE_FAILED' | 'UNCLASSIFIED_REVERT' | 'EMPTY_REVERT';
+interface SimulationCall {
+    chainId?: string;
+    to?: Address;
+    data?: Hex;
+    value?: string;
+}
+interface SimulationDetails {
+    stateOverride?: unknown;
+    blockNumber?: string;
+    relayer?: Address;
+    simulationUrls?: string[];
+}
+interface SimulationFailureSimulation {
+    success: false;
+    action?: SimulationAction;
+    chainId?: string;
+    call?: SimulationCall;
+    errorSelector?: string;
+    errorName?: string;
+    errorArgs?: Record<string, unknown>;
+    errorCategory?: SimulationErrorCategory;
+    details?: SimulationDetails;
+}
+interface SimulationFailureDetails {
+    nonce?: string;
+    category?: SimulationErrorCategory;
+    errorSelector?: string;
+    errorName?: string;
+    errorArgs?: Record<string, unknown>;
+    retryable?: boolean;
+    retryHint?: SimulationRetryHint;
+    simulations?: SimulationFailureSimulation[];
+}
+declare class OrchestratorError extends Error {
+    readonly code: ErrorCode | 'UNKNOWN';
+    readonly traceId: string;
+    readonly statusCode?: number;
+    constructor(params: BaseErrorParams & {
+        code?: ErrorCode | 'UNKNOWN';
+    });
+}
+declare class ValidationError extends OrchestratorError {
+    readonly issues: ValidationIssue[];
+    constructor(params: BaseErrorParams & {
+        issues?: ValidationIssue[];
+    });
+}
+declare class InsufficientLiquidityError extends OrchestratorError {
+    readonly availableIntents: Record<string, bigint>[];
+    readonly unfillable: Record<string, bigint>;
+    constructor(params: BaseErrorParams & {
+        availableIntents: Record<string, bigint>[];
+        unfillable: Record<string, bigint>;
+    });
+}
+declare class NotFoundError extends OrchestratorError {
+    constructor(params: BaseErrorParams);
+}
+declare class UnauthorizedError extends OrchestratorError {
+    constructor(params: BaseErrorParams);
+}
+declare class ForbiddenError extends OrchestratorError {
+    constructor(params: BaseErrorParams & {
+        code?: ErrorCode;
+    });
+}
+/**
+ * Thrown when an API key's scope denies the request.
+ *
+ * Subclass of `ForbiddenError` carrying the failed `scope` and the
+ * `required` / `actual` levels — distinct from a generic 403 so integrators
+ * can prompt the user to widen the key's scope rather than rotate it.
+ */
+declare class KeyScopeDeniedError extends ForbiddenError {
+    readonly scope: string;
+    readonly required: string | boolean;
+    readonly actual: string | boolean;
+    constructor(params: BaseErrorParams & {
+        scope: string;
+        required: string | boolean;
+        actual: string | boolean;
+    });
+}
+declare class ConflictError extends OrchestratorError {
+    constructor(params: BaseErrorParams);
+}
+declare class UnprocessableContentError extends OrchestratorError {
+    readonly details: ErrorDetail[];
+    constructor(params: BaseErrorParams & {
+        details?: ErrorDetail[];
+    });
+}
+/** Per-client sponsorship cap a quote can breach. Mirrors the orchestrator's
+ * `SponsorLimits` keys: per-intent gas, per-intent bridge fee, or the
+ * per-intent aggregate. */
+declare const SPONSOR_LIMIT_KEYS: readonly ["gasPerIntentUSD", "bridgeFeePerIntentUSD", "perIntentUSD"];
+type SponsorLimitKey = (typeof SPONSOR_LIMIT_KEYS)[number];
+/**
+ * A configured per-client sponsorship cap was exceeded by a quote.
+ *
+ * A `422 UNPROCESSABLE_CONTENT` specialization: the integrator's sponsor
+ * policy sets a per-intent USD ceiling (gas, bridge-fee, or aggregate) and
+ * this quote's sponsored coverage would exceed it. Distinct from
+ * {@link InsufficientSponsorBalanceError} (a funds shortfall) — a cap breach
+ * is deterministic and does NOT clear by topping up the sponsorship balance;
+ * the cap itself must be raised or the intent made cheaper.
+ *
+ * Extends {@link UnprocessableContentError} and keeps `code` as
+ * `'UNPROCESSABLE_CONTENT'` (the wire does not yet carry a dedicated code), so
+ * existing handling of that error still catches it. `sponsorAddress` is
+ * populated only for the pre-fold check; the post-fold multi-candidate
+ * rejection omits it, so treat every field as best-effort.
+ */
+declare class SponsorLimitExceededError extends UnprocessableContentError {
+    readonly limitKey?: SponsorLimitKey;
+    readonly capUsd?: number;
+    readonly coverageUsd?: number;
+    readonly sponsorAddress?: string;
+    constructor(params: BaseErrorParams & {
+        details?: ErrorDetail[];
+        limitKey?: SponsorLimitKey;
+        capUsd?: number;
+        coverageUsd?: number;
+        sponsorAddress?: string;
+    });
+}
+/**
+ * The sponsor's prefunded balance cannot cover the sponsored categories for a
+ * quote.
+ *
+ * A `422 UNPROCESSABLE_CONTENT` specialization. Coverage is all-or-nothing:
+ * `failedCategories` lists the enabled categories (`gas`, `bridgeFee`,
+ * `swapFee`) that could not be covered. Unlike
+ * {@link SponsorLimitExceededError} (a configured policy cap), this clears once
+ * the sponsorship balance is topped up.
+ *
+ * Extends {@link UnprocessableContentError} and keeps `code` as
+ * `'UNPROCESSABLE_CONTENT'`, so existing handling of that error still catches
+ * it.
+ */
+declare class InsufficientSponsorBalanceError extends UnprocessableContentError {
+    readonly failedCategories: string[];
+    readonly sponsorAddress?: string;
+    readonly remainingBalanceUsd?: number;
+    readonly totalSponsoredUsd?: number;
+    constructor(params: BaseErrorParams & {
+        details?: ErrorDetail[];
+        failedCategories?: string[];
+        sponsorAddress?: string;
+        remainingBalanceUsd?: number;
+        totalSponsoredUsd?: number;
+    });
+}
+declare class RateLimitedError extends OrchestratorError {
+    readonly retryAfter?: string;
+    constructor(params: BaseErrorParams & {
+        retryAfter?: string;
+    });
+}
+declare class SettlementQuoteError extends OrchestratorError {
+    constructor(params: BaseErrorParams);
+}
+declare class SettlementExecutionError extends OrchestratorError {
+    constructor(params: BaseErrorParams);
+}
+declare class SimulationFailedError extends OrchestratorError {
+    readonly nonce?: string;
+    readonly category?: SimulationErrorCategory;
+    readonly errorSelector?: string;
+    readonly errorName?: string;
+    readonly errorArgs?: Record<string, unknown>;
+    readonly retryable: boolean;
+    readonly retryHint?: SimulationRetryHint;
+    readonly simulations: SimulationFailureSimulation[];
+    constructor(params: BaseErrorParams & SimulationFailureDetails);
+}
+declare class ExternalServiceTimeoutError extends OrchestratorError {
+    constructor(params: BaseErrorParams);
+}
+declare class RelayerMarketUnavailableError extends OrchestratorError {
+    constructor(params: BaseErrorParams);
+}
+declare class InternalServerError extends OrchestratorError {
+    constructor(params: BaseErrorParams);
+}
+interface ErrorEnvelope {
+    code: ErrorCode;
+    message: string;
+    traceId: string;
+    details?: unknown;
+}
+declare function parseErrorEnvelope(envelope: ErrorEnvelope, statusCode: number, retryAfter?: string): OrchestratorError;
+declare function isOrchestratorError(error: unknown): error is OrchestratorError;
+declare function isRateLimited(error: unknown): error is RateLimitedError;
+declare function isValidationError(error: unknown): error is ValidationError;
+declare function isAuthError(error: unknown): error is UnauthorizedError | ForbiddenError;
+declare function isSimulationFailed(error: unknown): error is SimulationFailedError;
+declare function isSponsorLimitExceeded(error: unknown): error is SponsorLimitExceededError;
+declare function isInsufficientSponsorBalance(error: unknown): error is InsufficientSponsorBalanceError;
+/** Either sponsor failure: a configured cap breach or a balance shortfall. */
+declare function isSponsorError(error: unknown): error is SponsorLimitExceededError | InsufficientSponsorBalanceError;
+declare function isRetryable(error: unknown): boolean;
+/**
+ * Detects transport-level failures (connection reset, socket closed, DNS, TLS)
+ * that `fetch` rejects with instead of returning an HTTP response. Unlike HTTP
+ * errors — which the client converts into typed {@link OrchestratorError}s —
+ * these carry no status and bubble up untyped, so {@link isRetryable} misses
+ * them. They are safe to retry for idempotent reads (e.g. intent-status
+ * polling). We match by `code` and message across the cause chain — never by
+ * error type: `fetch` rejects network failures as `TypeError`, but `TypeError`
+ * is also thrown for logic bugs, bad URLs, and response-decoding errors that
+ * must NOT be retried (`waitForExecution` has no SDK-side deadline). Runtimes
+ * differ (Bun throws a plain `Error` with a socket message; undici/Node a
+ * `TypeError` with a coded `cause`), hence both signals. Caller-initiated
+ * aborts are excluded so deadlines/cancellation still propagate.
+ */
+declare function isConnectionError(error: unknown): boolean;
+export type { ErrorCode, ErrorDetail, ErrorEnvelope, SimulationAction, SimulationCall, SimulationDetails, SimulationErrorCategory, SimulationFailureDetails, SimulationFailureSimulation, SimulationRetryHint, SponsorLimitKey, ValidationIssue, };
+export { parseErrorEnvelope, isOrchestratorError, isRetryable, isConnectionError, isAuthError, isValidationError, isRateLimited, isSimulationFailed, isSponsorLimitExceeded, isInsufficientSponsorBalance, isSponsorError, OrchestratorError, ValidationError, InsufficientLiquidityError, SponsorLimitExceededError, InsufficientSponsorBalanceError, NotFoundError, UnauthorizedError, ForbiddenError, KeyScopeDeniedError, ConflictError, UnprocessableContentError, RateLimitedError, SettlementQuoteError, SettlementExecutionError, SimulationFailedError, ExternalServiceTimeoutError, RelayerMarketUnavailableError, InternalServerError, };
+//# sourceMappingURL=errors.d.ts.map

package/dist/src/clients/orchestrator/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../clients/orchestrator/errors.ts"],"names":[],"mappings":"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"}