@avalabs/fusion-sdk 0.21.0 → 0.23.0

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

@@ -0,0 +1,17 @@
+import { RecurringFrequency } from "./types.js";
+
+//#region src/transfer-service/markr/recurring/_frequency.d.ts
+declare function deriveIntervalSeconds(frequency: RecurringFrequency): number;
+type FrequencyValidationResult = {
+  ok: true;
+  intervalSeconds: number;
+} | {
+  ok: false;
+  reason: "below-minimum" | "invalid-unit" | "invalid-value";
+};
+/** Server-enforced upper bound on `RecurringFrequency.value` (per Markr API docs). */
+declare const RECURRING_FREQUENCY_VALUE_MAX: number;
+declare function validateFrequency(frequency: RecurringFrequency, minFrequencySeconds: number): FrequencyValidationResult;
+//#endregion
+export { FrequencyValidationResult, RECURRING_FREQUENCY_VALUE_MAX, deriveIntervalSeconds, validateFrequency };
+//# sourceMappingURL=_frequency.d.ts.map

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

@@ -0,0 +1,2 @@
+const e={minute:60,hour:3600,day:86400,week:604800,month:2592e3};function t(t){return e[t.unit]*t.value}const n=365;function r(n,r){if(!(n.unit in e))return{ok:!1,reason:`invalid-unit`};if(!Number.isInteger(n.value)||n.value<1||n.value>365)return{ok:!1,reason:`invalid-value`};let i=t(n);return i<r?{ok:!1,reason:`below-minimum`}:{ok:!0,intervalSeconds:i}}export{n as RECURRING_FREQUENCY_VALUE_MAX,t as deriveIntervalSeconds,r as validateFrequency};
+//# sourceMappingURL=_frequency.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_frequency.js","names":[],"sources":["../../../../src/transfer-service/markr/recurring/_frequency.ts"],"sourcesContent":["import type { RecurringFrequency, RecurringFrequencyUnit } from './types';\n\n/**\n * Seconds-per-unit lookup. The \"month\" entry uses 30 days; Markr's `/recurring/quote`\n * returns the server-derived `intervalSeconds`, so this helper is a client-side\n * estimator (used for the picker's \"below-minimum\" greying), not the source of truth.\n */\nconst SECONDS_BY_UNIT: Readonly<Record<RecurringFrequencyUnit, number>> = {\n  minute: 60,\n  hour: 3600,\n  day: 86_400,\n  week: 604_800,\n  month: 2_592_000,\n};\n\nexport function deriveIntervalSeconds(frequency: RecurringFrequency): number {\n  return SECONDS_BY_UNIT[frequency.unit] * frequency.value;\n}\n\nexport type FrequencyValidationResult =\n  | { ok: true; intervalSeconds: number }\n  | { ok: false; reason: 'below-minimum' | 'invalid-unit' | 'invalid-value' };\n\n/** Server-enforced upper bound on `RecurringFrequency.value` (per Markr API docs). */\nexport const RECURRING_FREQUENCY_VALUE_MAX: number = 365;\n\nexport function validateFrequency(\n  frequency: RecurringFrequency,\n  minFrequencySeconds: number,\n): FrequencyValidationResult {\n  if (!(frequency.unit in SECONDS_BY_UNIT)) {\n    return { ok: false, reason: 'invalid-unit' };\n  }\n\n  // `1 ≤ value ≤ 365` mirrors the server-side bound. Catching it here lets\n  // picker UIs surface the error inline instead of waiting for the\n  // `/recurring/quote` HTTP round-trip to fail.\n  if (!Number.isInteger(frequency.value) || frequency.value < 1 || frequency.value > RECURRING_FREQUENCY_VALUE_MAX) {\n    return { ok: false, reason: 'invalid-value' };\n  }\n\n  const intervalSeconds = deriveIntervalSeconds(frequency);\n\n  if (intervalSeconds < minFrequencySeconds) {\n    return { ok: false, reason: 'below-minimum' };\n  }\n\n  return { ok: true, intervalSeconds };\n}\n"],"mappings":"AAOA,MAAM,EAAoE,CACxE,OAAQ,GACR,KAAM,KACN,IAAK,MACL,KAAM,OACN,MAAO,OACR,CAED,SAAgB,EAAsB,EAAuC,CAC3E,OAAO,EAAgB,EAAU,MAAQ,EAAU,MAQrD,MAAa,EAAwC,IAErD,SAAgB,EACd,EACA,EAC2B,CAC3B,GAAI,EAAE,EAAU,QAAQ,GACtB,MAAO,CAAE,GAAI,GAAO,OAAQ,eAAgB,CAM9C,GAAI,CAAC,OAAO,UAAU,EAAU,MAAM,EAAI,EAAU,MAAQ,GAAK,EAAU,MAAA,IACzE,MAAO,CAAE,GAAI,GAAO,OAAQ,gBAAiB,CAG/C,IAAM,EAAkB,EAAsB,EAAU,CAMxD,OAJI,EAAkB,EACb,CAAE,GAAI,GAAO,OAAQ,gBAAiB,CAGxC,CAAE,GAAI,GAAM,kBAAiB"}

package/dist/transfer-service/markr/recurring/_namespace.cjs

@@ -0,0 +1,2 @@
+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(`../../_evm-errors.cjs`),a=require(`../../_evm-approval.cjs`),o=require(`../_api.cjs`),s=require(`../_utils.cjs`),c=require(`./_api.cjs`),l=require(`./_eligibility.cjs`);let u=require(`viem`);function d({apiOptions:t,appId:n,evmSigner:r,recurringChainInfo:i}){return{quote:e=>c.markrRecurringQuote(t,{...e,appId:n}),executeFirstFill:e=>f({...e,apiOptions:t,appId:n,evmSigner:r}),listOrders:e=>c.markrListRecurringOrders(t,e),executeCancellation:n=>m({...n,signatureReason:e.TransferSignatureReason.CancelRecurringSwap,apiOptions:t,evmSigner:r,fetchCalldata:c.markrPrepareCancellation}),executePause:n=>m({...n,signatureReason:e.TransferSignatureReason.PauseRecurringSwap,apiOptions:t,evmSigner:r,fetchCalldata:c.markrPreparePause}),executeUnpause:n=>m({...n,signatureReason:e.TransferSignatureReason.ResumeRecurringSwap,apiOptions:t,evmSigner:r,fetchCalldata:c.markrPrepareUnpause}),checkEligibility:e=>l.checkRecurringEligibility({...e,recurringChainInfo:i}),getRecurringChainInfo:()=>i}}async function f({apiOptions:l,appId:u,evmSigner:d,fallbackToDefaultOnBatchFailure:f,fromAddress:p,gasSettings:m,quote:g,signerContext:_,sourceChain:v}){let y=Math.floor(Date.now()/1e3);if(g.expiredAt<=y){let e=y-g.expiredAt;throw new t.InvalidParamsError(t.ErrorReason.QUOTE_EXPIRED,`Recurring quote expired ${e} seconds ago.`)}let b=n.caip2ToEip155ChainId(v.chainId);if(b!==g.chainId)throw new t.InvalidParamsError(`sourceChain does not match quote.chainId`,`sourceChain.chainId=${v.chainId} resolves to ${b}, but quote.chainId=${g.chainId}.`);let x=r.getEvmClientForChain({chain:v}),S=n.caip2ToEip155HexChainId(v.chainId),{address:C}=await o.markrGetSpenderAddress(l,{chainId:g.chainId,crossChainSwap:!1,quoteId:g.uuid});if(!C)throw new t.SdkError(t.ErrorReason.CHAIN_NOT_SUPPORTED,t.ErrorCode.INVALID_PARAMS,{details:`Missing Markr spender address for source chain ${v.chainId}.`});let w=await a.buildErc20ApprovalRequest({chainIdHex:S,client:x,gasSettings:m,owner:p,requiredAllowance:g.totalAmountIn,spender:C,token:g.tokenIn}),T=h({fromAddress:p,quote:g,sourceChain:v}),E=await c.markrRecurringSwap(l,{uuid:g.uuid,appId:u});if(w!==void 0&&typeof d.signBatch==`function`){let n={currentSignature:1,currentSignatureReason:e.TransferSignatureReason.ScheduleRecurringSwap,quote:T,requiredSignatures:1,signerContext:_},i={chainId:S,data:E.data,from:p,gas:void 0,to:E.to,value:E.value,...r.maybe1559(m)};try{let e=(await d.signBatch([w,i],e=>x.sendRawTransaction({serializedTransaction:e}),n)).at(-1);if(!e)throw new t.SdkError(`One-click batch signing returned no transaction hashes.`,t.ErrorCode.SIGNING_FAILED);return{txHash:e}}catch(e){if(!f)throw e}}w&&await a.signApprovalAndAssertConfirmed({client:x,evmSigner:d,request:w,step:{currentSignature:1,currentSignatureReason:e.TransferSignatureReason.AllowanceApproval,quote:T,requiredSignatures:2,signerContext:_}});let D=await s.getMarkrSwapWrapperAbi(!1),O=await i.estimateGasWithRevert(x,{account:p,to:E.to,data:E.data,value:E.value},D,`Failed to estimate gas for recurring first-fill swap transaction.`),k={chainId:S,data:E.data,from:p,gas:r.applyFeeUnitsBpsMargin(O,m?.estimateGasMarginBps),to:E.to,value:E.value,...r.maybe1559(m)},A={currentSignature:w?2:1,currentSignatureReason:e.TransferSignatureReason.ScheduleRecurringSwap,quote:T,requiredSignatures:w?2:1,signerContext:_};return{txHash:await d.sign(k,e=>x.sendRawTransaction({serializedTransaction:e}),A)}}const p={[e.TransferSignatureReason.PauseRecurringSwap]:`pause`,[e.TransferSignatureReason.ResumeRecurringSwap]:`resume`,[e.TransferSignatureReason.CancelRecurringSwap]:`cancel`};async function m({signatureReason:e,address:t,apiOptions:a,evmSigner:o,fetchCalldata:s,gasSettings:c,orderId:l,signerContext:d,sourceChain:f}){let m=r.getEvmClientForChain({chain:f}),h=n.caip2ToEip155ChainId(f.chainId),_=n.caip2ToEip155HexChainId(f.chainId),v=await s(a,{orderId:l,address:t,chainId:h}),y=await i.estimateGasWithRevert(m,{account:t,to:v.to,data:v.data,value:v.value},u.erc20Abi,`Failed to estimate gas for recurring ${p[e]} transaction.`),b={chainId:_,data:v.data,from:t,gas:r.applyFeeUnitsBpsMargin(y,c?.estimateGasMarginBps),to:v.to,value:v.value,...r.maybe1559(c)},x={currentSignature:1,currentSignatureReason:e,quote:g({address:t,signatureReason:e,orderId:l,sourceChain:f}),requiredSignatures:1,signerContext:d};return{txHash:await o.sign(b,e=>m.sendRawTransaction({serializedTransaction:e}),x)}}function h({fromAddress:t,quote:n,sourceChain:r}){return{aggregator:{id:`markr-recurring`,name:`Markr recurring`},amountIn:n.amount,amountOut:n.amountOut,assetIn:{type:e.TokenType.ERC20,address:n.tokenIn,name:``,symbol:``,decimals:0},assetOut:{type:e.TokenType.ERC20,address:n.tokenOut,name:``,symbol:``,decimals:0},expiresAt:n.expiredAt,fees:[],fromAddress:t,id:n.uuid,partnerFeeBps:null,serviceType:e.ServiceType.MARKR,slippageBps:n.recommendedSlippage,sourceChain:r,targetChain:r,toAddress:t}}function g({signatureReason:t,address:n,orderId:r,sourceChain:i}){let a=p[t];return{aggregator:{id:`markr-recurring-${a}`,name:`Markr recurring (${a})`},amountIn:0n,amountOut:0n,assetIn:_(),assetOut:_(),expiresAt:0,fees:[],fromAddress:n,id:r,partnerFeeBps:null,serviceType:e.ServiceType.MARKR,slippageBps:0,sourceChain:i,targetChain:i,toAddress:n}}function _(){return{type:e.TokenType.NATIVE,name:``,symbol:``,decimals:0}}exports.createRecurringNamespace=d;
+//# sourceMappingURL=_namespace.cjs.map

