feat(connect): add prepareTransactionRequest

Author: mrcnk

bun.lockb

@@ -22,6 +22,7 @@
 		"cleanup": "rimraf dist .turbo"
 	},
 	"dependencies": {
+		"@mina-js/shared": "workspace:*",
 		"@mina-js/accounts": "workspace:*",
 		"@mina-js/klesia-sdk": "workspace:*",
 		"@mina-js/providers": "workspace:*",

packages/connect/package.json

@@ -3,10 +3,12 @@
 exports[`matches snapshot of local source 1`] = `
 {
   "createNullifier": [Function: AsyncFunction],
+  "estimateFees": [Function: AsyncFunction],
   "getAccounts": [Function: AsyncFunction],
   "getBalance": [Function: AsyncFunction],
   "getChainId": [Function: AsyncFunction],
   "getTransactionCount": [Function: AsyncFunction],
+  "prepareTransactionRequest": [Function: AsyncFunction],
   "signFields": [Function: AsyncFunction],
   "signMessage": [Function: AsyncFunction],
   "signTransaction": [Function: AsyncFunction],
@@ -16,10 +18,12 @@ exports[`matches snapshot of local source 1`] = `
 exports[`matches snapshot of json-rpc source 1`] = `
 {
   "createNullifier": [Function: AsyncFunction],
+  "estimateFees": [Function: AsyncFunction],
   "getAccounts": [Function: AsyncFunction],
   "getBalance": [Function: AsyncFunction],
   "getChainId": [Function: AsyncFunction],
   "getTransactionCount": [Function: AsyncFunction],
+  "prepareTransactionRequest": [Function: AsyncFunction],
   "signFields": [Function: AsyncFunction],
   "signMessage": [Function: AsyncFunction],
   "signTransaction": [Function: AsyncFunction],

packages/connect/src/__snapshots__/client.spec.ts.snap

@@ -75,4 +75,18 @@ describe("local source", () => {
 		const signature = await client.signMessage({ message: "hello" });
 		expect(signature.data).toEqual("hello");
 	});
+
+	it("fills missing transaction fields", async () => {
+		const account = privateKeyToAccount({
+			privateKey: Test.accounts[0].privateKey,
+		});
+		const client = createWalletClient({ account, network: "devnet" });
+		const transaction = await client.prepareTransactionRequest({
+			from: PUBLIC_KEY,
+			to: PUBLIC_KEY,
+			amount: 1_000_000_000n,
+		});
+		expect(transaction.fee).toBeDefined();
+		expect(transaction.nonce).toBeDefined();
+	});
 });

packages/connect/src/client.spec.ts

@@ -1,8 +1,12 @@
-import type { Account, SignTransaction } from "@mina-js/accounts";
-import type { SignMessage } from "@mina-js/accounts";
-import type { SignFields } from "@mina-js/accounts";
-import type { CreateNullifier } from "@mina-js/accounts";
+import type {
+	Account,
+	CreateNullifier,
+	SignFields,
+	SignMessage,
+	SignTransaction,
+} from "@mina-js/accounts";
 import { createClient } from "@mina-js/klesia-sdk";
+import type { PartiallyFormedTransactionProperties } from "@mina-js/shared";
 import { match } from "ts-pattern";
 import { createStore } from "./store";
 
@@ -101,6 +105,29 @@ export const createWalletClient = ({
 		if (account.type !== "local") throw new Error("Account type not supported");
 		return account.createNullifier(params);
 	};
+	const estimateFees = async () => {
+		const { result } = await klesiaClient.request<"mina_estimateFees">({
+			method: "mina_estimateFees",
+		});
+		return result;
+	};
+	const prepareTransactionRequest = async (
+		transaction: PartiallyFormedTransactionProperties,
+	) => {
+		let fee = transaction.fee;
+		let nonce = transaction.nonce;
+		if (!nonce) {
+			nonce = await getTransactionCount();
+		}
+		if (!fee) {
+			fee = BigInt((await estimateFees()).medium);
+		}
+		return {
+			...transaction,
+			fee,
+			nonce,
+		};
+	};
 	return {
 		getAccounts,
 		getBalance,
@@ -110,5 +137,7 @@ export const createWalletClient = ({
 		signMessage,
 		signFields,
 		createNullifier,
+		estimateFees,
+		prepareTransactionRequest,
 	};
 };

packages/connect/src/client.ts

@@ -2,11 +2,13 @@ import type { z } from "zod";
 import type {
 	LiteralSchema,
 	NullifierSchema,
+	PartiallyFormedTransactionPayload,
 	PrivateKeySchema,
 	PublicKeySchema,
 	SignedFieldsSchema,
 	SignedMessageSchema,
 	SignedTransactionSchema,
+	TransactionPayload,
 	TransactionReceiptSchema,
 } from "./validation";
 
@@ -17,6 +19,10 @@ export type Literal = z.infer<typeof LiteralSchema>;
 export type Json = Literal | { [key: string]: Json } | Json[];
 export type PublicKey = z.infer<typeof PublicKeySchema>;
 export type PrivateKey = z.infer<typeof PrivateKeySchema>;
+export type TransactionProperties = z.infer<typeof TransactionPayload>;
+export type PartiallyFormedTransactionProperties = z.infer<
+	typeof PartiallyFormedTransactionPayload
+>;
 
 /**
  * Return types

packages/shared/src/types.ts

@@ -39,6 +39,11 @@ export const TransactionPayload = z
 	})
 	.strict();
 
+export const PartiallyFormedTransactionPayload = TransactionPayload.extend({
+	fee: z.coerce.bigint().optional(),
+	nonce: z.coerce.bigint().optional(),
+});
+
 /**
  * Return type schemas
  */