| name | bifrost-slpx-info |
| description | Query Bifrost SLPx liquid staking protocol data on Ethereum, Base, Optimism, and Arbitrum.
Get vETH/ETH exchange rates, APY, TVL, user balances, redemption queue status, and protocol stats
via on-chain ERC-4626 vault calls and Bifrost REST API.
Use when users ask about Bifrost staking rates, vETH prices, DeFi yield, or vToken holdings. |
Bifrost SLPx Info
Query Bifrost vETH liquid staking data via on-chain calls to the VETH ERC-4626 vault contract.
Contract & Network
vETH is deployed on Ethereum and three L2 networks. The same contract address is used across all chains.
| Chain | ChainId | VETH Contract | WETH (underlying) | Default RPC | Fallback RPC |
|---|
| Ethereum | 1 | 0xc3997ff81f2831929499c4eE4Ee4e0F08F42D4D8 | 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 | https://ethereum.publicnode.com | https://1rpc.io/eth |
| Base | 8453 | 0xc3997ff81f2831929499c4eE4Ee4e0F08F42D4D8 | 0x4200000000000000000000000000000000000006 | https://base.publicnode.com | https://1rpc.io/base |
| Optimism | 10 | 0xc3997ff81f2831929499c4eE4Ee4e0F08F42D4D8 | 0x4200000000000000000000000000000000000006 | https://optimism.publicnode.com | https://1rpc.io/op |
| Arbitrum | 42161 | 0xc3997ff81f2831929499c4eE4Ee4e0F08F42D4D8 | 0x82aF49447D8a07e3bd95BD0d56f35241523fBab1 | https://arbitrum-one.publicnode.com | https://1rpc.io/arb |
Configuration (Environment Variables)
On first run, ask the user whether they want to configure custom settings. If not, use the defaults above.
| Variable | Description | Default |
|---|
BIFROST_CHAIN | Target chain name (ethereum, base, optimism, arbitrum) | ethereum |
BIFROST_RPC_URL | Custom RPC endpoint | Per-chain default from table above |
BIFROST_VETH_ADDRESS | VETH contract address (override) | 0xc3997ff81f2831929499c4eE4Ee4e0F08F42D4D8 |
Bifrost Backend API
Protocol-level statistics available via the Bifrost REST API (no RPC needed):
GET https://api.bifrost.app/api/site
Returns JSON with vETH object containing:
| Field | Description |
|---|
apy | Total APY (Base + Farming), e.g. "8.24" |
apyBase | Base staking APY from Ethereum validators, e.g. "3.12" |
apyReward | Additional Bifrost farming reward APY, e.g. "5.12" |
tvl | Total value locked in USD |
tvm | Total vETH minted (in ETH) |
totalIssuance | Total vETH supply (on Bifrost chain) |
holders | Number of vETH holders across all chains |
Use this API when users ask about APY, yield, TVL, or holder count.
Quick Reference
VETH is an ERC-4626 vault inheriting from VToken → VTokenBase → ERC4626Upgradeable. All standard ERC-4626 view functions are available. Exchange rates are Oracle-backed.
Token Info
| Query | Function | Selector | Args | Returns | Description |
|---|
| Token name | name() | 0x06fdde03 | none | string | Returns "Bifrost Voucher ETH" |
| Token symbol | symbol() | 0x95d89b41 | none | string | Returns "vETH" |
| Decimals | decimals() | 0x313ce567 | none | uint8 | Returns 18 |
| Underlying asset | asset() | 0x38d52e0f | none | address | Returns the WETH address (differs per chain, see Contract & Network table) |
Exchange Rate Queries
| Query | Function | Selector | Args | Returns | Description |
|---|
| ETH → vETH rate | convertToShares(uint256) | 0xc6e6f592 | assets (wei) | uint256 (shares) | Convert an ETH amount to the equivalent vETH shares using the current Oracle exchange rate |
| vETH → ETH rate | convertToAssets(uint256) | 0x07a2d13a | shares (wei) | uint256 (assets) | Convert a vETH shares amount to the equivalent ETH value using the current Oracle exchange rate |
| Preview deposit | previewDeposit(uint256) | 0xef8b30f7 | assets (wei) | uint256 (shares) | Simulate a deposit and return the exact vETH shares that would be minted |
| Preview mint | previewMint(uint256) | 0xb3d7f6b9 | shares (wei) | uint256 (assets) | Simulate minting a specific amount of vETH shares and return the ETH required |
| Preview withdraw | previewWithdraw(uint256) | 0x0a28a477 | assets (wei) | uint256 (shares) | Simulate withdrawing a specific ETH amount and return the vETH shares that would be burned |
| Preview redeem | previewRedeem(uint256) | 0x4cdad506 | shares (wei) | uint256 (assets) | Simulate a redemption and return the exact ETH that would be returned |
User Balance & Withdrawal Queries
| Query | Function | Selector | Args | Returns | Description |
|---|
| vETH balance | balanceOf(address) | 0x70a08231 | owner address | uint256 | Get the vETH token balance of a specific address |
| Claimable ETH | canWithdrawalAmount(address) | 0x52a630b9 | target address | (uint256, uint256, uint256) | Returns (totalAvailableAmount, pendingDeleteIndex, pendingDeleteAmount). First value = ETH ready to claim |
| Withdrawal queue | getWithdrawals(address) | 0x3a2b643a | target address | Withdrawal[] | Returns array of withdrawal entries, each with queued (amount in queue) and pending (amount being processed) fields |
| Max redeemable | maxRedeem(address) | 0xd905777e | owner address | uint256 | Maximum vETH shares the owner can redeem in a single tx |
| Max withdrawable | maxWithdraw(address) | 0xce96cb77 | owner address | uint256 | Maximum ETH the owner can withdraw in a single tx |
| Max depositable | maxDeposit(address) | 0x402d267d | receiver address | uint256 | Maximum ETH that can be deposited for receiver (typically type(uint256).max = unlimited) |
| Max mintable | maxMint(address) | 0xc63d75b6 | receiver address | uint256 | Maximum vETH shares that can be minted for receiver (typically type(uint256).max = unlimited) |
| Allowance | allowance(address,address) | 0xdd62ed3e | owner, spender | uint256 | Check vETH spending allowance granted by owner to spender |
Protocol Statistics
| Query | Function | Selector | Args | Returns | Description |
|---|
| Total assets | totalAssets() | 0x01e1d114 | none | uint256 | Total ETH managed by the vault, sourced from Oracle poolInfo(asset) |
| Total supply | totalSupply() | 0x18160ddd | none | uint256 | Total vETH tokens in circulation on this chain |
| Vault balance | getTotalBalance() | 0x12b58349 | none | uint256 | ETH available for payouts (BridgeVault balance + completed withdrawals) |
| Queued withdrawals | queuedWithdrawal() | 0x996e5c06 | none | uint256 | Total ETH amount currently queued for withdrawal globally |
| Completed withdrawals | completedWithdrawal() | 0x63ea1b92 | none | uint256 | Total ETH amount that has completed withdrawal processing globally |
| Max withdraw count | maxWithdrawCount() | 0xdc692cd7 | none | uint256 | Maximum number of concurrent pending withdrawal entries per user |
| Paused | paused() | 0x5c975abb | none | bool | Whether the contract is currently paused (deposits/redeems disabled) |
How to Call
All queries are read-only eth_call — no gas, no signing.
Method A: cast (preferred)
cast call <VETH_CONTRACT> \
"<FUNCTION_SIGNATURE>(<ARG_TYPES>)(<RETURN_TYPES>)" <ARGS> \
--rpc-url <RPC_URL>
Example — query exchange rate for 1 ETH on Ethereum:
cast call 0xc3997ff81f2831929499c4eE4Ee4e0F08F42D4D8 \
"convertToShares(uint256)(uint256)" 1000000000000000000 \
--rpc-url https://ethereum.publicnode.com
Method B: curl + JSON-RPC (if cast unavailable)
curl -s -X POST <RPC_URL> \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"eth_call","params":[{"to":"<VETH_CONTRACT>","data":"<SELECTOR><ENCODED_ARGS>"},"latest"]}'
Calldata Encoding
- No-arg functions: calldata = selector only (e.g.,
0x01e1d114 for totalAssets())
- uint256 arg: selector + amount in hex, left-padded to 64 chars
- Example: 1 ETH =
0xDE0B6B3A7640000 → pad to 0000000000000000000000000000000000000000000000000de0b6b3a7640000
- address arg: selector + address (no 0x), left-padded to 64 chars
- Example:
0xAbCd...1234 → 000000000000000000000000AbCd...1234
Response Decoding
- curl returns
{"result":"0x<hex>"}. For single uint256: convert 64 hex chars to decimal, divide by 1e18.
canWithdrawalAmount returns 3 × uint256 (192 hex chars): (totalAvailableAmount, pendingDeleteIndex, pendingDeleteAmount). First 64 chars = claimable ETH amount.
Agent Behavior
- Environment check: on first interaction, ask user if they want to configure
BIFROST_CHAIN or BIFROST_RPC_URL. If not, use Ethereum Mainnet defaults
- RPC selection: use
BIFROST_RPC_URL if set; otherwise use per-chain default RPC. Fall back to per-chain fallback RPC on failure
- Multi-chain awareness: when user specifies a chain (e.g. "on Base", "on Arbitrum"), switch to that chain's RPC and WETH address accordingly
- All values are in wei (18 decimals) — always convert to human-readable before displaying
- Default exchange rate query: show rate for 1 ETH if no amount specified
- Prompt for wallet address if not provided; display truncated (first 6 + last 4 chars)
- If
canWithdrawalAmount first value > 0, indicate claimable and suggest "claim my redeemed ETH"
- Prefer
cast call; fall back to curl + JSON-RPC with pre-computed calldata if cast fails
- Always fetch fresh data — do not cache across requests
- If RPC fails, retry with fallback before reporting error
- Useful links: direct users to Bifrost vETH page or Bifrost App when relevant
Error Handling
| Error | User Message |
|---|
| RPC failure | "Unable to connect to Ethereum. Retrying with backup endpoint..." |
Zero from convertToShares | "The vETH exchange rate is temporarily unavailable. The contract may be paused." |
| Empty withdrawal array | "You have no pending vETH redemptions." |
| Invalid address | "Please provide a valid Ethereum address (0x + 40 hex characters)." |
execution reverted | Retry with alternate method (cast ↔ curl). If both fail, report to user. |
Notes
- VETH inherits
VToken → VTokenBase → ERC4626Upgradeable / OwnableUpgradeable / PausableUpgradeable. All standard ERC-4626 view functions work
- Exchange rates are Oracle-backed via
oracle.poolInfo(asset) — may lag slightly vs. actual staking rewards
getWithdrawals returns Withdrawal[] where each entry has queued (amount waiting in queue) and pending (amount being processed by Bifrost)- The same VETH contract address is deployed on Ethereum, Base, Optimism, and Arbitrum — but WETH (underlying asset) addresses differ per chain
totalAssets() reflects the global pool size from Oracle, while totalSupply() is per-chain vETH circulationgetTotalBalance() = BridgeVault balance + completed withdrawals — represents ETH available for immediate payouts
