@account-kit/signer 4.25.1 → 4.27.0

package/dist/esm/index.d.ts

@@ -9,3 +9,4 @@ export { AlchemyWebSigner } from "./signer.js";
 export type * from "./solanaSigner.js";
 export type * from "./types.js";
 export { AlchemySignerStatus } from "./types.js";
+export { SolanaSigner } from "./solanaSigner.js";

package/dist/esm/index.js

@@ -5,4 +5,5 @@ export { NotAuthenticatedError, OAuthProvidersError, MfaRequiredError, } from ".
 export { DEFAULT_SESSION_MS, SessionManagerParamsSchema, } from "./session/manager.js";
 export { AlchemyWebSigner } from "./signer.js";
 export { AlchemySignerStatus } from "./types.js";
+export { SolanaSigner } from "./solanaSigner.js";
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,kBAAkB,EAClB,0BAA0B,GAC3B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC","sourcesContent":["export { BaseAlchemySigner } from \"./base.js\";\nexport { BaseSignerClient } from \"./client/base.js\";\nexport {\n  AlchemySignerWebClient,\n  OauthCancelledError,\n  OauthFailedError,\n} from \"./client/index.js\";\nexport type * from \"./client/types.js\";\nexport {\n  NotAuthenticatedError,\n  OAuthProvidersError,\n  MfaRequiredError,\n} from \"./errors.js\";\nexport {\n  DEFAULT_SESSION_MS,\n  SessionManagerParamsSchema,\n} from \"./session/manager.js\";\nexport type * from \"./signer.js\";\nexport { AlchemyWebSigner } from \"./signer.js\";\nexport type * from \"./solanaSigner.js\";\nexport type * from \"./types.js\";\nexport { AlchemySignerStatus } from \"./types.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,kBAAkB,EAClB,0BAA0B,GAC3B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC","sourcesContent":["export { BaseAlchemySigner } from \"./base.js\";\nexport { BaseSignerClient } from \"./client/base.js\";\nexport {\n  AlchemySignerWebClient,\n  OauthCancelledError,\n  OauthFailedError,\n} from \"./client/index.js\";\nexport type * from \"./client/types.js\";\nexport {\n  NotAuthenticatedError,\n  OAuthProvidersError,\n  MfaRequiredError,\n} from \"./errors.js\";\nexport {\n  DEFAULT_SESSION_MS,\n  SessionManagerParamsSchema,\n} from \"./session/manager.js\";\nexport type * from \"./signer.js\";\nexport { AlchemyWebSigner } from \"./signer.js\";\nexport type * from \"./solanaSigner.js\";\nexport type * from \"./types.js\";\nexport { AlchemySignerStatus } from \"./types.js\";\nexport { SolanaSigner } from \"./solanaSigner.js\";\n"]}

package/dist/esm/solanaSigner.d.ts

@@ -1,12 +1,45 @@
-import { Transaction, type VersionedTransaction } from "@solana/web3.js";
+import { Connection, Transaction, TransactionInstruction, VersionedTransaction } from "@solana/web3.js";
 import { type ByteArray } from "viem";
 import type { BaseSignerClient } from "./client/base";
+/**
+ * The SolanaSigner class is used to sign transactions and messages for the Solana blockchain.
+ * It provides methods to add signatures to transactions and sign messages.
+ */
 export declare class SolanaSigner {
-    private alchemyClient;
-    address: string;
+    readonly alchemyClient: BaseSignerClient;
+    readonly address: string;
+    /**
+     * Constructor for the SolanaSigner class which is a wrapper around the alchemy client, and is more focused on the solana web3
+     *
+     * @param {object} client This is the client that will be used to sign the transaction, and we are just having functions on top of it.
+     */
     constructor(client: BaseSignerClient);
-    addSignature(tx: Transaction | VersionedTransaction): Promise<Transaction | VersionedTransaction>;
+    /**
+     * Adds a signature of the client user to a transaction
+     *
+     * @param {Transaction | VersionedTransaction} transaction - The transaction to add the signature to
+     * @returns {Promise<Transaction | VersionedTransaction >} The transaction with the signature added
+     */
+    addSignature(transaction: Transaction | VersionedTransaction): Promise<Transaction | VersionedTransaction>;
+    /**
+     * Signs a message
+     *
+     * @param {Uint8Array} message - The message to sign
+     * @returns {Promise<ByteArray>} The signature of the message
+     */
     signMessage(message: Uint8Array): Promise<ByteArray>;
+    createTransfer(instructions: TransactionInstruction[], connection: Connection, version?: "versioned"): Promise<VersionedTransaction>;
+    createTransfer(instructions: TransactionInstruction[], connection: Connection, version?: "legacy"): Promise<Transaction>;
+    createTransfer(instructions: TransactionInstruction[], connection: Connection): Promise<VersionedTransaction>;
+    /**
+     * Adds sponsorship to a transaction. Used to have a party like Alchemy pay for the transaction.
+     *
+     * @param {TransactionInstruction[]} instructions - The instructions to add to the transaction
+     * @param {Connection} connection - The connection to use for the transaction
+     * @param {string} [policyId] - The policy ID to add sponsorship to
+     * @returns {Promise<VersionedTransaction>} The transaction with sponsorship added
+     */
+    addSponsorship(instructions: TransactionInstruction[], connection: Connection, policyId: string): Promise<VersionedTransaction>;
     private formatSignatureForSolana;
     private getMessageToSign;
 }

