@avalabs/fusion-sdk 0.21.0 → 0.23.0

package/dist/transfer-service/markr/recurring/types.d.ts

@@ -0,0 +1,455 @@
+import { Chain } from "../../../types/chain.js";
+import { Hex } from "../../../types/signer.js";
+import { GasSettings } from "../../../types/service.js";
+import { Address } from "viem";
+
+//#region src/transfer-service/markr/recurring/types.d.ts
+/**
+* Frequency units accepted by Markr's `/recurring/quote` and `/recurring/orders` endpoints.
+*
+* @see https://orchestrator-docs.markr.io/#/paths/~1recurring~1quote/post
+*/
+declare const RECURRING_FREQUENCY_UNITS: readonly ["minute", "hour", "day", "week", "month"];
+type RecurringFrequencyUnit = (typeof RECURRING_FREQUENCY_UNITS)[number];
+interface RecurringFrequency {
+  unit: RecurringFrequencyUnit;
+  /**
+  * Integer in `[1, 365]` (server-enforced upper bound). `validateFrequency`
+  * surfaces violations as `{ ok: false, reason: 'invalid-value' }`.
+  */
+  value: number;
+}
+/**
+* Markr's "unlimited orders" sentinel. Sent to the server as `-1`, which the
+* router expands to `uint256` max on-chain. Callers can also pass `Infinity`
+* to {@link RecurringQuoteParams.numberOfOrders} for the same effect; the API
+* helpers translate to `-1` at the wire boundary.
+*/
+declare const RECURRING_UNLIMITED_ORDERS_SENTINEL = -1;
+/**
+* Status values emitted by Markr for a recurring schedule. Treated as a
+* closed set — if Markr ever adds a new value server-side, the schema
+* will reject it loudly so the SDK update gates rendering changes
+* (instead of silently passing an unhandled state through to the UI).
+*
+* Mirrors the existing `TransferSignatureReason` enum pattern in
+* `constants.ts`: PascalCase members with kebab/lowercase wire values.
+*/
+declare enum RecurringOrderStatus {
+  Active = "active",
+  Completed = "completed",
+  Cancelled = "cancelled",
+  Paused = "paused"
+}
+interface RecurringOrderFailure {
+  /** 1-based index of the failed scheduled swap. */
+  executionIndex: number;
+  /** Reason strings supplied by the orchestrator (e.g. `"Slippage tolerance exceeded"`). */
+  reasons: ReadonlyArray<string>;
+  /** On-chain attempts before the execution was marked failed. */
+  tryCount: number;
+  /** Unix seconds. */
+  failedAt: number;
+}
+/**
+* Server-side recurring-swap order returned by `GET /recurring/orders` and
+* `POST /recurring/orders/{orderId}/cancel`.
+*
+* @see https://orchestrator-docs.markr.io/#/Recurring%20Swaps
+*/
+interface RecurringOrder {
+  /**
+  * bytes32 hex (`0x` + 64 hex chars). Used as the path param for cancellation.
+  * Typed as a template-literal `0x`-prefixed string to catch the obvious
+  * "I forgot the `0x`" mistake at compile time; the wire-level regex check
+  * (in `markrCancelRecurringOrder`) enforces the full bytes32 shape.
+  */
+  orderId: `0x${string}`;
+  /** EVM wallet that created the schedule. */
+  owner: Address;
+  chainId: number;
+  tokenIn: Address;
+  tokenOut: Address;
+  /** Per-order input amount, in `tokenIn`'s smallest unit. */
+  amount: bigint;
+  /** -1 when unlimited; otherwise a positive integer (server-clamped to ≤ 365). */
+  numberOfOrders: number;
+  executedOrders: number;
+  /**
+  * `numberOfOrders - executedOrders` on finite schedules. `null` on
+  * unlimited schedules (`numberOfOrders === -1`) — they have no finite
+  * remainder to report. Per the Markr OpenAPI spec the field is
+  * nullable; the schema also normalizes `undefined` to `null` so a
+  * `=== null` check is sufficient.
+  */
+  remainingOrders: number | null;
+  frequency: RecurringFrequency;
+  /** `amount × numberOfOrders` — the ERC-20 allowance granted at setup. */
+  totalAmountIn: bigint;
+  /** Retry count for the *next* pending execution. `0` when none is pending. */
+  tryCount: number;
+  /** History of failed `executionIndex` values, newest last. */
+  failures: ReadonlyArray<RecurringOrderFailure>;
+  status: RecurringOrderStatus;
+  /** Unix seconds. */
+  createdAt: number;
+  /**
+  * Unix seconds. `null` once the schedule is completed / cancelled /
+  * inactive. Per the Markr OpenAPI spec this field is optional + nullable;
+  * the schema normalizes an omitted-field response to `null` so consumers
+  * can branch on a single `=== null` check.
+  */
+  nextExecutionAt: number | null;
+  /**
+  * Unix seconds when the order was cancelled; `null` otherwise. Populated
+  * with a number when `status === 'cancelled'`. Per the Markr OpenAPI spec
+  * this field is optional + nullable; the schema normalizes both wire
+  * shapes (`null` and omitted) to `null` for consumer ergonomics.
+  */
+  cancelledAt: number | null;
+}
+/**
+* Known fee types emitted by Markr today. Open at runtime — the schema
+* tolerates unknown values so a new fee category from the orchestrator doesn't
+* fail quote parsing. See {@link RecurringOrderStatus} for the widening
+* pattern.
+*/
+type RecurringQuoteFeeType = "gas" | "recurring" | "protocol" | "bridge" | "slippage" | "swap" | "other" | (string & Record<never, never>);
+interface RecurringQuoteFee {
+  type: RecurringQuoteFeeType;
+  name: string;
+  amount: bigint;
+  token: {
+    chainId: number;
+    address: Address;
+  };
+  /**
+  * Docs document `extra` as `boolean or object`. The boolean form is the
+  * legacy "additive one-time charge" flag (e.g. the one-time native
+  * schedule fee with `type: 'recurring'`); the object form is reserved
+  * for future structured metadata. Consumers should treat any truthy
+  * value as "additive — balance-check separately."
+  */
+  extra?: boolean | Record<string, unknown>;
+}
+interface RecurringQuoteResponse {
+  uuid: string;
+  chainId: number;
+  tokenIn: Address;
+  tokenOut: Address;
+  /** Per-order input. */
+  amount: bigint;
+  /** Server-side clamped value (may be 365 if the request was unlimited). */
+  numberOfOrders: number;
+  frequency: RecurringFrequency;
+  /** Server-derived from `frequency`. */
+  intervalSeconds: number;
+  /** `amount × numberOfOrders` — the ERC-20 allowance the caller must grant. */
+  totalAmountIn: bigint;
+  /** First-fill output estimate. */
+  amountOut: bigint;
+  /** First-fill `minAmountOut` (slippage applied). */
+  minAmountOut: bigint;
+  fees: ReadonlyArray<RecurringQuoteFee>;
+  /** Basis points. */
+  recommendedSlippage: number;
+  /** Unix seconds. */
+  expiredAt: number;
+}
+interface RecurringQuoteParams {
+  appId: string;
+  chainId: number;
+  tokenIn: Address;
+  tokenInDecimals: number;
+  tokenOut: Address;
+  tokenOutDecimals: number;
+  /**
+  * Per-order input in smallest unit. `bigint` only — matches the rest of the
+  * SDK's internal amount types (response amounts, `Quote.amountIn`, etc.).
+  * Callers holding a decimal string should coerce with `BigInt(s)` at the
+  * call site.
+  */
+  amount: bigint;
+  /**
+  * Number of orders. Accepts:
+  * - `Infinity` or `-1` — translated to the unlimited sentinel (`-1`) on the wire.
+  * - Integer in `[2, 365]` — Markr's documented finite bound.
+  *
+  * Anything else (`NaN`, `0`, `1`, negatives other than `-1`, non-integers,
+  * values > 365) throws `InvalidParamsError` at the SDK boundary so a
+  * misbehaving form parse (`parseInt('')` → `NaN`, or a stale "minimum is 1"
+  * assumption) can't silently become an unlimited schedule or a guaranteed
+  * server-side rejection.
+  */
+  numberOfOrders: number;
+  frequency: RecurringFrequency;
+  /** Basis points (matches `/quote` semantics). */
+  slippage?: number;
+}
+interface RecurringSwapParams {
+  uuid: string;
+  appId: string;
+}
+interface ListRecurringOrdersParams {
+  address: Address;
+  chainId?: number;
+  status?: RecurringOrderStatus;
+}
+interface ListRecurringOrdersResponse {
+  address: Address;
+  count: number;
+  orders: ReadonlyArray<RecurringOrder>;
+}
+/**
+* Shared params for the three order-action execute methods
+* ({@link RecurringNamespace.executeCancellation},
+* {@link RecurringNamespace.executePause},
+* {@link RecurringNamespace.executeUnpause}). The SDK derives the wire-level
+* `chainId` from `sourceChain`, estimates gas via the chain's RPC, then signs
+* and broadcasts via the configured `evmSigner`.
+*/
+interface RecurringExecuteOrderActionParams {
+  /** See {@link RecurringOrder.orderId} for the shape. */
+  orderId: `0x${string}`;
+  /** Owner address of the schedule — must match the order's `owner`. */
+  address: Address;
+  /**
+  * Source chain the schedule lives on — pass the same `Chain` that backs
+  * `sourceChain` on the recurring order (the SDK reads `rpcUrl` + multicall
+  * for the on-chain gas estimate and uses `chainId` for the wire request).
+  */
+  sourceChain: Chain;
+  /** Optional fee-margin + 1559 overrides forwarded to the signed TX. */
+  gasSettings?: GasSettings;
+  /**
+  * Opaque payload forwarded unchanged onto the `step.signerContext` field
+  * seen by the configured `EvmSigner`. Lets consumers correlate the wallet
+  * prompt back to the specific cancel / pause / unpause request that
+  * produced it (e.g. UI slot id, display label) without relying on an
+  * action-type-keyed lookup map that two concurrent same-type actions
+  * could clobber.
+  */
+  signerContext?: unknown;
+}
+/**
+* Params for {@link RecurringNamespace.executeFirstFill}. Replaces the
+* pre-signer `prepareFirstFill` shape; the SDK now reads the on-chain
+* allowance against `totalAmountIn`, signs an `approve` if needed (batched
+* one-click when `evmSigner.signBatch` is available and the swap is
+* same-chain), then signs and broadcasts the first-fill swap.
+*/
+interface RecurringExecuteFirstFillParams {
+  /** Full recurring quote — carries `uuid`, `totalAmountIn`, `expiredAt`. */
+  quote: RecurringQuoteResponse;
+  /** EVM address creating the schedule (and signing the first fill). */
+  fromAddress: Address;
+  /**
+  * Source chain — same `Chain` used to obtain the recurring quote. The SDK
+  * reads `rpcUrl` for allowance + gas calls; `chainId` is cross-checked
+  * against `quote.chainId` to catch obvious wiring mistakes.
+  */
+  sourceChain: Chain;
+  /** Optional fee-margin + 1559 overrides. */
+  gasSettings?: GasSettings;
+  /**
+  * Mirrors the same flag on `TransferService.transferAsset`: when the
+  * one-click batch (approval + first-fill) is attempted and the consumer's
+  * wallet rejects the batch, fall back to two sequential signatures
+  * (`approve`, then `swap`) instead of bubbling the batch error up.
+  */
+  fallbackToDefaultOnBatchFailure?: boolean;
+  /**
+  * Opaque payload forwarded unchanged onto the `step.signerContext` field
+  * seen by the configured `EvmSigner` for both the optional approval step
+  * and the first-fill swap step. See
+  * {@link RecurringExecuteOrderActionParams.signerContext}.
+  */
+  signerContext?: unknown;
+}
+/** Result of any `recurring.execute*` method — broadcast TX hash. */
+interface RecurringExecuteResult {
+  txHash: Hex;
+}
+interface RecurringChainInfoEntry {
+  /** Server-published lower bound for `intervalSeconds` (today: 300s on enabled chains). */
+  minFrequencySeconds: number;
+  supportedTokens: ReadonlyArray<{
+    address: Address;
+    /**
+    * Smallest-unit decimal string — must be `BigInt()`-parseable (i.e.
+    * matches `/^\d+$/`). The Zod schema enforces this on the wire, but the
+    * TS type alone is plain `string`; consumers constructing this map by
+    * hand (caching, tests) should pass a digits-only decimal string or
+    * `BigInt(minimumAmount)` will throw downstream in `checkEligibility`.
+    */
+    minimumAmount: string;
+  }>;
+}
+/**
+* Cached `/info/chains` recurring metadata keyed by EVM chainId. SVM chains
+* are omitted — Markr supports recurring on same-chain EVM only.
+*/
+type RecurringChainInfoMap = ReadonlyMap<number, RecurringChainInfoEntry>;
+/**
+* Reasons surfaced when {@link checkRecurringEligibility} returns
+* `{ eligible: false, … }`. Mirrors the existing `TransferSignatureReason`
+* enum pattern (PascalCase member, kebab-case wire value) so external
+* consumers comparing the raw string still match.
+*/
+declare enum RecurringEligibilityReason {
+  CrossChain = "cross-chain",
+  UnsupportedSourceChain = "unsupported-source-chain",
+  UnsupportedToken = "unsupported-token",
+  NoEvmAddress = "no-evm-address",
+  AmountBelowMinimum = "amount-below-minimum"
+}
+type RecurringEligibility = {
+  eligible: true;
+  minimumAmount: string;
+  minIntervalSeconds: number;
+} | {
+  eligible: false;
+  reason: RecurringEligibilityReason.AmountBelowMinimum;
+  minimumAmount: string;
+} | {
+  eligible: false;
+  reason: Exclude<RecurringEligibilityReason, RecurringEligibilityReason.AmountBelowMinimum>;
+};
+interface CheckRecurringEligibilityParams {
+  recurringChainInfo: RecurringChainInfoMap;
+  fromTokenAddress: Address;
+  toTokenAddress: Address;
+  sourceChainId: number;
+  targetChainId: number;
+  ownerAddress?: Address;
+  /** Per-order amount; when present, enables the `amount-below-minimum` check. */
+  amount?: bigint;
+}
+/**
+* Params passed to `RecurringNamespace.checkEligibility`. Same as
+* `CheckRecurringEligibilityParams` minus the chain-info map, which the
+* namespace closure injects.
+*/
+type RecurringNamespaceCheckEligibilityParams = Omit<CheckRecurringEligibilityParams, "recurringChainInfo">;
+/**
+* Params passed to `RecurringNamespace.quote`. Same as `RecurringQuoteParams`
+* minus `appId`, which the namespace closure injects.
+*/
+type RecurringNamespaceQuoteParams = Omit<RecurringQuoteParams, "appId">;
+/**
+* High-level wrapper exposed as `MarkrService.recurring`. Methods curry
+* `apiOptions`, `appId`, and the cached `recurringChainInfo` so callers only
+* pass per-call inputs.
+*/
+interface RecurringNamespace {
+  /** POST `/recurring/quote` — full quote with `totalAmountIn`, fees, expiry, uuid. */
+  quote(props: RecurringNamespaceQuoteParams): Promise<RecurringQuoteResponse>;
+  /**
+  * Creates the schedule on-chain by signing and broadcasting the first
+  * `/recurring/swap` fill via the configured `evmSigner`. Mirrors
+  * `TransferService.transferAsset`:
+  *
+  * 1. Reads on-chain `allowance(tokenIn → router)` against `quote.totalAmountIn`.
+  * 2. If allowance is short, builds an `approve(router, totalAmountIn)` TX.
+  *    When the consumer's signer exposes `signBatch`, the SDK attempts a
+  *    one-click batch (approve + swap) — set
+  *    {@link RecurringExecuteFirstFillParams.fallbackToDefaultOnBatchFailure}
+  *    to fall back to two sequential signatures if the wallet rejects the
+  *    batch.
+  * 3. Estimates gas (with `gasSettings.estimateGasMarginBps` margin) for
+  *    each TX before signing, and dispatches the signed serialized TX via
+  *    the chain's RPC.
+  *
+  * Quote-expiry guard mirrors the previous `prepareFirstFill` behavior —
+  * `quote.expiredAt <= now` throws `InvalidParamsError(QUOTE_EXPIRED)` at
+  * the SDK boundary before any HTTP / on-chain call.
+  *
+  * Returns the broadcast first-fill TX hash; the schedule transitions to
+  * `'active'` once Markr observes the on-chain event (poll `listOrders`).
+  */
+  executeFirstFill(props: RecurringExecuteFirstFillParams): Promise<RecurringExecuteResult>;
+  /**
+  * GET `/recurring/orders?address=…&chainId?=…&status?=…` — returns the
+  * full response (`{ address, count, orders }`) so callers can render the
+  * server-echoed `address` (e.g. confirming the queried wallet matches the
+  * current EVM signer) and `count` (pagination / "you have N schedules"
+  * affordances) without an extra lookup. Consumers that only care about the
+  * orders array can destructure: `const { orders } = await listOrders(…)`.
+  */
+  listOrders(props: ListRecurringOrdersParams): Promise<ListRecurringOrdersResponse>;
+  /**
+  * Cancels the recurring schedule identified by `orderId`: fetches the
+  * `/recurring/orders/{orderId}/cancel` calldata, estimates gas, then signs
+  * and broadcasts via the configured `evmSigner`. The schedule transitions
+  * to `status: 'cancelled'` only once the TX confirms and Markr observes
+  * the on-chain event.
+  *
+  * Eligibility: only `'active'` and `'paused'` orders can be cancelled per
+  * Markr's docs. An attempt to cancel a `'completed'` order surfaces as
+  * `HttpError(400)` from the orchestrator before signing.
+  */
+  executeCancellation(props: RecurringExecuteOrderActionParams): Promise<RecurringExecuteResult>;
+  /**
+  * Pauses the recurring schedule identified by `orderId`: fetches the
+  * `/recurring/orders/{orderId}/pause` calldata, estimates gas, then signs
+  * and broadcasts via the configured `evmSigner`. The schedule transitions
+  * to `status: 'paused'` only once the TX confirms and Markr observes the
+  * on-chain event.
+  *
+  * Eligibility: only `'active'` orders can be paused per Markr's docs.
+  * Attempting to pause a non-`active` order surfaces as `HttpError(400)`.
+  *
+  * Pausing preserves the schedule's existing ERC-20 allowance — when the
+  * user later unpauses, no re-approval and no new native schedule fee are
+  * required (this is the key UX benefit of pause over cancel-and-recreate).
+  *
+  * @see https://orchestrator-docs.markr.io/#tag/Recurring-Swaps/paths/~1recurring~1orders~1{orderId}~1pause/post
+  */
+  executePause(props: RecurringExecuteOrderActionParams): Promise<RecurringExecuteResult>;
+  /**
+  * Unpauses (resumes) the recurring schedule identified by `orderId`:
+  * fetches the `/recurring/orders/{orderId}/unpause` calldata, estimates
+  * gas, then signs and broadcasts via the configured `evmSigner`. The
+  * schedule transitions back to `status: 'active'` only once the TX
+  * confirms and Markr observes the on-chain event.
+  *
+  * Eligibility: only `'paused'` orders can be unpaused per Markr's docs.
+  * Attempting to unpause a non-`paused` order surfaces as `HttpError(400)`.
+  *
+  * Resumes execution from where the schedule left off — remaining fills
+  * continue on the original `frequency` cadence. The orchestrator recomputes
+  * `nextExecutionAt` after the TX confirms.
+  *
+  * @see https://orchestrator-docs.markr.io/#tag/Recurring-Swaps/paths/~1recurring~1orders~1{orderId}~1unpause/post
+  */
+  executeUnpause(props: RecurringExecuteOrderActionParams): Promise<RecurringExecuteResult>;
+  /**
+  * Pure (no fetch) — uses the cached `/info/chains` recurring metadata.
+  *
+  * **Covers:** chain support, token support, EVM-address presence, same-chain
+  * (cross-chain rejected), and per-order minimum (when `amount` is passed —
+  * failure carries `minimumAmount`).
+  *
+  * **Does NOT cover wallet balance.** This helper has no wallet/RPC context.
+  * Checking that the user holds `amount × numberOfOrders` of `tokenIn` (plus
+  * native gas for the first fill) is the consumer's responsibility, same as
+  * the one-shot swap flow. There is no `InsufficientBalance` reason on
+  * {@link RecurringEligibilityReason} by design.
+  *
+  * **Does NOT cover post-fill failures.** Once a schedule is live, on-chain
+  * reverts (slippage, runtime insufficient balance, etc.) surface server-side
+  * as open-ended strings on `RecurringOrder.failures[].reasons` — substring-
+  * match those for client-driven auto-cancel (AC4 pattern) and call
+  * {@link RecurringNamespace.prepareCancellation} when applicable.
+  *
+  * **Does NOT cover server-side quote rejection.** Slippage, target-token
+  * unsupported, liquidity, etc. are decided at `/recurring/quote` time and
+  * surface as `HttpError` from {@link RecurringNamespace.quote}.
+  */
+  checkEligibility(props: RecurringNamespaceCheckEligibilityParams): RecurringEligibility;
+  /** Returns the cached `/info/chains` recurring metadata. */
+  getRecurringChainInfo(): RecurringChainInfoMap;
+}
+//#endregion
+export { CheckRecurringEligibilityParams, ListRecurringOrdersParams, ListRecurringOrdersResponse, RECURRING_FREQUENCY_UNITS, RECURRING_UNLIMITED_ORDERS_SENTINEL, RecurringChainInfoEntry, RecurringChainInfoMap, RecurringEligibility, RecurringEligibilityReason, RecurringExecuteFirstFillParams, RecurringExecuteOrderActionParams, RecurringExecuteResult, RecurringFrequency, RecurringFrequencyUnit, RecurringNamespace, RecurringNamespaceCheckEligibilityParams, RecurringNamespaceQuoteParams, RecurringOrder, RecurringOrderFailure, RecurringOrderStatus, RecurringQuoteFee, RecurringQuoteFeeType, RecurringQuoteParams, RecurringQuoteResponse, RecurringSwapParams };
+//# sourceMappingURL=types.d.ts.map