package/dist/transfer-service/markr/recurring/_namespace.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"_namespace.cjs","names":["markrRecurringQuote","markrListRecurringOrders","TransferSignatureReason","markrPrepareCancellation","markrPreparePause","markrPrepareUnpause","checkRecurringEligibility","InvalidParamsError","ErrorReason","caip2ToEip155ChainId","getEvmClientForChain","caip2ToEip155HexChainId","markrGetSpenderAddress","SdkError","ErrorCode","buildErc20ApprovalRequest","markrRecurringSwap","maybe1559","signApprovalAndAssertConfirmed","getMarkrSwapWrapperAbi","estimateGasWithRevert","applyFeeUnitsBpsMargin","erc20Abi","TokenType","ServiceType"],"sources":["../../../../src/transfer-service/markr/recurring/_namespace.ts"],"sourcesContent":["import { erc20Abi } from 'viem';\nimport { ServiceType, TokenType, TransferSignatureReason } from '../../../constants';\nimport { ErrorCode, ErrorReason, InvalidParamsError, SdkError } from '../../../errors';\nimport type { Chain } from '../../../types/chain';\nimport type { Quote } from '../../../types/quote';\nimport type { EvmSigner, EvmTransactionRequest } from '../../../types/signer';\nimport type { TransferStepDetails } from '../../../types/transfer';\nimport { caip2ToEip155ChainId, caip2ToEip155HexChainId } from '../../../utils/caip';\nimport { applyFeeUnitsBpsMargin, getEvmClientForChain, maybe1559 } from '../../_utils';\nimport { buildErc20ApprovalRequest, signApprovalAndAssertConfirmed } from '../../_evm-approval';\nimport { estimateGasWithRevert } from '../../_evm-errors';\nimport type { WrappedSwapTransactionResponse } from '../_schema';\nimport { markrGetSpenderAddress, type ApiOptions } from '../_api';\nimport { getMarkrSwapWrapperAbi } from '../_utils';\nimport {\n  markrListRecurringOrders,\n  markrPrepareCancellation,\n  markrPreparePause,\n  markrPrepareUnpause,\n  markrRecurringQuote,\n  markrRecurringSwap,\n} from './_api';\nimport { checkRecurringEligibility } from './_eligibility';\nimport type {\n  RecurringChainInfoMap,\n  RecurringExecuteFirstFillParams,\n  RecurringExecuteOrderActionParams,\n  RecurringExecuteResult,\n  RecurringNamespace,\n  RecurringQuoteResponse,\n} from './types';\n\nexport interface CreateRecurringNamespaceOptions {\n  apiOptions: ApiOptions;\n  appId: string;\n  evmSigner: EvmSigner;\n  /**\n   * The cached `/info/chains` recurring metadata. Captured by value at\n   * namespace construction time — matches how `partnerFeeBps`,\n   * `supportedChains`, and `supportedTokens` are also frozen at\n   * `createMarkrService` init. If staleness ever becomes a real consumer\n   * concern, the fix is a top-level `manager.refresh()` (not a per-namespace\n   * lazy-read pattern).\n   */\n  recurringChainInfo: RecurringChainInfoMap;\n}\n\nexport function createRecurringNamespace({\n  apiOptions,\n  appId,\n  evmSigner,\n  recurringChainInfo,\n}: CreateRecurringNamespaceOptions): RecurringNamespace {\n  return {\n    quote: (props) => markrRecurringQuote(apiOptions, { ...props, appId }),\n\n    executeFirstFill: (props) => executeFirstFillImpl({ ...props, apiOptions, appId, evmSigner }),\n\n    listOrders: (props) => markrListRecurringOrders(apiOptions, props),\n\n    executeCancellation: (props) =>\n      executeOrderActionImpl({\n        ...props,\n        signatureReason: TransferSignatureReason.CancelRecurringSwap,\n        apiOptions,\n        evmSigner,\n        fetchCalldata: markrPrepareCancellation,\n      }),\n\n    executePause: (props) =>\n      executeOrderActionImpl({\n        ...props,\n        signatureReason: TransferSignatureReason.PauseRecurringSwap,\n        apiOptions,\n        evmSigner,\n        fetchCalldata: markrPreparePause,\n      }),\n\n    executeUnpause: (props) =>\n      executeOrderActionImpl({\n        ...props,\n        signatureReason: TransferSignatureReason.ResumeRecurringSwap,\n        apiOptions,\n        evmSigner,\n        fetchCalldata: markrPrepareUnpause,\n      }),\n\n    checkEligibility: (props) => checkRecurringEligibility({ ...props, recurringChainInfo }),\n\n    getRecurringChainInfo: () => recurringChainInfo,\n  };\n}\n\n// ---------------------------------------------------------------------------\n// First-fill execution (allowance check + approve-if-needed + first-fill swap)\n// ---------------------------------------------------------------------------\n\ninterface ExecuteFirstFillImplParams extends RecurringExecuteFirstFillParams {\n  apiOptions: ApiOptions;\n  appId: string;\n  evmSigner: EvmSigner;\n}\n\nasync function executeFirstFillImpl({\n  apiOptions,\n  appId,\n  evmSigner,\n  fallbackToDefaultOnBatchFailure,\n  fromAddress,\n  gasSettings,\n  quote,\n  signerContext,\n  sourceChain,\n}: ExecuteFirstFillImplParams): Promise<RecurringExecuteResult> {\n  // Mirror the one-shot guard at `TransferManager.estimateNativeFee` — fail at\n  // the SDK boundary with `QUOTE_EXPIRED` instead of an opaque `HttpError`\n  // from `/recurring/swap` for a slow-to-approve user.\n  const now = Math.floor(Date.now() / 1_000);\n  if (quote.expiredAt <= now) {\n    const expiredSecondsAgo = now - quote.expiredAt;\n    throw new InvalidParamsError(\n      ErrorReason.QUOTE_EXPIRED,\n      `Recurring quote expired ${expiredSecondsAgo} seconds ago.`,\n    );\n  }\n\n  // Wiring-mistake guard: the passed `sourceChain.chainId` (CAIP-2) must agree\n  // with the `chainId` (numeric) the quote was issued against. Otherwise the\n  // allowance / gas reads hit the wrong chain.\n  const sourceChainIdNumeric = caip2ToEip155ChainId(sourceChain.chainId);\n  if (sourceChainIdNumeric !== quote.chainId) {\n    throw new InvalidParamsError(\n      'sourceChain does not match quote.chainId',\n      `sourceChain.chainId=${sourceChain.chainId} resolves to ${sourceChainIdNumeric}, but quote.chainId=${quote.chainId}.`,\n    );\n  }\n\n  const sourceClient = getEvmClientForChain({ chain: sourceChain });\n  const chainIdHex = caip2ToEip155HexChainId(sourceChain.chainId);\n\n  const { address: spenderAddress } = await markrGetSpenderAddress(apiOptions, {\n    chainId: quote.chainId,\n    crossChainSwap: false,\n    quoteId: quote.uuid,\n  });\n\n  if (!spenderAddress) {\n    throw new SdkError(ErrorReason.CHAIN_NOT_SUPPORTED, ErrorCode.INVALID_PARAMS, {\n      details: `Missing Markr spender address for source chain ${sourceChain.chainId}.`,\n    });\n  }\n\n  const approvalRequest = await buildErc20ApprovalRequest({\n    chainIdHex,\n    client: sourceClient,\n    gasSettings,\n    owner: fromAddress,\n    requiredAllowance: quote.totalAmountIn,\n    spender: spenderAddress,\n    token: quote.tokenIn,\n  });\n\n  const syntheticQuote = buildSyntheticQuoteForFirstFill({ fromAddress, quote, sourceChain });\n\n  const swap = await markrRecurringSwap(apiOptions, { uuid: quote.uuid, appId });\n\n  // One-click batch path: same-chain DCA, approval required, signer exposes\n  // `signBatch`. Matches `_executeEvmTransfer`'s eligibility check (recurring\n  // is always same-chain so the cross-chain check there collapses to true).\n  if (approvalRequest !== undefined && typeof evmSigner.signBatch === 'function') {\n    const batchStep: TransferStepDetails = {\n      currentSignature: 1,\n      currentSignatureReason: TransferSignatureReason.ScheduleRecurringSwap,\n      quote: syntheticQuote,\n      requiredSignatures: 1,\n      signerContext,\n    };\n\n    // Gas is left undefined on the swap leg — the wallet handles batched gas\n    // estimation since the approval hasn't executed yet.\n    const swapRequest: EvmTransactionRequest = {\n      chainId: chainIdHex,\n      data: swap.data,\n      from: fromAddress,\n      gas: undefined,\n      to: swap.to,\n      value: swap.value,\n      ...maybe1559(gasSettings),\n    };\n\n    try {\n      const txHashes = await evmSigner.signBatch(\n        [approvalRequest, swapRequest],\n        (signedTxHash) => sourceClient.sendRawTransaction({ serializedTransaction: signedTxHash }),\n        batchStep,\n      );\n      const swapTxHash = txHashes.at(-1);\n      if (!swapTxHash) {\n        throw new SdkError('One-click batch signing returned no transaction hashes.', ErrorCode.SIGNING_FAILED);\n      }\n      return { txHash: swapTxHash };\n    } catch (error) {\n      if (!fallbackToDefaultOnBatchFailure) {\n        throw error;\n      }\n      // Fall through to the two-signature path below.\n    }\n  }\n\n  if (approvalRequest) {\n    await signApprovalAndAssertConfirmed({\n      client: sourceClient,\n      evmSigner,\n      request: approvalRequest,\n      step: {\n        currentSignature: 1,\n        currentSignatureReason: TransferSignatureReason.AllowanceApproval,\n        quote: syntheticQuote,\n        requiredSignatures: 2,\n        signerContext,\n      },\n    });\n  }\n\n  // Use the Markr same-chain swap wrapper ABI for best-effort revert decoding\n  // — matches `_estimateGasFromSwapResponse` in `estimate-native-fee.ts`.\n  // Recurring is always same-chain, so `crossChain: false`. Built-in\n  // `Error(string)` / `Panic(uint256)` are decoded regardless of ABI.\n  const markrAbi = await getMarkrSwapWrapperAbi(false);\n  const swapGasEstimate = await estimateGasWithRevert(\n    sourceClient,\n    { account: fromAddress, to: swap.to, data: swap.data, value: swap.value },\n    markrAbi,\n    'Failed to estimate gas for recurring first-fill swap transaction.',\n  );\n\n  const swapRequest: EvmTransactionRequest = {\n    chainId: chainIdHex,\n    data: swap.data,\n    from: fromAddress,\n    gas: applyFeeUnitsBpsMargin(swapGasEstimate, gasSettings?.estimateGasMarginBps),\n    to: swap.to,\n    value: swap.value,\n    ...maybe1559(gasSettings),\n  };\n\n  const swapStep: TransferStepDetails = {\n    currentSignature: approvalRequest ? 2 : 1,\n    currentSignatureReason: TransferSignatureReason.ScheduleRecurringSwap,\n    quote: syntheticQuote,\n    requiredSignatures: approvalRequest ? 2 : 1,\n    signerContext,\n  };\n\n  const txHash = await evmSigner.sign(\n    swapRequest,\n    (signedTxHash) => sourceClient.sendRawTransaction({ serializedTransaction: signedTxHash }),\n    swapStep,\n  );\n\n  return { txHash };\n}\n\n// ---------------------------------------------------------------------------\n// Order-action execution (cancel / pause / unpause — single-tx state change)\n// ---------------------------------------------------------------------------\n\ninterface ExecuteOrderActionImplParams extends RecurringExecuteOrderActionParams {\n  signatureReason:\n    | TransferSignatureReason.PauseRecurringSwap\n    | TransferSignatureReason.ResumeRecurringSwap\n    | TransferSignatureReason.CancelRecurringSwap;\n  apiOptions: ApiOptions;\n  evmSigner: EvmSigner;\n  fetchCalldata: (\n    apiOptions: ApiOptions,\n    params: { orderId: `0x${string}`; address: `0x${string}`; chainId: number },\n  ) => Promise<WrappedSwapTransactionResponse>;\n}\n\n// Short verbs for error-message interpolation — avoids the doubled-\"recurring\"\n// + kebab-case-in-prose readout you'd get from interpolating the raw enum\n// wire value (e.g. `recurring pause-recurring-swap transaction`).\nconst ORDER_ACTION_LABEL: Record<ExecuteOrderActionImplParams['signatureReason'], string> = {\n  [TransferSignatureReason.PauseRecurringSwap]: 'pause',\n  [TransferSignatureReason.ResumeRecurringSwap]: 'resume',\n  [TransferSignatureReason.CancelRecurringSwap]: 'cancel',\n};\n\nasync function executeOrderActionImpl({\n  signatureReason,\n  address,\n  apiOptions,\n  evmSigner,\n  fetchCalldata,\n  gasSettings,\n  orderId,\n  signerContext,\n  sourceChain,\n}: ExecuteOrderActionImplParams): Promise<RecurringExecuteResult> {\n  const sourceClient = getEvmClientForChain({ chain: sourceChain });\n  const chainIdNumeric = caip2ToEip155ChainId(sourceChain.chainId);\n  const chainIdHex = caip2ToEip155HexChainId(sourceChain.chainId);\n\n  const calldata = await fetchCalldata(apiOptions, { orderId, address, chainId: chainIdNumeric });\n\n  const gasEstimate = await estimateGasWithRevert(\n    sourceClient,\n    { account: address, to: calldata.to, data: calldata.data, value: calldata.value },\n    erc20Abi,\n    `Failed to estimate gas for recurring ${ORDER_ACTION_LABEL[signatureReason]} transaction.`,\n  );\n\n  const request: EvmTransactionRequest = {\n    chainId: chainIdHex,\n    data: calldata.data,\n    from: address,\n    gas: applyFeeUnitsBpsMargin(gasEstimate, gasSettings?.estimateGasMarginBps),\n    to: calldata.to,\n    value: calldata.value,\n    ...maybe1559(gasSettings),\n  };\n\n  const step: TransferStepDetails = {\n    currentSignature: 1,\n    currentSignatureReason: signatureReason,\n    quote: buildSyntheticQuoteForOrderAction({ address, signatureReason, orderId, sourceChain }),\n    requiredSignatures: 1,\n    signerContext,\n  };\n\n  const txHash = await evmSigner.sign(\n    request,\n    (signedTxHash) => sourceClient.sendRawTransaction({ serializedTransaction: signedTxHash }),\n    step,\n  );\n\n  return { txHash };\n}\n\n// ---------------------------------------------------------------------------\n// Internal: synthetic Quote objects for `TransferStepDetails.quote`\n// ---------------------------------------------------------------------------\n\n/**\n * Builds a minimum-viable {@link Quote} for the signer step so consumer\n * `EvmSigner` impls can render meaningful wallet prompts for a recurring\n * action (which has no real `Quote` in the swap-quoter sense). The synthetic\n * value carries enough recurring context (uuid, chain, amounts, tokens) for\n * a wallet UI to label the popup; the `aggregator.id` (`'markr-recurring'`)\n * lets advanced signers detect the recurring path explicitly.\n *\n * Asset fields use placeholder `name`/`symbol`/`decimals` because the\n * recurring quote doesn't echo those — consumers needing rich asset display\n * should resolve token metadata against their own asset map keyed by\n * `quote.tokenIn`/`tokenOut`.\n */\nfunction buildSyntheticQuoteForFirstFill({\n  fromAddress,\n  quote,\n  sourceChain,\n}: {\n  fromAddress: `0x${string}`;\n  quote: RecurringQuoteResponse;\n  sourceChain: Chain;\n}): Quote {\n  return {\n    // Keep the stable `'markr-recurring'` marker (shipped in #240) — consumer\n    // signers may detect the recurring path via `quote.aggregator.id`. The\n    // typed `TransferStepDetails.currentSignatureReason` is now the preferred\n    // discriminant for new integrations, but this id stays for back-compat.\n    aggregator: { id: 'markr-recurring', name: 'Markr recurring' },\n    amountIn: quote.amount,\n    amountOut: quote.amountOut,\n    assetIn: { type: TokenType.ERC20, address: quote.tokenIn, name: '', symbol: '', decimals: 0 },\n    assetOut: { type: TokenType.ERC20, address: quote.tokenOut, name: '', symbol: '', decimals: 0 },\n    expiresAt: quote.expiredAt,\n    fees: [],\n    fromAddress,\n    id: quote.uuid,\n    partnerFeeBps: null,\n    serviceType: ServiceType.MARKR,\n    slippageBps: quote.recommendedSlippage,\n    // Pass the caller-provided `Chain` straight through — recurring is always\n    // same-chain, so source === target. Avoids stripping `chainName` /\n    // `networkToken` / `rpcUrl` that consumer signers may use for display.\n    sourceChain,\n    targetChain: sourceChain,\n    toAddress: fromAddress,\n  };\n}\n\nfunction buildSyntheticQuoteForOrderAction({\n  signatureReason,\n  address,\n  orderId,\n  sourceChain,\n}: {\n  signatureReason:\n    | TransferSignatureReason.PauseRecurringSwap\n    | TransferSignatureReason.ResumeRecurringSwap\n    | TransferSignatureReason.CancelRecurringSwap;\n  address: `0x${string}`;\n  orderId: `0x${string}`;\n  sourceChain: Chain;\n}): Quote {\n  const action = ORDER_ACTION_LABEL[signatureReason];\n  return {\n    // Same back-compat rationale as `buildSyntheticQuoteForFirstFill` — preserve\n    // the original lowercase `markr-recurring-${action}` id shape (shipped in\n    // #240) so consumers keying off `quote.aggregator.id` keep working.\n    aggregator: {\n      id: `markr-recurring-${action}`,\n      name: `Markr recurring (${action})`,\n    },\n    amountIn: 0n,\n    amountOut: 0n,\n    assetIn: emptyNativeAsset(),\n    assetOut: emptyNativeAsset(),\n    expiresAt: 0,\n    fees: [],\n    fromAddress: address,\n    id: orderId,\n    partnerFeeBps: null,\n    serviceType: ServiceType.MARKR,\n    slippageBps: 0,\n    // See `buildSyntheticQuoteForFirstFill` — pass the real `Chain` through.\n    sourceChain,\n    targetChain: sourceChain,\n    toAddress: address,\n  };\n}\n\nfunction emptyNativeAsset() {\n  return { type: TokenType.NATIVE, name: '', symbol: '', decimals: 0 } as const;\n}\n"],"mappings":"2YA+CA,SAAgB,EAAyB,CACvC,aACA,QACA,YACA,sBACsD,CACtD,MAAO,CACL,MAAQ,GAAUA,EAAAA,oBAAoB,EAAY,CAAE,GAAG,EAAO,QAAO,CAAC,CAEtE,iBAAmB,GAAU,EAAqB,CAAE,GAAG,EAAO,aAAY,QAAO,YAAW,CAAC,CAE7F,WAAa,GAAUC,EAAAA,yBAAyB,EAAY,EAAM,CAElE,oBAAsB,GACpB,EAAuB,CACrB,GAAG,EACH,gBAAiBC,EAAAA,wBAAwB,oBACzC,aACA,YACA,cAAeC,EAAAA,yBAChB,CAAC,CAEJ,aAAe,GACb,EAAuB,CACrB,GAAG,EACH,gBAAiBD,EAAAA,wBAAwB,mBACzC,aACA,YACA,cAAeE,EAAAA,kBAChB,CAAC,CAEJ,eAAiB,GACf,EAAuB,CACrB,GAAG,EACH,gBAAiBF,EAAAA,wBAAwB,oBACzC,aACA,YACA,cAAeG,EAAAA,oBAChB,CAAC,CAEJ,iBAAmB,GAAUC,EAAAA,0BAA0B,CAAE,GAAG,EAAO,qBAAoB,CAAC,CAExF,0BAA6B,EAC9B,CAaH,eAAe,EAAqB,CAClC,aACA,QACA,YACA,kCACA,cACA,cACA,QACA,gBACA,eAC8D,CAI9D,IAAM,EAAM,KAAK,MAAM,KAAK,KAAK,CAAG,IAAM,CAC1C,GAAI,EAAM,WAAa,EAAK,CAC1B,IAAM,EAAoB,EAAM,EAAM,UACtC,MAAM,IAAIC,EAAAA,mBACRC,EAAAA,YAAY,cACZ,2BAA2B,EAAkB,eAC9C,CAMH,IAAM,EAAuBC,EAAAA,qBAAqB,EAAY,QAAQ,CACtE,GAAI,IAAyB,EAAM,QACjC,MAAM,IAAIF,EAAAA,mBACR,2CACA,uBAAuB,EAAY,QAAQ,eAAe,EAAqB,sBAAsB,EAAM,QAAQ,GACpH,CAGH,IAAM,EAAeG,EAAAA,qBAAqB,CAAE,MAAO,EAAa,CAAC,CAC3D,EAAaC,EAAAA,wBAAwB,EAAY,QAAQ,CAEzD,CAAE,QAAS,GAAmB,MAAMC,EAAAA,uBAAuB,EAAY,CAC3E,QAAS,EAAM,QACf,eAAgB,GAChB,QAAS,EAAM,KAChB,CAAC,CAEF,GAAI,CAAC,EACH,MAAM,IAAIC,EAAAA,SAASL,EAAAA,YAAY,oBAAqBM,EAAAA,UAAU,eAAgB,CAC5E,QAAS,kDAAkD,EAAY,QAAQ,GAChF,CAAC,CAGJ,IAAM,EAAkB,MAAMC,EAAAA,0BAA0B,CACtD,aACA,OAAQ,EACR,cACA,MAAO,EACP,kBAAmB,EAAM,cACzB,QAAS,EACT,MAAO,EAAM,QACd,CAAC,CAEI,EAAiB,EAAgC,CAAE,cAAa,QAAO,cAAa,CAAC,CAErF,EAAO,MAAMC,EAAAA,mBAAmB,EAAY,CAAE,KAAM,EAAM,KAAM,QAAO,CAAC,CAK9E,GAAI,IAAoB,IAAA,IAAa,OAAO,EAAU,WAAc,WAAY,CAC9E,IAAM,EAAiC,CACrC,iBAAkB,EAClB,uBAAwBd,EAAAA,wBAAwB,sBAChD,MAAO,EACP,mBAAoB,EACpB,gBACD,CAIK,EAAqC,CACzC,QAAS,EACT,KAAM,EAAK,KACX,KAAM,EACN,IAAK,IAAA,GACL,GAAI,EAAK,GACT,MAAO,EAAK,MACZ,GAAGe,EAAAA,UAAU,EAAY,CAC1B,CAED,GAAI,CAMF,IAAM,GALW,MAAM,EAAU,UAC/B,CAAC,EAAiB,EAAY,CAC7B,GAAiB,EAAa,mBAAmB,CAAE,sBAAuB,EAAc,CAAC,CAC1F,EACD,EAC2B,GAAG,GAAG,CAClC,GAAI,CAAC,EACH,MAAM,IAAIJ,EAAAA,SAAS,0DAA2DC,EAAAA,UAAU,eAAe,CAEzG,MAAO,CAAE,OAAQ,EAAY,OACtB,EAAO,CACd,GAAI,CAAC,EACH,MAAM,GAMR,GACF,MAAMI,EAAAA,+BAA+B,CACnC,OAAQ,EACR,YACA,QAAS,EACT,KAAM,CACJ,iBAAkB,EAClB,uBAAwBhB,EAAAA,wBAAwB,kBAChD,MAAO,EACP,mBAAoB,EACpB,gBACD,CACF,CAAC,CAOJ,IAAM,EAAW,MAAMiB,EAAAA,uBAAuB,GAAM,CAC9C,EAAkB,MAAMC,EAAAA,sBAC5B,EACA,CAAE,QAAS,EAAa,GAAI,EAAK,GAAI,KAAM,EAAK,KAAM,MAAO,EAAK,MAAO,CACzE,EACA,oEACD,CAEK,EAAqC,CACzC,QAAS,EACT,KAAM,EAAK,KACX,KAAM,EACN,IAAKC,EAAAA,uBAAuB,EAAiB,GAAa,qBAAqB,CAC/E,GAAI,EAAK,GACT,MAAO,EAAK,MACZ,GAAGJ,EAAAA,UAAU,EAAY,CAC1B,CAEK,EAAgC,CACpC,iBAAkB,EAAkB,EAAI,EACxC,uBAAwBf,EAAAA,wBAAwB,sBAChD,MAAO,EACP,mBAAoB,EAAkB,EAAI,EAC1C,gBACD,CAQD,MAAO,CAAE,OANM,MAAM,EAAU,KAC7B,EACC,GAAiB,EAAa,mBAAmB,CAAE,sBAAuB,EAAc,CAAC,CAC1F,EACD,CAEgB,CAuBnB,MAAM,EAAsF,EACzFA,EAAAA,wBAAwB,oBAAqB,SAC7CA,EAAAA,wBAAwB,qBAAsB,UAC9CA,EAAAA,wBAAwB,qBAAsB,SAChD,CAED,eAAe,EAAuB,CACpC,kBACA,UACA,aACA,YACA,gBACA,cACA,UACA,gBACA,eACgE,CAChE,IAAM,EAAeQ,EAAAA,qBAAqB,CAAE,MAAO,EAAa,CAAC,CAC3D,EAAiBD,EAAAA,qBAAqB,EAAY,QAAQ,CAC1D,EAAaE,EAAAA,wBAAwB,EAAY,QAAQ,CAEzD,EAAW,MAAM,EAAc,EAAY,CAAE,UAAS,UAAS,QAAS,EAAgB,CAAC,CAEzF,EAAc,MAAMS,EAAAA,sBACxB,EACA,CAAE,QAAS,EAAS,GAAI,EAAS,GAAI,KAAM,EAAS,KAAM,MAAO,EAAS,MAAO,CACjFE,EAAAA,SACA,wCAAwC,EAAmB,GAAiB,eAC7E,CAEK,EAAiC,CACrC,QAAS,EACT,KAAM,EAAS,KACf,KAAM,EACN,IAAKD,EAAAA,uBAAuB,EAAa,GAAa,qBAAqB,CAC3E,GAAI,EAAS,GACb,MAAO,EAAS,MAChB,GAAGJ,EAAAA,UAAU,EAAY,CAC1B,CAEK,EAA4B,CAChC,iBAAkB,EAClB,uBAAwB,EACxB,MAAO,EAAkC,CAAE,UAAS,kBAAiB,UAAS,cAAa,CAAC,CAC5F,mBAAoB,EACpB,gBACD,CAQD,MAAO,CAAE,OANM,MAAM,EAAU,KAC7B,EACC,GAAiB,EAAa,mBAAmB,CAAE,sBAAuB,EAAc,CAAC,CAC1F,EACD,CAEgB,CAoBnB,SAAS,EAAgC,CACvC,cACA,QACA,eAKQ,CACR,MAAO,CAKL,WAAY,CAAE,GAAI,kBAAmB,KAAM,kBAAmB,CAC9D,SAAU,EAAM,OAChB,UAAW,EAAM,UACjB,QAAS,CAAE,KAAMM,EAAAA,UAAU,MAAO,QAAS,EAAM,QAAS,KAAM,GAAI,OAAQ,GAAI,SAAU,EAAG,CAC7F,SAAU,CAAE,KAAMA,EAAAA,UAAU,MAAO,QAAS,EAAM,SAAU,KAAM,GAAI,OAAQ,GAAI,SAAU,EAAG,CAC/F,UAAW,EAAM,UACjB,KAAM,EAAE,CACR,cACA,GAAI,EAAM,KACV,cAAe,KACf,YAAaC,EAAAA,YAAY,MACzB,YAAa,EAAM,oBAInB,cACA,YAAa,EACb,UAAW,EACZ,CAGH,SAAS,EAAkC,CACzC,kBACA,UACA,UACA,eASQ,CACR,IAAM,EAAS,EAAmB,GAClC,MAAO,CAIL,WAAY,CACV,GAAI,mBAAmB,IACvB,KAAM,oBAAoB,EAAO,GAClC,CACD,SAAU,GACV,UAAW,GACX,QAAS,GAAkB,CAC3B,SAAU,GAAkB,CAC5B,UAAW,EACX,KAAM,EAAE,CACR,YAAa,EACb,GAAI,EACJ,cAAe,KACf,YAAaA,EAAAA,YAAY,MACzB,YAAa,EAEb,cACA,YAAa,EACb,UAAW,EACZ,CAGH,SAAS,GAAmB,CAC1B,MAAO,CAAE,KAAMD,EAAAA,UAAU,OAAQ,KAAM,GAAI,OAAQ,GAAI,SAAU,EAAG"}

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

