@lifi/composer-sdk 0.7.1 → 0.9.0

package/dist/run/simulate.cjs

@@ -1,46 +1,41 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var simulate_exports = {};
-__export(simulate_exports, {
-  buildSimulateRequest: () => buildSimulateRequest
-});
-module.exports = __toCommonJS(simulate_exports);
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/run/simulate.ts
+/**
+* Assembles a {@link SimulateRequest} from a compile result and the
+* caller-supplied chain, signer, and tracked balances. Pure: performs no
+* network I/O, does not mutate its input, and returns a fresh object.
+*
+* Bridges the common case — simulate the transaction you just compiled —
+* without coupling raw-transaction simulation to the flow builder. The
+* `value` defaults to the compiled transaction's value unless overridden.
+*
+* @example
+* ```ts
+* const compiled = await builder.compile({ inputs: { ... }, signer: '0x1111...' });
+* const req = buildSimulateRequest({
+*   result: compiled,
+*   chainId: 1,
+*   signer: '0x1111111111111111111111111111111111111111',
+*   trackedBalances: [{ token: '0xA0b8...', owner: '0x1111...' }],
+* });
+* const sim = await sdk.client.simulate(req);
+* ```
+*/
 const buildSimulateRequest = (input) => {
-  const { result, chainId, signer, trackedBalances, requirements, block } = input;
-  if (result.transactionRequest === void 0) {
-    throw new Error(
-      "buildSimulateRequest: the compile result has no transactionRequest (empty compiled program \u2014 a settle-only external-funding flow); submit the `actions` entries instead of simulating"
-    );
-  }
-  return {
-    chainId,
-    from: signer,
-    to: result.transactionRequest.to,
-    data: result.transactionRequest.data,
-    value: input.value ?? result.transactionRequest.value,
-    block,
-    requirements,
-    trackedBalances
-  };
+	const { result, chainId, signer, trackedBalances, requirements, block } = input;
+	if (result.transactionRequest === void 0) throw new Error("buildSimulateRequest: the compile result has no transactionRequest (empty compiled program — a settle-only external-funding flow); submit the `actions` entries instead of simulating");
+	return {
+		chainId,
+		from: signer,
+		to: result.transactionRequest.to,
+		data: result.transactionRequest.data,
+		value: input.value ?? result.transactionRequest.value,
+		block,
+		requirements,
+		trackedBalances
+	};
 };
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  buildSimulateRequest
-});
+//#endregion
+exports.buildSimulateRequest = buildSimulateRequest;
+
 //# sourceMappingURL=simulate.cjs.map

