Slasher

Git Source

Methods

FACTORY

function FACTORY() external view returns (address)

Get the factory's address.

Returns

Name	Type	Description
	address	address of the factory

NETWORK_MIDDLEWARE_SERVICE

function NETWORK_MIDDLEWARE_SERVICE() external view returns (address)

Get the network middleware service's address.

Returns

Name	Type	Description
	address	address of the network middleware service

TYPE

function TYPE() external view returns (uint64)

Get the entity's type.

Returns

Name	Type	Description
	uint64	type of the entity

VAULT_FACTORY

function VAULT_FACTORY() external view returns (address)

Get the vault factory's address.

Returns

Name	Type	Description
	address	address of the vault factory

cumulativeSlash

function cumulativeSlash(bytes32 subnetwork, address operator) external view returns (uint256)

Get a cumulative slash amount for an operator on a subnetwork.

Parameters

Name	Type	Description
subnetwork	bytes32	full identifier of the subnetwork (address of the network concatenated with the uint96 identifier)
operator	address	address of the operator

Returns

Name	Type	Description
	uint256	cumulative slash amount

cumulativeSlashAt

function cumulativeSlashAt(bytes32 subnetwork, address operator, uint48 timestamp, bytes hint) external view returns (uint256)

Get a cumulative slash amount for an operator on a subnetwork until a given timestamp (inclusively) using a hint.

Parameters

Name	Type	Description
subnetwork	bytes32	full identifier of the subnetwork (address of the network concatenated with the uint96 identifier)
operator	address	address of the operator
timestamp	uint48	time point to get the cumulative slash amount until (inclusively)
hint	bytes	hint for the checkpoint index

Returns

Name	Type	Description
	uint256	cumulative slash amount until the given timestamp (inclusively)

globalCumulativeSlash

function globalCumulativeSlash() external view returns (uint256)

Get a global cumulative slash amount.

Returns

Name	Type	Description
	uint256	cumulative slash amount

globalCumulativeSlashAt

function globalCumulativeSlashAt(uint48 timestamp, bytes hint) external view returns (uint256)

Get a global cumulative slash amount until a given timestamp (inclusively) using a hint.

Parameters

Name	Type	Description
timestamp	uint48	time point to get the cumulative slash amount until (inclusively)
hint	bytes	hint for the checkpoint index

Returns

Name	Type	Description
	uint256	cumulative slash amount until the given timestamp (inclusively)

latestSlashedCaptureTimestamp

function latestSlashedCaptureTimestamp(bytes32 subnetwork, address operator) external view returns (uint48 value)

Get the latest capture timestamp that was slashed on a subnetwork.

Parameters

Name	Type	Description
subnetwork	bytes32	full identifier of the subnetwork (address of the network concatenated with the uint96 identifier)
operator	address	address of the operator

Returns

Name	Type	Description
	uint48	latest capture timestamp that was slashed

slash

function slash(bytes32 subnetwork, address operator, uint256 amount, uint48 captureTimestamp, bytes hints) external nonpayable returns (uint256 slashedAmount)

Perform a slash using a subnetwork for a particular operator by a given amount using hints.

Only a network middleware can call this function.

Parameters

Name	Type	Description
subnetwork	bytes32	full identifier of the subnetwork (address of the network concatenated with the uint96 identifier)
operator	address	address of the operator
amount	uint256	maximum amount of the collateral to be slashed
captureTimestamp	uint48	time point when the stake was captured
hints	bytes	hints for checkpoints' indexes

Returns

Name	Type	Description
slashedAmount	uint256	amount of the collateral slashed

slashableStake

function slashableStake(bytes32 subnetwork, address operator, uint48 captureTimestamp, bytes hints) external view returns (uint256)

Get a slashable amount of a stake got at a given capture timestamp using hints.

Parameters

Name	Type	Description
subnetwork	bytes32	full identifier of the subnetwork (address of the network concatenated with the uint96 identifier)
operator	address	address of the operator
captureTimestamp	uint48	time point to get the stake amount at
hints	bytes	hints for the checkpoints' indexes

Returns

Name	Type	Description
	uint256	slashable amount of the stake

staticDelegateCall

function staticDelegateCall(address target, bytes data) external nonpayable

Make a delegatecall from this contract to a given target contract with a particular data (always reverts with a return data).

It allows to use this contract's storage on-chain.

Parameters

Name	Type	Description
target	address	address of the contract to make a delegatecall to
data	bytes	data to make a delegatecall with

vault

function vault() external view returns (address)

Get the vault's address.

Returns

Name	Type	Description
	address	address of the vault

Events

Initialized

event Initialized(uint64 version)

Triggered when the contract has been initialized or reinitialized.

Parameters

Name	Type	Description
version	uint64

Slash

event Slash(bytes32 indexed subnetwork, address indexed operator, uint256 slashedAmount, uint48 captureTimestamp)

Emitted when a slash is performed.

Parameters

Name	Type	Description
subnetwork indexed	bytes32	subnetwork that requested the slash
operator indexed	address	operator that is slashed
slashedAmount	uint256	amount of the collateral slashed
captureTimestamp	uint48	time point when the stake was captured

Structs

SlashableStakeHints

struct SlashableStakeHints {
    bytes activeStakeHint;
    bytes stakeHints;
    bytes globalCumulativeSlashFromHint;
    bytes cumulativeSlashFromHint;
}

Hints for a slashable stake.

Parameters

Name	Type	Description
activeStakeHint	bytes	hint for the active stake checkpoint
stakeHints	bytes	hints for the stake checkpoints
globalCumulativeSlashFromHint	bytes	hint for the global cumulative slash amount at a capture timestamp
cumulativeSlashFromHint	bytes	hint for the cumulative slash amount at a capture timestamp

SlashHints

struct SlashHints {
    bytes slashableStakeHints;
}

Hints for a slash.

Parameters

Name	Type	Description
slashableStakeHints	bytes	hints for the slashable stake checkpoints