@gauntlet-xyz/sdk 2.5.0 → 3.1.1

package/dist/cjs/api/activity.d.ts

@@ -0,0 +1,72 @@
+import type { ActivityOptions, GauntletApi, TokenRef, UserActivity } from "./client.js";
+export type ActivityFlowKind = 'deposit' | 'withdraw' | 'transfer_in' | 'transfer_out';
+export type ActivityFlowStatus = 'settled' | 'pending' | 'refunded';
+/** A signed token amount as reported by the API, with base-unit conversion when possible. */
+export interface AssetAmount {
+    /** Human-unit decimal string exactly as the API emits it, e.g. `"1250.5"`. */
+    decimal: string;
+    /** Base-unit integer (`decimal × 10^token.decimals`); null when the token's decimals are unknown. */
+    raw: bigint | null;
+    token: TokenRef | null;
+}
+/**
+ * One user action against a vault, stitched from the activity log's immutable
+ * rows. Sync flows (Morpho, secondary-market transfers) come from a single
+ * row; Aera async flows pair a `*_pending` request row with its terminal
+ * settle/refund row via `request_hash`.
+ */
+export interface ActivityFlow {
+    kind: ActivityFlowKind;
+    status: ActivityFlowStatus;
+    /** CAIP-10 vault id (`"{chainId}:{address}"`). */
+    vaultId: string;
+    /** Aera async correlation hash; null for sync flows and transfers. */
+    requestHash: string | null;
+    /** When the request row landed. Null when the flow's pending row is outside the fetched window. */
+    requestedAt: Date | null;
+    /** When the terminal (settle/refund) row landed. Null while pending. */
+    settledAt: Date | null;
+    /** Magnitude of the flow's asset movement (requested amount for refunded flows). */
+    assets: AssetAmount;
+    /** Magnitude of the flow's share movement in 18-decimal base units. */
+    shares: bigint;
+    /** Transaction hashes in row order (request first, then settlement, when both are known). */
+    txHashes: string[];
+}
+/**
+ * Pure stitcher: folds raw activity rows into `ActivityFlow`s. Rows may be in
+ * any order and may span multiple vaults; async lifecycles are paired by
+ * `request_hash`. Flows are returned newest-first (by the flow's latest row).
+ */
+export declare function stitchActivityFlows(rows: UserActivity[]): ActivityFlow[];
+export interface ActivityFlowsOptions extends Pick<ActivityOptions, 'vaultId' | 'limit'> {
+    /** Stop paginating once this many rows have been fetched. Defaults to 1000. */
+    maxRows?: number;
+}
+/**
+ * Fetches the wallet's activity log and stitches it into lifecycle-aware
+ * flows — the replacement for scanning vault event logs over RPC.
+ *
+ * ```ts
+ * const flows = await getActivityFlows(client.api, wallet);
+ * const open = flows.filter((f) => f.status === 'pending');
+ * ```
+ */
+export declare function getActivityFlows(api: GauntletApi, walletAddress: string, options?: ActivityFlowsOptions): Promise<ActivityFlow[]>;
+export interface WaitForSettlementOptions {
+    /** Transaction hash of the submitted request. Prevents reuse of an earlier settlement. */
+    requestTxHash: string;
+    /** CAIP-10 vault id — narrows polling to one vault's activity. */
+    vaultId?: string;
+    /** Polling interval. Defaults to 5s. */
+    pollIntervalMs?: number;
+    /** Overall deadline. Defaults to 10 minutes. Throws `SettlementTimeoutError` on expiry. */
+    timeoutMs?: number;
+}
+/**
+ * Polls the activity log until the Aera async request identified by
+ * `requestHash` reaches a terminal state, and returns the settled or refunded
+ * flow. Use after submitting a `requestDeposit` / `requestRedeem` transaction.
+ */
+export declare function waitForRequestSettlement(api: GauntletApi, walletAddress: string, requestHash: string, options: WaitForSettlementOptions): Promise<ActivityFlow>;
+//# sourceMappingURL=activity.d.ts.map

package/dist/cjs/api/activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../../../src/api/activity.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,oBAAiB;AAIrF,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,UAAU,GAAG,aAAa,GAAG,cAAc,CAAC;AACvF,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;AAEpE,6FAA6F;AAC7F,MAAM,WAAW,WAAW;IAC1B,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB,qGAAqG;IACrG,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,gBAAgB,CAAC;IACvB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,mGAAmG;IACnG,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,wEAAwE;IACxE,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,oFAAoF;IACpF,MAAM,EAAE,WAAW,CAAC;IACpB,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAC;IACf,6FAA6F;IAC7F,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AA4CD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CA2CxE;AAED,MAAM,WAAW,oBAAqB,SAAQ,IAAI,CAAC,eAAe,EAAE,SAAS,GAAG,OAAO,CAAC;IACtF,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,WAAW,EAChB,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,YAAY,EAAE,CAAC,CAqBzB;AAED,MAAM,WAAW,wBAAwB;IACvC,0FAA0F;IAC1F,aAAa,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2FAA2F;IAC3F,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,WAAW,EAChB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,YAAY,CAAC,CAwBvB"}

package/dist/cjs/api/activity.js

