feat: add the vault liquid staking adapter

[0xkr3p]

Summary by CodeRabbit

• New Features
  • Added The Vault liquid staking pool integration, enabling real-time TVL and APY tracking for the vSOL token.

[coderabbitai]

Warning

Rate limit exceeded

@0xkr3p has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 6 minutes and 54 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

📝 Walkthrough

Walkthrough

A new adapter module for the vSOL liquid staking pool on Solana is introduced. It fetches total supply, current SOL price, and APY data concurrently, validates the inputs, and returns computed TVL and APY metrics for the pool.

Changes

Cohort / File(s)	Summary
New Vault Liquid Staking Adapter src/adaptors/the-vault-liquid-staking/index.js	Implements async apy() function that concurrently retrieves total supply, vSOL price, and APY data; validates and converts values, then returns pool metadata including TVL in USD and base APY. Exports timetravel, apy, and url properties.

Sequence Diagram

sequenceDiagram
    participant Caller as Caller/Client
    participant Adapter as vSOL Adapter
    participant OnChain as On-Chain Data
    participant PriceAPI as Price API
    participant APYData as APY Data Source
    
    Caller->>Adapter: Call apy()
    par Concurrent Fetches
        Adapter->>OnChain: Fetch vSOL total supply
        Adapter->>PriceAPI: Fetch current SOL price
        Adapter->>APYData: Fetch latest APY
    and
        OnChain-->>Adapter: Supply value
        PriceAPI-->>Adapter: Price value
        APYData-->>Adapter: APY value
    end
    
    Adapter->>Adapter: Validate price & APY
    Adapter->>Adapter: Convert APY to percentage
    Adapter->>Adapter: Compute TVL (supply × price)
    
    Adapter-->>Caller: Return pool array with TVL & APY

Loading

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

• feat: add blazestake adapter #2383: Adds a near-identical Solana liquid-staking adapter with the same module structure and concurrent data-fetching pattern.
• feat: add doublezero staked sol #2381: Introduces an adapter with nearly identical implementation that fetches total supply, price, and APY to compute TVL and APY.
• feat: add starke-staked-sol #2376: Implements a Solana liquid-staking adapter with concurrent async fetching of supply, price, and APY, exporting the same module shape.

Poem

🐰 A new vSOL nest to tend,
Where prices dance and APYs blend,
Concurrent whispers, swift and fair,
TVL blooms in Solana's air! ✨

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title 'feat: add the vault liquid staking adapter' accurately reflects the main change—adding a new adapter for The Vault liquid staking protocol. It is concise, clear, and directly related to the changeset.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[0xkr3p]

@coderabbitai review

[coderabbitai]

✅ Actions performed

Review triggered.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.