package/dist/transfer-service/markr/recurring/types.js

@@ -0,0 +1,2 @@
+const e=[`minute`,`hour`,`day`,`week`,`month`],t=-1;let n=function(e){return e.Active=`active`,e.Completed=`completed`,e.Cancelled=`cancelled`,e.Paused=`paused`,e}({}),r=function(e){return e.CrossChain=`cross-chain`,e.UnsupportedSourceChain=`unsupported-source-chain`,e.UnsupportedToken=`unsupported-token`,e.NoEvmAddress=`no-evm-address`,e.AmountBelowMinimum=`amount-below-minimum`,e}({});export{e as RECURRING_FREQUENCY_UNITS,t as RECURRING_UNLIMITED_ORDERS_SENTINEL,r as RecurringEligibilityReason,n as RecurringOrderStatus};
+//# sourceMappingURL=types.js.map

package/dist/transfer-service/markr/recurring/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":[],"sources":["../../../../src/transfer-service/markr/recurring/types.ts"],"sourcesContent":["import type { Address as EvmAddress } from 'viem';\nimport type { Chain } from '../../../types/chain';\nimport type { GasSettings } from '../../../types/service';\nimport type { Hex } from '../../../types/signer';\n\n/**\n * Frequency units accepted by Markr's `/recurring/quote` and `/recurring/orders` endpoints.\n *\n * @see https://orchestrator-docs.markr.io/#/paths/~1recurring~1quote/post\n */\nexport const RECURRING_FREQUENCY_UNITS = ['minute', 'hour', 'day', 'week', 'month'] as const;\n\nexport type RecurringFrequencyUnit = (typeof RECURRING_FREQUENCY_UNITS)[number];\n\nexport interface RecurringFrequency {\n  unit: RecurringFrequencyUnit;\n  /**\n   * Integer in `[1, 365]` (server-enforced upper bound). `validateFrequency`\n   * surfaces violations as `{ ok: false, reason: 'invalid-value' }`.\n   */\n  value: number;\n}\n\n/**\n * Markr's \"unlimited orders\" sentinel. Sent to the server as `-1`, which the\n * router expands to `uint256` max on-chain. Callers can also pass `Infinity`\n * to {@link RecurringQuoteParams.numberOfOrders} for the same effect; the API\n * helpers translate to `-1` at the wire boundary.\n */\nexport const RECURRING_UNLIMITED_ORDERS_SENTINEL = -1;\n\n/**\n * Status values emitted by Markr for a recurring schedule. Treated as a\n * closed set — if Markr ever adds a new value server-side, the schema\n * will reject it loudly so the SDK update gates rendering changes\n * (instead of silently passing an unhandled state through to the UI).\n *\n * Mirrors the existing `TransferSignatureReason` enum pattern in\n * `constants.ts`: PascalCase members with kebab/lowercase wire values.\n */\nexport enum RecurringOrderStatus {\n  Active = 'active',\n  Completed = 'completed',\n  Cancelled = 'cancelled',\n  Paused = 'paused',\n}\n\nexport interface RecurringOrderFailure {\n  /** 1-based index of the failed scheduled swap. */\n  executionIndex: number;\n  /** Reason strings supplied by the orchestrator (e.g. `\"Slippage tolerance exceeded\"`). */\n  reasons: ReadonlyArray<string>;\n  /** On-chain attempts before the execution was marked failed. */\n  tryCount: number;\n  /** Unix seconds. */\n  failedAt: number;\n}\n\n/**\n * Server-side recurring-swap order returned by `GET /recurring/orders` and\n * `POST /recurring/orders/{orderId}/cancel`.\n *\n * @see https://orchestrator-docs.markr.io/#/Recurring%20Swaps\n */\nexport interface RecurringOrder {\n  /**\n   * bytes32 hex (`0x` + 64 hex chars). Used as the path param for cancellation.\n   * Typed as a template-literal `0x`-prefixed string to catch the obvious\n   * \"I forgot the `0x`\" mistake at compile time; the wire-level regex check\n   * (in `markrCancelRecurringOrder`) enforces the full bytes32 shape.\n   */\n  orderId: `0x${string}`;\n  /** EVM wallet that created the schedule. */\n  owner: EvmAddress;\n  chainId: number;\n  tokenIn: EvmAddress;\n  tokenOut: EvmAddress;\n  /** Per-order input amount, in `tokenIn`'s smallest unit. */\n  amount: bigint;\n  /** -1 when unlimited; otherwise a positive integer (server-clamped to ≤ 365). */\n  numberOfOrders: number;\n  executedOrders: number;\n  /**\n   * `numberOfOrders - executedOrders` on finite schedules. `null` on\n   * unlimited schedules (`numberOfOrders === -1`) — they have no finite\n   * remainder to report. Per the Markr OpenAPI spec the field is\n   * nullable; the schema also normalizes `undefined` to `null` so a\n   * `=== null` check is sufficient.\n   */\n  remainingOrders: number | null;\n  frequency: RecurringFrequency;\n  /** `amount × numberOfOrders` — the ERC-20 allowance granted at setup. */\n  totalAmountIn: bigint;\n  /** Retry count for the *next* pending execution. `0` when none is pending. */\n  tryCount: number;\n  /** History of failed `executionIndex` values, newest last. */\n  failures: ReadonlyArray<RecurringOrderFailure>;\n  status: RecurringOrderStatus;\n  /** Unix seconds. */\n  createdAt: number;\n  /**\n   * Unix seconds. `null` once the schedule is completed / cancelled /\n   * inactive. Per the Markr OpenAPI spec this field is optional + nullable;\n   * the schema normalizes an omitted-field response to `null` so consumers\n   * can branch on a single `=== null` check.\n   */\n  nextExecutionAt: number | null;\n  /**\n   * Unix seconds when the order was cancelled; `null` otherwise. Populated\n   * with a number when `status === 'cancelled'`. Per the Markr OpenAPI spec\n   * this field is optional + nullable; the schema normalizes both wire\n   * shapes (`null` and omitted) to `null` for consumer ergonomics.\n   */\n  cancelledAt: number | null;\n}\n\n/**\n * Known fee types emitted by Markr today. Open at runtime — the schema\n * tolerates unknown values so a new fee category from the orchestrator doesn't\n * fail quote parsing. See {@link RecurringOrderStatus} for the widening\n * pattern.\n */\nexport type RecurringQuoteFeeType =\n  | 'gas'\n  | 'recurring'\n  | 'protocol'\n  | 'bridge'\n  | 'slippage'\n  | 'swap'\n  | 'other'\n  // See `RecurringOrderStatus` for why `Record<never, never>` replaces `{}`.\n  | (string & Record<never, never>);\n\nexport interface RecurringQuoteFee {\n  type: RecurringQuoteFeeType;\n  name: string;\n  amount: bigint;\n  token: { chainId: number; address: EvmAddress };\n  /**\n   * Docs document `extra` as `boolean or object`. The boolean form is the\n   * legacy \"additive one-time charge\" flag (e.g. the one-time native\n   * schedule fee with `type: 'recurring'`); the object form is reserved\n   * for future structured metadata. Consumers should treat any truthy\n   * value as \"additive — balance-check separately.\"\n   */\n  extra?: boolean | Record<string, unknown>;\n}\n\nexport interface RecurringQuoteResponse {\n  uuid: string;\n  chainId: number;\n  tokenIn: EvmAddress;\n  tokenOut: EvmAddress;\n  /** Per-order input. */\n  amount: bigint;\n  /** Server-side clamped value (may be 365 if the request was unlimited). */\n  numberOfOrders: number;\n  frequency: RecurringFrequency;\n  /** Server-derived from `frequency`. */\n  intervalSeconds: number;\n  /** `amount × numberOfOrders` — the ERC-20 allowance the caller must grant. */\n  totalAmountIn: bigint;\n  /** First-fill output estimate. */\n  amountOut: bigint;\n  /** First-fill `minAmountOut` (slippage applied). */\n  minAmountOut: bigint;\n  fees: ReadonlyArray<RecurringQuoteFee>;\n  /** Basis points. */\n  recommendedSlippage: number;\n  /** Unix seconds. */\n  expiredAt: number;\n}\n\nexport interface RecurringQuoteParams {\n  appId: string;\n  chainId: number;\n  tokenIn: EvmAddress;\n  tokenInDecimals: number;\n  tokenOut: EvmAddress;\n  tokenOutDecimals: number;\n  /**\n   * Per-order input in smallest unit. `bigint` only — matches the rest of the\n   * SDK's internal amount types (response amounts, `Quote.amountIn`, etc.).\n   * Callers holding a decimal string should coerce with `BigInt(s)` at the\n   * call site.\n   */\n  amount: bigint;\n  /**\n   * Number of orders. Accepts:\n   * - `Infinity` or `-1` — translated to the unlimited sentinel (`-1`) on the wire.\n   * - Integer in `[2, 365]` — Markr's documented finite bound.\n   *\n   * Anything else (`NaN`, `0`, `1`, negatives other than `-1`, non-integers,\n   * values > 365) throws `InvalidParamsError` at the SDK boundary so a\n   * misbehaving form parse (`parseInt('')` → `NaN`, or a stale \"minimum is 1\"\n   * assumption) can't silently become an unlimited schedule or a guaranteed\n   * server-side rejection.\n   */\n  numberOfOrders: number;\n  frequency: RecurringFrequency;\n  /** Basis points (matches `/quote` semantics). */\n  slippage?: number;\n}\n\nexport interface RecurringSwapParams {\n  uuid: string;\n  appId: string;\n}\n\nexport interface ListRecurringOrdersParams {\n  address: EvmAddress;\n  chainId?: number;\n  status?: RecurringOrderStatus;\n}\n\nexport interface ListRecurringOrdersResponse {\n  address: EvmAddress;\n  count: number;\n  orders: ReadonlyArray<RecurringOrder>;\n}\n\n/**\n * Wire-level params for the internal `_api.ts` cancel/pause/unpause helpers\n * (`markrPrepareCancellation` etc.). Public consumers reach the same endpoints\n * via {@link RecurringNamespace.executeCancellation}/`executePause`/\n * `executeUnpause`, which take {@link RecurringExecuteOrderActionParams}\n * instead and derive `chainId` from the passed `sourceChain`.\n */\nexport interface RecurringOrderActionApiParams {\n  /** See {@link RecurringOrder.orderId} for the shape. */\n  orderId: `0x${string}`;\n  address: EvmAddress;\n  /**\n   * Chain the schedule lives on — required by Markr's\n   * `POST /recurring/orders/{orderId}/{action}` endpoints (the orchestrator\n   * scopes orderIds per chain, so the same bytes32 could in principle exist\n   * on multiple chains).\n   */\n  chainId: number;\n}\n\n/**\n * Shared params for the three order-action execute methods\n * ({@link RecurringNamespace.executeCancellation},\n * {@link RecurringNamespace.executePause},\n * {@link RecurringNamespace.executeUnpause}). The SDK derives the wire-level\n * `chainId` from `sourceChain`, estimates gas via the chain's RPC, then signs\n * and broadcasts via the configured `evmSigner`.\n */\nexport interface RecurringExecuteOrderActionParams {\n  /** See {@link RecurringOrder.orderId} for the shape. */\n  orderId: `0x${string}`;\n  /** Owner address of the schedule — must match the order's `owner`. */\n  address: EvmAddress;\n  /**\n   * Source chain the schedule lives on — pass the same `Chain` that backs\n   * `sourceChain` on the recurring order (the SDK reads `rpcUrl` + multicall\n   * for the on-chain gas estimate and uses `chainId` for the wire request).\n   */\n  sourceChain: Chain;\n  /** Optional fee-margin + 1559 overrides forwarded to the signed TX. */\n  gasSettings?: GasSettings;\n  /**\n   * Opaque payload forwarded unchanged onto the `step.signerContext` field\n   * seen by the configured `EvmSigner`. Lets consumers correlate the wallet\n   * prompt back to the specific cancel / pause / unpause request that\n   * produced it (e.g. UI slot id, display label) without relying on an\n   * action-type-keyed lookup map that two concurrent same-type actions\n   * could clobber.\n   */\n  signerContext?: unknown;\n}\n\n/**\n * Params for {@link RecurringNamespace.executeFirstFill}. Replaces the\n * pre-signer `prepareFirstFill` shape; the SDK now reads the on-chain\n * allowance against `totalAmountIn`, signs an `approve` if needed (batched\n * one-click when `evmSigner.signBatch` is available and the swap is\n * same-chain), then signs and broadcasts the first-fill swap.\n */\nexport interface RecurringExecuteFirstFillParams {\n  /** Full recurring quote — carries `uuid`, `totalAmountIn`, `expiredAt`. */\n  quote: RecurringQuoteResponse;\n  /** EVM address creating the schedule (and signing the first fill). */\n  fromAddress: EvmAddress;\n  /**\n   * Source chain — same `Chain` used to obtain the recurring quote. The SDK\n   * reads `rpcUrl` for allowance + gas calls; `chainId` is cross-checked\n   * against `quote.chainId` to catch obvious wiring mistakes.\n   */\n  sourceChain: Chain;\n  /** Optional fee-margin + 1559 overrides. */\n  gasSettings?: GasSettings;\n  /**\n   * Mirrors the same flag on `TransferService.transferAsset`: when the\n   * one-click batch (approval + first-fill) is attempted and the consumer's\n   * wallet rejects the batch, fall back to two sequential signatures\n   * (`approve`, then `swap`) instead of bubbling the batch error up.\n   */\n  fallbackToDefaultOnBatchFailure?: boolean;\n  /**\n   * Opaque payload forwarded unchanged onto the `step.signerContext` field\n   * seen by the configured `EvmSigner` for both the optional approval step\n   * and the first-fill swap step. See\n   * {@link RecurringExecuteOrderActionParams.signerContext}.\n   */\n  signerContext?: unknown;\n}\n\n/** Result of any `recurring.execute*` method — broadcast TX hash. */\nexport interface RecurringExecuteResult {\n  txHash: Hex;\n}\n\nexport interface RecurringChainInfoEntry {\n  /** Server-published lower bound for `intervalSeconds` (today: 300s on enabled chains). */\n  minFrequencySeconds: number;\n  supportedTokens: ReadonlyArray<{\n    address: EvmAddress;\n    /**\n     * Smallest-unit decimal string — must be `BigInt()`-parseable (i.e.\n     * matches `/^\\d+$/`). The Zod schema enforces this on the wire, but the\n     * TS type alone is plain `string`; consumers constructing this map by\n     * hand (caching, tests) should pass a digits-only decimal string or\n     * `BigInt(minimumAmount)` will throw downstream in `checkEligibility`.\n     */\n    minimumAmount: string;\n  }>;\n}\n\n/**\n * Cached `/info/chains` recurring metadata keyed by EVM chainId. SVM chains\n * are omitted — Markr supports recurring on same-chain EVM only.\n */\nexport type RecurringChainInfoMap = ReadonlyMap<number, RecurringChainInfoEntry>;\n\n/**\n * Reasons surfaced when {@link checkRecurringEligibility} returns\n * `{ eligible: false, … }`. Mirrors the existing `TransferSignatureReason`\n * enum pattern (PascalCase member, kebab-case wire value) so external\n * consumers comparing the raw string still match.\n */\nexport enum RecurringEligibilityReason {\n  CrossChain = 'cross-chain',\n  UnsupportedSourceChain = 'unsupported-source-chain',\n  UnsupportedToken = 'unsupported-token',\n  NoEvmAddress = 'no-evm-address',\n  AmountBelowMinimum = 'amount-below-minimum',\n}\n\nexport type RecurringEligibility =\n  | { eligible: true; minimumAmount: string; minIntervalSeconds: number }\n  // `AmountBelowMinimum` carries the floor so error UIs can say \"Min is X\"\n  // without a second `getRecurringChainInfo()` lookup. The value is the same\n  // smallest-unit decimal string as the success branch's `minimumAmount`.\n  | { eligible: false; reason: RecurringEligibilityReason.AmountBelowMinimum; minimumAmount: string }\n  | { eligible: false; reason: Exclude<RecurringEligibilityReason, RecurringEligibilityReason.AmountBelowMinimum> };\n\nexport interface CheckRecurringEligibilityParams {\n  recurringChainInfo: RecurringChainInfoMap;\n  fromTokenAddress: EvmAddress;\n  toTokenAddress: EvmAddress;\n  sourceChainId: number;\n  targetChainId: number;\n  ownerAddress?: EvmAddress;\n  /** Per-order amount; when present, enables the `amount-below-minimum` check. */\n  amount?: bigint;\n}\n\n/**\n * Params passed to `RecurringNamespace.checkEligibility`. Same as\n * `CheckRecurringEligibilityParams` minus the chain-info map, which the\n * namespace closure injects.\n */\nexport type RecurringNamespaceCheckEligibilityParams = Omit<CheckRecurringEligibilityParams, 'recurringChainInfo'>;\n\n/**\n * Params passed to `RecurringNamespace.quote`. Same as `RecurringQuoteParams`\n * minus `appId`, which the namespace closure injects.\n */\nexport type RecurringNamespaceQuoteParams = Omit<RecurringQuoteParams, 'appId'>;\n\n/**\n * High-level wrapper exposed as `MarkrService.recurring`. Methods curry\n * `apiOptions`, `appId`, and the cached `recurringChainInfo` so callers only\n * pass per-call inputs.\n */\nexport interface RecurringNamespace {\n  /** POST `/recurring/quote` — full quote with `totalAmountIn`, fees, expiry, uuid. */\n  quote(props: RecurringNamespaceQuoteParams): Promise<RecurringQuoteResponse>;\n\n  /**\n   * Creates the schedule on-chain by signing and broadcasting the first\n   * `/recurring/swap` fill via the configured `evmSigner`. Mirrors\n   * `TransferService.transferAsset`:\n   *\n   * 1. Reads on-chain `allowance(tokenIn → router)` against `quote.totalAmountIn`.\n   * 2. If allowance is short, builds an `approve(router, totalAmountIn)` TX.\n   *    When the consumer's signer exposes `signBatch`, the SDK attempts a\n   *    one-click batch (approve + swap) — set\n   *    {@link RecurringExecuteFirstFillParams.fallbackToDefaultOnBatchFailure}\n   *    to fall back to two sequential signatures if the wallet rejects the\n   *    batch.\n   * 3. Estimates gas (with `gasSettings.estimateGasMarginBps` margin) for\n   *    each TX before signing, and dispatches the signed serialized TX via\n   *    the chain's RPC.\n   *\n   * Quote-expiry guard mirrors the previous `prepareFirstFill` behavior —\n   * `quote.expiredAt <= now` throws `InvalidParamsError(QUOTE_EXPIRED)` at\n   * the SDK boundary before any HTTP / on-chain call.\n   *\n   * Returns the broadcast first-fill TX hash; the schedule transitions to\n   * `'active'` once Markr observes the on-chain event (poll `listOrders`).\n   */\n  executeFirstFill(props: RecurringExecuteFirstFillParams): Promise<RecurringExecuteResult>;\n\n  /**\n   * GET `/recurring/orders?address=…&chainId?=…&status?=…` — returns the\n   * full response (`{ address, count, orders }`) so callers can render the\n   * server-echoed `address` (e.g. confirming the queried wallet matches the\n   * current EVM signer) and `count` (pagination / \"you have N schedules\"\n   * affordances) without an extra lookup. Consumers that only care about the\n   * orders array can destructure: `const { orders } = await listOrders(…)`.\n   */\n  listOrders(props: ListRecurringOrdersParams): Promise<ListRecurringOrdersResponse>;\n\n  /**\n   * Cancels the recurring schedule identified by `orderId`: fetches the\n   * `/recurring/orders/{orderId}/cancel` calldata, estimates gas, then signs\n   * and broadcasts via the configured `evmSigner`. The schedule transitions\n   * to `status: 'cancelled'` only once the TX confirms and Markr observes\n   * the on-chain event.\n   *\n   * Eligibility: only `'active'` and `'paused'` orders can be cancelled per\n   * Markr's docs. An attempt to cancel a `'completed'` order surfaces as\n   * `HttpError(400)` from the orchestrator before signing.\n   */\n  executeCancellation(props: RecurringExecuteOrderActionParams): Promise<RecurringExecuteResult>;\n\n  /**\n   * Pauses the recurring schedule identified by `orderId`: fetches the\n   * `/recurring/orders/{orderId}/pause` calldata, estimates gas, then signs\n   * and broadcasts via the configured `evmSigner`. The schedule transitions\n   * to `status: 'paused'` only once the TX confirms and Markr observes the\n   * on-chain event.\n   *\n   * Eligibility: only `'active'` orders can be paused per Markr's docs.\n   * Attempting to pause a non-`active` order surfaces as `HttpError(400)`.\n   *\n   * Pausing preserves the schedule's existing ERC-20 allowance — when the\n   * user later unpauses, no re-approval and no new native schedule fee are\n   * required (this is the key UX benefit of pause over cancel-and-recreate).\n   *\n   * @see https://orchestrator-docs.markr.io/#tag/Recurring-Swaps/paths/~1recurring~1orders~1{orderId}~1pause/post\n   */\n  executePause(props: RecurringExecuteOrderActionParams): Promise<RecurringExecuteResult>;\n\n  /**\n   * Unpauses (resumes) the recurring schedule identified by `orderId`:\n   * fetches the `/recurring/orders/{orderId}/unpause` calldata, estimates\n   * gas, then signs and broadcasts via the configured `evmSigner`. The\n   * schedule transitions back to `status: 'active'` only once the TX\n   * confirms and Markr observes the on-chain event.\n   *\n   * Eligibility: only `'paused'` orders can be unpaused per Markr's docs.\n   * Attempting to unpause a non-`paused` order surfaces as `HttpError(400)`.\n   *\n   * Resumes execution from where the schedule left off — remaining fills\n   * continue on the original `frequency` cadence. The orchestrator recomputes\n   * `nextExecutionAt` after the TX confirms.\n   *\n   * @see https://orchestrator-docs.markr.io/#tag/Recurring-Swaps/paths/~1recurring~1orders~1{orderId}~1unpause/post\n   */\n  executeUnpause(props: RecurringExecuteOrderActionParams): Promise<RecurringExecuteResult>;\n\n  /**\n   * Pure (no fetch) — uses the cached `/info/chains` recurring metadata.\n   *\n   * **Covers:** chain support, token support, EVM-address presence, same-chain\n   * (cross-chain rejected), and per-order minimum (when `amount` is passed —\n   * failure carries `minimumAmount`).\n   *\n   * **Does NOT cover wallet balance.** This helper has no wallet/RPC context.\n   * Checking that the user holds `amount × numberOfOrders` of `tokenIn` (plus\n   * native gas for the first fill) is the consumer's responsibility, same as\n   * the one-shot swap flow. There is no `InsufficientBalance` reason on\n   * {@link RecurringEligibilityReason} by design.\n   *\n   * **Does NOT cover post-fill failures.** Once a schedule is live, on-chain\n   * reverts (slippage, runtime insufficient balance, etc.) surface server-side\n   * as open-ended strings on `RecurringOrder.failures[].reasons` — substring-\n   * match those for client-driven auto-cancel (AC4 pattern) and call\n   * {@link RecurringNamespace.prepareCancellation} when applicable.\n   *\n   * **Does NOT cover server-side quote rejection.** Slippage, target-token\n   * unsupported, liquidity, etc. are decided at `/recurring/quote` time and\n   * surface as `HttpError` from {@link RecurringNamespace.quote}.\n   */\n  checkEligibility(props: RecurringNamespaceCheckEligibilityParams): RecurringEligibility;\n\n  /** Returns the cached `/info/chains` recurring metadata. */\n  getRecurringChainInfo(): RecurringChainInfoMap;\n}\n"],"mappings":"AAUA,MAAa,EAA4B,CAAC,SAAU,OAAQ,MAAO,OAAQ,QAAQ,CAmBtE,EAAsC,GAWnD,IAAY,EAAL,SAAA,EAAA,OACL,GAAA,OAAA,SACA,EAAA,UAAA,YACA,EAAA,UAAA,YACA,EAAA,OAAA,eACD,CAySW,EAAL,SAAA,EAAA,OACL,GAAA,WAAA,cACA,EAAA,uBAAA,2BACA,EAAA,iBAAA,oBACA,EAAA,aAAA,iBACA,EAAA,mBAAA,6BACD"}

