[react]: add useSendTransaction hook

.changeset/tender-terms-repeat.md

@@ -0,0 +1,5 @@
+---
+"@gillsdk/react": minor
+---
+
+added `useSendTransaction` hook

packages/react/README.md

@@ -66,6 +66,23 @@ Fetch data from the Solana blockchain with the gill hooks:
 - [`useTokenMint`](#get-token-mint-account) - get a decoded token's Mint account
 - [`useTokenAccount`](#get-token-account) - get the token account for a given mint and owner (or ATA)
 
+Send data to the Solana blockchain with the gill hooks:
+
+- [`useSendTransaction`](#send-transaction) - send a serialized solana transaction (Base64 encoded) to the Solana blockchain
+
+### Example Usage of useSendTransaction hook
+```tsx
+const { send, signature, isPending, isError } = useSendTransaction({
+  transaction: base64EncodedTransaction,
+  config: {
+    skipPreflight: true,
+    preflightCommitment: 'finalized'
+  }
+});
+// Send the transaction
+send();
+````
+
 ### Wrap your React app in a context provider
 
 Wrap your app with the `SolanaProvider` React context provider and pass your Solana client to it:

packages/react/src/__typeset__/send-transaction.ts

@@ -0,0 +1,38 @@
+import { useSendTransaction } from "../hooks";
+import { Base64EncodedWireTransaction, SendTransactionApi} from "gill";
+
+// [DESCRIBE] useSendTransaction
+{
+  const transaction = null as unknown as Base64EncodedWireTransaction | string;
+  {
+    const signature = useSendTransaction({ transaction });
+    signature.transaction satisfies ReturnType<SendTransactionApi["sendTransaction"]>;
+    // @ts-expect-error - Should not allow no argument
+    useSendTransaction();
+
+    // @ts-expect-error - Should not allow empty argument object
+    useSendTransaction({});
+  }
+
+  {
+    // Should accept `config` input
+    const signature = useSendTransaction({
+      config: {
+        encoding: "base64",
+        preflightCommitment: "confirmed",
+        skipPreflight: false,
+      },
+      transaction,
+    });
+    signature.transaction satisfies ReturnType<SendTransactionApi["sendTransaction"]>;
+  }
+
+  {
+    // Should require `signature` input
+    const signature = useSendTransaction({
+      transaction: "5Pj5fCupXLUePYn18JkY8SrRaWFiUctuDTRwvUy2ML9yvkENLb1QMYbcBGcBXRrSVDjp7RjUwk9a3rLC6gpvtYpZ",
+    });
+
+    signature.transaction satisfies ReturnType<SendTransactionApi["sendTransaction"]>;
+  }
+}

packages/react/src/hooks/index.ts

@@ -10,3 +10,4 @@ export * from "./slot.js";
 export * from "./token-account.js";
 export * from "./token-mint.js";
 export * from "./transaction.js";
+export * from "./send-transaction.js";

packages/react/src/hooks/send-transaction.ts

@@ -0,0 +1,59 @@
+"use client";
+
+import { GillUseRpcHook } from "./types";
+import { useSolanaClient } from "./client";
+import { GILL_HOOK_CLIENT_KEY } from "../const";
+import { useMutation } from "@tanstack/react-query";
+import { Base64EncodedWireTransaction, SendTransactionApi, Simplify } from "gill";
+
+// Define the configuration type for the RPC method
+type RpConfig = Simplify<Parameters<SendTransactionApi["sendTransaction"]>[1]>;
+
+// Define the response type for the hook
+type UseSendTransactionResponse = ReturnType<SendTransactionApi["sendTransaction"]>;
+
+type UseSendTransactionInput<TConfig extends RpConfig = RpConfig> = GillUseRpcHook<TConfig> & {
+  config?: TConfig;
+  /**
+   *  The signed transaction in wire format, as a base-64 encoded string.
+   */
+  transaction: Base64EncodedWireTransaction | string;
+};
+
+/**
+ * Send a transaction using the Solana RPC method of
+ * [`sendTransaction`](https://solana.com/docs/rpc/http/sendtransaction)
+ *
+ * @returns An object from useMutation, including `signature`(the transaction signature) in an object
+ */
+export function useSendTransaction<TConfig extends RpConfig = RpConfig>({
+  transaction,
+  config,
+}: UseSendTransactionInput<TConfig>) {
+  const { rpc } = useSolanaClient();
+
+  const { data, ...rest } = useMutation({
+    mutationFn: async () => {
+      // The RPC method expects the base-64 encoded transaction as the first argument.
+      const response = await rpc
+        .sendTransaction(transaction as Base64EncodedWireTransaction, {
+          encoding: "base64",
+          preflightCommitment: "confirmed",
+          skipPreflight: false,
+          ...(config || {}),
+        })
+        .send();
+      // return the transaction signature as a base-64 encoded string
+      return response;
+    },
+    mutationKey: [GILL_HOOK_CLIENT_KEY, "sendTransaction"],
+    networkMode: "offlineFirst",
+    retry: 3,
+    retryDelay: (index) => Math.min(1000 * 2 ** index, 3000),
+  });
+
+  return {
+    ...rest,
+    transaction: data as UseSendTransactionResponse,
+  };
+}