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

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"]}

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

@@ -0,0 +1,31 @@
+import type { SolanaSigner } from "../types.js";
+/** Minimal structural shape of a wallet-standard account. */
+export interface WalletStandardAccount {
+    address: string;
+    publicKey?: Uint8Array;
+    chains?: readonly string[];
+    features?: readonly string[];
+    [key: string]: unknown;
+}
+/** Minimal structural shape of a wallet-standard wallet. */
+export interface WalletStandardWallet {
+    features: {
+        readonly [name: string]: unknown;
+    };
+}
+/**
+ * Adapts a Wallet Standard wallet into a {@link SolanaSigner}.
+ *
+ * Works with any wallet that implements the `solana:signTransaction` feature
+ * from the Wallet Standard spec (Phantom, Solflare, etc.). No peer dependency
+ * required — the interface uses `Uint8Array` directly.
+ *
+ * For `@solana/wallet-adapter-react` wallets, use {@link fromWalletAdapter}.
+ * For `@solana/kit` signers, use {@link fromKitSigner}. For raw Ed25519
+ * keypairs, use {@link fromKeypair}.
+ *
+ * @param {WalletStandardWallet} wallet - The wallet-standard wallet object
+ * @param {WalletStandardAccount} account - The account to sign with
+ * @returns {SolanaSigner} A SolanaSigner compatible with `createSmartWalletClient`
+ */
+export declare function fromWalletStandard(wallet: WalletStandardWallet, account: WalletStandardAccount): SolanaSigner;

package/dist/esm/adapters/fromWalletStandard.js