@@ -0,0 +1,138 @@
+"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 activity_exports = {};
+__export(activity_exports, {
+  getActivityFlows: () => getActivityFlows,
+  stitchActivityFlows: () => stitchActivityFlows,
+  waitForRequestSettlement: () => waitForRequestSettlement
+});
+module.exports = __toCommonJS(activity_exports);
+var import_activityRows = require("./activityRows");
+var import_errors = require("../errors");
+var import_decimal = require("./decimal");
+var import_errors2 = require("./errors");
+const PENDING_TYPES = /* @__PURE__ */ new Set(["deposit_pending", "withdraw_pending"]);
+const REFUNDED_TYPES = /* @__PURE__ */ new Set(["deposit_refunded", "withdraw_refunded"]);
+function flowKind(rowType) {
+  if (["deposit", "deposit_pending", "deposit_refunded"].includes(rowType)) return "deposit";
+  if (["withdraw", "withdraw_pending", "withdraw_refunded"].includes(rowType)) return "withdraw";
+  if (rowType === "transfer_in" || rowType === "transfer_out") return rowType;
+  throw new import_errors.GauntletSDKError(`Unknown activity row type "${rowType}"`);
+}
+function abs(value) {
+  return value < 0n ? -value : value;
+}
+const ASSET_SCALE = 18;
+function toAssetAmount(rows) {
+  let best = rows[0];
+  let bestMagnitude = abs((0, import_decimal.decimalToBigInt)(best.assets_delta.native, ASSET_SCALE));
+  for (const row of rows.slice(1)) {
+    const magnitude = abs((0, import_decimal.decimalToBigInt)(row.assets_delta.native, ASSET_SCALE));
+    if (magnitude > bestMagnitude) {
+      best = row;
+      bestMagnitude = magnitude;
+    }
+  }
+  const token = best.assets_delta.token ?? rows.find((r) => r.assets_delta.token)?.assets_delta.token ?? null;
+  const decimal = best.assets_delta.native.replace(/^-/, "");
+  const raw = token?.decimals != null ? (0, import_decimal.decimalToBigInt)(decimal, token.decimals) : null;
+  return { decimal, raw, token };
+}
+function stitchActivityFlows(rows) {
+  const groups = (0, import_activityRows.activityLifecycles)((0, import_activityRows.orderActivityRows)(rows));
+  const flows = [];
+  for (const group of groups) {
+    group.sort((a, b) => a.block_timestamp - b.block_timestamp);
+    const pendingRow = group.find((r) => PENDING_TYPES.has(r.type)) ?? null;
+    const terminalRow = group.find((r) => !PENDING_TYPES.has(r.type)) ?? null;
+    const isAsync = group.some((r) => r.request_hash != null);
+    let status;
+    if (!terminalRow) status = "pending";
+    else if (REFUNDED_TYPES.has(terminalRow.type)) status = "refunded";
+    else status = "settled";
+    let sharesMagnitude = 0n;
+    for (const row of group) {
+      const shares = abs((0, import_decimal.sharesToBigInt)(row.shares_delta));
+      if (shares > sharesMagnitude) sharesMagnitude = shares;
+    }
+    flows.push({
+      kind: flowKind((terminalRow ?? pendingRow ?? group[0]).type),
+      status,
+      vaultId: group[0].vault_id,
+      requestHash: group[0].request_hash ?? null,
+      requestedAt: pendingRow ? new Date(pendingRow.block_timestamp * 1e3) : isAsync ? null : new Date(group[0].block_timestamp * 1e3),
+      settledAt: terminalRow ? new Date(terminalRow.block_timestamp * 1e3) : null,
+      assets: toAssetAmount(group),
+      shares: sharesMagnitude,
+      txHashes: [...new Set(group.map((r) => r.tx_hash))]
+    });
+  }
+  return flows.sort((a, b) => {
+    const aAt = (a.settledAt ?? a.requestedAt)?.getTime() ?? 0;
+    const bAt = (b.settledAt ?? b.requestedAt)?.getTime() ?? 0;
+    return bAt - aAt;
+  });
+}
+async function getActivityFlows(api, walletAddress, options = {}) {
+  const maxRows = options.maxRows ?? 1e3;
+  const rows = [];
+  for await (const row of api.activityRows(walletAddress, {
+    vaultId: options.vaultId,
+    // The API caps page size at 1000; request maxRows per page so the common
+    // case is a single round trip instead of ten default-100 pages.
+    limit: options.limit ?? Math.min(maxRows, 1e3),
+    order: "desc"
+  })) {
+    rows.push(row);
+    if (rows.length >= maxRows) break;
+  }
+  const flows = stitchActivityFlows(rows);
+  if (rows.length >= maxRows) {
+    return flows.filter((f) => f.requestHash === null || f.requestedAt !== null);
+  }
+  return flows;
+}
+async function waitForRequestSettlement(api, walletAddress, requestHash, options) {
+  if (typeof options?.requestTxHash !== "string" || options.requestTxHash.length === 0) {
+    throw new import_errors.GauntletSDKError(
+      "Settlement polling requires the submitted request transaction hash"
+    );
+  }
+  const pollIntervalMs = options.pollIntervalMs ?? 5e3;
+  const timeoutMs = options.timeoutMs ?? 6e5;
+  const deadline = Date.now() + timeoutMs;
+  for (; ; ) {
+    const flows = await getActivityFlows(api, walletAddress, { vaultId: options.vaultId });
+    const flow = flows.find(
+      (f) => f.requestHash === requestHash && f.txHashes.some((hash) => hash.toLowerCase() === options.requestTxHash.toLowerCase())
+    );
+    if (flow && flow.status !== "pending") return flow;
+    if (Date.now() + pollIntervalMs > deadline) {
+      throw new import_errors2.SettlementTimeoutError(requestHash, timeoutMs);
+    }
+    await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getActivityFlows,
+  stitchActivityFlows,
+  waitForRequestSettlement
+});
+//# sourceMappingURL=activity.js.map

