feat(TS): Integrate Zerion API for agentkit

[pcminh0505]

Description

• Integrate 2 Zerion API endpoints for portfolio fetching
  • get_portfolio_overview: Get aggregated USD balance of a wallet address
  • get_fungible_positions: Get aggregated token positions (wallet and DeFi) of a wallet address

Requirement: Zerion API key

Example

• get_portfolio_overview

Wallet Portfolio Overview:
- Total Value: $3267.53
- 24h Change: -0.63%
- Position Types: wallet: $497.17, deposited: $2138.66, staked: $631.65
- Top Chains: unichain: $2179.59, base: $815.98, ethereum: $270.11, polygon: $0.85, abstract: $0.58

• get_fungible_positions

Total Value: $3762.01

Token Positions (>$1):
- ETH (Ethereum) on unichain — $1134.21 [deposit via Uniswap V4]
- USD₮0 (USD₮0) on unichain — $1004.22 [deposit via Uniswap V4]
- WELL (WELL) on base — $630.55 [staked via Moonwell]
- MORPHO (Morpho Token) on base — $497.49 [deposit via Moonwell]
- ETH (Ethereum) on ethereum — $268.30 [wallet]
- ETH (Ethereum) on base — $182.84 [wallet]
- ETH (Ethereum) on unichain — $40.94 [wallet]
- UNI (Uniswap) on ethereum — $1.92 [wallet]
- ALCH (Alchemist Accelerate) on base — $1.54 [wallet]

Tests

 PASS  src/action-providers/zerion/zerionActionProvider.test.ts (8.381 s)
  ZerionActionProvider
    ✓ should throw if no API key is provided (10 ms)
    ✓ should use provided API key from config
    ✓ should support the protocol family
    ✓ should not support other protocol families
    ✓ should handle invalid network objects
    getPortfolioOverview
      ✓ returns error for invalid address
      ✓ returns formatted data for valid address (1 ms)
      ✓ returns error on fetch failure
    getFungiblePositions
      ✓ returns error for invalid address (1 ms)
      ✓ returns formatted data for valid address
      ✓ returns error on fetch failure

Checklist

A couple of things to include in your PR for completeness:

• Added documentation to all relevant README.md files
• Added a changelog entry

[cb-heimdall]

🟡 Heimdall Review Status

Requirement	Status	More Info
Reviews	🟡 0/1	Denominator calculation Show calculation 1 if user is bot 0 1 if user is external 0 From .codeflow.yml 1 Additional review requirements Show calculation Max 0 0 From CODEOWNERS 0 Global minimum 0 Max 1 1 1 if commit is unverified 0 Sum 1

[chungquantin]

Looks good, hope this is merged!