BeaconDeposit

0x4242424242424242424242424242424242424242 | ABI JSON

The contract handling validators deposits. Its events are used by the beacon chain to manage the staking process.

Functions

getOperator

Get the operator address for a given pubkey.

Returns zero address if the pubkey is not registered.

function getOperator(bytes calldata pubkey) external view returns (address);

Parameters

Name	Type	Description
pubkey	bytes	The pubkey of the validator.

Returns

Name	Type	Description
<none>	address	The operator address for the given pubkey.

deposit

Submit a deposit message to the Beaconchain.

This will be used to create a new validator or to top up an existing one, increasing stake.

emits the Deposit event upon successful deposit.

Reverts if the operator is already set and caller passed non-zero operator.

function deposit(
    bytes calldata pubkey,
    bytes calldata credentials,
    bytes calldata signature,
    address operator
)
    external
    payable;

Parameters

Name	Type	Description
pubkey	bytes	is the consensus public key of the validator.
credentials	bytes	is the withdrawal credentials of the validator.
signature	bytes	is the signature used only on the first deposit.
operator	address	is the address of the operator used for POL mechanics.

requestOperatorChange

Request to change the operator of a validator.

Only the current operator can request a change.

function requestOperatorChange(bytes calldata pubkey, address newOperator) external;

Parameters

Name	Type	Description
pubkey	bytes	The pubkey of the validator.
newOperator	address	The new operator address.

cancelOperatorChange

Cancel the operator change of a validator.

Only the current operator can cancel the change.

function cancelOperatorChange(bytes calldata pubkey) external;

Parameters

Name	Type	Description
pubkey	bytes	The pubkey of the validator.

acceptOperatorChange

Accept the operator change of a validator.

Only the new operator can accept the change.

Reverts if the queue delay has not passed.

function acceptOperatorChange(bytes calldata pubkey) external;

Parameters

Name	Type	Description
pubkey	bytes	The pubkey of the validator.

Events

Deposit

Emitted when a deposit is made, which could mean a new validator or a top up of an existing one.

event Deposit(bytes pubkey, bytes credentials, uint64 amount, bytes signature, uint64 index);

Parameters

Name	Type	Description
pubkey	bytes	the public key of the validator.
credentials	bytes	is the withdrawal credentials of the validator.
amount	uint64	the amount of stake being deposited, in Gwei.
signature	bytes	the signature of the deposit message.
index	uint64	the index of the deposit.

OperatorChangeQueued

Emitted when the operator change of a validator is queued.

event OperatorChangeQueued(
    bytes indexed pubkey, address queuedOperator, address currentOperator, uint256 queuedTimestamp
);

Parameters

Name	Type	Description
pubkey	bytes	The pubkey of the validator.
queuedOperator	address	The new queued operator address.
currentOperator	address	The current operator address.
queuedTimestamp	uint256	The timestamp when the change was queued.

OperatorChangeCancelled

Emitted when the operator change of a validator is cancelled.

event OperatorChangeCancelled(bytes indexed pubkey);

Parameters

Name	Type	Description
pubkey	bytes	The pubkey of the validator.

OperatorUpdated

Emitted when the operator of a validator is updated.

event OperatorUpdated(bytes indexed pubkey, address newOperator, address previousOperator);

Parameters

Name	Type	Description
pubkey	bytes	The pubkey of the validator.
newOperator	address	The new operator address.
previousOperator	address	The previous operator address.