@@ -0,0 +1,53 @@
+import { SolanaSignerError } from "./SolanaSignerError.js";
+const SIGN_TRANSACTION = "solana:signTransaction";
+function isSolanaSignTransactionFeature(feature) {
+    return (typeof feature === "object" &&
+        feature !== null &&
+        "signTransaction" in feature &&
+        typeof feature.signTransaction ===
+            "function");
+}
+/**
+ * Adapts a Wallet Standard wallet into a {@link SolanaSigner}.
+ *
+ * Works with any wallet that implements the `solana:signTransaction` feature
+ * from the Wallet Standard spec (Phantom, Solflare, etc.). No peer dependency
+ * required — the interface uses `Uint8Array` directly.
+ *
+ * For `@solana/wallet-adapter-react` wallets, use {@link fromWalletAdapter}.
+ * For `@solana/kit` signers, use {@link fromKitSigner}. For raw Ed25519
+ * keypairs, use {@link fromKeypair}.
+ *
+ * @param {WalletStandardWallet} wallet - The wallet-standard wallet object
+ * @param {WalletStandardAccount} account - The account to sign with
+ * @returns {SolanaSigner} A SolanaSigner compatible with `createSmartWalletClient`
+ */
+export function fromWalletStandard(wallet, account) {
+    const feature = wallet.features[SIGN_TRANSACTION];
+    if (!isSolanaSignTransactionFeature(feature)) {
+        throw new SolanaSignerError(`Wallet does not support the "${SIGN_TRANSACTION}" feature.`);
+    }
+    if (account.features && !account.features.includes(SIGN_TRANSACTION)) {
+        throw new SolanaSignerError(`Account ${account.address} does not support the "${SIGN_TRANSACTION}" feature.`);
+    }
+    return {
+        address: account.address,
+        async signTransaction({ transaction }) {
+            let output;
+            try {
+                [output] = await feature.signTransaction({ account, transaction });
+            }
+            catch (e) {
+                throw new SolanaSignerError("Wallet standard wallet failed to sign transaction", { cause: e });
+            }
+            if (!output) {
+                throw new SolanaSignerError("Wallet returned no signed transaction.");
+            }
+            if (!(output.signedTransaction instanceof Uint8Array)) {
+                throw new SolanaSignerError("Wallet returned an invalid signed transaction.");
+            }
+            return output;
+        },
+    };
+}
+//# sourceMappingURL=fromWalletStandard.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fromWalletStandard.js","sourceRoot":"","sources":["../../../src/adapters/fromWalletStandard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG3D,MAAM,gBAAgB,GAAG,wBAAwB,CAAC;AAyBlD,SAAS,8BAA8B,CACrC,OAAgB;IAEhB,OAAO,CACL,OAAO,OAAO,KAAK,QAAQ;QAC3B,OAAO,KAAK,IAAI;QAChB,iBAAiB,IAAI,OAAO;QAC5B,OAAQ,OAAyC,CAAC,eAAe;YAC/D,UAAU,CACb,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAA4B,EAC5B,OAA8B;IAE9B,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IAElD,IAAI,CAAC,8BAA8B,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,iBAAiB,CACzB,gCAAgC,gBAAgB,YAAY,CAC7D,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,iBAAiB,CACzB,WAAW,OAAO,CAAC,OAAO,0BAA0B,gBAAgB,YAAY,CACjF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK,CAAC,eAAe,CAAC,EAAE,WAAW,EAAE;YACnC,IAAI,MAAqD,CAAC;YAC1D,IAAI,CAAC;gBACH,CAAC,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;YACrE,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,IAAI,iBAAiB,CACzB,mDAAmD,EACnD,EAAE,KAAK,EAAE,CAAU,EAAE,CACtB,CAAC;YACJ,CAAC;YAED,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,iBAAiB,CAAC,wCAAwC,CAAC,CAAC;YACxE,CAAC;YAED,IAAI,CAAC,CAAC,MAAM,CAAC,iBAAiB,YAAY,UAAU,CAAC,EAAE,CAAC;gBACtD,MAAM,IAAI,iBAAiB,CACzB,gDAAgD,CACjD,CAAC;YACJ,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import { SolanaSignerError } from \"./SolanaSignerError.js\";\nimport type { SolanaSigner } from \"../types.js\";\n\nconst SIGN_TRANSACTION = \"solana:signTransaction\";\n\n/** Minimal structural shape of a wallet-standard account. */\nexport interface WalletStandardAccount {\n  address: string;\n  publicKey?: Uint8Array;\n  chains?: readonly string[];\n  features?: readonly string[];\n  [key: string]: unknown;\n}\n\n/** Minimal structural shape of a wallet-standard wallet. */\nexport interface WalletStandardWallet {\n  features: { readonly [name: string]: unknown };\n}\n\ninterface SolanaSignTransactionFeature {\n  readonly signTransaction: (\n    ...inputs: readonly {\n      account: WalletStandardAccount;\n      transaction: Uint8Array;\n    }[]\n  ) => Promise<readonly { signedTransaction: Uint8Array }[]>;\n}\n\nfunction isSolanaSignTransactionFeature(\n  feature: unknown,\n): feature is SolanaSignTransactionFeature {\n  return (\n    typeof feature === \"object\" &&\n    feature !== null &&\n    \"signTransaction\" in feature &&\n    typeof (feature as { signTransaction?: unknown }).signTransaction ===\n      \"function\"\n  );\n}\n\n/**\n * Adapts a Wallet Standard wallet into a {@link SolanaSigner}.\n *\n * Works with any wallet that implements the `solana:signTransaction` feature\n * from the Wallet Standard spec (Phantom, Solflare, etc.). No peer dependency\n * required — the interface uses `Uint8Array` directly.\n *\n * For `@solana/wallet-adapter-react` wallets, use {@link fromWalletAdapter}.\n * For `@solana/kit` signers, use {@link fromKitSigner}. For raw Ed25519\n * keypairs, use {@link fromKeypair}.\n *\n * @param {WalletStandardWallet} wallet - The wallet-standard wallet object\n * @param {WalletStandardAccount} account - The account to sign with\n * @returns {SolanaSigner} A SolanaSigner compatible with `createSmartWalletClient`\n */\nexport function fromWalletStandard(\n  wallet: WalletStandardWallet,\n  account: WalletStandardAccount,\n): SolanaSigner {\n  const feature = wallet.features[SIGN_TRANSACTION];\n\n  if (!isSolanaSignTransactionFeature(feature)) {\n    throw new SolanaSignerError(\n      `Wallet does not support the \"${SIGN_TRANSACTION}\" feature.`,\n    );\n  }\n\n  if (account.features && !account.features.includes(SIGN_TRANSACTION)) {\n    throw new SolanaSignerError(\n      `Account ${account.address} does not support the \"${SIGN_TRANSACTION}\" feature.`,\n    );\n  }\n\n  return {\n    address: account.address,\n    async signTransaction({ transaction }) {\n      let output: { signedTransaction: Uint8Array } | undefined;\n      try {\n        [output] = await feature.signTransaction({ account, transaction });\n      } catch (e) {\n        throw new SolanaSignerError(\n          \"Wallet standard wallet failed to sign transaction\",\n          { cause: e as Error },\n        );\n      }\n\n      if (!output) {\n        throw new SolanaSignerError(\"Wallet returned no signed transaction.\");\n      }\n\n      if (!(output.signedTransaction instanceof Uint8Array)) {\n        throw new SolanaSignerError(\n          \"Wallet returned an invalid signed transaction.\",\n        );\n      }\n\n      return output;\n    },\n  };\n}\n"]}

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