package/dist/cjs/api/activity.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/api/activity.ts"],
+  "sourcesContent": ["import { activityLifecycles, orderActivityRows } from './activityRows';\nimport { GauntletSDKError } from '../errors';\nimport type { ActivityOptions, GauntletApi, TokenRef, UserActivity } from './client';\nimport { decimalToBigInt, sharesToBigInt } from './decimal';\nimport { SettlementTimeoutError } from './errors';\n\nexport type ActivityFlowKind = 'deposit' | 'withdraw' | 'transfer_in' | 'transfer_out';\nexport type ActivityFlowStatus = 'settled' | 'pending' | 'refunded';\n\n/** A signed token amount as reported by the API, with base-unit conversion when possible. */\nexport interface AssetAmount {\n  /** Human-unit decimal string exactly as the API emits it, e.g. `\"1250.5\"`. */\n  decimal: string;\n  /** Base-unit integer (`decimal \u00D7 10^token.decimals`); null when the token's decimals are unknown. */\n  raw: bigint | null;\n  token: TokenRef | null;\n}\n\n/**\n * One user action against a vault, stitched from the activity log's immutable\n * rows. Sync flows (Morpho, secondary-market transfers) come from a single\n * row; Aera async flows pair a `*_pending` request row with its terminal\n * settle/refund row via `request_hash`.\n */\nexport interface ActivityFlow {\n  kind: ActivityFlowKind;\n  status: ActivityFlowStatus;\n  /** CAIP-10 vault id (`\"{chainId}:{address}\"`). */\n  vaultId: string;\n  /** Aera async correlation hash; null for sync flows and transfers. */\n  requestHash: string | null;\n  /** When the request row landed. Null when the flow's pending row is outside the fetched window. */\n  requestedAt: Date | null;\n  /** When the terminal (settle/refund) row landed. Null while pending. */\n  settledAt: Date | null;\n  /** Magnitude of the flow's asset movement (requested amount for refunded flows). */\n  assets: AssetAmount;\n  /** Magnitude of the flow's share movement in 18-decimal base units. */\n  shares: bigint;\n  /** Transaction hashes in row order (request first, then settlement, when both are known). */\n  txHashes: string[];\n}\n\nconst PENDING_TYPES = new Set(['deposit_pending', 'withdraw_pending']);\nconst REFUNDED_TYPES = new Set(['deposit_refunded', 'withdraw_refunded']);\n\nfunction flowKind(rowType: string): ActivityFlowKind {\n  if (['deposit', 'deposit_pending', 'deposit_refunded'].includes(rowType)) return 'deposit';\n  if (['withdraw', 'withdraw_pending', 'withdraw_refunded'].includes(rowType)) return 'withdraw';\n  if (rowType === 'transfer_in' || rowType === 'transfer_out') return rowType;\n  throw new GauntletSDKError(`Unknown activity row type \"${rowType}\"`);\n}\n\nfunction abs(value: bigint): bigint {\n  return value < 0n ? -value : value;\n}\n\n/**\n * Comparison scale for asset amounts. The API emits human-unit decimal strings\n * with at most `token.decimals` fractional digits, so 18 digits is exact for\n * every supported asset.\n */\nconst ASSET_SCALE = 18;\n\nfunction toAssetAmount(rows: UserActivity[]): AssetAmount {\n  // Per the API contract, at most one row of an async lifecycle carries the\n  // asset movement (the other legs are \"0\"), so the max magnitude is the\n  // flow's amount. For refunded flows this surfaces the requested amount\n  // instead of the useless net of zero.\n  let best = rows[0];\n  let bestMagnitude = abs(decimalToBigInt(best.assets_delta.native, ASSET_SCALE));\n  for (const row of rows.slice(1)) {\n    const magnitude = abs(decimalToBigInt(row.assets_delta.native, ASSET_SCALE));\n    if (magnitude > bestMagnitude) {\n      best = row;\n      bestMagnitude = magnitude;\n    }\n  }\n  const token =\n    best.assets_delta.token ?? rows.find((r) => r.assets_delta.token)?.assets_delta.token ?? null;\n  const decimal = best.assets_delta.native.replace(/^-/, '');\n  const raw = token?.decimals != null ? decimalToBigInt(decimal, token.decimals) : null;\n  return { decimal, raw, token };\n}\n\n/**\n * Pure stitcher: folds raw activity rows into `ActivityFlow`s. Rows may be in\n * any order and may span multiple vaults; async lifecycles are paired by\n * `request_hash`. Flows are returned newest-first (by the flow's latest row).\n */\nexport function stitchActivityFlows(rows: UserActivity[]): ActivityFlow[] {\n  const groups = activityLifecycles(orderActivityRows(rows));\n\n  const flows: ActivityFlow[] = [];\n  for (const group of groups) {\n    group.sort((a, b) => a.block_timestamp - b.block_timestamp);\n    const pendingRow = group.find((r) => PENDING_TYPES.has(r.type)) ?? null;\n    const terminalRow = group.find((r) => !PENDING_TYPES.has(r.type)) ?? null;\n    const isAsync = group.some((r) => r.request_hash != null);\n\n    let status: ActivityFlowStatus;\n    if (!terminalRow) status = 'pending';\n    else if (REFUNDED_TYPES.has(terminalRow.type)) status = 'refunded';\n    else status = 'settled';\n\n    let sharesMagnitude = 0n;\n    for (const row of group) {\n      const shares = abs(sharesToBigInt(row.shares_delta));\n      if (shares > sharesMagnitude) sharesMagnitude = shares;\n    }\n\n    flows.push({\n      kind: flowKind((terminalRow ?? pendingRow ?? group[0]).type),\n      status,\n      vaultId: group[0].vault_id,\n      requestHash: group[0].request_hash ?? null,\n      requestedAt: pendingRow\n        ? new Date(pendingRow.block_timestamp * 1000)\n        : isAsync\n          ? null\n          : new Date(group[0].block_timestamp * 1000),\n      settledAt: terminalRow ? new Date(terminalRow.block_timestamp * 1000) : null,\n      assets: toAssetAmount(group),\n      shares: sharesMagnitude,\n      txHashes: [...new Set(group.map((r) => r.tx_hash))],\n    });\n  }\n\n  return flows.sort((a, b) => {\n    const aAt = (a.settledAt ?? a.requestedAt)?.getTime() ?? 0;\n    const bAt = (b.settledAt ?? b.requestedAt)?.getTime() ?? 0;\n    return bAt - aAt;\n  });\n}\n\nexport interface ActivityFlowsOptions extends Pick<ActivityOptions, 'vaultId' | 'limit'> {\n  /** Stop paginating once this many rows have been fetched. Defaults to 1000. */\n  maxRows?: number;\n}\n\n/**\n * Fetches the wallet's activity log and stitches it into lifecycle-aware\n * flows \u2014 the replacement for scanning vault event logs over RPC.\n *\n * ```ts\n * const flows = await getActivityFlows(client.api, wallet);\n * const open = flows.filter((f) => f.status === 'pending');\n * ```\n */\nexport async function getActivityFlows(\n  api: GauntletApi,\n  walletAddress: string,\n  options: ActivityFlowsOptions = {}\n): Promise<ActivityFlow[]> {\n  const maxRows = options.maxRows ?? 1000;\n  const rows: UserActivity[] = [];\n  for await (const row of api.activityRows(walletAddress, {\n    vaultId: options.vaultId,\n    // The API caps page size at 1000; request maxRows per page so the common\n    // case is a single round trip instead of ten default-100 pages.\n    limit: options.limit ?? Math.min(maxRows, 1000),\n    order: 'desc',\n  })) {\n    rows.push(row);\n    if (rows.length >= maxRows) break;\n  }\n  const flows = stitchActivityFlows(rows);\n  if (rows.length >= maxRows) {\n    // The window cut may have split an async lifecycle, keeping a terminal\n    // row whose request leg (the one carrying the amount) fell outside the\n    // window. Drop those flows rather than reporting zeroed amounts.\n    return flows.filter((f) => f.requestHash === null || f.requestedAt !== null);\n  }\n  return flows;\n}\n\nexport interface WaitForSettlementOptions {\n  /** Transaction hash of the submitted request. Prevents reuse of an earlier settlement. */\n  requestTxHash: string;\n  /** CAIP-10 vault id \u2014 narrows polling to one vault's activity. */\n  vaultId?: string;\n  /** Polling interval. Defaults to 5s. */\n  pollIntervalMs?: number;\n  /** Overall deadline. Defaults to 10 minutes. Throws `SettlementTimeoutError` on expiry. */\n  timeoutMs?: number;\n}\n\n/**\n * Polls the activity log until the Aera async request identified by\n * `requestHash` reaches a terminal state, and returns the settled or refunded\n * flow. Use after submitting a `requestDeposit` / `requestRedeem` transaction.\n */\nexport async function waitForRequestSettlement(\n  api: GauntletApi,\n  walletAddress: string,\n  requestHash: string,\n  options: WaitForSettlementOptions\n): Promise<ActivityFlow> {\n  if (typeof options?.requestTxHash !== 'string' || options.requestTxHash.length === 0) {\n    throw new GauntletSDKError(\n      'Settlement polling requires the submitted request transaction hash'\n    );\n  }\n  const pollIntervalMs = options.pollIntervalMs ?? 5_000;\n  const timeoutMs = options.timeoutMs ?? 600_000;\n  const deadline = Date.now() + timeoutMs;\n\n  for (;;) {\n    const flows = await getActivityFlows(api, walletAddress, { vaultId: options.vaultId });\n    const flow = flows.find(\n      (f) =>\n        f.requestHash === requestHash &&\n        f.txHashes.some((hash) => hash.toLowerCase() === options.requestTxHash.toLowerCase())\n    );\n    if (flow && flow.status !== 'pending') return flow;\n\n    if (Date.now() + pollIntervalMs > deadline) {\n      throw new SettlementTimeoutError(requestHash, timeoutMs);\n    }\n    await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["import_errors"]
+}