package/dist/transfer-service/wrap-unwrap/_handlers/transfer-asset.cjs

@@ -1,2 +1,2 @@
-require(`../../../_virtual/_rolldown/runtime.cjs`);const e=require(`../../../constants.cjs`),t=require(`../../../errors.cjs`),n=require(`../../../utils/caip.cjs`),r=require(`../../_transfer-utilities.cjs`),i=require(`../../_utils.cjs`),a=require(`../_utils.cjs`);let o=require(`viem`);function s({chainConfigs:s,environment:c,evmSigner:l}){return async({quote:u,gasSettings:d,onStepChange:f})=>{if(u.serviceType!==e.ServiceType.WRAP_UNWRAP)throw new t.SdkError(t.ErrorReason.INCORRECT_PROVIDER_PROVIDED,t.ErrorCode.INVALID_PARAMS);let p=Math.floor(Date.now()/1e3);if(u.expiresAt<=p)throw new t.SdkError(t.ErrorReason.QUOTE_EXPIRED,t.ErrorCode.INVALID_PARAMS);let m=u.fromAddress;if(!(0,o.isAddress)(m))throw new t.SdkError(t.ErrorReason.INVALID_PARAMS,t.ErrorCode.INVALID_PARAMS,{details:`fromAddress is not a valid EVM address.`});let h=u.sourceChain.chainId,g=a.getWrapDirection(u.assetIn,u.assetOut,h,s);if(!g)throw new t.SdkError(t.ErrorReason.INVALID_PARAMS,t.ErrorCode.INVALID_PARAMS,{details:`Quote does not represent a valid wrap/unwrap pair.`});let _=a.getWrapperContractAddress(h,s),v=g===`wrap`,y=a.encodeWrapUnwrapData(g,u.amountIn),b=i.getEvmClientForChain({chain:u.sourceChain}),x=await a.estimateWrapUnwrapGas({direction:g,amountIn:u.amountIn,contractAddress:_,fromAddress:m,client:b,estimateGasMarginBps:d?.estimateGasMarginBps}),S={chainId:n.caip2ToEip155HexChainId(u.sourceChain.chainId),data:y,from:m,gas:x,to:_,value:v?u.amountIn:0n,...d?.maxFeePerGas===void 0?null:{maxFeePerGas:d.maxFeePerGas,maxPriorityFeePerGas:d.maxPriorityFeePerGas}},C={currentSignature:1,currentSignatureReason:e.TransferSignatureReason.WrapToken,quote:u,requiredSignatures:1};f?.(C);let w=Date.now();return r.sourcePendingTransferFromQuote(u,{environment:c,txHash:await l.sign(S,async e=>b.sendRawTransaction({serializedTransaction:e}),C),startedAtMs:w,requiredConfirmationCount:1})}}exports.transferAssetFactory=s;
+require(`../../../_virtual/_rolldown/runtime.cjs`);const e=require(`../../../constants.cjs`),t=require(`../../../errors.cjs`),n=require(`../../../utils/caip.cjs`),r=require(`../../_utils.cjs`),i=require(`../../_transfer-utilities.cjs`),a=require(`../_utils.cjs`);let o=require(`viem`);function s({chainConfigs:s,environment:c,evmSigner:l}){return async({quote:u,gasSettings:d,onStepChange:f})=>{if(u.serviceType!==e.ServiceType.WRAP_UNWRAP)throw new t.SdkError(t.ErrorReason.INCORRECT_PROVIDER_PROVIDED,t.ErrorCode.INVALID_PARAMS);let p=Math.floor(Date.now()/1e3);if(u.expiresAt<=p)throw new t.SdkError(t.ErrorReason.QUOTE_EXPIRED,t.ErrorCode.INVALID_PARAMS);let m=u.fromAddress;if(!(0,o.isAddress)(m))throw new t.SdkError(t.ErrorReason.INVALID_PARAMS,t.ErrorCode.INVALID_PARAMS,{details:`fromAddress is not a valid EVM address.`});let h=u.sourceChain.chainId,g=a.getWrapDirection(u.assetIn,u.assetOut,h,s);if(!g)throw new t.SdkError(t.ErrorReason.INVALID_PARAMS,t.ErrorCode.INVALID_PARAMS,{details:`Quote does not represent a valid wrap/unwrap pair.`});let _=a.getWrapperContractAddress(h,s),v=g===`wrap`,y=a.encodeWrapUnwrapData(g,u.amountIn),b=r.getEvmClientForChain({chain:u.sourceChain}),x=await a.estimateWrapUnwrapGas({direction:g,amountIn:u.amountIn,contractAddress:_,fromAddress:m,client:b,estimateGasMarginBps:d?.estimateGasMarginBps}),S={chainId:n.caip2ToEip155HexChainId(u.sourceChain.chainId),data:y,from:m,gas:x,to:_,value:v?u.amountIn:0n,...d?.maxFeePerGas===void 0?null:{maxFeePerGas:d.maxFeePerGas,maxPriorityFeePerGas:d.maxPriorityFeePerGas}},C={currentSignature:1,currentSignatureReason:e.TransferSignatureReason.WrapToken,quote:u,requiredSignatures:1};f?.(C);let w=Date.now();return i.sourcePendingTransferFromQuote(u,{environment:c,txHash:await l.sign(S,async e=>b.sendRawTransaction({serializedTransaction:e}),C),startedAtMs:w,requiredConfirmationCount:1})}}exports.transferAssetFactory=s;
 //# sourceMappingURL=transfer-asset.cjs.map