@@ -0,0 +1,10 @@
+/**
+ * Finds the signature slot index for `signerAddress` by decoding the
+ * transaction message and looking up the address in the account keys.
+ * Tries `@solana/kit` first, falls back to `@solana/web3.js`.
+ *
+ * @param {Uint8Array} transaction - The serialized Solana transaction bytes
+ * @param {string} signerAddress - The base58-encoded address of the signer
+ * @returns {Promise<number>} The slot index, or -1 if the address is not a required signer
+ */
+export declare function findSignerSlot(transaction: Uint8Array, signerAddress: string): Promise<number>;

package/dist/esm/adapters/resolveSignerSlot.js

@@ -0,0 +1,39 @@
+import { SolanaSignerError } from "./SolanaSignerError.js";
+/**
+ * Finds the signature slot index for `signerAddress` by decoding the
+ * transaction message and looking up the address in the account keys.
+ * Tries `@solana/kit` first, falls back to `@solana/web3.js`.
+ *
+ * @param {Uint8Array} transaction - The serialized Solana transaction bytes
+ * @param {string} signerAddress - The base58-encoded address of the signer
+ * @returns {Promise<number>} The slot index, or -1 if the address is not a required signer
+ */
+export async function findSignerSlot(transaction, signerAddress) {
+    let accounts;
+    let numRequiredSigners;
+    try {
+        const { getCompiledTransactionMessageDecoder } = await import("@solana/kit");
+        const numSigs = transaction[0];
+        const messageBytes = transaction.slice(1 + numSigs * 64);
+        const decoded = getCompiledTransactionMessageDecoder().decode(messageBytes);
+        accounts = decoded.staticAccounts;
+        numRequiredSigners = decoded.header.numSignerAccounts;
+    }
+    catch {
+        try {
+            const { VersionedTransaction } = await import("@solana/web3.js");
+            const vtx = VersionedTransaction.deserialize(transaction);
+            accounts = vtx.message.staticAccountKeys.map((k) => k.toBase58());
+            numRequiredSigners = vtx.message.header.numRequiredSignatures;
+        }
+        catch {
+            throw new SolanaSignerError("Failed to decode transaction: install @solana/kit or @solana/web3.js");
+        }
+    }
+    const slotIndex = accounts.indexOf(signerAddress);
+    if (slotIndex < 0 || slotIndex >= numRequiredSigners) {
+        return -1;
+    }
+    return slotIndex;
+}
+//# sourceMappingURL=resolveSignerSlot.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolveSignerSlot.js","sourceRoot":"","sources":["../../../src/adapters/resolveSignerSlot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,WAAuB,EACvB,aAAqB;IAErB,IAAI,QAA2B,CAAC;IAChC,IAAI,kBAA0B,CAAC;IAE/B,IAAI,CAAC;QACH,MAAM,EAAE,oCAAoC,EAAE,GAAG,MAAM,MAAM,CAC3D,aAAa,CACd,CAAC;QACF,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,YAAY,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,GAAG,OAAO,GAAG,EAAE,CAAC,CAAC;QACzD,MAAM,OAAO,GAAG,oCAAoC,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAC5E,QAAQ,GAAG,OAAO,CAAC,cAAmC,CAAC;QACvD,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,CAAC;YACH,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;YACjE,MAAM,GAAG,GAAG,oBAAoB,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;YAC1D,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;YAClE,kBAAkB,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,qBAAqB,CAAC;QAChE,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,iBAAiB,CACzB,sEAAsE,CACvE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAClD,IAAI,SAAS,GAAG,CAAC,IAAI,SAAS,IAAI,kBAAkB,EAAE,CAAC;QACrD,OAAO,CAAC,CAAC,CAAC;IACZ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC","sourcesContent":["import { SolanaSignerError } from \"./SolanaSignerError.js\";\n\n/**\n * Finds the signature slot index for `signerAddress` by decoding the\n * transaction message and looking up the address in the account keys.\n * Tries `@solana/kit` first, falls back to `@solana/web3.js`.\n *\n * @param {Uint8Array} transaction - The serialized Solana transaction bytes\n * @param {string} signerAddress - The base58-encoded address of the signer\n * @returns {Promise<number>} The slot index, or -1 if the address is not a required signer\n */\nexport async function findSignerSlot(\n  transaction: Uint8Array,\n  signerAddress: string,\n): Promise<number> {\n  let accounts: readonly string[];\n  let numRequiredSigners: number;\n\n  try {\n    const { getCompiledTransactionMessageDecoder } = await import(\n      \"@solana/kit\"\n    );\n    const numSigs = transaction[0];\n    const messageBytes = transaction.slice(1 + numSigs * 64);\n    const decoded = getCompiledTransactionMessageDecoder().decode(messageBytes);\n    accounts = decoded.staticAccounts as readonly string[];\n    numRequiredSigners = decoded.header.numSignerAccounts;\n  } catch {\n    try {\n      const { VersionedTransaction } = await import(\"@solana/web3.js\");\n      const vtx = VersionedTransaction.deserialize(transaction);\n      accounts = vtx.message.staticAccountKeys.map((k) => k.toBase58());\n      numRequiredSigners = vtx.message.header.numRequiredSignatures;\n    } catch {\n      throw new SolanaSignerError(\n        \"Failed to decode transaction: install @solana/kit or @solana/web3.js\",\n      );\n    }\n  }\n\n  const slotIndex = accounts.indexOf(signerAddress);\n  if (slotIndex < 0 || slotIndex >= numRequiredSigners) {\n    return -1;\n  }\n  return slotIndex;\n}\n"]}

