@alchemy/wallet-apis 5.0.0-beta.3 → 5.0.0-beta.31

package/dist/esm/actions/solana/prepareCalls.js

@@ -0,0 +1,70 @@
+import { isSolanaChain } from "../../utils/assertions.js";
+import { SolanaPrepareCallsParams as SolanaPrepareCallsSchema } from "@alchemy/wallet-api-types";
+import { wallet_prepareCalls as MethodSchema } from "@alchemy/wallet-api-types/rpc";
+import { BaseError } from "@alchemy/common";
+import { LOGGER } from "../../logger.js";
+import { mergeSolanaClientCapabilities, } from "../../utils/capabilities.js";
+import { methodSchema, encode, decode, } from "../../utils/schema.js";
+const schema = methodSchema(MethodSchema);
+function isSolanaResponse(response) {
+    return response.type === "solana-transaction-v0";
+}
+/**
+ * Prepares Solana instructions for execution by building a versioned transaction.
+ * Returns the compiled transaction and a signature request that needs to be signed
+ * before submitting to sendPreparedCalls.
+ *
+ * @param {InnerSolanaWalletApiClient} client - The Solana wallet API client
+ * @param {SolanaPrepareCallsParams} params - Parameters for preparing Solana calls
+ * @param {Array<{programId: string, accounts?: Array, data: Hex}>} params.calls - Array of Solana instructions
+ * @param {string} [params.account] - The Solana address to execute from. Defaults to the signer's address.
+ * @param {SolanaChainId} [params.chainId] - The Solana chain ID. Defaults to the client's chain.
+ * @param {object} [params.capabilities] - Optional capabilities (e.g. paymaster sponsorship)
+ * @returns {Promise<SolanaPrepareCallsResult>} The prepared Solana transaction with signature request
+ *
+ * @example
+ * ```ts
+ * const result = await client.prepareCalls({
+ *   calls: [{
+ *     programId: "11111111111111111111111111111111",
+ *     data: "0x...",
+ *   }],
+ *   capabilities: {
+ *     paymaster: { policyId: "your-policy-id" }
+ *   }
+ * });
+ * ```
+ */
+export async function prepareCalls(client, params) {
+    const { account, chainId, capabilities: caps, ...rest } = params;
+    const from = account ?? client.solanaAccount;
+    if (!isSolanaChain(client.chain)) {
+        throw new BaseError("Expected a Solana chain on the client");
+    }
+    const resolvedChainId = chainId ?? client.chain.solanaChainId;
+    const merged = mergeSolanaClientCapabilities(client, caps);
+    const capabilities = merged?.paymaster
+        ? { paymasterService: merged.paymaster }
+        : undefined;
+    LOGGER.debug("solana:prepareCalls:start", {
+        callsCount: params.calls?.length,
+        hasCapabilities: !!caps,
+    });
+    const rpcParams = encode(SolanaPrepareCallsSchema, {
+        ...rest,
+        chainId: resolvedChainId,
+        from,
+        capabilities,
+    });
+    const rpcResp = await client.request({
+        method: "wallet_prepareCalls",
+        params: [rpcParams],
+    });
+    LOGGER.debug("solana:prepareCalls:done");
+    const decoded = decode(schema.response, rpcResp);
+    if (!isSolanaResponse(decoded)) {
+        throw new BaseError(`Unexpected EVM response from Solana prepareCalls: ${decoded.type}`);
+    }
+    return decoded;
+}
+//# sourceMappingURL=prepareCalls.js.map

package/dist/esm/actions/solana/prepareCalls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepareCalls.js","sourceRoot":"","sources":["../../../../src/actions/solana/prepareCalls.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1D,OAAO,EAAE,wBAAwB,IAAI,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACjG,OAAO,EAAE,mBAAmB,IAAI,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAEpF,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EACL,6BAA6B,GAE9B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,YAAY,EACZ,MAAM,EACN,MAAM,GAEP,MAAM,uBAAuB,CAAC;AAE/B,MAAM,MAAM,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;AAmB1C,SAAS,gBAAgB,CACvB,QAA8B;IAE9B,OAAO,QAAQ,CAAC,IAAI,KAAK,uBAAuB,CAAC;AACnD,CAAC;AAID;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAkC,EAClC,MAAgC;IAEhC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;IACjE,MAAM,IAAI,GAAG,OAAO,IAAI,MAAM,CAAC,aAAa,CAAC;IAC7C,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,SAAS,CAAC,uCAAuC,CAAC,CAAC;IAC/D,CAAC;IACD,MAAM,eAAe,GAAG,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC;IAE9D,MAAM,MAAM,GAAG,6BAA6B,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC3D,MAAM,YAAY,GAAG,MAAM,EAAE,SAAS;QACpC,CAAC,CAAC,EAAE,gBAAgB,EAAE,MAAM,CAAC,SAAS,EAAE;QACxC,CAAC,CAAC,SAAS,CAAC;IAEd,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE;QACxC,UAAU,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM;QAChC,eAAe,EAAE,CAAC,CAAC,IAAI;KACxB,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,MAAM,CAAC,wBAAwB,EAAE;QACjD,GAAG,IAAI;QACP,OAAO,EAAE,eAAe;QACxB,IAAI;QACJ,YAAY;KACb,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;QACnC,MAAM,EAAE,qBAAqB;QAC7B,MAAM,EAAE,CAAC,SAAS,CAAC;KACpB,CAAC,CAAC;IAEH,MAAM,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAEjD,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,SAAS,CACjB,qDAAqD,OAAO,CAAC,IAAI,EAAE,CACpE,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["import type { Prettify } from \"viem\";\nimport type {\n  DistributiveOmit,\n  InnerSolanaWalletApiClient,\n} from \"../../types.js\";\nimport { isSolanaChain } from \"../../utils/assertions.js\";\nimport type { SolanaChainId } from \"@alchemy/wallet-api-types\";\nimport { SolanaPrepareCallsParams as SolanaPrepareCallsSchema } from \"@alchemy/wallet-api-types\";\nimport { wallet_prepareCalls as MethodSchema } from \"@alchemy/wallet-api-types/rpc\";\nimport type { z } from \"zod\";\nimport { BaseError } from \"@alchemy/common\";\nimport { LOGGER } from \"../../logger.js\";\nimport {\n  mergeSolanaClientCapabilities,\n  type WithCapabilities,\n} from \"../../utils/capabilities.js\";\nimport {\n  methodSchema,\n  encode,\n  decode,\n  type MethodResponse,\n} from \"../../utils/schema.js\";\n\nconst schema = methodSchema(MethodSchema);\ntype PrepareCallsResponse = MethodResponse<typeof MethodSchema>;\n\ntype BaseSolanaPrepareCallsParams = z.output<typeof SolanaPrepareCallsSchema>;\n\nexport type SolanaPrepareCallsParams = Prettify<\n  WithCapabilities<\n    DistributiveOmit<BaseSolanaPrepareCallsParams, \"from\" | \"chainId\"> & {\n      account?: string;\n      chainId?: SolanaChainId;\n    }\n  >\n>;\n\ntype SolanaPrepareCallsResponse = Extract<\n  PrepareCallsResponse,\n  { type: \"solana-transaction-v0\" }\n>;\n\nfunction isSolanaResponse(\n  response: PrepareCallsResponse,\n): response is SolanaPrepareCallsResponse {\n  return response.type === \"solana-transaction-v0\";\n}\n\nexport type SolanaPrepareCallsResult = SolanaPrepareCallsResponse;\n\n/**\n * Prepares Solana instructions for execution by building a versioned transaction.\n * Returns the compiled transaction and a signature request that needs to be signed\n * before submitting to sendPreparedCalls.\n *\n * @param {InnerSolanaWalletApiClient} client - The Solana wallet API client\n * @param {SolanaPrepareCallsParams} params - Parameters for preparing Solana calls\n * @param {Array<{programId: string, accounts?: Array, data: Hex}>} params.calls - Array of Solana instructions\n * @param {string} [params.account] - The Solana address to execute from. Defaults to the signer's address.\n * @param {SolanaChainId} [params.chainId] - The Solana chain ID. Defaults to the client's chain.\n * @param {object} [params.capabilities] - Optional capabilities (e.g. paymaster sponsorship)\n * @returns {Promise<SolanaPrepareCallsResult>} The prepared Solana transaction with signature request\n *\n * @example\n * ```ts\n * const result = await client.prepareCalls({\n *   calls: [{\n *     programId: \"11111111111111111111111111111111\",\n *     data: \"0x...\",\n *   }],\n *   capabilities: {\n *     paymaster: { policyId: \"your-policy-id\" }\n *   }\n * });\n * ```\n */\nexport async function prepareCalls(\n  client: InnerSolanaWalletApiClient,\n  params: SolanaPrepareCallsParams,\n): Promise<SolanaPrepareCallsResult> {\n  const { account, chainId, capabilities: caps, ...rest } = params;\n  const from = account ?? client.solanaAccount;\n  if (!isSolanaChain(client.chain)) {\n    throw new BaseError(\"Expected a Solana chain on the client\");\n  }\n  const resolvedChainId = chainId ?? client.chain.solanaChainId;\n\n  const merged = mergeSolanaClientCapabilities(client, caps);\n  const capabilities = merged?.paymaster\n    ? { paymasterService: merged.paymaster }\n    : undefined;\n\n  LOGGER.debug(\"solana:prepareCalls:start\", {\n    callsCount: params.calls?.length,\n    hasCapabilities: !!caps,\n  });\n\n  const rpcParams = encode(SolanaPrepareCallsSchema, {\n    ...rest,\n    chainId: resolvedChainId,\n    from,\n    capabilities,\n  });\n\n  const rpcResp = await client.request({\n    method: \"wallet_prepareCalls\",\n    params: [rpcParams],\n  });\n\n  LOGGER.debug(\"solana:prepareCalls:done\");\n  const decoded = decode(schema.response, rpcResp);\n\n  if (!isSolanaResponse(decoded)) {\n    throw new BaseError(\n      `Unexpected EVM response from Solana prepareCalls: ${decoded.type}`,\n    );\n  }\n\n  return decoded;\n}\n"]}

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

