Add SUI support for Fireblocks integration

- Introduced a new example script for SUI transactions.
- Added SUI to Fireblocks asset types.
- Implemented SUI transaction signing and broadcasting in FireblocksService.
- Added utility functions for converting SUI to mist and vice versa.
- Updated KILN_VALIDATORS to include SUI mainnet validator address.

Author: menefrego15

examples/sui.ts

@@ -0,0 +1,93 @@
+import type { FireblocksIntegration } from '../src/fireblocks.ts';
+import { KILN_VALIDATORS, Kiln, suiToMist } from '../src/kiln.ts';
+import { loadEnv } from './env.ts';
+
+const { kilnApiKey, kilnAccountId, kilnApiUrl, fireblocksApiKey, fireblocksApiSecret, fireblocksVaultId } =
+  await loadEnv();
+
+const k = new Kiln({
+  baseUrl: kilnApiUrl,
+  apiToken: kilnApiKey,
+});
+
+const vault: FireblocksIntegration = {
+  config: {
+    apiKey: fireblocksApiKey,
+    secretKey: fireblocksApiSecret,
+    basePath: 'https://api.fireblocks.io/v1',
+  },
+  vaultId: fireblocksVaultId,
+};
+
+//
+// Get the pubkey from Fireblocks
+//
+const fireblocksWallet = (
+  await k.fireblocks
+    .getSdk(vault)
+    .vaults.getVaultAccountAssetAddressesPaginated({ assetId: 'SUI', vaultAccountId: vault.vaultId, limit: 1 })
+).data.addresses?.[0].address;
+if (!fireblocksWallet) {
+  console.log('Failed to get pubkey');
+  process.exit(0);
+}
+
+console.log(fireblocksWallet);
+
+//
+// Craft the transaction
+//
+console.log('Crafting transaction...');
+console.log('params:', {
+  account_id: kilnAccountId,
+  sender: fireblocksWallet,
+  validator_address: KILN_VALIDATORS.SUI.mainnet.KILN,
+  amount_mist: suiToMist('1.1').toString(),
+});
+const txRequest = await k.client.POST('/sui/transaction/stake', {
+  body: {
+    account_id: kilnAccountId,
+    sender: fireblocksWallet,
+    validator_address: KILN_VALIDATORS.SUI.mainnet.KILN,
+    amount_mist: suiToMist('1.1').toString(),
+  },
+});
+if (txRequest.error) {
+  console.log('Failed to craft transaction:', txRequest);
+  process.exit(1);
+} else {
+  console.log('Crafted transaction:', txRequest.data);
+}
+console.log('\n\n\n');
+
+//
+// Sign the transaction
+//
+console.log('Signing transaction...');
+const signRequest = await (async () => {
+  try {
+    return await k.fireblocks.signSuiTx(vault, txRequest.data.data);
+  } catch (err) {
+    console.log('Failed to sign transaction:', err);
+    process.exit(1);
+  }
+})();
+console.log('Signed transaction:', signRequest);
+console.log('\n\n\n');
+
+//
+// Broadcast the transaction
+//
+console.log('Broadcasting transaction...');
+const broadcastedRequest = await k.client.POST('/sui/transaction/broadcast', {
+  body: {
+    tx_serialized: signRequest.signed_tx.data.tx_serialized,
+    serialized_signature: signRequest.signed_tx.data.serialized_signature,
+  },
+});
+if (broadcastedRequest.error) {
+  console.log('Failed to broadcast transaction:', broadcastedRequest);
+  process.exit(1);
+} else {
+  console.log('Broadcasted transaction:', broadcastedRequest.data);
+}

src/fireblocks.ts

@@ -21,6 +21,7 @@ export type FireblocksIntegration = (
 const ERRORS = {
   MISSING_SIGNATURE: 'An error occurred while attempting to retrieve the signature from Fireblocks.',
   FAILED_TO_PREPARE: 'An error occurred while attempting to add the signature to the transaction.',
+  MISSING_PUBLIC_KEY: 'An error occurred while attempting to retrieve the public key from Fireblocks.',
 };
 
 export class FireblocksService {
@@ -1271,4 +1272,54 @@ export class FireblocksService {
       fireblocks_tx: fbTx,
     };
   }
+
+  async signSuiTx(
+    integration: FireblocksIntegration,
+    tx: components['schemas']['SUITx'],
+    note?: string,
+  ): Promise<{
+    signed_tx: { data: components['schemas']['SUIBroadcastTxPayload'] };
+    fireblocks_tx: TransactionResponse;
+  }> {
+    const payload = {
+      rawMessageData: {
+        messages: [
+          {
+            content: tx.unsigned_tx_hash.substring(2),
+          },
+        ],
+      },
+    };
+
+    const fbSigner = this.getSigner(integration);
+    const fbNote = note ? note : 'SUI tx from @kilnfi/sdk';
+    const fbTx = await fbSigner.sign(payload, 'SUI', fbNote);
+    const signature = fbTx.signedMessages?.[0]?.signature?.fullSig;
+    const fbPubkey = fbTx.signedMessages?.[0]?.publicKey;
+
+    if (!signature) {
+      throw new Error(ERRORS.MISSING_SIGNATURE);
+    }
+
+    if (!fbPubkey) {
+      throw new Error(ERRORS.MISSING_PUBLIC_KEY);
+    }
+
+    const preparedTx = await this.client.POST('/sui/transaction/prepare', {
+      body: {
+        pubkey: fbPubkey,
+        signature: signature,
+        tx_serialized: tx.unsigned_tx_serialized,
+      },
+    });
+
+    if (preparedTx.error) {
+      throw new Error(ERRORS.FAILED_TO_PREPARE);
+    }
+
+    return {
+      signed_tx: preparedTx.data,
+      fireblocks_tx: fbTx,
+    };
+  }
 }

src/fireblocks_signer.ts

@@ -36,7 +36,8 @@ export type FireblocksAssetId =
   | 'KAVA_KAVA'
   | 'TRX'
   | 'BTC'
-  | 'SEI';
+  | 'SEI'
+  | 'SUI';
 
 export class FireblocksSigner {
   constructor(

src/utils.ts

@@ -336,3 +336,17 @@ export const seiToUsei = (sei: string): bigint => {
 export const useiToSei = (usei: bigint): string => {
   return formatUnits(usei, 6);
 };
+
+/**
+ * Convert SUI to mist
+ */
+export const suiToMist = (sui: string): bigint => {
+  return parseUnits(sui, 9);
+};
+
+/**
+ * Convert mist to SUI
+ */
+export const mistToSui = (mist: bigint): string => {
+  return formatUnits(mist, 9);
+};

src/validators.ts

@@ -105,4 +105,9 @@ export const KILN_VALIDATORS = {
       KILN: 'seivaloper1u9xeaqdjz3kky2ymdhdsn0ra5uy9tc3eqkjc8w',
     },
   },
+  SUI: {
+    mainnet: {
+      KILN: '0x92c7bf9914897e8878e559c19a6cffd22e6a569a6dd4d26f8e82e0f2ad1873d6',
+    },
+  },
 };