added transactionFromBase64 (#56)

* feat: from base64

* refactor: correct decoder

.changeset/twenty-jars-double.md

@@ -0,0 +1,5 @@
+---
+"gill": minor
+---
+
+added `transactionFromBase64` function

packages/gill/src/__tests__/base64-transactions.ts

@@ -1,7 +1,12 @@
 import { blockhash } from "@solana/rpc-types";
 import { address } from "@solana/addresses";
 import { createKeyPairSignerFromPrivateKeyBytes, type KeyPairSigner } from "@solana/signers";
-import { createTransaction, transactionToBase64, transactionToBase64WithSigners } from "../core";
+import {
+  createTransaction,
+  transactionFromBase64,
+  transactionToBase64,
+  transactionToBase64WithSigners,
+} from "../core";
 
 // initialize a sample transaction
 const tx = createTransaction({
@@ -66,3 +71,16 @@ describe("transactionToBase64WithSigners", () => {
     expect(result).toBe(expected);
   });
 });
+
+describe("transactionFromBase64", () => {
+  test("can decode base64 an unsigned transaction", () => {
+    const input =
+      "AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAABC7YxPJkVXZH3qqq8Nq1nwYa5Pm6+M9ZeObND0CCtBLXjfKbGfbEEIU1AEH81ttgpyiNLO+xurYCsjdCVcfR4YQA=";
+
+    const tx = transactionFromBase64(input);
+
+    const result = transactionToBase64(tx);
+
+    expect(result).toBe(input);
+  });
+});

packages/gill/src/core/base64-from-transaction.ts

@@ -0,0 +1,12 @@
+import { getBase64Encoder } from "@solana/codecs";
+import { getTransactionDecoder, type Transaction } from "@solana/transactions";
+import type { transactionToBase64, transactionToBase64WithSigners } from "./base64-to-transaction";
+
+/**
+ * Convert a base64 encoded transaction string into compiled transaction
+ *
+ * Use {@link transactionToBase64} or {@link transactionToBase64WithSigners} to create the base64 encoded transaction string
+ */
+export function transactionFromBase64(base64EncodedTransaction: string): Transaction {
+  return getTransactionDecoder().decode(getBase64Encoder().encode(base64EncodedTransaction));
+}

packages/gill/src/core/index.ts

@@ -4,8 +4,9 @@ export * from "./utils";
 export * from "./rpc";
 export * from "./explorer";
 export * from "./create-transaction";
-export * from "./base64-transactions";
 export * from "./prepare-transaction";
 export * from "./create-solana-client";
 export * from "./accounts";
 export * from "./keypairs";
+export * from "./base64-to-transaction";
+export * from "./base64-from-transaction";

packages/gill/src/core/prepare-transaction.ts

@@ -15,7 +15,7 @@ import type { GetLatestBlockhashApi, Rpc, SimulateTransactionApi } from "@solana
 import { isSetComputeLimitInstruction } from "../programs/compute-budget";
 import { getComputeUnitEstimateForTransactionMessageFactory } from "../kit";
 import { debug, isDebugEnabled } from "./debug";
-import { transactionToBase64WithSigners } from "./base64-transactions";
+import { transactionToBase64WithSigners } from "./base64-to-transaction";
 
 type PrepareCompilableTransactionMessage =
   | CompilableTransactionMessage