@alchemy/wallet-apis 5.0.0-beta.25 → 5.0.0-beta.27

package/dist/esm/actions/sendCalls.d.ts

@@ -33,8 +33,11 @@ export type SendCallsResult = Prettify<SendPreparedCallsResult>;
  *   }
  * });
  *
- * // The result contains the call ID
- * console.log(result.id);
+ * // Wait for the calls to be mined and confirmed.
+ * // Polls getCallsStatus until the bundle succeeds, fails, or times out (default 60s).
+ * // See: https://viem.sh/docs/actions/wallet/waitForCallsStatus
+ * const status = await client.waitForCallsStatus({ id: result.id });
+ * console.log(status.status); // "success" | "failure"
  * ```
  * <Note>
  * If using this action with an ERC-20 paymaster in pre-operation mode with `autoPermit`, the contents of the permit will be hidden

package/dist/esm/actions/sendCalls.js

@@ -31,8 +31,11 @@ import { extractCapabilitiesForSending } from "../utils/capabilities.js";
  *   }
  * });
  *
- * // The result contains the call ID
- * console.log(result.id);
+ * // Wait for the calls to be mined and confirmed.
+ * // Polls getCallsStatus until the bundle succeeds, fails, or times out (default 60s).
+ * // See: https://viem.sh/docs/actions/wallet/waitForCallsStatus
+ * const status = await client.waitForCallsStatus({ id: result.id });
+ * console.log(status.status); // "success" | "failure"
  * ```
  * <Note>
  * If using this action with an ERC-20 paymaster in pre-operation mode with `autoPermit`, the contents of the permit will be hidden

package/dist/esm/actions/sendCalls.js.map