package/dist/cjs/api/activityRows.d.ts

@@ -0,0 +1,11 @@
+import type { UserActivity } from "./client.js";
+export declare function isPending(row: UserActivity): boolean;
+export declare function requireSameToken(leftRow: UserActivity, rightRow: UserActivity): void;
+export declare function validateActivityRow(row: UserActivity): void;
+export declare function orderActivityRows(rows: UserActivity[]): UserActivity[];
+/**
+ * Split request hashes by vault and by each request occurrence.
+ * Takes the output of `orderActivityRows`.
+ */
+export declare function activityLifecycles(ordered: UserActivity[]): UserActivity[][];
+//# sourceMappingURL=activityRows.d.ts.map

package/dist/cjs/api/activityRows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activityRows.d.ts","sourceRoot":"","sources":["../../../src/api/activityRows.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAiB;AAG7C,wBAAgB,SAAS,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAEpD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,CAepF;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAsD3D;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAQtE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,EAAE,CA+C5E"}

package/dist/cjs/api/activityRows.js

@@ -0,0 +1,139 @@
+"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 activityRows_exports = {};
+__export(activityRows_exports, {
+  activityLifecycles: () => activityLifecycles,
+  isPending: () => isPending,
+  orderActivityRows: () => orderActivityRows,
+  requireSameToken: () => requireSameToken,
+  validateActivityRow: () => validateActivityRow
+});
+module.exports = __toCommonJS(activityRows_exports);
+var import_errors = require("../errors");
+var import_decimal = require("./decimal");
+function isPending(row) {
+  return row.type === "deposit_pending" || row.type === "withdraw_pending";
+}
+function requireSameToken(leftRow, rightRow) {
+  if (leftRow.vault_id.split(":")[0] !== rightRow.vault_id.split(":")[0]) {
+    throw new import_errors.GauntletSDKError("Activity rows contain assets on different chains");
+  }
+  const left = leftRow.assets_delta.token;
+  const right = rightRow.assets_delta.token;
+  if (left != null && right != null && (left.address.toLowerCase() !== right.address.toLowerCase() || (left.decimals ?? null) !== (right.decimals ?? null))) {
+    throw new import_errors.GauntletSDKError("Activity rows contain different asset denominations");
+  }
+}
+function validateActivityRow(row) {
+  const shares = (0, import_decimal.sharesToBigInt)(row.shares_delta);
+  const assets = (0, import_decimal.decimalToBigInt)(row.assets_delta.native, 18);
+  if (!Number.isSafeInteger(row.block_number) || row.block_number < 0 || !Number.isSafeInteger(row.block_timestamp) || row.block_timestamp < 0 || typeof row.vault_id !== "string" || row.vault_id.length === 0 || typeof row.tx_hash !== "string" || row.tx_hash.length === 0 || row.request_hash != null && (typeof row.request_hash !== "string" || row.request_hash.length === 0)) {
+    throw new import_errors.GauntletSDKError("The activity row has invalid event identifiers");
+  }
+  const token = row.assets_delta.token;
+  if (token != null && token.decimals != null) {
+    if (!Number.isInteger(token.decimals) || token.decimals < 0 || token.decimals > 255) {
+      throw new import_errors.GauntletSDKError("The activity token has invalid decimals");
+    }
+    (0, import_decimal.decimalToBigInt)(row.assets_delta.native, token.decimals);
+  }
+  let valid;
+  switch (row.type) {
+    case "deposit":
+      valid = shares >= 0n && assets >= 0n && (row.request_hash == null || assets === 0n);
+      break;
+    case "deposit_pending":
+      valid = shares === 0n && assets > 0n && row.request_hash != null;
+      break;
+    case "deposit_refunded":
+      valid = shares === 0n && assets < 0n && row.request_hash != null;
+      break;
+    case "withdraw":
+      valid = shares <= 0n && assets <= 0n && (row.request_hash == null || shares === 0n);
+      break;
+    case "withdraw_pending":
+      valid = shares < 0n && assets === 0n && row.request_hash != null;
+      break;
+    case "withdraw_refunded":
+      valid = shares > 0n && assets === 0n && row.request_hash != null;
+      break;
+    case "transfer_in":
+      valid = shares >= 0n && assets >= 0n && row.request_hash == null;
+      break;
+    case "transfer_out":
+      valid = shares <= 0n && assets <= 0n && row.request_hash == null;
+      break;
+    default:
+      valid = false;
+  }
+  if (!valid) throw new import_errors.GauntletSDKError(`Invalid activity deltas for ${row.type}`);
+}
+function orderActivityRows(rows) {
+  rows.forEach(validateActivityRow);
+  return [...rows].sort(
+    (a, b) => a.block_number - b.block_number || a.block_timestamp - b.block_timestamp || Number(isPending(b)) - Number(isPending(a))
+  );
+}
+function activityLifecycles(ordered) {
+  const groups = [];
+  const latest = /* @__PURE__ */ new Map();
+  for (const row of ordered) {
+    if (row.request_hash == null) {
+      groups.push([row]);
+      continue;
+    }
+    const key = `${row.vault_id}:${row.request_hash}`;
+    const previous = latest.get(key);
+    if (previous === void 0 || isPending(row)) {
+      if (previous !== void 0 && previous.every(isPending)) {
+        throw new import_errors.GauntletSDKError("An activity request has duplicate pending rows");
+      }
+      const group = [row];
+      latest.set(key, group);
+      groups.push(group);
+      continue;
+    }
+    if (previous.some((entry) => !isPending(entry))) {
+      throw new import_errors.GauntletSDKError("An activity request has conflicting terminal rows");
+    }
+    const pending = previous[0];
+    requireSameToken(pending, row);
+    const expected = pending.type === "deposit_pending" ? ["deposit", "deposit_refunded"] : ["withdraw", "withdraw_refunded"];
+    if (!expected.includes(row.type)) {
+      throw new import_errors.GauntletSDKError("The activity terminal does not match its request");
+    }
+    if (row.type === "deposit_refunded" && (0, import_decimal.decimalToBigInt)(pending.assets_delta.native, 18) !== -(0, import_decimal.decimalToBigInt)(row.assets_delta.native, 18)) {
+      throw new import_errors.GauntletSDKError("The deposit refund does not match its request");
+    }
+    if (row.type === "withdraw_refunded" && (0, import_decimal.sharesToBigInt)(pending.shares_delta) !== -(0, import_decimal.sharesToBigInt)(row.shares_delta)) {
+      throw new import_errors.GauntletSDKError("The withdrawal refund does not match its request");
+    }
+    previous.push(row);
+  }
+  return groups;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  activityLifecycles,
+  isPending,
+  orderActivityRows,
+  requireSameToken,
+  validateActivityRow
+});
+//# sourceMappingURL=activityRows.js.map