package/dist/transfer-service/wrap-unwrap/_handlers/transfer-asset.js

@@ -1,2 +1,2 @@
-import{ServiceType as e,TransferSignatureReason as t}from"../../../constants.js";import{ErrorCode as n,ErrorReason as r,SdkError as i}from"../../../errors.js";import{caip2ToEip155HexChainId as a}from"../../../utils/caip.js";import{sourcePendingTransferFromQuote as o}from"../../_transfer-utilities.js";import{getEvmClientForChain as s}from"../../_utils.js";import{encodeWrapUnwrapData as c,estimateWrapUnwrapGas as l,getWrapDirection as u,getWrapperContractAddress as d}from"../_utils.js";import{isAddress as f}from"viem";function p({chainConfigs:p,environment:m,evmSigner:h}){return async({quote:g,gasSettings:_,onStepChange:v})=>{if(g.serviceType!==e.WRAP_UNWRAP)throw new i(r.INCORRECT_PROVIDER_PROVIDED,n.INVALID_PARAMS);let y=Math.floor(Date.now()/1e3);if(g.expiresAt<=y)throw new i(r.QUOTE_EXPIRED,n.INVALID_PARAMS);let b=g.fromAddress;if(!f(b))throw new i(r.INVALID_PARAMS,n.INVALID_PARAMS,{details:`fromAddress is not a valid EVM address.`});let x=g.sourceChain.chainId,S=u(g.assetIn,g.assetOut,x,p);if(!S)throw new i(r.INVALID_PARAMS,n.INVALID_PARAMS,{details:`Quote does not represent a valid wrap/unwrap pair.`});let C=d(x,p),w=S===`wrap`,T=c(S,g.amountIn),E=s({chain:g.sourceChain}),D=await l({direction:S,amountIn:g.amountIn,contractAddress:C,fromAddress:b,client:E,estimateGasMarginBps:_?.estimateGasMarginBps}),O={chainId:a(g.sourceChain.chainId),data:T,from:b,gas:D,to:C,value:w?g.amountIn:0n,..._?.maxFeePerGas===void 0?null:{maxFeePerGas:_.maxFeePerGas,maxPriorityFeePerGas:_.maxPriorityFeePerGas}},k={currentSignature:1,currentSignatureReason:t.WrapToken,quote:g,requiredSignatures:1};v?.(k);let A=Date.now();return o(g,{environment:m,txHash:await h.sign(O,async e=>E.sendRawTransaction({serializedTransaction:e}),k),startedAtMs:A,requiredConfirmationCount:1})}}export{p as transferAssetFactory};
+import{ServiceType as e,TransferSignatureReason as t}from"../../../constants.js";import{ErrorCode as n,ErrorReason as r,SdkError as i}from"../../../errors.js";import{caip2ToEip155HexChainId as a}from"../../../utils/caip.js";import{getEvmClientForChain as o}from"../../_utils.js";import{sourcePendingTransferFromQuote as s}from"../../_transfer-utilities.js";import{encodeWrapUnwrapData as c,estimateWrapUnwrapGas as l,getWrapDirection as u,getWrapperContractAddress as d}from"../_utils.js";import{isAddress as f}from"viem";function p({chainConfigs:p,environment:m,evmSigner:h}){return async({quote:g,gasSettings:_,onStepChange:v})=>{if(g.serviceType!==e.WRAP_UNWRAP)throw new i(r.INCORRECT_PROVIDER_PROVIDED,n.INVALID_PARAMS);let y=Math.floor(Date.now()/1e3);if(g.expiresAt<=y)throw new i(r.QUOTE_EXPIRED,n.INVALID_PARAMS);let b=g.fromAddress;if(!f(b))throw new i(r.INVALID_PARAMS,n.INVALID_PARAMS,{details:`fromAddress is not a valid EVM address.`});let x=g.sourceChain.chainId,S=u(g.assetIn,g.assetOut,x,p);if(!S)throw new i(r.INVALID_PARAMS,n.INVALID_PARAMS,{details:`Quote does not represent a valid wrap/unwrap pair.`});let C=d(x,p),w=S===`wrap`,T=c(S,g.amountIn),E=o({chain:g.sourceChain}),D=await l({direction:S,amountIn:g.amountIn,contractAddress:C,fromAddress:b,client:E,estimateGasMarginBps:_?.estimateGasMarginBps}),O={chainId:a(g.sourceChain.chainId),data:T,from:b,gas:D,to:C,value:w?g.amountIn:0n,..._?.maxFeePerGas===void 0?null:{maxFeePerGas:_.maxFeePerGas,maxPriorityFeePerGas:_.maxPriorityFeePerGas}},k={currentSignature:1,currentSignatureReason:t.WrapToken,quote:g,requiredSignatures:1};v?.(k);let A=Date.now();return s(g,{environment:m,txHash:await h.sign(O,async e=>E.sendRawTransaction({serializedTransaction:e}),k),startedAtMs:A,requiredConfirmationCount:1})}}export{p as transferAssetFactory};
 //# sourceMappingURL=transfer-asset.js.map

