feat(sdk-coin-sol): add WASM-based transaction parsing via @bitgo/wasm-solana

Adds WASM-based transaction parsing using @bitgo/wasm-solana package
with no @solana/web3.js dependency in the parsing path.

WasmTransaction class for parsing Solana transactions using WASM:
- Transaction ID extraction from signatures
- Signable payload generation
- JSON serialization with parsed instruction data
- Transaction explanation for human readability
- Token name resolution via BitGo statics

Clean instruction combiner without @solana/web3.js dependency:
- Combines raw WASM-parsed instructions into BitGoJS InstructionParams
- Pattern matching for multi-instruction combinations:
  - CreateAccount + NonceInitialize → WalletInit
  - CreateAccount + StakeInitialize + Delegate → StakingActivate (Native)
  - CreateAccount + StakeInitialize → StakingActivate (Marinade)
  - StakePoolDepositSol → StakingActivate (Jito)
  - StakePoolWithdrawStake → StakingDeactivate (Jito)
- Derives transaction type from combined instructions
- Handles bigint to string conversion for amounts

Thin wrapper that orchestrates WASM instruction parsing:
1. Gets transaction bytes from WASM transaction
2. Parses with wasm-solana's parseTransaction()
3. Delegates to wasmParsedInstructionCombiner

- Added explainTransactionWithWasm() for WASM-based transaction explanation
- Integration with new WASM parsing layer

Fixed edge cases in staking instruction parsing:
- StakingAuthorize: support 4-key instructions (custodian optional)
- StakingAuthorizeRaw: support 2-3 instructions (one or both authorities)

- wasmTransaction.ts: Unit tests for WasmTransaction class
- jitoWasmVerification.ts: Jito staking WASM verification tests

TICKET: BTC-0

Author: lcovar

modules/sdk-coin-sol/bitgo-wasm-solana-0.0.1.tgz

@@ -44,6 +44,7 @@
     "@bitgo/sdk-core": "^36.29.0",
     "@bitgo/sdk-lib-mpc": "^10.8.1",
     "@bitgo/statics": "^58.23.0",
+    "@bitgo/wasm-solana": "file:bitgo-wasm-solana-0.0.1.tgz",
     "@solana/spl-stake-pool": "1.1.8",
     "@solana/spl-token": "0.3.1",
     "@solana/web3.js": "1.92.1",

modules/sdk-coin-sol/package.json

@@ -14,9 +14,11 @@ export { StakingWithdrawBuilder } from './stakingWithdrawBuilder';
 export { TokenTransferBuilder } from './tokenTransferBuilder';
 export { Transaction } from './transaction';
 export { TransactionBuilder } from './transactionBuilder';
+export { WasmTransaction } from './wasm';
 export { TransactionBuilderFactory } from './transactionBuilderFactory';
 export { TransferBuilder } from './transferBuilder';
 export { TransferBuilderV2 } from './transferBuilderV2';
 export { WalletInitializationBuilder } from './walletInitializationBuilder';
 export { Interface, Utils };
 export { MessageBuilderFactory } from './messages';
+export { InstructionBuilderTypes } from './constants';

modules/sdk-coin-sol/src/lib/index.ts

@@ -1171,7 +1171,10 @@ function parseStakingAuthorizeInstructions(
  */
 function parseStakingAuthorizeRawInstructions(instructions: TransactionInstruction[]): Array<Nonce | StakingAuthorize> {
   const instructionData: Array<Nonce | StakingAuthorize> = [];
-  assert(instructions.length === 2, 'Invalid number of instructions');
+  // StakingAuthorizeRaw transactions have:
+  // - 2 instructions: NonceAdvance + 1 Authorize (changing either staking OR withdraw authority)
+  // - 3 instructions: NonceAdvance + 2 Authorizes (changing BOTH staking AND withdraw authority)
+  assert(instructions.length >= 2 && instructions.length <= 3, 'Invalid number of instructions');
   const advanceNonceInstruction = SystemInstruction.decodeNonceAdvance(instructions[0]);
   const nonce: Nonce = {
     type: InstructionBuilderTypes.NonceAdvance,
@@ -1181,17 +1184,24 @@ function parseStakingAuthorizeRawInstructions(instructions: TransactionInstructi
     },
   };
   instructionData.push(nonce);
-  const authorize = instructions[1];
-  assert(authorize.keys.length === 5, 'Invalid number of keys in authorize instruction');
-  instructionData.push({
-    type: InstructionBuilderTypes.StakingAuthorize,
-    params: {
-      stakingAddress: authorize.keys[0].pubkey.toString(),
-      oldAuthorizeAddress: authorize.keys[2].pubkey.toString(),
-      newAuthorizeAddress: authorize.keys[3].pubkey.toString(),
-      custodianAddress: authorize.keys[4].pubkey.toString(),
-    },
-  });
+
+  // Process all authorize instructions (1 or 2)
+  for (let i = 1; i < instructions.length; i++) {
+    const authorize = instructions[i];
+    // Authorize instruction keys: [stakePubkey, clockSysvar, oldAuthority, newAuthority, custodian?]
+    // - 4 keys: no custodian required
+    // - 5 keys: custodian is present (required when stake is locked)
+    assert(authorize.keys.length >= 4 && authorize.keys.length <= 5, 'Invalid number of keys in authorize instruction');
+    instructionData.push({
+      type: InstructionBuilderTypes.StakingAuthorize,
+      params: {
+        stakingAddress: authorize.keys[0].pubkey.toString(),
+        oldAuthorizeAddress: authorize.keys[2].pubkey.toString(),
+        newAuthorizeAddress: authorize.keys[3].pubkey.toString(),
+        custodianAddress: authorize.keys.length === 5 ? authorize.keys[4].pubkey.toString() : '',
+      },
+    });
+  }
   return instructionData;
 }
 
@@ -1239,7 +1249,7 @@ function parseCustomInstructions(
   return instructionData;
 }
 
-function findTokenName(
+export function findTokenName(
   mintAddress: string,
   instructionMetadata?: InstructionParams[],
   _useTokenAddressTokenName?: boolean

modules/sdk-coin-sol/src/lib/instructionParamsFactory.ts

@@ -0,0 +1,7 @@
+/**
+ * WASM-only implementations for Solana.
+ *
+ * These implementations use @bitgo/wasm-solana exclusively,
+ * with zero @solana/web3.js dependencies.
+ */
+export { WasmTransaction } from './transaction';