@account-kit/signer 4.54.1 → 4.55.0

package/dist/esm/index.d.ts

@@ -10,3 +10,4 @@ export type * from "./solanaSigner.js";
 export type * from "./types.js";
 export { AlchemySignerStatus } from "./types.js";
 export { SolanaSigner } from "./solanaSigner.js";
+export { createSolanaSponsoredTransaction, createSolanaTransaction, } from "./utils/solana.js";

package/dist/esm/index.js

@@ -6,4 +6,5 @@ export { DEFAULT_SESSION_MS, SessionManagerParamsSchema, } from "./session/manag
 export { AlchemyWebSigner } from "./signer.js";
 export { AlchemySignerStatus } from "./types.js";
 export { SolanaSigner } from "./solanaSigner.js";
+export { createSolanaSponsoredTransaction, createSolanaTransaction, } from "./utils/solana.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;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"]}
+{"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;AACjD,OAAO,EACL,gCAAgC,EAChC,uBAAuB,GACxB,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\";\nexport {\n  createSolanaSponsoredTransaction,\n  createSolanaTransaction,\n} from \"./utils/solana.js\";\n"]}

package/dist/esm/solanaSigner.js

@@ -1,6 +1,7 @@
 import { Connection, PublicKey, Transaction, TransactionInstruction, TransactionMessage, VersionedTransaction, } from "@solana/web3.js";
 import { size, slice, toBytes, toHex } from "viem";
 import { NotAuthenticatedError } from "./errors.js";
+import { createSolanaSponsoredTransaction } from "./utils/solana.js";
 /**
  * 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.
@@ -108,43 +109,7 @@ export class SolanaSigner {
      * @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));
+        return createSolanaSponsoredTransaction(instructions, connection, policyId, this.address);
     }
     formatSignatureForSolana(signature) {
         if (size(signature) === 64)
@@ -162,7 +127,4 @@ 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":"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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 createTransaction(\n    instructions: TransactionInstruction[],\n    connection: Connection,\n    version?: \"versioned\",\n  ): Promise<VersionedTransaction>;\n  async createTransaction(\n    instructions: TransactionInstruction[],\n    connection: Connection,\n    version?: \"legacy\",\n  ): Promise<Transaction>;\n  async createTransaction(\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 createTransaction(\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"]}
+{"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\";\nimport { createSolanaSponsoredTransaction } from \"./utils/solana.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 createTransaction(\n    instructions: TransactionInstruction[],\n    connection: Connection,\n    version?: \"versioned\",\n  ): Promise<VersionedTransaction>;\n  async createTransaction(\n    instructions: TransactionInstruction[],\n    connection: Connection,\n    version?: \"legacy\",\n  ): Promise<Transaction>;\n  async createTransaction(\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 createTransaction(\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    return createSolanaSponsoredTransaction(\n      instructions,\n      connection,\n      policyId,\n      this.address,\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}\n"]}

package/dist/esm/utils/solana.d.ts

@@ -0,0 +1,21 @@
+import type { TransactionInstruction } from "@solana/web3.js";
+import { Connection, VersionedTransaction } from "@solana/web3.js";
+/**
+ * This function wraps instructions in a sponsored transaction using Alchemy's fee payer service
+ *
+ * @param {TransactionInstruction[]} instructions - The instructions to add sponsorship to
+ * @param {Connection} connection - The connection to use
+ * @param {string} policyId - The policy id to use
+ * @param {string} address - The address to use
+ * @returns {Promise<VersionedTransaction>} - The sponsored transaction
+ */
+export declare function createSolanaSponsoredTransaction(instructions: TransactionInstruction[], connection: Connection, policyId: string, address: string): Promise<VersionedTransaction>;
+/**
+ * Creates a regular (non-sponsored) Solana transaction from instructions
+ *
+ * @param {TransactionInstruction[]} instructions - The instructions to create transaction from
+ * @param {Connection} connection - The connection to use
+ * @param {string} address - The payer address
+ * @returns {Promise<VersionedTransaction>} - The transaction
+ */
+export declare function createSolanaTransaction(instructions: TransactionInstruction[], connection: Connection, address: string): Promise<VersionedTransaction>;

package/dist/esm/utils/solana.js