@@ -0,0 +1,34 @@
+import type { Prettify } from "viem";
+import type { DistributiveOmit, InnerSolanaWalletApiClient } from "../../types.js";
+import type { SolanaChainId } from "@alchemy/wallet-api-types";
+import { type SolanaPrepareCallsParams } from "./prepareCalls.js";
+import { type SolanaSendPreparedCallsResult } from "./sendPreparedCalls.js";
+export type SolanaSendCallsParams = Prettify<DistributiveOmit<SolanaPrepareCallsParams, "chainId"> & {
+    chainId?: SolanaChainId;
+}>;
+export type SolanaSendCallsResult = Prettify<SolanaSendPreparedCallsResult>;
+/**
+ * Prepares, signs, and submits Solana instructions in a single call.
+ * Internally calls `prepareCalls`, `signPreparedCalls`, and `sendPreparedCalls`.
+ *
+ * @param {InnerSolanaWalletApiClient} client - The Solana wallet API client
+ * @param {SolanaSendCallsParams} params - Parameters for sending Solana calls
+ * @param {Array<{programId: string, accounts?: Array, data: Hex}>} params.calls - Array of Solana instructions
+ * @param {string} [params.account] - The Solana address to execute from. Defaults to the signer's address.
+ * @param {object} [params.capabilities] - Optional capabilities (e.g. paymaster sponsorship)
+ * @returns {Promise<SolanaSendCallsResult>} The result containing the call ID
+ *
+ * @example
+ * ```ts
+ * const result = await client.sendCalls({
+ *   calls: [{
+ *     programId: "11111111111111111111111111111111",
+ *     data: "0x...",
+ *   }],
+ *   capabilities: {
+ *     paymaster: { policyId: "your-policy-id" }
+ *   }
+ * });
+ * ```
+ */
+export declare function sendCalls(client: InnerSolanaWalletApiClient, params: SolanaSendCallsParams): Promise<SolanaSendCallsResult>;

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

