Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Kiln
Consensys Layer Deposit Manager Interface (v1)
This interface exposes methods to handle the interactions with the official deposit contract
Deposits current balance to the Consensus Layer by batches of 32 ETH
Name | Type | Description |
---|---|---|
Returns the amount of pending ETH
Name | Type | Description |
---|---|---|
Get the deposited validator count (the count of deposits made by the contract)
Retrieve the withdrawal credentials
A validator key got funded on the deposit contract
The stored deposit contract address changed
The stored withdrawal credentials changed
An error occured during the deposit
The length of the BLS Public key is invalid during deposit
The length of the BLS Signature is invalid during deposit
The received count of public keys to deposit is invalid
The received count of signatures to deposit is invalid
The withdrawal credentials value is null
The internal key retrieval returned no keys
Not enough funds to deposit one validator
Figment
Firewall
This interface exposes methods to accept calls to admin-level functions of an underlying contract.
Sets the permission for a function selector
Name | Type | Description |
---|---|---|
Retrieve the destination address
Name | Type | Description |
---|---|---|
Retrieve the executor address
Returns true if the executor is allowed to perform a call on the given selector
Sets the executor address
The stored destination address has been changed
The stored executor address has been changed
The storage permission for a selector has been changed
Kiln
Oracle Manager (v1)
This interface exposes methods to handle the inputs provided by the oracle
Get CL validator count (the amount of validator reported by the oracles)
Name | Type | Description |
---|---|---|
Get CL validator total balance
Name | Type | Description |
---|---|---|
Get oracle address
Sets the validator count and validator total balance sum reported by the oracle
Can only be called by the oracle addressThe round id is a blackbox value that should only be used to identify unique reportsWhen a report is performed, River computes the amount of fees that can be pulledfrom the execution layer fee recipient. This amount is capped by the max allowedincrease provided during the report.If the total asset balance increases (from the reported total balance and the pulled funds)we then compute the share that must be taken for the collector on the positive delta.The execution layer fees are taken into account here because they are the product ofnode operator's work, just like consensus layer fees, and both should be handled in thesame manner, as a single revenue stream for the users and the collector.
Set the oracle address
The consensus layer data provided by the oracle has been updated
The stored oracle address changed
The reported validator count is invalid
Kiln
Administrable Interface
This interface exposes methods to handle the ownership of the contracts
Accept the transfer of ownership
Only callable by the pending admin. Resets the pending admin if succesful.
Retrieves the current admin address
Name | Type | Description |
---|---|---|
Retrieve the current pending admin address
Proposes a new address as admin
This security prevents setting an invalid address as an admin. The pendingadmin has to claim its ownership of the contract, and prove that the newaddress is able to perform regular transactions.
The admin address changed
The pending admin address changed
Kiln
Allowlist Interface (v1)
This interface exposes methods to handle the list of allowed recipients.
Sets the allowlisting status for one or more accounts
The permission value is overridden and not updated
Name | Type | Description |
---|---|---|
Retrieves the allower address
This method retrieves the raw permission value
This method returns true if the user has the expected permission ignoring any deny list membership
Initializes the allowlist
This method returns true if the user has the expected permission and is not in the deny list
This method returns true if the user is in the deny list
This method should be used as a modifier and is expected to revert if the user hasn't got the required permission or if the user is in the deny list.
Changes the allower address
The stored allower address has been changed
The permissions of several accounts have changed
The account is denied access
The provided accounts list is empty
The provided accounts and permissions list have different lengths
Kiln
Redeem Manager Interface (v1)
This contract handles the redeem requests of all users
Claims the rewards of the provided redeem request ids
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Claims the rewards of the provided redeem request ids
Retrieve the amount of redeemed LsETH pending to be supplied with withdrawn ETH
Retrieve the amount of LsETH waiting to be exited
Retrieve the global count of redeem requests
Retrieve the details of a specific redeem request
Retrieve River address
Retrieve the global count of withdrawal events
Retrieve the details of a specific withdrawal event
Pulls exceeding buffer eth
Reports a withdraw event from River
Creates a redeem request
Creates a redeem request using msg.sender as recipient
Resolves the provided list of redeem request ids
The result is an array of equal length with ids or error code-1 means that the request is not satisfied yet-2 means that the request is out of bounds-3 means that the request has already been claimedThis call was created to be called by an off-chain interface, the output could then be used to perform the claimRewards call in a regular transaction
Emitted when a redeem request claim has been processed and matched at least once and funds are sent to the recipient
Emitted when a withdrawal event is created
Emitted when a redeem request is created
Emitted when a redeem request has been satisfied and filled (even partially) from a withdrawal event
Emitted when the redeem demand is set
Emitted when the River address is set
Thrown when the payment after a claim failed
Thrown when the redeem request and withdrawal event are not matching during claim
Thrown when the provided arrays don't have matching lengths
Thrown When a zero value is provided
Thrown when the redeem request id is already claimed
Thrown when the provided redeem request id is out of bounds
Thrown when a transfer error occured with LsETH
Thrown when the withdrawal request id if out of bounds
Thrown when the provided withdrawal event exceeds the redeem demand
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
_maxCount
uint256
The maximum amount of validator keys to fund
_0
uint256
The amount of pending ETH
_0
uint256
The deposited validator count
_0
bytes32
The withdrawal credentials
publicKey
bytes
BLS Public key that got funded
depositContract indexed
address
Address of the deposit contract
withdrawalCredentials
bytes32
The withdrawal credentials to use for deposits
_functionSelector
bytes4
Method signature on which the permission is changed
_executorCanCall
bool
True if selector is callable by the executor
_0
address
The destination address
_0
address
The executor address
_selector
bytes4
The selector to verify
_0
bool
True if executor is allowed to call
_newExecutor
address
New address for the executor
destination indexed
address
The new destination address
executor indexed
address
The new executor address
selector
bytes4
The 4 bytes method selector
status
bool
True if executor is allowed
_0
uint256
The CL validator count
_0
uint256
The CL Validator total balance
_0
address
The oracle address
_validatorCount
uint256
The number of active validators on the consensus layer
_validatorTotalBalance
uint256
The balance sum of the active validators on the consensus layer
_roundId
bytes32
An identifier for this update
_maxIncrease
uint256
The maximum allowed increase in the total balance
_oracleAddress
address
Address of the oracle
validatorCount
uint256
The new count of validators running on the consensus layer
validatorTotalBalance
uint256
The new total balance sum of all validators
roundId
bytes32
Round identifier
oracleAddress indexed
address
The new oracle address
providedValidatorCount
uint256
The received validator count value
depositedValidatorCount
uint256
The number of deposits performed by the system
_0
address
The admin address
_0
address
The pending admin address
_newAdmin
address
New admin address
admin indexed
address
New admin address
pendingAdmin indexed
address
New pending admin address
_accounts
address[]
Accounts with statuses to edit
_permissions
uint256[]
Allowlist permissions for each account, in the same order as _accounts
_0
address
The address of the allower
_account
address
Recipient to verify
_0
uint256
The raw permissions value of the account
_account
address
Recipient to verify
_mask
uint256
Combination of permissions to verify
_0
bool
True if mask is respected
_admin
address
Address of the Allowlist administrator
_allower
address
Address of the allower
_account
address
Recipient to verify
_mask
uint256
Combination of permissions to verify
_0
bool
True if mask is respected and user is allowed
_account
address
Recipient to verify
_0
bool
True if user is denied access
_account
address
Recipient to verify
_mask
uint256
Combination of permissions to verify
_newAllowerAddress
address
New address allowed to edit the allowlist
allower indexed
address
The new allower address
accounts
address[]
List of accounts
permissions
uint256[]
New permissions for each account at the same index
_account
address
The denied account
_redeemRequestIds
uint32[]
The list of redeem requests to claim
_withdrawalEventIds
uint32[]
The list of withdrawal events to use for every redeem request claim
_skipAlreadyClaimed
bool
True if the call should not revert on claiming of already claimed requests
_depth
uint16
The maximum recursive depth for the resolution of the redeem requests
claimStatuses
uint8[]
The list of claim statuses. 0 for fully claimed, 1 for partially claimed, 2 for skipped
_redeemRequestIds
uint32[]
The list of redeem requests to claim
_withdrawalEventIds
uint32[]
The list of withdrawal events to use for every redeem request claim
claimStatuses
uint8[]
The list of claim statuses. 0 for fully claimed, 1 for partially claimed, 2 for skipped
_0
uint256
The amount of eth in the buffer
_0
uint256
The amount of LsETH waiting to be exited
_0
uint256
undefined
_redeemRequestId
uint32
The id of the request
_0
RedeemQueue.RedeemRequest
The redeem request details
_0
address
The address of River
_0
uint256
undefined
_withdrawalEventId
uint32
The id of the withdrawal event
_0
WithdrawalStack.WithdrawalEvent
The withdrawal event details
_river
address
The address of the River contract
_max
uint256
The maximum amount that should be pulled
_lsETHWithdrawable
uint256
The amount of LsETH that can be redeemed due to this new withdraw event
_lsETHAmount
uint256
The amount of LsETH to redeem
_recipient
address
The recipient owning the redeem request
redeemRequestId
uint32
The id of the redeem request
_lsETHAmount
uint256
The amount of LsETH to redeem
redeemRequestId
uint32
The id of the redeem request
_redeemRequestIds
uint32[]
The list of redeem requests to resolve
withdrawalEventIds
int64[]
The list of withdrawal events matching every redeem request (or error codes)
redeemRequestId indexed
uint32
The id of the redeem request
recipient indexed
address
The address receiving the redeem request funds
ethAmount
uint256
The amount of eth retrieved
lsEthAmount
uint256
The total amount of LsETH used to redeem the eth
remainingLsEthAmount
uint256
The amount of LsETH remaining
height
uint256
The height of the withdrawal event in LsETH
amount
uint256
The amount of the withdrawal event in LsETH
ethAmount
uint256
The amount of eth to distrubute to claimers
id
uint32
The id of the withdrawal event
owner indexed
address
The owner of the redeem request
height
uint256
The height of the redeem request in LsETH
amount
uint256
The amount of the redeem request in LsETH
maxRedeemableEth
uint256
The maximum amount of eth that can be redeemed from this request
id
uint32
The id of the new redeem request
redeemRequestId indexed
uint32
The id of the redeem request
withdrawalEventId indexed
uint32
The id of the withdrawal event used to fill the request
lsEthAmountSatisfied
uint256
The amount of LsETH filled
ethAmountSatisfied
uint256
The amount of ETH filled
lsEthAmountRemaining
uint256
The amount of LsETH remaining
ethAmountExceeding
uint256
The amount of eth added to the exceeding buffer
oldRedeemDemand
uint256
The old redeem demand
newRedeemDemand
uint256
The new redeem demand
river
address
The new river address
recipient
address
The recipient of the payment
rdata
bytes
The revert data
redeemRequestId
uint256
The provided redeem request id
withdrawalEventId
uint256
The provided associated withdrawal event id
id
uint256
The redeem request id
id
uint256
The redeem request id
id
uint256
The withdrawal event id
withdrawalAmount
uint256
The amount of the withdrawal event
redeemDemand
uint256
The current redeem demand
Kiln
User Deposit Manager (v1)
This interface exposes methods to handle the inbound transfers cases or the explicit submissions
Explicit deposit method to mint on msg.sender
Explicit deposit method to mint on msg.sender and transfer to _recipient
Name | Type | Description |
---|---|---|
User deposited ETH in the system
And empty deposit attempt was made
Kiln
Shares Manager Interface (v1)
This interface exposes methods to handle the shares of the depositor and the ERC20 interface
Retrieve the allowance value for a spender
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Approves an account for future spendings
An approved account can use transferFrom to transfer funds on behalf of the token owner
Retrieve the balance of an account
Retrieve the underlying asset balance of an account
Retrieve the decimal count
Decrease allowance to another account
Increase allowance to another account
Retrieve the token name
Retrieve the shares count from an underlying asset amount
Retrieve the token symbol
Retrieve the total token supply
Retrieve the total underlying asset supply
Performs a transfer from the message sender to the provided account
Performs a transfer between two recipients
Retrieve the underlying asset balance from an amount of shares
Allowance too low to perform operation
Balance too low to perform operation
Invalid empty transfer
Invalid transfer recipients
Kiln
Oracle Interface (v1)
This interface exposes methods to handle the input from the allowed oracle members.Highly inspired by Lido's implementation.
Adds new address as oracle member, giving the ability to push cl reports.
Only callable by the adminstratorModifying the quorum clears all the reporting data
Name | Type | Description |
---|---|---|
Retrieve the current cl spec
Retrieve the current epoch id based on block timestamp
Retrieve the current frame details
Retrieve expected epoch id
Retrieve the first epoch id of the frame of the provided epoch id
Retrieve member report status
Retrieve the last completed epoch id
Retrieve member report status
Retrieve the list of oracle members
Retrieve the current quorum
Retrieve the report bounds
Retrieve decoded report at provided index
Retrieve report variants count
Retrieve River address
Retrieve the block timestamp
Initializes the oracle
Returns true if address is member
Performs a naive search, do not call this on-chain, used as an off-chain helper
Removes an address from the oracle members.
Only callable by the adminstratorModifying the quorum clears all the reporting dataRemaining members that have already voted should vote again for the same frame.
Report cl chain data
Only callable by an oracle memberThe epoch id is expected to be >= to the expected epoch id stored in the contractThe epoch id is expected to be the first epoch of its frameThe Consensus Layer Validator count is the amount of running validators managed by River.Until withdrawals are enabled, this count also takes into account any exited and slashed validatoras funds are still locked on the consensus layer.
Edits the cl spec parameters
Only callable by the adminstrator
Changes the address of an oracle member
Only callable by the adminitratorCannot use an address already in useThis call will clear all the reporting data
Edits the quorum required to forward cl data to River
Modifying the quorum clears all the reporting data
Edits the cl bounds parameters
Only callable by the adminstrator
A member has been added to the oracle member list
Consensus Layer data has been reported by an oracle member
The expected epoch id has been changed
The report has been submitted to river
A member has been removed from the oracle member list
The report bounds have been changed
A member address has been edited
The storage quorum value has been changed
The storage river address value has been changed
The consensus layer spec has been changed
The address is already in use by an oracle member
The member already reported on the given epoch id
The provided epoch is too old compared to the expected epoch id
The provided epoch is not at the beginning of its frame
The negative delta in balance is above the allowed lower bound
The delta in balance is above the allowed upper bound
Alluvial
ERC20 Vestable Votes Upgradeable Interface(v1)
This interface exposes methods to manage vestings
Computes the releasable amount of tokens for a vesting schedule.
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Computes the vested amount of tokens for a vesting schedule.
Creates a new vesting scheduleThere may delay between the time a user should start vesting tokens and the time the vesting schedule is actually created on the contract.Typically a user joins the Liquid Collective but some weeks pass before the user gets all legal agreements in place and signed for thetoken grant emission to happen. In this case, the vesting schedule created for the token grant would start on the join date which is in the past.
As vesting schedules can be created in the past, this means that you should be careful when creating a vesting schedule and what duration parametersyou use as this contract would allow creating a vesting schedule in the past and even a vesting schedule that has already ended.
Delegate vesting escrowed tokens
Get vesting schedule
The vesting schedule structure represents a static configuration used to compute the desiredvesting details of a beneficiary at all times. The values won't change even after tokens are released.The only dynamic field of the structure is end, and is updated whenever a vesting schedule is revoked
Get count of vesting schedules
Release vesting scheduleWhen tokens are released from the escrow, the delegated address of the escrow will see its voting power decrease.The beneficiary has to make sure its delegation parameters are set properly to be able to use/delegate the voting power of its balance.
Revoke vesting schedule
Get the address of the escrow for a vesting schedule
A new vesting schedule has been created
Vesting escrow has been delegated
Vesting schedule has been released
Vesting schedule has been revoked
Attempt to revoke a vesting schedule with an invalid end parameter
Invalid parameter for a vesting schedule
Vesting schedule creator has unsufficient balance to create vesting schedule
The vesting schedule is locked
The vesting schedule is not revocable
Attempt to revoke a schedule in the past
No token to release
Kiln
Wrapped LsETH Interface (v1)
This interface exposes methods to wrap the LsETH token into a rebase token.
Retrieves the token allowance given from one address to another
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Approves another account to transfer tokens
Retrieves the token balance of the specified user
Burn tokens and retrieve underlying LsETH tokens
The message sender burns shares from its balance for the LsETH equivalent valueThe message sender doesn't need to approve the contract to burn the sharesThe freed LsETH is sent to the specified recipient
Retrieves the token decimal count
Decrease allowance to another account
Increase allowance to another account
Initializes the wrapped token contract
Mint tokens by providing LsETH tokens
The message sender locks LsETH tokens and received wrapped LsETH tokens in exchangeThe message sender needs to approve the contract to mint the wrapped tokensThe minted wrapped LsETH is sent to the specified recipient
Retrieves the token full name
Retrieves the raw shares count of the user
Retrieves the token symbol
Retrieves the token total supply
Transfers tokens between the message sender and a recipient
Transfers tokens between two accounts
It is expected that _from has given at least _value allowance to msg.sender
An approval has been made
Tokens have been burned
Tokens have been minted
The stored value of river has been changed
A transfer has been made
Allowance too low to perform operation
Balance too low to perform operation
Invalid empty transfer
The token transfer failed during the minting or burning process
Invalid transfer recipients
Kiln
Operators Registry Interface (v1)
This interface exposes methods to handle the list of operators and their keys
Adds an operator to the registry
Only callable by the administrator
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Adds new keys for an operator
Only callable by the administrator or the operator address
Get operator details
Get operator count
Retrieve the River address
Get the details of a validator
Initializes the operators registry
Retrieve the active operator set
Retrieve validator keys based on operator statuses
Remove validator keys
Only callable by the administrator or the operator addressThe indexes must be provided sorted in decreasing order and duplicate-free, otherwise the method will revertThe operator limit will be set to the lowest deleted key index if the operator's limit wasn't equal to its total key countThe operator or the admin cannot remove funded keysWhen removing validators, the indexes of specific unfunded keys can be changed in order to properlyremove the keys from the storage array. Beware of this specific behavior when chaining calls as thetargeted public key indexes can point to a different key after a first call was made and performedsome swaps
Changes the operator address of an operator
Only callable by the administrator or the previous operator address
Changes the operator staking limit
Only callable by the administratorThe operator indexes must be in increasing order and contain no duplicateThe limit cannot exceed the total key count of the operatorThe _indexes and _newLimits must have the same length.Each limit value is applied to the operator index at the same index in the _indexes array.
Changes the operator name
Only callable by the administrator or the operator
Changes the operator status
Only callable by the administrator
Changes the operator stopped validator count
Only callable by the administrator
A new operator has been added to the registry
The operator or the admin added new validator keys and signatures
The public keys and signatures are concatenatedA public key is 48 bytes longA signature is 96 bytes long[P1, S1, P2, S2, ..., PN, SN] where N is the bytes length divided by (96 + 48)
The operator edited its keys after the snapshot block
This means that we cannot assume that its key set is checked by the snapshotThis happens only if the limit was meant to be increased
The call didn't alter the limit of the operator
The operator or the admin removed a public key and its signature from the registry
The operator address has been changed
The operator limit has been changed
The operator display name has been changed
The operator status has been changed
The operator stopped validator count has been changed
The stored river address has been changed
The calling operator is inactive
The provided operator and limits array have different lengths
The provided operator and limits array are empty
A funded key deletion has been attempted
The index that is removed is out of bounds
The provided key count is 0
The provided concatenated keys do not have the expected length
The index provided are not sorted properly (descending order)
The value for the operator limit is too high
The value for the limit is too low
The provided list of operators is not in increasing order
Alluvial
TLC Interface (v1)
TLC token interface
Returns the remaining number of tokens that spender
will be allowed to spend on behalf of owner
through {transferFrom}. This is zero by default. This value changes when {approve} or {transferFrom} are called.
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Sets amount
as the allowance of spender
over the caller's tokens. Returns a boolean value indicating whether the operation succeeded. IMPORTANT: Beware that changing an allowance with this method brings the risk that someone may use both the old and the new allowance by unfortunate transaction ordering. One possible solution to mitigate this race condition is to first reduce the spender's allowance to 0 and set the desired value afterwards: https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729 Emits an {Approval} event.
Returns the amount of tokens owned by account
.
Computes the releasable amount of tokens for a vesting schedule.
Computes the vested amount of tokens for a vesting schedule.
Creates a new vesting scheduleThere may delay between the time a user should start vesting tokens and the time the vesting schedule is actually created on the contract.Typically a user joins the Liquid Collective but some weeks pass before the user gets all legal agreements in place and signed for thetoken grant emission to happen. In this case, the vesting schedule created for the token grant would start on the join date which is in the past.
As vesting schedules can be created in the past, this means that you should be careful when creating a vesting schedule and what duration parametersyou use as this contract would allow creating a vesting schedule in the past and even a vesting schedule that has already ended.
Delegates votes from the sender to delegatee
.
Delegates votes from signer to delegatee
.
Delegate vesting escrowed tokens
Returns the delegate that account
has chosen.
Returns the total supply of votes available at the end of a past block (blockNumber
). NOTE: This value is the sum of all available votes, which is not necessarily the sum of all delegated votes. Votes that have not been delegated are still part of total supply, even though they would not participate in a vote.
Returns the amount of votes that account
had at the end of a past block (blockNumber
).
Get vesting schedule
The vesting schedule structure represents a static configuration used to compute the desiredvesting details of a beneficiary at all times. The values won't change even after tokens are released.The only dynamic field of the structure is end, and is updated whenever a vesting schedule is revoked
Get count of vesting schedules
Returns the current amount of votes that account
has.
Initializes the TLC Token
Migrates the vesting schedule state structures
Release vesting scheduleWhen tokens are released from the escrow, the delegated address of the escrow will see its voting power decrease.The beneficiary has to make sure its delegation parameters are set properly to be able to use/delegate the voting power of its balance.
Revoke vesting schedule
Returns the amount of tokens in existence.
Moves amount
tokens from the caller's account to to
. Returns a boolean value indicating whether the operation succeeded. Emits a {Transfer} event.
Moves amount
tokens from from
to to
using the allowance mechanism. amount
is then deducted from the caller's allowance. Returns a boolean value indicating whether the operation succeeded. Emits a {Transfer} event.
Get the address of the escrow for a vesting schedule
A new vesting schedule has been created
Vesting escrow has been delegated
Vesting schedule has been released
Vesting schedule has been revoked
Attempt to revoke a vesting schedule with an invalid end parameter
Invalid parameter for a vesting schedule
Vesting schedule creator has unsufficient balance to create vesting schedule
The vesting schedule is locked
The vesting schedule is not revocable
Attempt to revoke a schedule in the past
No token to release
Kiln
Execution Layer Fee Recipient Interface (v1)
This interface exposes methods to receive all the execution layer fees from the proposed blocks + bribes
Initialize the fee recipient with the required arguments
Name | Type | Description |
---|
Pulls ETH to the River contract
Only callable by the River contract
Name | Type | Description |
---|
The storage river address has changed
The fallback has been triggered
Kiln
Coverage Fund Interface (v1)
This interface exposes methods to receive donations for the slashing coverage fund and pull the funds into river
Donates ETH to the coverage fund contract
Initialize the coverage fund with the required arguments
Name | Type | Description |
---|
Pulls ETH into the River contract
Only callable by the River contract
A donation has been made to the coverage fund
The storage river address has changed
A donation with 0 ETH has been performed
The fallback or receive callback has been triggered
Kiln
River Interface (v1)
The main system interface
Retrieve the allowance value for a spender
Name | Type | Description |
---|
Name | Type | Description |
---|
Approves an account for future spendings
An approved account can use transferFrom to transfer funds on behalf of the token owner
Retrieve the balance of an account
Retrieve the underlying asset balance of an account
Retrieve the decimal count
Decrease allowance to another account
Explicit deposit method to mint on msg.sender
Explicit deposit method to mint on msg.sender and transfer to _recipient
Deposits current balance to the Consensus Layer by batches of 32 ETH
Retrieve the allowlist address
Returns the amount of pending ETH
Get CL validator count (the amount of validator reported by the oracles)
Get CL validator total balance
Retrieve the collector address
Retrieve the coverage fund
Get the deposited validator count (the count of deposits made by the contract)
Retrieve the execution layer fee recipient
Get the current global fee
Retrieve the metadata uri string value
Retrieve the operators registry
Get oracle address
Retrieve the withdrawal credentials
Increase allowance to another account
Initializes the River system
Retrieve the token name
Input for coverage funds
Input for execution layer fee earnings
Changes the allowlist address
Changes the collector address
Sets the validator count and validator total balance sum reported by the oracle
Can only be called by the oracle addressThe round id is a blackbox value that should only be used to identify unique reportsWhen a report is performed, River computes the amount of fees that can be pulledfrom the execution layer fee recipient. This amount is capped by the max allowedincrease provided during the report.If the total asset balance increases (from the reported total balance and the pulled funds)we then compute the share that must be taken for the collector on the positive delta.The execution layer fees are taken into account here because they are the product ofnode operator's work, just like consensus layer fees, and both should be handled in thesame manner, as a single revenue stream for the users and the collector.
Changes the coverage fund
Changes the execution layer fee recipient
Changes the global fee parameter
Sets the metadata uri string value
Set the oracle address
Retrieve the shares count from an underlying asset amount
Retrieve the token symbol
Retrieve the total token supply
Retrieve the total underlying asset supply
Performs a transfer from the message sender to the provided account
Performs a transfer between two recipients
Retrieve the underlying asset balance from an amount of shares
The consensus layer data provided by the oracle has been updated
A validator key got funded on the deposit contract
Funds have been pulled from the Coverage Fund
Funds have been pulled from the Execution Layer Fee Recipient
The system underlying supply increased. This is a snapshot of the balances for accounting purposes
The stored Allowlist has been changed
The stored Collector has been changed
The stored Coverage Fund has been changed
The stored deposit contract address changed
The stored Execution Layer Fee Recipient has been changed
The stored Global Fee has been changed
The stored Metadata URI string has been changed
The stored Operators Registry has been changed
The stored oracle address changed
The stored withdrawal credentials changed
User deposited ETH in the system
Allowance too low to perform operation
Balance too low to perform operation
The access was denied
And empty deposit attempt was made
An error occured during the deposit
The length of the BLS Public key is invalid during deposit
The length of the BLS Signature is invalid during deposit
The received count of public keys to deposit is invalid
The received count of signatures to deposit is invalid
The reported validator count is invalid
The withdrawal credentials value is null
The internal key retrieval returned no keys
Not enough funds to deposit one validator
Invalid empty transfer
Invalid transfer recipients
The computed amount of shares to mint is 0
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
_recipient
address
Address receiving the minted LsETH
depositor indexed
address
Address performing the deposit
recipient indexed
address
Address receiving the minted shares
amount
uint256
Amount in ETH deposited
_owner
address
Address that issued the allowance
_spender
address
Address that received the allowance
_0
uint256
The allowance in shares for a given spender
_spender
address
Address that is allowed to spend the tokens
_value
uint256
The allowed amount in shares, will override previous value
_0
bool
True if success
_owner
address
Address to be checked
_0
uint256
The balance of the account in shares
_owner
address
Address to be checked
_0
uint256
The underlying balance of the account
_0
uint8
The decimal count
_spender
address
Spender that receives the allowance
_subtractableValue
uint256
Amount of shares to subtract
_0
bool
True if success
_spender
address
Spender that receives the allowance
_additionalValue
uint256
Amount of shares to add
_0
bool
True if success
_0
string
The token name
_underlyingAssetAmount
uint256
Amount of underlying asset to convert
_0
uint256
The amount of shares worth the underlying asset amopunt
_0
string
The token symbol
_0
uint256
The total supply in shares
_0
uint256
The total underlying asset supply
_to
address
Address receiving the tokens
_value
uint256
Amount of shares to be sent
_0
bool
True if success
_from
address
Address sending the tokens
_to
address
Address receiving the tokens
_value
uint256
Amount of shares to be sent
_0
bool
True if success
_shares
uint256
Amount of shares to convert
_0
uint256
The underlying asset balance represented by the shares
owner indexed
address
undefined
spender indexed
address
undefined
value
uint256
undefined
from indexed
address
undefined
to indexed
address
undefined
value
uint256
undefined
_from
address
Account where funds are sent from
_operator
address
Account attempting the transfer
_allowance
uint256
Current allowance
_value
uint256
Requested transfer value in shares
_from
address
Account sending the funds in the invalid transfer
_to
address
Account receiving the funds in the invalid transfer
_newOracleMember
address
Address of the new member
_newQuorum
uint256
New quorum value
_0
CLSpec.CLSpecStruct
The Consensus Layer Specification
_0
uint256
The current epoch id
_startEpochId
uint256
The epoch at the beginning of the frame
_startTime
uint256
The timestamp of the beginning of the frame in seconds
_endTime
uint256
The timestamp of the end of the frame in seconds
_0
uint256
The current expected epoch id
_epochId
uint256
Epoch id used to get the frame
_0
uint256
The first epoch id of the frame containing the given epoch id
_0
uint256
The raw report status value
_0
uint256
The last completed epoch id
_oracleMember
address
Address of member to check
_0
bool
True if member has reported
_0
address[]
The oracle members
_0
uint256
The current quorum
_0
ReportBounds.ReportBoundsStruct
The report bounds
_idx
uint256
Index of report
_clBalance
uint64
The reported consensus layer balance sum of River's validators
_clValidators
uint32
The reported validator count
_reportCount
uint16
The number of similar reports
_0
uint256
The count of report variants
_0
address
The address of River
_0
uint256
The current timestamp from the EVM context
_river
address
Address of the River contract, able to receive oracle input data after quorum is met
_administratorAddress
address
Address able to call administrative methods
_epochsPerFrame
uint64
CL spec parameter. Number of epochs in a frame.
_slotsPerEpoch
uint64
CL spec parameter. Number of slots in one epoch.
_secondsPerSlot
uint64
CL spec parameter. Number of seconds between slots.
_genesisTime
uint64
CL spec parameter. Timestamp of the genesis slot.
_annualAprUpperBound
uint256
CL bound parameter. Maximum apr allowed for balance increase. Delta between updates is extrapolated on a year time frame.
_relativeLowerBound
uint256
CL bound parameter. Maximum relative balance decrease.
_memberAddress
address
Address of the member
_0
bool
True if address is a member
_oracleMember
address
Address to remove
_newQuorum
uint256
New quorum value
_epochId
uint256
Epoch where the balance and validator count has been computed
_clValidatorsBalance
uint64
Total balance of River validators
_clValidatorCount
uint32
Total River validator count
_epochsPerFrame
uint64
Number of epochs in a frame.
_slotsPerEpoch
uint64
Number of slots in one epoch.
_secondsPerSlot
uint64
Number of seconds between slots.
_genesisTime
uint64
Timestamp of the genesis slot.
_oracleMember
address
Address to change
_newAddress
address
New address for the member
_newQuorum
uint256
New quorum parameter
_annualAprUpperBound
uint256
Maximum apr allowed for balance increase. Delta between updates is extrapolated on a year time frame.
_relativeLowerBound
uint256
Maximum relative balance decrease.
member indexed
address
The address of the member
epochId
uint256
The epoch of the report
newCLBalance
uint128
The new consensus layer balance
newCLValidatorCount
uint32
The new consensus layer validator count
oracleMember
address
The oracle member that reported
epochId
uint256
The new expected epoch id
postTotalEth
uint256
The new total ETH balance
prevTotalEth
uint256
The previous total ETH balance
timeElapsed
uint256
Time since last report
totalShares
uint256
The new total amount of shares
member indexed
address
The address of the member
annualAprUpperBound
uint256
The maximum allowed apr. 10% means increases in balance extrapolated to a year should not exceed 10%.
relativeLowerBound
uint256
The maximum allowed balance decrease as a relative % of the total balance
oldAddress indexed
address
The previous member address
newAddress indexed
address
The new member address
newQuorum
uint256
The new quorum value
_river
address
The new river address
epochsPerFrame
uint64
The number of epochs inside a frame (225 = 24 hours)
slotsPerEpoch
uint64
The number of slots inside an epoch (32 on ethereum mainnet)
secondsPerSlot
uint64
The time between two slots (12 seconds on ethereum mainnet)
genesisTime
uint64
The timestamp of block #0
newAddress
address
The address already in use
epochId
uint256
The epoch id provided as input
member
address
The oracle member
providedEpochId
uint256
The epoch id provided as input
minExpectedEpochId
uint256
The minimum epoch id expected
providedEpochId
uint256
The epoch id provided as input
expectedFrameFirstEpochId
uint256
The frame first epoch id that was expected
prevTotalEth
uint256
The previous total balance
postTotalEth
uint256
The new total balance
timeElapsed
uint256
The time since last report
relativeLowerBound
uint256
The maximum relative decrease allowed
prevTotalEth
uint256
The previous total balance
postTotalEth
uint256
The new total balance
timeElapsed
uint256
The time since last report
annualAprUpperBound
uint256
The maximum apr allowed
_index
uint256
index of the vesting schedule
_0
uint256
amount of releasable tokens
_index
uint256
index of the vesting schedule
_0
uint256
amount of vested tokens
_start
uint64
start time of the vesting
_cliffDuration
uint32
duration to vesting cliff (in seconds)
_duration
uint32
total vesting schedule duration after which all tokens are vested (in seconds)
_periodDuration
uint32
duration of a period after which new tokens unlock (in seconds)
_lockDuration
uint32
duration during which tokens are locked (in seconds)
_revocable
bool
whether the vesting schedule is revocable or not
_amount
uint256
amount of token attributed by the vesting schedule
_beneficiary
address
address of the beneficiary of the tokens
_delegatee
address
address to delegate escrow voting power to
_0
uint256
index of the created vesting schedule
_index
uint256
index of the vesting schedule
_delegatee
address
address to delegate the token to
_0
bool
True on success
_index
uint256
Index of the vesting schedule
_0
VestingSchedulesV2.VestingSchedule
undefined
_0
uint256
count of vesting schedules
_index
uint256
Index of the vesting schedule to release
_0
uint256
released amount
_index
uint256
Index of the vesting schedule to revoke
_end
uint64
End date for the schedule
returnedAmount
uint256
amount returned to the vesting schedule creator
_index
uint256
Index of the vesting schedule
_0
address
address of the escrow
index
uint256
Vesting schedule index
creator indexed
address
Creator of the vesting schedule
beneficiary indexed
address
Vesting beneficiary address
amount
uint256
Vesting schedule amount
index
uint256
Vesting schedule index
oldDelegatee indexed
address
old delegatee
newDelegatee indexed
address
new delegatee
beneficiary indexed
address
vesting schedule beneficiary
index
uint256
Vesting schedule index
releasedAmount
uint256
Amount of tokens released to the beneficiary
index
uint256
Vesting schedule index
returnedAmount
uint256
Amount of tokens returned to the creator
newEnd
uint256
New end timestamp after revoke action
msg
string
undefined
_owner
address
Owner that gave the allowance
_spender
address
Spender that received the allowance
_0
uint256
The allowance of the owner to the spender
_spender
address
Spender that receives the allowance
_value
uint256
Amount to allow
_0
bool
True if success
_owner
address
Owner to check the balance
_0
uint256
The balance of the owner
_recipient
address
The account receiving the underlying LsETH tokens after shares are burned
_shares
uint256
Amount of LsETH to free by burning wrapped LsETH
_0
uint8
The decimal count
_spender
address
Spender that receives the allowance
_subtractableValue
uint256
Amount to subtract
_0
bool
True if success
_spender
address
Spender that receives the allowance
_additionalValue
uint256
Amount to add
_0
bool
True if success
_river
address
Address of the River contract
_recipient
address
The account receiving the new minted wrapped LsETH
_shares
uint256
The amount of LsETH to wrap
_0
string
The name of the token
_owner
address
Owner to check the shares balance
_0
uint256
The shares of the owner
_0
string
The symbol of the token
_0
uint256
The total supply
_to
address
Recipient of the transfer
_value
uint256
Amount to transfer
_0
bool
True if success
_from
address
Sender account
_to
address
Recipient of the transfer
_value
uint256
Amount to transfer
_0
bool
True if success
owner indexed
address
The token owner
spender indexed
address
The account allowed by the owner
value
uint256
The amount allowed
recipient indexed
address
The account that receive the underlying LsETH
shares
uint256
The amount of LsETH that got sent back
recipient indexed
address
The account receiving the new tokens
shares
uint256
The amount of LsETH provided
river indexed
address
The new address of river
from indexed
address
The transfer sender
to indexed
address
The transfer recipient
value
uint256
The amount transfered
_from
address
Account where funds are sent from
_operator
address
Account attempting the transfer
_allowance
uint256
Current allowance
_value
uint256
Requested transfer value
_from
address
Account sending the funds in the invalid transfer
_to
address
Account receiving the funds in the invalid transfer
_name
string
The name identifying the operator
_operator
address
The address representing the operator, receiving the rewards
_0
uint256
The index of the new operator
_index
uint256
The operator index
_keyCount
uint256
The amount of keys provided
_publicKeysAndSignatures
bytes
Public keys of the validator, concatenated
_index
uint256
The index of the operator
_0
Operators.Operator
The details of the operator
_0
uint256
The operator count
_0
address
The address of River
_operatorIndex
uint256
The index of the operator
_validatorIndex
uint256
The index of the validator
publicKey
bytes
The public key of the validator
signature
bytes
The signature used during deposit
funded
bool
True if validator has been funded
_admin
address
Admin in charge of managing operators
_river
address
Address of River system
_0
Operators.Operator[]
The list of active operators and their details
_count
uint256
Max amount of keys requested
publicKeys
bytes[]
An array of public keys
signatures
bytes[]
An array of signatures linked to the public keys
_index
uint256
The operator index
_indexes
uint256[]
The indexes of the keys to remove
_index
uint256
The operator index
_newOperatorAddress
address
The new address of the operator
_operatorIndexes
uint256[]
The operator indexes, in increasing order and duplicate free
_newLimits
uint256[]
The new staking limit of the operators
_snapshotBlock
uint256
The block number at which the snapshot was computed
_index
uint256
The operator index
_newName
string
The new operator name
_index
uint256
The operator index
_newStatus
bool
The new status of the operator
_index
uint256
The operator index
_newStoppedValidatorCount
uint256
The new stopped validator count of the operator
index indexed
uint256
The operator index
name
string
The operator display name
operatorAddress indexed
address
The operator address
index indexed
uint256
The operator index
publicKeysAndSignatures
bytes
The concatenated public keys and signatures
index indexed
uint256
The operator index
currentLimit
uint256
The current operator limit
newLimit
uint256
The new operator limit that was attempted to be set
latestKeysEditBlockNumber indexed
uint256
The last block number at which the operator changed its keys
snapshotBlock indexed
uint256
The block number of the snapshot
index indexed
uint256
The operator index
limit
uint256
The limit of the operator
index indexed
uint256
The operator index
publicKey
bytes
The BLS public key that has been removed
index indexed
uint256
The operator index
newOperatorAddress indexed
address
The new operator address
index indexed
uint256
The operator index
newLimit
uint256
The new operator staking limit
index indexed
uint256
The operator index
newName
string
The new display name
index indexed
uint256
The operator index
active
bool
True if the operator is active
index indexed
uint256
The operator index
newStoppedValidatorCount
uint256
The new stopped validator count
river indexed
address
The new river address
index
uint256
The operator index
index
uint256
The operator index
limit
uint256
The new limit provided
keyCount
uint256
The operator key count
index
uint256
The operator index
limit
uint256
The new limit provided
fundedKeyCount
uint256
The operator funded key count
owner
address
undefined
spender
address
undefined
_0
uint256
undefined
spender
address
undefined
amount
uint256
undefined
_0
bool
undefined
account
address
undefined
_0
uint256
undefined
_index
uint256
index of the vesting schedule
_0
uint256
amount of releasable tokens
_index
uint256
index of the vesting schedule
_0
uint256
amount of vested tokens
_start
uint64
start time of the vesting
_cliffDuration
uint32
duration to vesting cliff (in seconds)
_duration
uint32
total vesting schedule duration after which all tokens are vested (in seconds)
_periodDuration
uint32
duration of a period after which new tokens unlock (in seconds)
_lockDuration
uint32
duration during which tokens are locked (in seconds)
_revocable
bool
whether the vesting schedule is revocable or not
_amount
uint256
amount of token attributed by the vesting schedule
_beneficiary
address
address of the beneficiary of the tokens
_delegatee
address
address to delegate escrow voting power to
_0
uint256
index of the created vesting schedule
delegatee
address
undefined
delegatee
address
undefined
nonce
uint256
undefined
expiry
uint256
undefined
v
uint8
undefined
r
bytes32
undefined
s
bytes32
undefined
_index
uint256
index of the vesting schedule
_delegatee
address
address to delegate the token to
_0
bool
True on success
account
address
undefined
_0
address
undefined
blockNumber
uint256
undefined
_0
uint256
undefined
account
address
undefined
blockNumber
uint256
undefined
_0
uint256
undefined
_index
uint256
Index of the vesting schedule
_0
VestingSchedulesV2.VestingSchedule
undefined
_0
uint256
count of vesting schedules
account
address
undefined
_0
uint256
undefined
_account
address
The initial account to grant all the minted tokens
_index
uint256
Index of the vesting schedule to release
_0
uint256
released amount
_index
uint256
Index of the vesting schedule to revoke
_end
uint64
End date for the schedule
returnedAmount
uint256
amount returned to the vesting schedule creator
_0
uint256
undefined
to
address
undefined
amount
uint256
undefined
_0
bool
undefined
from
address
undefined
to
address
undefined
amount
uint256
undefined
_0
bool
undefined
_index
uint256
Index of the vesting schedule
_0
address
address of the escrow
owner indexed
address
undefined
spender indexed
address
undefined
value
uint256
undefined
index
uint256
undefined
creator indexed
address
undefined
beneficiary indexed
address
undefined
amount
uint256
undefined
delegator indexed
address
undefined
fromDelegate indexed
address
undefined
toDelegate indexed
address
undefined
delegate indexed
address
undefined
previousBalance
uint256
undefined
newBalance
uint256
undefined
index
uint256
undefined
oldDelegatee indexed
address
undefined
newDelegatee indexed
address
undefined
beneficiary indexed
address
undefined
index
uint256
undefined
releasedAmount
uint256
undefined
index
uint256
undefined
returnedAmount
uint256
undefined
newEnd
uint256
undefined
from indexed
address
undefined
to indexed
address
undefined
value
uint256
undefined
msg
string
undefined
river | address | The new river address |
_maxAmount | uint256 | The maximum amount to pull into the system |
donator | address | Address that performed the donation |
amount | uint256 | The amount donated |
river | address | The new river address |
_spender | address | Address that is allowed to spend the tokens |
_value | uint256 | The allowed amount in shares, will override previous value |
_0 | bool | True if success |
_owner | address | Address to be checked |
_0 | uint256 | The balance of the account in shares |
_owner | address | Address to be checked |
_0 | uint256 | The underlying balance of the account |
_0 | uint8 | The decimal count |
_spender | address | Spender that receives the allowance |
_subtractableValue | uint256 | Amount of shares to subtract |
_0 | bool | True if success |
_recipient | address | Address receiving the minted LsETH |
_maxCount | uint256 | The maximum amount of validator keys to fund |
_0 | address | The allowlist address |
_0 | uint256 | The amount of pending ETH |
_0 | uint256 | The CL validator count |
_0 | uint256 | The CL Validator total balance |
_0 | address | The collector address |
_0 | address | The coverage fund address |
_0 | uint256 | The deposited validator count |
_0 | address | The execution layer fee recipient address |
_0 | uint256 | The global fee |
_0 | string | The metadata uri string value |
_0 | address | The operators registry address |
_0 | address | The oracle address |
_0 | bytes32 | The withdrawal credentials |
_spender | address | Spender that receives the allowance |
_additionalValue | uint256 | Amount of shares to add |
_0 | bool | True if success |
_depositContractAddress | address | Address to make Consensus Layer deposits |
_elFeeRecipientAddress | address | Address that receives the execution layer fees |
_withdrawalCredentials | bytes32 | Credentials to use for every validator deposit |
_oracleAddress | address | The address of the Oracle contract |
_systemAdministratorAddress | address | Administrator address |
_allowlistAddress | address | Address of the allowlist contract |
_operatorRegistryAddress | address | Address of the operator registry |
_collectorAddress | address | Address receiving the the global fee on revenue |
_globalFee | uint256 | Amount retained when the ETH balance increases and sent to the collector |
_0 | string | The token name |
_newAllowlist | address | New address for the allowlist |
_newCollector | address | New address for the collector |
_validatorCount | uint256 | The number of active validators on the consensus layer |
_validatorTotalBalance | uint256 | The balance sum of the active validators on the consensus layer |
_roundId | bytes32 | An identifier for this update |
_maxIncrease | uint256 | The maximum allowed increase in the total balance |
_newCoverageFund | address | New address for the fund |
_newELFeeRecipient | address | New address for the recipient |
newFee | uint256 | New fee value |
_metadataURI | string | The new metadata uri string value |
_oracleAddress | address | Address of the oracle |
_underlyingAssetAmount | uint256 | Amount of underlying asset to convert |
_0 | uint256 | The amount of shares worth the underlying asset amopunt |
_0 | string | The token symbol |
_0 | uint256 | The total supply in shares |
_0 | uint256 | The total underlying asset supply |
_to | address | Address receiving the tokens |
_value | uint256 | Amount of shares to be sent |
_0 | bool | True if success |
_from | address | Address sending the tokens |
_to | address | Address receiving the tokens |
_value | uint256 | Amount of shares to be sent |
_0 | bool | True if success |
_shares | uint256 | Amount of shares to convert |
_0 | uint256 | The underlying asset balance represented by the shares |
owner | address | undefined |
spender | address | undefined |
value | uint256 | undefined |
validatorCount | uint256 | undefined |
validatorTotalBalance | uint256 | undefined |
roundId | bytes32 | undefined |
publicKey | bytes | undefined |
amount | uint256 | The amount pulled |
amount | uint256 | The amount pulled |
_collector | address | The address of the collector during this event |
_oldTotalUnderlyingBalance | uint256 | Old total ETH balance under management by River |
_oldTotalSupply | uint256 | Old total supply in shares |
_newTotalUnderlyingBalance | uint256 | New total ETH balance under management by River |
_newTotalSupply | uint256 | New total supply in shares |
allowlist | address | The new Allowlist |
collector | address | The new Collector |
coverageFund | address | The new Coverage Fund |
depositContract | address | undefined |
elFeeRecipient | address | The new Execution Layer Fee Recipient |
fee | uint256 | The new Global Fee |
metadataURI | string | The new Metadata URI string |
operatorRegistry | address | The new Operators Registry |
oracleAddress | address | undefined |
withdrawalCredentials | bytes32 | undefined |
from | address | undefined |
to | address | undefined |
value | uint256 | undefined |
depositor | address | undefined |
recipient | address | undefined |
amount | uint256 | undefined |
_from | address | Account where funds are sent from |
_operator | address | Account attempting the transfer |
_allowance | uint256 | Current allowance |
_value | uint256 | Requested transfer value in shares |
account | address | The account that was denied |
providedValidatorCount | uint256 | The received validator count value |
depositedValidatorCount | uint256 | The number of deposits performed by the system |
_from | address | Account sending the funds in the invalid transfer |
_to | address | Account receiving the funds in the invalid transfer |
pubkey | bytes | The 48 bytes long BLS Public key representing the validator |
withdrawalCredentials | bytes | The 32 bytes long withdrawal credentials, configures the withdrawal recipient |
signature | bytes | The 96 bytes long BLS Signature performed by the pubkey's private key |
depositDataRoot | bytes32 | The root hash of the whole deposit data structure |
_riverAddress | address | Address of River |
_maxAmount | uint256 | The maximum amount to pull into the system |
_riverAddress | address | Address of River |
_owner | address | Address that issued the allowance |
_spender | address | Address that received the allowance |
_0 | uint256 | The allowance in shares for a given spender |