@@ -0,0 +1,2 @@
+import{ServiceType as e,TokenType as t,TransferSignatureReason as n}from"../../../constants.js";import{ErrorCode as r,ErrorReason as i,InvalidParamsError as a,SdkError as o}from"../../../errors.js";import{caip2ToEip155ChainId as s,caip2ToEip155HexChainId as c}from"../../../utils/caip.js";import{applyFeeUnitsBpsMargin as l,getEvmClientForChain as u,maybe1559 as d}from"../../_utils.js";import{estimateGasWithRevert as f}from"../../_evm-errors.js";import{buildErc20ApprovalRequest as p,signApprovalAndAssertConfirmed as m}from"../../_evm-approval.js";import{markrGetSpenderAddress as h}from"../_api.js";import{getMarkrSwapWrapperAbi as g}from"../_utils.js";import{markrListRecurringOrders as _,markrPrepareCancellation as v,markrPreparePause as y,markrPrepareUnpause as b,markrRecurringQuote as x,markrRecurringSwap as S}from"./_api.js";import{checkRecurringEligibility as C}from"./_eligibility.js";import{erc20Abi as w}from"viem";function T({apiOptions:e,appId:t,evmSigner:r,recurringChainInfo:i}){return{quote:n=>x(e,{...n,appId:t}),executeFirstFill:n=>E({...n,apiOptions:e,appId:t,evmSigner:r}),listOrders:t=>_(e,t),executeCancellation:t=>O({...t,signatureReason:n.CancelRecurringSwap,apiOptions:e,evmSigner:r,fetchCalldata:v}),executePause:t=>O({...t,signatureReason:n.PauseRecurringSwap,apiOptions:e,evmSigner:r,fetchCalldata:y}),executeUnpause:t=>O({...t,signatureReason:n.ResumeRecurringSwap,apiOptions:e,evmSigner:r,fetchCalldata:b}),checkEligibility:e=>C({...e,recurringChainInfo:i}),getRecurringChainInfo:()=>i}}async function E({apiOptions:e,appId:t,evmSigner:_,fallbackToDefaultOnBatchFailure:v,fromAddress:y,gasSettings:b,quote:x,signerContext:C,sourceChain:w}){let T=Math.floor(Date.now()/1e3);if(x.expiredAt<=T){let e=T-x.expiredAt;throw new a(i.QUOTE_EXPIRED,`Recurring quote expired ${e} seconds ago.`)}let E=s(w.chainId);if(E!==x.chainId)throw new a(`sourceChain does not match quote.chainId`,`sourceChain.chainId=${w.chainId} resolves to ${E}, but quote.chainId=${x.chainId}.`);let D=u({chain:w}),O=c(w.chainId),{address:A}=await h(e,{chainId:x.chainId,crossChainSwap:!1,quoteId:x.uuid});if(!A)throw new o(i.CHAIN_NOT_SUPPORTED,r.INVALID_PARAMS,{details:`Missing Markr spender address for source chain ${w.chainId}.`});let j=await p({chainIdHex:O,client:D,gasSettings:b,owner:y,requiredAllowance:x.totalAmountIn,spender:A,token:x.tokenIn}),M=k({fromAddress:y,quote:x,sourceChain:w}),N=await S(e,{uuid:x.uuid,appId:t});if(j!==void 0&&typeof _.signBatch==`function`){let e={currentSignature:1,currentSignatureReason:n.ScheduleRecurringSwap,quote:M,requiredSignatures:1,signerContext:C},t={chainId:O,data:N.data,from:y,gas:void 0,to:N.to,value:N.value,...d(b)};try{let n=(await _.signBatch([j,t],e=>D.sendRawTransaction({serializedTransaction:e}),e)).at(-1);if(!n)throw new o(`One-click batch signing returned no transaction hashes.`,r.SIGNING_FAILED);return{txHash:n}}catch(e){if(!v)throw e}}j&&await m({client:D,evmSigner:_,request:j,step:{currentSignature:1,currentSignatureReason:n.AllowanceApproval,quote:M,requiredSignatures:2,signerContext:C}});let P=await g(!1),F=await f(D,{account:y,to:N.to,data:N.data,value:N.value},P,`Failed to estimate gas for recurring first-fill swap transaction.`),I={chainId:O,data:N.data,from:y,gas:l(F,b?.estimateGasMarginBps),to:N.to,value:N.value,...d(b)},L={currentSignature:j?2:1,currentSignatureReason:n.ScheduleRecurringSwap,quote:M,requiredSignatures:j?2:1,signerContext:C};return{txHash:await _.sign(I,e=>D.sendRawTransaction({serializedTransaction:e}),L)}}const D={[n.PauseRecurringSwap]:`pause`,[n.ResumeRecurringSwap]:`resume`,[n.CancelRecurringSwap]:`cancel`};async function O({signatureReason:e,address:t,apiOptions:n,evmSigner:r,fetchCalldata:i,gasSettings:a,orderId:o,signerContext:p,sourceChain:m}){let h=u({chain:m}),g=s(m.chainId),_=c(m.chainId),v=await i(n,{orderId:o,address:t,chainId:g}),y=await f(h,{account:t,to:v.to,data:v.data,value:v.value},w,`Failed to estimate gas for recurring ${D[e]} transaction.`),b={chainId:_,data:v.data,from:t,gas:l(y,a?.estimateGasMarginBps),to:v.to,value:v.value,...d(a)},x={currentSignature:1,currentSignatureReason:e,quote:A({address:t,signatureReason:e,orderId:o,sourceChain:m}),requiredSignatures:1,signerContext:p};return{txHash:await r.sign(b,e=>h.sendRawTransaction({serializedTransaction:e}),x)}}function k({fromAddress:n,quote:r,sourceChain:i}){return{aggregator:{id:`markr-recurring`,name:`Markr recurring`},amountIn:r.amount,amountOut:r.amountOut,assetIn:{type:t.ERC20,address:r.tokenIn,name:``,symbol:``,decimals:0},assetOut:{type:t.ERC20,address:r.tokenOut,name:``,symbol:``,decimals:0},expiresAt:r.expiredAt,fees:[],fromAddress:n,id:r.uuid,partnerFeeBps:null,serviceType:e.MARKR,slippageBps:r.recommendedSlippage,sourceChain:i,targetChain:i,toAddress:n}}function A({signatureReason:t,address:n,orderId:r,sourceChain:i}){let a=D[t];return{aggregator:{id:`markr-recurring-${a}`,name:`Markr recurring (${a})`},amountIn:0n,amountOut:0n,assetIn:j(),assetOut:j(),expiresAt:0,fees:[],fromAddress:n,id:r,partnerFeeBps:null,serviceType:e.MARKR,slippageBps:0,sourceChain:i,targetChain:i,toAddress:n}}function j(){return{type:t.NATIVE,name:``,symbol:``,decimals:0}}export{T as createRecurringNamespace};
+//# sourceMappingURL=_namespace.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_namespace.js","names":[],"sources":["../../../../src/transfer-service/markr/recurring/_namespace.ts"],"sourcesContent":["import { erc20Abi } from 'viem';\nimport { ServiceType, TokenType, TransferSignatureReason } from '../../../constants';\nimport { ErrorCode, ErrorReason, InvalidParamsError, SdkError } from '../../../errors';\nimport type { Chain } from '../../../types/chain';\nimport type { Quote } from '../../../types/quote';\nimport type { EvmSigner, EvmTransactionRequest } from '../../../types/signer';\nimport type { TransferStepDetails } from '../../../types/transfer';\nimport { caip2ToEip155ChainId, caip2ToEip155HexChainId } from '../../../utils/caip';\nimport { applyFeeUnitsBpsMargin, getEvmClientForChain, maybe1559 } from '../../_utils';\nimport { buildErc20ApprovalRequest, signApprovalAndAssertConfirmed } from '../../_evm-approval';\nimport { estimateGasWithRevert } from '../../_evm-errors';\nimport type { WrappedSwapTransactionResponse } from '../_schema';\nimport { markrGetSpenderAddress, type ApiOptions } from '../_api';\nimport { getMarkrSwapWrapperAbi } from '../_utils';\nimport {\n  markrListRecurringOrders,\n  markrPrepareCancellation,\n  markrPreparePause,\n  markrPrepareUnpause,\n  markrRecurringQuote,\n  markrRecurringSwap,\n} from './_api';\nimport { checkRecurringEligibility } from './_eligibility';\nimport type {\n  RecurringChainInfoMap,\n  RecurringExecuteFirstFillParams,\n  RecurringExecuteOrderActionParams,\n  RecurringExecuteResult,\n  RecurringNamespace,\n  RecurringQuoteResponse,\n} from './types';\n\nexport interface CreateRecurringNamespaceOptions {\n  apiOptions: ApiOptions;\n  appId: string;\n  evmSigner: EvmSigner;\n  /**\n   * The cached `/info/chains` recurring metadata. Captured by value at\n   * namespace construction time — matches how `partnerFeeBps`,\n   * `supportedChains`, and `supportedTokens` are also frozen at\n   * `createMarkrService` init. If staleness ever becomes a real consumer\n   * concern, the fix is a top-level `manager.refresh()` (not a per-namespace\n   * lazy-read pattern).\n   */\n  recurringChainInfo: RecurringChainInfoMap;\n}\n\nexport function createRecurringNamespace({\n  apiOptions,\n  appId,\n  evmSigner,\n  recurringChainInfo,\n}: CreateRecurringNamespaceOptions): RecurringNamespace {\n  return {\n    quote: (props) => markrRecurringQuote(apiOptions, { ...props, appId }),\n\n    executeFirstFill: (props) => executeFirstFillImpl({ ...props, apiOptions, appId, evmSigner }),\n\n    listOrders: (props) => markrListRecurringOrders(apiOptions, props),\n\n    executeCancellation: (props) =>\n      executeOrderActionImpl({\n        ...props,\n        signatureReason: TransferSignatureReason.CancelRecurringSwap,\n        apiOptions,\n        evmSigner,\n        fetchCalldata: markrPrepareCancellation,\n      }),\n\n    executePause: (props) =>\n      executeOrderActionImpl({\n        ...props,\n        signatureReason: TransferSignatureReason.PauseRecurringSwap,\n        apiOptions,\n        evmSigner,\n        fetchCalldata: markrPreparePause,\n      }),\n\n    executeUnpause: (props) =>\n      executeOrderActionImpl({\n        ...props,\n        signatureReason: TransferSignatureReason.ResumeRecurringSwap,\n        apiOptions,\n        evmSigner,\n        fetchCalldata: markrPrepareUnpause,\n      }),\n\n    checkEligibility: (props) => checkRecurringEligibility({ ...props, recurringChainInfo }),\n\n    getRecurringChainInfo: () => recurringChainInfo,\n  };\n}\n\n// ---------------------------------------------------------------------------\n// First-fill execution (allowance check + approve-if-needed + first-fill swap)\n// ---------------------------------------------------------------------------\n\ninterface ExecuteFirstFillImplParams extends RecurringExecuteFirstFillParams {\n  apiOptions: ApiOptions;\n  appId: string;\n  evmSigner: EvmSigner;\n}\n\nasync function executeFirstFillImpl({\n  apiOptions,\n  appId,\n  evmSigner,\n  fallbackToDefaultOnBatchFailure,\n  fromAddress,\n  gasSettings,\n  quote,\n  signerContext,\n  sourceChain,\n}: ExecuteFirstFillImplParams): Promise<RecurringExecuteResult> {\n  // Mirror the one-shot guard at `TransferManager.estimateNativeFee` — fail at\n  // the SDK boundary with `QUOTE_EXPIRED` instead of an opaque `HttpError`\n  // from `/recurring/swap` for a slow-to-approve user.\n  const now = Math.floor(Date.now() / 1_000);\n  if (quote.expiredAt <= now) {\n    const expiredSecondsAgo = now - quote.expiredAt;\n    throw new InvalidParamsError(\n      ErrorReason.QUOTE_EXPIRED,\n      `Recurring quote expired ${expiredSecondsAgo} seconds ago.`,\n    );\n  }\n\n  // Wiring-mistake guard: the passed `sourceChain.chainId` (CAIP-2) must agree\n  // with the `chainId` (numeric) the quote was issued against. Otherwise the\n  // allowance / gas reads hit the wrong chain.\n  const sourceChainIdNumeric = caip2ToEip155ChainId(sourceChain.chainId);\n  if (sourceChainIdNumeric !== quote.chainId) {\n    throw new InvalidParamsError(\n      'sourceChain does not match quote.chainId',\n      `sourceChain.chainId=${sourceChain.chainId} resolves to ${sourceChainIdNumeric}, but quote.chainId=${quote.chainId}.`,\n    );\n  }\n\n  const sourceClient = getEvmClientForChain({ chain: sourceChain });\n  const chainIdHex = caip2ToEip155HexChainId(sourceChain.chainId);\n\n  const { address: spenderAddress } = await markrGetSpenderAddress(apiOptions, {\n    chainId: quote.chainId,\n    crossChainSwap: false,\n    quoteId: quote.uuid,\n  });\n\n  if (!spenderAddress) {\n    throw new SdkError(ErrorReason.CHAIN_NOT_SUPPORTED, ErrorCode.INVALID_PARAMS, {\n      details: `Missing Markr spender address for source chain ${sourceChain.chainId}.`,\n    });\n  }\n\n  const approvalRequest = await buildErc20ApprovalRequest({\n    chainIdHex,\n    client: sourceClient,\n    gasSettings,\n    owner: fromAddress,\n    requiredAllowance: quote.totalAmountIn,\n    spender: spenderAddress,\n    token: quote.tokenIn,\n  });\n\n  const syntheticQuote = buildSyntheticQuoteForFirstFill({ fromAddress, quote, sourceChain });\n\n  const swap = await markrRecurringSwap(apiOptions, { uuid: quote.uuid, appId });\n\n  // One-click batch path: same-chain DCA, approval required, signer exposes\n  // `signBatch`. Matches `_executeEvmTransfer`'s eligibility check (recurring\n  // is always same-chain so the cross-chain check there collapses to true).\n  if (approvalRequest !== undefined && typeof evmSigner.signBatch === 'function') {\n    const batchStep: TransferStepDetails = {\n      currentSignature: 1,\n      currentSignatureReason: TransferSignatureReason.ScheduleRecurringSwap,\n      quote: syntheticQuote,\n      requiredSignatures: 1,\n      signerContext,\n    };\n\n    // Gas is left undefined on the swap leg — the wallet handles batched gas\n    // estimation since the approval hasn't executed yet.\n    const swapRequest: EvmTransactionRequest = {\n      chainId: chainIdHex,\n      data: swap.data,\n      from: fromAddress,\n      gas: undefined,\n      to: swap.to,\n      value: swap.value,\n      ...maybe1559(gasSettings),\n    };\n\n    try {\n      const txHashes = await evmSigner.signBatch(\n        [approvalRequest, swapRequest],\n        (signedTxHash) => sourceClient.sendRawTransaction({ serializedTransaction: signedTxHash }),\n        batchStep,\n      );\n      const swapTxHash = txHashes.at(-1);\n      if (!swapTxHash) {\n        throw new SdkError('One-click batch signing returned no transaction hashes.', ErrorCode.SIGNING_FAILED);\n      }\n      return { txHash: swapTxHash };\n    } catch (error) {\n      if (!fallbackToDefaultOnBatchFailure) {\n        throw error;\n      }\n      // Fall through to the two-signature path below.\n    }\n  }\n\n  if (approvalRequest) {\n    await signApprovalAndAssertConfirmed({\n      client: sourceClient,\n      evmSigner,\n      request: approvalRequest,\n      step: {\n        currentSignature: 1,\n        currentSignatureReason: TransferSignatureReason.AllowanceApproval,\n        quote: syntheticQuote,\n        requiredSignatures: 2,\n        signerContext,\n      },\n    });\n  }\n\n  // Use the Markr same-chain swap wrapper ABI for best-effort revert decoding\n  // — matches `_estimateGasFromSwapResponse` in `estimate-native-fee.ts`.\n  // Recurring is always same-chain, so `crossChain: false`. Built-in\n  // `Error(string)` / `Panic(uint256)` are decoded regardless of ABI.\n  const markrAbi = await getMarkrSwapWrapperAbi(false);\n  const swapGasEstimate = await estimateGasWithRevert(\n    sourceClient,\n    { account: fromAddress, to: swap.to, data: swap.data, value: swap.value },\n    markrAbi,\n    'Failed to estimate gas for recurring first-fill swap transaction.',\n  );\n\n  const swapRequest: EvmTransactionRequest = {\n    chainId: chainIdHex,\n    data: swap.data,\n    from: fromAddress,\n    gas: applyFeeUnitsBpsMargin(swapGasEstimate, gasSettings?.estimateGasMarginBps),\n    to: swap.to,\n    value: swap.value,\n    ...maybe1559(gasSettings),\n  };\n\n  const swapStep: TransferStepDetails = {\n    currentSignature: approvalRequest ? 2 : 1,\n    currentSignatureReason: TransferSignatureReason.ScheduleRecurringSwap,\n    quote: syntheticQuote,\n    requiredSignatures: approvalRequest ? 2 : 1,\n    signerContext,\n  };\n\n  const txHash = await evmSigner.sign(\n    swapRequest,\n    (signedTxHash) => sourceClient.sendRawTransaction({ serializedTransaction: signedTxHash }),\n    swapStep,\n  );\n\n  return { txHash };\n}\n\n// ---------------------------------------------------------------------------\n// Order-action execution (cancel / pause / unpause — single-tx state change)\n// ---------------------------------------------------------------------------\n\ninterface ExecuteOrderActionImplParams extends RecurringExecuteOrderActionParams {\n  signatureReason:\n    | TransferSignatureReason.PauseRecurringSwap\n    | TransferSignatureReason.ResumeRecurringSwap\n    | TransferSignatureReason.CancelRecurringSwap;\n  apiOptions: ApiOptions;\n  evmSigner: EvmSigner;\n  fetchCalldata: (\n    apiOptions: ApiOptions,\n    params: { orderId: `0x${string}`; address: `0x${string}`; chainId: number },\n  ) => Promise<WrappedSwapTransactionResponse>;\n}\n\n// Short verbs for error-message interpolation — avoids the doubled-\"recurring\"\n// + kebab-case-in-prose readout you'd get from interpolating the raw enum\n// wire value (e.g. `recurring pause-recurring-swap transaction`).\nconst ORDER_ACTION_LABEL: Record<ExecuteOrderActionImplParams['signatureReason'], string> = {\n  [TransferSignatureReason.PauseRecurringSwap]: 'pause',\n  [TransferSignatureReason.ResumeRecurringSwap]: 'resume',\n  [TransferSignatureReason.CancelRecurringSwap]: 'cancel',\n};\n\nasync function executeOrderActionImpl({\n  signatureReason,\n  address,\n  apiOptions,\n  evmSigner,\n  fetchCalldata,\n  gasSettings,\n  orderId,\n  signerContext,\n  sourceChain,\n}: ExecuteOrderActionImplParams): Promise<RecurringExecuteResult> {\n  const sourceClient = getEvmClientForChain({ chain: sourceChain });\n  const chainIdNumeric = caip2ToEip155ChainId(sourceChain.chainId);\n  const chainIdHex = caip2ToEip155HexChainId(sourceChain.chainId);\n\n  const calldata = await fetchCalldata(apiOptions, { orderId, address, chainId: chainIdNumeric });\n\n  const gasEstimate = await estimateGasWithRevert(\n    sourceClient,\n    { account: address, to: calldata.to, data: calldata.data, value: calldata.value },\n    erc20Abi,\n    `Failed to estimate gas for recurring ${ORDER_ACTION_LABEL[signatureReason]} transaction.`,\n  );\n\n  const request: EvmTransactionRequest = {\n    chainId: chainIdHex,\n    data: calldata.data,\n    from: address,\n    gas: applyFeeUnitsBpsMargin(gasEstimate, gasSettings?.estimateGasMarginBps),\n    to: calldata.to,\n    value: calldata.value,\n    ...maybe1559(gasSettings),\n  };\n\n  const step: TransferStepDetails = {\n    currentSignature: 1,\n    currentSignatureReason: signatureReason,\n    quote: buildSyntheticQuoteForOrderAction({ address, signatureReason, orderId, sourceChain }),\n    requiredSignatures: 1,\n    signerContext,\n  };\n\n  const txHash = await evmSigner.sign(\n    request,\n    (signedTxHash) => sourceClient.sendRawTransaction({ serializedTransaction: signedTxHash }),\n    step,\n  );\n\n  return { txHash };\n}\n\n// ---------------------------------------------------------------------------\n// Internal: synthetic Quote objects for `TransferStepDetails.quote`\n// ---------------------------------------------------------------------------\n\n/**\n * Builds a minimum-viable {@link Quote} for the signer step so consumer\n * `EvmSigner` impls can render meaningful wallet prompts for a recurring\n * action (which has no real `Quote` in the swap-quoter sense). The synthetic\n * value carries enough recurring context (uuid, chain, amounts, tokens) for\n * a wallet UI to label the popup; the `aggregator.id` (`'markr-recurring'`)\n * lets advanced signers detect the recurring path explicitly.\n *\n * Asset fields use placeholder `name`/`symbol`/`decimals` because the\n * recurring quote doesn't echo those — consumers needing rich asset display\n * should resolve token metadata against their own asset map keyed by\n * `quote.tokenIn`/`tokenOut`.\n */\nfunction buildSyntheticQuoteForFirstFill({\n  fromAddress,\n  quote,\n  sourceChain,\n}: {\n  fromAddress: `0x${string}`;\n  quote: RecurringQuoteResponse;\n  sourceChain: Chain;\n}): Quote {\n  return {\n    // Keep the stable `'markr-recurring'` marker (shipped in #240) — consumer\n    // signers may detect the recurring path via `quote.aggregator.id`. The\n    // typed `TransferStepDetails.currentSignatureReason` is now the preferred\n    // discriminant for new integrations, but this id stays for back-compat.\n    aggregator: { id: 'markr-recurring', name: 'Markr recurring' },\n    amountIn: quote.amount,\n    amountOut: quote.amountOut,\n    assetIn: { type: TokenType.ERC20, address: quote.tokenIn, name: '', symbol: '', decimals: 0 },\n    assetOut: { type: TokenType.ERC20, address: quote.tokenOut, name: '', symbol: '', decimals: 0 },\n    expiresAt: quote.expiredAt,\n    fees: [],\n    fromAddress,\n    id: quote.uuid,\n    partnerFeeBps: null,\n    serviceType: ServiceType.MARKR,\n    slippageBps: quote.recommendedSlippage,\n    // Pass the caller-provided `Chain` straight through — recurring is always\n    // same-chain, so source === target. Avoids stripping `chainName` /\n    // `networkToken` / `rpcUrl` that consumer signers may use for display.\n    sourceChain,\n    targetChain: sourceChain,\n    toAddress: fromAddress,\n  };\n}\n\nfunction buildSyntheticQuoteForOrderAction({\n  signatureReason,\n  address,\n  orderId,\n  sourceChain,\n}: {\n  signatureReason:\n    | TransferSignatureReason.PauseRecurringSwap\n    | TransferSignatureReason.ResumeRecurringSwap\n    | TransferSignatureReason.CancelRecurringSwap;\n  address: `0x${string}`;\n  orderId: `0x${string}`;\n  sourceChain: Chain;\n}): Quote {\n  const action = ORDER_ACTION_LABEL[signatureReason];\n  return {\n    // Same back-compat rationale as `buildSyntheticQuoteForFirstFill` — preserve\n    // the original lowercase `markr-recurring-${action}` id shape (shipped in\n    // #240) so consumers keying off `quote.aggregator.id` keep working.\n    aggregator: {\n      id: `markr-recurring-${action}`,\n      name: `Markr recurring (${action})`,\n    },\n    amountIn: 0n,\n    amountOut: 0n,\n    assetIn: emptyNativeAsset(),\n    assetOut: emptyNativeAsset(),\n    expiresAt: 0,\n    fees: [],\n    fromAddress: address,\n    id: orderId,\n    partnerFeeBps: null,\n    serviceType: ServiceType.MARKR,\n    slippageBps: 0,\n    // See `buildSyntheticQuoteForFirstFill` — pass the real `Chain` through.\n    sourceChain,\n    targetChain: sourceChain,\n    toAddress: address,\n  };\n}\n\nfunction emptyNativeAsset() {\n  return { type: TokenType.NATIVE, name: '', symbol: '', decimals: 0 } as const;\n}\n"],"mappings":"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"}