@@ -0,0 +1,44 @@
+import { prepareCalls } from "./prepareCalls.js";
+import { signPreparedCalls } from "./signPreparedCalls.js";
+import { sendPreparedCalls, } from "./sendPreparedCalls.js";
+import { LOGGER } from "../../logger.js";
+/**
+ * Prepares, signs, and submits Solana instructions in a single call.
+ * Internally calls `prepareCalls`, `signPreparedCalls`, and `sendPreparedCalls`.
+ *
+ * @param {InnerSolanaWalletApiClient} client - The Solana wallet API client
+ * @param {SolanaSendCallsParams} params - Parameters for sending Solana calls
+ * @param {Array<{programId: string, accounts?: Array, data: Hex}>} params.calls - Array of Solana instructions
+ * @param {string} [params.account] - The Solana address to execute from. Defaults to the signer's address.
+ * @param {object} [params.capabilities] - Optional capabilities (e.g. paymaster sponsorship)
+ * @returns {Promise<SolanaSendCallsResult>} The result containing the call ID
+ *
+ * @example
+ * ```ts
+ * const result = await client.sendCalls({
+ *   calls: [{
+ *     programId: "11111111111111111111111111111111",
+ *     data: "0x...",
+ *   }],
+ *   capabilities: {
+ *     paymaster: { policyId: "your-policy-id" }
+ *   }
+ * });
+ * ```
+ */
+export async function sendCalls(client, params) {
+    LOGGER.info("solana:sendCalls:start", {
+        calls: params.calls?.length,
+        hasCapabilities: !!params.capabilities,
+    });
+    const { chainId, ...rest } = params;
+    const prepared = await prepareCalls(client, {
+        ...rest,
+        ...(chainId != null ? { chainId } : {}),
+    });
+    const signed = await signPreparedCalls(client, prepared);
+    const res = await sendPreparedCalls(client, signed);
+    LOGGER.info("solana:sendCalls:done");
+    return res;
+}
+//# sourceMappingURL=sendCalls.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sendCalls.js","sourceRoot":"","sources":["../../../../src/actions/solana/sendCalls.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,YAAY,EAAiC,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EACL,iBAAiB,GAElB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAUzC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAAkC,EAClC,MAA6B;IAE7B,MAAM,CAAC,IAAI,CAAC,wBAAwB,EAAE;QACpC,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM;QAC3B,eAAe,EAAE,CAAC,CAAC,MAAM,CAAC,YAAY;KACvC,CAAC,CAAC;IAEH,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;IACpC,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE;QAC1C,GAAG,IAAI;QACP,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACzD,MAAM,GAAG,GAAG,MAAM,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpD,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACrC,OAAO,GAAG,CAAC;AACb,CAAC","sourcesContent":["import type { Prettify } from \"viem\";\nimport type {\n  DistributiveOmit,\n  InnerSolanaWalletApiClient,\n} from \"../../types.js\";\nimport type { SolanaChainId } from \"@alchemy/wallet-api-types\";\nimport { prepareCalls, type SolanaPrepareCallsParams } from \"./prepareCalls.js\";\nimport { signPreparedCalls } from \"./signPreparedCalls.js\";\nimport {\n  sendPreparedCalls,\n  type SolanaSendPreparedCallsResult,\n} from \"./sendPreparedCalls.js\";\nimport { LOGGER } from \"../../logger.js\";\n\nexport type SolanaSendCallsParams = Prettify<\n  DistributiveOmit<SolanaPrepareCallsParams, \"chainId\"> & {\n    chainId?: SolanaChainId;\n  }\n>;\n\nexport type SolanaSendCallsResult = Prettify<SolanaSendPreparedCallsResult>;\n\n/**\n * Prepares, signs, and submits Solana instructions in a single call.\n * Internally calls `prepareCalls`, `signPreparedCalls`, and `sendPreparedCalls`.\n *\n * @param {InnerSolanaWalletApiClient} client - The Solana wallet API client\n * @param {SolanaSendCallsParams} params - Parameters for sending Solana calls\n * @param {Array<{programId: string, accounts?: Array, data: Hex}>} params.calls - Array of Solana instructions\n * @param {string} [params.account] - The Solana address to execute from. Defaults to the signer's address.\n * @param {object} [params.capabilities] - Optional capabilities (e.g. paymaster sponsorship)\n * @returns {Promise<SolanaSendCallsResult>} The result containing the call ID\n *\n * @example\n * ```ts\n * const result = await client.sendCalls({\n *   calls: [{\n *     programId: \"11111111111111111111111111111111\",\n *     data: \"0x...\",\n *   }],\n *   capabilities: {\n *     paymaster: { policyId: \"your-policy-id\" }\n *   }\n * });\n * ```\n */\nexport async function sendCalls(\n  client: InnerSolanaWalletApiClient,\n  params: SolanaSendCallsParams,\n): Promise<SolanaSendCallsResult> {\n  LOGGER.info(\"solana:sendCalls:start\", {\n    calls: params.calls?.length,\n    hasCapabilities: !!params.capabilities,\n  });\n\n  const { chainId, ...rest } = params;\n  const prepared = await prepareCalls(client, {\n    ...rest,\n    ...(chainId != null ? { chainId } : {}),\n  });\n\n  const signed = await signPreparedCalls(client, prepared);\n  const res = await sendPreparedCalls(client, signed);\n  LOGGER.info(\"solana:sendCalls:done\");\n  return res;\n}\n"]}

package/dist/esm/actions/solana/sendPreparedCalls.d.ts

@@ -0,0 +1,24 @@
+import type { Prettify } from "viem";
+import type { InnerSolanaWalletApiClient } from "../../types.js";
+import { PreparedCall_SolanaV0_Signed as PreparedCall_SolanaV0_SignedSchema } from "@alchemy/wallet-api-types";
+import type { z } from "zod";
+import { wallet_sendPreparedCalls as MethodSchema } from "@alchemy/wallet-api-types/rpc";
+import { type MethodResponse } from "../../utils/schema.js";
+type SendPreparedCallsResponse = MethodResponse<typeof MethodSchema>;
+export type SolanaSendPreparedCallsParams = Prettify<z.output<typeof PreparedCall_SolanaV0_SignedSchema>>;
+type SolanaSendPreparedCallsResponse = Extract<SendPreparedCallsResponse, {
+    details: {
+        type: "solana-transaction-v0";
+    };
+}>;
+export type SolanaSendPreparedCallsResult = SolanaSendPreparedCallsResponse;
+/**
+ * Sends a signed Solana transaction.
+ * This method is used after signing the signature request returned from prepareCalls.
+ *
+ * @param {InnerSolanaWalletApiClient} client - The Solana wallet API client
+ * @param {SolanaSendPreparedCallsParams} params - The signed Solana transaction
+ * @returns {Promise<SolanaSendPreparedCallsResult>} The result containing the call ID
+ */
+export declare function sendPreparedCalls(client: InnerSolanaWalletApiClient, params: SolanaSendPreparedCallsParams): Promise<SolanaSendPreparedCallsResult>;
+export {};

package/dist/esm/actions/solana/sendPreparedCalls.js

@@ -0,0 +1,32 @@
+import { PreparedCall_SolanaV0_Signed as PreparedCall_SolanaV0_SignedSchema } from "@alchemy/wallet-api-types";
+import { BaseError } from "@alchemy/common";
+import { LOGGER } from "../../logger.js";
+import { wallet_sendPreparedCalls as MethodSchema } from "@alchemy/wallet-api-types/rpc";
+import { methodSchema, encode, decode, } from "../../utils/schema.js";
+const schema = methodSchema(MethodSchema);
+function isSolanaResponse(response) {
+    return response.details.type === "solana-transaction-v0";
+}
+/**
+ * Sends a signed Solana transaction.
+ * This method is used after signing the signature request returned from prepareCalls.
+ *
+ * @param {InnerSolanaWalletApiClient} client - The Solana wallet API client
+ * @param {SolanaSendPreparedCallsParams} params - The signed Solana transaction
+ * @returns {Promise<SolanaSendPreparedCallsResult>} The result containing the call ID
+ */
+export async function sendPreparedCalls(client, params) {
+    LOGGER.debug("solana:sendPreparedCalls:start", { type: params.type });
+    const rpcParams = encode(PreparedCall_SolanaV0_SignedSchema, params);
+    const rpcResp = await client.request({
+        method: "wallet_sendPreparedCalls",
+        params: [rpcParams],
+    });
+    LOGGER.debug("solana:sendPreparedCalls:done");
+    const decoded = decode(schema.response, rpcResp);
+    if (!isSolanaResponse(decoded)) {
+        throw new BaseError(`Unexpected EVM response from Solana sendPreparedCalls: ${decoded.details.type}`);
+    }
+    return decoded;
+}
+//# sourceMappingURL=sendPreparedCalls.js.map