package/dist/run/simulate.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/run/simulate.ts"],"sourcesContent":["import type {\n  ComposeCompileResult,\n  SimulateRequest,\n  SlotFinderRequirement,\n  TrackedBalance,\n} from '@lifi/compose-spec';\n\n/**\n * Input for {@link buildSimulateRequest}: a compile result plus the fields a\n * simulation needs that a compiled flow does not carry.\n */\nexport interface BuildSimulateRequestInput {\n  /**\n   * A result from `builder.compile(...)` / `client.compile(...)`. Both\n   * `success` and `partial` results are valid input — the helper does not\n   * discriminate on `status`. A success result for an empty compiled program\n   * (a settle-only `funding: 'external'` flow) carries no\n   * `transactionRequest`; there is nothing to simulate and this helper\n   * throws — submit the result's `actions` entries directly instead.\n   */\n  readonly result: ComposeCompileResult;\n  /** EVM chain id. A compile result does not carry the target chain. */\n  readonly chainId: number;\n  /**\n   * The transaction sender (`from`). A compile result does not carry the\n   * signer, so it must be supplied here.\n   */\n  readonly signer: string;\n  /**\n   * Balances to watch across the simulation. These cannot be inferred from a\n   * flow and must be supplied by the caller.\n   */\n  readonly trackedBalances: readonly TrackedBalance[];\n  /** Optional funding instructions applied before simulation. */\n  readonly requirements?: readonly SlotFinderRequirement[];\n  /** Optional block to pin the simulation to. Omitted ⇒ chain head. */\n  readonly block?: number;\n  /**\n   * Optional native value override. Defaults to the compiled\n   * `transactionRequest.value` when omitted.\n   */\n  readonly value?: bigint | string;\n}\n\n/**\n * Assembles a {@link SimulateRequest} from a compile result and the\n * caller-supplied chain, signer, and tracked balances. Pure: performs no\n * network I/O, does not mutate its input, and returns a fresh object.\n *\n * Bridges the common case — simulate the transaction you just compiled —\n * without coupling raw-transaction simulation to the flow builder. The\n * `value` defaults to the compiled transaction's value unless overridden.\n *\n * @example\n * ```ts\n * const compiled = await builder.compile({ inputs: { ... }, signer: '0x1111...' });\n * const req = buildSimulateRequest({\n *   result: compiled,\n *   chainId: 1,\n *   signer: '0x1111111111111111111111111111111111111111',\n *   trackedBalances: [{ token: '0xA0b8...', owner: '0x1111...' }],\n * });\n * const sim = await sdk.client.simulate(req);\n * ```\n */\nexport const buildSimulateRequest = (\n  input: BuildSimulateRequestInput,\n): SimulateRequest => {\n  const { result, chainId, signer, trackedBalances, requirements, block } =\n    input;\n  // A settle-only flow authored with `funding: 'external'` compiles to an\n  // empty program: the success response carries no `transactionRequest`, so\n  // there is nothing to simulate — the required submissions are the\n  // `actions` entries, submitted directly.\n  if (result.transactionRequest === undefined) {\n    throw new Error(\n      'buildSimulateRequest: the compile result has no transactionRequest (empty compiled program — a settle-only external-funding flow); submit the `actions` entries instead of simulating',\n    );\n  }\n  return {\n    chainId,\n    from: signer,\n    to: result.transactionRequest.to,\n    data: result.transactionRequest.data,\n    value: input.value ?? result.transactionRequest.value,\n    block,\n    requirements,\n    trackedBalances,\n  };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAiEO,MAAM,uBAAuB,CAClC,UACoB;AACpB,QAAM,EAAE,QAAQ,SAAS,QAAQ,iBAAiB,cAAc,MAAM,IACpE;AAKF,MAAI,OAAO,uBAAuB,QAAW;AAC3C,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,SAAO;AAAA,IACL;AAAA,IACA,MAAM;AAAA,IACN,IAAI,OAAO,mBAAmB;AAAA,IAC9B,MAAM,OAAO,mBAAmB;AAAA,IAChC,OAAO,MAAM,SAAS,OAAO,mBAAmB;AAAA,IAChD;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;","names":[]}
+{"version":3,"file":"simulate.cjs","names":[],"sources":["../../src/run/simulate.ts"],"sourcesContent":["import type {\n  ComposeCompileResult,\n  SimulateRequest,\n  SlotFinderRequirement,\n  TrackedBalance,\n} from '@lifi/compose-spec';\n\n/**\n * Input for {@link buildSimulateRequest}: a compile result plus the fields a\n * simulation needs that a compiled flow does not carry.\n */\nexport interface BuildSimulateRequestInput {\n  /**\n   * A result from `builder.compile(...)` / `client.compile(...)`. Both\n   * `success` and `partial` results are valid input — the helper does not\n   * discriminate on `status`. A success result for an empty compiled program\n   * (a settle-only `funding: 'external'` flow) carries no\n   * `transactionRequest`; there is nothing to simulate and this helper\n   * throws — submit the result's `actions` entries directly instead.\n   */\n  readonly result: ComposeCompileResult;\n  /** EVM chain id. A compile result does not carry the target chain. */\n  readonly chainId: number;\n  /**\n   * The transaction sender (`from`). A compile result does not carry the\n   * signer, so it must be supplied here.\n   */\n  readonly signer: string;\n  /**\n   * Balances to watch across the simulation. These cannot be inferred from a\n   * flow and must be supplied by the caller.\n   */\n  readonly trackedBalances: readonly TrackedBalance[];\n  /** Optional funding instructions applied before simulation. */\n  readonly requirements?: readonly SlotFinderRequirement[];\n  /** Optional block to pin the simulation to. Omitted ⇒ chain head. */\n  readonly block?: number;\n  /**\n   * Optional native value override. Defaults to the compiled\n   * `transactionRequest.value` when omitted.\n   */\n  readonly value?: bigint | string;\n}\n\n/**\n * Assembles a {@link SimulateRequest} from a compile result and the\n * caller-supplied chain, signer, and tracked balances. Pure: performs no\n * network I/O, does not mutate its input, and returns a fresh object.\n *\n * Bridges the common case — simulate the transaction you just compiled —\n * without coupling raw-transaction simulation to the flow builder. The\n * `value` defaults to the compiled transaction's value unless overridden.\n *\n * @example\n * ```ts\n * const compiled = await builder.compile({ inputs: { ... }, signer: '0x1111...' });\n * const req = buildSimulateRequest({\n *   result: compiled,\n *   chainId: 1,\n *   signer: '0x1111111111111111111111111111111111111111',\n *   trackedBalances: [{ token: '0xA0b8...', owner: '0x1111...' }],\n * });\n * const sim = await sdk.client.simulate(req);\n * ```\n */\nexport const buildSimulateRequest = (\n  input: BuildSimulateRequestInput,\n): SimulateRequest => {\n  const { result, chainId, signer, trackedBalances, requirements, block } =\n    input;\n  // A settle-only flow authored with `funding: 'external'` compiles to an\n  // empty program: the success response carries no `transactionRequest`, so\n  // there is nothing to simulate — the required submissions are the\n  // `actions` entries, submitted directly.\n  if (result.transactionRequest === undefined) {\n    throw new Error(\n      'buildSimulateRequest: the compile result has no transactionRequest (empty compiled program — a settle-only external-funding flow); submit the `actions` entries instead of simulating',\n    );\n  }\n  return {\n    chainId,\n    from: signer,\n    to: result.transactionRequest.to,\n    data: result.transactionRequest.data,\n    value: input.value ?? result.transactionRequest.value,\n    block,\n    requirements,\n    trackedBalances,\n  };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAiEA,MAAa,wBACX,UACoB;CACpB,MAAM,EAAE,QAAQ,SAAS,QAAQ,iBAAiB,cAAc,UAC9D;CAKF,IAAI,OAAO,uBAAuB,KAAA,GAChC,MAAM,IAAI,MACR,uLACF;CAEF,OAAO;EACL;EACA,MAAM;EACN,IAAI,OAAO,mBAAmB;EAC9B,MAAM,OAAO,mBAAmB;EAChC,OAAO,MAAM,SAAS,OAAO,mBAAmB;EAChD;EACA;EACA;CACF;AACF"}

package/dist/run/simulate.d.cts

@@ -1,40 +1,40 @@
-import { ComposeCompileResult, TrackedBalance, SlotFinderRequirement, SimulateRequest } from '@lifi/compose-spec';
-
+import { ComposeCompileResult, SimulateRequest, SlotFinderRequirement, TrackedBalance } from "@lifi/compose-spec";
+//#region src/run/simulate.d.ts
 /**
  * Input for {@link buildSimulateRequest}: a compile result plus the fields a
  * simulation needs that a compiled flow does not carry.
  */
-interface BuildSimulateRequestInput {
-    /**
-     * A result from `builder.compile(...)` / `client.compile(...)`. Both
-     * `success` and `partial` results are valid input — the helper does not
-     * discriminate on `status`. A success result for an empty compiled program
-     * (a settle-only `funding: 'external'` flow) carries no
-     * `transactionRequest`; there is nothing to simulate and this helper
-     * throws — submit the result's `actions` entries directly instead.
-     */
-    readonly result: ComposeCompileResult;
-    /** EVM chain id. A compile result does not carry the target chain. */
-    readonly chainId: number;
-    /**
-     * The transaction sender (`from`). A compile result does not carry the
-     * signer, so it must be supplied here.
-     */
-    readonly signer: string;
-    /**
-     * Balances to watch across the simulation. These cannot be inferred from a
-     * flow and must be supplied by the caller.
-     */
-    readonly trackedBalances: readonly TrackedBalance[];
-    /** Optional funding instructions applied before simulation. */
-    readonly requirements?: readonly SlotFinderRequirement[];
-    /** Optional block to pin the simulation to. Omitted ⇒ chain head. */
-    readonly block?: number;
-    /**
-     * Optional native value override. Defaults to the compiled
-     * `transactionRequest.value` when omitted.
-     */
-    readonly value?: bigint | string;
+export interface BuildSimulateRequestInput {
+  /**
+   * A result from `builder.compile(...)` / `client.compile(...)`. Both
+   * `success` and `partial` results are valid input — the helper does not
+   * discriminate on `status`. A success result for an empty compiled program
+   * (a settle-only `funding: 'external'` flow) carries no
+   * `transactionRequest`; there is nothing to simulate and this helper
+   * throws — submit the result's `actions` entries directly instead.
+   */
+  readonly result: ComposeCompileResult;
+  /** EVM chain id. A compile result does not carry the target chain. */
+  readonly chainId: number;
+  /**
+   * The transaction sender (`from`). A compile result does not carry the
+   * signer, so it must be supplied here.
+   */
+  readonly signer: string;
+  /**
+   * Balances to watch across the simulation. These cannot be inferred from a
+   * flow and must be supplied by the caller.
+   */
+  readonly trackedBalances: readonly TrackedBalance[];
+  /** Optional funding instructions applied before simulation. */
+  readonly requirements?: readonly SlotFinderRequirement[];
+  /** Optional block to pin the simulation to. Omitted ⇒ chain head. */
+  readonly block?: number;
+  /**
+   * Optional native value override. Defaults to the compiled
+   * `transactionRequest.value` when omitted.
+   */
+  readonly value?: bigint | string;
 }
 /**
  * Assembles a {@link SimulateRequest} from a compile result and the
@@ -57,6 +57,6 @@ interface BuildSimulateRequestInput {
  * const sim = await sdk.client.simulate(req);
  * ```
  */
-declare const buildSimulateRequest: (input: BuildSimulateRequestInput) => SimulateRequest;
-
-export { type BuildSimulateRequestInput, buildSimulateRequest };
+export declare const buildSimulateRequest: (input: BuildSimulateRequestInput) => SimulateRequest;
+//#endregion
+//# sourceMappingURL=simulate.d.cts.map

package/dist/run/simulate.d.ts

@@ -1,40 +1,40 @@
-import { ComposeCompileResult, TrackedBalance, SlotFinderRequirement, SimulateRequest } from '@lifi/compose-spec';
-
+import { ComposeCompileResult, SimulateRequest, SlotFinderRequirement, TrackedBalance } from "@lifi/compose-spec";
+//#region src/run/simulate.d.ts
 /**
  * Input for {@link buildSimulateRequest}: a compile result plus the fields a
  * simulation needs that a compiled flow does not carry.
  */
-interface BuildSimulateRequestInput {
-    /**
-     * A result from `builder.compile(...)` / `client.compile(...)`. Both
-     * `success` and `partial` results are valid input — the helper does not
-     * discriminate on `status`. A success result for an empty compiled program
-     * (a settle-only `funding: 'external'` flow) carries no
-     * `transactionRequest`; there is nothing to simulate and this helper
-     * throws — submit the result's `actions` entries directly instead.
-     */
-    readonly result: ComposeCompileResult;
-    /** EVM chain id. A compile result does not carry the target chain. */
-    readonly chainId: number;
-    /**
-     * The transaction sender (`from`). A compile result does not carry the
-     * signer, so it must be supplied here.
-     */
-    readonly signer: string;
-    /**
-     * Balances to watch across the simulation. These cannot be inferred from a
-     * flow and must be supplied by the caller.
-     */
-    readonly trackedBalances: readonly TrackedBalance[];
-    /** Optional funding instructions applied before simulation. */
-    readonly requirements?: readonly SlotFinderRequirement[];
-    /** Optional block to pin the simulation to. Omitted ⇒ chain head. */
-    readonly block?: number;
-    /**
-     * Optional native value override. Defaults to the compiled
-     * `transactionRequest.value` when omitted.
-     */
-    readonly value?: bigint | string;
+export interface BuildSimulateRequestInput {
+  /**
+   * A result from `builder.compile(...)` / `client.compile(...)`. Both
+   * `success` and `partial` results are valid input — the helper does not
+   * discriminate on `status`. A success result for an empty compiled program
+   * (a settle-only `funding: 'external'` flow) carries no
+   * `transactionRequest`; there is nothing to simulate and this helper
+   * throws — submit the result's `actions` entries directly instead.
+   */
+  readonly result: ComposeCompileResult;
+  /** EVM chain id. A compile result does not carry the target chain. */
+  readonly chainId: number;
+  /**
+   * The transaction sender (`from`). A compile result does not carry the
+   * signer, so it must be supplied here.
+   */
+  readonly signer: string;
+  /**
+   * Balances to watch across the simulation. These cannot be inferred from a
+   * flow and must be supplied by the caller.
+   */
+  readonly trackedBalances: readonly TrackedBalance[];
+  /** Optional funding instructions applied before simulation. */
+  readonly requirements?: readonly SlotFinderRequirement[];
+  /** Optional block to pin the simulation to. Omitted ⇒ chain head. */
+  readonly block?: number;
+  /**
+   * Optional native value override. Defaults to the compiled
+   * `transactionRequest.value` when omitted.
+   */
+  readonly value?: bigint | string;
 }
 /**
  * Assembles a {@link SimulateRequest} from a compile result and the
@@ -57,6 +57,6 @@ interface BuildSimulateRequestInput {
  * const sim = await sdk.client.simulate(req);
  * ```
  */
-declare const buildSimulateRequest: (input: BuildSimulateRequestInput) => SimulateRequest;
-
-export { type BuildSimulateRequestInput, buildSimulateRequest };
+export declare const buildSimulateRequest: (input: BuildSimulateRequestInput) => SimulateRequest;
+//#endregion
+//# sourceMappingURL=simulate.d.ts.map

package/dist/run/simulate.js

@@ -1,22 +1,40 @@
+//#region src/run/simulate.ts
+/**
+* Assembles a {@link SimulateRequest} from a compile result and the
+* caller-supplied chain, signer, and tracked balances. Pure: performs no
+* network I/O, does not mutate its input, and returns a fresh object.
+*
+* Bridges the common case — simulate the transaction you just compiled —
+* without coupling raw-transaction simulation to the flow builder. The
+* `value` defaults to the compiled transaction's value unless overridden.
+*
+* @example
+* ```ts
+* const compiled = await builder.compile({ inputs: { ... }, signer: '0x1111...' });
+* const req = buildSimulateRequest({
+*   result: compiled,
+*   chainId: 1,
+*   signer: '0x1111111111111111111111111111111111111111',
+*   trackedBalances: [{ token: '0xA0b8...', owner: '0x1111...' }],
+* });
+* const sim = await sdk.client.simulate(req);
+* ```
+*/
 const buildSimulateRequest = (input) => {
-  const { result, chainId, signer, trackedBalances, requirements, block } = input;
-  if (result.transactionRequest === void 0) {
-    throw new Error(
-      "buildSimulateRequest: the compile result has no transactionRequest (empty compiled program \u2014 a settle-only external-funding flow); submit the `actions` entries instead of simulating"
-    );
-  }
-  return {
-    chainId,
-    from: signer,
-    to: result.transactionRequest.to,
-    data: result.transactionRequest.data,
-    value: input.value ?? result.transactionRequest.value,
-    block,
-    requirements,
-    trackedBalances
-  };
-};
-export {
-  buildSimulateRequest
+	const { result, chainId, signer, trackedBalances, requirements, block } = input;
+	if (result.transactionRequest === void 0) throw new Error("buildSimulateRequest: the compile result has no transactionRequest (empty compiled program — a settle-only external-funding flow); submit the `actions` entries instead of simulating");
+	return {
+		chainId,
+		from: signer,
+		to: result.transactionRequest.to,
+		data: result.transactionRequest.data,
+		value: input.value ?? result.transactionRequest.value,
+		block,
+		requirements,
+		trackedBalances
+	};
 };
+//#endregion
+export { buildSimulateRequest };
+
 //# sourceMappingURL=simulate.js.map

package/dist/run/simulate.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/run/simulate.ts"],"sourcesContent":["import type {\n  ComposeCompileResult,\n  SimulateRequest,\n  SlotFinderRequirement,\n  TrackedBalance,\n} from '@lifi/compose-spec';\n\n/**\n * Input for {@link buildSimulateRequest}: a compile result plus the fields a\n * simulation needs that a compiled flow does not carry.\n */\nexport interface BuildSimulateRequestInput {\n  /**\n   * A result from `builder.compile(...)` / `client.compile(...)`. Both\n   * `success` and `partial` results are valid input — the helper does not\n   * discriminate on `status`. A success result for an empty compiled program\n   * (a settle-only `funding: 'external'` flow) carries no\n   * `transactionRequest`; there is nothing to simulate and this helper\n   * throws — submit the result's `actions` entries directly instead.\n   */\n  readonly result: ComposeCompileResult;\n  /** EVM chain id. A compile result does not carry the target chain. */\n  readonly chainId: number;\n  /**\n   * The transaction sender (`from`). A compile result does not carry the\n   * signer, so it must be supplied here.\n   */\n  readonly signer: string;\n  /**\n   * Balances to watch across the simulation. These cannot be inferred from a\n   * flow and must be supplied by the caller.\n   */\n  readonly trackedBalances: readonly TrackedBalance[];\n  /** Optional funding instructions applied before simulation. */\n  readonly requirements?: readonly SlotFinderRequirement[];\n  /** Optional block to pin the simulation to. Omitted ⇒ chain head. */\n  readonly block?: number;\n  /**\n   * Optional native value override. Defaults to the compiled\n   * `transactionRequest.value` when omitted.\n   */\n  readonly value?: bigint | string;\n}\n\n/**\n * Assembles a {@link SimulateRequest} from a compile result and the\n * caller-supplied chain, signer, and tracked balances. Pure: performs no\n * network I/O, does not mutate its input, and returns a fresh object.\n *\n * Bridges the common case — simulate the transaction you just compiled —\n * without coupling raw-transaction simulation to the flow builder. The\n * `value` defaults to the compiled transaction's value unless overridden.\n *\n * @example\n * ```ts\n * const compiled = await builder.compile({ inputs: { ... }, signer: '0x1111...' });\n * const req = buildSimulateRequest({\n *   result: compiled,\n *   chainId: 1,\n *   signer: '0x1111111111111111111111111111111111111111',\n *   trackedBalances: [{ token: '0xA0b8...', owner: '0x1111...' }],\n * });\n * const sim = await sdk.client.simulate(req);\n * ```\n */\nexport const buildSimulateRequest = (\n  input: BuildSimulateRequestInput,\n): SimulateRequest => {\n  const { result, chainId, signer, trackedBalances, requirements, block } =\n    input;\n  // A settle-only flow authored with `funding: 'external'` compiles to an\n  // empty program: the success response carries no `transactionRequest`, so\n  // there is nothing to simulate — the required submissions are the\n  // `actions` entries, submitted directly.\n  if (result.transactionRequest === undefined) {\n    throw new Error(\n      'buildSimulateRequest: the compile result has no transactionRequest (empty compiled program — a settle-only external-funding flow); submit the `actions` entries instead of simulating',\n    );\n  }\n  return {\n    chainId,\n    from: signer,\n    to: result.transactionRequest.to,\n    data: result.transactionRequest.data,\n    value: input.value ?? result.transactionRequest.value,\n    block,\n    requirements,\n    trackedBalances,\n  };\n};\n"],"mappings":"AAiEO,MAAM,uBAAuB,CAClC,UACoB;AACpB,QAAM,EAAE,QAAQ,SAAS,QAAQ,iBAAiB,cAAc,MAAM,IACpE;AAKF,MAAI,OAAO,uBAAuB,QAAW;AAC3C,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,SAAO;AAAA,IACL;AAAA,IACA,MAAM;AAAA,IACN,IAAI,OAAO,mBAAmB;AAAA,IAC9B,MAAM,OAAO,mBAAmB;AAAA,IAChC,OAAO,MAAM,SAAS,OAAO,mBAAmB;AAAA,IAChD;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;","names":[]}
+{"version":3,"file":"simulate.js","names":[],"sources":["../../src/run/simulate.ts"],"sourcesContent":["import type {\n  ComposeCompileResult,\n  SimulateRequest,\n  SlotFinderRequirement,\n  TrackedBalance,\n} from '@lifi/compose-spec';\n\n/**\n * Input for {@link buildSimulateRequest}: a compile result plus the fields a\n * simulation needs that a compiled flow does not carry.\n */\nexport interface BuildSimulateRequestInput {\n  /**\n   * A result from `builder.compile(...)` / `client.compile(...)`. Both\n   * `success` and `partial` results are valid input — the helper does not\n   * discriminate on `status`. A success result for an empty compiled program\n   * (a settle-only `funding: 'external'` flow) carries no\n   * `transactionRequest`; there is nothing to simulate and this helper\n   * throws — submit the result's `actions` entries directly instead.\n   */\n  readonly result: ComposeCompileResult;\n  /** EVM chain id. A compile result does not carry the target chain. */\n  readonly chainId: number;\n  /**\n   * The transaction sender (`from`). A compile result does not carry the\n   * signer, so it must be supplied here.\n   */\n  readonly signer: string;\n  /**\n   * Balances to watch across the simulation. These cannot be inferred from a\n   * flow and must be supplied by the caller.\n   */\n  readonly trackedBalances: readonly TrackedBalance[];\n  /** Optional funding instructions applied before simulation. */\n  readonly requirements?: readonly SlotFinderRequirement[];\n  /** Optional block to pin the simulation to. Omitted ⇒ chain head. */\n  readonly block?: number;\n  /**\n   * Optional native value override. Defaults to the compiled\n   * `transactionRequest.value` when omitted.\n   */\n  readonly value?: bigint | string;\n}\n\n/**\n * Assembles a {@link SimulateRequest} from a compile result and the\n * caller-supplied chain, signer, and tracked balances. Pure: performs no\n * network I/O, does not mutate its input, and returns a fresh object.\n *\n * Bridges the common case — simulate the transaction you just compiled —\n * without coupling raw-transaction simulation to the flow builder. The\n * `value` defaults to the compiled transaction's value unless overridden.\n *\n * @example\n * ```ts\n * const compiled = await builder.compile({ inputs: { ... }, signer: '0x1111...' });\n * const req = buildSimulateRequest({\n *   result: compiled,\n *   chainId: 1,\n *   signer: '0x1111111111111111111111111111111111111111',\n *   trackedBalances: [{ token: '0xA0b8...', owner: '0x1111...' }],\n * });\n * const sim = await sdk.client.simulate(req);\n * ```\n */\nexport const buildSimulateRequest = (\n  input: BuildSimulateRequestInput,\n): SimulateRequest => {\n  const { result, chainId, signer, trackedBalances, requirements, block } =\n    input;\n  // A settle-only flow authored with `funding: 'external'` compiles to an\n  // empty program: the success response carries no `transactionRequest`, so\n  // there is nothing to simulate — the required submissions are the\n  // `actions` entries, submitted directly.\n  if (result.transactionRequest === undefined) {\n    throw new Error(\n      'buildSimulateRequest: the compile result has no transactionRequest (empty compiled program — a settle-only external-funding flow); submit the `actions` entries instead of simulating',\n    );\n  }\n  return {\n    chainId,\n    from: signer,\n    to: result.transactionRequest.to,\n    data: result.transactionRequest.data,\n    value: input.value ?? result.transactionRequest.value,\n    block,\n    requirements,\n    trackedBalances,\n  };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAiEA,MAAa,wBACX,UACoB;CACpB,MAAM,EAAE,QAAQ,SAAS,QAAQ,iBAAiB,cAAc,UAC9D;CAKF,IAAI,OAAO,uBAAuB,KAAA,GAChC,MAAM,IAAI,MACR,uLACF;CAEF,OAAO;EACL;EACA,MAAM;EACN,IAAI,OAAO,mBAAmB;EAC9B,MAAM,OAAO,mBAAmB;EAChC,OAAO,MAAM,SAAS,OAAO,mBAAmB;EAChD;EACA;EACA;CACF;AACF"}

package/dist/sdk.cjs

@@ -1,69 +1,58 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var sdk_exports = {};
-__export(sdk_exports, {
-  createComposeSdk: () => createComposeSdk
-});
-module.exports = __toCommonJS(sdk_exports);
-var import_FlowBuilderCore = require("./authoring/FlowBuilderCore.js");
-var import_client = require("./client.js");
-var import_operations_generated = require("./generated/operations.generated.js");
-var import_inputs = require("./run/inputs.js");
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_client = require("./client.cjs");
+const require_run_inputs = require("./run/inputs.cjs");
+const require_authoring_FlowBuilderCore = require("./authoring/FlowBuilderCore.cjs");
+const require_generated_operations_generated = require("./generated/operations.generated.cjs");
+//#region src/sdk.ts
+/**
+* Creates a new Compose SDK instance.
+*
+* @param options - SDK configuration including the API base URL, required API key, and optional fetch implementation.
+* @returns A {@link ComposeSdk} instance.
+*
+* @example
+* ```ts
+* const sdk = createComposeSdk({ baseUrl: 'https://li.quest', apiKey: 'YOUR_API_KEY' });
+* ```
+*/
 const createComposeSdk = (options) => {
-  const composeClient = (0, import_client.createComposeClient)(options);
-  const request = (flowDoc, run) => ({
-    flow: flowDoc,
-    run: (0, import_inputs.buildRun)({
-      inputs: run.inputs,
-      preconditions: run.preconditions,
-      signer: run.signer,
-      assumptions: run.assumptions,
-      referrer: run.referrer,
-      integratorFeeBps: run.integratorFeeBps,
-      maxPriceImpactBps: run.maxPriceImpactBps,
-      sweepTo: run.sweepTo,
-      simulationPolicy: run.simulationPolicy,
-      simulateUserProgram: run.simulateUserProgram,
-      checkOnChainAllowances: run.checkOnChainAllowances
-    })
-  });
-  const flow = (chainId, opts) => {
-    const core = (0, import_FlowBuilderCore.createFlowBuilderCore)(chainId, opts);
-    const builder = Object.assign(core, (0, import_operations_generated.bindGeneratedOps)(core));
-    const compile = async (run) => {
-      const flowDoc = builder.build();
-      const req = request(flowDoc, run);
-      return composeClient.compile(req);
-    };
-    return Object.assign(builder, { compile });
-  };
-  return {
-    client: composeClient,
-    flow,
-    getSupportedChains: composeClient.getChains,
-    request,
-    route: composeClient.route,
-    simulate: composeClient.simulate
-  };
+	const composeClient = require_client.createComposeClient(options);
+	const request = (flowDoc, run) => ({
+		flow: flowDoc,
+		run: require_run_inputs.buildRun({
+			inputs: run.inputs,
+			preconditions: run.preconditions,
+			signer: run.signer,
+			assumptions: run.assumptions,
+			referrer: run.referrer,
+			integratorFeeBps: run.integratorFeeBps,
+			maxPriceImpactBps: run.maxPriceImpactBps,
+			sweepTo: run.sweepTo,
+			simulationPolicy: run.simulationPolicy,
+			simulateUserProgram: run.simulateUserProgram,
+			checkOnChainAllowances: run.checkOnChainAllowances
+		})
+	});
+	const flow = (chainId, opts) => {
+		const core = require_authoring_FlowBuilderCore.createFlowBuilderCore(chainId, opts);
+		const builder = Object.assign(core, require_generated_operations_generated.bindGeneratedOps(core));
+		const compile = async (run) => {
+			const flowDoc = builder.build();
+			const req = request(flowDoc, run);
+			return composeClient.compile(req);
+		};
+		return Object.assign(builder, { compile });
+	};
+	return {
+		client: composeClient,
+		flow,
+		getSupportedChains: composeClient.getChains,
+		request,
+		route: composeClient.route,
+		simulate: composeClient.simulate
+	};
 };
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  createComposeSdk
-});
+//#endregion
+exports.createComposeSdk = createComposeSdk;
+
 //# sourceMappingURL=sdk.cjs.map

package/dist/sdk.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/sdk.ts"],"sourcesContent":["import type {\n  ComposeCompileRequest,\n  ComposeCompileResult,\n  ComposeRouteRequest,\n  InputSpec,\n  SimulateRequest,\n  SimulateResult,\n} from '@lifi/compose-spec';\n\nimport {\n  createFlowBuilderCore,\n  type FlowBuilderCore,\n  type FlowOptions,\n  type TypedFlow,\n} from './authoring/FlowBuilderCore.js';\nimport { type ComposeClient, createComposeClient } from './client.js';\nimport type { ChainSummary } from './discovery.js';\nimport {\n  bindGeneratedOps,\n  type GeneratedOps,\n} from './generated/operations.generated.js';\nimport { buildRun, type ComposeRunInput } from './run/inputs.js';\nimport type { InputSchema } from './types.js';\n\nexport type { ComposeRunInput };\n\n/**\n * A flow builder augmented with generated operation methods and a `compile` method\n * that submits the flow to the Compose backend for compilation.\n *\n * Created via {@link ComposeSdk.flow}.\n *\n * @typeParam T - The input schema describing the flow's required inputs.\n */\nexport type FlowBuilder<T extends InputSchema = InputSchema> =\n  FlowBuilderCore<T> &\n    GeneratedOps & {\n      /**\n       * Builds the flow document from the current builder state and submits it\n       * to the Compose API for compilation.\n       *\n       * @param run - Runtime inputs, preconditions, and signer address.\n       * @returns The compiled transaction calldata and metadata.\n       * @throws {@link ComposeError} on network, validation, or server errors.\n       *\n       * @example\n       * ```ts\n       * const result = await builder.compile({\n       *   inputs: { token: materialisers.balanceOf({}) },\n       *   signer: '0xYourAddress...',\n       * });\n       * console.log(result.calldata);\n       * ```\n       */\n      readonly compile: (\n        run: ComposeRunInput<T>,\n      ) => Promise<ComposeCompileResult>;\n    };\n\n/**\n * Configuration for creating a Compose SDK instance.\n */\nexport interface ComposeSdkOptions {\n  /** Base URL of the Compose API (e.g. `\"https://li.quest\"`). */\n  readonly baseUrl: string;\n  /** Optional custom `fetch` implementation. Defaults to `globalThis.fetch`. */\n  readonly fetch?: typeof globalThis.fetch;\n  /** LI.FI API key, sent as the `x-lifi-api-key` header on every request. Required — the Compose API rejects unauthenticated requests. */\n  readonly apiKey: string;\n}\n\n/**\n * The top-level Compose SDK interface.\n *\n * Provides methods to build flows, compile them into executable calldata, and\n * interact with the Compose API directly.\n *\n * @example\n * ```ts\n * import { createComposeSdk, resources, materialisers } from '@lifi/composer-sdk';\n *\n * const sdk = createComposeSdk({ baseUrl: 'https://li.quest', apiKey: 'YOUR_API_KEY' });\n *\n * const builder = sdk.flow(1, {\n *   inputs: { usdc: resources.erc20('0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', 1) },\n * });\n *\n * builder.lifi.swap('swap1', {\n *   bind: { amountIn: builder.inputs.usdc },\n *   config: { resourceOut: resources.native(1) },\n * });\n *\n * const result = await builder.compile({\n *   inputs: { usdc: materialisers.balanceOf({}) },\n *   signer: '0xYourAddress...',\n * });\n * ```\n */\nexport interface ComposeSdk {\n  /** Low-level HTTP client for the Compose API. */\n  readonly client: ComposeClient;\n  /**\n   * Creates a new flow builder targeting the given chain.\n   * @param chainId - The EVM chain ID (e.g. `1` for Ethereum mainnet).\n   * @param options - Flow configuration including input declarations.\n   * @returns A {@link FlowBuilder} with generated operation methods and a `compile` method.\n   * @throws Error if any resource input's `chainId` doesn't match the flow's `chainId`.\n   */\n  readonly flow: <T extends InputSchema>(\n    chainId: number,\n    options: FlowOptions<T>,\n  ) => FlowBuilder<T>;\n  /**\n   * Fetches the chains this Compose deployment supports, ascending by\n   * `chainId`. Thin pass-through to {@link ComposeClient.getChains}; see it\n   * for what \"supported\" means and for the caching caveat.\n   *\n   * Each entry pairs the `chainId` with a display `name`, so one call both\n   * gates a chain selector and labels it. Key on `chainId`; `name` is a\n   * deployment-maintained label that can change.\n   *\n   * Use it to fail fast before building a flow for a chain the server would\n   * reject.\n   *\n   * @returns The supported chains, ascending by `chainId`.\n   * @throws {@link ComposeError} on network or server errors.\n   *\n   * @example\n   * ```ts\n   * const chains = await sdk.getSupportedChains();\n   * if (!chains.some((c) => c.chainId === 8453)) {\n   *   throw new Error('Base is not supported');\n   * }\n   * for (const { chainId, name } of chains) {\n   *   console.log(`${name} (${chainId})`);\n   * }\n   * ```\n   */\n  readonly getSupportedChains: () => Promise<readonly ChainSummary[]>;\n  /**\n   * Builds a raw compile request without sending it. Useful for inspecting the\n   * request payload or submitting it through a custom transport.\n   * @param flow - A built flow document (from `builder.build()`).\n   * @param run - Runtime inputs, preconditions, and signer address.\n   * @returns A {@link ComposeCompileRequest} ready to send to the Compose API.\n   */\n  readonly request: <T extends InputSchema>(\n    flow: TypedFlow<T>,\n    run: ComposeRunInput<T>,\n  ) => ComposeCompileRequest;\n  /**\n   * Compiles a token pair on one chain into a submit-ready transaction. Thin\n   * pass-through to {@link ComposeClient.route}; see it for the short chain of\n   * catalog edges the server plans, when to prefer `flow(...).compile(...)`,\n   * the `success` / `partial` discrimination, and error behaviour. Build the\n   * `amount` with `routeAmount.exact(...)` / `routeAmount.all(...)`.\n   *\n   * @param request - The from/to token pair, amount, signer, and route options.\n   * @returns A discriminated result: `status: 'success'` or `status: 'partial'`.\n   * @throws {@link ComposeError} on network, validation, or server errors.\n   */\n  readonly route: (\n    request: ComposeRouteRequest,\n  ) => Promise<ComposeCompileResult>;\n  /**\n   * Simulates a raw, pre-encoded transaction. Thin pass-through to\n   * {@link ComposeClient.simulate}; see it for the `ok` / `revert` / `error`\n   * result discrimination and error behaviour. Pair with `buildSimulateRequest`\n   * to assemble the request from a compile result.\n   *\n   * @param request - The raw transaction plus funding `requirements` and\n   *   `trackedBalances`.\n   * @returns A {@link SimulateResult} (`ok` / `revert` / `error`).\n   * @throws {@link ComposeError} on network, validation, or server errors.\n   */\n  readonly simulate: (request: SimulateRequest) => Promise<SimulateResult>;\n}\n\n/**\n * Creates a new Compose SDK instance.\n *\n * @param options - SDK configuration including the API base URL, required API key, and optional fetch implementation.\n * @returns A {@link ComposeSdk} instance.\n *\n * @example\n * ```ts\n * const sdk = createComposeSdk({ baseUrl: 'https://li.quest', apiKey: 'YOUR_API_KEY' });\n * ```\n */\nexport const createComposeSdk = (options: ComposeSdkOptions): ComposeSdk => {\n  const composeClient = createComposeClient(options);\n\n  const request = <T extends InputSchema>(\n    flowDoc: TypedFlow<T>,\n    run: ComposeRunInput<T>,\n  ): ComposeCompileRequest => ({\n    flow: flowDoc,\n    run: buildRun({\n      inputs: run.inputs as Record<string, InputSpec>,\n      preconditions: run.preconditions,\n      signer: run.signer,\n      assumptions: run.assumptions as Record<string, bigint> | undefined,\n      referrer: run.referrer,\n      integratorFeeBps: run.integratorFeeBps,\n      maxPriceImpactBps: run.maxPriceImpactBps,\n      sweepTo: run.sweepTo,\n      simulationPolicy: run.simulationPolicy,\n      simulateUserProgram: run.simulateUserProgram,\n      checkOnChainAllowances: run.checkOnChainAllowances,\n    }),\n  });\n\n  const flow = <T extends InputSchema>(\n    chainId: number,\n    opts: FlowOptions<T>,\n  ): FlowBuilder<T> => {\n    const core = createFlowBuilderCore(chainId, opts);\n    const builder = Object.assign(core, bindGeneratedOps(core));\n\n    const compile = async (\n      run: ComposeRunInput<T>,\n    ): Promise<ComposeCompileResult> => {\n      const flowDoc = builder.build();\n      const req = request(flowDoc, run);\n      return composeClient.compile(req);\n    };\n\n    return Object.assign(builder, { compile });\n  };\n\n  return {\n    client: composeClient,\n    flow,\n    getSupportedChains: composeClient.getChains,\n    request,\n    route: composeClient.route,\n    simulate: composeClient.simulate,\n  };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AASA,6BAKO;AACP,oBAAwD;AAExD,kCAGO;AACP,oBAA+C;AAwKxC,MAAM,mBAAmB,CAAC,YAA2C;AAC1E,QAAM,oBAAgB,mCAAoB,OAAO;AAEjD,QAAM,UAAU,CACd,SACA,SAC2B;AAAA,IAC3B,MAAM;AAAA,IACN,SAAK,wBAAS;AAAA,MACZ,QAAQ,IAAI;AAAA,MACZ,eAAe,IAAI;AAAA,MACnB,QAAQ,IAAI;AAAA,MACZ,aAAa,IAAI;AAAA,MACjB,UAAU,IAAI;AAAA,MACd,kBAAkB,IAAI;AAAA,MACtB,mBAAmB,IAAI;AAAA,MACvB,SAAS,IAAI;AAAA,MACb,kBAAkB,IAAI;AAAA,MACtB,qBAAqB,IAAI;AAAA,MACzB,wBAAwB,IAAI;AAAA,IAC9B,CAAC;AAAA,EACH;AAEA,QAAM,OAAO,CACX,SACA,SACmB;AACnB,UAAM,WAAO,8CAAsB,SAAS,IAAI;AAChD,UAAM,UAAU,OAAO,OAAO,UAAM,8CAAiB,IAAI,CAAC;AAE1D,UAAM,UAAU,OACd,QACkC;AAClC,YAAM,UAAU,QAAQ,MAAM;AAC9B,YAAM,MAAM,QAAQ,SAAS,GAAG;AAChC,aAAO,cAAc,QAAQ,GAAG;AAAA,IAClC;AAEA,WAAO,OAAO,OAAO,SAAS,EAAE,QAAQ,CAAC;AAAA,EAC3C;AAEA,SAAO;AAAA,IACL,QAAQ;AAAA,IACR;AAAA,IACA,oBAAoB,cAAc;AAAA,IAClC;AAAA,IACA,OAAO,cAAc;AAAA,IACrB,UAAU,cAAc;AAAA,EAC1B;AACF;","names":[]}
+{"version":3,"file":"sdk.cjs","names":["createComposeClient","buildRun","createFlowBuilderCore","bindGeneratedOps"],"sources":["../src/sdk.ts"],"sourcesContent":["import type {\n  ComposeCompileRequest,\n  ComposeCompileResult,\n  ComposeRouteRequest,\n  InputSpec,\n  SimulateRequest,\n  SimulateResult,\n} from '@lifi/compose-spec';\n\nimport {\n  createFlowBuilderCore,\n  type FlowBuilderCore,\n  type FlowOptions,\n  type TypedFlow,\n} from './authoring/FlowBuilderCore.js';\nimport { type ComposeClient, createComposeClient } from './client.js';\nimport type { ChainSummary } from './discovery.js';\nimport {\n  bindGeneratedOps,\n  type GeneratedOps,\n} from './generated/operations.generated.js';\nimport { buildRun, type ComposeRunInput } from './run/inputs.js';\nimport type { InputSchema } from './types.js';\n\nexport type { ComposeRunInput };\n\n/**\n * A flow builder augmented with generated operation methods and a `compile` method\n * that submits the flow to the Compose backend for compilation.\n *\n * Created via {@link ComposeSdk.flow}.\n *\n * @typeParam T - The input schema describing the flow's required inputs.\n */\nexport type FlowBuilder<T extends InputSchema = InputSchema> =\n  FlowBuilderCore<T> &\n    GeneratedOps & {\n      /**\n       * Builds the flow document from the current builder state and submits it\n       * to the Compose API for compilation.\n       *\n       * @param run - Runtime inputs, preconditions, and signer address.\n       * @returns The compiled transaction calldata and metadata.\n       * @throws {@link ComposeError} on network, validation, or server errors.\n       *\n       * @example\n       * ```ts\n       * const result = await builder.compile({\n       *   inputs: { token: materialisers.balanceOf({}) },\n       *   signer: '0xYourAddress...',\n       * });\n       * console.log(result.calldata);\n       * ```\n       */\n      readonly compile: (\n        run: ComposeRunInput<T>,\n      ) => Promise<ComposeCompileResult>;\n    };\n\n/**\n * Configuration for creating a Compose SDK instance.\n */\nexport interface ComposeSdkOptions {\n  /** Base URL of the Compose API (e.g. `\"https://li.quest\"`). */\n  readonly baseUrl: string;\n  /** Optional custom `fetch` implementation. Defaults to `globalThis.fetch`. */\n  readonly fetch?: typeof globalThis.fetch;\n  /** LI.FI API key, sent as the `x-lifi-api-key` header on every request. Required — the Compose API rejects unauthenticated requests. */\n  readonly apiKey: string;\n}\n\n/**\n * The top-level Compose SDK interface.\n *\n * Provides methods to build flows, compile them into executable calldata, and\n * interact with the Compose API directly.\n *\n * @example\n * ```ts\n * import { createComposeSdk, resources, materialisers } from '@lifi/composer-sdk';\n *\n * const sdk = createComposeSdk({ baseUrl: 'https://li.quest', apiKey: 'YOUR_API_KEY' });\n *\n * const builder = sdk.flow(1, {\n *   inputs: { usdc: resources.erc20('0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', 1) },\n * });\n *\n * builder.lifi.swap('swap1', {\n *   bind: { amountIn: builder.inputs.usdc },\n *   config: { resourceOut: resources.native(1) },\n * });\n *\n * const result = await builder.compile({\n *   inputs: { usdc: materialisers.balanceOf({}) },\n *   signer: '0xYourAddress...',\n * });\n * ```\n */\nexport interface ComposeSdk {\n  /** Low-level HTTP client for the Compose API. */\n  readonly client: ComposeClient;\n  /**\n   * Creates a new flow builder targeting the given chain.\n   * @param chainId - The EVM chain ID (e.g. `1` for Ethereum mainnet).\n   * @param options - Flow configuration including input declarations.\n   * @returns A {@link FlowBuilder} with generated operation methods and a `compile` method.\n   * @throws Error if any resource input's `chainId` doesn't match the flow's `chainId`.\n   */\n  readonly flow: <T extends InputSchema>(\n    chainId: number,\n    options: FlowOptions<T>,\n  ) => FlowBuilder<T>;\n  /**\n   * Fetches the chains this Compose deployment supports, ascending by\n   * `chainId`. Thin pass-through to {@link ComposeClient.getChains}; see it\n   * for what \"supported\" means and for the caching caveat.\n   *\n   * Each entry pairs the `chainId` with a display `name`, so one call both\n   * gates a chain selector and labels it. Key on `chainId`; `name` is a\n   * deployment-maintained label that can change.\n   *\n   * Use it to fail fast before building a flow for a chain the server would\n   * reject.\n   *\n   * @returns The supported chains, ascending by `chainId`.\n   * @throws {@link ComposeError} on network or server errors.\n   *\n   * @example\n   * ```ts\n   * const chains = await sdk.getSupportedChains();\n   * if (!chains.some((c) => c.chainId === 8453)) {\n   *   throw new Error('Base is not supported');\n   * }\n   * for (const { chainId, name } of chains) {\n   *   console.log(`${name} (${chainId})`);\n   * }\n   * ```\n   */\n  readonly getSupportedChains: () => Promise<readonly ChainSummary[]>;\n  /**\n   * Builds a raw compile request without sending it. Useful for inspecting the\n   * request payload or submitting it through a custom transport.\n   * @param flow - A built flow document (from `builder.build()`).\n   * @param run - Runtime inputs, preconditions, and signer address.\n   * @returns A {@link ComposeCompileRequest} ready to send to the Compose API.\n   */\n  readonly request: <T extends InputSchema>(\n    flow: TypedFlow<T>,\n    run: ComposeRunInput<T>,\n  ) => ComposeCompileRequest;\n  /**\n   * Compiles a token pair on one chain into a submit-ready transaction. Thin\n   * pass-through to {@link ComposeClient.route}; see it for the short chain of\n   * catalog edges the server plans, when to prefer `flow(...).compile(...)`,\n   * the `success` / `partial` discrimination, and error behaviour. Build the\n   * `amount` with `routeAmount.exact(...)` / `routeAmount.all(...)`.\n   *\n   * @param request - The from/to token pair, amount, signer, and route options.\n   * @returns A discriminated result: `status: 'success'` or `status: 'partial'`.\n   * @throws {@link ComposeError} on network, validation, or server errors.\n   */\n  readonly route: (\n    request: ComposeRouteRequest,\n  ) => Promise<ComposeCompileResult>;\n  /**\n   * Simulates a raw, pre-encoded transaction. Thin pass-through to\n   * {@link ComposeClient.simulate}; see it for the `ok` / `revert` / `error`\n   * result discrimination and error behaviour. Pair with `buildSimulateRequest`\n   * to assemble the request from a compile result.\n   *\n   * @param request - The raw transaction plus funding `requirements` and\n   *   `trackedBalances`.\n   * @returns A {@link SimulateResult} (`ok` / `revert` / `error`).\n   * @throws {@link ComposeError} on network, validation, or server errors.\n   */\n  readonly simulate: (request: SimulateRequest) => Promise<SimulateResult>;\n}\n\n/**\n * Creates a new Compose SDK instance.\n *\n * @param options - SDK configuration including the API base URL, required API key, and optional fetch implementation.\n * @returns A {@link ComposeSdk} instance.\n *\n * @example\n * ```ts\n * const sdk = createComposeSdk({ baseUrl: 'https://li.quest', apiKey: 'YOUR_API_KEY' });\n * ```\n */\nexport const createComposeSdk = (options: ComposeSdkOptions): ComposeSdk => {\n  const composeClient = createComposeClient(options);\n\n  const request = <T extends InputSchema>(\n    flowDoc: TypedFlow<T>,\n    run: ComposeRunInput<T>,\n  ): ComposeCompileRequest => ({\n    flow: flowDoc,\n    run: buildRun({\n      inputs: run.inputs as Record<string, InputSpec>,\n      preconditions: run.preconditions,\n      signer: run.signer,\n      assumptions: run.assumptions as Record<string, bigint> | undefined,\n      referrer: run.referrer,\n      integratorFeeBps: run.integratorFeeBps,\n      maxPriceImpactBps: run.maxPriceImpactBps,\n      sweepTo: run.sweepTo,\n      simulationPolicy: run.simulationPolicy,\n      simulateUserProgram: run.simulateUserProgram,\n      checkOnChainAllowances: run.checkOnChainAllowances,\n    }),\n  });\n\n  const flow = <T extends InputSchema>(\n    chainId: number,\n    opts: FlowOptions<T>,\n  ): FlowBuilder<T> => {\n    const core = createFlowBuilderCore(chainId, opts);\n    const builder = Object.assign(core, bindGeneratedOps(core));\n\n    const compile = async (\n      run: ComposeRunInput<T>,\n    ): Promise<ComposeCompileResult> => {\n      const flowDoc = builder.build();\n      const req = request(flowDoc, run);\n      return composeClient.compile(req);\n    };\n\n    return Object.assign(builder, { compile });\n  };\n\n  return {\n    client: composeClient,\n    flow,\n    getSupportedChains: composeClient.getChains,\n    request,\n    route: composeClient.route,\n    simulate: composeClient.simulate,\n  };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;AA6LA,MAAa,oBAAoB,YAA2C;CAC1E,MAAM,gBAAgBA,eAAAA,oBAAoB,OAAO;CAEjD,MAAM,WACJ,SACA,SAC2B;EAC3B,MAAM;EACN,KAAKC,mBAAAA,SAAS;GACZ,QAAQ,IAAI;GACZ,eAAe,IAAI;GACnB,QAAQ,IAAI;GACZ,aAAa,IAAI;GACjB,UAAU,IAAI;GACd,kBAAkB,IAAI;GACtB,mBAAmB,IAAI;GACvB,SAAS,IAAI;GACb,kBAAkB,IAAI;GACtB,qBAAqB,IAAI;GACzB,wBAAwB,IAAI;EAC9B,CAAC;CACH;CAEA,MAAM,QACJ,SACA,SACmB;EACnB,MAAM,OAAOC,kCAAAA,sBAAsB,SAAS,IAAI;EAChD,MAAM,UAAU,OAAO,OAAO,MAAMC,uCAAAA,iBAAiB,IAAI,CAAC;EAE1D,MAAM,UAAU,OACd,QACkC;GAClC,MAAM,UAAU,QAAQ,MAAM;GAC9B,MAAM,MAAM,QAAQ,SAAS,GAAG;GAChC,OAAO,cAAc,QAAQ,GAAG;EAClC;EAEA,OAAO,OAAO,OAAO,SAAS,EAAE,QAAQ,CAAC;CAC3C;CAEA,OAAO;EACL,QAAQ;EACR;EACA,oBAAoB,cAAc;EAClC;EACA,OAAO,cAAc;EACrB,UAAU,cAAc;CAC1B;AACF"}