@@ -0,0 +1,72 @@
+import { Connection, PublicKey, TransactionMessage, VersionedTransaction, } from "@solana/web3.js";
+/**
+ * This function wraps instructions in a sponsored transaction using Alchemy's fee payer service
+ *
+ * @param {TransactionInstruction[]} instructions - The instructions to add sponsorship to
+ * @param {Connection} connection - The connection to use
+ * @param {string} policyId - The policy id to use
+ * @param {string} address - The address to use
+ * @returns {Promise<VersionedTransaction>} - The sponsored transaction
+ */
+export async function createSolanaSponsoredTransaction(instructions, connection, policyId, address) {
+    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(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));
+}
+/**
+ * Creates a regular (non-sponsored) Solana transaction from instructions
+ *
+ * @param {TransactionInstruction[]} instructions - The instructions to create transaction from
+ * @param {Connection} connection - The connection to use
+ * @param {string} address - The payer address
+ * @returns {Promise<VersionedTransaction>} - The transaction
+ */
+export async function createSolanaTransaction(instructions, connection, address) {
+    const { blockhash } = await connection.getLatestBlockhash({
+        commitment: "finalized",
+    });
+    const message = new TransactionMessage({
+        payerKey: new PublicKey(address),
+        recentBlockhash: blockhash,
+        instructions,
+    }).compileToV0Message();
+    return new VersionedTransaction(message);
+}
+function decodeBase64(serializedTransaction) {
+    return Buffer.from(serializedTransaction, "base64");
+}
+//# sourceMappingURL=solana.js.map

package/dist/esm/utils/solana.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"solana.js","sourceRoot":"","sources":["../../../src/utils/solana.ts"],"names":[],"mappings":"AACA,OAAO,EACL,UAAU,EACV,SAAS,EACT,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,gCAAgC,CACpD,YAAsC,EACtC,UAAsB,EACtB,QAAgB,EAChB,OAAe;IAEf,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,UAAU,CAAC,kBAAkB,CAAC;QACxD,UAAU,EAAE,WAAW;KACxB,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,IAAI,kBAAkB,CAAC;QACrC,4EAA4E;QAC5E,QAAQ,EAAE,IAAI,SAAS,CAAC,OAAO,CAAC;QAChC,eAAe,EAAE,SAAS;QAC1B,YAAY;KACb,CAAC,CAAC,kBAAkB,EAAE,CAAC;IACxB,MAAM,oBAAoB,GAAG,IAAI,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC/D,MAAM,qBAAqB,GAAG,MAAM,CAAC,IAAI,CACvC,oBAAoB,CAAC,SAAS,EAAE,CACjC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACrB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;QAC1B,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,OAAO,CAAC;QAC/D,OAAO,EAAE,KAAK;QACd,MAAM,EAAE,yBAAyB;QACjC,MAAM,EAAE;YACN;gBACE,QAAQ;gBACR,qBAAqB;aACtB;SACF;KACF,CAAC,CAAC;IACH,MAAM,OAAO,GAAG;QACd,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,MAAM,EAAE,kBAAkB;YAC1B,cAAc,EAAE,kBAAkB;SACnC;QACD,IAAI;KACL,CAAC;IAEF,MAAM,QAAQ,GAAG,MAAM,KAAK;IAC1B,6BAA6B;IAC7B,UAAU,CAAC,WAAW,EACtB,OAAO,CACR,CAAC;IACF,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC3C,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,qBAAqB;QAC9C,MAAM,IAAI,KAAK,CACb,sDAAsD,IAAI,CAAC,SAAS,CAClE,YAAY,CACb,EAAE,CACJ,CAAC;IACJ,OAAO,oBAAoB,CAAC,WAAW,CACrC,YAAY,CAAC,YAAY,CAAC,MAAM,CAAC,qBAAqB,CAAC,CACxD,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,YAAsC,EACtC,UAAsB,EACtB,OAAe;IAEf,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,UAAU,CAAC,kBAAkB,CAAC;QACxD,UAAU,EAAE,WAAW;KACxB,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,IAAI,kBAAkB,CAAC;QACrC,QAAQ,EAAE,IAAI,SAAS,CAAC,OAAO,CAAC;QAChC,eAAe,EAAE,SAAS;QAC1B,YAAY;KACb,CAAC,CAAC,kBAAkB,EAAE,CAAC;IACxB,OAAO,IAAI,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,YAAY,CAAC,qBAA6B;IACjD,OAAO,MAAM,CAAC,IAAI,CAAC,qBAAqB,EAAE,QAAQ,CAAC,CAAC;AACtD,CAAC","sourcesContent":["import type { TransactionInstruction } from \"@solana/web3.js\";\nimport {\n  Connection,\n  PublicKey,\n  TransactionMessage,\n  VersionedTransaction,\n} from \"@solana/web3.js\";\n\n/**\n * This function wraps instructions in a sponsored transaction using Alchemy's fee payer service\n *\n * @param {TransactionInstruction[]} instructions - The instructions to add sponsorship to\n * @param {Connection} connection - The connection to use\n * @param {string} policyId - The policy id to use\n * @param {string} address - The address to use\n * @returns {Promise<VersionedTransaction>} - The sponsored transaction\n */\nexport async function createSolanaSponsoredTransaction(\n  instructions: TransactionInstruction[],\n  connection: Connection,\n  policyId: string,\n  address: 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(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/**\n * Creates a regular (non-sponsored) Solana transaction from instructions\n *\n * @param {TransactionInstruction[]} instructions - The instructions to create transaction from\n * @param {Connection} connection - The connection to use\n * @param {string} address - The payer address\n * @returns {Promise<VersionedTransaction>} - The transaction\n */\nexport async function createSolanaTransaction(\n  instructions: TransactionInstruction[],\n  connection: Connection,\n  address: string,\n): Promise<VersionedTransaction> {\n  const { blockhash } = await connection.getLatestBlockhash({\n    commitment: \"finalized\",\n  });\n  const message = new TransactionMessage({\n    payerKey: new PublicKey(address),\n    recentBlockhash: blockhash,\n    instructions,\n  }).compileToV0Message();\n  return new VersionedTransaction(message);\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.54.1";
+export declare const VERSION = "4.55.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.54.1";
+export const VERSION = "4.55.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.54.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.55.0\";\n"]}