package/dist/esm/actions/solana/sendPreparedCalls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendPreparedCalls.js","sourceRoot":"","sources":["../../../../src/actions/solana/sendPreparedCalls.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,4BAA4B,IAAI,kCAAkC,EAAE,MAAM,2BAA2B,CAAC;AAE/G,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,wBAAwB,IAAI,YAAY,EAAE,MAAM,+BAA+B,CAAC;AACzF,OAAO,EACL,YAAY,EACZ,MAAM,EACN,MAAM,GAEP,MAAM,uBAAuB,CAAC;AAE/B,MAAM,MAAM,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;AAc1C,SAAS,gBAAgB,CACvB,QAAmC;IAEnC,OAAO,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,uBAAuB,CAAC;AAC3D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAkC,EAClC,MAAqC;IAErC,MAAM,CAAC,KAAK,CAAC,gCAAgC,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAEtE,MAAM,SAAS,GAAG,MAAM,CAAC,kCAAkC,EAAE,MAAM,CAAC,CAAC;IACrE,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;QACnC,MAAM,EAAE,0BAA0B;QAClC,MAAM,EAAE,CAAC,SAAS,CAAC;KACpB,CAAC,CAAC;IAEH,MAAM,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAEjD,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,SAAS,CACjB,0DAA0D,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CACjF,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["import type { Prettify } from \"viem\";\nimport type { InnerSolanaWalletApiClient } from \"../../types.js\";\nimport { PreparedCall_SolanaV0_Signed as PreparedCall_SolanaV0_SignedSchema } from \"@alchemy/wallet-api-types\";\nimport type { z } from \"zod\";\nimport { BaseError } from \"@alchemy/common\";\nimport { LOGGER } from \"../../logger.js\";\nimport { wallet_sendPreparedCalls as MethodSchema } from \"@alchemy/wallet-api-types/rpc\";\nimport {\n  methodSchema,\n  encode,\n  decode,\n  type MethodResponse,\n} from \"../../utils/schema.js\";\n\nconst schema = methodSchema(MethodSchema);\ntype SendPreparedCallsResponse = MethodResponse<typeof MethodSchema>;\n\nexport type SolanaSendPreparedCallsParams = Prettify<\n  z.output<typeof PreparedCall_SolanaV0_SignedSchema>\n>;\n\ntype SolanaSendPreparedCallsResponse = Extract<\n  SendPreparedCallsResponse,\n  { details: { type: \"solana-transaction-v0\" } }\n>;\n\nexport type SolanaSendPreparedCallsResult = SolanaSendPreparedCallsResponse;\n\nfunction isSolanaResponse(\n  response: SendPreparedCallsResponse,\n): response is SolanaSendPreparedCallsResult {\n  return response.details.type === \"solana-transaction-v0\";\n}\n\n/**\n * Sends a signed Solana transaction.\n * This method is used after signing the signature request returned from prepareCalls.\n *\n * @param {InnerSolanaWalletApiClient} client - The Solana wallet API client\n * @param {SolanaSendPreparedCallsParams} params - The signed Solana transaction\n * @returns {Promise<SolanaSendPreparedCallsResult>} The result containing the call ID\n */\nexport async function sendPreparedCalls(\n  client: InnerSolanaWalletApiClient,\n  params: SolanaSendPreparedCallsParams,\n): Promise<SolanaSendPreparedCallsResult> {\n  LOGGER.debug(\"solana:sendPreparedCalls:start\", { type: params.type });\n\n  const rpcParams = encode(PreparedCall_SolanaV0_SignedSchema, params);\n  const rpcResp = await client.request({\n    method: \"wallet_sendPreparedCalls\",\n    params: [rpcParams],\n  });\n\n  LOGGER.debug(\"solana:sendPreparedCalls:done\");\n  const decoded = decode(schema.response, rpcResp);\n\n  if (!isSolanaResponse(decoded)) {\n    throw new BaseError(\n      `Unexpected EVM response from Solana sendPreparedCalls: ${decoded.details.type}`,\n    );\n  }\n\n  return decoded;\n}\n"]}

package/dist/esm/actions/solana/signPreparedCalls.d.ts

@@ -0,0 +1,23 @@
+import type { Prettify } from "viem";
+import type { InnerSolanaWalletApiClient } from "../../types.js";
+import { type SolanaSignatureResult } from "./signSignatureRequest.js";
+import type { SolanaPrepareCallsResult } from "./prepareCalls.js";
+export type SolanaSignPreparedCallsParams = Prettify<SolanaPrepareCallsResult>;
+export type SolanaSignPreparedCallsResult = Prettify<Omit<SolanaPrepareCallsResult, "signatureRequest" | "feePayment" | "details"> & {
+    signature: SolanaSignatureResult;
+}>;
+/**
+ * Signs a prepared Solana transaction using the client's Ed25519 signer.
+ *
+ * @param {InnerSolanaWalletApiClient} client - The Solana wallet client
+ * @param {SolanaSignPreparedCallsParams} params - The prepared Solana transaction with signature request
+ * @returns {Promise<SolanaSignPreparedCallsResult>} The signed Solana transaction
+ *
+ * @example
+ * ```ts
+ * const prepared = await client.prepareCalls({ ... });
+ * const signed = await client.signPreparedCalls(prepared);
+ * const result = await client.sendPreparedCalls(signed);
+ * ```
+ */
+export declare function signPreparedCalls(client: InnerSolanaWalletApiClient, params: SolanaSignPreparedCallsParams): Promise<SolanaSignPreparedCallsResult>;

package/dist/esm/actions/solana/signPreparedCalls.js

@@ -0,0 +1,24 @@
+import { signSolanaSignatureRequest, } from "./signSignatureRequest.js";
+import { LOGGER } from "../../logger.js";
+/**
+ * Signs a prepared Solana transaction using the client's Ed25519 signer.
+ *
+ * @param {InnerSolanaWalletApiClient} client - The Solana wallet client
+ * @param {SolanaSignPreparedCallsParams} params - The prepared Solana transaction with signature request
+ * @returns {Promise<SolanaSignPreparedCallsResult>} The signed Solana transaction
+ *
+ * @example
+ * ```ts
+ * const prepared = await client.prepareCalls({ ... });
+ * const signed = await client.signPreparedCalls(prepared);
+ * const result = await client.sendPreparedCalls(signed);
+ * ```
+ */
+export async function signPreparedCalls(client, params) {
+    LOGGER.debug("solana:signPreparedCalls:start");
+    const signature = await signSolanaSignatureRequest(client.owner, params.signatureRequest);
+    const { signatureRequest: _, feePayment: __, details: ___, ...rest } = params;
+    LOGGER.debug("solana:signPreparedCalls:done");
+    return { ...rest, signature };
+}
+//# sourceMappingURL=signPreparedCalls.js.map