@@ -1 +1 @@
-{"version":3,"file":"sendCalls.js","sourceRoot":"","sources":["../../../src/actions/sendCalls.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAA2B,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EACL,iBAAiB,GAElB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAUzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAA4B,EAC5B,MAAuB;IAEvB,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE;QAC7B,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM;QAC3B,eAAe,EAAE,CAAC,CAAC,MAAM,CAAC,YAAY;KACvC,CAAC,CAAC;IACH,MAAM,EAAE,KAAK,EAAE,GAAG,kBAAkB,EAAE,GAAG,MAAM,CAAC;IAChD,IAAI,KAAK,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE;QACrC,GAAG,kBAAkB;QACrB,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChD,CAAC,CAAC;IAEH,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;QACtC,MAAM,SAAS,GAAG,MAAM,oBAAoB,CAC1C,MAAM,EACN,KAAK,CAAC,gBAAgB,CACvB,CAAC;QAEF,MAAM,gBAAgB,GAAG;YACvB,GAAG,KAAK,CAAC,eAAe;YACxB,8EAA8E;YAC9E,wBAAwB,EAAE,SAGzB;SACF,CAAC;QAEF,KAAK,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAE3D,MAAM,6BAA6B,GAAG,6BAA6B,CACjE,MAAM,CAAC,YAAY,CACpB,CAAC;IAEF,MAAM,GAAG,GAAG,MAAM,iBAAiB,CAAC,MAAM,EAAE;QAC1C,GAAG,WAAW;QACd,GAAG,CAAC,6BAA6B,IAAI,IAAI;YACvC,CAAC,CAAC,EAAE,YAAY,EAAE,6BAA6B,EAAE;YACjD,CAAC,CAAC,EAAE,CAAC;KACR,CAAC,CAAC;IACH,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC9B,OAAO,GAAG,CAAC;AACb,CAAC","sourcesContent":["import type { Chain, Prettify } from \"viem\";\nimport type { DistributiveOmit, InnerWalletApiClient } from \"../types.js\";\nimport { prepareCalls, type PrepareCallsParams } from \"./prepareCalls.js\";\nimport { signPreparedCalls } from \"./signPreparedCalls.js\";\nimport {\n  sendPreparedCalls,\n  type SendPreparedCallsResult,\n} from \"./sendPreparedCalls.js\";\nimport { LOGGER } from \"../logger.js\";\nimport { signSignatureRequest } from \"./signSignatureRequest.js\";\nimport { extractCapabilitiesForSending } from \"../utils/capabilities.js\";\n\nexport type SendCallsParams = Prettify<\n  DistributiveOmit<PrepareCallsParams, \"chainId\"> & {\n    chain?: Pick<Chain, \"id\">;\n  }\n>;\n\nexport type SendCallsResult = Prettify<SendPreparedCallsResult>;\n\n/**\n * Prepares, signs, and submits calls. This function internally calls `prepareCalls`, `signPreparedCalls`, and `sendPreparedCalls`.\n *\n * The client defaults to using EIP-7702 with the signer's address, so you can call\n * this directly without first calling `requestAccount`.\n *\n * @param {InnerWalletApiClient} client - The wallet API client to use for the request\n * @param {SendCallsParams} params - Parameters for sending calls\n * @param {Array<{to: Address, data?: Hex, value?: bigint}>} params.calls - Array of contract calls to execute\n * @param {AccountParam} [params.account] - The account to execute the calls from. Can be an address string or an object with an `address` property. Defaults to the client's account (signer address via EIP-7702).\n * @param {object} [params.capabilities] - Optional capabilities to include with the request.\n * @returns {Promise<SendPreparedCallsResult>} A Promise that resolves to the result containing the call ID.\n *\n *  @example\n * ```ts\n * // Send calls (uses signer address via EIP-7702 by default)\n * const result = await client.sendCalls({\n *   calls: [{\n *     to: \"0x1234...\",\n *     data: \"0xabcdef...\",\n *     value: 0n\n *   }],\n *   capabilities: {\n *     paymaster: { policyId: \"your-policy-id\" }\n *   }\n * });\n *\n * // The result contains the call ID\n * console.log(result.id);\n * ```\n * <Note>\n * If using this action with an ERC-20 paymaster in pre-operation mode with `autoPermit`, the contents of the permit will be hidden\n * from the user. It is recommended to use the `prepareCalls` action instead to manually handle the permit signature.\n * </Note>\n */\nexport async function sendCalls(\n  client: InnerWalletApiClient,\n  params: SendCallsParams,\n): Promise<SendCallsResult> {\n  LOGGER.info(\"sendCalls:start\", {\n    calls: params.calls?.length,\n    hasCapabilities: !!params.capabilities,\n  });\n  const { chain, ...prepareCallsParams } = params;\n  let calls = await prepareCalls(client, {\n    ...prepareCallsParams,\n    ...(chain != null ? { chainId: chain.id } : {}),\n  });\n\n  if (calls.type === \"paymaster-permit\") {\n    const signature = await signSignatureRequest(\n      client,\n      calls.signatureRequest,\n    );\n\n    const secondCallParams = {\n      ...calls.modifiedRequest,\n      // WebAuthn signatures are not supported for paymaster permits (throws above).\n      paymasterPermitSignature: signature as Exclude<\n        typeof signature,\n        { type: \"webauthn-p256\" }\n      >,\n    };\n\n    calls = await prepareCalls(client, secondCallParams);\n  }\n\n  const signedCalls = await signPreparedCalls(client, calls);\n\n  const sendPreparedCallsCapabilities = extractCapabilitiesForSending(\n    params.capabilities,\n  );\n\n  const res = await sendPreparedCalls(client, {\n    ...signedCalls,\n    ...(sendPreparedCallsCapabilities != null\n      ? { capabilities: sendPreparedCallsCapabilities }\n      : {}),\n  });\n  LOGGER.info(\"sendCalls:done\");\n  return res;\n}\n"]}
+{"version":3,"file":"sendCalls.js","sourceRoot":"","sources":["../../../src/actions/sendCalls.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAA2B,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EACL,iBAAiB,GAElB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAUzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAA4B,EAC5B,MAAuB;IAEvB,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE;QAC7B,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM;QAC3B,eAAe,EAAE,CAAC,CAAC,MAAM,CAAC,YAAY;KACvC,CAAC,CAAC;IACH,MAAM,EAAE,KAAK,EAAE,GAAG,kBAAkB,EAAE,GAAG,MAAM,CAAC;IAChD,IAAI,KAAK,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE;QACrC,GAAG,kBAAkB;QACrB,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChD,CAAC,CAAC;IAEH,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;QACtC,MAAM,SAAS,GAAG,MAAM,oBAAoB,CAC1C,MAAM,EACN,KAAK,CAAC,gBAAgB,CACvB,CAAC;QAEF,MAAM,gBAAgB,GAAG;YACvB,GAAG,KAAK,CAAC,eAAe;YACxB,8EAA8E;YAC9E,wBAAwB,EAAE,SAGzB;SACF,CAAC;QAEF,KAAK,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAE3D,MAAM,6BAA6B,GAAG,6BAA6B,CACjE,MAAM,CAAC,YAAY,CACpB,CAAC;IAEF,MAAM,GAAG,GAAG,MAAM,iBAAiB,CAAC,MAAM,EAAE;QAC1C,GAAG,WAAW;QACd,GAAG,CAAC,6BAA6B,IAAI,IAAI;YACvC,CAAC,CAAC,EAAE,YAAY,EAAE,6BAA6B,EAAE;YACjD,CAAC,CAAC,EAAE,CAAC;KACR,CAAC,CAAC;IACH,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC9B,OAAO,GAAG,CAAC;AACb,CAAC","sourcesContent":["import type { Chain, Prettify } from \"viem\";\nimport type { DistributiveOmit, InnerWalletApiClient } from \"../types.js\";\nimport { prepareCalls, type PrepareCallsParams } from \"./prepareCalls.js\";\nimport { signPreparedCalls } from \"./signPreparedCalls.js\";\nimport {\n  sendPreparedCalls,\n  type SendPreparedCallsResult,\n} from \"./sendPreparedCalls.js\";\nimport { LOGGER } from \"../logger.js\";\nimport { signSignatureRequest } from \"./signSignatureRequest.js\";\nimport { extractCapabilitiesForSending } from \"../utils/capabilities.js\";\n\nexport type SendCallsParams = Prettify<\n  DistributiveOmit<PrepareCallsParams, \"chainId\"> & {\n    chain?: Pick<Chain, \"id\">;\n  }\n>;\n\nexport type SendCallsResult = Prettify<SendPreparedCallsResult>;\n\n/**\n * Prepares, signs, and submits calls. This function internally calls `prepareCalls`, `signPreparedCalls`, and `sendPreparedCalls`.\n *\n * The client defaults to using EIP-7702 with the signer's address, so you can call\n * this directly without first calling `requestAccount`.\n *\n * @param {InnerWalletApiClient} client - The wallet API client to use for the request\n * @param {SendCallsParams} params - Parameters for sending calls\n * @param {Array<{to: Address, data?: Hex, value?: bigint}>} params.calls - Array of contract calls to execute\n * @param {AccountParam} [params.account] - The account to execute the calls from. Can be an address string or an object with an `address` property. Defaults to the client's account (signer address via EIP-7702).\n * @param {object} [params.capabilities] - Optional capabilities to include with the request.\n * @returns {Promise<SendPreparedCallsResult>} A Promise that resolves to the result containing the call ID.\n *\n *  @example\n * ```ts\n * // Send calls (uses signer address via EIP-7702 by default)\n * const result = await client.sendCalls({\n *   calls: [{\n *     to: \"0x1234...\",\n *     data: \"0xabcdef...\",\n *     value: 0n\n *   }],\n *   capabilities: {\n *     paymaster: { policyId: \"your-policy-id\" }\n *   }\n * });\n *\n * // Wait for the calls to be mined and confirmed.\n * // Polls getCallsStatus until the bundle succeeds, fails, or times out (default 60s).\n * // See: https://viem.sh/docs/actions/wallet/waitForCallsStatus\n * const status = await client.waitForCallsStatus({ id: result.id });\n * console.log(status.status); // \"success\" | \"failure\"\n * ```\n * <Note>\n * If using this action with an ERC-20 paymaster in pre-operation mode with `autoPermit`, the contents of the permit will be hidden\n * from the user. It is recommended to use the `prepareCalls` action instead to manually handle the permit signature.\n * </Note>\n */\nexport async function sendCalls(\n  client: InnerWalletApiClient,\n  params: SendCallsParams,\n): Promise<SendCallsResult> {\n  LOGGER.info(\"sendCalls:start\", {\n    calls: params.calls?.length,\n    hasCapabilities: !!params.capabilities,\n  });\n  const { chain, ...prepareCallsParams } = params;\n  let calls = await prepareCalls(client, {\n    ...prepareCallsParams,\n    ...(chain != null ? { chainId: chain.id } : {}),\n  });\n\n  if (calls.type === \"paymaster-permit\") {\n    const signature = await signSignatureRequest(\n      client,\n      calls.signatureRequest,\n    );\n\n    const secondCallParams = {\n      ...calls.modifiedRequest,\n      // WebAuthn signatures are not supported for paymaster permits (throws above).\n      paymasterPermitSignature: signature as Exclude<\n        typeof signature,\n        { type: \"webauthn-p256\" }\n      >,\n    };\n\n    calls = await prepareCalls(client, secondCallParams);\n  }\n\n  const signedCalls = await signPreparedCalls(client, calls);\n\n  const sendPreparedCallsCapabilities = extractCapabilitiesForSending(\n    params.capabilities,\n  );\n\n  const res = await sendPreparedCalls(client, {\n    ...signedCalls,\n    ...(sendPreparedCallsCapabilities != null\n      ? { capabilities: sendPreparedCallsCapabilities }\n      : {}),\n  });\n  LOGGER.info(\"sendCalls:done\");\n  return res;\n}\n"]}

package/dist/esm/experimental/actions/requestQuoteV0.d.ts

@@ -6,6 +6,9 @@ import { wallet_requestQuote_v0 as MethodSchema } from "@alchemy/wallet-api-type
 import { type MethodParams, type MethodResponse } from "../../utils/schema.js";
 type BaseRequestQuoteV0Params = MethodParams<typeof MethodSchema>;
 type RequestQuoteV0Response = MethodResponse<typeof MethodSchema>;
+/**
+ * Parameters accepted by the experimental `requestQuoteV0` action.
+ */
 export type RequestQuoteV0Params = Prettify<WithCapabilities<DistributiveOmit<BaseRequestQuoteV0Params, "from" | "chainId"> & {
     account?: AccountParam;
     chainId?: number;
@@ -17,6 +20,9 @@ type ClientModifiedRequest = Prettify<Omit<Extract<RequestQuoteV0Response, {
     account: Address;
     capabilities?: PrepareCallsCapabilities;
 }>;
+/**
+ * Result returned by the experimental `requestQuoteV0` action.
+ */
 export type RequestQuoteV0Result = Exclude<RequestQuoteV0Response, {
     type: "paymaster-permit";
 }> | (Omit<Extract<RequestQuoteV0Response, {
@@ -32,13 +38,15 @@ export type RequestQuoteV0Result = Exclude<RequestQuoteV0Response, {
  * @param {RequestQuoteV0Params} params - Parameters for requesting a swap quote
  * @param {Address} params.fromToken - The address of the token to swap from
  * @param {Address} params.toToken - The address of the token to swap to
- * @param {Hex} [params.fromAmount] - The amount to swap from (mutually exclusive with minimumToAmount)
- * @param {Hex} [params.minimumToAmount] - The minimum amount to receive (mutually exclusive with fromAmount)
+ * @param {bigint} [params.fromAmount] - The amount to swap from (mutually exclusive with minimumToAmount)
+ * @param {bigint} [params.minimumToAmount] - The minimum amount to receive (mutually exclusive with fromAmount)
  * @param {AccountParam} [params.account] - The account to execute the swap from. Can be an address string or an object with an `address` property. Defaults to the client's account (signer address via EIP-7702).
- * @param {Hex} [params.slippage] - The maximum acceptable slippage percentage
+ * @param {number} [params.chainId] - The source chain ID. Defaults to the wallet client's chain.
+ * @param {number} [params.toChainId] - The destination chain ID for cross-chain swaps. Omit for same-chain swaps.
+ * @param {bigint} [params.slippage] - The maximum acceptable slippage in basis points.
  * @param {boolean} [params.returnRawCalls] - Whether to return raw calls for EOA wallets (defaults to false for smart wallets)
  * @param {object} [params.capabilities] - Optional capabilities to include with the request (only available when returnRawCalls is false)
- * @param {Array<{to: Address, data?: Hex, value?: Hex}>} [params.postCalls] - Optional calls to execute after the swap
+ * @param {Array<{ to: Address; data?: Hex; value?: bigint }>} [params.postCalls] - Optional calls to execute after the swap
  * @returns {Promise<RequestQuoteV0Result>} A Promise that resolves to either prepared calls or raw calls depending on returnRawCalls
  *
  * @example
@@ -48,6 +56,7 @@ export type RequestQuoteV0Result = Exclude<RequestQuoteV0Response, {
  *   fromToken: "0xA0b86a33E6441e1d6a8E8C7a8E8E8E8E8E8E8E8E",
  *   toToken: "0xB0b86a33E6441e1d6a8E8C7a8E8E8E8E8E8E8E8E",
  *   fromAmount: 1000000000000000000n, // 1 ETH
+ *   chainId: 42161, // Arbitrum
  *   capabilities: {
  *     paymaster: { policyId: "your-policy-id" }
  *   }
@@ -58,6 +67,7 @@ export type RequestQuoteV0Result = Exclude<RequestQuoteV0Response, {
  *   fromToken: "0xA0b86a33E6441e1d6a8E8C7a8E8E8E8E8E8E8E8E",
  *   toToken: "0xB0b86a33E6441e1d6a8E8C7a8E8E8E8E8E8E8E8E",
  *   fromAmount: 1000000000000000000n,
+ *   chainId: 42161,
  *   returnRawCalls: true
  * });
  * ```

package/dist/esm/experimental/actions/requestQuoteV0.js

@@ -11,13 +11,15 @@ const schema = methodSchema(MethodSchema);
  * @param {RequestQuoteV0Params} params - Parameters for requesting a swap quote
  * @param {Address} params.fromToken - The address of the token to swap from
  * @param {Address} params.toToken - The address of the token to swap to
- * @param {Hex} [params.fromAmount] - The amount to swap from (mutually exclusive with minimumToAmount)
- * @param {Hex} [params.minimumToAmount] - The minimum amount to receive (mutually exclusive with fromAmount)
+ * @param {bigint} [params.fromAmount] - The amount to swap from (mutually exclusive with minimumToAmount)
+ * @param {bigint} [params.minimumToAmount] - The minimum amount to receive (mutually exclusive with fromAmount)
  * @param {AccountParam} [params.account] - The account to execute the swap from. Can be an address string or an object with an `address` property. Defaults to the client's account (signer address via EIP-7702).
- * @param {Hex} [params.slippage] - The maximum acceptable slippage percentage
+ * @param {number} [params.chainId] - The source chain ID. Defaults to the wallet client's chain.
+ * @param {number} [params.toChainId] - The destination chain ID for cross-chain swaps. Omit for same-chain swaps.
+ * @param {bigint} [params.slippage] - The maximum acceptable slippage in basis points.
  * @param {boolean} [params.returnRawCalls] - Whether to return raw calls for EOA wallets (defaults to false for smart wallets)
  * @param {object} [params.capabilities] - Optional capabilities to include with the request (only available when returnRawCalls is false)
- * @param {Array<{to: Address, data?: Hex, value?: Hex}>} [params.postCalls] - Optional calls to execute after the swap
+ * @param {Array<{ to: Address; data?: Hex; value?: bigint }>} [params.postCalls] - Optional calls to execute after the swap
  * @returns {Promise<RequestQuoteV0Result>} A Promise that resolves to either prepared calls or raw calls depending on returnRawCalls
  *
  * @example
@@ -27,6 +29,7 @@ const schema = methodSchema(MethodSchema);
  *   fromToken: "0xA0b86a33E6441e1d6a8E8C7a8E8E8E8E8E8E8E8E",
  *   toToken: "0xB0b86a33E6441e1d6a8E8C7a8E8E8E8E8E8E8E8E",
  *   fromAmount: 1000000000000000000n, // 1 ETH
+ *   chainId: 42161, // Arbitrum
  *   capabilities: {
  *     paymaster: { policyId: "your-policy-id" }
  *   }
@@ -37,6 +40,7 @@ const schema = methodSchema(MethodSchema);
  *   fromToken: "0xA0b86a33E6441e1d6a8E8C7a8E8E8E8E8E8E8E8E",
  *   toToken: "0xB0b86a33E6441e1d6a8E8C7a8E8E8E8E8E8E8E8E",
  *   fromAmount: 1000000000000000000n,
+ *   chainId: 42161,
  *   returnRawCalls: true
  * });
  * ```

package/dist/esm/experimental/actions/requestQuoteV0.js.map

@@ -1 +1 @@
-{"version":3,"file":"requestQuoteV0.js","sourceRoot":"","sources":["../../../../src/experimental/actions/requestQuoteV0.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,iBAAiB,GAGlB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,cAAc,EAAqB,MAAM,wBAAwB,CAAC;AAC3E,OAAO,EAAE,sBAAsB,IAAI,YAAY,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EACL,YAAY,EACZ,MAAM,EACN,MAAM,GAGP,MAAM,uBAAuB,CAAC;AAE/B,MAAM,MAAM,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;AAoC1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAA4B,EAC5B,MAA4B;IAE5B,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO;QACzB,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC;QAChC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;IAE3B,MAAM,YAAY,GAChB,gBAAgB,IAAI,MAAM,IAAI,MAAM,CAAC,cAAc;QACjD,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,uBAAuB,CACrB,MAAM,EACN,cAAc,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAC3D,CAAC;IAER,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;IACpD,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE;QACvC,GAAG,IAAI;QACP,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE;QAC1C,IAAI;QACJ,GAAG,CAAC,YAAY,IAAI,EAAE,YAAY,EAAE,iBAAiB,CAAC,YAAY,CAAC,EAAE,CAAC;KACvE,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;QACnC,MAAM,EAAE,wBAAwB;QAChC,MAAM,EAAE,CAAC,SAAS,CAAC;KACpB,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAEjD,+EAA+E;IAC/E,sCAAsC;IACtC,8EAA8E;IAC9E,IAAI,MAAM,IAAI,OAAO,IAAI,OAAO,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;QAC7D,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,mBAAmB,EAAE,GAClD,OAAO,CAAC,eAAe,CAAC;QAC1B,OAAO;YACL,GAAG,OAAO;YACV,eAAe,EAAE;gBACf,GAAG,mBAAmB;gBACtB,OAAO,EAAE,IAAI;gBACb,YAAY,EAAE,mBAAmB,CAAC,YAAY,CAAC;aAChD;SACF,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["import type { Address, Prettify } from \"viem\";\nimport type { DistributiveOmit, InnerWalletApiClient } from \"../../types.ts\";\nimport {\n  fromRpcCapabilities,\n  mergeClientCapabilities,\n  toRpcCapabilities,\n  type PrepareCallsCapabilities,\n  type WithCapabilities,\n} from \"../../utils/capabilities.js\";\nimport { resolveAddress, type AccountParam } from \"../../utils/resolve.js\";\nimport { wallet_requestQuote_v0 as MethodSchema } from \"@alchemy/wallet-api-types/rpc\";\nimport {\n  methodSchema,\n  encode,\n  decode,\n  type MethodParams,\n  type MethodResponse,\n} from \"../../utils/schema.js\";\n\nconst schema = methodSchema(MethodSchema);\ntype BaseRequestQuoteV0Params = MethodParams<typeof MethodSchema>;\ntype RequestQuoteV0Response = MethodResponse<typeof MethodSchema>;\n\nexport type RequestQuoteV0Params = Prettify<\n  WithCapabilities<\n    DistributiveOmit<BaseRequestQuoteV0Params, \"from\" | \"chainId\"> & {\n      account?: AccountParam;\n      chainId?: number;\n    }\n  >\n>;\n\n/** The modifiedRequest in client format: `account` instead of `from`, SDK capabilities. */\ntype ClientModifiedRequest = Prettify<\n  Omit<\n    Extract<\n      RequestQuoteV0Response,\n      { type: \"paymaster-permit\" }\n    >[\"modifiedRequest\"],\n    \"from\" | \"capabilities\"\n  > & {\n    account: Address;\n    capabilities?: PrepareCallsCapabilities;\n  }\n>;\n\nexport type RequestQuoteV0Result =\n  | Exclude<RequestQuoteV0Response, { type: \"paymaster-permit\" }>\n  | (Omit<\n      Extract<RequestQuoteV0Response, { type: \"paymaster-permit\" }>,\n      \"modifiedRequest\"\n    > & {\n      modifiedRequest: ClientModifiedRequest;\n    });\n\n/**\n * Requests a quote for a token swap, returning either prepared calls for smart wallets\n * or raw calls for EOA wallets depending on the returnRawCalls parameter.\n *\n * @param {InnerWalletApiClient} client - The wallet API client to use for the request\n * @param {RequestQuoteV0Params} params - Parameters for requesting a swap quote\n * @param {Address} params.fromToken - The address of the token to swap from\n * @param {Address} params.toToken - The address of the token to swap to\n * @param {Hex} [params.fromAmount] - The amount to swap from (mutually exclusive with minimumToAmount)\n * @param {Hex} [params.minimumToAmount] - The minimum amount to receive (mutually exclusive with fromAmount)\n * @param {AccountParam} [params.account] - The account to execute the swap from. Can be an address string or an object with an `address` property. Defaults to the client's account (signer address via EIP-7702).\n * @param {Hex} [params.slippage] - The maximum acceptable slippage percentage\n * @param {boolean} [params.returnRawCalls] - Whether to return raw calls for EOA wallets (defaults to false for smart wallets)\n * @param {object} [params.capabilities] - Optional capabilities to include with the request (only available when returnRawCalls is false)\n * @param {Array<{to: Address, data?: Hex, value?: Hex}>} [params.postCalls] - Optional calls to execute after the swap\n * @returns {Promise<RequestQuoteV0Result>} A Promise that resolves to either prepared calls or raw calls depending on returnRawCalls\n *\n * @example\n * ```ts twoslash\n * // Request a quote for smart wallet (prepared calls)\n * const quote = await client.requestQuoteV0({\n *   fromToken: \"0xA0b86a33E6441e1d6a8E8C7a8E8E8E8E8E8E8E8E\",\n *   toToken: \"0xB0b86a33E6441e1d6a8E8C7a8E8E8E8E8E8E8E8E\",\n *   fromAmount: 1000000000000000000n, // 1 ETH\n *   capabilities: {\n *     paymaster: { policyId: \"your-policy-id\" }\n *   }\n * });\n *\n * // Request a quote for EOA wallet (raw calls)\n * const rawQuote = await client.requestQuoteV0({\n *   fromToken: \"0xA0b86a33E6441e1d6a8E8C7a8E8E8E8E8E8E8E8E\",\n *   toToken: \"0xB0b86a33E6441e1d6a8E8C7a8E8E8E8E8E8E8E8E\",\n *   fromAmount: 1000000000000000000n,\n *   returnRawCalls: true\n * });\n * ```\n */\nexport async function requestQuoteV0(\n  client: InnerWalletApiClient,\n  params: RequestQuoteV0Params,\n): Promise<RequestQuoteV0Result> {\n  const from = params.account\n    ? resolveAddress(params.account)\n    : client.account.address;\n\n  const capabilities =\n    \"returnRawCalls\" in params && params.returnRawCalls\n      ? undefined\n      : mergeClientCapabilities(\n          client,\n          \"capabilities\" in params ? params.capabilities : undefined,\n        );\n\n  const { account: _, chainId: __, ...rest } = params;\n  const rpcParams = encode(schema.request, {\n    ...rest,\n    chainId: params.chainId ?? client.chain.id,\n    from,\n    ...(capabilities && { capabilities: toRpcCapabilities(capabilities) }),\n  });\n\n  const rpcResp = await client.request({\n    method: \"wallet_requestQuote_v0\",\n    params: [rpcParams],\n  });\n\n  const decoded = decode(schema.response, rpcResp);\n\n  // Transform paymaster-permit modifiedRequest from RPC format to client format:\n  // - `from` (RPC) → `account` (client)\n  // - `capabilities.paymasterService` (RPC) → `capabilities.paymaster` (client)\n  if (\"type\" in decoded && decoded.type === \"paymaster-permit\") {\n    const { from, capabilities, ...restModifiedRequest } =\n      decoded.modifiedRequest;\n    return {\n      ...decoded,\n      modifiedRequest: {\n        ...restModifiedRequest,\n        account: from,\n        capabilities: fromRpcCapabilities(capabilities),\n      },\n    };\n  }\n\n  return decoded;\n}\n"]}
+{"version":3,"file":"requestQuoteV0.js","sourceRoot":"","sources":["../../../../src/experimental/actions/requestQuoteV0.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,iBAAiB,GAGlB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,cAAc,EAAqB,MAAM,wBAAwB,CAAC;AAC3E,OAAO,EAAE,sBAAsB,IAAI,YAAY,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EACL,YAAY,EACZ,MAAM,EACN,MAAM,GAGP,MAAM,uBAAuB,CAAC;AAE/B,MAAM,MAAM,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;AA0C1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAA4B,EAC5B,MAA4B;IAE5B,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO;QACzB,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC;QAChC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;IAE3B,MAAM,YAAY,GAChB,gBAAgB,IAAI,MAAM,IAAI,MAAM,CAAC,cAAc;QACjD,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,uBAAuB,CACrB,MAAM,EACN,cAAc,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAC3D,CAAC;IAER,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;IACpD,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE;QACvC,GAAG,IAAI;QACP,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE;QAC1C,IAAI;QACJ,GAAG,CAAC,YAAY,IAAI,EAAE,YAAY,EAAE,iBAAiB,CAAC,YAAY,CAAC,EAAE,CAAC;KACvE,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;QACnC,MAAM,EAAE,wBAAwB;QAChC,MAAM,EAAE,CAAC,SAAS,CAAC;KACpB,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAEjD,+EAA+E;IAC/E,sCAAsC;IACtC,8EAA8E;IAC9E,IAAI,MAAM,IAAI,OAAO,IAAI,OAAO,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;QAC7D,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,mBAAmB,EAAE,GAClD,OAAO,CAAC,eAAe,CAAC;QAC1B,OAAO;YACL,GAAG,OAAO;YACV,eAAe,EAAE;gBACf,GAAG,mBAAmB;gBACtB,OAAO,EAAE,IAAI;gBACb,YAAY,EAAE,mBAAmB,CAAC,YAAY,CAAC;aAChD;SACF,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["import type { Address, Prettify } from \"viem\";\nimport type { DistributiveOmit, InnerWalletApiClient } from \"../../types.ts\";\nimport {\n  fromRpcCapabilities,\n  mergeClientCapabilities,\n  toRpcCapabilities,\n  type PrepareCallsCapabilities,\n  type WithCapabilities,\n} from \"../../utils/capabilities.js\";\nimport { resolveAddress, type AccountParam } from \"../../utils/resolve.js\";\nimport { wallet_requestQuote_v0 as MethodSchema } from \"@alchemy/wallet-api-types/rpc\";\nimport {\n  methodSchema,\n  encode,\n  decode,\n  type MethodParams,\n  type MethodResponse,\n} from \"../../utils/schema.js\";\n\nconst schema = methodSchema(MethodSchema);\ntype BaseRequestQuoteV0Params = MethodParams<typeof MethodSchema>;\ntype RequestQuoteV0Response = MethodResponse<typeof MethodSchema>;\n\n/**\n * Parameters accepted by the experimental `requestQuoteV0` action.\n */\nexport type RequestQuoteV0Params = Prettify<\n  WithCapabilities<\n    DistributiveOmit<BaseRequestQuoteV0Params, \"from\" | \"chainId\"> & {\n      account?: AccountParam;\n      chainId?: number;\n    }\n  >\n>;\n\n/** The modifiedRequest in client format: `account` instead of `from`, SDK capabilities. */\ntype ClientModifiedRequest = Prettify<\n  Omit<\n    Extract<\n      RequestQuoteV0Response,\n      { type: \"paymaster-permit\" }\n    >[\"modifiedRequest\"],\n    \"from\" | \"capabilities\"\n  > & {\n    account: Address;\n    capabilities?: PrepareCallsCapabilities;\n  }\n>;\n\n/**\n * Result returned by the experimental `requestQuoteV0` action.\n */\nexport type RequestQuoteV0Result =\n  | Exclude<RequestQuoteV0Response, { type: \"paymaster-permit\" }>\n  | (Omit<\n      Extract<RequestQuoteV0Response, { type: \"paymaster-permit\" }>,\n      \"modifiedRequest\"\n    > & {\n      modifiedRequest: ClientModifiedRequest;\n    });\n\n/**\n * Requests a quote for a token swap, returning either prepared calls for smart wallets\n * or raw calls for EOA wallets depending on the returnRawCalls parameter.\n *\n * @param {InnerWalletApiClient} client - The wallet API client to use for the request\n * @param {RequestQuoteV0Params} params - Parameters for requesting a swap quote\n * @param {Address} params.fromToken - The address of the token to swap from\n * @param {Address} params.toToken - The address of the token to swap to\n * @param {bigint} [params.fromAmount] - The amount to swap from (mutually exclusive with minimumToAmount)\n * @param {bigint} [params.minimumToAmount] - The minimum amount to receive (mutually exclusive with fromAmount)\n * @param {AccountParam} [params.account] - The account to execute the swap from. Can be an address string or an object with an `address` property. Defaults to the client's account (signer address via EIP-7702).\n * @param {number} [params.chainId] - The source chain ID. Defaults to the wallet client's chain.\n * @param {number} [params.toChainId] - The destination chain ID for cross-chain swaps. Omit for same-chain swaps.\n * @param {bigint} [params.slippage] - The maximum acceptable slippage in basis points.\n * @param {boolean} [params.returnRawCalls] - Whether to return raw calls for EOA wallets (defaults to false for smart wallets)\n * @param {object} [params.capabilities] - Optional capabilities to include with the request (only available when returnRawCalls is false)\n * @param {Array<{ to: Address; data?: Hex; value?: bigint }>} [params.postCalls] - Optional calls to execute after the swap\n * @returns {Promise<RequestQuoteV0Result>} A Promise that resolves to either prepared calls or raw calls depending on returnRawCalls\n *\n * @example\n * ```ts twoslash\n * // Request a quote for smart wallet (prepared calls)\n * const quote = await client.requestQuoteV0({\n *   fromToken: \"0xA0b86a33E6441e1d6a8E8C7a8E8E8E8E8E8E8E8E\",\n *   toToken: \"0xB0b86a33E6441e1d6a8E8C7a8E8E8E8E8E8E8E8E\",\n *   fromAmount: 1000000000000000000n, // 1 ETH\n *   chainId: 42161, // Arbitrum\n *   capabilities: {\n *     paymaster: { policyId: \"your-policy-id\" }\n *   }\n * });\n *\n * // Request a quote for EOA wallet (raw calls)\n * const rawQuote = await client.requestQuoteV0({\n *   fromToken: \"0xA0b86a33E6441e1d6a8E8C7a8E8E8E8E8E8E8E8E\",\n *   toToken: \"0xB0b86a33E6441e1d6a8E8C7a8E8E8E8E8E8E8E8E\",\n *   fromAmount: 1000000000000000000n,\n *   chainId: 42161,\n *   returnRawCalls: true\n * });\n * ```\n */\nexport async function requestQuoteV0(\n  client: InnerWalletApiClient,\n  params: RequestQuoteV0Params,\n): Promise<RequestQuoteV0Result> {\n  const from = params.account\n    ? resolveAddress(params.account)\n    : client.account.address;\n\n  const capabilities =\n    \"returnRawCalls\" in params && params.returnRawCalls\n      ? undefined\n      : mergeClientCapabilities(\n          client,\n          \"capabilities\" in params ? params.capabilities : undefined,\n        );\n\n  const { account: _, chainId: __, ...rest } = params;\n  const rpcParams = encode(schema.request, {\n    ...rest,\n    chainId: params.chainId ?? client.chain.id,\n    from,\n    ...(capabilities && { capabilities: toRpcCapabilities(capabilities) }),\n  });\n\n  const rpcResp = await client.request({\n    method: \"wallet_requestQuote_v0\",\n    params: [rpcParams],\n  });\n\n  const decoded = decode(schema.response, rpcResp);\n\n  // Transform paymaster-permit modifiedRequest from RPC format to client format:\n  // - `from` (RPC) → `account` (client)\n  // - `capabilities.paymasterService` (RPC) → `capabilities.paymaster` (client)\n  if (\"type\" in decoded && decoded.type === \"paymaster-permit\") {\n    const { from, capabilities, ...restModifiedRequest } =\n      decoded.modifiedRequest;\n    return {\n      ...decoded,\n      modifiedRequest: {\n        ...restModifiedRequest,\n        account: from,\n        capabilities: fromRpcCapabilities(capabilities),\n      },\n    };\n  }\n\n  return decoded;\n}\n"]}

package/dist/esm/experimental/swapActionsDecorator.d.ts

@@ -1,5 +1,8 @@
 import { type RequestQuoteV0Params, type RequestQuoteV0Result } from "./actions/requestQuoteV0.js";
 import type { BaseWalletClient } from "../types.js";
+/**
+ * Experimental swap actions for wallet API clients.
+ */
 export type SwapActions = {
     requestQuoteV0: (params: RequestQuoteV0Params) => Promise<RequestQuoteV0Result>;
 };

package/dist/esm/experimental/swapActionsDecorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"swapActionsDecorator.js","sourceRoot":"","sources":["../../../src/experimental/swapActionsDecorator.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,GAGf,MAAM,6BAA6B,CAAC;AASrC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAA8C,CACpE,MAAM,EACN,EAAE;IACF,mEAAmE;IACnE,2CAA2C;IAC3C,MAAM,OAAO,GAAG,MAA8B,CAAC;IAC/C,OAAO;QACL,cAAc,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC;KAC5D,CAAC;AACJ,CAAC,CAAC","sourcesContent":["import {\n  requestQuoteV0,\n  type RequestQuoteV0Params,\n  type RequestQuoteV0Result,\n} from \"./actions/requestQuoteV0.js\";\nimport type { BaseWalletClient, InnerWalletApiClient } from \"../types.js\";\n\nexport type SwapActions = {\n  requestQuoteV0: (\n    params: RequestQuoteV0Params,\n  ) => Promise<RequestQuoteV0Result>;\n};\n\n/**\n * This is a decorator that is used to add experimental swap actions to a client.\n *\n * @param {BaseWalletClient} client The wallet client to extend with swap functionality\n * @returns {SwapActions} An object containing swap-related actions\n */\nexport const swapActions: (client: BaseWalletClient) => SwapActions = (\n  client,\n) => {\n  // This is safe. It's just needed b/c we have an internal decorator\n  // that we don't expose on the public type.\n  const _client = client as InnerWalletApiClient;\n  return {\n    requestQuoteV0: (params) => requestQuoteV0(_client, params),\n  };\n};\n"]}
+{"version":3,"file":"swapActionsDecorator.js","sourceRoot":"","sources":["../../../src/experimental/swapActionsDecorator.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,GAGf,MAAM,6BAA6B,CAAC;AAYrC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAA8C,CACpE,MAAM,EACN,EAAE;IACF,mEAAmE;IACnE,2CAA2C;IAC3C,MAAM,OAAO,GAAG,MAA8B,CAAC;IAC/C,OAAO;QACL,cAAc,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC;KAC5D,CAAC;AACJ,CAAC,CAAC","sourcesContent":["import {\n  requestQuoteV0,\n  type RequestQuoteV0Params,\n  type RequestQuoteV0Result,\n} from \"./actions/requestQuoteV0.js\";\nimport type { BaseWalletClient, InnerWalletApiClient } from \"../types.js\";\n\n/**\n * Experimental swap actions for wallet API clients.\n */\nexport type SwapActions = {\n  requestQuoteV0: (\n    params: RequestQuoteV0Params,\n  ) => Promise<RequestQuoteV0Result>;\n};\n\n/**\n * This is a decorator that is used to add experimental swap actions to a client.\n *\n * @param {BaseWalletClient} client The wallet client to extend with swap functionality\n * @returns {SwapActions} An object containing swap-related actions\n */\nexport const swapActions: (client: BaseWalletClient) => SwapActions = (\n  client,\n) => {\n  // This is safe. It's just needed b/c we have an internal decorator\n  // that we don't expose on the public type.\n  const _client = client as InnerWalletApiClient;\n  return {\n    requestQuoteV0: (params) => requestQuoteV0(_client, params),\n  };\n};\n"]}

package/dist/esm/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "5.0.0-beta.24";
+export declare const VERSION = "5.0.0-beta.26";

package/dist/esm/version.js

@@ -1,4 +1,4 @@
 // This file is autogenerated by inject-version.ts. Any changes will be
 // overwritten on commit!
-export const VERSION = "5.0.0-beta.24";
+export const VERSION = "5.0.0-beta.26";
 //# sourceMappingURL=version.js.map

package/dist/esm/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,yBAAyB;AACzB,MAAM,CAAC,MAAM,OAAO,GAAG,eAAe,CAAC","sourcesContent":["// This file is autogenerated by inject-version.ts. Any changes will be\n// overwritten on commit!\nexport const VERSION = \"5.0.0-beta.24\";\n"]}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,yBAAyB;AACzB,MAAM,CAAC,MAAM,OAAO,GAAG,eAAe,CAAC","sourcesContent":["// This file is autogenerated by inject-version.ts. Any changes will be\n// overwritten on commit!\nexport const VERSION = \"5.0.0-beta.26\";\n"]}

package/dist/types/actions/sendCalls.d.ts

@@ -33,8 +33,11 @@ export type SendCallsResult = Prettify<SendPreparedCallsResult>;
  *   }
  * });
  *
- * // The result contains the call ID
- * console.log(result.id);
+ * // Wait for the calls to be mined and confirmed.
+ * // Polls getCallsStatus until the bundle succeeds, fails, or times out (default 60s).
+ * // See: https://viem.sh/docs/actions/wallet/waitForCallsStatus
+ * const status = await client.waitForCallsStatus({ id: result.id });
+ * console.log(status.status); // "success" | "failure"
  * ```
  * <Note>
  * If using this action with an ERC-20 paymaster in pre-operation mode with `autoPermit`, the contents of the permit will be hidden

package/dist/types/actions/sendCalls.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sendCalls.d.ts","sourceRoot":"","sources":["../../../src/actions/sendCalls.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAC5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAgB,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE1E,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,wBAAwB,CAAC;AAKhC,MAAM,MAAM,eAAe,GAAG,QAAQ,CACpC,gBAAgB,CAAC,kBAAkB,EAAE,SAAS,CAAC,GAAG;IAChD,KAAK,CAAC,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;CAC3B,CACF,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC,uBAAuB,CAAC,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,oBAAoB,EAC5B,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,eAAe,CAAC,CA2C1B"}
+{"version":3,"file":"sendCalls.d.ts","sourceRoot":"","sources":["../../../src/actions/sendCalls.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAC5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAgB,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE1E,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,wBAAwB,CAAC;AAKhC,MAAM,MAAM,eAAe,GAAG,QAAQ,CACpC,gBAAgB,CAAC,kBAAkB,EAAE,SAAS,CAAC,GAAG;IAChD,KAAK,CAAC,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;CAC3B,CACF,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC,uBAAuB,CAAC,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,oBAAoB,EAC5B,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,eAAe,CAAC,CA2C1B"}

package/dist/types/experimental/actions/requestQuoteV0.d.ts

@@ -6,6 +6,9 @@ import { wallet_requestQuote_v0 as MethodSchema } from "@alchemy/wallet-api-type
 import { type MethodParams, type MethodResponse } from "../../utils/schema.js";
 type BaseRequestQuoteV0Params = MethodParams<typeof MethodSchema>;
 type RequestQuoteV0Response = MethodResponse<typeof MethodSchema>;
+/**
+ * Parameters accepted by the experimental `requestQuoteV0` action.
+ */
 export type RequestQuoteV0Params = Prettify<WithCapabilities<DistributiveOmit<BaseRequestQuoteV0Params, "from" | "chainId"> & {
     account?: AccountParam;
     chainId?: number;
@@ -17,6 +20,9 @@ type ClientModifiedRequest = Prettify<Omit<Extract<RequestQuoteV0Response, {
     account: Address;
     capabilities?: PrepareCallsCapabilities;
 }>;
+/**
+ * Result returned by the experimental `requestQuoteV0` action.
+ */
 export type RequestQuoteV0Result = Exclude<RequestQuoteV0Response, {
     type: "paymaster-permit";
 }> | (Omit<Extract<RequestQuoteV0Response, {
@@ -32,13 +38,15 @@ export type RequestQuoteV0Result = Exclude<RequestQuoteV0Response, {
  * @param {RequestQuoteV0Params} params - Parameters for requesting a swap quote
  * @param {Address} params.fromToken - The address of the token to swap from
  * @param {Address} params.toToken - The address of the token to swap to
- * @param {Hex} [params.fromAmount] - The amount to swap from (mutually exclusive with minimumToAmount)
- * @param {Hex} [params.minimumToAmount] - The minimum amount to receive (mutually exclusive with fromAmount)
+ * @param {bigint} [params.fromAmount] - The amount to swap from (mutually exclusive with minimumToAmount)
+ * @param {bigint} [params.minimumToAmount] - The minimum amount to receive (mutually exclusive with fromAmount)
  * @param {AccountParam} [params.account] - The account to execute the swap from. Can be an address string or an object with an `address` property. Defaults to the client's account (signer address via EIP-7702).
- * @param {Hex} [params.slippage] - The maximum acceptable slippage percentage
+ * @param {number} [params.chainId] - The source chain ID. Defaults to the wallet client's chain.
+ * @param {number} [params.toChainId] - The destination chain ID for cross-chain swaps. Omit for same-chain swaps.
+ * @param {bigint} [params.slippage] - The maximum acceptable slippage in basis points.
  * @param {boolean} [params.returnRawCalls] - Whether to return raw calls for EOA wallets (defaults to false for smart wallets)
  * @param {object} [params.capabilities] - Optional capabilities to include with the request (only available when returnRawCalls is false)
- * @param {Array<{to: Address, data?: Hex, value?: Hex}>} [params.postCalls] - Optional calls to execute after the swap
+ * @param {Array<{ to: Address; data?: Hex; value?: bigint }>} [params.postCalls] - Optional calls to execute after the swap
  * @returns {Promise<RequestQuoteV0Result>} A Promise that resolves to either prepared calls or raw calls depending on returnRawCalls
  *
  * @example
@@ -48,6 +56,7 @@ export type RequestQuoteV0Result = Exclude<RequestQuoteV0Response, {
  *   fromToken: "0xA0b86a33E6441e1d6a8E8C7a8E8E8E8E8E8E8E8E",
  *   toToken: "0xB0b86a33E6441e1d6a8E8C7a8E8E8E8E8E8E8E8E",
  *   fromAmount: 1000000000000000000n, // 1 ETH
+ *   chainId: 42161, // Arbitrum
  *   capabilities: {
  *     paymaster: { policyId: "your-policy-id" }
  *   }
@@ -58,6 +67,7 @@ export type RequestQuoteV0Result = Exclude<RequestQuoteV0Response, {
  *   fromToken: "0xA0b86a33E6441e1d6a8E8C7a8E8E8E8E8E8E8E8E",
  *   toToken: "0xB0b86a33E6441e1d6a8E8C7a8E8E8E8E8E8E8E8E",
  *   fromAmount: 1000000000000000000n,
+ *   chainId: 42161,
  *   returnRawCalls: true
  * });
  * ```

package/dist/types/experimental/actions/requestQuoteV0.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"requestQuoteV0.d.ts","sourceRoot":"","sources":["../../../../src/experimental/actions/requestQuoteV0.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAIL,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EACtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,EAAE,sBAAsB,IAAI,YAAY,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAG/B,KAAK,wBAAwB,GAAG,YAAY,CAAC,OAAO,YAAY,CAAC,CAAC;AAClE,KAAK,sBAAsB,GAAG,cAAc,CAAC,OAAO,YAAY,CAAC,CAAC;AAElE,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CACzC,gBAAgB,CACd,gBAAgB,CAAC,wBAAwB,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG;IAC/D,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CACF,CACF,CAAC;AAEF,2FAA2F;AAC3F,KAAK,qBAAqB,GAAG,QAAQ,CACnC,IAAI,CACF,OAAO,CACL,sBAAsB,EACtB;IAAE,IAAI,EAAE,kBAAkB,CAAA;CAAE,CAC7B,CAAC,iBAAiB,CAAC,EACpB,MAAM,GAAG,cAAc,CACxB,GAAG;IACF,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,wBAAwB,CAAC;CACzC,CACF,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAC5B,OAAO,CAAC,sBAAsB,EAAE;IAAE,IAAI,EAAE,kBAAkB,CAAA;CAAE,CAAC,GAC7D,CAAC,IAAI,CACH,OAAO,CAAC,sBAAsB,EAAE;IAAE,IAAI,EAAE,kBAAkB,CAAA;CAAE,CAAC,EAC7D,iBAAiB,CAClB,GAAG;IACF,eAAe,EAAE,qBAAqB,CAAC;CACxC,CAAC,CAAC;AAEP;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,oBAAoB,EAC5B,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,oBAAoB,CAAC,CA6C/B"}
+{"version":3,"file":"requestQuoteV0.d.ts","sourceRoot":"","sources":["../../../../src/experimental/actions/requestQuoteV0.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAIL,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EACtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,EAAE,sBAAsB,IAAI,YAAY,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAG/B,KAAK,wBAAwB,GAAG,YAAY,CAAC,OAAO,YAAY,CAAC,CAAC;AAClE,KAAK,sBAAsB,GAAG,cAAc,CAAC,OAAO,YAAY,CAAC,CAAC;AAElE;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CACzC,gBAAgB,CACd,gBAAgB,CAAC,wBAAwB,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG;IAC/D,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CACF,CACF,CAAC;AAEF,2FAA2F;AAC3F,KAAK,qBAAqB,GAAG,QAAQ,CACnC,IAAI,CACF,OAAO,CACL,sBAAsB,EACtB;IAAE,IAAI,EAAE,kBAAkB,CAAA;CAAE,CAC7B,CAAC,iBAAiB,CAAC,EACpB,MAAM,GAAG,cAAc,CACxB,GAAG;IACF,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,wBAAwB,CAAC;CACzC,CACF,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC5B,OAAO,CAAC,sBAAsB,EAAE;IAAE,IAAI,EAAE,kBAAkB,CAAA;CAAE,CAAC,GAC7D,CAAC,IAAI,CACH,OAAO,CAAC,sBAAsB,EAAE;IAAE,IAAI,EAAE,kBAAkB,CAAA;CAAE,CAAC,EAC7D,iBAAiB,CAClB,GAAG;IACF,eAAe,EAAE,qBAAqB,CAAC;CACxC,CAAC,CAAC;AAEP;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,oBAAoB,EAC5B,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,oBAAoB,CAAC,CA6C/B"}

package/dist/types/experimental/swapActionsDecorator.d.ts

@@ -1,5 +1,8 @@
 import { type RequestQuoteV0Params, type RequestQuoteV0Result } from "./actions/requestQuoteV0.js";
 import type { BaseWalletClient } from "../types.js";
+/**
+ * Experimental swap actions for wallet API clients.
+ */
 export type SwapActions = {
     requestQuoteV0: (params: RequestQuoteV0Params) => Promise<RequestQuoteV0Result>;
 };

package/dist/types/experimental/swapActionsDecorator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"swapActionsDecorator.d.ts","sourceRoot":"","sources":["../../../src/experimental/swapActionsDecorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EAC1B,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,gBAAgB,EAAwB,MAAM,aAAa,CAAC;AAE1E,MAAM,MAAM,WAAW,GAAG;IACxB,cAAc,EAAE,CACd,MAAM,EAAE,oBAAoB,KACzB,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACpC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,WAAW,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,WASvD,CAAC"}
+{"version":3,"file":"swapActionsDecorator.d.ts","sourceRoot":"","sources":["../../../src/experimental/swapActionsDecorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EAC1B,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,gBAAgB,EAAwB,MAAM,aAAa,CAAC;AAE1E;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,cAAc,EAAE,CACd,MAAM,EAAE,oBAAoB,KACzB,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACpC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,WAAW,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,WASvD,CAAC"}

package/dist/types/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "5.0.0-beta.24";
+export declare const VERSION = "5.0.0-beta.26";
 //# sourceMappingURL=version.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alchemy/wallet-apis",
-  "version": "5.0.0-beta.25",
+  "version": "5.0.0-beta.27",
   "description": "Alchemy Wallet APIs",
   "author": "Alchemy",
   "license": "MIT",
@@ -55,8 +55,8 @@
     "viem": "^2.45.0"
   },
   "dependencies": {
-    "@alchemy/common": "5.0.0-beta.25",
-    "@alchemy/wallet-api-types": "^0.1.0-alpha.27",
+    "@alchemy/common": "5.0.0-beta.27",
+    "@alchemy/wallet-api-types": "0.1.0-alpha.27",
     "deep-equal": "^2.2.3",
     "ox": "^0.11.1",
     "typebox": "^1.0.81"
@@ -76,5 +76,5 @@
     "url": "https://github.com/alchemyplatform/aa-sdk/issues"
   },
   "homepage": "https://github.com/alchemyplatform/aa-sdk#readme",
-  "gitHead": "0eb4e1f1d586317a5f2c189e2ddef139d7348412"
+  "gitHead": "890706a0df785e32c2dc139d31f247d49d7780c7"
 }

package/src/actions/sendCalls.ts

@@ -45,8 +45,11 @@ export type SendCallsResult = Prettify<SendPreparedCallsResult>;
  *   }
  * });
  *
- * // The result contains the call ID
- * console.log(result.id);
+ * // Wait for the calls to be mined and confirmed.
+ * // Polls getCallsStatus until the bundle succeeds, fails, or times out (default 60s).
+ * // See: https://viem.sh/docs/actions/wallet/waitForCallsStatus
+ * const status = await client.waitForCallsStatus({ id: result.id });
+ * console.log(status.status); // "success" | "failure"
  * ```
  * <Note>
  * If using this action with an ERC-20 paymaster in pre-operation mode with `autoPermit`, the contents of the permit will be hidden

package/src/experimental/actions/requestQuoteV0.ts

@@ -21,6 +21,9 @@ const schema = methodSchema(MethodSchema);
 type BaseRequestQuoteV0Params = MethodParams<typeof MethodSchema>;
 type RequestQuoteV0Response = MethodResponse<typeof MethodSchema>;
 
+/**
+ * Parameters accepted by the experimental `requestQuoteV0` action.
+ */
 export type RequestQuoteV0Params = Prettify<
   WithCapabilities<
     DistributiveOmit<BaseRequestQuoteV0Params, "from" | "chainId"> & {
@@ -44,6 +47,9 @@ type ClientModifiedRequest = Prettify<
   }
 >;
 
+/**
+ * Result returned by the experimental `requestQuoteV0` action.
+ */
 export type RequestQuoteV0Result =
   | Exclude<RequestQuoteV0Response, { type: "paymaster-permit" }>
   | (Omit<
@@ -61,13 +67,15 @@ export type RequestQuoteV0Result =
  * @param {RequestQuoteV0Params} params - Parameters for requesting a swap quote
  * @param {Address} params.fromToken - The address of the token to swap from
  * @param {Address} params.toToken - The address of the token to swap to
- * @param {Hex} [params.fromAmount] - The amount to swap from (mutually exclusive with minimumToAmount)
- * @param {Hex} [params.minimumToAmount] - The minimum amount to receive (mutually exclusive with fromAmount)
+ * @param {bigint} [params.fromAmount] - The amount to swap from (mutually exclusive with minimumToAmount)
+ * @param {bigint} [params.minimumToAmount] - The minimum amount to receive (mutually exclusive with fromAmount)
  * @param {AccountParam} [params.account] - The account to execute the swap from. Can be an address string or an object with an `address` property. Defaults to the client's account (signer address via EIP-7702).
- * @param {Hex} [params.slippage] - The maximum acceptable slippage percentage
+ * @param {number} [params.chainId] - The source chain ID. Defaults to the wallet client's chain.
+ * @param {number} [params.toChainId] - The destination chain ID for cross-chain swaps. Omit for same-chain swaps.
+ * @param {bigint} [params.slippage] - The maximum acceptable slippage in basis points.
  * @param {boolean} [params.returnRawCalls] - Whether to return raw calls for EOA wallets (defaults to false for smart wallets)
  * @param {object} [params.capabilities] - Optional capabilities to include with the request (only available when returnRawCalls is false)
- * @param {Array<{to: Address, data?: Hex, value?: Hex}>} [params.postCalls] - Optional calls to execute after the swap
+ * @param {Array<{ to: Address; data?: Hex; value?: bigint }>} [params.postCalls] - Optional calls to execute after the swap
  * @returns {Promise<RequestQuoteV0Result>} A Promise that resolves to either prepared calls or raw calls depending on returnRawCalls
  *
  * @example
@@ -77,6 +85,7 @@ export type RequestQuoteV0Result =
  *   fromToken: "0xA0b86a33E6441e1d6a8E8C7a8E8E8E8E8E8E8E8E",
  *   toToken: "0xB0b86a33E6441e1d6a8E8C7a8E8E8E8E8E8E8E8E",
  *   fromAmount: 1000000000000000000n, // 1 ETH
+ *   chainId: 42161, // Arbitrum
  *   capabilities: {
  *     paymaster: { policyId: "your-policy-id" }
  *   }
@@ -87,6 +96,7 @@ export type RequestQuoteV0Result =
  *   fromToken: "0xA0b86a33E6441e1d6a8E8C7a8E8E8E8E8E8E8E8E",
  *   toToken: "0xB0b86a33E6441e1d6a8E8C7a8E8E8E8E8E8E8E8E",
  *   fromAmount: 1000000000000000000n,
+ *   chainId: 42161,
  *   returnRawCalls: true
  * });
  * ```

package/src/experimental/swapActionsDecorator.ts

@@ -5,6 +5,9 @@ import {
 } from "./actions/requestQuoteV0.js";
 import type { BaseWalletClient, InnerWalletApiClient } from "../types.js";
 
+/**
+ * Experimental swap actions for wallet API clients.
+ */
 export type SwapActions = {
   requestQuoteV0: (
     params: RequestQuoteV0Params,

package/src/version.ts

@@ -1,3 +1,3 @@
 // This file is autogenerated by inject-version.ts. Any changes will be
 // overwritten on commit!
-export const VERSION = "5.0.0-beta.25";
+export const VERSION = "5.0.0-beta.27";