package/dist/transfer-service/markr/recurring/_schema.cjs

@@ -0,0 +1,2 @@
+require(`../../../_virtual/_rolldown/runtime.cjs`);const e=require(`./types.cjs`),t=require(`../../service-schemas.cjs`);let n=require(`zod`);const r=/^0x[0-9a-fA-F]{64}$/,i=n.z.enum(e.RECURRING_FREQUENCY_UNITS),a=n.z.object({unit:i,value:n.z.number().int().min(1)}),o=n.z.enum(Object.values(e.RecurringOrderStatus)),s=n.z.object({executionIndex:n.z.number().int().nonnegative(),reasons:n.z.array(n.z.string()),tryCount:n.z.number().int().nonnegative(),failedAt:n.z.number().int().nonnegative()}),c=n.z.string().regex(r,`Invalid recurring order id (expected 0x-prefixed bytes32)`).transform(e=>e),l=n.z.object({orderId:c,owner:t.EvmAddressSchema,chainId:n.z.coerce.number().int().nonnegative(),tokenIn:t.EvmAddressSchema,tokenOut:t.EvmAddressSchema,amount:n.z.coerce.bigint().nonnegative(),numberOfOrders:n.z.number().int(),executedOrders:n.z.number().int().nonnegative(),remainingOrders:n.z.number().int().nonnegative().nullish().transform(e=>e??null),frequency:a,totalAmountIn:n.z.coerce.bigint().nonnegative(),tryCount:n.z.number().int().nonnegative(),failures:n.z.array(s),status:o,createdAt:n.z.number().int().nonnegative(),nextExecutionAt:n.z.number().int().nonnegative().nullish().transform(e=>e??null),cancelledAt:n.z.number().int().nonnegative().nullish().transform(e=>e??null)}),u=n.z.object({type:n.z.enum([`gas`,`recurring`,`protocol`,`bridge`,`slippage`,`swap`,`other`]).or(n.z.string()),name:n.z.string(),amount:n.z.coerce.bigint().nonnegative(),token:n.z.object({chainId:n.z.coerce.number().int().nonnegative(),address:t.EvmAddressSchema}),extra:n.z.union([n.z.boolean(),n.z.record(n.z.string(),n.z.unknown())]).optional()}),d=n.z.object({uuid:n.z.uuid(),chainId:n.z.coerce.number().int().nonnegative(),tokenIn:t.EvmAddressSchema,tokenOut:t.EvmAddressSchema,amount:n.z.coerce.bigint().nonnegative(),numberOfOrders:n.z.number().int(),frequency:a,intervalSeconds:n.z.number().int().nonnegative(),totalAmountIn:n.z.coerce.bigint().nonnegative(),amountOut:n.z.coerce.bigint().nonnegative(),minAmountOut:n.z.coerce.bigint().nonnegative(),fees:n.z.array(u),recommendedSlippage:n.z.number().int().nonnegative(),expiredAt:n.z.number().int().nonnegative()}),f=n.z.object({address:t.EvmAddressSchema,count:n.z.number().int().nonnegative(),orders:n.z.array(l)});exports.ListRecurringOrdersResponseSchema=f,exports.RecurringQuoteResponseSchema=d;
+//# sourceMappingURL=_schema.cjs.map

