@lifi/composer-sdk 0.4.0-staging.1 → 0.4.1

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/client.ts"],"sourcesContent":["import type {\n  ComposeCompilePartialData,\n  ComposeCompileRequest,\n  ComposeCompileResult,\n  ComposeCompileSuccessData,\n  ComposeManifest,\n  SimulateRequest,\n  SimulateResult,\n} from '@lifi/compose-spec';\n\nimport type { GetZapPacksOptions, ZapPackOverview } from './discovery.js';\nimport { ComposeError, errorFromHttpResponse } from './errors.js';\nimport {\n  parseCompilePartialEnvelope,\n  parseSimulateResult,\n} from './responseSchemas.js';\n\n// __SDK_VERSION__ is a compile-time constant injected by tsup (via `define` in tsup.config.ts)\n// and by vitest (via `define` in vitest.config.ts). Both read the version from package.json\n// at build/test time and replace this identifier with the literal string value.\n// It is sent as the `x-lifi-composer-sdk` request header so the server can identify the caller.\n// Falls back to 'dev' when running via tsx without tsup substitution (e.g. the example harness).\ndeclare const __SDK_VERSION__: string;\n\nconst SDK_VERSION: string =\n  typeof __SDK_VERSION__ !== 'undefined' ? __SDK_VERSION__ : 'dev';\n\n/**\n * Configuration for creating a low-level Compose API client.\n */\nexport interface ComposeClientOptions {\n  /** Base URL of the Compose API. */\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 * Low-level HTTP client for the Compose API.\n *\n * Handles request serialization, SDK version headers, and error mapping.\n * Prefer using {@link ComposeSdk} for the full builder experience. Use this\n * directly when you need to decouple request building from submission — e.g.\n * build via `sdk.request()` then submit via `client.compile()` with custom\n * retry logic or request inspection.\n */\nexport interface ComposeClient {\n  /**\n   * Fetches the server's operation manifest describing all supported operations,\n   * guards, materialisers, and preconditions.\n   * @returns The manifest document.\n   * @throws {@link ComposeError} on network, validation, or server errors.\n   */\n  readonly getManifest: () => Promise<ComposeManifest>;\n  /**\n   * Submits a compile request and returns the result.\n   *\n   * When the caller passes `simulationPolicy: 'allow-revert'` and the transaction\n   * reverts in simulation, the server responds with HTTP 206 and the SDK returns a\n   * partial result (`status: 'partial'`) instead of throwing. The partial result\n   * includes the transaction (without `gasLimit`) and revert diagnostics.\n   *\n   * @param request - The full compile request including flow and run inputs.\n   * @returns A discriminated result: `status: 'success'` or `status: 'partial'`.\n   * @throws {@link ComposeError} on network, validation, or server errors.\n   */\n  readonly compile: (\n    request: ComposeCompileRequest,\n  ) => Promise<ComposeCompileResult>;\n  /**\n   * Fetches the available routing edges grouped by protocol.\n   *\n   * The edge catalog is dynamic — it reflects the current state of the\n   * backend's routing snapshot (protocols, chains, token blacklists).\n   * Results are not cached by the SDK; callers should cache as appropriate.\n   *\n   * @param options - Optional filter to restrict results to specific protocols.\n   * @returns An array of {@link ZapPackOverview} objects, one per protocol.\n   * @throws {@link ComposeError} on network or server errors (503 when the\n   *   routing catalog is not yet initialized).\n   */\n  readonly getZapPacks: (\n    options?: GetZapPacksOptions,\n  ) => Promise<readonly ZapPackOverview[]>;\n  /**\n   * Simulates a raw, pre-encoded transaction against `POST /simulate` and\n   * reports how the watched balances change and how much inner-call gas it\n   * burns.\n   *\n   * The result is a discriminated union on `status`:\n   * - `'ok'` — the simulation ran successfully; `deltas`/`gasUsed` are populated.\n   * - `'revert'` — the simulation ran but the transaction reverted on-chain. A\n   *   revert is a *successful simulation*, not a transport error, so it is\n   *   returned (HTTP 200) rather than thrown — mirroring how {@link compile}\n   *   returns `status: 'partial'` on a simulated revert.\n   * - `'error'` — the request was well-formed but the simulation could not be\n   *   set up or run (HTTP 422); `message` is intentionally generic.\n   *\n   * `bigint` amounts in the request (`value`, requirement `balance`/`allowance`)\n   * are serialised to decimal strings automatically.\n   *\n   * @param request - The raw transaction plus funding `requirements` and the\n   *   `trackedBalances` to watch.\n   * @returns A {@link SimulateResult} (`ok` / `revert` / `error`).\n   * @throws {@link ComposeError} on network failures, HTTP 400 (malformed\n   *   input), 401/403 (auth), 404, 429, and 5xx.\n   */\n  readonly simulate: (request: SimulateRequest) => Promise<SimulateResult>;\n}\n\nconst bigintReplacer = (_key: string, value: unknown): unknown =>\n  typeof value === 'bigint' ? value.toString() : value;\n\nconst isNonNullObject = (v: unknown): v is Record<string, unknown> =>\n  typeof v === 'object' && v !== null;\n\nconst parseBody = async <T>(res: Response, url: string): Promise<T> => {\n  const body = await res.json().catch((_) => null);\n  if (!isNonNullObject(body) || !('data' in body)) {\n    throw new ComposeError('UNKNOWN_ERROR', 'Unexpected response format', {\n      url,\n    });\n  }\n  return body.data as T;\n};\n\nconst parseCompileSuccessBody = async (\n  res: Response,\n  url: string,\n): Promise<ComposeCompileResult> => {\n  const data = await parseBody<ComposeCompileSuccessData>(res, url);\n  return { ...data, status: 'success' as const };\n};\n\nconst parsePartialBody = async (\n  res: Response,\n  url: string,\n): Promise<ComposeCompileResult> => {\n  const body = await res.json().catch((_) => null);\n  const envelope = parseCompilePartialEnvelope(body);\n  if (envelope === null) {\n    throw new ComposeError(\n      'UNKNOWN_ERROR',\n      'Unexpected partial response format',\n      { url },\n    );\n  }\n  // `data` is validated as an object by the schema; compose-spec owns its full\n  // shape as a hand-authored type, so we narrow it here rather than re-declaring\n  // that type as a schema. `error` is fully validated — no cast needed.\n  const data = envelope.data as unknown as ComposeCompilePartialData;\n  return { ...data, status: 'partial' as const, error: envelope.error };\n};\n\n// `/simulate` is un-enveloped: the discriminated body (`{ status, ... }`) is at\n// the top level, NOT wrapped in `{ data }` like `/compose`. So this reads the\n// body directly and validates it against the simulate union rather than reusing\n// `parseBody`.\nconst parseSimulateBody = async (\n  res: Response,\n  url: string,\n): Promise<SimulateResult> => {\n  const body = await res.json().catch((_) => null);\n  const result = parseSimulateResult(body);\n  if (result === null) {\n    throw new ComposeError(\n      'UNKNOWN_ERROR',\n      'Unexpected simulate response format',\n      { url },\n    );\n  }\n  return result;\n};\n\n/**\n * Creates a low-level Compose API client.\n *\n * @param options - Client configuration including the API base URL.\n * @returns A {@link ComposeClient} instance.\n */\nexport const createComposeClient = (\n  options: ComposeClientOptions,\n): ComposeClient => {\n  if (!options.baseUrl || !/^https?:\\/\\//i.test(options.baseUrl)) {\n    throw new ComposeError(\n      'VALIDATION_ERROR',\n      `Invalid baseUrl: expected an HTTP(S) URL, got \"${options.baseUrl}\"`,\n    );\n  }\n  const trimmedApiKey = options.apiKey?.trim() || undefined;\n  if (!trimmedApiKey) {\n    throw new ComposeError(\n      'VALIDATION_ERROR',\n      'apiKey is required: pass a LI.FI API key to createComposeSdk().',\n    );\n  }\n  const fetchFn = options.fetch ?? globalThis.fetch;\n  const base = options.baseUrl.replace(/\\/$/, '');\n\n  const baseHeaders: Record<string, string> = {\n    Accept: 'application/json',\n    'x-lifi-composer-sdk': SDK_VERSION,\n    'x-lifi-api-key': trimmedApiKey,\n  };\n\n  const getManifest = async (): Promise<ComposeManifest> => {\n    const url = `${base}/compose/manifest`;\n    let res: Response;\n    try {\n      res = await fetchFn(url, {\n        method: 'GET',\n        headers: { ...baseHeaders },\n      });\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      throw new ComposeError('NETWORK_ERROR', message, { cause: err });\n    }\n    if (!res.ok) {\n      const body = await res.text();\n      throw errorFromHttpResponse(res.status, body, url);\n    }\n    return await parseBody<ComposeManifest>(res, url);\n  };\n\n  const compile = async (\n    request: ComposeCompileRequest,\n  ): Promise<ComposeCompileResult> => {\n    const url = `${base}/compose`;\n    let res: Response;\n    try {\n      res = await fetchFn(url, {\n        method: 'POST',\n        headers: { ...baseHeaders, 'Content-Type': 'application/json' },\n        body: JSON.stringify(request, bigintReplacer),\n      });\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      throw new ComposeError('NETWORK_ERROR', message, { cause: err });\n    }\n    if (res.status === 206) {\n      return await parsePartialBody(res, url);\n    }\n    if (!res.ok) {\n      const body = await res.text();\n      throw errorFromHttpResponse(res.status, body, url);\n    }\n    return await parseCompileSuccessBody(res, url);\n  };\n\n  const getZapPacks = async (\n    options?: GetZapPacksOptions,\n  ): Promise<readonly ZapPackOverview[]> => {\n    const params = new URLSearchParams();\n    if (options?.protocols !== undefined) {\n      // Backend expects a single comma-separated value, not repeated keys.\n      const raw = options.protocols;\n      const list = typeof raw === 'string' ? raw : raw.join(',');\n      params.set('protocols', list);\n    }\n    const qs = params.toString();\n    const url = `${base}/compose/zap-packs${qs ? `?${qs}` : ''}`;\n    let res: Response;\n    try {\n      res = await fetchFn(url, {\n        method: 'GET',\n        headers: { ...baseHeaders },\n      });\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      throw new ComposeError('NETWORK_ERROR', message, { cause: err });\n    }\n    if (!res.ok) {\n      const body = await res.text();\n      throw errorFromHttpResponse(res.status, body, url);\n    }\n    return await parseBody<readonly ZapPackOverview[]>(res, url);\n  };\n\n  const simulate = async (\n    request: SimulateRequest,\n  ): Promise<SimulateResult> => {\n    const url = `${base}/simulate`;\n    let res: Response;\n    try {\n      res = await fetchFn(url, {\n        method: 'POST',\n        headers: { ...baseHeaders, 'Content-Type': 'application/json' },\n        body: JSON.stringify(request, bigintReplacer),\n      });\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      throw new ComposeError('NETWORK_ERROR', message, { cause: err });\n    }\n    // Only 200 (carries `ok`/`revert`) and 422 (carries the `error` member of\n    // the union) have a discriminated body. 422 is deliberately intercepted\n    // here (not thrown as VALIDATION_ERROR) so callers get one exhaustive\n    // `switch (result.status)`. Every other status is a transport error and is\n    // thrown — including HTTP 400 (malformed input, no `status` body) and any\n    // unexpected 2xx.\n    if (res.status === 200 || res.status === 422) {\n      return await parseSimulateBody(res, url);\n    }\n    const body = await res.text();\n    throw errorFromHttpResponse(res.status, body, url);\n  };\n\n  return { getManifest, compile, getZapPacks, simulate };\n};\n"],"mappings":"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","names":["options"]}
+{"version":3,"sources":["../src/client.ts"],"sourcesContent":["import type {\n  ComposeCompilePartialData,\n  ComposeCompileRequest,\n  ComposeCompileResult,\n  ComposeCompileSuccessData,\n  ComposeManifest,\n  ComposeRouteRequest,\n  SimulateRequest,\n  SimulateResult,\n} from '@lifi/compose-spec';\n\nimport type { GetZapPacksOptions, ZapPackOverview } from './discovery.js';\nimport { ComposeError, errorFromHttpResponse } from './errors.js';\nimport {\n  parseCompilePartialEnvelope,\n  parseSimulateResult,\n} from './responseSchemas.js';\n\n// __SDK_VERSION__ is a compile-time constant injected by tsup (via `define` in tsup.config.ts)\n// and by vitest (via `define` in vitest.config.ts). Both read the version from package.json\n// at build/test time and replace this identifier with the literal string value.\n// It is sent as the `x-lifi-composer-sdk` request header so the server can identify the caller.\n// Falls back to 'dev' when running via tsx without tsup substitution (e.g. the example harness).\ndeclare const __SDK_VERSION__: string;\n\nconst SDK_VERSION: string =\n  typeof __SDK_VERSION__ !== 'undefined' ? __SDK_VERSION__ : 'dev';\n\n/**\n * Configuration for creating a low-level Compose API client.\n */\nexport interface ComposeClientOptions {\n  /** Base URL of the Compose API. */\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 * Low-level HTTP client for the Compose API.\n *\n * Handles request serialization, SDK version headers, and error mapping.\n * Prefer using {@link ComposeSdk} for the full builder experience. Use this\n * directly when you need to decouple request building from submission — e.g.\n * build via `sdk.request()` then submit via `client.compile()` with custom\n * retry logic or request inspection.\n */\nexport interface ComposeClient {\n  /**\n   * Fetches the server's operation manifest describing all supported operations,\n   * guards, materialisers, and preconditions.\n   * @returns The manifest document.\n   * @throws {@link ComposeError} on network, validation, or server errors.\n   */\n  readonly getManifest: () => Promise<ComposeManifest>;\n  /**\n   * Submits a compile request and returns the result.\n   *\n   * When the caller passes `simulationPolicy: 'allow-revert'` and the transaction\n   * reverts in simulation, the server responds with HTTP 206 and the SDK returns a\n   * partial result (`status: 'partial'`) instead of throwing. The partial result\n   * includes the transaction (without `gasLimit`) and revert diagnostics.\n   *\n   * @param request - The full compile request including flow and run inputs.\n   * @returns A discriminated result: `status: 'success'` or `status: 'partial'`.\n   * @throws {@link ComposeError} on network, validation, or server errors.\n   */\n  readonly compile: (\n    request: ComposeCompileRequest,\n  ) => Promise<ComposeCompileResult>;\n  /**\n   * Compiles a token pair into a submit-ready transaction via\n   * `POST /compose/route`.\n   *\n   * A convenience path that skips flow authoring: the server builds a one-node\n   * `lifi.zap` flow with a `directDeposit` input from the `fromToken` /\n   * `toToken` pair and runs it through the same pipeline as {@link compile}.\n   * The response is therefore the same discriminated result — HTTP 206 under\n   * `simulationPolicy: 'allow-revert'` yields `status: 'partial'` rather than\n   * throwing, exactly as it does for {@link compile}.\n   *\n   * As of today that flow is a single zap step: one edge of the backend's\n   * routing catalog (a position entry or exit, a wrap or unwrap, a mint or\n   * burn). Enumerate the pairs it covers with {@link getZapPacks}; a pair with\n   * no edge is rejected with `kind: 'no_route_error'`. The endpoint is meant to\n   * author richer flows later, so the single-step limit is the current state of\n   * the server, not the shape of this contract.\n   *\n   * Use {@link compile} for what the server does not author for you: several\n   * chained operations, splits, explicit preconditions, or per-op guards.\n   *\n   * `bigint` amounts in `amount` are serialised to decimal strings\n   * automatically.\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   *   including `NOT_FOUND` (HTTP 404) when no catalog edge covers the pair.\n   */\n  readonly route: (\n    request: ComposeRouteRequest,\n  ) => Promise<ComposeCompileResult>;\n  /**\n   * Fetches the available routing edges grouped by protocol.\n   *\n   * The edge catalog is dynamic — it reflects the current state of the\n   * backend's routing snapshot (protocols, chains, token blacklists).\n   * Results are not cached by the SDK; callers should cache as appropriate.\n   *\n   * @param options - Optional filter to restrict results to specific protocols.\n   * @returns An array of {@link ZapPackOverview} objects, one per protocol.\n   * @throws {@link ComposeError} on network or server errors (503 when the\n   *   routing catalog is not yet initialized).\n   */\n  readonly getZapPacks: (\n    options?: GetZapPacksOptions,\n  ) => Promise<readonly ZapPackOverview[]>;\n  /**\n   * Simulates a raw, pre-encoded transaction against `POST /simulate` and\n   * reports how the watched balances change and how much inner-call gas it\n   * burns.\n   *\n   * The result is a discriminated union on `status`:\n   * - `'ok'` — the simulation ran successfully; `deltas`/`gasUsed` are populated.\n   * - `'revert'` — the simulation ran but the transaction reverted on-chain. A\n   *   revert is a *successful simulation*, not a transport error, so it is\n   *   returned (HTTP 200) rather than thrown — mirroring how {@link compile}\n   *   returns `status: 'partial'` on a simulated revert.\n   * - `'error'` — the request was well-formed but the simulation could not be\n   *   set up or run (HTTP 422); `message` is intentionally generic.\n   *\n   * `bigint` amounts in the request (`value`, requirement `balance`/`allowance`)\n   * are serialised to decimal strings automatically.\n   *\n   * @param request - The raw transaction plus funding `requirements` and the\n   *   `trackedBalances` to watch.\n   * @returns A {@link SimulateResult} (`ok` / `revert` / `error`).\n   * @throws {@link ComposeError} on network failures, HTTP 400 (malformed\n   *   input), 401/403 (auth), 404, 429, and 5xx.\n   */\n  readonly simulate: (request: SimulateRequest) => Promise<SimulateResult>;\n}\n\nconst bigintReplacer = (_key: string, value: unknown): unknown =>\n  typeof value === 'bigint' ? value.toString() : value;\n\nconst isNonNullObject = (v: unknown): v is Record<string, unknown> =>\n  typeof v === 'object' && v !== null;\n\nconst parseBody = async <T>(res: Response, url: string): Promise<T> => {\n  const body = await res.json().catch((_) => null);\n  if (!isNonNullObject(body) || !('data' in body)) {\n    throw new ComposeError('UNKNOWN_ERROR', 'Unexpected response format', {\n      url,\n    });\n  }\n  return body.data as T;\n};\n\nconst parseCompileSuccessBody = async (\n  res: Response,\n  url: string,\n): Promise<ComposeCompileResult> => {\n  const data = await parseBody<ComposeCompileSuccessData>(res, url);\n  return { ...data, status: 'success' as const };\n};\n\nconst parsePartialBody = async (\n  res: Response,\n  url: string,\n): Promise<ComposeCompileResult> => {\n  const body = await res.json().catch((_) => null);\n  const envelope = parseCompilePartialEnvelope(body);\n  if (envelope === null) {\n    throw new ComposeError(\n      'UNKNOWN_ERROR',\n      'Unexpected partial response format',\n      { url },\n    );\n  }\n  // `data` is validated as an object by the schema; compose-spec owns its full\n  // shape as a hand-authored type, so we narrow it here rather than re-declaring\n  // that type as a schema. `error` is fully validated — no cast needed.\n  const data = envelope.data as unknown as ComposeCompilePartialData;\n  return { ...data, status: 'partial' as const, error: envelope.error };\n};\n\n// `/simulate` is un-enveloped: the discriminated body (`{ status, ... }`) is at\n// the top level, NOT wrapped in `{ data }` like `/compose`. So this reads the\n// body directly and validates it against the simulate union rather than reusing\n// `parseBody`.\nconst parseSimulateBody = async (\n  res: Response,\n  url: string,\n): Promise<SimulateResult> => {\n  const body = await res.json().catch((_) => null);\n  const result = parseSimulateResult(body);\n  if (result === null) {\n    throw new ComposeError(\n      'UNKNOWN_ERROR',\n      'Unexpected simulate response format',\n      { url },\n    );\n  }\n  return result;\n};\n// `POST /compose` and `POST /compose/route` differ only in path and request\n// shape: both return the enveloped success data on 200 and the partial\n// envelope on 206, so they share one transport.\ntype ComposeTransport = {\n  readonly fetchFn: typeof fetch;\n  readonly baseHeaders: Record<string, string>;\n};\n\nconst postCompile = async (\n  { fetchFn, baseHeaders }: ComposeTransport,\n  url: string,\n  request: ComposeCompileRequest | ComposeRouteRequest,\n): Promise<ComposeCompileResult> => {\n  let res: Response;\n  try {\n    res = await fetchFn(url, {\n      method: 'POST',\n      headers: { ...baseHeaders, 'Content-Type': 'application/json' },\n      body: JSON.stringify(request, bigintReplacer),\n    });\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    throw new ComposeError('NETWORK_ERROR', message, { cause: err });\n  }\n  if (res.status === 206) {\n    return await parsePartialBody(res, url);\n  }\n  if (!res.ok) {\n    const body = await res.text();\n    throw errorFromHttpResponse(res.status, body, url);\n  }\n  return await parseCompileSuccessBody(res, url);\n};\n\n/**\n * Creates a low-level Compose API client.\n *\n * @param options - Client configuration including the API base URL.\n * @returns A {@link ComposeClient} instance.\n */\nexport const createComposeClient = (\n  options: ComposeClientOptions,\n): ComposeClient => {\n  if (!options.baseUrl || !/^https?:\\/\\//i.test(options.baseUrl)) {\n    throw new ComposeError(\n      'VALIDATION_ERROR',\n      `Invalid baseUrl: expected an HTTP(S) URL, got \"${options.baseUrl}\"`,\n    );\n  }\n  const trimmedApiKey = options.apiKey?.trim() || undefined;\n  if (!trimmedApiKey) {\n    throw new ComposeError(\n      'VALIDATION_ERROR',\n      'apiKey is required: pass a LI.FI API key to createComposeSdk().',\n    );\n  }\n  const fetchFn = options.fetch ?? globalThis.fetch;\n  const base = options.baseUrl.replace(/\\/$/, '');\n\n  const baseHeaders: Record<string, string> = {\n    Accept: 'application/json',\n    'x-lifi-composer-sdk': SDK_VERSION,\n    'x-lifi-api-key': trimmedApiKey,\n  };\n  const transport: ComposeTransport = { fetchFn, baseHeaders };\n\n  const getManifest = async (): Promise<ComposeManifest> => {\n    const url = `${base}/compose/manifest`;\n    let res: Response;\n    try {\n      res = await fetchFn(url, {\n        method: 'GET',\n        headers: { ...baseHeaders },\n      });\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      throw new ComposeError('NETWORK_ERROR', message, { cause: err });\n    }\n    if (!res.ok) {\n      const body = await res.text();\n      throw errorFromHttpResponse(res.status, body, url);\n    }\n    return await parseBody<ComposeManifest>(res, url);\n  };\n\n  const compile = async (\n    request: ComposeCompileRequest,\n  ): Promise<ComposeCompileResult> =>\n    postCompile(transport, `${base}/compose`, request);\n\n  const route = async (\n    request: ComposeRouteRequest,\n  ): Promise<ComposeCompileResult> =>\n    postCompile(transport, `${base}/compose/route`, request);\n\n  const getZapPacks = async (\n    options?: GetZapPacksOptions,\n  ): Promise<readonly ZapPackOverview[]> => {\n    const params = new URLSearchParams();\n    if (options?.protocols !== undefined) {\n      // Backend expects a single comma-separated value, not repeated keys.\n      const raw = options.protocols;\n      const list = typeof raw === 'string' ? raw : raw.join(',');\n      params.set('protocols', list);\n    }\n    const qs = params.toString();\n    const url = `${base}/compose/zap-packs${qs ? `?${qs}` : ''}`;\n    let res: Response;\n    try {\n      res = await fetchFn(url, {\n        method: 'GET',\n        headers: { ...baseHeaders },\n      });\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      throw new ComposeError('NETWORK_ERROR', message, { cause: err });\n    }\n    if (!res.ok) {\n      const body = await res.text();\n      throw errorFromHttpResponse(res.status, body, url);\n    }\n    return await parseBody<readonly ZapPackOverview[]>(res, url);\n  };\n\n  const simulate = async (\n    request: SimulateRequest,\n  ): Promise<SimulateResult> => {\n    const url = `${base}/simulate`;\n    let res: Response;\n    try {\n      res = await fetchFn(url, {\n        method: 'POST',\n        headers: { ...baseHeaders, 'Content-Type': 'application/json' },\n        body: JSON.stringify(request, bigintReplacer),\n      });\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      throw new ComposeError('NETWORK_ERROR', message, { cause: err });\n    }\n    // Only 200 (carries `ok`/`revert`) and 422 (carries the `error` member of\n    // the union) have a discriminated body. 422 is deliberately intercepted\n    // here (not thrown as VALIDATION_ERROR) so callers get one exhaustive\n    // `switch (result.status)`. Every other status is a transport error and is\n    // thrown — including HTTP 400 (malformed input, no `status` body) and any\n    // unexpected 2xx.\n    if (res.status === 200 || res.status === 422) {\n      return await parseSimulateBody(res, url);\n    }\n    const body = await res.text();\n    throw errorFromHttpResponse(res.status, body, url);\n  };\n\n  return { getManifest, compile, route, getZapPacks, simulate };\n};\n"],"mappings":"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","names":["options"]}