package/dist/esm/client.d.ts

@@ -1,7 +1,9 @@
 import { type Address, type Chain } from "viem";
-import type { SmartWalletClient, SmartWalletSigner } from "./types.js";
+import type { SmartWalletClient, SmartWalletSigner, SolanaSmartWalletClient, SolanaSigner, SolanaChainDef } from "./types.js";
 import type { AlchemyWalletTransport } from "./transport.js";
-export type CreateSmartWalletClientParams = {
+import type { SolanaChainId } from "@alchemy/wallet-api-types";
+export declare const SOLANA_CHAINS: Record<SolanaChainId, SolanaChainDef>;
+export type CreateEvmSmartWalletClientParams = {
     signer: SmartWalletSigner;
     transport: AlchemyWalletTransport;
     chain: Chain;
@@ -11,19 +13,32 @@ export type CreateSmartWalletClientParams = {
         policyIds?: string[];
     };
 };
+export type CreateSolanaSmartWalletClientParams = {
+    signer: SolanaSigner;
+    transport: AlchemyWalletTransport;
+    chain: SolanaChainId;
+    account?: string;
+    paymaster?: {
+        policyId: string;
+    };
+};
+/** Either {@link CreateEvmSmartWalletClientParams} or {@link CreateSolanaSmartWalletClientParams}. */
+export type CreateSmartWalletClientParams = CreateEvmSmartWalletClientParams | CreateSolanaSmartWalletClientParams;
+/**
+ * Creates a smart wallet client for EVM chains with actions for preparing,
+ * signing, and sending user operations.
+ *
+ * @param {CreateEvmSmartWalletClientParams} params - EVM client configuration
+ * @returns {SmartWalletClient} An EVM smart wallet client with smart wallet actions
+ */
+export declare function createSmartWalletClient(params: CreateEvmSmartWalletClientParams): SmartWalletClient;
 /**
- * Creates a smart wallet client with wallet API actions.
+ * Creates a smart wallet client for Solana chains with actions for preparing,
+ * signing, and sending transactions.
  *
- * By default, the client uses EIP-7702 with the signer's address, allowing you to call
- * `prepareCalls` or `sendCalls` directly without first calling `requestAccount`.
- * Use `requestAccount` only if you need a non-7702 smart account.
+ * Solana-specific adapters are in `@alchemy/wallet-apis/solana`.
  *
- * @param {CreateSmartWalletClientParams} params - Parameters for creating the smart wallet client.
- * @param {SmartWalletSigner} params.signer - The signer to use for signing transactions.
- * @param {AlchemyWalletTransport} params.transport - The transport to use for RPC calls.
- * @param {Chain} params.chain - The blockchain network to connect to.
- * @param {AccountParam} [params.account] - Optional account. Can be an address string or an object with an `address` property. Defaults to the signer's address (EIP-7702).
- * @param {object} [params.paymaster] - Optional paymaster configuration with policy IDs.
- * @returns {SmartWalletClient} A wallet client extended with smart wallet actions.
+ * @param {CreateSolanaSmartWalletClientParams} params - Solana client configuration
+ * @returns {SolanaSmartWalletClient} A Solana smart wallet client with Solana smart wallet actions
  */
-export declare const createSmartWalletClient: ({ signer, transport, chain, account, paymaster, }: CreateSmartWalletClientParams) => SmartWalletClient;
+export declare function createSmartWalletClient(params: CreateSolanaSmartWalletClientParams): SolanaSmartWalletClient;

package/dist/esm/client.js

@@ -1,25 +1,48 @@
-import { createClient } from "viem";
+import { BaseError } from "@alchemy/common";
+import { createClient, defineChain } from "viem";
 import { smartWalletActions } from "./decorators/smartWalletActions.js";
+import { solanaSmartWalletActions } from "./decorators/solanaSmartWalletActions.js";
 import { createInternalState } from "./internal.js";
 import { isLocalAccount } from "./utils/assertions.js";
-/**
- * Creates a smart wallet client with wallet API actions.
- *
- * By default, the client uses EIP-7702 with the signer's address, allowing you to call
- * `prepareCalls` or `sendCalls` directly without first calling `requestAccount`.
- * Use `requestAccount` only if you need a non-7702 smart account.
- *
- * @param {CreateSmartWalletClientParams} params - Parameters for creating the smart wallet client.
- * @param {SmartWalletSigner} params.signer - The signer to use for signing transactions.
- * @param {AlchemyWalletTransport} params.transport - The transport to use for RPC calls.
- * @param {Chain} params.chain - The blockchain network to connect to.
- * @param {AccountParam} [params.account] - Optional account. Can be an address string or an object with an `address` property. Defaults to the signer's address (EIP-7702).
- * @param {object} [params.paymaster] - Optional paymaster configuration with policy IDs.
- * @returns {SmartWalletClient} A wallet client extended with smart wallet actions.
- */
-export const createSmartWalletClient = ({ signer, transport, chain, account, paymaster, }) => {
+// ── Solana chain definitions ────────────────────────────────────────────
+const solanaMainnet = {
+    ...defineChain({
+        id: 0,
+        name: "Solana Mainnet",
+        nativeCurrency: { name: "SOL", symbol: "SOL", decimals: 9 },
+        rpcUrls: { default: { http: [] } },
+    }),
+    solanaChainId: "solana:mainnet",
+};
+const solanaDevnet = {
+    ...defineChain({
+        id: 0,
+        name: "Solana Devnet",
+        nativeCurrency: { name: "SOL", symbol: "SOL", decimals: 9 },
+        rpcUrls: { default: { http: [] } },
+    }),
+    solanaChainId: "solana:devnet",
+};
+export const SOLANA_CHAINS = {
+    "solana:mainnet": solanaMainnet,
+    "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp": solanaMainnet,
+    "solana:devnet": solanaDevnet,
+    "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1": solanaDevnet,
+};
+// ── Factory ─────────────────────────────────────────────────────────────
+function isSolanaParams(params) {
+    return typeof params.chain === "string" && params.chain.startsWith("solana:");
+}
+export function createSmartWalletClient(params) {
+    if (isSolanaParams(params)) {
+        return createSolanaClient(params);
+    }
+    return createEvmClient(params);
+}
+// ── EVM path ────────────────────────────────────────────────────────────
+function createEvmClient({ signer, transport, chain, account, paymaster, }) {
     const _policyIds = [
-        ...(paymaster?.policyId ? [paymaster?.policyId] : []),
+        ...(paymaster?.policyId ? [paymaster.policyId] : []),
         ...(paymaster?.policyIds ?? []),
     ];
     // If no account address is provided, the client defaults to using the signer's address via EIP-7702.
@@ -37,5 +60,26 @@ export const createSmartWalletClient = ({ signer, transport, chain, account, pay
         owner: signer,
     }))
         .extend(smartWalletActions);
-};
+}
+// ── Solana path ─────────────────────────────────────────────────────────
+function createSolanaClient({ signer, transport, chain, account, paymaster, }) {
+    const _policyIds = paymaster?.policyId ? [paymaster.policyId] : [];
+    const _account = account ?? signer.address;
+    const _chain = SOLANA_CHAINS[chain];
+    if (!_chain) {
+        throw new BaseError(`Unsupported Solana chain: ${chain}`);
+    }
+    return createClient({
+        transport,
+        chain: _chain,
+        name: "alchemySolanaSmartWalletClient",
+    })
+        .extend(() => ({
+        policyIds: _policyIds,
+        internal: createInternalState(),
+        owner: signer,
+        solanaAccount: _account,
+    }))
+        .extend(solanaSmartWalletActions);
+}
 //# sourceMappingURL=client.js.map