package/dist/esm/actions/solana/signPreparedCalls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signPreparedCalls.js","sourceRoot":"","sources":["../../../../src/actions/solana/signPreparedCalls.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,0BAA0B,GAE3B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAazC;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAkC,EAClC,MAAqC;IAErC,MAAM,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;IAE/C,MAAM,SAAS,GAAG,MAAM,0BAA0B,CAChD,MAAM,CAAC,KAAK,EACZ,MAAM,CAAC,gBAAgB,CACxB,CAAC;IAEF,MAAM,EAAE,gBAAgB,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;IAE9E,MAAM,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAC9C,OAAO,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,CAAC;AAChC,CAAC","sourcesContent":["import type { Prettify } from \"viem\";\nimport type { InnerSolanaWalletApiClient } from \"../../types.js\";\nimport {\n  signSolanaSignatureRequest,\n  type SolanaSignatureResult,\n} from \"./signSignatureRequest.js\";\nimport type { SolanaPrepareCallsResult } from \"./prepareCalls.js\";\nimport { LOGGER } from \"../../logger.js\";\n\nexport type SolanaSignPreparedCallsParams = Prettify<SolanaPrepareCallsResult>;\n\nexport type SolanaSignPreparedCallsResult = Prettify<\n  Omit<\n    SolanaPrepareCallsResult,\n    \"signatureRequest\" | \"feePayment\" | \"details\"\n  > & {\n    signature: SolanaSignatureResult;\n  }\n>;\n\n/**\n * Signs a prepared Solana transaction using the client's Ed25519 signer.\n *\n * @param {InnerSolanaWalletApiClient} client - The Solana wallet client\n * @param {SolanaSignPreparedCallsParams} params - The prepared Solana transaction with signature request\n * @returns {Promise<SolanaSignPreparedCallsResult>} The signed Solana transaction\n *\n * @example\n * ```ts\n * const prepared = await client.prepareCalls({ ... });\n * const signed = await client.signPreparedCalls(prepared);\n * const result = await client.sendPreparedCalls(signed);\n * ```\n */\nexport async function signPreparedCalls(\n  client: InnerSolanaWalletApiClient,\n  params: SolanaSignPreparedCallsParams,\n): Promise<SolanaSignPreparedCallsResult> {\n  LOGGER.debug(\"solana:signPreparedCalls:start\");\n\n  const signature = await signSolanaSignatureRequest(\n    client.owner,\n    params.signatureRequest,\n  );\n\n  const { signatureRequest: _, feePayment: __, details: ___, ...rest } = params;\n\n  LOGGER.debug(\"solana:signPreparedCalls:done\");\n  return { ...rest, signature };\n}\n"]}

package/dist/esm/actions/solana/signSignatureRequest.d.ts

@@ -0,0 +1,10 @@
+import type { SolanaSigner } from "../../types.js";
+export type SolanaSignatureRequestParams = {
+    type: "solana_signTransaction";
+    data: `0x${string}`;
+};
+export type SolanaSignatureResult = {
+    type: "ed25519";
+    data: string;
+};
+export declare function signSolanaSignatureRequest(signer: SolanaSigner, signatureRequest: SolanaSignatureRequestParams): Promise<SolanaSignatureResult>;

package/dist/esm/actions/solana/signSignatureRequest.js

@@ -0,0 +1,33 @@
+import { LOGGER } from "../../logger.js";
+import { hexToBytes } from "viem";
+import { Base58 } from "ox";
+import { findSignerSlot } from "../../adapters/resolveSignerSlot.js";
+import { SolanaSignerError } from "../../adapters/SolanaSignerError.js";
+export async function signSolanaSignatureRequest(signer, signatureRequest) {
+    const txBytes = hexToBytes(signatureRequest.data);
+    const slotIndex = await findSignerSlot(txBytes, signer.address);
+    if (slotIndex < 0) {
+        throw new SolanaSignerError(`Signer ${signer.address} is not a required signer in this transaction`);
+    }
+    LOGGER.debug("signSolanaSignatureRequest:signing");
+    const { signedTransaction } = await signer.signTransaction({
+        transaction: txBytes,
+    });
+    if (signedTransaction[0] !== txBytes[0]) {
+        throw new SolanaSignerError(`Signer returned a transaction with a different signature count (expected ${txBytes[0]}, got ${signedTransaction[0]})`);
+    }
+    const offset = 1 + slotIndex * 64;
+    const rawSignature = signedTransaction.slice(offset, offset + 64);
+    if (rawSignature.length !== 64) {
+        throw new SolanaSignerError(`Signed transaction too short to contain signature at slot ${slotIndex}`);
+    }
+    if (rawSignature.every((b) => b === 0)) {
+        throw new SolanaSignerError(`Signer ${signer.address} did not produce a signature at slot ${slotIndex}`);
+    }
+    LOGGER.debug("signSolanaSignatureRequest:ok");
+    return {
+        type: "ed25519",
+        data: Base58.fromBytes(rawSignature),
+    };
+}
+//# sourceMappingURL=signSignatureRequest.js.map

package/dist/esm/actions/solana/signSignatureRequest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signSignatureRequest.js","sourceRoot":"","sources":["../../../../src/actions/solana/signSignatureRequest.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAYxE,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,MAAoB,EACpB,gBAA8C;IAE9C,MAAM,OAAO,GAAG,UAAU,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAElD,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAChE,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QAClB,MAAM,IAAI,iBAAiB,CACzB,UAAU,MAAM,CAAC,OAAO,+CAA+C,CACxE,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;IAEnD,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC;QACzD,WAAW,EAAE,OAAO;KACrB,CAAC,CAAC;IAEH,IAAI,iBAAiB,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,iBAAiB,CACzB,4EAA4E,OAAO,CAAC,CAAC,CAAC,SAAS,iBAAiB,CAAC,CAAC,CAAC,GAAG,CACvH,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,GAAG,SAAS,GAAG,EAAE,CAAC;IAClC,MAAM,YAAY,GAAG,iBAAiB,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,EAAE,CAAC,CAAC;IAElE,IAAI,YAAY,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QAC/B,MAAM,IAAI,iBAAiB,CACzB,6DAA6D,SAAS,EAAE,CACzE,CAAC;IACJ,CAAC;IAED,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,iBAAiB,CACzB,UAAU,MAAM,CAAC,OAAO,wCAAwC,SAAS,EAAE,CAC5E,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAC9C,OAAO;QACL,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC;KACrC,CAAC;AACJ,CAAC","sourcesContent":["import type { SolanaSigner } from \"../../types.js\";\nimport { LOGGER } from \"../../logger.js\";\nimport { hexToBytes } from \"viem\";\nimport { Base58 } from \"ox\";\nimport { findSignerSlot } from \"../../adapters/resolveSignerSlot.js\";\nimport { SolanaSignerError } from \"../../adapters/SolanaSignerError.js\";\n\nexport type SolanaSignatureRequestParams = {\n  type: \"solana_signTransaction\";\n  data: `0x${string}`;\n};\n\nexport type SolanaSignatureResult = {\n  type: \"ed25519\";\n  data: string;\n};\n\nexport async function signSolanaSignatureRequest(\n  signer: SolanaSigner,\n  signatureRequest: SolanaSignatureRequestParams,\n): Promise<SolanaSignatureResult> {\n  const txBytes = hexToBytes(signatureRequest.data);\n\n  const slotIndex = await findSignerSlot(txBytes, signer.address);\n  if (slotIndex < 0) {\n    throw new SolanaSignerError(\n      `Signer ${signer.address} is not a required signer in this transaction`,\n    );\n  }\n\n  LOGGER.debug(\"signSolanaSignatureRequest:signing\");\n\n  const { signedTransaction } = await signer.signTransaction({\n    transaction: txBytes,\n  });\n\n  if (signedTransaction[0] !== txBytes[0]) {\n    throw new SolanaSignerError(\n      `Signer returned a transaction with a different signature count (expected ${txBytes[0]}, got ${signedTransaction[0]})`,\n    );\n  }\n\n  const offset = 1 + slotIndex * 64;\n  const rawSignature = signedTransaction.slice(offset, offset + 64);\n\n  if (rawSignature.length !== 64) {\n    throw new SolanaSignerError(\n      `Signed transaction too short to contain signature at slot ${slotIndex}`,\n    );\n  }\n\n  if (rawSignature.every((b) => b === 0)) {\n    throw new SolanaSignerError(\n      `Signer ${signer.address} did not produce a signature at slot ${slotIndex}`,\n    );\n  }\n\n  LOGGER.debug(\"signSolanaSignatureRequest:ok\");\n  return {\n    type: \"ed25519\",\n    data: Base58.fromBytes(rawSignature),\n  };\n}\n"]}

