​
Function Signature

signTransaction(params: {
  senderAddress: string;
  externalServerKeyShares: any[];
  transaction: Transaction;
  password?: string;
}): Promise<string>

​
Description

Signs an SVM transaction using the specified wallet address. This function requires external server key shares and a valid session ID for authentication.

​
Parameters

​
Required Parameters

  • senderAddress (string) - The wallet address to sign with
  • externalServerKeyShares (any[]) - Array of external server key shares
  • transaction (Transaction) - The transaction to sign (Solana web3.js format)

​
Optional Parameters

  • password (string) - Wallet password (if wallet is password-protected)

​
Returns

  • Promise<string> - The signed transaction as a serialized string

​
Example

import { authenticatedSvmClient } from './client';
import { Transaction, SystemProgram, LAMPORTS_PER_SOL } from '@solana/web3.js';

const svmClient = await authenticatedSvmClient();

const transaction = new Transaction().add(
  SystemProgram.transfer({
    fromPubkey: new PublicKey('YourSolanaWalletAddress'),
    toPubkey: new PublicKey('11111111111111111111111111111112'),
    lamports: LAMPORTS_PER_SOL * 0.001,
  })
);

const signedTx = await svmClient.signTransaction({
  senderAddress: 'YourSolanaWalletAddress',
  externalServerKeyShares: [
    {
      chainName: 'solana',
      keyShare: '0x1234567890',
    },
  ],
  transaction: transaction,
  password: 'optional-password',
});

console.log('Signed transaction:', signedTx);

​
Key Share Format

interface KeyShare {
  chainName: string;
  keyShare: string;
}

const externalServerKeyShares: KeyShare[] = [
  {
    chainName: 'solana', // or your specific Solana chain
    keyShare: '0x1234567890', // the actual key share
  },
];

​
Error Handling

try {
  const signedTx = await svmClient.signTransaction({
    senderAddress: 'YourSolanaWalletAddress',
    externalServerKeyShares: keyShares,
    transaction: tx,
  });
  console.log('Transaction signed successfully');
} catch (error) {
  console.error('Failed to sign transaction:', error);
}

​
Security Considerations

  • Transaction Validation: Always validate transaction parameters before signing
  • Key Share Security: Keep external server key shares secure
  • Session Management: Implement proper session management
  • Network Verification: Ensure you’re signing transactions for the correct Solana network