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
1---2name: bifrost-slpx-info3description: 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.4---56# Bifrost SLPx Info78Query Bifrost vETH liquid staking data via on-chain calls to the VETH ERC-4626 vault contract.910## Contract & Network1112vETH is deployed on Ethereum and three L2 networks. The same contract address is used across all chains.1314| Chain | ChainId | VETH Contract | WETH (underlying) | Default RPC | Fallback RPC |15|-------|---------|---------------|--------------------|----|------|16| Ethereum | 1 | `0xc3997ff81f2831929499c4eE4Ee4e0F08F42D4D8` | `0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2` | `https://ethereum.publicnode.com` | `https://1rpc.io/eth` |17| Base | 8453 | `0xc3997ff81f2831929499c4eE4Ee4e0F08F42D4D8` | `0x4200000000000000000000000000000000000006` | `https://base.publicnode.com` | `https://1rpc.io/base` |18| Optimism | 10 | `0xc3997ff81f2831929499c4eE4Ee4e0F08F42D4D8` | `0x4200000000000000000000000000000000000006` | `https://optimism.publicnode.com` | `https://1rpc.io/op` |19| Arbitrum | 42161 | `0xc3997ff81f2831929499c4eE4Ee4e0F08F42D4D8` | `0x82aF49447D8a07e3bd95BD0d56f35241523fBab1` | `https://arbitrum-one.publicnode.com` | `https://1rpc.io/arb` |2021## Configuration (Environment Variables)2223On first run, ask the user whether they want to configure custom settings. If not, use the defaults above.2425| Variable | Description | Default |26|----------|-------------|---------|27| `BIFROST_CHAIN` | Target chain name (`ethereum`, `base`, `optimism`, `arbitrum`) | `ethereum` |28| `BIFROST_RPC_URL` | Custom RPC endpoint | Per-chain default from table above |29| `BIFROST_VETH_ADDRESS` | VETH contract address (override) | `0xc3997ff81f2831929499c4eE4Ee4e0F08F42D4D8` |3031## Bifrost Backend API3233Protocol-level statistics available via the Bifrost REST API (no RPC needed):3435```36GET https://api.bifrost.app/api/site37```3839Returns JSON with `vETH` object containing:4041| Field | Description |42|-------|-------------|43| `apy` | Total APY (Base + Farming), e.g. `"8.24"` |44| `apyBase` | Base staking APY from Ethereum validators, e.g. `"3.12"` |45| `apyReward` | Additional Bifrost farming reward APY, e.g. `"5.12"` |46| `tvl` | Total value locked in USD |47| `tvm` | Total vETH minted (in ETH) |48| `totalIssuance` | Total vETH supply (on Bifrost chain) |49| `holders` | Number of vETH holders across all chains |5051Use this API when users ask about APY, yield, TVL, or holder count.5253## Quick Reference5455VETH is an ERC-4626 vault inheriting from `VToken → VTokenBase → ERC4626Upgradeable`. All standard ERC-4626 view functions are available. Exchange rates are Oracle-backed.5657### Token Info5859| Query | Function | Selector | Args | Returns | Description |60|-------|----------|----------|------|---------|-------------|61| Token name | `name()` | `0x06fdde03` | none | string | Returns `"Bifrost Voucher ETH"` |62| Token symbol | `symbol()` | `0x95d89b41` | none | string | Returns `"vETH"` |63| Decimals | `decimals()` | `0x313ce567` | none | uint8 | Returns `18` |64| Underlying asset | `asset()` | `0x38d52e0f` | none | address | Returns the WETH address (differs per chain, see Contract & Network table) |6566### Exchange Rate Queries6768| Query | Function | Selector | Args | Returns | Description |69|-------|----------|----------|------|---------|-------------|70| 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 |71| 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 |72| Preview deposit | `previewDeposit(uint256)` | `0xef8b30f7` | assets (wei) | uint256 (shares) | Simulate a deposit and return the exact vETH shares that would be minted |73| Preview mint | `previewMint(uint256)` | `0xb3d7f6b9` | shares (wei) | uint256 (assets) | Simulate minting a specific amount of vETH shares and return the ETH required |74| Preview withdraw | `previewWithdraw(uint256)` | `0x0a28a477` | assets (wei) | uint256 (shares) | Simulate withdrawing a specific ETH amount and return the vETH shares that would be burned |75| Preview redeem | `previewRedeem(uint256)` | `0x4cdad506` | shares (wei) | uint256 (assets) | Simulate a redemption and return the exact ETH that would be returned |7677### User Balance & Withdrawal Queries7879| Query | Function | Selector | Args | Returns | Description |80|-------|----------|----------|------|---------|-------------|81| vETH balance | `balanceOf(address)` | `0x70a08231` | owner address | uint256 | Get the vETH token balance of a specific address |82| Claimable ETH | `canWithdrawalAmount(address)` | `0x52a630b9` | target address | (uint256, uint256, uint256) | Returns `(totalAvailableAmount, pendingDeleteIndex, pendingDeleteAmount)`. First value = ETH ready to claim |83| 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 |84| Max redeemable | `maxRedeem(address)` | `0xd905777e` | owner address | uint256 | Maximum vETH shares the owner can redeem in a single tx |85| Max withdrawable | `maxWithdraw(address)` | `0xce96cb77` | owner address | uint256 | Maximum ETH the owner can withdraw in a single tx |86| Max depositable | `maxDeposit(address)` | `0x402d267d` | receiver address | uint256 | Maximum ETH that can be deposited for receiver (typically type(uint256).max = unlimited) |87| Max mintable | `maxMint(address)` | `0xc63d75b6` | receiver address | uint256 | Maximum vETH shares that can be minted for receiver (typically type(uint256).max = unlimited) |88| Allowance | `allowance(address,address)` | `0xdd62ed3e` | owner, spender | uint256 | Check vETH spending allowance granted by owner to spender |8990### Protocol Statistics9192| Query | Function | Selector | Args | Returns | Description |93|-------|----------|----------|------|---------|-------------|94| Total assets | `totalAssets()` | `0x01e1d114` | none | uint256 | Total ETH managed by the vault, sourced from Oracle `poolInfo(asset)` |95| Total supply | `totalSupply()` | `0x18160ddd` | none | uint256 | Total vETH tokens in circulation on this chain |96| Vault balance | `getTotalBalance()` | `0x12b58349` | none | uint256 | ETH available for payouts (BridgeVault balance + completed withdrawals) |97| Queued withdrawals | `queuedWithdrawal()` | `0x996e5c06` | none | uint256 | Total ETH amount currently queued for withdrawal globally |98| Completed withdrawals | `completedWithdrawal()` | `0x63ea1b92` | none | uint256 | Total ETH amount that has completed withdrawal processing globally |99| Max withdraw count | `maxWithdrawCount()` | `0xdc692cd7` | none | uint256 | Maximum number of concurrent pending withdrawal entries per user |100| Paused | `paused()` | `0x5c975abb` | none | bool | Whether the contract is currently paused (deposits/redeems disabled) |101102## How to Call103104All queries are read-only `eth_call` — no gas, no signing.105106**Method A: cast** (preferred)107```bash108cast call <VETH_CONTRACT> \109 "<FUNCTION_SIGNATURE>(<ARG_TYPES>)(<RETURN_TYPES>)" <ARGS> \110 --rpc-url <RPC_URL>111```112113Example — query exchange rate for 1 ETH on Ethereum:114```bash115cast call 0xc3997ff81f2831929499c4eE4Ee4e0F08F42D4D8 \116 "convertToShares(uint256)(uint256)" 1000000000000000000 \117 --rpc-url https://ethereum.publicnode.com118```119120**Method B: curl + JSON-RPC** (if cast unavailable)121```bash122curl -s -X POST <RPC_URL> \123 -H "Content-Type: application/json" \124 -d '{"jsonrpc":"2.0","id":1,"method":"eth_call","params":[{"to":"<VETH_CONTRACT>","data":"<SELECTOR><ENCODED_ARGS>"},"latest"]}'125```126127### Calldata Encoding128129- **No-arg functions**: calldata = selector only (e.g., `0x01e1d114` for `totalAssets()`)130- **uint256 arg**: selector + amount in hex, left-padded to 64 chars131 - Example: 1 ETH = `0xDE0B6B3A7640000` → pad to `0000000000000000000000000000000000000000000000000de0b6b3a7640000`132- **address arg**: selector + address (no 0x), left-padded to 64 chars133 - Example: `0xAbCd...1234` → `000000000000000000000000AbCd...1234`134135### Response Decoding136137- curl returns `{"result":"0x<hex>"}`. For single uint256: convert 64 hex chars to decimal, divide by 1e18.138- `canWithdrawalAmount` returns 3 × uint256 (192 hex chars): `(totalAvailableAmount, pendingDeleteIndex, pendingDeleteAmount)`. First 64 chars = claimable ETH amount.139140## Agent Behavior1411421. **Environment check**: on first interaction, ask user if they want to configure `BIFROST_CHAIN` or `BIFROST_RPC_URL`. If not, use Ethereum Mainnet defaults1432. **RPC selection**: use `BIFROST_RPC_URL` if set; otherwise use per-chain default RPC. Fall back to per-chain fallback RPC on failure1443. **Multi-chain awareness**: when user specifies a chain (e.g. "on Base", "on Arbitrum"), switch to that chain's RPC and WETH address accordingly1454. All values are in wei (18 decimals) — always convert to human-readable before displaying1465. Default exchange rate query: show rate for 1 ETH if no amount specified1476. Prompt for wallet address if not provided; display truncated (first 6 + last 4 chars)1487. If `canWithdrawalAmount` first value > 0, indicate claimable and suggest "claim my redeemed ETH"1498. Prefer `cast call`; fall back to `curl` + JSON-RPC with pre-computed calldata if cast fails1509. Always fetch fresh data — do not cache across requests15110. If RPC fails, retry with fallback before reporting error15211. **Useful links**: direct users to [Bifrost vETH page](https://www.bifrost.io/vtoken/veth) or [Bifrost App](https://app.bifrost.io/vstaking/vETH) when relevant153154## Error Handling155156| Error | User Message |157|-------|-------------|158| RPC failure | "Unable to connect to Ethereum. Retrying with backup endpoint..." |159| Zero from `convertToShares` | "The vETH exchange rate is temporarily unavailable. The contract may be paused." |160| Empty withdrawal array | "You have no pending vETH redemptions." |161| Invalid address | "Please provide a valid Ethereum address (0x + 40 hex characters)." |162| `execution reverted` | Retry with alternate method (cast ↔ curl). If both fail, report to user. |163164## Notes1651661. VETH inherits `VToken → VTokenBase → ERC4626Upgradeable / OwnableUpgradeable / PausableUpgradeable`. All standard ERC-4626 view functions work1672. Exchange rates are Oracle-backed via `oracle.poolInfo(asset)` — may lag slightly vs. actual staking rewards1683. `getWithdrawals` returns `Withdrawal[]` where each entry has `queued` (amount waiting in queue) and `pending` (amount being processed by Bifrost)1694. The same VETH contract address is deployed on Ethereum, Base, Optimism, and Arbitrum — but WETH (underlying asset) addresses differ per chain1705. `totalAssets()` reflects the global pool size from Oracle, while `totalSupply()` is per-chain vETH circulation1716. `getTotalBalance()` = BridgeVault balance + completed withdrawals — represents ETH available for immediate payouts
dvcrn