package/dist/esm/actions/solana/waitForCallsStatus.d.ts

@@ -0,0 +1,24 @@
+import type { InnerSolanaWalletApiClient } from "../../types.js";
+import { type SolanaGetCallsStatusResult } from "./getCallsStatus.js";
+export type SolanaWaitForCallsStatusParams = {
+    id: `0x${string}`;
+    pollingInterval?: number;
+    retryCount?: number;
+    retryDelay?: (opts: {
+        count: number;
+    }) => number;
+    status?: (result: SolanaGetCallsStatusResult) => boolean;
+    throwOnFailure?: boolean;
+    timeout?: number;
+};
+export type SolanaWaitForCallsStatusResult = SolanaGetCallsStatusResult;
+/**
+ * Polls getCallsStatus until the call reaches a terminal state.
+ * Similar API to viem's waitForCallsStatus with retry, exponential backoff,
+ * configurable status predicate, throwOnFailure, and timeout.
+ *
+ * @param {InnerSolanaWalletApiClient} client - The Solana wallet API client
+ * @param {SolanaWaitForCallsStatusParams} params - The call ID and optional polling config
+ * @returns {Promise<SolanaWaitForCallsStatusResult>} The final status
+ */
+export declare function waitForCallsStatus(client: InnerSolanaWalletApiClient, params: SolanaWaitForCallsStatusParams): Promise<SolanaWaitForCallsStatusResult>;

package/dist/esm/actions/solana/waitForCallsStatus.js

@@ -0,0 +1,46 @@
+import { getCallsStatus, } from "./getCallsStatus.js";
+import { BaseError } from "@alchemy/common";
+import { LOGGER } from "../../logger.js";
+/**
+ * Polls getCallsStatus until the call reaches a terminal state.
+ * Similar API to viem's waitForCallsStatus with retry, exponential backoff,
+ * configurable status predicate, throwOnFailure, and timeout.
+ *
+ * @param {InnerSolanaWalletApiClient} client - The Solana wallet API client
+ * @param {SolanaWaitForCallsStatusParams} params - The call ID and optional polling config
+ * @returns {Promise<SolanaWaitForCallsStatusResult>} The final status
+ */
+export async function waitForCallsStatus(client, params) {
+    const { id, pollingInterval = client.pollingInterval, retryCount = 4, retryDelay = ({ count }) => ~~(1 << count) * 200, status: isReady = ({ statusCode }) => statusCode === 200 || statusCode >= 300, throwOnFailure = false, timeout = 60000, } = params;
+    LOGGER.debug("solana:waitForCallsStatus:start", { id });
+    const start = Date.now();
+    while (Date.now() - start < timeout) {
+        let result;
+        for (let attempt = 0; attempt <= retryCount; attempt++) {
+            try {
+                result = await getCallsStatus(client, { id });
+                break;
+            }
+            catch (error) {
+                if (attempt >= retryCount)
+                    throw error;
+                await new Promise((r) => setTimeout(r, retryDelay({ count: attempt })));
+            }
+        }
+        if (!result)
+            throw new BaseError("Unexpected: no result after retries");
+        if (throwOnFailure && result.status === "failure") {
+            throw new BaseError(`Solana call bundle failed with status code ${result.statusCode}`);
+        }
+        if (isReady(result)) {
+            LOGGER.debug("solana:waitForCallsStatus:done", {
+                status: result.status,
+                statusCode: result.statusCode,
+            });
+            return result;
+        }
+        await new Promise((r) => setTimeout(r, pollingInterval));
+    }
+    throw new BaseError(`Timed out while waiting for call bundle with id "${id}" to be confirmed.`);
+}
+//# sourceMappingURL=waitForCallsStatus.js.map