package/dist/cjs/api/activityRows.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/api/activityRows.ts"],
+  "sourcesContent": ["import { GauntletSDKError } from '../errors';\nimport type { UserActivity } from './client';\nimport { decimalToBigInt, sharesToBigInt } from './decimal';\n\nexport function isPending(row: UserActivity): boolean {\n  return row.type === 'deposit_pending' || row.type === 'withdraw_pending';\n}\n\nexport function requireSameToken(leftRow: UserActivity, rightRow: UserActivity): void {\n  // The vault ID includes the chain ID; TokenRef has no chain field.\n  if (leftRow.vault_id.split(':')[0] !== rightRow.vault_id.split(':')[0]) {\n    throw new GauntletSDKError('Activity rows contain assets on different chains');\n  }\n  const left = leftRow.assets_delta.token;\n  const right = rightRow.assets_delta.token;\n  if (\n    left != null &&\n    right != null &&\n    (left.address.toLowerCase() !== right.address.toLowerCase() ||\n      (left.decimals ?? null) !== (right.decimals ?? null))\n  ) {\n    throw new GauntletSDKError('Activity rows contain different asset denominations');\n  }\n}\n\nexport function validateActivityRow(row: UserActivity): void {\n  const shares = sharesToBigInt(row.shares_delta);\n  const assets = decimalToBigInt(row.assets_delta.native, 18);\n  if (\n    !Number.isSafeInteger(row.block_number) ||\n    row.block_number < 0 ||\n    !Number.isSafeInteger(row.block_timestamp) ||\n    row.block_timestamp < 0 ||\n    typeof row.vault_id !== 'string' ||\n    row.vault_id.length === 0 ||\n    typeof row.tx_hash !== 'string' ||\n    row.tx_hash.length === 0 ||\n    (row.request_hash != null &&\n      (typeof row.request_hash !== 'string' || row.request_hash.length === 0))\n  ) {\n    throw new GauntletSDKError('The activity row has invalid event identifiers');\n  }\n  const token = row.assets_delta.token;\n  if (token != null && token.decimals != null) {\n    if (!Number.isInteger(token.decimals) || token.decimals < 0 || token.decimals > 255) {\n      throw new GauntletSDKError('The activity token has invalid decimals');\n    }\n    decimalToBigInt(row.assets_delta.native, token.decimals);\n  }\n  let valid: boolean;\n  switch (row.type) {\n    case 'deposit':\n      valid = shares >= 0n && assets >= 0n && (row.request_hash == null || assets === 0n);\n      break;\n    case 'deposit_pending':\n      valid = shares === 0n && assets > 0n && row.request_hash != null;\n      break;\n    case 'deposit_refunded':\n      valid = shares === 0n && assets < 0n && row.request_hash != null;\n      break;\n    case 'withdraw':\n      valid = shares <= 0n && assets <= 0n && (row.request_hash == null || shares === 0n);\n      break;\n    case 'withdraw_pending':\n      valid = shares < 0n && assets === 0n && row.request_hash != null;\n      break;\n    case 'withdraw_refunded':\n      valid = shares > 0n && assets === 0n && row.request_hash != null;\n      break;\n    case 'transfer_in':\n      valid = shares >= 0n && assets >= 0n && row.request_hash == null;\n      break;\n    case 'transfer_out':\n      valid = shares <= 0n && assets <= 0n && row.request_hash == null;\n      break;\n    default:\n      valid = false;\n  }\n  if (!valid) throw new GauntletSDKError(`Invalid activity deltas for ${row.type}`);\n}\n\nexport function orderActivityRows(rows: UserActivity[]): UserActivity[] {\n  rows.forEach(validateActivityRow);\n  return [...rows].sort(\n    (a, b) =>\n      a.block_number - b.block_number ||\n      a.block_timestamp - b.block_timestamp ||\n      Number(isPending(b)) - Number(isPending(a))\n  );\n}\n\n/**\n * Split request hashes by vault and by each request occurrence.\n * Takes the output of `orderActivityRows`.\n */\nexport function activityLifecycles(ordered: UserActivity[]): UserActivity[][] {\n  const groups: UserActivity[][] = [];\n  const latest = new Map<string, UserActivity[]>();\n  for (const row of ordered) {\n    if (row.request_hash == null) {\n      groups.push([row]);\n      continue;\n    }\n    const key = `${row.vault_id}:${row.request_hash}`;\n    const previous = latest.get(key);\n    if (previous === undefined || isPending(row)) {\n      if (previous !== undefined && previous.every(isPending)) {\n        throw new GauntletSDKError('An activity request has duplicate pending rows');\n      }\n      const group = [row];\n      latest.set(key, group);\n      groups.push(group);\n      continue;\n    }\n    if (previous.some((entry) => !isPending(entry))) {\n      throw new GauntletSDKError('An activity request has conflicting terminal rows');\n    }\n    const pending = previous[0];\n    requireSameToken(pending, row);\n    const expected =\n      pending.type === 'deposit_pending'\n        ? ['deposit', 'deposit_refunded']\n        : ['withdraw', 'withdraw_refunded'];\n    if (!expected.includes(row.type)) {\n      throw new GauntletSDKError('The activity terminal does not match its request');\n    }\n    if (\n      row.type === 'deposit_refunded' &&\n      decimalToBigInt(pending.assets_delta.native, 18) !==\n        -decimalToBigInt(row.assets_delta.native, 18)\n    ) {\n      throw new GauntletSDKError('The deposit refund does not match its request');\n    }\n    if (\n      row.type === 'withdraw_refunded' &&\n      sharesToBigInt(pending.shares_delta) !== -sharesToBigInt(row.shares_delta)\n    ) {\n      throw new GauntletSDKError('The withdrawal refund does not match its request');\n    }\n    previous.push(row);\n  }\n  return groups;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/cjs/api/caip.d.ts

@@ -0,0 +1,29 @@
+import type { GauntletClient } from "../client.js";
+/**
+ * The Gaia API identifies vaults as `"{chainId}:{address}"` with a lowercase
+ * address (a CAIP-10-style account id without the `eip155` namespace prefix).
+ */
+export interface ApiVaultId {
+    chainId: number;
+    /** Lowercase EVM address. */
+    address: string;
+}
+export declare function parseApiVaultId(id: string): ApiVaultId;
+export declare function formatApiVaultId(chainId: number, address: string): string;
+/**
+ * Resolves a manifest vault id (e.g. `VaultId.AeraUsdAlpha` / `'gtusda'`) to
+ * the Gaia API's CAIP-10 id for the vault's deployment on `chainId`.
+ *
+ * Deployment resolution is `resolveVault` — the same rules tx-building uses:
+ * single-deployment vaults resolve directly (a mismatched explicit `chainId`
+ * throws `ChainMismatchError`), multi-chain vaults default to Base when
+ * `chainId` is omitted.
+ */
+export declare function apiVaultIdFromVaultId(client: GauntletClient, vaultId: string, chainId?: number): Promise<string>;
+/**
+ * Resolves a Gaia API CAIP-10 vault id back to the manifest vault id, or
+ * `undefined` when the vault is not in the bundled manifest (the API indexes
+ * more vaults than the manifest lists).
+ */
+export declare function vaultIdFromApiVaultId(client: GauntletClient, apiVaultId: string): Promise<string | undefined>;
+//# sourceMappingURL=caip.d.ts.map

package/dist/cjs/api/caip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"caip.d.ts","sourceRoot":"","sources":["../../../src/api/caip.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAkB;AAKhD;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,CAMtD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAQ7B"}

package/dist/cjs/api/caip.js

@@ -0,0 +1,61 @@
+"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 caip_exports = {};
+__export(caip_exports, {
+  apiVaultIdFromVaultId: () => apiVaultIdFromVaultId,
+  formatApiVaultId: () => formatApiVaultId,
+  parseApiVaultId: () => parseApiVaultId,
+  vaultIdFromApiVaultId: () => vaultIdFromApiVaultId
+});
+module.exports = __toCommonJS(caip_exports);
+var import_errors = require("../errors");
+var import_vaults = require("../evm/vaults");
+var import_errors2 = require("./errors");
+function parseApiVaultId(id) {
+  const match = /^(?:eip155:)?(\d+):(0x[0-9a-fA-F]{40})$/.exec(id);
+  if (!match) throw new import_errors2.InvalidCaipIdError(id);
+  const chainId = Number(match[1]);
+  if (!Number.isSafeInteger(chainId) || chainId <= 0) throw new import_errors2.InvalidCaipIdError(id);
+  return { chainId, address: match[2].toLowerCase() };
+}
+function formatApiVaultId(chainId, address) {
+  return `${chainId}:${address.toLowerCase()}`;
+}
+async function apiVaultIdFromVaultId(client, vaultId, chainId) {
+  const resolved = await (0, import_vaults.resolveVault)(client, vaultId, chainId);
+  if (!resolved) throw new import_errors.VaultNotFoundError(vaultId, chainId);
+  return formatApiVaultId(resolved.vault.chainId, resolved.vault.vaultAddress);
+}
+async function vaultIdFromApiVaultId(client, apiVaultId) {
+  const { chainId, address } = parseApiVaultId(apiVaultId);
+  const manifest = await client.manifest;
+  return manifest.vaults.find(
+    (v) => v.deployments.some(
+      (d) => d.chain === "evm" && d.chainId === chainId && d.vaultAddress.toLowerCase() === address
+    )
+  )?.vaultId;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  apiVaultIdFromVaultId,
+  formatApiVaultId,
+  parseApiVaultId,
+  vaultIdFromApiVaultId
+});
+//# sourceMappingURL=caip.js.map