package/dist/types/index.d.ts

@@ -10,4 +10,5 @@ export type * from "./solanaSigner.js";
 export type * from "./types.js";
 export { AlchemySignerStatus } from "./types.js";
 export { SolanaSigner } from "./solanaSigner.js";
+export { createSolanaSponsoredTransaction, createSolanaTransaction, } from "./utils/solana.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;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,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;AACjD,OAAO,EACL,gCAAgC,EAChC,uBAAuB,GACxB,MAAM,mBAAmB,CAAC"}

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

@@ -1 +1 @@
-{"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,iBAAiB,CACrB,YAAY,EAAE,sBAAsB,EAAE,EACtC,UAAU,EAAE,UAAU,EACtB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,oBAAoB,CAAC;IAC1B,iBAAiB,CACrB,YAAY,EAAE,sBAAsB,EAAE,EACtC,UAAU,EAAE,UAAU,EACtB,OAAO,CAAC,EAAE,QAAQ,GACjB,OAAO,CAAC,WAAW,CAAC;IACjB,iBAAiB,CACrB,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"}
+{"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;AAItD;;;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,iBAAiB,CACrB,YAAY,EAAE,sBAAsB,EAAE,EACtC,UAAU,EAAE,UAAU,EACtB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,oBAAoB,CAAC;IAC1B,iBAAiB,CACrB,YAAY,EAAE,sBAAsB,EAAE,EACtC,UAAU,EAAE,UAAU,EACtB,OAAO,CAAC,EAAE,QAAQ,GACjB,OAAO,CAAC,WAAW,CAAC;IACjB,iBAAiB,CACrB,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;IAShC,OAAO,CAAC,wBAAwB;IAMhC,OAAO,CAAC,gBAAgB;CASzB"}

package/dist/types/utils/solana.d.ts

@@ -0,0 +1,22 @@
+import type { TransactionInstruction } from "@solana/web3.js";
+import { Connection, VersionedTransaction } from "@solana/web3.js";
+/**
+ * This function wraps instructions in a sponsored transaction using Alchemy's fee payer service
+ *
+ * @param {TransactionInstruction[]} instructions - The instructions to add sponsorship to
+ * @param {Connection} connection - The connection to use
+ * @param {string} policyId - The policy id to use
+ * @param {string} address - The address to use
+ * @returns {Promise<VersionedTransaction>} - The sponsored transaction
+ */
+export declare function createSolanaSponsoredTransaction(instructions: TransactionInstruction[], connection: Connection, policyId: string, address: string): Promise<VersionedTransaction>;
+/**
+ * Creates a regular (non-sponsored) Solana transaction from instructions
+ *
+ * @param {TransactionInstruction[]} instructions - The instructions to create transaction from
+ * @param {Connection} connection - The connection to use
+ * @param {string} address - The payer address
+ * @returns {Promise<VersionedTransaction>} - The transaction
+ */
+export declare function createSolanaTransaction(instructions: TransactionInstruction[], connection: Connection, address: string): Promise<VersionedTransaction>;
+//# sourceMappingURL=solana.d.ts.map