package/dist/transfer-service/markr/recurring/_schema.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"_schema.cjs","names":["z","RECURRING_FREQUENCY_UNITS","RecurringOrderStatus","EvmAddressSchema"],"sources":["../../../../src/transfer-service/markr/recurring/_schema.ts"],"sourcesContent":["import { z } from 'zod';\nimport { EvmAddressSchema } from '../../service-schemas';\nimport {\n  RECURRING_FREQUENCY_UNITS,\n  RecurringOrderStatus,\n  type ListRecurringOrdersResponse,\n  type RecurringFrequency,\n  type RecurringFrequencyUnit,\n  type RecurringOrder,\n  type RecurringOrderFailure,\n  type RecurringQuoteResponse,\n} from './types';\n\nconst ORDER_ID_REGEX = /^0x[0-9a-fA-F]{64}$/;\n\nexport const RecurringFrequencyUnitSchema: z.ZodType<RecurringFrequencyUnit> = z.enum(RECURRING_FREQUENCY_UNITS);\n\nexport const RecurringFrequencySchema: z.ZodType<RecurringFrequency> = z.object({\n  unit: RecurringFrequencyUnitSchema,\n  value: z.number().int().min(1),\n});\n\n/**\n * Closed enum — see {@link RecurringOrderStatus}. Unknown server-side values\n * (e.g. a hypothetical `'expired'`) will fail parsing loudly, which gates\n * UI behavior on an SDK update rather than silently surfacing an unhandled\n * status to the consumer.\n */\nexport const RecurringOrderStatusSchema: z.ZodType<RecurringOrderStatus> = z.enum(\n  Object.values(RecurringOrderStatus) as [RecurringOrderStatus, ...RecurringOrderStatus[]],\n);\n\nexport const RecurringOrderFailureSchema: z.ZodType<RecurringOrderFailure> = z.object({\n  // `nonnegative` (not `positive`) — Markr documents `executionIndex` as\n  // 1-based today, but forward-compat with a future setup-time failure\n  // emitting index `0` costs nothing and matches the same brittleness fix\n  // applied to the status / fee-type enums.\n  executionIndex: z.number().int().nonnegative(),\n  reasons: z.array(z.string()),\n  tryCount: z.number().int().nonnegative(),\n  failedAt: z.number().int().nonnegative(),\n});\n\n/**\n * `0x`-prefixed bytes32 hex. Use `.transform()` to widen `string` into the\n * template-literal type that `RecurringOrder.orderId` declares — mirrors the\n * `EvmAddressSchema` pattern from `service-schemas.ts`.\n */\nconst OrderIdSchema: z.ZodType<`0x${string}`> = z\n  .string()\n  .regex(ORDER_ID_REGEX, 'Invalid recurring order id (expected 0x-prefixed bytes32)')\n  .transform((value) => value as `0x${string}`);\n\n/**\n * Schema for a single `RecurringOrder` element as returned by Markr's\n * `/recurring/orders` (list) and `/recurring/orders/{orderId}/cancel`\n * endpoints.\n */\nexport const RecurringOrderSchema: z.ZodType<RecurringOrder> = z.object({\n  orderId: OrderIdSchema,\n  owner: EvmAddressSchema,\n  chainId: z.coerce.number().int().nonnegative(),\n  tokenIn: EvmAddressSchema,\n  tokenOut: EvmAddressSchema,\n  amount: z.coerce.bigint().nonnegative(),\n  numberOfOrders: z.number().int(),\n  executedOrders: z.number().int().nonnegative(),\n  // `null` (or omitted) on unlimited schedules per the Markr OpenAPI spec —\n  // `numberOfOrders: -1` schedules have no finite remainder to report. Finite\n  // schedules carry `numberOfOrders - executedOrders` as a non-negative int.\n  // `.nullish()` accepts both `null` and `undefined`; we normalize to `null`\n  // by coercing `undefined` via a default transform so consumers can use a\n  // simple `if (order.remainingOrders === null)` check instead of also\n  // guarding for `undefined`.\n  remainingOrders: z\n    .number()\n    .int()\n    .nonnegative()\n    .nullish()\n    .transform((value) => value ?? null),\n  frequency: RecurringFrequencySchema,\n  totalAmountIn: z.coerce.bigint().nonnegative(),\n  tryCount: z.number().int().nonnegative(),\n  failures: z.array(RecurringOrderFailureSchema),\n  status: RecurringOrderStatusSchema,\n  createdAt: z.number().int().nonnegative(),\n  // OpenAPI marks `nextExecutionAt` as optional + nullable — accept all\n  // three wire shapes (number / null / omitted) and normalize to\n  // `number | null` so consumers can use a single `=== null` check.\n  // Same pattern as `remainingOrders` above.\n  nextExecutionAt: z\n    .number()\n    .int()\n    .nonnegative()\n    .nullish()\n    .transform((value) => value ?? null),\n  // OpenAPI marks `cancelledAt` as optional + nullable; populated only when\n  // `status === 'cancelled'`. Normalize to `number | null` (always present\n  // in the parsed shape) for the same consumer-ergonomics reason as\n  // `nextExecutionAt` / `remainingOrders`.\n  cancelledAt: z\n    .number()\n    .int()\n    .nonnegative()\n    .nullish()\n    .transform((value) => value ?? null),\n});\n\nconst RecurringQuoteFeeSchema = z.object({\n  // Tolerant of unknown fee categories (forward-compat). Unlike\n  // `RecurringOrderStatusSchema` (closed enum — see comment there), a new\n  // fee category from Markr is safe to render as \"Other fee\" instead of\n  // bricking parsing on already-shipped clients.\n  type: z.enum(['gas', 'recurring', 'protocol', 'bridge', 'slippage', 'swap', 'other']).or(z.string()),\n  name: z.string(),\n  amount: z.coerce.bigint().nonnegative(),\n  token: z.object({\n    chainId: z.coerce.number().int().nonnegative(),\n    address: EvmAddressSchema,\n  }),\n  // Docs: `extra: boolean or object` — accept both. See the equivalent\n  // widening on the one-shot quote schema in `markr/_schema.ts`.\n  extra: z.union([z.boolean(), z.record(z.string(), z.unknown())]).optional(),\n});\n\n/**\n * Schema for the response from Markr's `/recurring/quote` endpoint.\n */\nexport const RecurringQuoteResponseSchema: z.ZodType<RecurringQuoteResponse> = z.object({\n  uuid: z.uuid(),\n  chainId: z.coerce.number().int().nonnegative(),\n  tokenIn: EvmAddressSchema,\n  tokenOut: EvmAddressSchema,\n  amount: z.coerce.bigint().nonnegative(),\n  numberOfOrders: z.number().int(),\n  frequency: RecurringFrequencySchema,\n  intervalSeconds: z.number().int().nonnegative(),\n  totalAmountIn: z.coerce.bigint().nonnegative(),\n  amountOut: z.coerce.bigint().nonnegative(),\n  minAmountOut: z.coerce.bigint().nonnegative(),\n  fees: z.array(RecurringQuoteFeeSchema),\n  recommendedSlippage: z.number().int().nonnegative(),\n  expiredAt: z.number().int().nonnegative(),\n});\n\n/**\n * Schema for the response from Markr's `/recurring/orders` (list) endpoint.\n */\nexport const ListRecurringOrdersResponseSchema: z.ZodType<ListRecurringOrdersResponse> = z.object({\n  address: EvmAddressSchema,\n  count: z.number().int().nonnegative(),\n  orders: z.array(RecurringOrderSchema),\n});\n"],"mappings":"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"}

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