package/dist/cjs/api/caip.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/api/caip.ts"],
+  "sourcesContent": ["import type { GauntletClient } from '../client';\nimport { VaultNotFoundError } from '../errors';\nimport { resolveVault } from '../evm/vaults';\nimport { InvalidCaipIdError } from './errors';\n\n/**\n * The Gaia API identifies vaults as `\"{chainId}:{address}\"` with a lowercase\n * address (a CAIP-10-style account id without the `eip155` namespace prefix).\n */\nexport interface ApiVaultId {\n  chainId: number;\n  /** Lowercase EVM address. */\n  address: string;\n}\n\nexport function parseApiVaultId(id: string): ApiVaultId {\n  const match = /^(?:eip155:)?(\\d+):(0x[0-9a-fA-F]{40})$/.exec(id);\n  if (!match) throw new InvalidCaipIdError(id);\n  const chainId = Number(match[1]);\n  if (!Number.isSafeInteger(chainId) || chainId <= 0) throw new InvalidCaipIdError(id);\n  return { chainId, address: match[2].toLowerCase() };\n}\n\nexport function formatApiVaultId(chainId: number, address: string): string {\n  return `${chainId}:${address.toLowerCase()}`;\n}\n\n/**\n * Resolves a manifest vault id (e.g. `VaultId.AeraUsdAlpha` / `'gtusda'`) to\n * the Gaia API's CAIP-10 id for the vault's deployment on `chainId`.\n *\n * Deployment resolution is `resolveVault` \u2014 the same rules tx-building uses:\n * single-deployment vaults resolve directly (a mismatched explicit `chainId`\n * throws `ChainMismatchError`), multi-chain vaults default to Base when\n * `chainId` is omitted.\n */\nexport async function apiVaultIdFromVaultId(\n  client: GauntletClient,\n  vaultId: string,\n  chainId?: number\n): Promise<string> {\n  const resolved = await resolveVault(client, vaultId, chainId);\n  if (!resolved) throw new VaultNotFoundError(vaultId, chainId);\n  return formatApiVaultId(resolved.vault.chainId, resolved.vault.vaultAddress);\n}\n\n/**\n * Resolves a Gaia API CAIP-10 vault id back to the manifest vault id, or\n * `undefined` when the vault is not in the bundled manifest (the API indexes\n * more vaults than the manifest lists).\n */\nexport async function vaultIdFromApiVaultId(\n  client: GauntletClient,\n  apiVaultId: string\n): Promise<string | undefined> {\n  const { chainId, address } = parseApiVaultId(apiVaultId);\n  const manifest = await client.manifest;\n  return manifest.vaults.find((v) =>\n    v.deployments.some(\n      (d) => d.chain === 'evm' && d.chainId === chainId && d.vaultAddress.toLowerCase() === address\n    )\n  )?.vaultId;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,oBAAmC;AACnC,oBAA6B;AAC7B,IAAAA,iBAAmC;AAY5B,SAAS,gBAAgB,IAAwB;AACtD,QAAM,QAAQ,0CAA0C,KAAK,EAAE;AAC/D,MAAI,CAAC,MAAO,OAAM,IAAI,kCAAmB,EAAE;AAC3C,QAAM,UAAU,OAAO,MAAM,CAAC,CAAC;AAC/B,MAAI,CAAC,OAAO,cAAc,OAAO,KAAK,WAAW,EAAG,OAAM,IAAI,kCAAmB,EAAE;AACnF,SAAO,EAAE,SAAS,SAAS,MAAM,CAAC,EAAE,YAAY,EAAE;AACpD;AAEO,SAAS,iBAAiB,SAAiB,SAAyB;AACzE,SAAO,GAAG,OAAO,IAAI,QAAQ,YAAY,CAAC;AAC5C;AAWA,eAAsB,sBACpB,QACA,SACA,SACiB;AACjB,QAAM,WAAW,UAAM,4BAAa,QAAQ,SAAS,OAAO;AAC5D,MAAI,CAAC,SAAU,OAAM,IAAI,iCAAmB,SAAS,OAAO;AAC5D,SAAO,iBAAiB,SAAS,MAAM,SAAS,SAAS,MAAM,YAAY;AAC7E;AAOA,eAAsB,sBACpB,QACA,YAC6B;AAC7B,QAAM,EAAE,SAAS,QAAQ,IAAI,gBAAgB,UAAU;AACvD,QAAM,WAAW,MAAM,OAAO;AAC9B,SAAO,SAAS,OAAO;AAAA,IAAK,CAAC,MAC3B,EAAE,YAAY;AAAA,MACZ,CAAC,MAAM,EAAE,UAAU,SAAS,EAAE,YAAY,WAAW,EAAE,aAAa,YAAY,MAAM;AAAA,IACxF;AAAA,EACF,GAAG;AACL;",
+  "names": ["import_errors"]
+}