package/dist/types/transfer-manager.d.cts

@@ -7,6 +7,7 @@ import { SdkError } from "../errors.cjs";
 import { Transfer } from "./transfer.cjs";
 import { EstimateNativeFeeOptions, GetBridgeableAssetsProps, GetMinimumTransferAmountProps, GetSupportedChainsResult, NativeFeeEstimate, ServiceInitializer, TrackTransferProps, TransferAssetProps } from "./service.cjs";
 import { QuoterOptions } from "../quoter/quoter.cjs";
+import { RecurringNamespace } from "../transfer-service/markr/recurring/types.cjs";
 
 //#region src/types/transfer-manager.d.ts
 interface AssetBridgeMap {
@@ -93,6 +94,21 @@ interface TransferManager {
   getSupportedChains(): Promise<GetSupportedChainsResult>;
   /** Create a quote aggregator for the specified intent. */
   getQuoter(props: QuoterProps, options?: QuoterOptions): QuoterInterface;
+  /**
+  * Recurring-swap (DCA) capability surface, aggregated at the manager layer
+  * to match the style of `getBridgeableAssets` / `getMinimumTransferAmount`.
+  *
+  * The manager delegates each call internally to whichever underlying
+  * service implements recurring (today: Markr). Each method throws
+  * `ServiceUnavailableError` if no initialized service backs the call —
+  * same failure shape as `transferAsset` / `estimateNativeFee` /
+  * `trackTransfer` when the relevant service wasn't in the initializer
+  * list.
+  *
+  * @example
+  *   const quote = await manager.recurring.quote({ ... });
+  */
+  readonly recurring: RecurringNamespace;
   /** Returns the current status of the transfer manager. */
   status(): TransferManagerStatus;
   /** Track a transfer’s lifecycle. */

package/dist/types/transfer-manager.d.ts

@@ -7,6 +7,7 @@ import { SdkError } from "../errors.js";
 import { Transfer } from "./transfer.js";
 import { EstimateNativeFeeOptions, GetBridgeableAssetsProps, GetMinimumTransferAmountProps, GetSupportedChainsResult, NativeFeeEstimate, ServiceInitializer, TrackTransferProps, TransferAssetProps } from "./service.js";
 import { QuoterOptions } from "../quoter/quoter.js";
+import { RecurringNamespace } from "../transfer-service/markr/recurring/types.js";
 
 //#region src/types/transfer-manager.d.ts
 interface AssetBridgeMap {
@@ -93,6 +94,21 @@ interface TransferManager {
   getSupportedChains(): Promise<GetSupportedChainsResult>;
   /** Create a quote aggregator for the specified intent. */
   getQuoter(props: QuoterProps, options?: QuoterOptions): QuoterInterface;
+  /**
+  * Recurring-swap (DCA) capability surface, aggregated at the manager layer
+  * to match the style of `getBridgeableAssets` / `getMinimumTransferAmount`.
+  *
+  * The manager delegates each call internally to whichever underlying
+  * service implements recurring (today: Markr). Each method throws
+  * `ServiceUnavailableError` if no initialized service backs the call —
+  * same failure shape as `transferAsset` / `estimateNativeFee` /
+  * `trackTransfer` when the relevant service wasn't in the initializer
+  * list.
+  *
+  * @example
+  *   const quote = await manager.recurring.quote({ ... });
+  */
+  readonly recurring: RecurringNamespace;
   /** Returns the current status of the transfer manager. */
   status(): TransferManagerStatus;
   /** Track a transfer’s lifecycle. */

package/dist/types/transfer.d.cts

@@ -16,6 +16,14 @@ interface TransferStepDetails {
   readonly requiredSignatures: number;
   /** The original quote */
   readonly quote: Quote;
+  /**
+  * Opaque per-request payload supplied by the caller on the originating
+  * execute call; the SDK forwards it unchanged. Lets consumers correlate
+  * a signer prompt back to the specific request that produced it without
+  * relying on out-of-band state keyed by action type (which can collide
+  * when two same-type actions are in flight).
+  */
+  readonly signerContext?: unknown;
 }
 /**
 * Unified transfer lifecycle states (bridge and swap).

package/dist/types/transfer.d.ts

@@ -16,6 +16,14 @@ interface TransferStepDetails {
   readonly requiredSignatures: number;
   /** The original quote */
   readonly quote: Quote;
+  /**
+  * Opaque per-request payload supplied by the caller on the originating
+  * execute call; the SDK forwards it unchanged. Lets consumers correlate
+  * a signer prompt back to the specific request that produced it without
+  * relying on out-of-band state keyed by action type (which can collide
+  * when two same-type actions are in flight).
+  */
+  readonly signerContext?: unknown;
 }
 /**
 * Unified transfer lifecycle states (bridge and swap).

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@avalabs/fusion-sdk",
   "license": "Limited Ecosystem License",
-  "version": "0.21.0",
+  "version": "0.23.0",
   "type": "module",
   "main": "./dist/mod.cjs",
   "module": "./dist/mod.js",
@@ -49,8 +49,8 @@
     "vitest": "4.0.6",
     "tsdown": "0.21.4",
     "zod": "4.1.12",
-    "@internal/tsdown-config": "0.0.1",
-    "eslint-config-custom": "0.1.0"
+    "eslint-config-custom": "0.1.0",
+    "@internal/tsdown-config": "0.0.1"
   },
   "sideEffects": false,
   "scripts": {