feat: Solana State SDK — Jupiter, Drift, Kamino protocol wrappers

[skansal-rome]

Summary

• Convert library extensions: Added read_u16le, read_u128le, u16le to contracts/convert.sol. Refactored existing read_i128le to use read_u128le.
• Jupiter v6 passthrough: JupiterLib execute_route helper + JupiterSwap convenience contract for forwarding pre-computed Jupiter API routes via CPI.
• Drift v2 full integration: Account parsers (PerpMarket, SpotMarket, User positions), PDA derivation, instruction builders (deposit, withdraw, place_perp_order, cancel_order), DriftOrderBuilder for market/limit orders, DriftController + DriftFactory.
• Kamino Lending + Vault: Reserve and Obligation parsers with health factor computation, PDA derivation, instruction builders (deposit, withdraw, borrow, repay), KaminoLending contract. Vault strategy parser + KaminoVault contract for LP provision.
• Unified DeFi interfaces: ISwap, ILending, IPerpetuals, ILiquidity protocol-agnostic interfaces + DeFiRouter implementing all four, delegating to protocol-specific libraries.
• Hardhat config: Enabled viaIR: true + optimizer for stack depth support in complex CPI account builders.

Architecture

┌──────────────────────────────────────────────────┐
│  Unified DeFi Layer                              │
│  ISwap · ILending · IPerpetuals · ILiquidity     │
│              DeFiRouter (delegates)              │
└──────────┬──────────┬──────────┬─────────────────┘
           │          │          │
┌──────────┴──┐ ┌─────┴──────┐ ┌┴─────────────────┐
│ JupiterLib  │ │ DriftLib   │ │ KaminoLendingLib  │
│ (passthru)  │ │ DriftIx    │ │ KaminoLendingIx   │
│             │ │ DriftPDA   │ │ KaminoVaultLib    │
│             │ │ DriftCtrl  │ │ KaminoVaultIx     │
└─────────────┘ └────────────┘ └───────────────────┘
                       │
         Rome CPI Precompile (0xFF...08)

⚠️ Before merging

• All byte offsets in parsers are marked VERIFY — must be validated against live Solana account dumps before production use
• Jupiter/Drift/Kamino may not be deployed on monti_spl; integration testing requires mock accounts or mainnet forks
• Program IDs are hardcoded from mainnet base58 addresses

Test plan

• npx hardhat compile — 49 files compile cleanly (solc 0.8.28, viaIR)
• Validate parser offsets against Anchor IDL account snapshots
• Deploy to monti_spl and run integration tests (blocked on protocol availability)
• Unit tests for Convert extensions with boundary values
• Unit tests for instruction builder discriminators

🤖 Generated with Claude Code