package/dist/esm/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAA4B,MAAM,MAAM,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAExE,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAcvD;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,EACtC,MAAM,EACN,SAAS,EACT,KAAK,EACL,OAAO,EACP,SAAS,GACqB,EAAqB,EAAE;IACrD,MAAM,UAAU,GAAG;QACjB,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,GAAG,CAAC,SAAS,EAAE,SAAS,IAAI,EAAE,CAAC;KAChC,CAAC;IAEF,qGAAqG;IACrG,MAAM,QAAQ,GACZ,OAAO;QACP,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAErE,OAAO,YAAY,CAAC;QAClB,OAAO,EAAE,QAAQ;QACjB,SAAS;QACT,KAAK;QACL,IAAI,EAAE,0BAA0B;KACjC,CAAC;SACC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;QACb,SAAS,EAAE,UAAU;QACrB,QAAQ,EAAE,mBAAmB,EAAE;QAC/B,KAAK,EAAE,MAAM;KACd,CAAC,CAAC;SACF,MAAM,CAAC,kBAAkB,CAAC,CAAC;AAChC,CAAC,CAAC","sourcesContent":["import { createClient, type Address, type Chain } from \"viem\";\nimport { smartWalletActions } from \"./decorators/smartWalletActions.js\";\nimport type { SmartWalletClient, SmartWalletSigner } from \"./types.js\";\nimport { createInternalState } from \"./internal.js\";\nimport { isLocalAccount } from \"./utils/assertions.js\";\nimport type { AlchemyWalletTransport } from \"./transport.js\";\n\nexport type CreateSmartWalletClientParams = {\n  signer: SmartWalletSigner;\n  transport: AlchemyWalletTransport;\n  chain: Chain;\n  account?: Address;\n  paymaster?: {\n    policyId?: string;\n    policyIds?: string[];\n  };\n};\n\n/**\n * Creates a smart wallet client with wallet API actions.\n *\n * By default, the client uses EIP-7702 with the signer's address, allowing you to call\n * `prepareCalls` or `sendCalls` directly without first calling `requestAccount`.\n * Use `requestAccount` only if you need a non-7702 smart account.\n *\n * @param {CreateSmartWalletClientParams} params - Parameters for creating the smart wallet client.\n * @param {SmartWalletSigner} params.signer - The signer to use for signing transactions.\n * @param {AlchemyWalletTransport} params.transport - The transport to use for RPC calls.\n * @param {Chain} params.chain - The blockchain network to connect to.\n * @param {AccountParam} [params.account] - Optional account. Can be an address string or an object with an `address` property. Defaults to the signer's address (EIP-7702).\n * @param {object} [params.paymaster] - Optional paymaster configuration with policy IDs.\n * @returns {SmartWalletClient} A wallet client extended with smart wallet actions.\n */\nexport const createSmartWalletClient = ({\n  signer,\n  transport,\n  chain,\n  account,\n  paymaster,\n}: CreateSmartWalletClientParams): SmartWalletClient => {\n  const _policyIds = [\n    ...(paymaster?.policyId ? [paymaster?.policyId] : []),\n    ...(paymaster?.policyIds ?? []),\n  ];\n\n  // If no account address is provided, the client defaults to using the signer's address via EIP-7702.\n  const _account =\n    account ??\n    (isLocalAccount(signer) ? signer.address : signer.account.address);\n\n  return createClient({\n    account: _account,\n    transport,\n    chain,\n    name: \"alchemySmartWalletClient\",\n  })\n    .extend(() => ({\n      policyIds: _policyIds,\n      internal: createInternalState(),\n      owner: signer,\n    }))\n    .extend(smartWalletActions);\n};\n"]}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"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","sourcesContent":["import { BaseError } from \"@alchemy/common\";\nimport { createClient, defineChain, type Address, type Chain } from \"viem\";\nimport { smartWalletActions } from \"./decorators/smartWalletActions.js\";\nimport { solanaSmartWalletActions } from \"./decorators/solanaSmartWalletActions.js\";\nimport type {\n  SmartWalletClient,\n  SmartWalletSigner,\n  SolanaSmartWalletClient,\n  SolanaSigner,\n  SolanaChainDef,\n} from \"./types.js\";\nimport { createInternalState } from \"./internal.js\";\nimport { isLocalAccount } from \"./utils/assertions.js\";\nimport type { AlchemyWalletTransport } from \"./transport.js\";\nimport type { SolanaChainId } from \"@alchemy/wallet-api-types\";\n\n// ── Solana chain definitions ────────────────────────────────────────────\n\nconst solanaMainnet: SolanaChainDef = {\n  ...defineChain({\n    id: 0,\n    name: \"Solana Mainnet\",\n    nativeCurrency: { name: \"SOL\", symbol: \"SOL\", decimals: 9 },\n    rpcUrls: { default: { http: [] } },\n  }),\n  solanaChainId: \"solana:mainnet\",\n};\n\nconst solanaDevnet: SolanaChainDef = {\n  ...defineChain({\n    id: 0,\n    name: \"Solana Devnet\",\n    nativeCurrency: { name: \"SOL\", symbol: \"SOL\", decimals: 9 },\n    rpcUrls: { default: { http: [] } },\n  }),\n  solanaChainId: \"solana:devnet\",\n};\n\nexport const SOLANA_CHAINS: Record<SolanaChainId, SolanaChainDef> = {\n  \"solana:mainnet\": solanaMainnet,\n  \"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp\": solanaMainnet,\n  \"solana:devnet\": solanaDevnet,\n  \"solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1\": solanaDevnet,\n};\n\n// ── Param types ─────────────────────────────────────────────────────────\n\nexport type CreateEvmSmartWalletClientParams = {\n  signer: SmartWalletSigner;\n  transport: AlchemyWalletTransport;\n  chain: Chain;\n  account?: Address;\n  paymaster?: {\n    policyId?: string;\n    policyIds?: string[];\n  };\n};\n\nexport type CreateSolanaSmartWalletClientParams = {\n  signer: SolanaSigner;\n  transport: AlchemyWalletTransport;\n  chain: SolanaChainId;\n  account?: string;\n  paymaster?: {\n    policyId: string;\n  };\n};\n\n/** Either {@link CreateEvmSmartWalletClientParams} or {@link CreateSolanaSmartWalletClientParams}. */\nexport type CreateSmartWalletClientParams =\n  | CreateEvmSmartWalletClientParams\n  | CreateSolanaSmartWalletClientParams;\n\n// ── Factory ─────────────────────────────────────────────────────────────\n\nfunction isSolanaParams(\n  params: CreateSmartWalletClientParams,\n): params is CreateSolanaSmartWalletClientParams {\n  return typeof params.chain === \"string\" && params.chain.startsWith(\"solana:\");\n}\n\n/**\n * Creates a smart wallet client for EVM chains with actions for preparing,\n * signing, and sending user operations.\n *\n * @param {CreateEvmSmartWalletClientParams} params - EVM client configuration\n * @returns {SmartWalletClient} An EVM smart wallet client with smart wallet actions\n */\nexport function createSmartWalletClient(\n  params: CreateEvmSmartWalletClientParams,\n): SmartWalletClient;\n/**\n * Creates a smart wallet client for Solana chains with actions for preparing,\n * signing, and sending transactions.\n *\n * Solana-specific adapters are in `@alchemy/wallet-apis/solana`.\n *\n * @param {CreateSolanaSmartWalletClientParams} params - Solana client configuration\n * @returns {SolanaSmartWalletClient} A Solana smart wallet client with Solana smart wallet actions\n */\nexport function createSmartWalletClient(\n  params: CreateSolanaSmartWalletClientParams,\n): SolanaSmartWalletClient;\nexport function createSmartWalletClient(\n  params: CreateSmartWalletClientParams,\n): SmartWalletClient | SolanaSmartWalletClient {\n  if (isSolanaParams(params)) {\n    return createSolanaClient(params);\n  }\n  return createEvmClient(params);\n}\n\n// ── EVM path ────────────────────────────────────────────────────────────\n\nfunction createEvmClient({\n  signer,\n  transport,\n  chain,\n  account,\n  paymaster,\n}: CreateEvmSmartWalletClientParams): SmartWalletClient {\n  const _policyIds = [\n    ...(paymaster?.policyId ? [paymaster.policyId] : []),\n    ...(paymaster?.policyIds ?? []),\n  ];\n\n  // If no account address is provided, the client defaults to using the signer's address via EIP-7702.\n  const _account =\n    account ??\n    (isLocalAccount(signer) ? signer.address : signer.account.address);\n\n  return createClient({\n    account: _account,\n    transport,\n    chain,\n    name: \"alchemySmartWalletClient\",\n  })\n    .extend(() => ({\n      policyIds: _policyIds,\n      internal: createInternalState(),\n      owner: signer,\n    }))\n    .extend(smartWalletActions);\n}\n\n// ── Solana path ─────────────────────────────────────────────────────────\n\nfunction createSolanaClient({\n  signer,\n  transport,\n  chain,\n  account,\n  paymaster,\n}: CreateSolanaSmartWalletClientParams): SolanaSmartWalletClient {\n  const _policyIds = paymaster?.policyId ? [paymaster.policyId] : [];\n\n  const _account = account ?? signer.address;\n\n  const _chain = SOLANA_CHAINS[chain];\n  if (!_chain) {\n    throw new BaseError(`Unsupported Solana chain: ${chain}`);\n  }\n\n  return createClient({\n    transport,\n    chain: _chain,\n    name: \"alchemySolanaSmartWalletClient\",\n  })\n    .extend(() => ({\n      policyIds: _policyIds,\n      internal: createInternalState(),\n      owner: signer,\n      solanaAccount: _account,\n    }))\n    .extend(solanaSmartWalletActions);\n}\n"]}