package/dist/esm/actions/solana/waitForCallsStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"waitForCallsStatus.js","sourceRoot":"","sources":["../../../../src/actions/solana/waitForCallsStatus.ts"],"names":[],"mappings":"AACA,OAAO,EACL,cAAc,GAEf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAczC;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAkC,EAClC,MAAsC;IAEtC,MAAM,EACJ,EAAE,EACF,eAAe,GAAG,MAAM,CAAC,eAAe,EACxC,UAAU,GAAG,CAAC,EACd,UAAU,GAAG,CAAC,EAAE,KAAK,EAAqB,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,GAAG,GAAG,EACnE,MAAM,EAAE,OAAO,GAAG,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CACnC,UAAU,KAAK,GAAG,IAAI,UAAU,IAAI,GAAG,EACzC,cAAc,GAAG,KAAK,EACtB,OAAO,GAAG,KAAM,GACjB,GAAG,MAAM,CAAC;IAEX,MAAM,CAAC,KAAK,CAAC,iCAAiC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAExD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEzB,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,OAAO,EAAE,CAAC;QACpC,IAAI,MAA8C,CAAC;QAEnD,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;YACvD,IAAI,CAAC;gBACH,MAAM,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;gBAC9C,MAAM;YACR,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,OAAO,IAAI,UAAU;oBAAE,MAAM,KAAK,CAAC;gBACvC,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;YAC1E,CAAC;QACH,CAAC;QAED,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,SAAS,CAAC,qCAAqC,CAAC,CAAC;QAExE,IAAI,cAAc,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAClD,MAAM,IAAI,SAAS,CACjB,8CAA8C,MAAM,CAAC,UAAU,EAAE,CAClE,CAAC;QACJ,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACpB,MAAM,CAAC,KAAK,CAAC,gCAAgC,EAAE;gBAC7C,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,UAAU,EAAE,MAAM,CAAC,UAAU;aAC9B,CAAC,CAAC;YACH,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,IAAI,SAAS,CACjB,oDAAoD,EAAE,oBAAoB,CAC3E,CAAC;AACJ,CAAC","sourcesContent":["import type { InnerSolanaWalletApiClient } from \"../../types.js\";\nimport {\n  getCallsStatus,\n  type SolanaGetCallsStatusResult,\n} from \"./getCallsStatus.js\";\nimport { BaseError } from \"@alchemy/common\";\nimport { LOGGER } from \"../../logger.js\";\n\nexport type SolanaWaitForCallsStatusParams = {\n  id: `0x${string}`;\n  pollingInterval?: number;\n  retryCount?: number;\n  retryDelay?: (opts: { count: number }) => number;\n  status?: (result: SolanaGetCallsStatusResult) => boolean;\n  throwOnFailure?: boolean;\n  timeout?: number;\n};\n\nexport type SolanaWaitForCallsStatusResult = SolanaGetCallsStatusResult;\n\n/**\n * Polls getCallsStatus until the call reaches a terminal state.\n * Similar API to viem's waitForCallsStatus with retry, exponential backoff,\n * configurable status predicate, throwOnFailure, and timeout.\n *\n * @param {InnerSolanaWalletApiClient} client - The Solana wallet API client\n * @param {SolanaWaitForCallsStatusParams} params - The call ID and optional polling config\n * @returns {Promise<SolanaWaitForCallsStatusResult>} The final status\n */\nexport async function waitForCallsStatus(\n  client: InnerSolanaWalletApiClient,\n  params: SolanaWaitForCallsStatusParams,\n): Promise<SolanaWaitForCallsStatusResult> {\n  const {\n    id,\n    pollingInterval = client.pollingInterval,\n    retryCount = 4,\n    retryDelay = ({ count }: { count: number }) => ~~(1 << count) * 200,\n    status: isReady = ({ statusCode }) =>\n      statusCode === 200 || statusCode >= 300,\n    throwOnFailure = false,\n    timeout = 60_000,\n  } = params;\n\n  LOGGER.debug(\"solana:waitForCallsStatus:start\", { id });\n\n  const start = Date.now();\n\n  while (Date.now() - start < timeout) {\n    let result: SolanaGetCallsStatusResult | undefined;\n\n    for (let attempt = 0; attempt <= retryCount; attempt++) {\n      try {\n        result = await getCallsStatus(client, { id });\n        break;\n      } catch (error) {\n        if (attempt >= retryCount) throw error;\n        await new Promise((r) => setTimeout(r, retryDelay({ count: attempt })));\n      }\n    }\n\n    if (!result) throw new BaseError(\"Unexpected: no result after retries\");\n\n    if (throwOnFailure && result.status === \"failure\") {\n      throw new BaseError(\n        `Solana call bundle failed with status code ${result.statusCode}`,\n      );\n    }\n\n    if (isReady(result)) {\n      LOGGER.debug(\"solana:waitForCallsStatus:done\", {\n        status: result.status,\n        statusCode: result.statusCode,\n      });\n      return result;\n    }\n\n    await new Promise((r) => setTimeout(r, pollingInterval));\n  }\n\n  throw new BaseError(\n    `Timed out while waiting for call bundle with id \"${id}\" to be confirmed.`,\n  );\n}\n"]}

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

@@ -0,0 +1,37 @@
+import { type Chain, type Prettify } from "viem";
+import type { InnerWalletApiClient } from "../types.js";
+import { type AccountParam } from "../utils/resolve.js";
+import { type SendCallsResult } from "./sendCalls.js";
+export type UndelegateAccountParams = Prettify<{
+    account?: AccountParam;
+    chain?: Pick<Chain, "id">;
+    capabilities?: {
+        paymaster?: {
+            policyId: string;
+        };
+    };
+}>;
+export type UndelegateAccountResult = Prettify<SendCallsResult>;
+/**
+ * Prepares, signs, and sends an EIP-7702 undelegation to remove delegation from an EOA.
+ * Gas is sponsored by Alchemy (requires Enterprise plan).
+ *
+ * A BSO (Bundler Sponsorship Override) policy ID must be provided either via
+ * `params.capabilities.paymaster.policyId` or pre-configured on the client via `policyIds`.
+ *
+ * @param {InnerWalletApiClient} client - The wallet API client to use for the request
+ * @param {UndelegateAccountParams} params - Parameters for undelegating the account
+ * @param {AccountParam} [params.account] - The account to undelegate. Defaults to the client's account (signer address).
+ * @param {object} [params.chain] - The chain. Defaults to the client's chain.
+ * @param {object} [params.capabilities] - Optional capabilities. If omitted, falls back to the policy ID(s) set on the client.
+ * @param {object} [params.capabilities.paymaster] - Paymaster capabilities. Requires a BSO policy ID.
+ * @param {string} [params.capabilities.paymaster.policyId] - The BSO policy ID to use for gas sponsorship.
+ * @returns {Promise<UndelegateAccountResult>} A Promise that resolves to the result containing the call ID.
+ *
+ * @example
+ * ```ts
+ * const result = await client.undelegateAccount();
+ * const status = await client.waitForCallsStatus({ id: result.id });
+ * ```
+ */
+export declare function undelegateAccount(client: InnerWalletApiClient, params?: UndelegateAccountParams): Promise<UndelegateAccountResult>;

package/dist/esm/actions/undelegateAccount.js