package/dist/discovery.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/discovery.ts"],"sourcesContent":["/**\n * Types for the Compose discovery API (`GET /compose/zap-packs`).\n *\n * These are SDK-facing presentation types — not part of the core compile\n * contract in compose-spec. The backend response is the source of truth;\n * the SDK provides typed access.\n *\n * The `type` field on edges is a plain `string` rather than a strict union\n * so the SDK remains forward-compatible when the backend introduces new\n * edge types. Known values at time of writing:\n * `\"enter-position\"`, `\"exit-position\"`, `\"wrap\"`, `\"unwrap\"`, `\"mint\"`, `\"burn\"`.\n */\n\n/**\n * A single routing edge representing a supported token-to-token path\n * through a DeFi protocol.\n */\nexport interface ZapPackEdge {\n  /** Edge type (e.g. `\"enter-position\"`, `\"exit-position\"`, `\"wrap\"`). */\n  readonly type: string;\n  /** Input token. */\n  readonly in: { readonly address: string; readonly chainId: number };\n  /** Output token. */\n  readonly out: { readonly address: string; readonly chainId: number };\n  /** Minimum input amount accepted (stringified integer), if constrained. */\n  readonly inAmountMin?: string;\n  /** Maximum input amount accepted (stringified integer), if constrained. */\n  readonly inAmountMax?: string;\n}\n\n/**\n * All routing edges for a single protocol.\n */\nexport interface ZapPackOverview {\n  /** Protocol identifier (e.g. `\"aave\"`, `\"morpho\"`). */\n  readonly protocol: string;\n  /** Available routing edges for this protocol. */\n  readonly edges: readonly ZapPackEdge[];\n}\n\n/**\n * Options for {@link ComposeClient.getZapPacks}.\n */\nexport interface GetZapPacksOptions {\n  /**\n   * Filter to specific protocols. Pass a single string or an array.\n   * Only edges belonging to the listed protocols are returned.\n   * Omit to fetch all available protocols.\n   */\n  readonly protocols?: string | readonly string[];\n}\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}
+{"version":3,"sources":["../src/discovery.ts"],"sourcesContent":["/**\n * Types for the Compose discovery API (`GET /compose/zap-packs`).\n *\n * These are SDK-facing presentation types — not part of the core compile\n * contract in compose-spec. The backend response is the source of truth;\n * the SDK provides typed access.\n *\n * The `type` field on edges is a plain `string` rather than a strict union\n * so the SDK remains forward-compatible when the backend introduces new\n * edge types. Known values at time of writing:\n * `\"enter-position\"`, `\"exit-position\"`, `\"wrap\"`, `\"unwrap\"`, `\"mint\"`, `\"burn\"`.\n */\n\n/**\n * A single routing edge representing a supported token-to-token path\n * through a DeFi protocol.\n */\nexport interface ZapPackEdge {\n  /** Edge type (e.g. `\"enter-position\"`, `\"exit-position\"`, `\"wrap\"`). */\n  readonly type: string;\n  /** Input token. */\n  readonly in: { readonly address: string; readonly chainId: number };\n  /** Output token. */\n  readonly out: { readonly address: string; readonly chainId: number };\n  /** Minimum input amount accepted (stringified integer), if constrained. */\n  readonly inAmountMin?: string;\n  /** Maximum input amount accepted (stringified integer), if constrained. */\n  readonly inAmountMax?: string;\n  /**\n   * Recipient binding obligation. `\"required\"` means the zap must bind its\n   * `recipient` input. The output is externally owned, terminal, and unswept.\n   * The loose string type preserves forward compatibility with new values.\n   */\n  readonly recipient?: string;\n  /**\n   * Output availability. `\"future\"` means the output becomes available only\n   * after the initiating transaction settles; route via `lifi.zapAsync` with\n   * a bound recipient. Absent means the output is available synchronously.\n   * The loose string type preserves forward compatibility with new values.\n   */\n  readonly availability?: string;\n}\n\n/**\n * All routing edges for a single protocol.\n */\nexport interface ZapPackOverview {\n  /** Protocol identifier (e.g. `\"aave\"`, `\"morpho\"`). */\n  readonly protocol: string;\n  /** Available routing edges for this protocol. */\n  readonly edges: readonly ZapPackEdge[];\n}\n\n/**\n * Options for {@link ComposeClient.getZapPacks}.\n */\nexport interface GetZapPacksOptions {\n  /**\n   * Filter to specific protocols. Pass a single string or an array.\n   * Only edges belonging to the listed protocols are returned.\n   * Omit to fetch all available protocols.\n   */\n  readonly protocols?: string | readonly string[];\n}\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/discovery.d.cts

@@ -31,6 +31,19 @@ interface ZapPackEdge {
     readonly inAmountMin?: string;
     /** Maximum input amount accepted (stringified integer), if constrained. */
     readonly inAmountMax?: string;
+    /**
+     * Recipient binding obligation. `"required"` means the zap must bind its
+     * `recipient` input. The output is externally owned, terminal, and unswept.
+     * The loose string type preserves forward compatibility with new values.
+     */
+    readonly recipient?: string;
+    /**
+     * Output availability. `"future"` means the output becomes available only
+     * after the initiating transaction settles; route via `lifi.zapAsync` with
+     * a bound recipient. Absent means the output is available synchronously.
+     * The loose string type preserves forward compatibility with new values.
+     */
+    readonly availability?: string;
 }
 /**
  * All routing edges for a single protocol.

package/dist/discovery.d.ts

@@ -31,6 +31,19 @@ interface ZapPackEdge {
     readonly inAmountMin?: string;
     /** Maximum input amount accepted (stringified integer), if constrained. */
     readonly inAmountMax?: string;
+    /**
+     * Recipient binding obligation. `"required"` means the zap must bind its
+     * `recipient` input. The output is externally owned, terminal, and unswept.
+     * The loose string type preserves forward compatibility with new values.
+     */
+    readonly recipient?: string;
+    /**
+     * Output availability. `"future"` means the output becomes available only
+     * after the initiating transaction settles; route via `lifi.zapAsync` with
+     * a bound recipient. Absent means the output is available synchronously.
+     * The loose string type preserves forward compatibility with new values.
+     */
+    readonly availability?: string;
 }
 /**
  * All routing edges for a single protocol.

package/dist/generated/config.generated.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/generated/config.generated.ts"],"sourcesContent":["// AUTO-GENERATED from manifest.json — do not edit by hand.\n// Regenerate with: yarn workspace @lifi/composer-sdk generate\n\nimport type { Address, IntegerStringInput } from '../types.js';\n\n/**\n * a number between 0 and 10000\n */\nexport type Between010000 = number;\n\nexport interface CoreSplitConfig {\n  bps: Between010000;\n}\n\n/**\n * a positive number\n */\nexport type Positive = number;\n/**\n * a string at most 64 character(s) long\n */\nexport type MaxLength64 = string;\n/**\n * an array of at most 50 item(s)\n *\n * @maxItems 50\n */\nexport type MaxItems50 = MaxLength64[];\n\nexport interface LifiSwapConfig {\n  resourceOut:\n    | {\n        kind: 'native';\n        chainId: Positive;\n      }\n    | {\n        kind: 'erc20';\n        token: Address;\n        chainId: Positive;\n      };\n  slippage?: number;\n  timing?: {\n    swapStepTimingStrategies?: {\n      strategy: 'minWaitTime';\n      minWaitTimeMs: number;\n      startingExpectedResults: number;\n      reduceEveryMs: number;\n    }[];\n    routeTimingStrategies?: {\n      strategy: 'minWaitTime';\n      minWaitTimeMs: number;\n      startingExpectedResults: number;\n      reduceEveryMs: number;\n    }[];\n  };\n  exchanges?: {\n    allow?: MaxItems50;\n    deny?: MaxItems50;\n    prefer?: MaxItems50;\n  };\n}\n\nexport interface InvariantNumericConfig {\n  op: 'gte' | 'gt' | 'lte' | 'lt' | 'eq' | 'neq';\n  threshold: IntegerStringInput;\n}\n\nexport interface InvariantNumericInRangeConfig {\n  min: IntegerStringInput;\n  max: IntegerStringInput;\n}\n\nexport interface InvariantGteConfig {\n  threshold: IntegerStringInput;\n}\n\nexport interface InvariantGtConfig {\n  threshold: IntegerStringInput;\n}\n\nexport interface InvariantLteConfig {\n  threshold: IntegerStringInput;\n}\n\nexport interface InvariantLtConfig {\n  threshold: IntegerStringInput;\n}\n\nexport interface InvariantEqConfig {\n  threshold: IntegerStringInput;\n}\n\nexport interface InvariantNeqConfig {\n  threshold: IntegerStringInput;\n}\n\n/**\n * a non-negative number\n */\nexport type NonNegative = number;\n\nexport interface CoreBpsDownConfig {\n  bps: NonNegative;\n}\n\nexport interface CoreBpsUpConfig {\n  bps: NonNegative;\n}\n\nexport interface CoreApproveConfig {\n  spender: Address;\n}\n\nexport interface CoreBalanceOfConfig {\n  token: Address;\n  owner?: Address;\n}\n\nexport interface CoreTransferConfig {\n  amount?: IntegerStringInput;\n}\n\nexport interface CoreEmitEvent1Config {\n  signature: string;\n}\n\nexport interface CoreEmitEvent2Config {\n  signature: string;\n}\n\nexport interface CoreEmitEvent3Config {\n  signature: string;\n}\n\nexport interface CoreEmitEvent4Config {\n  signature: string;\n}\n\n/**\n * a string at most 65536 character(s) long\n */\nexport type MaxLength65536 = string;\n\nexport interface CoreCallConfig {\n  target: Address;\n  functionSignature: string;\n  callType?: 'Call' | 'ValueCall';\n  args?: (\n    | (\n        | MaxLength65536\n        | number\n        | boolean\n        | {\n            $ref: string;\n          }\n      )\n    | (\n        | (\n            | MaxLength65536\n            | number\n            | boolean\n            | {\n                $ref: string;\n              }\n          )\n        | (\n            | (\n                | MaxLength65536\n                | number\n                | boolean\n                | {\n                    $ref: string;\n                  }\n              )\n            | (\n                | (\n                    | MaxLength65536\n                    | number\n                    | boolean\n                    | {\n                        $ref: string;\n                      }\n                  )\n                | (\n                    | (\n                        | MaxLength65536\n                        | number\n                        | boolean\n                        | {\n                            $ref: string;\n                          }\n                      )\n                    | (\n                        | MaxLength65536\n                        | number\n                        | boolean\n                        | {\n                            $ref: string;\n                          }\n                      )[]\n                  )[]\n              )[]\n          )[]\n      )[]\n  )[];\n  approvals?: {\n    spender: Address;\n  }[];\n}\n\nexport interface CoreStaticCallConfig {\n  target: Address;\n  functionSignature: string;\n  args?: (\n    | (\n        | MaxLength65536\n        | number\n        | boolean\n        | {\n            $ref: string;\n          }\n      )\n    | (\n        | (\n            | MaxLength65536\n            | number\n            | boolean\n            | {\n                $ref: string;\n              }\n          )\n        | (\n            | (\n                | MaxLength65536\n                | number\n                | boolean\n                | {\n                    $ref: string;\n                  }\n              )\n            | (\n                | (\n                    | MaxLength65536\n                    | number\n                    | boolean\n                    | {\n                        $ref: string;\n                      }\n                  )\n                | (\n                    | (\n                        | MaxLength65536\n                        | number\n                        | boolean\n                        | {\n                            $ref: string;\n                          }\n                      )\n                    | (\n                        | MaxLength65536\n                        | number\n                        | boolean\n                        | {\n                            $ref: string;\n                          }\n                      )[]\n                  )[]\n              )[]\n          )[]\n      )[]\n  )[];\n}\n\nexport interface CoreRawCallConfig {\n  target: Address;\n  calldata: string;\n  callType?: 'Call' | 'StaticCall' | 'ValueCall' | 'DelegateCall';\n  resultType?: string;\n}\n\nexport interface CoreInvokeConfig {\n  target: Address;\n  functionSignature: string;\n  callType?: 'Call' | 'ValueCall';\n  args?: (\n    | (\n        | MaxLength65536\n        | number\n        | boolean\n        | {\n            $ref: string;\n          }\n      )\n    | (\n        | (\n            | MaxLength65536\n            | number\n            | boolean\n            | {\n                $ref: string;\n              }\n          )\n        | (\n            | (\n                | MaxLength65536\n                | number\n                | boolean\n                | {\n                    $ref: string;\n                  }\n              )\n            | (\n                | (\n                    | MaxLength65536\n                    | number\n                    | boolean\n                    | {\n                        $ref: string;\n                      }\n                  )\n                | (\n                    | (\n                        | MaxLength65536\n                        | number\n                        | boolean\n                        | {\n                            $ref: string;\n                          }\n                      )\n                    | (\n                        | MaxLength65536\n                        | number\n                        | boolean\n                        | {\n                            $ref: string;\n                          }\n                      )[]\n                  )[]\n              )[]\n          )[]\n      )[]\n  )[];\n}\n\nexport interface CoreAsResourceConfig {\n  resource:\n    | {\n        kind: 'native';\n        chainId: Positive;\n      }\n    | {\n        kind: 'erc20';\n        token: Address;\n        chainId: Positive;\n      };\n}\n\nexport interface AaveBorrowConfig {\n  pool: string;\n  asset: string;\n  variableDebtToken: string;\n  amount: IntegerStringInput;\n  referralId?: number;\n}\n\nexport type AaveRepayConfig =\n  | {\n      pool: string;\n      mode: 'exact';\n    }\n  | {\n      pool: string;\n      mode: 'max';\n    };\n\nexport interface AaveRepayWithATokensConfig {\n  pool: string;\n  asset: string;\n}\n\nexport interface AaveClaimRewardsConfig {\n  rewardsController: string;\n  assets: string[];\n  reward: string;\n  amount?: IntegerStringInput;\n  to?: string;\n}\n\n/**\n * a number between 0 and 255\n */\nexport type Between0255 = number;\n\nexport interface AaveSetEModeConfig {\n  pool: string;\n  category: Between0255;\n}\n\nexport interface AaveGetHealthFactorConfig {\n  pool: string;\n  user?: string;\n}\n\nexport type MorphoBlueSupplyCollateralConfig =\n  | (\n      | {\n          morpho?: string;\n          onBehalfOf?: string;\n          mode: 'exact';\n          /**\n           * a string matching the pattern ^0x[0-9a-fA-F]{64}$\n           */\n          marketId: string;\n        }\n      | {\n          morpho?: string;\n          onBehalfOf?: string;\n          mode: 'exact';\n          marketParams: {\n            loanToken: string;\n            collateralToken: string;\n            oracle: string;\n            irm: string;\n            lltv: string;\n          };\n        }\n    )\n  | (\n      | {\n          morpho?: string;\n          onBehalfOf?: string;\n          mode: 'all';\n          /**\n           * a string matching the pattern ^0x[0-9a-fA-F]{64}$\n           */\n          marketId: string;\n        }\n      | {\n          morpho?: string;\n          onBehalfOf?: string;\n          mode: 'all';\n          marketParams: {\n            loanToken: string;\n            collateralToken: string;\n            oracle: string;\n            irm: string;\n            lltv: string;\n          };\n        }\n    );\n\nexport type MorphoBlueWithdrawCollateralConfig =\n  | {\n      morpho?: string;\n      amount: IntegerStringInput;\n      onBehalfOf?: string;\n      receiver?: string;\n      /**\n       * a string matching the pattern ^0x[0-9a-fA-F]{64}$\n       */\n      marketId: string;\n    }\n  | {\n      morpho?: string;\n      amount: IntegerStringInput;\n      onBehalfOf?: string;\n      receiver?: string;\n      marketParams: {\n        loanToken: string;\n        collateralToken: string;\n        oracle: string;\n        irm: string;\n        lltv: string;\n      };\n    };\n\nexport type MorphoBlueBorrowConfig =\n  | {\n      morpho?: string;\n      amount: IntegerStringInput;\n      onBehalfOf?: string;\n      receiver?: string;\n      /**\n       * a string matching the pattern ^0x[0-9a-fA-F]{64}$\n       */\n      marketId: string;\n    }\n  | {\n      morpho?: string;\n      amount: IntegerStringInput;\n      onBehalfOf?: string;\n      receiver?: string;\n      marketParams: {\n        loanToken: string;\n        collateralToken: string;\n        oracle: string;\n        irm: string;\n        lltv: string;\n      };\n    };\n\nexport type MorphoBlueRepayConfig =\n  | (\n      | {\n          morpho?: string;\n          mode: 'exact';\n          /**\n           * a string matching the pattern ^0x[0-9a-fA-F]{64}$\n           */\n          marketId: string;\n        }\n      | {\n          morpho?: string;\n          mode: 'exact';\n          marketParams: {\n            loanToken: string;\n            collateralToken: string;\n            oracle: string;\n            irm: string;\n            lltv: string;\n          };\n        }\n    )\n  | (\n      | {\n          morpho?: string;\n          mode: 'max';\n          /**\n           * a string matching the pattern ^0x[0-9a-fA-F]{64}$\n           */\n          marketId: string;\n        }\n      | {\n          morpho?: string;\n          mode: 'max';\n          marketParams: {\n            loanToken: string;\n            collateralToken: string;\n            oracle: string;\n            irm: string;\n            lltv: string;\n          };\n        }\n    );\n\nexport type MorphoBlueSupplyConfig =\n  | {\n      morpho?: string;\n      onBehalfOf?: string;\n      /**\n       * a string matching the pattern ^0x[0-9a-fA-F]{64}$\n       */\n      marketId: string;\n    }\n  | {\n      morpho?: string;\n      onBehalfOf?: string;\n      marketParams: {\n        loanToken: string;\n        collateralToken: string;\n        oracle: string;\n        irm: string;\n        lltv: string;\n      };\n    };\n\nexport type MorphoBlueWithdrawConfig =\n  | (\n      | {\n          morpho?: string;\n          mode: 'exact';\n          amount: IntegerStringInput;\n          onBehalfOf?: string;\n          receiver?: string;\n          /**\n           * a string matching the pattern ^0x[0-9a-fA-F]{64}$\n           */\n          marketId: string;\n        }\n      | {\n          morpho?: string;\n          mode: 'exact';\n          amount: IntegerStringInput;\n          onBehalfOf?: string;\n          receiver?: string;\n          marketParams: {\n            loanToken: string;\n            collateralToken: string;\n            oracle: string;\n            irm: string;\n            lltv: string;\n          };\n        }\n    )\n  | (\n      | {\n          morpho?: string;\n          mode: 'max';\n          onBehalfOf?: string;\n          receiver?: string;\n          /**\n           * a string matching the pattern ^0x[0-9a-fA-F]{64}$\n           */\n          marketId: string;\n        }\n      | {\n          morpho?: string;\n          mode: 'max';\n          onBehalfOf?: string;\n          receiver?: string;\n          marketParams: {\n            loanToken: string;\n            collateralToken: string;\n            oracle: string;\n            irm: string;\n            lltv: string;\n          };\n        }\n    );\n\nexport type MorphoBlueGetPositionConfig =\n  | {\n      morpho?: string;\n      user?: string;\n      /**\n       * a string matching the pattern ^0x[0-9a-fA-F]{64}$\n       */\n      marketId: string;\n    }\n  | {\n      morpho?: string;\n      user?: string;\n      marketParams: {\n        loanToken: string;\n        collateralToken: string;\n        oracle: string;\n        irm: string;\n        lltv: string;\n      };\n    };\n\nexport interface LifiFlashloanRepayConfig {\n  leg: string;\n  fee?: string;\n}\n\nexport type ContinuationAssertReadyConfig =\n  | {\n      kind: 'erc20BalanceGte';\n      chainId: Positive;\n      token: StartsWith0X;\n      owner: StartsWith0X;\n      minAmount: string;\n    }\n  | {\n      kind: 'nativeBalanceGte';\n      chainId: Positive;\n      owner: StartsWith0X;\n      minAmount: string;\n    }\n  | {\n      kind: 'call';\n      chainId: Positive;\n      to: StartsWith0X;\n      calldata: StartsWith0X;\n      comparator: 'gte' | 'eq' | 'lte';\n      value: string;\n    };\n/**\n * a string starting with \"0x\"\n */\nexport type StartsWith0X = string;\n\nexport interface LifiZapConfig {\n  resourceOut:\n    | {\n        kind: 'native';\n        chainId: Positive;\n      }\n    | {\n        kind: 'erc20';\n        token: Address;\n        chainId: Positive;\n      };\n}\n\nexport interface ParaswapBuyConfig {\n  resourceOut:\n    | {\n        kind: 'native';\n        chainId: Positive;\n      }\n    | {\n        kind: 'erc20';\n        token: Address;\n        chainId: Positive;\n      };\n  exactAmountOut: string;\n  srcDecimals: NonNegative;\n  destDecimals: NonNegative;\n  maxSlippageBps?: Between010000;\n  partner?: string;\n  partnerAddress?: string;\n  /**\n   * Integrator fee in basis points; non-negative integer string capped at 9000.\n   */\n  partnerFeeBps?: string;\n}\n\nexport interface CorePeekConfig {\n  target: Address;\n  functionSignature: string;\n  args?: string[];\n}\n\nexport interface SlippageGuardConfig {\n  port: string;\n  bps: Between010000;\n}\n\nexport interface CoreNumericInvariantGuardConfig {\n  port: string;\n  op: 'gte' | 'gt' | 'lte' | 'lt' | 'eq' | 'neq';\n  threshold: IntegerStringInput;\n}\n\nexport interface BalanceOfMaterialiserConfig {\n  owner: Address;\n}\n\nexport type DirectDepositMaterialiserConfig =\n  | {\n      amount: IntegerStringInput;\n      allowNonExact?: false;\n    }\n  | {\n      amount: IntegerStringInput;\n      allowNonExact: true;\n    }\n  | {\n      allowNonExact: true;\n      simAmount?: string;\n    };\n\nexport interface CallMaterialiserConfig {\n  target: Address;\n  calldata: string;\n}\n\nexport interface FlashloanMaterialiserConfig {\n  providerKind: 'aave-v3' | 'erc3156' | 'balancer-v2' | 'morpho-blue';\n  amount: IntegerStringInput;\n}\n\nexport interface Erc20BalancePreconditionConfig {\n  wallet: Address;\n  token: Address;\n  balance: IntegerStringInput;\n}\n\nexport interface NativeBalancePreconditionConfig {\n  wallet: Address;\n  balance: IntegerStringInput;\n}\n\nexport interface Erc20AllowancePreconditionConfig {\n  owner: Address;\n  spender: Address;\n  token: Address;\n  allowance: IntegerStringInput;\n}\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}
+{"version":3,"sources":["../../src/generated/config.generated.ts"],"sourcesContent":["// AUTO-GENERATED from manifest.json — do not edit by hand.\n// Regenerate with: yarn workspace @lifi/composer-sdk generate\n\nimport type { Address, IntegerStringInput } from '../types.js';\n\n/**\n * a number between 0 and 10000\n */\nexport type Between010000 = number;\n\nexport interface CoreSplitConfig {\n  bps: Between010000;\n}\n\n/**\n * a positive number\n */\nexport type Positive = number;\n/**\n * a string at most 64 character(s) long\n */\nexport type MaxLength64 = string;\n/**\n * an array of at most 50 item(s)\n *\n * @maxItems 50\n */\nexport type MaxItems50 = MaxLength64[];\n\nexport interface LifiSwapConfig {\n  resourceOut:\n    | {\n        kind: 'native';\n        chainId: Positive;\n      }\n    | {\n        kind: 'erc20';\n        token: Address;\n        chainId: Positive;\n      };\n  slippage?: number;\n  timing?: {\n    swapStepTimingStrategies?: {\n      strategy: 'minWaitTime';\n      minWaitTimeMs: number;\n      startingExpectedResults: number;\n      reduceEveryMs: number;\n    }[];\n    routeTimingStrategies?: {\n      strategy: 'minWaitTime';\n      minWaitTimeMs: number;\n      startingExpectedResults: number;\n      reduceEveryMs: number;\n    }[];\n  };\n  exchanges?: {\n    allow?: MaxItems50;\n    deny?: MaxItems50;\n    prefer?: MaxItems50;\n  };\n}\n\nexport interface InvariantNumericConfig {\n  op: 'gte' | 'gt' | 'lte' | 'lt' | 'eq' | 'neq';\n  threshold: IntegerStringInput;\n}\n\nexport interface InvariantNumericInRangeConfig {\n  min: IntegerStringInput;\n  max: IntegerStringInput;\n}\n\nexport interface InvariantGteConfig {\n  threshold: IntegerStringInput;\n}\n\nexport interface InvariantGtConfig {\n  threshold: IntegerStringInput;\n}\n\nexport interface InvariantLteConfig {\n  threshold: IntegerStringInput;\n}\n\nexport interface InvariantLtConfig {\n  threshold: IntegerStringInput;\n}\n\nexport interface InvariantEqConfig {\n  threshold: IntegerStringInput;\n}\n\nexport interface InvariantNeqConfig {\n  threshold: IntegerStringInput;\n}\n\n/**\n * a non-negative number\n */\nexport type NonNegative = number;\n\nexport interface CoreBpsDownConfig {\n  bps: NonNegative;\n}\n\nexport interface CoreBpsUpConfig {\n  bps: NonNegative;\n}\n\nexport interface CoreApproveConfig {\n  spender: Address;\n}\n\nexport interface CoreBalanceOfConfig {\n  token: Address;\n  owner?: Address;\n}\n\nexport interface CoreTransferConfig {\n  amount?: IntegerStringInput;\n}\n\nexport interface CoreEmitEvent1Config {\n  signature: string;\n}\n\nexport interface CoreEmitEvent2Config {\n  signature: string;\n}\n\nexport interface CoreEmitEvent3Config {\n  signature: string;\n}\n\nexport interface CoreEmitEvent4Config {\n  signature: string;\n}\n\n/**\n * a string at most 65536 character(s) long\n */\nexport type MaxLength65536 = string;\n\nexport interface CoreCallConfig {\n  target: Address;\n  functionSignature: string;\n  callType?: 'Call' | 'ValueCall';\n  args?: (\n    | (\n        | MaxLength65536\n        | number\n        | boolean\n        | {\n            $ref: string;\n          }\n      )\n    | (\n        | (\n            | MaxLength65536\n            | number\n            | boolean\n            | {\n                $ref: string;\n              }\n          )\n        | (\n            | (\n                | MaxLength65536\n                | number\n                | boolean\n                | {\n                    $ref: string;\n                  }\n              )\n            | (\n                | (\n                    | MaxLength65536\n                    | number\n                    | boolean\n                    | {\n                        $ref: string;\n                      }\n                  )\n                | (\n                    | (\n                        | MaxLength65536\n                        | number\n                        | boolean\n                        | {\n                            $ref: string;\n                          }\n                      )\n                    | (\n                        | MaxLength65536\n                        | number\n                        | boolean\n                        | {\n                            $ref: string;\n                          }\n                      )[]\n                  )[]\n              )[]\n          )[]\n      )[]\n  )[];\n  approvals?: (\n    | {\n        spender: Address;\n      }\n    | {\n        from: 'sender';\n      }\n  )[];\n}\n\nexport interface CoreStaticCallConfig {\n  target: Address;\n  functionSignature: string;\n  args?: (\n    | (\n        | MaxLength65536\n        | number\n        | boolean\n        | {\n            $ref: string;\n          }\n      )\n    | (\n        | (\n            | MaxLength65536\n            | number\n            | boolean\n            | {\n                $ref: string;\n              }\n          )\n        | (\n            | (\n                | MaxLength65536\n                | number\n                | boolean\n                | {\n                    $ref: string;\n                  }\n              )\n            | (\n                | (\n                    | MaxLength65536\n                    | number\n                    | boolean\n                    | {\n                        $ref: string;\n                      }\n                  )\n                | (\n                    | (\n                        | MaxLength65536\n                        | number\n                        | boolean\n                        | {\n                            $ref: string;\n                          }\n                      )\n                    | (\n                        | MaxLength65536\n                        | number\n                        | boolean\n                        | {\n                            $ref: string;\n                          }\n                      )[]\n                  )[]\n              )[]\n          )[]\n      )[]\n  )[];\n}\n\nexport interface CoreRawCallConfig {\n  target: Address;\n  calldata: string;\n  callType?: 'Call' | 'StaticCall' | 'ValueCall' | 'DelegateCall';\n  resultType?: string;\n}\n\nexport interface CoreInvokeConfig {\n  target: Address;\n  functionSignature: string;\n  callType?: 'Call' | 'ValueCall';\n  args?: (\n    | (\n        | MaxLength65536\n        | number\n        | boolean\n        | {\n            $ref: string;\n          }\n      )\n    | (\n        | (\n            | MaxLength65536\n            | number\n            | boolean\n            | {\n                $ref: string;\n              }\n          )\n        | (\n            | (\n                | MaxLength65536\n                | number\n                | boolean\n                | {\n                    $ref: string;\n                  }\n              )\n            | (\n                | (\n                    | MaxLength65536\n                    | number\n                    | boolean\n                    | {\n                        $ref: string;\n                      }\n                  )\n                | (\n                    | (\n                        | MaxLength65536\n                        | number\n                        | boolean\n                        | {\n                            $ref: string;\n                          }\n                      )\n                    | (\n                        | MaxLength65536\n                        | number\n                        | boolean\n                        | {\n                            $ref: string;\n                          }\n                      )[]\n                  )[]\n              )[]\n          )[]\n      )[]\n  )[];\n}\n\nexport interface CoreAsResourceConfig {\n  resource:\n    | {\n        kind: 'native';\n        chainId: Positive;\n      }\n    | {\n        kind: 'erc20';\n        token: Address;\n        chainId: Positive;\n      };\n}\n\nexport interface AaveBorrowConfig {\n  pool: string;\n  asset: string;\n  variableDebtToken: string;\n  amount: IntegerStringInput;\n  referralId?: number;\n}\n\nexport type AaveRepayConfig =\n  | {\n      pool: string;\n      mode: 'exact';\n    }\n  | {\n      pool: string;\n      mode: 'max';\n    };\n\nexport interface AaveRepayWithATokensConfig {\n  pool: string;\n  asset: string;\n}\n\nexport interface AaveClaimRewardsConfig {\n  rewardsController: string;\n  assets: string[];\n  reward: string;\n  amount?: IntegerStringInput;\n  to?: string;\n}\n\n/**\n * a number between 0 and 255\n */\nexport type Between0255 = number;\n\nexport interface AaveSetEModeConfig {\n  pool: string;\n  category: Between0255;\n}\n\nexport interface AaveGetHealthFactorConfig {\n  pool: string;\n  user?: string;\n}\n\nexport type MorphoBlueSupplyCollateralConfig =\n  | (\n      | {\n          morpho?: string;\n          onBehalfOf?: string;\n          mode: 'exact';\n          /**\n           * a string matching the pattern ^0x[0-9a-fA-F]{64}$\n           */\n          marketId: string;\n        }\n      | {\n          morpho?: string;\n          onBehalfOf?: string;\n          mode: 'exact';\n          marketParams: {\n            loanToken: string;\n            collateralToken: string;\n            oracle: string;\n            irm: string;\n            lltv: string;\n          };\n        }\n    )\n  | (\n      | {\n          morpho?: string;\n          onBehalfOf?: string;\n          mode: 'all';\n          /**\n           * a string matching the pattern ^0x[0-9a-fA-F]{64}$\n           */\n          marketId: string;\n        }\n      | {\n          morpho?: string;\n          onBehalfOf?: string;\n          mode: 'all';\n          marketParams: {\n            loanToken: string;\n            collateralToken: string;\n            oracle: string;\n            irm: string;\n            lltv: string;\n          };\n        }\n    );\n\nexport type MorphoBlueWithdrawCollateralConfig =\n  | {\n      morpho?: string;\n      amount: IntegerStringInput;\n      onBehalfOf?: string;\n      receiver?: string;\n      /**\n       * a string matching the pattern ^0x[0-9a-fA-F]{64}$\n       */\n      marketId: string;\n    }\n  | {\n      morpho?: string;\n      amount: IntegerStringInput;\n      onBehalfOf?: string;\n      receiver?: string;\n      marketParams: {\n        loanToken: string;\n        collateralToken: string;\n        oracle: string;\n        irm: string;\n        lltv: string;\n      };\n    };\n\nexport type MorphoBlueBorrowConfig =\n  | {\n      morpho?: string;\n      amount: IntegerStringInput;\n      onBehalfOf?: string;\n      receiver?: string;\n      /**\n       * a string matching the pattern ^0x[0-9a-fA-F]{64}$\n       */\n      marketId: string;\n    }\n  | {\n      morpho?: string;\n      amount: IntegerStringInput;\n      onBehalfOf?: string;\n      receiver?: string;\n      marketParams: {\n        loanToken: string;\n        collateralToken: string;\n        oracle: string;\n        irm: string;\n        lltv: string;\n      };\n    };\n\nexport type MorphoBlueRepayConfig =\n  | (\n      | {\n          morpho?: string;\n          mode: 'exact';\n          /**\n           * a string matching the pattern ^0x[0-9a-fA-F]{64}$\n           */\n          marketId: string;\n        }\n      | {\n          morpho?: string;\n          mode: 'exact';\n          marketParams: {\n            loanToken: string;\n            collateralToken: string;\n            oracle: string;\n            irm: string;\n            lltv: string;\n          };\n        }\n    )\n  | (\n      | {\n          morpho?: string;\n          mode: 'max';\n          /**\n           * a string matching the pattern ^0x[0-9a-fA-F]{64}$\n           */\n          marketId: string;\n        }\n      | {\n          morpho?: string;\n          mode: 'max';\n          marketParams: {\n            loanToken: string;\n            collateralToken: string;\n            oracle: string;\n            irm: string;\n            lltv: string;\n          };\n        }\n    );\n\nexport type MorphoBlueSupplyConfig =\n  | {\n      morpho?: string;\n      onBehalfOf?: string;\n      /**\n       * a string matching the pattern ^0x[0-9a-fA-F]{64}$\n       */\n      marketId: string;\n    }\n  | {\n      morpho?: string;\n      onBehalfOf?: string;\n      marketParams: {\n        loanToken: string;\n        collateralToken: string;\n        oracle: string;\n        irm: string;\n        lltv: string;\n      };\n    };\n\nexport type MorphoBlueWithdrawConfig =\n  | (\n      | {\n          morpho?: string;\n          mode: 'exact';\n          amount: IntegerStringInput;\n          onBehalfOf?: string;\n          receiver?: string;\n          /**\n           * a string matching the pattern ^0x[0-9a-fA-F]{64}$\n           */\n          marketId: string;\n        }\n      | {\n          morpho?: string;\n          mode: 'exact';\n          amount: IntegerStringInput;\n          onBehalfOf?: string;\n          receiver?: string;\n          marketParams: {\n            loanToken: string;\n            collateralToken: string;\n            oracle: string;\n            irm: string;\n            lltv: string;\n          };\n        }\n    )\n  | (\n      | {\n          morpho?: string;\n          mode: 'max';\n          onBehalfOf?: string;\n          receiver?: string;\n          /**\n           * a string matching the pattern ^0x[0-9a-fA-F]{64}$\n           */\n          marketId: string;\n        }\n      | {\n          morpho?: string;\n          mode: 'max';\n          onBehalfOf?: string;\n          receiver?: string;\n          marketParams: {\n            loanToken: string;\n            collateralToken: string;\n            oracle: string;\n            irm: string;\n            lltv: string;\n          };\n        }\n    );\n\nexport type MorphoBlueGetPositionConfig =\n  | {\n      morpho?: string;\n      user?: string;\n      /**\n       * a string matching the pattern ^0x[0-9a-fA-F]{64}$\n       */\n      marketId: string;\n    }\n  | {\n      morpho?: string;\n      user?: string;\n      marketParams: {\n        loanToken: string;\n        collateralToken: string;\n        oracle: string;\n        irm: string;\n        lltv: string;\n      };\n    };\n\nexport interface LifiFlashloanRepayConfig {\n  leg: string;\n  fee?: string;\n}\n\nexport type ContinuationAssertReadyConfig =\n  | {\n      kind: 'erc20BalanceGte';\n      chainId: Positive;\n      token: StartsWith0X;\n      owner: StartsWith0X;\n      minAmount: string;\n    }\n  | {\n      kind: 'nativeBalanceGte';\n      chainId: Positive;\n      owner: StartsWith0X;\n      minAmount: string;\n    }\n  | {\n      kind: 'call';\n      chainId: Positive;\n      to: StartsWith0X;\n      calldata: StartsWith0X;\n      comparator: 'gte' | 'eq' | 'lte';\n      value: string;\n    };\n/**\n * a string starting with \"0x\"\n */\nexport type StartsWith0X = string;\n\nexport interface LifiZapConfig {\n  resourceOut:\n    | {\n        kind: 'native';\n        chainId: Positive;\n      }\n    | {\n        kind: 'erc20';\n        token: Address;\n        chainId: Positive;\n      };\n}\n\nexport interface LifiZapAsyncConfig {\n  resourceOut:\n    | {\n        kind: 'native';\n        chainId: Positive;\n      }\n    | {\n        kind: 'erc20';\n        token: Address;\n        chainId: Positive;\n      };\n}\n\nexport interface ParaswapBuyConfig {\n  resourceOut:\n    | {\n        kind: 'native';\n        chainId: Positive;\n      }\n    | {\n        kind: 'erc20';\n        token: Address;\n        chainId: Positive;\n      };\n  exactAmountOut: string;\n  srcDecimals: NonNegative;\n  destDecimals: NonNegative;\n  maxSlippageBps?: Between010000;\n  partner?: string;\n  partnerAddress?: string;\n  /**\n   * Integrator fee in basis points; non-negative integer string capped at 9000.\n   */\n  partnerFeeBps?: string;\n}\n\nexport interface CorePeekConfig {\n  target: Address;\n  functionSignature: string;\n  args?: string[];\n}\n\nexport interface SlippageGuardConfig {\n  port: string;\n  bps: Between010000;\n}\n\nexport interface CoreNumericInvariantGuardConfig {\n  port: string;\n  op: 'gte' | 'gt' | 'lte' | 'lt' | 'eq' | 'neq';\n  threshold: IntegerStringInput;\n}\n\nexport interface BalanceOfMaterialiserConfig {\n  owner: Address;\n}\n\nexport type DirectDepositMaterialiserConfig =\n  | {\n      amount: IntegerStringInput;\n      allowNonExact?: false;\n    }\n  | {\n      amount: IntegerStringInput;\n      allowNonExact: true;\n    }\n  | {\n      allowNonExact: true;\n      simAmount?: string;\n    };\n\nexport interface CallMaterialiserConfig {\n  target: Address;\n  calldata: string;\n}\n\nexport interface FlashloanMaterialiserConfig {\n  providerKind: 'aave-v3' | 'erc3156' | 'balancer-v2' | 'morpho-blue';\n  amount: IntegerStringInput;\n}\n\nexport interface Erc20BalancePreconditionConfig {\n  wallet: Address;\n  token: Address;\n  balance: IntegerStringInput;\n}\n\nexport interface NativeBalancePreconditionConfig {\n  wallet: Address;\n  balance: IntegerStringInput;\n}\n\nexport interface Erc20AllowancePreconditionConfig {\n  owner: Address;\n  spender: Address;\n  token: Address;\n  allowance: IntegerStringInput;\n}\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/generated/config.generated.d.cts

@@ -131,9 +131,11 @@ interface CoreCallConfig {
     }) | (MaxLength65536 | number | boolean | {
         $ref: string;
     })[])[])[])[])[])[];
