@alchemy/wallet-apis 5.0.0-beta.28 → 5.0.0-beta.29

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/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;

package/dist/esm/adapters/fromKeypair.js

@@ -0,0 +1,46 @@
+import { SolanaSignerError } from "./SolanaSignerError.js";
+import { findSignerSlot } from "./resolveSignerSlot.js";
+/**
+ * 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 function fromKeypair(signer) {
+    return {
+        address: signer.address,
+        async signTransaction({ transaction }) {
+            const numSigs = transaction[0];
+            const messageStart = 1 + numSigs * 64;
+            const messageBytes = transaction.slice(messageStart);
+            let sig;
+            try {
+                sig = await signer.signMessage(messageBytes);
+            }
+            catch (e) {
+                throw new SolanaSignerError("Keypair signer failed to sign message", {
+                    cause: e,
+                });
+            }
+            if (sig.length !== 64) {
+                throw new SolanaSignerError(`Expected a 64-byte Ed25519 signature but received ${sig.length} bytes`);
+            }
+            const slotIndex = await findSignerSlot(transaction, signer.address);
+            if (slotIndex < 0) {
+                throw new SolanaSignerError(`Signer ${signer.address} is not a required signer in this transaction`);
+            }
+            const signedTx = new Uint8Array(transaction);
+            signedTx.set(sig, 1 + slotIndex * 64);
+            return { signedTransaction: signedTx };
+        },
+    };
+}
+//# sourceMappingURL=fromKeypair.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fromKeypair.js","sourceRoot":"","sources":["../../../src/adapters/fromKeypair.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAQxD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,WAAW,CAAC,MAA2B;IACrD,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK,CAAC,eAAe,CAAC,EAAE,WAAW,EAAE;YACnC,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,YAAY,GAAG,CAAC,GAAG,OAAO,GAAG,EAAE,CAAC;YACtC,MAAM,YAAY,GAAG,WAAW,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;YACrD,IAAI,GAAe,CAAC;YACpB,IAAI,CAAC;gBACH,GAAG,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;YAC/C,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,IAAI,iBAAiB,CAAC,uCAAuC,EAAE;oBACnE,KAAK,EAAE,CAAU;iBAClB,CAAC,CAAC;YACL,CAAC;YACD,IAAI,GAAG,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;gBACtB,MAAM,IAAI,iBAAiB,CACzB,qDAAqD,GAAG,CAAC,MAAM,QAAQ,CACxE,CAAC;YACJ,CAAC;YAED,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;YACpE,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;gBAClB,MAAM,IAAI,iBAAiB,CACzB,UAAU,MAAM,CAAC,OAAO,+CAA+C,CACxE,CAAC;YACJ,CAAC;YAED,MAAM,QAAQ,GAAG,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC;YAC7C,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,SAAS,GAAG,EAAE,CAAC,CAAC;YACtC,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,CAAC;QACzC,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import type { SolanaSigner } from \"../types.js\";\nimport { SolanaSignerError } from \"./SolanaSignerError.js\";\nimport { findSignerSlot } from \"./resolveSignerSlot.js\";\n\n/** Raw Ed25519 keypair signer (e.g. `Keypair` from `@solana/web3.js` v1 or a bare Ed25519 key). */\nexport interface SolanaKeypairSigner {\n  address: string;\n  signMessage(message: Uint8Array): Promise<Uint8Array>;\n}\n\n/**\n * Adapts a raw Ed25519 keypair signer into a {@link SolanaSigner}.\n *\n * Use this for legacy `@solana/web3.js` v1 `Keypair` signers or any signer\n * that exposes a `signMessage(bytes) => signature` interface. For\n * `@solana/kit` signers, use {@link fromKitSigner}. For browser wallets\n * (wallet adapter, Phantom, etc.), use {@link fromWalletAdapter}. For\n * wallet-standard wallets, use {@link fromWalletStandard}.\n *\n * Requires `@solana/kit` or `@solana/web3.js` as a peer dependency.\n *\n * @param {SolanaKeypairSigner} signer - The raw Ed25519 keypair signer to adapt\n * @returns {SolanaSigner} A SolanaSigner compatible with `createSmartWalletClient`\n */\nexport function fromKeypair(signer: SolanaKeypairSigner): SolanaSigner {\n  return {\n    address: signer.address,\n    async signTransaction({ transaction }) {\n      const numSigs = transaction[0];\n      const messageStart = 1 + numSigs * 64;\n      const messageBytes = transaction.slice(messageStart);\n      let sig: Uint8Array;\n      try {\n        sig = await signer.signMessage(messageBytes);\n      } catch (e) {\n        throw new SolanaSignerError(\"Keypair signer failed to sign message\", {\n          cause: e as Error,\n        });\n      }\n      if (sig.length !== 64) {\n        throw new SolanaSignerError(\n          `Expected a 64-byte Ed25519 signature but received ${sig.length} bytes`,\n        );\n      }\n\n      const slotIndex = await findSignerSlot(transaction, 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      const signedTx = new Uint8Array(transaction);\n      signedTx.set(sig, 1 + slotIndex * 64);\n      return { signedTransaction: signedTx };\n    },\n  };\n}\n"]}

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

@@ -0,0 +1,21 @@
+import type { SolanaSigner } from "../types.js";
+/** Any {@link https://solanakit.com @solana/kit} signer that implements `signTransactions` (e.g. `TransactionPartialSigner`, `KeyPairSigner`). */
+export interface SolanaTransactionPartialSigner {
+    address: string;
+    signTransactions(transactions: readonly unknown[]): Promise<readonly Record<string, Uint8Array>[]>;
+}
+/**
+ * Adapts an {@link https://solanakit.com @solana/kit} signer into a {@link SolanaSigner}.
+ *
+ * Accepts any signer that implements `signTransactions`, including
+ * `KeyPairSigner`, `TransactionPartialSigner`, and `NoopSigner`. For raw
+ * Ed25519 keypairs, use {@link fromKeypair}. For browser wallets (wallet
+ * adapter, Phantom, etc.), use {@link fromWalletAdapter}. For
+ * wallet-standard wallets, use {@link fromWalletStandard}.
+ *
+ * Requires `@solana/kit` as a peer dependency.
+ *
+ * @param {SolanaTransactionPartialSigner} signer - The @solana/kit signer to adapt
+ * @returns {SolanaSigner} A SolanaSigner compatible with `createSmartWalletClient`
+ */
+export declare function fromKitSigner(signer: SolanaTransactionPartialSigner): SolanaSigner;

package/dist/esm/adapters/fromKitSigner.js

@@ -0,0 +1,61 @@
+import { SolanaSignerError } from "./SolanaSignerError.js";
+import { findSignerSlot } from "./resolveSignerSlot.js";
+/**
+ * Adapts an {@link https://solanakit.com @solana/kit} signer into a {@link SolanaSigner}.
+ *
+ * Accepts any signer that implements `signTransactions`, including
+ * `KeyPairSigner`, `TransactionPartialSigner`, and `NoopSigner`. For raw
+ * Ed25519 keypairs, use {@link fromKeypair}. For browser wallets (wallet
+ * adapter, Phantom, etc.), use {@link fromWalletAdapter}. For
+ * wallet-standard wallets, use {@link fromWalletStandard}.
+ *
+ * Requires `@solana/kit` as a peer dependency.
+ *
+ * @param {SolanaTransactionPartialSigner} signer - The @solana/kit signer to adapt
+ * @returns {SolanaSigner} A SolanaSigner compatible with `createSmartWalletClient`
+ */
+export function fromKitSigner(signer) {
+    return {
+        address: signer.address,
+        async signTransaction({ transaction }) {
+            let tx;
+            try {
+                const { getTransactionCodec } = await import("@solana/kit");
+                const codec = getTransactionCodec();
+                tx = codec.decode(transaction);
+            }
+            catch (e) {
+                throw new SolanaSignerError("Failed to decode transaction", {
+                    cause: e,
+                });
+            }
+            let sigDict;
+            try {
+                [sigDict] = await signer.signTransactions([tx]);
+            }
+            catch (e) {
+                throw new SolanaSignerError("Kit signer failed to sign transaction", {
+                    cause: e,
+                });
+            }
+            if (!sigDict) {
+                throw new SolanaSignerError("TransactionPartialSigner returned no signatures");
+            }
+            const sig = sigDict[signer.address];
+            if (!sig) {
+                throw new SolanaSignerError(`TransactionPartialSigner did not produce a signature for ${signer.address}`);
+            }
+            if (sig.length !== 64) {
+                throw new SolanaSignerError(`Expected a 64-byte Ed25519 signature but received ${sig.length} bytes`);
+            }
+            const slotIndex = await findSignerSlot(transaction, signer.address);
+            if (slotIndex < 0) {
+                throw new SolanaSignerError(`Signer ${signer.address} is not a required signer in this transaction`);
+            }
+            const signedTx = new Uint8Array(transaction);
+            signedTx.set(sig, 1 + slotIndex * 64);
+            return { signedTransaction: signedTx };
+        },
+    };
+}
+//# sourceMappingURL=fromKitSigner.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fromKitSigner.js","sourceRoot":"","sources":["../../../src/adapters/fromKitSigner.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAUxD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAsC;IAEtC,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK,CAAC,eAAe,CAAC,EAAE,WAAW,EAAE;YACnC,IAAI,EAAW,CAAC;YAChB,IAAI,CAAC;gBACH,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;gBAC5D,MAAM,KAAK,GAAG,mBAAmB,EAAE,CAAC;gBACpC,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;YACjC,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,IAAI,iBAAiB,CAAC,8BAA8B,EAAE;oBAC1D,KAAK,EAAE,CAAU;iBAClB,CAAC,CAAC;YACL,CAAC;YAED,IAAI,OAA+C,CAAC;YACpD,IAAI,CAAC;gBACH,CAAC,OAAO,CAAC,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAClD,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,IAAI,iBAAiB,CAAC,uCAAuC,EAAE;oBACnE,KAAK,EAAE,CAAU;iBAClB,CAAC,CAAC;YACL,CAAC;YACD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,iBAAiB,CACzB,iDAAiD,CAClD,CAAC;YACJ,CAAC;YAED,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACpC,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,MAAM,IAAI,iBAAiB,CACzB,4DAA4D,MAAM,CAAC,OAAO,EAAE,CAC7E,CAAC;YACJ,CAAC;YACD,IAAI,GAAG,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;gBACtB,MAAM,IAAI,iBAAiB,CACzB,qDAAqD,GAAG,CAAC,MAAM,QAAQ,CACxE,CAAC;YACJ,CAAC;YAED,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;YACpE,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;gBAClB,MAAM,IAAI,iBAAiB,CACzB,UAAU,MAAM,CAAC,OAAO,+CAA+C,CACxE,CAAC;YACJ,CAAC;YAED,MAAM,QAAQ,GAAG,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC;YAC7C,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,SAAS,GAAG,EAAE,CAAC,CAAC;YACtC,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,CAAC;QACzC,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import type { SolanaSigner } from \"../types.js\";\nimport { SolanaSignerError } from \"./SolanaSignerError.js\";\nimport { findSignerSlot } from \"./resolveSignerSlot.js\";\n\n/** Any {@link https://solanakit.com @solana/kit} signer that implements `signTransactions` (e.g. `TransactionPartialSigner`, `KeyPairSigner`). */\nexport interface SolanaTransactionPartialSigner {\n  address: string;\n  signTransactions(\n    transactions: readonly unknown[],\n  ): Promise<readonly Record<string, Uint8Array>[]>;\n}\n\n/**\n * Adapts an {@link https://solanakit.com @solana/kit} signer into a {@link SolanaSigner}.\n *\n * Accepts any signer that implements `signTransactions`, including\n * `KeyPairSigner`, `TransactionPartialSigner`, and `NoopSigner`. For raw\n * Ed25519 keypairs, use {@link fromKeypair}. For browser wallets (wallet\n * adapter, Phantom, etc.), use {@link fromWalletAdapter}. For\n * wallet-standard wallets, use {@link fromWalletStandard}.\n *\n * Requires `@solana/kit` as a peer dependency.\n *\n * @param {SolanaTransactionPartialSigner} signer - The @solana/kit signer to adapt\n * @returns {SolanaSigner} A SolanaSigner compatible with `createSmartWalletClient`\n */\nexport function fromKitSigner(\n  signer: SolanaTransactionPartialSigner,\n): SolanaSigner {\n  return {\n    address: signer.address,\n    async signTransaction({ transaction }) {\n      let tx: unknown;\n      try {\n        const { getTransactionCodec } = await import(\"@solana/kit\");\n        const codec = getTransactionCodec();\n        tx = codec.decode(transaction);\n      } catch (e) {\n        throw new SolanaSignerError(\"Failed to decode transaction\", {\n          cause: e as Error,\n        });\n      }\n\n      let sigDict: Record<string, Uint8Array> | undefined;\n      try {\n        [sigDict] = await signer.signTransactions([tx]);\n      } catch (e) {\n        throw new SolanaSignerError(\"Kit signer failed to sign transaction\", {\n          cause: e as Error,\n        });\n      }\n      if (!sigDict) {\n        throw new SolanaSignerError(\n          \"TransactionPartialSigner returned no signatures\",\n        );\n      }\n\n      const sig = sigDict[signer.address];\n      if (!sig) {\n        throw new SolanaSignerError(\n          `TransactionPartialSigner did not produce a signature for ${signer.address}`,\n        );\n      }\n      if (sig.length !== 64) {\n        throw new SolanaSignerError(\n          `Expected a 64-byte Ed25519 signature but received ${sig.length} bytes`,\n        );\n      }\n\n      const slotIndex = await findSignerSlot(transaction, 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      const signedTx = new Uint8Array(transaction);\n      signedTx.set(sig, 1 + slotIndex * 64);\n      return { signedTransaction: signedTx };\n    },\n  };\n}\n"]}

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

@@ -0,0 +1,26 @@
+import type { SolanaSigner } from "../types.js";
+import type { VersionedTransaction } from "@solana/web3.js";
+/** Any signer with a `publicKey` and `signTransaction(VersionedTransaction)` method — matches `useWallet()` from `@solana/wallet-adapter-react` and injected wallet providers like `window.phantom.solana`. */
+export interface WalletAdapterSigner {
+    publicKey: {
+        toBase58(): string;
+    };
+    signTransaction: <T extends VersionedTransaction>(transaction: T) => Promise<T>;
+}
+/**
+ * Adapts a wallet that signs `VersionedTransaction` objects into a {@link SolanaSigner}.
+ *
+ * Works with `useWallet()` from `@solana/wallet-adapter-react` and injected
+ * browser wallet providers (e.g. `window.phantom.solana`). Handles the
+ * `Uint8Array` ↔ `VersionedTransaction` conversion internally.
+ *
+ * For `@solana/kit` signers, use {@link fromKitSigner}. For raw Ed25519
+ * keypairs, use {@link fromKeypair}. For wallet-standard wallets, use
+ * {@link fromWalletStandard}.
+ *
+ * Requires `@solana/web3.js` as a peer dependency.
+ *
+ * @param {WalletAdapterSigner} signer - The wallet adapter signer
+ * @returns {SolanaSigner} A SolanaSigner compatible with `createSmartWalletClient`
+ */
+export declare function fromWalletAdapter(signer: WalletAdapterSigner): SolanaSigner;

package/dist/esm/adapters/fromWalletAdapter.js

@@ -0,0 +1,45 @@
+import { SolanaSignerError } from "./SolanaSignerError.js";
+/**
+ * Adapts a wallet that signs `VersionedTransaction` objects into a {@link SolanaSigner}.
+ *
+ * Works with `useWallet()` from `@solana/wallet-adapter-react` and injected
+ * browser wallet providers (e.g. `window.phantom.solana`). Handles the
+ * `Uint8Array` ↔ `VersionedTransaction` conversion internally.
+ *
+ * For `@solana/kit` signers, use {@link fromKitSigner}. For raw Ed25519
+ * keypairs, use {@link fromKeypair}. For wallet-standard wallets, use
+ * {@link fromWalletStandard}.
+ *
+ * Requires `@solana/web3.js` as a peer dependency.
+ *
+ * @param {WalletAdapterSigner} signer - The wallet adapter signer
+ * @returns {SolanaSigner} A SolanaSigner compatible with `createSmartWalletClient`
+ */
+export function fromWalletAdapter(signer) {
+    return {
+        address: signer.publicKey.toBase58(),
+        async signTransaction({ transaction }) {
+            let tx;
+            try {
+                const web3 = await import("@solana/web3.js");
+                tx = web3.VersionedTransaction.deserialize(transaction);
+            }
+            catch (e) {
+                throw new SolanaSignerError("Failed to deserialize transaction", {
+                    cause: e,
+                });
+            }
+            let signed;
+            try {
+                signed = await signer.signTransaction(tx);
+            }
+            catch (e) {
+                throw new SolanaSignerError("Wallet adapter failed to sign transaction", {
+                    cause: e,
+                });
+            }
+            return { signedTransaction: new Uint8Array(signed.serialize()) };
+        },
+    };
+}
+//# sourceMappingURL=fromWalletAdapter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fromWalletAdapter.js","sourceRoot":"","sources":["../../../src/adapters/fromWalletAdapter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAU3D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAA2B;IAC3D,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE;QACpC,KAAK,CAAC,eAAe,CAAC,EAAE,WAAW,EAAE;YACnC,IAAI,EAAwB,CAAC;YAC7B,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;gBAC7C,EAAE,GAAG,IAAI,CAAC,oBAAoB,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;YAC1D,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,IAAI,iBAAiB,CAAC,mCAAmC,EAAE;oBAC/D,KAAK,EAAE,CAAU;iBAClB,CAAC,CAAC;YACL,CAAC;YAED,IAAI,MAA4B,CAAC;YACjC,IAAI,CAAC;gBACH,MAAM,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;YAC5C,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,IAAI,iBAAiB,CACzB,2CAA2C,EAC3C;oBACE,KAAK,EAAE,CAAU;iBAClB,CACF,CAAC;YACJ,CAAC;YAED,OAAO,EAAE,iBAAiB,EAAE,IAAI,UAAU,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC;QACnE,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import type { SolanaSigner } from \"../types.js\";\nimport type { VersionedTransaction } from \"@solana/web3.js\";\nimport { SolanaSignerError } from \"./SolanaSignerError.js\";\n\n/** Any signer with a `publicKey` and `signTransaction(VersionedTransaction)` method — matches `useWallet()` from `@solana/wallet-adapter-react` and injected wallet providers like `window.phantom.solana`. */\nexport interface WalletAdapterSigner {\n  publicKey: { toBase58(): string };\n  signTransaction: <T extends VersionedTransaction>(\n    transaction: T,\n  ) => Promise<T>;\n}\n\n/**\n * Adapts a wallet that signs `VersionedTransaction` objects into a {@link SolanaSigner}.\n *\n * Works with `useWallet()` from `@solana/wallet-adapter-react` and injected\n * browser wallet providers (e.g. `window.phantom.solana`). Handles the\n * `Uint8Array` ↔ `VersionedTransaction` conversion internally.\n *\n * For `@solana/kit` signers, use {@link fromKitSigner}. For raw Ed25519\n * keypairs, use {@link fromKeypair}. For wallet-standard wallets, use\n * {@link fromWalletStandard}.\n *\n * Requires `@solana/web3.js` as a peer dependency.\n *\n * @param {WalletAdapterSigner} signer - The wallet adapter signer\n * @returns {SolanaSigner} A SolanaSigner compatible with `createSmartWalletClient`\n */\nexport function fromWalletAdapter(signer: WalletAdapterSigner): SolanaSigner {\n  return {\n    address: signer.publicKey.toBase58(),\n    async signTransaction({ transaction }) {\n      let tx: VersionedTransaction;\n      try {\n        const web3 = await import(\"@solana/web3.js\");\n        tx = web3.VersionedTransaction.deserialize(transaction);\n      } catch (e) {\n        throw new SolanaSignerError(\"Failed to deserialize transaction\", {\n          cause: e as Error,\n        });\n      }\n\n      let signed: VersionedTransaction;\n      try {\n        signed = await signer.signTransaction(tx);\n      } catch (e) {\n        throw new SolanaSignerError(\n          \"Wallet adapter failed to sign transaction\",\n          {\n            cause: e as Error,\n          },\n        );\n      }\n\n      return { signedTransaction: new Uint8Array(signed.serialize()) };\n    },\n  };\n}\n"]}