package/dist/types/utils/solana.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solana.d.ts","sourceRoot":"","sources":["../../../src/utils/solana.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EACL,UAAU,EAGV,oBAAoB,EACrB,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;GAQG;AACH,wBAAsB,gCAAgC,CACpD,YAAY,EAAE,sBAAsB,EAAE,EACtC,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,oBAAoB,CAAC,CAiD/B;AAED;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAC3C,YAAY,EAAE,sBAAsB,EAAE,EACtC,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,oBAAoB,CAAC,CAU/B"}

package/dist/types/version.d.ts

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@account-kit/signer",
-  "version": "4.54.1",
+  "version": "4.55.0",
   "description": "Core interfaces and clients for interfacing with the Alchemy Signer API",
   "author": "Alchemy",
   "license": "MIT",
@@ -48,8 +48,8 @@
     "typescript-template": "*"
   },
   "dependencies": {
-    "@aa-sdk/core": "^4.54.1",
-    "@account-kit/logging": "^4.54.1",
+    "@aa-sdk/core": "^4.55.0",
+    "@account-kit/logging": "^4.55.0",
     "@noble/curves": "^1.9.2",
     "@noble/hashes": "1.7.1",
     "@noble/secp256k1": "^2.3.0",
@@ -78,5 +78,5 @@
     "url": "https://github.com/alchemyplatform/aa-sdk/issues"
   },
   "homepage": "https://github.com/alchemyplatform/aa-sdk#readme",
-  "gitHead": "44a337cbf1375398d92a74ea527fcf4d9bccdde7"
+  "gitHead": "0fd8daecdf3e978afc6dc795579f5222ec7e0ebf"
 }

package/src/index.ts

@@ -21,3 +21,7 @@ export type * from "./solanaSigner.js";
 export type * from "./types.js";
 export { AlchemySignerStatus } from "./types.js";
 export { SolanaSigner } from "./solanaSigner.js";
+export {
+  createSolanaSponsoredTransaction,
+  createSolanaTransaction,
+} from "./utils/solana.js";

package/src/solanaSigner.ts

@@ -9,6 +9,7 @@ import {
 import { size, slice, toBytes, toHex, type ByteArray, type Hex } from "viem";
 import type { BaseSignerClient } from "./client/base";
 import { NotAuthenticatedError } from "./errors.js";
+import { createSolanaSponsoredTransaction } from "./utils/solana.js";
 
 /**
  * The SolanaSigner class is used to sign transactions and messages for the Solana blockchain.
@@ -159,53 +160,11 @@ export class SolanaSigner {
     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,
+    return createSolanaSponsoredTransaction(
       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),
+      connection,
+      policyId,
+      this.address,
     );
   }
 
@@ -225,6 +184,3 @@ export class SolanaSigner {
     return toHex(messageToSign);
   }
 }
-function decodeBase64(serializedTransaction: string): Uint8Array {
-  return Buffer.from(serializedTransaction, "base64");
-}

package/src/utils/solana.ts

@@ -0,0 +1,100 @@
+import type { TransactionInstruction } from "@solana/web3.js";
+import {
+  Connection,
+  PublicKey,
+  TransactionMessage,
+  VersionedTransaction,
+} from "@solana/web3.js";
+
+/**
+ * This function wraps instructions in a sponsored transaction using Alchemy's fee payer service
+ *
+ * @param {TransactionInstruction[]} instructions - The instructions to add sponsorship to
+ * @param {Connection} connection - The connection to use
+ * @param {string} policyId - The policy id to use
+ * @param {string} address - The address to use
+ * @returns {Promise<VersionedTransaction>} - The sponsored transaction
+ */
+export async function createSolanaSponsoredTransaction(
+  instructions: TransactionInstruction[],
+  connection: Connection,
+  policyId: string,
+  address: 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(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),
+  );
+}
+
+/**
+ * Creates a regular (non-sponsored) Solana transaction from instructions
+ *
+ * @param {TransactionInstruction[]} instructions - The instructions to create transaction from
+ * @param {Connection} connection - The connection to use
+ * @param {string} address - The payer address
+ * @returns {Promise<VersionedTransaction>} - The transaction
+ */
+export async function createSolanaTransaction(
+  instructions: TransactionInstruction[],
+  connection: Connection,
+  address: string,
+): Promise<VersionedTransaction> {
+  const { blockhash } = await connection.getLatestBlockhash({
+    commitment: "finalized",
+  });
+  const message = new TransactionMessage({
+    payerKey: new PublicKey(address),
+    recentBlockhash: blockhash,
+    instructions,
+  }).compileToV0Message();
+  return new VersionedTransaction(message);
+}
+
+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.54.1";
+export const VERSION = "4.55.0";