-    approvals?: {
+    approvals?: ({
         spender: Address;
-    }[];
+    } | {
+        from: 'sender';
+    })[];
 }
 interface CoreStaticCallConfig {
     target: Address;
@@ -459,6 +461,16 @@ interface LifiZapConfig {
         chainId: Positive;
     };
 }
+interface LifiZapAsyncConfig {
+    resourceOut: {
+        kind: 'native';
+        chainId: Positive;
+    } | {
+        kind: 'erc20';
+        token: Address;
+        chainId: Positive;
+    };
+}
 interface ParaswapBuyConfig {
     resourceOut: {
         kind: 'native';
@@ -530,4 +542,4 @@ interface Erc20AllowancePreconditionConfig {
     allowance: IntegerStringInput;
 }
 
-export type { AaveBorrowConfig, AaveClaimRewardsConfig, AaveGetHealthFactorConfig, AaveRepayConfig, AaveRepayWithATokensConfig, AaveSetEModeConfig, BalanceOfMaterialiserConfig, Between010000, Between0255, CallMaterialiserConfig, ContinuationAssertReadyConfig, CoreApproveConfig, CoreAsResourceConfig, CoreBalanceOfConfig, CoreBpsDownConfig, CoreBpsUpConfig, CoreCallConfig, CoreEmitEvent1Config, CoreEmitEvent2Config, CoreEmitEvent3Config, CoreEmitEvent4Config, CoreInvokeConfig, CoreNumericInvariantGuardConfig, CorePeekConfig, CoreRawCallConfig, CoreSplitConfig, CoreStaticCallConfig, CoreTransferConfig, DirectDepositMaterialiserConfig, Erc20AllowancePreconditionConfig, Erc20BalancePreconditionConfig, FlashloanMaterialiserConfig, InvariantEqConfig, InvariantGtConfig, InvariantGteConfig, InvariantLtConfig, InvariantLteConfig, InvariantNeqConfig, InvariantNumericConfig, InvariantNumericInRangeConfig, LifiFlashloanRepayConfig, LifiSwapConfig, LifiZapConfig, MaxItems50, MaxLength64, MaxLength65536, MorphoBlueBorrowConfig, MorphoBlueGetPositionConfig, MorphoBlueRepayConfig, MorphoBlueSupplyCollateralConfig, MorphoBlueSupplyConfig, MorphoBlueWithdrawCollateralConfig, MorphoBlueWithdrawConfig, NativeBalancePreconditionConfig, NonNegative, ParaswapBuyConfig, Positive, SlippageGuardConfig, StartsWith0X };
+export type { AaveBorrowConfig, AaveClaimRewardsConfig, AaveGetHealthFactorConfig, AaveRepayConfig, AaveRepayWithATokensConfig, AaveSetEModeConfig, BalanceOfMaterialiserConfig, Between010000, Between0255, CallMaterialiserConfig, ContinuationAssertReadyConfig, CoreApproveConfig, CoreAsResourceConfig, CoreBalanceOfConfig, CoreBpsDownConfig, CoreBpsUpConfig, CoreCallConfig, CoreEmitEvent1Config, CoreEmitEvent2Config, CoreEmitEvent3Config, CoreEmitEvent4Config, CoreInvokeConfig, CoreNumericInvariantGuardConfig, CorePeekConfig, CoreRawCallConfig, CoreSplitConfig, CoreStaticCallConfig, CoreTransferConfig, DirectDepositMaterialiserConfig, Erc20AllowancePreconditionConfig, Erc20BalancePreconditionConfig, FlashloanMaterialiserConfig, InvariantEqConfig, InvariantGtConfig, InvariantGteConfig, InvariantLtConfig, InvariantLteConfig, InvariantNeqConfig, InvariantNumericConfig, InvariantNumericInRangeConfig, LifiFlashloanRepayConfig, LifiSwapConfig, LifiZapAsyncConfig, LifiZapConfig, MaxItems50, MaxLength64, MaxLength65536, MorphoBlueBorrowConfig, MorphoBlueGetPositionConfig, MorphoBlueRepayConfig, MorphoBlueSupplyCollateralConfig, MorphoBlueSupplyConfig, MorphoBlueWithdrawCollateralConfig, MorphoBlueWithdrawConfig, NativeBalancePreconditionConfig, NonNegative, ParaswapBuyConfig, Positive, SlippageGuardConfig, StartsWith0X };

package/dist/generated/config.generated.d.ts

@@ -131,9 +131,11 @@ interface CoreCallConfig {
     }) | (MaxLength65536 | number | boolean | {
         $ref: string;
     })[])[])[])[])[])[];