@@ -0,0 +1,49 @@
+import { zeroAddress } from "viem";
+import { LOGGER } from "../logger.js";
+import { resolveAddress } from "../utils/resolve.js";
+import { sendCalls } from "./sendCalls.js";
+/**
+ * Prepares, signs, and sends an EIP-7702 undelegation to remove delegation from an EOA.
+ * Gas is sponsored by Alchemy (requires Enterprise plan).
+ *
+ * A BSO (Bundler Sponsorship Override) policy ID must be provided either via
+ * `params.capabilities.paymaster.policyId` or pre-configured on the client via `policyIds`.
+ *
+ * @param {InnerWalletApiClient} client - The wallet API client to use for the request
+ * @param {UndelegateAccountParams} params - Parameters for undelegating the account
+ * @param {AccountParam} [params.account] - The account to undelegate. Defaults to the client's account (signer address).
+ * @param {object} [params.chain] - The chain. Defaults to the client's chain.
+ * @param {object} [params.capabilities] - Optional capabilities. If omitted, falls back to the policy ID(s) set on the client.
+ * @param {object} [params.capabilities.paymaster] - Paymaster capabilities. Requires a BSO policy ID.
+ * @param {string} [params.capabilities.paymaster.policyId] - The BSO policy ID to use for gas sponsorship.
+ * @returns {Promise<UndelegateAccountResult>} A Promise that resolves to the result containing the call ID.
+ *
+ * @example
+ * ```ts
+ * const result = await client.undelegateAccount();
+ * const status = await client.waitForCallsStatus({ id: result.id });
+ * ```
+ */
+export async function undelegateAccount(client, params) {
+    const account = params?.account
+        ? resolveAddress(params.account)
+        : client.account.address;
+    LOGGER.info("undelegateAccount:start", {
+        account,
+        chain: params?.chain,
+    });
+    const result = await sendCalls(client, {
+        calls: [],
+        account,
+        ...(params?.chain != null ? { chain: params.chain } : {}),
+        capabilities: {
+            ...params?.capabilities,
+            eip7702Auth: {
+                delegation: zeroAddress,
+            },
+        },
+    });
+    LOGGER.info("undelegateAccount:done", { id: result.id });
+    return result;
+}
+//# sourceMappingURL=undelegateAccount.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"undelegateAccount.js","sourceRoot":"","sources":["../../../src/actions/undelegateAccount.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAA6B,MAAM,MAAM,CAAC;AAE9D,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,cAAc,EAAqB,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,SAAS,EAAwB,MAAM,gBAAgB,CAAC;AAcjE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAA4B,EAC5B,MAAgC;IAEhC,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO;QAC7B,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC;QAChC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;IAE3B,MAAM,CAAC,IAAI,CAAC,yBAAyB,EAAE;QACrC,OAAO;QACP,KAAK,EAAE,MAAM,EAAE,KAAK;KACrB,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE;QACrC,KAAK,EAAE,EAAE;QACT,OAAO;QACP,GAAG,CAAC,MAAM,EAAE,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,YAAY,EAAE;YACZ,GAAG,MAAM,EAAE,YAAY;YACvB,WAAW,EAAE;gBACX,UAAU,EAAE,WAAW;aACxB;SACF;KACF,CAAC,CAAC;IAEH,MAAM,CAAC,IAAI,CAAC,wBAAwB,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;IACzD,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["import { zeroAddress, type Chain, type Prettify } from \"viem\";\nimport type { InnerWalletApiClient } from \"../types.js\";\nimport { LOGGER } from \"../logger.js\";\nimport { resolveAddress, type AccountParam } from \"../utils/resolve.js\";\nimport { sendCalls, type SendCallsResult } from \"./sendCalls.js\";\n\nexport type UndelegateAccountParams = Prettify<{\n  account?: AccountParam;\n  chain?: Pick<Chain, \"id\">;\n  capabilities?: {\n    paymaster?: {\n      policyId: string;\n    };\n  };\n}>;\n\nexport type UndelegateAccountResult = Prettify<SendCallsResult>;\n\n/**\n * Prepares, signs, and sends an EIP-7702 undelegation to remove delegation from an EOA.\n * Gas is sponsored by Alchemy (requires Enterprise plan).\n *\n * A BSO (Bundler Sponsorship Override) policy ID must be provided either via\n * `params.capabilities.paymaster.policyId` or pre-configured on the client via `policyIds`.\n *\n * @param {InnerWalletApiClient} client - The wallet API client to use for the request\n * @param {UndelegateAccountParams} params - Parameters for undelegating the account\n * @param {AccountParam} [params.account] - The account to undelegate. Defaults to the client's account (signer address).\n * @param {object} [params.chain] - The chain. Defaults to the client's chain.\n * @param {object} [params.capabilities] - Optional capabilities. If omitted, falls back to the policy ID(s) set on the client.\n * @param {object} [params.capabilities.paymaster] - Paymaster capabilities. Requires a BSO policy ID.\n * @param {string} [params.capabilities.paymaster.policyId] - The BSO policy ID to use for gas sponsorship.\n * @returns {Promise<UndelegateAccountResult>} A Promise that resolves to the result containing the call ID.\n *\n * @example\n * ```ts\n * const result = await client.undelegateAccount();\n * const status = await client.waitForCallsStatus({ id: result.id });\n * ```\n */\nexport async function undelegateAccount(\n  client: InnerWalletApiClient,\n  params?: UndelegateAccountParams,\n): Promise<UndelegateAccountResult> {\n  const account = params?.account\n    ? resolveAddress(params.account)\n    : client.account.address;\n\n  LOGGER.info(\"undelegateAccount:start\", {\n    account,\n    chain: params?.chain,\n  });\n\n  const result = await sendCalls(client, {\n    calls: [],\n    account,\n    ...(params?.chain != null ? { chain: params.chain } : {}),\n    capabilities: {\n      ...params?.capabilities,\n      eip7702Auth: {\n        delegation: zeroAddress,\n      },\n    },\n  });\n\n  LOGGER.info(\"undelegateAccount:done\", { id: result.id });\n  return result;\n}\n"]}

package/dist/esm/adapters/SolanaSignerError.d.ts

@@ -0,0 +1,4 @@
+import { BaseError } from "@alchemy/common";
+export declare class SolanaSignerError extends BaseError {
+    name: string;
+}

package/dist/esm/adapters/SolanaSignerError.js

@@ -0,0 +1,13 @@
+import { BaseError } from "@alchemy/common";
+export class SolanaSignerError extends BaseError {
+    constructor() {
+        super(...arguments);
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "SolanaSignerError"
+        });
+    }
+}
+//# sourceMappingURL=SolanaSignerError.js.map

package/dist/esm/adapters/SolanaSignerError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SolanaSignerError.js","sourceRoot":"","sources":["../../../src/adapters/SolanaSignerError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,MAAM,OAAO,iBAAkB,SAAQ,SAAS;IAAhD;;QACW;;;;mBAAO,mBAAmB;WAAC;IACtC,CAAC;CAAA","sourcesContent":["import { BaseError } from \"@alchemy/common\";\n\nexport class SolanaSignerError extends BaseError {\n  override name = \"SolanaSignerError\";\n}\n"]}

package/dist/esm/adapters/fromKeypair.d.ts

@@ -0,0 +1,21 @@
+import type { SolanaSigner } from "../types.js";
+/** Raw Ed25519 keypair signer (e.g. `Keypair` from `@solana/web3.js` v1 or a bare Ed25519 key). */
+export interface SolanaKeypairSigner {
+    address: string;
+    signMessage(message: Uint8Array): Promise<Uint8Array>;
+}
+/**
+ * Adapts a raw Ed25519 keypair signer into a {@link SolanaSigner}.
+ *
+ * Use this for legacy `@solana/web3.js` v1 `Keypair` signers or any signer
+ * that exposes a `signMessage(bytes) => signature` interface. For
+ * `@solana/kit` signers, use {@link fromKitSigner}. For browser wallets
+ * (wallet adapter, Phantom, etc.), use {@link fromWalletAdapter}. For
+ * wallet-standard wallets, use {@link fromWalletStandard}.
+ *
+ * Requires `@solana/kit` or `@solana/web3.js` as a peer dependency.
+ *
+ * @param {SolanaKeypairSigner} signer - The raw Ed25519 keypair signer to adapt
+ * @returns {SolanaSigner} A SolanaSigner compatible with `createSmartWalletClient`
+ */
+export declare function fromKeypair(signer: SolanaKeypairSigner): SolanaSigner;