package/dist/esm/decorators/smartWalletActions.d.ts

@@ -10,6 +10,7 @@ import { type SignMessageParams } from "../actions/signMessage.js";
 import { type SignTypedDataParams } from "../actions/signTypedData.js";
 import { type GrantPermissionsParams, type GrantPermissionsResult } from "../actions/grantPermissions.js";
 import { type GetCapabilitiesParams, type GetCapabilitiesResult } from "../actions/getCapabilities.js";
+import { type UndelegateAccountParams, type UndelegateAccountResult } from "../actions/undelegateAccount.js";
 import type { InnerWalletApiClient } from "../types.js";
 import { type GetCallsStatusParameters, type GetCallsStatusReturnType, type WaitForCallsStatusParameters, type WaitForCallsStatusReturnType } from "viem/actions";
 export type SmartWalletActions = {
@@ -26,6 +27,7 @@ export type SmartWalletActions = {
     getCallsStatus: (params: GetCallsStatusParameters) => Promise<GetCallsStatusReturnType>;
     waitForCallsStatus: (params: WaitForCallsStatusParameters) => Promise<WaitForCallsStatusReturnType>;
     getCapabilities: (params?: GetCapabilitiesParams | undefined) => Promise<GetCapabilitiesResult>;
+    undelegateAccount: (params?: UndelegateAccountParams) => Promise<UndelegateAccountResult>;
 };
 /**
  * Decorator that adds smart wallet actions to a wallet API client.

package/dist/esm/decorators/smartWalletActions.js

@@ -10,6 +10,7 @@ import { signMessage } from "../actions/signMessage.js";
 import { signTypedData, } from "../actions/signTypedData.js";
 import { grantPermissions, } from "../actions/grantPermissions.js";
 import { getCapabilities, } from "../actions/getCapabilities.js";
+import { undelegateAccount, } from "../actions/undelegateAccount.js";
 import { getCallsStatus, waitForCallsStatus, } from "viem/actions";
 /**
  * Decorator that adds smart wallet actions to a wallet API client.
@@ -19,7 +20,7 @@ import { getCallsStatus, waitForCallsStatus, } from "viem/actions";
  * @returns {SmartWalletActions} An object containing smart wallet action methods
  */
 export const smartWalletActions = (client) => ({
-    // Alchemy methods.
+    // Alchemy actions.
     requestAccount: (params) => requestAccount(client, params),
     prepareCalls: (params) => prepareCalls(client, params),
     listAccounts: (params) => listAccounts(client, params),
@@ -31,7 +32,8 @@ export const smartWalletActions = (client) => ({
     signTypedData: (params) => signTypedData(client, params),
     grantPermissions: (params) => grantPermissions(client, params),
     getCapabilities: (params) => getCapabilities(client, params),
-    // Viem methods.
+    undelegateAccount: (params) => undelegateAccount(client, params),
+    // Viem actions.
     getCallsStatus: (params) => getCallsStatus(client, params),
     waitForCallsStatus: (params) => waitForCallsStatus(client, params),
 });