@@ -0,0 +1,2 @@
+import{RECURRING_FREQUENCY_UNITS as e,RecurringOrderStatus as t}from"./types.js";import{EvmAddressSchema as n}from"../../service-schemas.js";import{z as r}from"zod";const i=/^0x[0-9a-fA-F]{64}$/,a=r.enum(e),o=r.object({unit:a,value:r.number().int().min(1)}),s=r.enum(Object.values(t)),c=r.object({executionIndex:r.number().int().nonnegative(),reasons:r.array(r.string()),tryCount:r.number().int().nonnegative(),failedAt:r.number().int().nonnegative()}),l=r.string().regex(i,`Invalid recurring order id (expected 0x-prefixed bytes32)`).transform(e=>e),u=r.object({orderId:l,owner:n,chainId:r.coerce.number().int().nonnegative(),tokenIn:n,tokenOut:n,amount:r.coerce.bigint().nonnegative(),numberOfOrders:r.number().int(),executedOrders:r.number().int().nonnegative(),remainingOrders:r.number().int().nonnegative().nullish().transform(e=>e??null),frequency:o,totalAmountIn:r.coerce.bigint().nonnegative(),tryCount:r.number().int().nonnegative(),failures:r.array(c),status:s,createdAt:r.number().int().nonnegative(),nextExecutionAt:r.number().int().nonnegative().nullish().transform(e=>e??null),cancelledAt:r.number().int().nonnegative().nullish().transform(e=>e??null)}),d=r.object({type:r.enum([`gas`,`recurring`,`protocol`,`bridge`,`slippage`,`swap`,`other`]).or(r.string()),name:r.string(),amount:r.coerce.bigint().nonnegative(),token:r.object({chainId:r.coerce.number().int().nonnegative(),address:n}),extra:r.union([r.boolean(),r.record(r.string(),r.unknown())]).optional()}),f=r.object({uuid:r.uuid(),chainId:r.coerce.number().int().nonnegative(),tokenIn:n,tokenOut:n,amount:r.coerce.bigint().nonnegative(),numberOfOrders:r.number().int(),frequency:o,intervalSeconds:r.number().int().nonnegative(),totalAmountIn:r.coerce.bigint().nonnegative(),amountOut:r.coerce.bigint().nonnegative(),minAmountOut:r.coerce.bigint().nonnegative(),fees:r.array(d),recommendedSlippage:r.number().int().nonnegative(),expiredAt:r.number().int().nonnegative()}),p=r.object({address:n,count:r.number().int().nonnegative(),orders:r.array(u)});export{p as ListRecurringOrdersResponseSchema,f as RecurringQuoteResponseSchema};
+//# sourceMappingURL=_schema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_schema.js","names":[],"sources":["../../../../src/transfer-service/markr/recurring/_schema.ts"],"sourcesContent":["import { z } from 'zod';\nimport { EvmAddressSchema } from '../../service-schemas';\nimport {\n  RECURRING_FREQUENCY_UNITS,\n  RecurringOrderStatus,\n  type ListRecurringOrdersResponse,\n  type RecurringFrequency,\n  type RecurringFrequencyUnit,\n  type RecurringOrder,\n  type RecurringOrderFailure,\n  type RecurringQuoteResponse,\n} from './types';\n\nconst ORDER_ID_REGEX = /^0x[0-9a-fA-F]{64}$/;\n\nexport const RecurringFrequencyUnitSchema: z.ZodType<RecurringFrequencyUnit> = z.enum(RECURRING_FREQUENCY_UNITS);\n\nexport const RecurringFrequencySchema: z.ZodType<RecurringFrequency> = z.object({\n  unit: RecurringFrequencyUnitSchema,\n  value: z.number().int().min(1),\n});\n\n/**\n * Closed enum — see {@link RecurringOrderStatus}. Unknown server-side values\n * (e.g. a hypothetical `'expired'`) will fail parsing loudly, which gates\n * UI behavior on an SDK update rather than silently surfacing an unhandled\n * status to the consumer.\n */\nexport const RecurringOrderStatusSchema: z.ZodType<RecurringOrderStatus> = z.enum(\n  Object.values(RecurringOrderStatus) as [RecurringOrderStatus, ...RecurringOrderStatus[]],\n);\n\nexport const RecurringOrderFailureSchema: z.ZodType<RecurringOrderFailure> = z.object({\n  // `nonnegative` (not `positive`) — Markr documents `executionIndex` as\n  // 1-based today, but forward-compat with a future setup-time failure\n  // emitting index `0` costs nothing and matches the same brittleness fix\n  // applied to the status / fee-type enums.\n  executionIndex: z.number().int().nonnegative(),\n  reasons: z.array(z.string()),\n  tryCount: z.number().int().nonnegative(),\n  failedAt: z.number().int().nonnegative(),\n});\n\n/**\n * `0x`-prefixed bytes32 hex. Use `.transform()` to widen `string` into the\n * template-literal type that `RecurringOrder.orderId` declares — mirrors the\n * `EvmAddressSchema` pattern from `service-schemas.ts`.\n */\nconst OrderIdSchema: z.ZodType<`0x${string}`> = z\n  .string()\n  .regex(ORDER_ID_REGEX, 'Invalid recurring order id (expected 0x-prefixed bytes32)')\n  .transform((value) => value as `0x${string}`);\n\n/**\n * Schema for a single `RecurringOrder` element as returned by Markr's\n * `/recurring/orders` (list) and `/recurring/orders/{orderId}/cancel`\n * endpoints.\n */\nexport const RecurringOrderSchema: z.ZodType<RecurringOrder> = z.object({\n  orderId: OrderIdSchema,\n  owner: EvmAddressSchema,\n  chainId: z.coerce.number().int().nonnegative(),\n  tokenIn: EvmAddressSchema,\n  tokenOut: EvmAddressSchema,\n  amount: z.coerce.bigint().nonnegative(),\n  numberOfOrders: z.number().int(),\n  executedOrders: z.number().int().nonnegative(),\n  // `null` (or omitted) on unlimited schedules per the Markr OpenAPI spec —\n  // `numberOfOrders: -1` schedules have no finite remainder to report. Finite\n  // schedules carry `numberOfOrders - executedOrders` as a non-negative int.\n  // `.nullish()` accepts both `null` and `undefined`; we normalize to `null`\n  // by coercing `undefined` via a default transform so consumers can use a\n  // simple `if (order.remainingOrders === null)` check instead of also\n  // guarding for `undefined`.\n  remainingOrders: z\n    .number()\n    .int()\n    .nonnegative()\n    .nullish()\n    .transform((value) => value ?? null),\n  frequency: RecurringFrequencySchema,\n  totalAmountIn: z.coerce.bigint().nonnegative(),\n  tryCount: z.number().int().nonnegative(),\n  failures: z.array(RecurringOrderFailureSchema),\n  status: RecurringOrderStatusSchema,\n  createdAt: z.number().int().nonnegative(),\n  // OpenAPI marks `nextExecutionAt` as optional + nullable — accept all\n  // three wire shapes (number / null / omitted) and normalize to\n  // `number | null` so consumers can use a single `=== null` check.\n  // Same pattern as `remainingOrders` above.\n  nextExecutionAt: z\n    .number()\n    .int()\n    .nonnegative()\n    .nullish()\n    .transform((value) => value ?? null),\n  // OpenAPI marks `cancelledAt` as optional + nullable; populated only when\n  // `status === 'cancelled'`. Normalize to `number | null` (always present\n  // in the parsed shape) for the same consumer-ergonomics reason as\n  // `nextExecutionAt` / `remainingOrders`.\n  cancelledAt: z\n    .number()\n    .int()\n    .nonnegative()\n    .nullish()\n    .transform((value) => value ?? null),\n});\n\nconst RecurringQuoteFeeSchema = z.object({\n  // Tolerant of unknown fee categories (forward-compat). Unlike\n  // `RecurringOrderStatusSchema` (closed enum — see comment there), a new\n  // fee category from Markr is safe to render as \"Other fee\" instead of\n  // bricking parsing on already-shipped clients.\n  type: z.enum(['gas', 'recurring', 'protocol', 'bridge', 'slippage', 'swap', 'other']).or(z.string()),\n  name: z.string(),\n  amount: z.coerce.bigint().nonnegative(),\n  token: z.object({\n    chainId: z.coerce.number().int().nonnegative(),\n    address: EvmAddressSchema,\n  }),\n  // Docs: `extra: boolean or object` — accept both. See the equivalent\n  // widening on the one-shot quote schema in `markr/_schema.ts`.\n  extra: z.union([z.boolean(), z.record(z.string(), z.unknown())]).optional(),\n});\n\n/**\n * Schema for the response from Markr's `/recurring/quote` endpoint.\n */\nexport const RecurringQuoteResponseSchema: z.ZodType<RecurringQuoteResponse> = z.object({\n  uuid: z.uuid(),\n  chainId: z.coerce.number().int().nonnegative(),\n  tokenIn: EvmAddressSchema,\n  tokenOut: EvmAddressSchema,\n  amount: z.coerce.bigint().nonnegative(),\n  numberOfOrders: z.number().int(),\n  frequency: RecurringFrequencySchema,\n  intervalSeconds: z.number().int().nonnegative(),\n  totalAmountIn: z.coerce.bigint().nonnegative(),\n  amountOut: z.coerce.bigint().nonnegative(),\n  minAmountOut: z.coerce.bigint().nonnegative(),\n  fees: z.array(RecurringQuoteFeeSchema),\n  recommendedSlippage: z.number().int().nonnegative(),\n  expiredAt: z.number().int().nonnegative(),\n});\n\n/**\n * Schema for the response from Markr's `/recurring/orders` (list) endpoint.\n */\nexport const ListRecurringOrdersResponseSchema: z.ZodType<ListRecurringOrdersResponse> = z.object({\n  address: EvmAddressSchema,\n  count: z.number().int().nonnegative(),\n  orders: z.array(RecurringOrderSchema),\n});\n"],"mappings":"qKAaA,MAAM,EAAiB,sBAEV,EAAkE,EAAE,KAAK,EAA0B,CAEnG,EAA0D,EAAE,OAAO,CAC9E,KAAM,EACN,MAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAC/B,CAAC,CAQW,EAA8D,EAAE,KAC3E,OAAO,OAAO,EAAqB,CACpC,CAEY,EAAgE,EAAE,OAAO,CAKpF,eAAgB,EAAE,QAAQ,CAAC,KAAK,CAAC,aAAa,CAC9C,QAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,CAC5B,SAAU,EAAE,QAAQ,CAAC,KAAK,CAAC,aAAa,CACxC,SAAU,EAAE,QAAQ,CAAC,KAAK,CAAC,aAAa,CACzC,CAAC,CAOI,EAA0C,EAC7C,QAAQ,CACR,MAAM,EAAgB,4DAA4D,CAClF,UAAW,GAAU,EAAuB,CAOlC,EAAkD,EAAE,OAAO,CACtE,QAAS,EACT,MAAO,EACP,QAAS,EAAE,OAAO,QAAQ,CAAC,KAAK,CAAC,aAAa,CAC9C,QAAS,EACT,SAAU,EACV,OAAQ,EAAE,OAAO,QAAQ,CAAC,aAAa,CACvC,eAAgB,EAAE,QAAQ,CAAC,KAAK,CAChC,eAAgB,EAAE,QAAQ,CAAC,KAAK,CAAC,aAAa,CAQ9C,gBAAiB,EACd,QAAQ,CACR,KAAK,CACL,aAAa,CACb,SAAS,CACT,UAAW,GAAU,GAAS,KAAK,CACtC,UAAW,EACX,cAAe,EAAE,OAAO,QAAQ,CAAC,aAAa,CAC9C,SAAU,EAAE,QAAQ,CAAC,KAAK,CAAC,aAAa,CACxC,SAAU,EAAE,MAAM,EAA4B,CAC9C,OAAQ,EACR,UAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,aAAa,CAKzC,gBAAiB,EACd,QAAQ,CACR,KAAK,CACL,aAAa,CACb,SAAS,CACT,UAAW,GAAU,GAAS,KAAK,CAKtC,YAAa,EACV,QAAQ,CACR,KAAK,CACL,aAAa,CACb,SAAS,CACT,UAAW,GAAU,GAAS,KAAK,CACvC,CAAC,CAEI,EAA0B,EAAE,OAAO,CAKvC,KAAM,EAAE,KAAK,CAAC,MAAO,YAAa,WAAY,SAAU,WAAY,OAAQ,QAAQ,CAAC,CAAC,GAAG,EAAE,QAAQ,CAAC,CACpG,KAAM,EAAE,QAAQ,CAChB,OAAQ,EAAE,OAAO,QAAQ,CAAC,aAAa,CACvC,MAAO,EAAE,OAAO,CACd,QAAS,EAAE,OAAO,QAAQ,CAAC,KAAK,CAAC,aAAa,CAC9C,QAAS,EACV,CAAC,CAGF,MAAO,EAAE,MAAM,CAAC,EAAE,SAAS,CAAE,EAAE,OAAO,EAAE,QAAQ,CAAE,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,UAAU,CAC5E,CAAC,CAKW,EAAkE,EAAE,OAAO,CACtF,KAAM,EAAE,MAAM,CACd,QAAS,EAAE,OAAO,QAAQ,CAAC,KAAK,CAAC,aAAa,CAC9C,QAAS,EACT,SAAU,EACV,OAAQ,EAAE,OAAO,QAAQ,CAAC,aAAa,CACvC,eAAgB,EAAE,QAAQ,CAAC,KAAK,CAChC,UAAW,EACX,gBAAiB,EAAE,QAAQ,CAAC,KAAK,CAAC,aAAa,CAC/C,cAAe,EAAE,OAAO,QAAQ,CAAC,aAAa,CAC9C,UAAW,EAAE,OAAO,QAAQ,CAAC,aAAa,CAC1C,aAAc,EAAE,OAAO,QAAQ,CAAC,aAAa,CAC7C,KAAM,EAAE,MAAM,EAAwB,CACtC,oBAAqB,EAAE,QAAQ,CAAC,KAAK,CAAC,aAAa,CACnD,UAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,aAAa,CAC1C,CAAC,CAKW,EAA4E,EAAE,OAAO,CAChG,QAAS,EACT,MAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,aAAa,CACrC,OAAQ,EAAE,MAAM,EAAqB,CACtC,CAAC"}

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

@@ -0,0 +1,2 @@
+import { 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 } from "./types.js";
+import { FrequencyValidationResult, RECURRING_FREQUENCY_VALUE_MAX, deriveIntervalSeconds, validateFrequency } from "./_frequency.js";

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

@@ -0,0 +1,2 @@
+const e=[`minute`,`hour`,`day`,`week`,`month`];let t=function(e){return e.Active=`active`,e.Completed=`completed`,e.Cancelled=`cancelled`,e.Paused=`paused`,e}({}),n=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}({});exports.RECURRING_FREQUENCY_UNITS=e,exports.RECURRING_UNLIMITED_ORDERS_SENTINEL=-1,exports.RecurringEligibilityReason=n,exports.RecurringOrderStatus=t;
+//# sourceMappingURL=types.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.cjs","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,CA8BnF,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"}