-    approvals?: {
+    approvals?: ({
         spender: Address;
-    }[];
+    } | {
+        from: 'sender';
+    })[];
 }
 interface CoreStaticCallConfig {
     target: Address;
@@ -459,6 +461,16 @@ interface LifiZapConfig {
         chainId: Positive;
     };
 }
+interface LifiZapAsyncConfig {
+    resourceOut: {
+        kind: 'native';
+        chainId: Positive;
+    } | {
+        kind: 'erc20';
+        token: Address;
+        chainId: Positive;
+    };
+}
 interface ParaswapBuyConfig {
     resourceOut: {
         kind: 'native';
@@ -530,4 +542,4 @@ interface Erc20AllowancePreconditionConfig {
     allowance: IntegerStringInput;
 }
 
-export type { AaveBorrowConfig, AaveClaimRewardsConfig, AaveGetHealthFactorConfig, AaveRepayConfig, AaveRepayWithATokensConfig, AaveSetEModeConfig, BalanceOfMaterialiserConfig, Between010000, Between0255, CallMaterialiserConfig, ContinuationAssertReadyConfig, CoreApproveConfig, CoreAsResourceConfig, CoreBalanceOfConfig, CoreBpsDownConfig, CoreBpsUpConfig, CoreCallConfig, CoreEmitEvent1Config, CoreEmitEvent2Config, CoreEmitEvent3Config, CoreEmitEvent4Config, CoreInvokeConfig, CoreNumericInvariantGuardConfig, CorePeekConfig, CoreRawCallConfig, CoreSplitConfig, CoreStaticCallConfig, CoreTransferConfig, DirectDepositMaterialiserConfig, Erc20AllowancePreconditionConfig, Erc20BalancePreconditionConfig, FlashloanMaterialiserConfig, InvariantEqConfig, InvariantGtConfig, InvariantGteConfig, InvariantLtConfig, InvariantLteConfig, InvariantNeqConfig, InvariantNumericConfig, InvariantNumericInRangeConfig, LifiFlashloanRepayConfig, LifiSwapConfig, LifiZapConfig, MaxItems50, MaxLength64, MaxLength65536, MorphoBlueBorrowConfig, MorphoBlueGetPositionConfig, MorphoBlueRepayConfig, MorphoBlueSupplyCollateralConfig, MorphoBlueSupplyConfig, MorphoBlueWithdrawCollateralConfig, MorphoBlueWithdrawConfig, NativeBalancePreconditionConfig, NonNegative, ParaswapBuyConfig, Positive, SlippageGuardConfig, StartsWith0X };
+export type { AaveBorrowConfig, AaveClaimRewardsConfig, AaveGetHealthFactorConfig, AaveRepayConfig, AaveRepayWithATokensConfig, AaveSetEModeConfig, BalanceOfMaterialiserConfig, Between010000, Between0255, CallMaterialiserConfig, ContinuationAssertReadyConfig, CoreApproveConfig, CoreAsResourceConfig, CoreBalanceOfConfig, CoreBpsDownConfig, CoreBpsUpConfig, CoreCallConfig, CoreEmitEvent1Config, CoreEmitEvent2Config, CoreEmitEvent3Config, CoreEmitEvent4Config, CoreInvokeConfig, CoreNumericInvariantGuardConfig, CorePeekConfig, CoreRawCallConfig, CoreSplitConfig, CoreStaticCallConfig, CoreTransferConfig, DirectDepositMaterialiserConfig, Erc20AllowancePreconditionConfig, Erc20BalancePreconditionConfig, FlashloanMaterialiserConfig, InvariantEqConfig, InvariantGtConfig, InvariantGteConfig, InvariantLtConfig, InvariantLteConfig, InvariantNeqConfig, InvariantNumericConfig, InvariantNumericInRangeConfig, LifiFlashloanRepayConfig, LifiSwapConfig, LifiZapAsyncConfig, LifiZapConfig, MaxItems50, MaxLength64, MaxLength65536, MorphoBlueBorrowConfig, MorphoBlueGetPositionConfig, MorphoBlueRepayConfig, MorphoBlueSupplyCollateralConfig, MorphoBlueSupplyConfig, MorphoBlueWithdrawCollateralConfig, MorphoBlueWithdrawConfig, NativeBalancePreconditionConfig, NonNegative, ParaswapBuyConfig, Positive, SlippageGuardConfig, StartsWith0X };

package/dist/generated/materialisers.generated.cjs

@@ -20,8 +20,7 @@ var materialisers_generated_exports = {};
 __export(materialisers_generated_exports, {
   balanceOf: () => balanceOf,
   call: () => call,
-  directDeposit: () => directDeposit,
-  flashloan: () => flashloan
+  directDeposit: () => directDeposit
 });
 module.exports = __toCommonJS(materialisers_generated_exports);
 const balanceOf = (config) => ({
@@ -36,15 +35,10 @@ const call = (config) => ({
   kind: "call",
   ...config
 });
-const flashloan = (config) => ({
-  kind: "flashloan",
-  ...config
-});
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   balanceOf,
   call,
-  directDeposit,
-  flashloan
+  directDeposit
 });
 //# sourceMappingURL=materialisers.generated.cjs.map

package/dist/generated/materialisers.generated.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/generated/materialisers.generated.ts"],"sourcesContent":["// AUTO-GENERATED from manifest.json — do not edit by hand.\n// Regenerate with: yarn workspace @lifi/composer-sdk generate\n\nimport type {\n  MaterialiserConfigOf,\n  MaterialiserInput,\n} from '@lifi/compose-spec';\n\nimport type {\n  BalanceOfMaterialiserConfig as BalanceOfMaterialiserConfigSchema,\n  CallMaterialiserConfig as CallMaterialiserConfigSchema,\n  DirectDepositMaterialiserConfig as DirectDepositMaterialiserConfigSchema,\n  FlashloanMaterialiserConfig as FlashloanMaterialiserConfigSchema,\n} from './config.generated.js';\n\nexport type BalanceOfMaterialiserConfig =\n  MaterialiserConfigOf<BalanceOfMaterialiserConfigSchema>;\n\n/** Read the on-chain token balance of an address as the input amount — accepts: resource */\nexport const balanceOf = (\n  config: BalanceOfMaterialiserConfig,\n): MaterialiserInput => ({\n  kind: 'balanceOf',\n  ...config,\n});\n\nexport type DirectDepositMaterialiserConfig =\n  MaterialiserConfigOf<DirectDepositMaterialiserConfigSchema>;\n\n/** Deposit tokens into the VM — native via msg.value, ERC-20 via transferFrom — accepts: resource */\nexport const directDeposit = (\n  config: DirectDepositMaterialiserConfig,\n): MaterialiserInput => ({\n  kind: 'directDeposit',\n  ...config,\n});\n\nexport type CallMaterialiserConfig =\n  MaterialiserConfigOf<CallMaterialiserConfigSchema>;\n\n/** Execute an arbitrary contract call and measure the resulting token balance diff — accepts: resource */\nexport const call = (config: CallMaterialiserConfig): MaterialiserInput => ({\n  kind: 'call',\n  ...config,\n});\n\nexport type FlashloanMaterialiserConfig =\n  MaterialiserConfigOf<FlashloanMaterialiserConfigSchema>;\n\n/** Borrow tokens from a flashloan provider; amount becomes a register populated by the proxy at callback time — accepts: resource */\nexport const flashloan = (\n  config: FlashloanMaterialiserConfig,\n): MaterialiserInput => ({\n  kind: 'flashloan',\n  ...config,\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAmBO,MAAM,YAAY,CACvB,YACuB;AAAA,EACvB,MAAM;AAAA,EACN,GAAG;AACL;AAMO,MAAM,gBAAgB,CAC3B,YACuB;AAAA,EACvB,MAAM;AAAA,EACN,GAAG;AACL;AAMO,MAAM,OAAO,CAAC,YAAuD;AAAA,EAC1E,MAAM;AAAA,EACN,GAAG;AACL;AAMO,MAAM,YAAY,CACvB,YACuB;AAAA,EACvB,MAAM;AAAA,EACN,GAAG;AACL;","names":[]}
+{"version":3,"sources":["../../src/generated/materialisers.generated.ts"],"sourcesContent":["// AUTO-GENERATED from manifest.json — do not edit by hand.\n// Regenerate with: yarn workspace @lifi/composer-sdk generate\n\nimport type {\n  MaterialiserConfigOf,\n  MaterialiserInput,\n} from '@lifi/compose-spec';\n\nimport type {\n  BalanceOfMaterialiserConfig as BalanceOfMaterialiserConfigSchema,\n  CallMaterialiserConfig as CallMaterialiserConfigSchema,\n  DirectDepositMaterialiserConfig as DirectDepositMaterialiserConfigSchema,\n} from './config.generated.js';\n\nexport type BalanceOfMaterialiserConfig =\n  MaterialiserConfigOf<BalanceOfMaterialiserConfigSchema>;\n\n/** Read the on-chain token balance of an address as the input amount — accepts: resource */\nexport const balanceOf = (\n  config: BalanceOfMaterialiserConfig,\n): MaterialiserInput => ({\n  kind: 'balanceOf',\n  ...config,\n});\n\nexport type DirectDepositMaterialiserConfig =\n  MaterialiserConfigOf<DirectDepositMaterialiserConfigSchema>;\n\n/** Deposit tokens into the VM — native via msg.value, ERC-20 via transferFrom — accepts: resource */\nexport const directDeposit = (\n  config: DirectDepositMaterialiserConfig,\n): MaterialiserInput => ({\n  kind: 'directDeposit',\n  ...config,\n});\n\nexport type CallMaterialiserConfig =\n  MaterialiserConfigOf<CallMaterialiserConfigSchema>;\n\n/** Execute an arbitrary contract call and measure the resulting token balance diff — accepts: resource */\nexport const call = (config: CallMaterialiserConfig): MaterialiserInput => ({\n  kind: 'call',\n  ...config,\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAkBO,MAAM,YAAY,CACvB,YACuB;AAAA,EACvB,MAAM;AAAA,EACN,GAAG;AACL;AAMO,MAAM,gBAAgB,CAC3B,YACuB;AAAA,EACvB,MAAM;AAAA,EACN,GAAG;AACL;AAMO,MAAM,OAAO,CAAC,YAAuD;AAAA,EAC1E,MAAM;AAAA,EACN,GAAG;AACL;","names":[]}

package/dist/generated/materialisers.generated.d.cts

@@ -1,4 +1,4 @@
 import '@lifi/compose-spec';
 import './config.generated.cjs';
-export { B as BalanceOfMaterialiserConfig, C as CallMaterialiserConfig, D as DirectDepositMaterialiserConfig, F as FlashloanMaterialiserConfig, b as balanceOf, c as call, d as directDeposit, f as flashloan } from '../materialisers.generated-DaJRwiRe.cjs';
+export { B as BalanceOfMaterialiserConfig, C as CallMaterialiserConfig, D as DirectDepositMaterialiserConfig, b as balanceOf, c as call, d as directDeposit } from '../materialisers.generated-BWq5oePO.cjs';
 import '../types.cjs';

package/dist/generated/materialisers.generated.d.ts

@@ -1,4 +1,4 @@
 import '@lifi/compose-spec';
 import './config.generated.js';
-export { B as BalanceOfMaterialiserConfig, C as CallMaterialiserConfig, D as DirectDepositMaterialiserConfig, F as FlashloanMaterialiserConfig, b as balanceOf, c as call, d as directDeposit, f as flashloan } from '../materialisers.generated-BfWJ-g7t.js';
+export { B as BalanceOfMaterialiserConfig, C as CallMaterialiserConfig, D as DirectDepositMaterialiserConfig, b as balanceOf, c as call, d as directDeposit } from '../materialisers.generated-BMkBQgWZ.js';
 import '../types.js';

package/dist/generated/materialisers.generated.js

@@ -10,14 +10,9 @@ const call = (config) => ({
   kind: "call",
   ...config
 });
-const flashloan = (config) => ({
-  kind: "flashloan",
-  ...config
-});
 export {
   balanceOf,
   call,
-  directDeposit,
-  flashloan
+  directDeposit
 };
 //# sourceMappingURL=materialisers.generated.js.map

package/dist/generated/materialisers.generated.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/generated/materialisers.generated.ts"],"sourcesContent":["// AUTO-GENERATED from manifest.json — do not edit by hand.\n// Regenerate with: yarn workspace @lifi/composer-sdk generate\n\nimport type {\n  MaterialiserConfigOf,\n  MaterialiserInput,\n} from '@lifi/compose-spec';\n\nimport type {\n  BalanceOfMaterialiserConfig as BalanceOfMaterialiserConfigSchema,\n  CallMaterialiserConfig as CallMaterialiserConfigSchema,\n  DirectDepositMaterialiserConfig as DirectDepositMaterialiserConfigSchema,\n  FlashloanMaterialiserConfig as FlashloanMaterialiserConfigSchema,\n} from './config.generated.js';\n\nexport type BalanceOfMaterialiserConfig =\n  MaterialiserConfigOf<BalanceOfMaterialiserConfigSchema>;\n\n/** Read the on-chain token balance of an address as the input amount — accepts: resource */\nexport const balanceOf = (\n  config: BalanceOfMaterialiserConfig,\n): MaterialiserInput => ({\n  kind: 'balanceOf',\n  ...config,\n});\n\nexport type DirectDepositMaterialiserConfig =\n  MaterialiserConfigOf<DirectDepositMaterialiserConfigSchema>;\n\n/** Deposit tokens into the VM — native via msg.value, ERC-20 via transferFrom — accepts: resource */\nexport const directDeposit = (\n  config: DirectDepositMaterialiserConfig,\n): MaterialiserInput => ({\n  kind: 'directDeposit',\n  ...config,\n});\n\nexport type CallMaterialiserConfig =\n  MaterialiserConfigOf<CallMaterialiserConfigSchema>;\n\n/** Execute an arbitrary contract call and measure the resulting token balance diff — accepts: resource */\nexport const call = (config: CallMaterialiserConfig): MaterialiserInput => ({\n  kind: 'call',\n  ...config,\n});\n\nexport type FlashloanMaterialiserConfig =\n  MaterialiserConfigOf<FlashloanMaterialiserConfigSchema>;\n\n/** Borrow tokens from a flashloan provider; amount becomes a register populated by the proxy at callback time — accepts: resource */\nexport const flashloan = (\n  config: FlashloanMaterialiserConfig,\n): MaterialiserInput => ({\n  kind: 'flashloan',\n  ...config,\n});\n"],"mappings":"AAmBO,MAAM,YAAY,CACvB,YACuB;AAAA,EACvB,MAAM;AAAA,EACN,GAAG;AACL;AAMO,MAAM,gBAAgB,CAC3B,YACuB;AAAA,EACvB,MAAM;AAAA,EACN,GAAG;AACL;AAMO,MAAM,OAAO,CAAC,YAAuD;AAAA,EAC1E,MAAM;AAAA,EACN,GAAG;AACL;AAMO,MAAM,YAAY,CACvB,YACuB;AAAA,EACvB,MAAM;AAAA,EACN,GAAG;AACL;","names":[]}
+{"version":3,"sources":["../../src/generated/materialisers.generated.ts"],"sourcesContent":["// AUTO-GENERATED from manifest.json — do not edit by hand.\n// Regenerate with: yarn workspace @lifi/composer-sdk generate\n\nimport type {\n  MaterialiserConfigOf,\n  MaterialiserInput,\n} from '@lifi/compose-spec';\n\nimport type {\n  BalanceOfMaterialiserConfig as BalanceOfMaterialiserConfigSchema,\n  CallMaterialiserConfig as CallMaterialiserConfigSchema,\n  DirectDepositMaterialiserConfig as DirectDepositMaterialiserConfigSchema,\n} from './config.generated.js';\n\nexport type BalanceOfMaterialiserConfig =\n  MaterialiserConfigOf<BalanceOfMaterialiserConfigSchema>;\n\n/** Read the on-chain token balance of an address as the input amount — accepts: resource */\nexport const balanceOf = (\n  config: BalanceOfMaterialiserConfig,\n): MaterialiserInput => ({\n  kind: 'balanceOf',\n  ...config,\n});\n\nexport type DirectDepositMaterialiserConfig =\n  MaterialiserConfigOf<DirectDepositMaterialiserConfigSchema>;\n\n/** Deposit tokens into the VM — native via msg.value, ERC-20 via transferFrom — accepts: resource */\nexport const directDeposit = (\n  config: DirectDepositMaterialiserConfig,\n): MaterialiserInput => ({\n  kind: 'directDeposit',\n  ...config,\n});\n\nexport type CallMaterialiserConfig =\n  MaterialiserConfigOf<CallMaterialiserConfigSchema>;\n\n/** Execute an arbitrary contract call and measure the resulting token balance diff — accepts: resource */\nexport const call = (config: CallMaterialiserConfig): MaterialiserInput => ({\n  kind: 'call',\n  ...config,\n});\n"],"mappings":"AAkBO,MAAM,YAAY,CACvB,YACuB;AAAA,EACvB,MAAM;AAAA,EACN,GAAG;AACL;AAMO,MAAM,gBAAgB,CAC3B,YACuB;AAAA,EACvB,MAAM;AAAA,EACN,GAAG;AACL;AAMO,MAAM,OAAO,CAAC,YAAuD;AAAA,EAC1E,MAAM;AAAA,EACN,GAAG;AACL;","names":[]}

package/dist/generated/operations.generated.cjs

@@ -103,9 +103,11 @@ const bindGeneratedOps = (builder) => ({
       amountOut: "resource",
       unspentIn: "resource"
     }),
-    flashloanRepay: (nodeId, args) => builder.call(nodeId, "lifi.flashloanRepay", args, {}),
     zap: (nodeId, args) => builder.call(nodeId, "lifi.zap", args, {
       amountOut: "resource"
+    }),
+    zapAsync: (nodeId, args) => builder.call(nodeId, "lifi.zapAsync", args, {
+      amountOut: "resource"
     })
   },
   invariant: {
@@ -183,52 +185,15 @@ const bindGeneratedOps = (builder) => ({
       claimed: "resource",
       claimedAmount: "uint256"
     }),
-    setEMode: (nodeId, args) => builder.call(nodeId, "aave.setEMode", args, {}),
-    getHealthFactor: (nodeId, args) => builder.call(nodeId, "aave.getHealthFactor", args, {
-      healthFactor: "uint256"
-    })
+    setEMode: (nodeId, args) => builder.call(nodeId, "aave.setEMode", args, {})
   },
   morphoBlue: {
     supplyCollateral: (nodeId, args) => builder.call(nodeId, "morphoBlue.supplyCollateral", args, {}),
     withdrawCollateral: (nodeId, args) => builder.call(nodeId, "morphoBlue.withdrawCollateral", args, {
       withdrawn: "resource",
       collateralWithdrawn: "uint256"
-    }),
-    borrow: (nodeId, args) => builder.call(nodeId, "morphoBlue.borrow", args, {
-      borrowed: "resource",
-      assetsBorrowed: "uint256",
-      sharesBorrowed: "uint256"
-    }),
-    repay: (nodeId, args) => builder.call(nodeId, "morphoBlue.repay", args, {
-      actualRepaid: "uint256",
-      sharesRepaid: "uint256",
-      residual: "resource"
-    }),
-    supply: (nodeId, args) => builder.call(nodeId, "morphoBlue.supply", args, {
-      assetsSupplied: "uint256",
-      sharesSupplied: "uint256",
-      residual: "resource"
-    }),
-    withdraw: (nodeId, args) => builder.call(nodeId, "morphoBlue.withdraw", args, {
-      withdrawn: "resource",
-      assetsWithdrawn: "uint256",
-      sharesWithdrawn: "uint256"
-    }),
-    getPosition: (nodeId, args) => builder.call(nodeId, "morphoBlue.getPosition", args, {
-      supplyShares: "uint256",
-      borrowShares: "uint128",
-      collateral: "uint128"
     })
   },
-  continuation: {
-    assertReady: (nodeId, args) => builder.call(nodeId, "continuation.assertReady", args, {}),
-    commitment: (nodeId, args) => builder.call(
-      nodeId,
-      "continuation.commitment",
-      { ...args, config: {} },
-      {}
-    )
-  },
   paraswap: {
     buy: (nodeId, args) => builder.call(nodeId, "paraswap.buy", args, {
       amountOut: "resource",