Method Name
public/get_kelp_effective_balances
public/get_kelp_effective_balancesGet all effective rsETH balances for a specific block number for a given number of addresses.
Here is the flow of rsETH:
1. Users deposit rsETH into one of several bridges (ARB, ETH)
2. This rsETH is minted to a single contract on the Derive chain
3. A socket bridge hook deposits this rsETH into a Derive Vault which mints shares
4. Those shares are bridged back to the source chain in the form of rsETH-C
To calculate the effective rsETH balances that users have in our vaults, we need to:
1. total_deposits: the total amount of rsETH deposited by users across all chains
2. user_shares: count how many rsETH-C shares are held across chains
3. Filter out users that have not registered with the orderbook
4. effective_balance: user_shares / total_shares * total_deposits
If no addresses are provided, returns all effective balances for all addresses.
NOTE: only users who have registered via derive.xyz are elligible to be tracked.
NOTE: This route cannot be tested locally
Parameters
| mainnet_blocknumber
integer
required
The mainnet blocknumber to get the effective balances for. Effective balances on both mainnet and arbitrum will be returned. |
| wallets
array of strings
Specify list of EOA accounts to query |
Response
| id
string or integer
required
|
| result
object
required
|
| result.mainnet_timestamp_sec
integer
required
The mainnet timestamp in seconds |
| result.blocknumbers
object
required
The block number used for each chain |
| result.effective_balances
object
required
The effective balance for each wallet address |
| result.total_deposits
object
required
The total deposits for each chain |
Example
{request_example_shell}
{request_example_javascript}
{request_example_python}
The above command returns JSON structured like this:
{response_example_json}