package/dist/esm/solanaSigner.js

@@ -1,8 +1,16 @@
-import { PublicKey, Transaction, } from "@solana/web3.js";
+import { Connection, PublicKey, Transaction, TransactionInstruction, TransactionMessage, VersionedTransaction, } from "@solana/web3.js";
 import { size, slice, toBytes, toHex } from "viem";
 import { NotAuthenticatedError } from "./errors.js";
-// TODO: I don't want this to be a class so that the flow is closer to how we do this for `toViemAccount`
+/**
+ * The SolanaSigner class is used to sign transactions and messages for the Solana blockchain.
+ * It provides methods to add signatures to transactions and sign messages.
+ */
 export class SolanaSigner {
+    /**
+     * Constructor for the SolanaSigner class which is a wrapper around the alchemy client, and is more focused on the solana web3
+     *
+     * @param {object} client This is the client that will be used to sign the transaction, and we are just having functions on top of it.
+     */
     constructor(client) {
         Object.defineProperty(this, "alchemyClient", {
             enumerable: true,
@@ -22,7 +30,13 @@ export class SolanaSigner {
         // TODO: also throw here
         this.address = client.getUser().solanaAddress;
     }
-    async addSignature(tx) {
+    /**
+     * Adds a signature of the client user to a transaction
+     *
+     * @param {Transaction | VersionedTransaction} transaction - The transaction to add the signature to
+     * @returns {Promise<Transaction | VersionedTransaction >} The transaction with the signature added
+     */
+    async addSignature(transaction) {
         const user = this.alchemyClient.getUser();
         if (!user) {
             throw new NotAuthenticatedError();
@@ -31,11 +45,17 @@ export class SolanaSigner {
             throw new Error("no solana address");
         }
         const fromKey = new PublicKey(user.solanaAddress);
-        const messageToSign = this.getMessageToSign(tx);
+        const messageToSign = this.getMessageToSign(transaction);
         const signature = await this.alchemyClient.signRawMessage(messageToSign, "SOLANA");
-        tx.addSignature(fromKey, Buffer.from(toBytes(this.formatSignatureForSolana(signature))));
-        return tx;
+        transaction.addSignature(fromKey, Buffer.from(toBytes(this.formatSignatureForSolana(signature))));
+        return transaction;
     }
+    /**
+     * Signs a message
+     *
+     * @param {Uint8Array} message - The message to sign
+     * @returns {Promise<ByteArray>} The signature of the message
+     */
     async signMessage(message) {
         const user = this.alchemyClient.getUser();
         if (!user) {
@@ -48,6 +68,84 @@ export class SolanaSigner {
         const signature = await this.alchemyClient.signRawMessage(messageToSign, "SOLANA");
         return toBytes(this.formatSignatureForSolana(signature));
     }
+    /**
+     * Creates a transfer transaction. Used for the SolanaCard example.
+     *
+     * @param {TransactionInstruction[]} instructions - The instructions to add to the transaction
+     * @param {Connection} connection - The connection to use for the transaction
+     * @param {"versioned" | "legacy"} [version] - The version of the transaction
+     * @returns {Promise<Transaction | VersionedTransaction>} The transfer transaction
+     */
+    async createTransfer(instructions, connection, version) {
+        const blockhash = (await connection.getLatestBlockhash()).blockhash;
+        let transferTransaction;
+        if (version === "legacy") {
+            // Legacy transaction
+            transferTransaction = instructions.reduce((tx, instruction) => tx.add(instruction), new Transaction());
+            // Get a recent block hash
+            transferTransaction.recentBlockhash = blockhash;
+            // Set the signer
+            transferTransaction.feePayer = new PublicKey(this.address);
+        }
+        else {
+            // VersionedTransaction
+            const txMessage = new TransactionMessage({
+                payerKey: new PublicKey(this.address),
+                recentBlockhash: blockhash,
+                instructions,
+            });
+            const versionedTxMessage = txMessage.compileToV0Message();
+            transferTransaction = new VersionedTransaction(versionedTxMessage);
+        }
+        return transferTransaction;
+    }
+    /**
+     * Adds sponsorship to a transaction. Used to have a party like Alchemy pay for the transaction.
+     *
+     * @param {TransactionInstruction[]} instructions - The instructions to add to the transaction
+     * @param {Connection} connection - The connection to use for the transaction
+     * @param {string} [policyId] - The policy ID to add sponsorship to
+     * @returns {Promise<VersionedTransaction>} The transaction with sponsorship added
+     */
+    async addSponsorship(instructions, connection, policyId) {
+        const { blockhash } = await connection.getLatestBlockhash({
+            commitment: "finalized",
+        });
+        const message = new TransactionMessage({
+            // Right now the backend will rewrite this payer Key to the server's address
+            payerKey: new PublicKey(this.address),
+            recentBlockhash: blockhash,
+            instructions,
+        }).compileToV0Message();
+        const versionedTransaction = new VersionedTransaction(message);
+        const serializedTransaction = Buffer.from(versionedTransaction.serialize()).toString("base64");
+        const body = JSON.stringify({
+            id: crypto?.randomUUID() ?? Math.floor(Math.random() * 1000000),
+            jsonrpc: "2.0",
+            method: "alchemy_requestFeePayer",
+            params: [
+                {
+                    policyId,
+                    serializedTransaction,
+                },
+            ],
+        });
+        const options = {
+            method: "POST",
+            headers: {
+                accept: "application/json",
+                "content-type": "application/json",
+            },
+            body,
+        };
+        const response = await fetch(
+        // TODO: Use the connection??
+        connection.rpcEndpoint, options);
+        const jsonResponse = await response.json();
+        if (!jsonResponse?.result?.serializedTransaction)
+            throw new Error(`Response doesn't include the serializedTransaction ${JSON.stringify(jsonResponse)}`);
+        return VersionedTransaction.deserialize(decodeBase64(jsonResponse.result.serializedTransaction));
+    }
     formatSignatureForSolana(signature) {
         if (size(signature) === 64)
             return signature;
@@ -64,4 +162,7 @@ export class SolanaSigner {
         return toHex(messageToSign);
     }
 }
+function decodeBase64(serializedTransaction) {
+    return Buffer.from(serializedTransaction, "base64");
+}
 //# sourceMappingURL=solanaSigner.js.map

package/dist/esm/solanaSigner.js.map

@@ -1 +1 @@
-{"version":3,"file":"solanaSigner.js","sourceRoot":"","sources":["../../src/solanaSigner.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,WAAW,GAEZ,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAA4B,MAAM,MAAM,CAAC;AAE7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEpD,yGAAyG;AACzG,MAAM,OAAO,YAAY;IAIvB,YAAY,MAAwB;QAH5B;;;;;WAAgC;QACjC;;;;;WAAgB;QAGrB,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC;QAC5B,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAEjE,wBAAwB;QACxB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,EAAG,CAAC,aAAc,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,EAAsC;QAEtC,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;QAC1C,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,qBAAqB,EAAE,CAAC;QACpC,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACvC,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAClD,MAAM,aAAa,GAAG,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;QAChD,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,cAAc,CACvD,aAAa,EACb,QAAQ,CACT,CAAC;QAEF,EAAE,CAAC,YAAY,CACb,OAAO,EACP,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,wBAAwB,CAAC,SAAS,CAAC,CAAC,CAAC,CAC/D,CAAC;QACF,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAAmB;QACnC,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;QAC1C,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,qBAAqB,EAAE,CAAC;QACpC,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACvC,CAAC;QAED,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,cAAc,CACvD,aAAa,EACb,QAAQ,CACT,CAAC;QAEF,OAAO,OAAO,CAAC,IAAI,CAAC,wBAAwB,CAAC,SAAS,CAAC,CAAC,CAAC;IAC3D,CAAC;IAEO,wBAAwB,CAAC,SAAc;QAC7C,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE;YAAE,OAAO,SAAS,CAAC;QAE7C,OAAO,KAAK,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IACjC,CAAC;IAEO,gBAAgB,CAAC,EAAsC;QAC7D,IAAI,aAAa,CAAC;QAClB,IAAI,EAAE,YAAY,WAAW,EAAE,CAAC;YAC9B,aAAa,GAAG,EAAE,CAAC,gBAAgB,EAAE,CAAC;QACxC,CAAC;aAAM,CAAC;YACN,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,KAAK,CAAC,aAAa,CAAC,CAAC;IAC9B,CAAC;CACF","sourcesContent":["import {\n  PublicKey,\n  Transaction,\n  type VersionedTransaction,\n} from \"@solana/web3.js\";\nimport { size, slice, toBytes, toHex, type ByteArray, type Hex } from \"viem\";\nimport type { BaseSignerClient } from \"./client/base\";\nimport { NotAuthenticatedError } from \"./errors.js\";\n\n// TODO: I don't want this to be a class so that the flow is closer to how we do this for `toViemAccount`\nexport class SolanaSigner {\n  private alchemyClient: BaseSignerClient;\n  public address: string;\n\n  constructor(client: BaseSignerClient) {\n    this.alchemyClient = client;\n    if (!client.getUser()) throw new Error(\"Must be authenticated!\");\n\n    // TODO: also throw here\n    this.address = client.getUser()!.solanaAddress!;\n  }\n\n  async addSignature(\n    tx: Transaction | VersionedTransaction\n  ): Promise<Transaction | VersionedTransaction> {\n    const user = this.alchemyClient.getUser();\n    if (!user) {\n      throw new NotAuthenticatedError();\n    }\n\n    if (!user.solanaAddress) {\n      throw new Error(\"no solana address\");\n    }\n\n    const fromKey = new PublicKey(user.solanaAddress);\n    const messageToSign = this.getMessageToSign(tx);\n    const signature = await this.alchemyClient.signRawMessage(\n      messageToSign,\n      \"SOLANA\"\n    );\n\n    tx.addSignature(\n      fromKey,\n      Buffer.from(toBytes(this.formatSignatureForSolana(signature)))\n    );\n    return tx;\n  }\n\n  async signMessage(message: Uint8Array): Promise<ByteArray> {\n    const user = this.alchemyClient.getUser();\n    if (!user) {\n      throw new NotAuthenticatedError();\n    }\n\n    if (!user.solanaAddress) {\n      throw new Error(\"no solana address\");\n    }\n\n    const messageToSign = toHex(message);\n    const signature = await this.alchemyClient.signRawMessage(\n      messageToSign,\n      \"SOLANA\"\n    );\n\n    return toBytes(this.formatSignatureForSolana(signature));\n  }\n\n  private formatSignatureForSolana(signature: Hex): Hex {\n    if (size(signature) === 64) return signature;\n\n    return slice(signature, 0, 64);\n  }\n\n  private getMessageToSign(tx: Transaction | VersionedTransaction): Hex {\n    let messageToSign;\n    if (tx instanceof Transaction) {\n      messageToSign = tx.serializeMessage();\n    } else {\n      messageToSign = Buffer.from(tx.message.serialize());\n    }\n    return toHex(messageToSign);\n  }\n}\n"]}
+{"version":3,"file":"solanaSigner.js","sourceRoot":"","sources":["../../src/solanaSigner.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  Connection,\n  PublicKey,\n  Transaction,\n  TransactionInstruction,\n  TransactionMessage,\n  VersionedTransaction,\n} from \"@solana/web3.js\";\nimport { size, slice, toBytes, toHex, type ByteArray, type Hex } from \"viem\";\nimport type { BaseSignerClient } from \"./client/base\";\nimport { NotAuthenticatedError } from \"./errors.js\";\n\n/**\n * The SolanaSigner class is used to sign transactions and messages for the Solana blockchain.\n * It provides methods to add signatures to transactions and sign messages.\n */\nexport class SolanaSigner {\n  readonly alchemyClient: BaseSignerClient;\n  public readonly address: string;\n\n  /**\n   * Constructor for the SolanaSigner class which is a wrapper around the alchemy client, and is more focused on the solana web3\n   *\n   * @param {object} client This is the client that will be used to sign the transaction, and we are just having functions on top of it.\n   */\n  constructor(client: BaseSignerClient) {\n    this.alchemyClient = client;\n    if (!client.getUser()) throw new Error(\"Must be authenticated!\");\n\n    // TODO: also throw here\n    this.address = client.getUser()!.solanaAddress!;\n  }\n\n  /**\n   * Adds a signature of the client user to a transaction\n   *\n   * @param {Transaction | VersionedTransaction} transaction - The transaction to add the signature to\n   * @returns {Promise<Transaction | VersionedTransaction >} The transaction with the signature added\n   */\n  async addSignature(\n    transaction: Transaction | VersionedTransaction\n  ): Promise<Transaction | VersionedTransaction> {\n    const user = this.alchemyClient.getUser();\n    if (!user) {\n      throw new NotAuthenticatedError();\n    }\n\n    if (!user.solanaAddress) {\n      throw new Error(\"no solana address\");\n    }\n\n    const fromKey = new PublicKey(user.solanaAddress);\n    const messageToSign = this.getMessageToSign(transaction);\n    const signature = await this.alchemyClient.signRawMessage(\n      messageToSign,\n      \"SOLANA\"\n    );\n\n    transaction.addSignature(\n      fromKey,\n      Buffer.from(toBytes(this.formatSignatureForSolana(signature)))\n    );\n    return transaction;\n  }\n\n  /**\n   * Signs a message\n   *\n   * @param {Uint8Array} message - The message to sign\n   * @returns {Promise<ByteArray>} The signature of the message\n   */\n  async signMessage(message: Uint8Array): Promise<ByteArray> {\n    const user = this.alchemyClient.getUser();\n    if (!user) {\n      throw new NotAuthenticatedError();\n    }\n\n    if (!user.solanaAddress) {\n      throw new Error(\"no solana address\");\n    }\n\n    const messageToSign = toHex(message);\n    const signature = await this.alchemyClient.signRawMessage(\n      messageToSign,\n      \"SOLANA\"\n    );\n\n    return toBytes(this.formatSignatureForSolana(signature));\n  }\n\n  async createTransfer(\n    instructions: TransactionInstruction[],\n    connection: Connection,\n    version?: \"versioned\"\n  ): Promise<VersionedTransaction>;\n  async createTransfer(\n    instructions: TransactionInstruction[],\n    connection: Connection,\n    version?: \"legacy\"\n  ): Promise<Transaction>;\n  async createTransfer(\n    instructions: TransactionInstruction[],\n    connection: Connection\n  ): Promise<VersionedTransaction>;\n\n  /**\n   * Creates a transfer transaction. Used for the SolanaCard example.\n   *\n   * @param {TransactionInstruction[]} instructions - The instructions to add to the transaction\n   * @param {Connection} connection - The connection to use for the transaction\n   * @param {\"versioned\" | \"legacy\"} [version] - The version of the transaction\n   * @returns {Promise<Transaction | VersionedTransaction>} The transfer transaction\n   */\n  async createTransfer(\n    instructions: TransactionInstruction[],\n    connection: Connection,\n    version?: string\n  ): Promise<Transaction | VersionedTransaction> {\n    const blockhash = (await connection.getLatestBlockhash()).blockhash;\n\n    let transferTransaction;\n\n    if (version === \"legacy\") {\n      // Legacy transaction\n      transferTransaction = instructions.reduce(\n        (tx, instruction) => tx.add(instruction),\n        new Transaction()\n      );\n\n      // Get a recent block hash\n      transferTransaction.recentBlockhash = blockhash;\n      // Set the signer\n      transferTransaction.feePayer = new PublicKey(this.address);\n    } else {\n      // VersionedTransaction\n      const txMessage = new TransactionMessage({\n        payerKey: new PublicKey(this.address),\n        recentBlockhash: blockhash,\n        instructions,\n      });\n\n      const versionedTxMessage = txMessage.compileToV0Message();\n      transferTransaction = new VersionedTransaction(versionedTxMessage);\n    }\n\n    return transferTransaction;\n  }\n\n  /**\n   * Adds sponsorship to a transaction. Used to have a party like Alchemy pay for the transaction.\n   *\n   * @param {TransactionInstruction[]} instructions - The instructions to add to the transaction\n   * @param {Connection} connection - The connection to use for the transaction\n   * @param {string} [policyId] - The policy ID to add sponsorship to\n   * @returns {Promise<VersionedTransaction>} The transaction with sponsorship added\n   */\n  async addSponsorship(\n    instructions: TransactionInstruction[],\n    connection: Connection,\n    policyId: string\n  ): Promise<VersionedTransaction> {\n    const { blockhash } = await connection.getLatestBlockhash({\n      commitment: \"finalized\",\n    });\n    const message = new TransactionMessage({\n      // Right now the backend will rewrite this payer Key to the server's address\n      payerKey: new PublicKey(this.address),\n      recentBlockhash: blockhash,\n      instructions,\n    }).compileToV0Message();\n    const versionedTransaction = new VersionedTransaction(message);\n    const serializedTransaction = Buffer.from(\n      versionedTransaction.serialize()\n    ).toString(\"base64\");\n    const body = JSON.stringify({\n      id: crypto?.randomUUID() ?? Math.floor(Math.random() * 1000000),\n      jsonrpc: \"2.0\",\n      method: \"alchemy_requestFeePayer\",\n      params: [\n        {\n          policyId,\n          serializedTransaction,\n        },\n      ],\n    });\n    const options = {\n      method: \"POST\",\n      headers: {\n        accept: \"application/json\",\n        \"content-type\": \"application/json\",\n      },\n      body,\n    };\n\n    const response = await fetch(\n      // TODO: Use the connection??\n      connection.rpcEndpoint,\n      options\n    );\n    const jsonResponse = await response.json();\n    if (!jsonResponse?.result?.serializedTransaction)\n      throw new Error(\n        `Response doesn't include the serializedTransaction ${JSON.stringify(\n          jsonResponse\n        )}`\n      );\n    return VersionedTransaction.deserialize(\n      decodeBase64(jsonResponse.result.serializedTransaction)\n    );\n  }\n\n  private formatSignatureForSolana(signature: Hex): Hex {\n    if (size(signature) === 64) return signature;\n\n    return slice(signature, 0, 64);\n  }\n\n  private getMessageToSign(tx: Transaction | VersionedTransaction): Hex {\n    let messageToSign;\n    if (tx instanceof Transaction) {\n      messageToSign = tx.serializeMessage();\n    } else {\n      messageToSign = Buffer.from(tx.message.serialize());\n    }\n    return toHex(messageToSign);\n  }\n}\nfunction decodeBase64(serializedTransaction: string): Uint8Array {\n  return Buffer.from(serializedTransaction, \"base64\");\n}\n"]}

package/dist/esm/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "4.25.1";
+export declare const VERSION = "4.27.0";

package/dist/esm/version.js

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

package/dist/esm/version.js.map

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

package/dist/types/index.d.ts

@@ -9,4 +9,5 @@ export { AlchemyWebSigner } from "./signer.js";
 export type * from "./solanaSigner.js";
 export type * from "./types.js";
 export { AlchemySignerStatus } from "./types.js";
+export { SolanaSigner } from "./solanaSigner.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,mBAAmB,mBAAmB,CAAC;AACvC,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,kBAAkB,EAClB,0BAA0B,GAC3B,MAAM,sBAAsB,CAAC;AAC9B,mBAAmB,aAAa,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,YAAY,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,mBAAmB,mBAAmB,CAAC;AACvC,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,kBAAkB,EAClB,0BAA0B,GAC3B,MAAM,sBAAsB,CAAC;AAC9B,mBAAmB,aAAa,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,YAAY,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/types/solanaSigner.d.ts

@@ -1,12 +1,45 @@
-import { Transaction, type VersionedTransaction } from "@solana/web3.js";
+import { Connection, Transaction, TransactionInstruction, VersionedTransaction } from "@solana/web3.js";
 import { type ByteArray } from "viem";
 import type { BaseSignerClient } from "./client/base";
+/**
+ * The SolanaSigner class is used to sign transactions and messages for the Solana blockchain.
+ * It provides methods to add signatures to transactions and sign messages.
+ */
 export declare class SolanaSigner {
-    private alchemyClient;
-    address: string;
+    readonly alchemyClient: BaseSignerClient;
+    readonly address: string;
+    /**
+     * Constructor for the SolanaSigner class which is a wrapper around the alchemy client, and is more focused on the solana web3
+     *
+     * @param {object} client This is the client that will be used to sign the transaction, and we are just having functions on top of it.
+     */
     constructor(client: BaseSignerClient);
-    addSignature(tx: Transaction | VersionedTransaction): Promise<Transaction | VersionedTransaction>;
+    /**
+     * Adds a signature of the client user to a transaction
+     *
+     * @param {Transaction | VersionedTransaction} transaction - The transaction to add the signature to
+     * @returns {Promise<Transaction | VersionedTransaction >} The transaction with the signature added
+     */
+    addSignature(transaction: Transaction | VersionedTransaction): Promise<Transaction | VersionedTransaction>;
+    /**
+     * Signs a message
+     *
+     * @param {Uint8Array} message - The message to sign
+     * @returns {Promise<ByteArray>} The signature of the message
+     */
     signMessage(message: Uint8Array): Promise<ByteArray>;
+    createTransfer(instructions: TransactionInstruction[], connection: Connection, version?: "versioned"): Promise<VersionedTransaction>;
+    createTransfer(instructions: TransactionInstruction[], connection: Connection, version?: "legacy"): Promise<Transaction>;
+    createTransfer(instructions: TransactionInstruction[], connection: Connection): Promise<VersionedTransaction>;
+    /**
+     * Adds sponsorship to a transaction. Used to have a party like Alchemy pay for the transaction.
+     *
+     * @param {TransactionInstruction[]} instructions - The instructions to add to the transaction
+     * @param {Connection} connection - The connection to use for the transaction
+     * @param {string} [policyId] - The policy ID to add sponsorship to
+     * @returns {Promise<VersionedTransaction>} The transaction with sponsorship added
+     */
+    addSponsorship(instructions: TransactionInstruction[], connection: Connection, policyId: string): Promise<VersionedTransaction>;
     private formatSignatureForSolana;
     private getMessageToSign;
 }

package/dist/types/solanaSigner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"solanaSigner.d.ts","sourceRoot":"","sources":["../../src/solanaSigner.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,WAAW,EACX,KAAK,oBAAoB,EAC1B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAA+B,KAAK,SAAS,EAAY,MAAM,MAAM,CAAC;AAC7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAItD,qBAAa,YAAY;IACvB,OAAO,CAAC,aAAa,CAAmB;IACjC,OAAO,EAAE,MAAM,CAAC;gBAEX,MAAM,EAAE,gBAAgB;IAQ9B,YAAY,CAChB,EAAE,EAAE,WAAW,GAAG,oBAAoB,GACrC,OAAO,CAAC,WAAW,GAAG,oBAAoB,CAAC;IAwBxC,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;IAmB1D,OAAO,CAAC,wBAAwB;IAMhC,OAAO,CAAC,gBAAgB;CASzB"}
+{"version":3,"file":"solanaSigner.d.ts","sourceRoot":"","sources":["../../src/solanaSigner.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EAEV,WAAW,EACX,sBAAsB,EAEtB,oBAAoB,EACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAA+B,KAAK,SAAS,EAAY,MAAM,MAAM,CAAC;AAC7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGtD;;;GAGG;AACH,qBAAa,YAAY;IACvB,QAAQ,CAAC,aAAa,EAAE,gBAAgB,CAAC;IACzC,SAAgB,OAAO,EAAE,MAAM,CAAC;IAEhC;;;;OAIG;gBACS,MAAM,EAAE,gBAAgB;IAQpC;;;;;OAKG;IACG,YAAY,CAChB,WAAW,EAAE,WAAW,GAAG,oBAAoB,GAC9C,OAAO,CAAC,WAAW,GAAG,oBAAoB,CAAC;IAwB9C;;;;;OAKG;IACG,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;IAmBpD,cAAc,CAClB,YAAY,EAAE,sBAAsB,EAAE,EACtC,UAAU,EAAE,UAAU,EACtB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,oBAAoB,CAAC;IAC1B,cAAc,CAClB,YAAY,EAAE,sBAAsB,EAAE,EACtC,UAAU,EAAE,UAAU,EACtB,OAAO,CAAC,EAAE,QAAQ,GACjB,OAAO,CAAC,WAAW,CAAC;IACjB,cAAc,CAClB,YAAY,EAAE,sBAAsB,EAAE,EACtC,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,oBAAoB,CAAC;IA6ChC;;;;;;;OAOG;IACG,cAAc,CAClB,YAAY,EAAE,sBAAsB,EAAE,EACtC,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,oBAAoB,CAAC;IAmDhC,OAAO,CAAC,wBAAwB;IAMhC,OAAO,CAAC,gBAAgB;CASzB"}

package/dist/types/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "4.25.1";
+export declare const VERSION = "4.27.0";
 //# sourceMappingURL=version.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@account-kit/signer",
-  "version": "4.25.1",
+  "version": "4.27.0",
   "description": "Core interfaces and clients for interfacing with the Alchemy Signer API",
   "author": "Alchemy",
   "license": "MIT",
@@ -42,6 +42,7 @@
   },
   "devDependencies": {
     "@tanstack/react-query": "^5.28.9",
+    "@types/bs58": "^4.0.4",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "tailwindcss": "^3.4.3",
@@ -50,13 +51,14 @@
     "vitest": "^2.0.4"
   },
   "dependencies": {
-    "@aa-sdk/core": "^4.25.1",
-    "@account-kit/logging": "^4.25.1",
+    "@aa-sdk/core": "^4.27.0",
+    "@account-kit/logging": "^4.27.0",
     "@solana/web3.js": "^1.98.0",
     "@turnkey/http": "^2.6.2",
     "@turnkey/iframe-stamper": "^1.0.0",
     "@turnkey/viem": "^0.4.8",
     "@turnkey/webauthn-stamper": "^0.4.3",
+    "bs58": "^6.0.0",
     "jwt-decode": "^4.0.0",
     "zod": "^3.22.4",
     "zustand": "^5.0.0-rc.2"
@@ -76,5 +78,5 @@
     "url": "https://github.com/alchemyplatform/aa-sdk/issues"
   },
   "homepage": "https://github.com/alchemyplatform/aa-sdk#readme",
-  "gitHead": "a9fea72b02f77909ca0dfc9cdecda7af6de0b17d"
+  "gitHead": "19b59caa4fcb4e057f8e84a81f77843650fcab25"
 }

package/src/index.ts

@@ -20,3 +20,4 @@ export { AlchemyWebSigner } from "./signer.js";
 export type * from "./solanaSigner.js";
 export type * from "./types.js";
 export { AlchemySignerStatus } from "./types.js";
+export { SolanaSigner } from "./solanaSigner.js";

package/src/solanaSigner.ts

@@ -1,17 +1,28 @@
 import {
+  Connection,
   PublicKey,
   Transaction,
-  type VersionedTransaction,
+  TransactionInstruction,
+  TransactionMessage,
+  VersionedTransaction,
 } from "@solana/web3.js";
 import { size, slice, toBytes, toHex, type ByteArray, type Hex } from "viem";
 import type { BaseSignerClient } from "./client/base";
 import { NotAuthenticatedError } from "./errors.js";
 
-// TODO: I don't want this to be a class so that the flow is closer to how we do this for `toViemAccount`
+/**
+ * The SolanaSigner class is used to sign transactions and messages for the Solana blockchain.
+ * It provides methods to add signatures to transactions and sign messages.
+ */
 export class SolanaSigner {
-  private alchemyClient: BaseSignerClient;
-  public address: string;
+  readonly alchemyClient: BaseSignerClient;
+  public readonly address: string;
 
+  /**
+   * Constructor for the SolanaSigner class which is a wrapper around the alchemy client, and is more focused on the solana web3
+   *
+   * @param {object} client This is the client that will be used to sign the transaction, and we are just having functions on top of it.
+   */
   constructor(client: BaseSignerClient) {
     this.alchemyClient = client;
     if (!client.getUser()) throw new Error("Must be authenticated!");
@@ -20,8 +31,14 @@ export class SolanaSigner {
     this.address = client.getUser()!.solanaAddress!;
   }
 
+  /**
+   * Adds a signature of the client user to a transaction
+   *
+   * @param {Transaction | VersionedTransaction} transaction - The transaction to add the signature to
+   * @returns {Promise<Transaction | VersionedTransaction >} The transaction with the signature added
+   */
   async addSignature(
-    tx: Transaction | VersionedTransaction
+    transaction: Transaction | VersionedTransaction
   ): Promise<Transaction | VersionedTransaction> {
     const user = this.alchemyClient.getUser();
     if (!user) {
@@ -33,19 +50,25 @@ export class SolanaSigner {
     }
 
     const fromKey = new PublicKey(user.solanaAddress);
-    const messageToSign = this.getMessageToSign(tx);
+    const messageToSign = this.getMessageToSign(transaction);
     const signature = await this.alchemyClient.signRawMessage(
       messageToSign,
       "SOLANA"
     );
 
-    tx.addSignature(
+    transaction.addSignature(
       fromKey,
       Buffer.from(toBytes(this.formatSignatureForSolana(signature)))
     );
-    return tx;
+    return transaction;
   }
 
+  /**
+   * Signs a message
+   *
+   * @param {Uint8Array} message - The message to sign
+   * @returns {Promise<ByteArray>} The signature of the message
+   */
   async signMessage(message: Uint8Array): Promise<ByteArray> {
     const user = this.alchemyClient.getUser();
     if (!user) {
@@ -65,6 +88,127 @@ export class SolanaSigner {
     return toBytes(this.formatSignatureForSolana(signature));
   }
 
+  async createTransfer(
+    instructions: TransactionInstruction[],
+    connection: Connection,
+    version?: "versioned"
+  ): Promise<VersionedTransaction>;
+  async createTransfer(
+    instructions: TransactionInstruction[],
+    connection: Connection,
+    version?: "legacy"
+  ): Promise<Transaction>;
+  async createTransfer(
+    instructions: TransactionInstruction[],
+    connection: Connection
+  ): Promise<VersionedTransaction>;
+
+  /**
+   * Creates a transfer transaction. Used for the SolanaCard example.
+   *
+   * @param {TransactionInstruction[]} instructions - The instructions to add to the transaction
+   * @param {Connection} connection - The connection to use for the transaction
+   * @param {"versioned" | "legacy"} [version] - The version of the transaction
+   * @returns {Promise<Transaction | VersionedTransaction>} The transfer transaction
+   */
+  async createTransfer(
+    instructions: TransactionInstruction[],
+    connection: Connection,
+    version?: string
+  ): Promise<Transaction | VersionedTransaction> {
+    const blockhash = (await connection.getLatestBlockhash()).blockhash;
+
+    let transferTransaction;
+
+    if (version === "legacy") {
+      // Legacy transaction
+      transferTransaction = instructions.reduce(
+        (tx, instruction) => tx.add(instruction),
+        new Transaction()
+      );
+
+      // Get a recent block hash
+      transferTransaction.recentBlockhash = blockhash;
+      // Set the signer
+      transferTransaction.feePayer = new PublicKey(this.address);
+    } else {
+      // VersionedTransaction
+      const txMessage = new TransactionMessage({
+        payerKey: new PublicKey(this.address),
+        recentBlockhash: blockhash,
+        instructions,
+      });
+
+      const versionedTxMessage = txMessage.compileToV0Message();
+      transferTransaction = new VersionedTransaction(versionedTxMessage);
+    }
+
+    return transferTransaction;
+  }
+
+  /**
+   * Adds sponsorship to a transaction. Used to have a party like Alchemy pay for the transaction.
+   *
+   * @param {TransactionInstruction[]} instructions - The instructions to add to the transaction
+   * @param {Connection} connection - The connection to use for the transaction
+   * @param {string} [policyId] - The policy ID to add sponsorship to
+   * @returns {Promise<VersionedTransaction>} The transaction with sponsorship added
+   */
+  async addSponsorship(
+    instructions: TransactionInstruction[],
+    connection: Connection,
+    policyId: string
+  ): Promise<VersionedTransaction> {
+    const { blockhash } = await connection.getLatestBlockhash({
+      commitment: "finalized",
+    });
+    const message = new TransactionMessage({
+      // Right now the backend will rewrite this payer Key to the server's address
+      payerKey: new PublicKey(this.address),
+      recentBlockhash: blockhash,
+      instructions,
+    }).compileToV0Message();
+    const versionedTransaction = new VersionedTransaction(message);
+    const serializedTransaction = Buffer.from(
+      versionedTransaction.serialize()
+    ).toString("base64");
+    const body = JSON.stringify({
+      id: crypto?.randomUUID() ?? Math.floor(Math.random() * 1000000),
+      jsonrpc: "2.0",
+      method: "alchemy_requestFeePayer",
+      params: [
+        {
+          policyId,
+          serializedTransaction,
+        },
+      ],
+    });
+    const options = {
+      method: "POST",
+      headers: {
+        accept: "application/json",
+        "content-type": "application/json",
+      },
+      body,
+    };
+
+    const response = await fetch(
+      // TODO: Use the connection??
+      connection.rpcEndpoint,
+      options
+    );
+    const jsonResponse = await response.json();
+    if (!jsonResponse?.result?.serializedTransaction)
+      throw new Error(
+        `Response doesn't include the serializedTransaction ${JSON.stringify(
+          jsonResponse
+        )}`
+      );
+    return VersionedTransaction.deserialize(
+      decodeBase64(jsonResponse.result.serializedTransaction)
+    );
+  }
+
   private formatSignatureForSolana(signature: Hex): Hex {
     if (size(signature) === 64) return signature;
 
@@ -81,3 +225,6 @@ export class SolanaSigner {
     return toHex(messageToSign);
   }
 }
+function decodeBase64(serializedTransaction: string): Uint8Array {
+  return Buffer.from(serializedTransaction, "base64");
+}

package/src/version.ts

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