Wallet Hierarchical Script Support

[Andre-Diamond]

Multisig Wallet Hierarchical Script Support

Context

We currently build wallets via src/utils/common.ts and use the results across API routes, hooks, and UI. There are three wallet types:

• Legacy: payment keys only
• SDK: built using MultisigWallet
• Summon: uses rawImportBodies.multisig payloads (payment and optional stake scripts)

Summon wallets can include hierarchical native scripts (for example, all wrapping a single atLeast), and may or may not include staking capabilities. We need to correctly parse these scripts, derive addresses, and expose capabilities so all dependent code behaves correctly.

Example imported payment native script (decoded):

{
  "type": "all",
  "scripts": [
    {
      "type": "atLeast",
      "required": 2,
      "scripts": [
        {
          "type": "sig",
          "keyHash": "b8b7d...dfde7"
        },
        {
          "type": "sig",
          "keyHash": "f4755...1faa1"
        },
        {
          "type": "sig",
          "keyHash": "59d8f...60762"
        }
      ]
    }
  ]
}

Desired Behavior

• Summon wallets should be usable wherever addresses, scripts, or capability detection are required.
• Hierarchical native scripts should be parsed to extract the effective signing rule and key hashes.
• Feature flags should be derived from the actual scripts:
  • Payment script always required
  • Staking only when a valid stake script is provided or a stake credential hash is derived
• UI and API should not assume MultisigWallet exists for Summon wallets.

[Andre-Diamond]

feat: enhance wallet balance handling and native script decoding

Initial commit

• Added getCanonicalWalletAddress function to standardize wallet address retrieval based on wallet type in useWalletBalances.ts.
• Refactored balance fetching logic to utilize the new canonical address function.
• Improved error handling for multisig wallet construction in the API endpoint, falling back to decoding stored CBOR for imported wallets.
• Introduced native script utilities in nativeScriptUtils.ts for decoding, converting, and analyzing native scripts.
• Added comprehensive tests for the new native script utilities, covering various scenarios including hierarchical and deeply nested scripts.
• Updated common.ts to leverage new native script utilities for wallet construction.
• Cleaned up unused code and improved overall structure for better maintainability.