Network Middleware

Architecture Overview

Subnetwork Comparison

Feature	Validator Subnetwork	Gateway Subnetwork
Duties	Basic block proposal	Preconfirmation tasks
Rewards	Shared with Gateway Subnetwork	Shared with Validator Subnetwork
Slashing Conditions	Accepting blocks from non-opt in relays	Reneging on preconfirmation commitments

Symbiotic Integration

The SymbioticNetworkMiddleware implements several key Symbiotic Primitive through Symbiotic Middleware SDK:

KeyManagerBLS - Manages storage and validation of operator keys using BLS signatures
EpochCapture - A middleware extension that captures timestamps based on epochs
EqualStakePower - Implementation of a 1:1 stake to voting power conversion
OzAccessManaged - A middleware extension that integrates OpenZeppelin’s AccessManaged for access control
BaseOperators - Base contract for managing operator registration, keys, and vault relationships
Subnetworks - Contract for managing subnetworks that can be registered and controlled

1. Validator Subnetwork Registration

2. Gateway Subnetwork Registration

3. Both Subnetworks via Self-Delegation (Full Participation)

Functions

Subnetwork Operations

Initialization Functions

`initialize`

function initialize(
    address network,
    uint48 slashingWindow,
    address vaultRegistry,
    address operatorRegistry,
    address operatorNetOptIn,
    address reader,
    address owner,
    address proposerRegistry
) external initializer

Initializes the contract with required parameters and sets up subnetworks. Parameters:

Name	Type	Description
`network`	`address`	The address of the network
`slashingWindow`	`uint48`	The duration of the slashing window
`vaultRegistry`	`address`	The address of the vault registry
`operatorRegistry`	`address`	The address of the operator registry
`operatorNetOptIn`	`address`	The address of the operator network opt-in service
`reader`	`address`	The address of the reader contract used for delegatecall
`owner`	`address`	The address of the contract owner
`_proposerRegistry`	`address`	The address of the proposer registry contract

Operator Management

`registerOperator`

function registerOperator(
    bytes memory key,
    address vault,
    bytes memory signature,
    uint96 subnetwork
) external

Registers a new operator with the specified key, vault, and subnetwork. Parameters:

Name	Type	Description
`key`	`bytes`	The BLS public key of the operator
`vault`	`address`	The vault address associated with the operator
`signature`	`bytes`	The signature proving ownership of the BLS key
`subnetwork`	`uint96`	The subnetwork identifier (VALIDATOR_SUBNETWORK or GATEWAY_SUBNETWORK)

`unregisterOperator`

function unregisterOperator() external

Unregisters the calling operator from the system.

`unpauseOperator`

function unpauseOperator() external

Unpauses the calling operator’s operations.

Vault Management Functions

`registerOperatorVault`

function registerOperatorVault(address vault) external

Registers a vault for the calling operator. Parameters:

Name	Type	Description
`vault`	`address`	The address of the vault to register

`unregisterOperatorVault`

function unregisterOperatorVault(address vault) external

Unregisters a vault for the calling operator. Parameters:

Name	Type	Description
`vault`	`address`	The address of the vault to unregister

`pauseOperatorVault`

function pauseOperatorVault(address vault) external

Pauses the operations of a vault for the calling operator. Parameters:

Name	Type	Description
`vault`	`address`	The address of the vault to pause

`unpauseOperatorVault`

function unpauseOperatorVault(address vault) external

Unpauses the operations of a vault for the calling operator. Parameters:

Name	Type	Description
`vault`	`address`	The address of the vault to unpause

Slashing Functions

`slash`

function slash(SlashParams calldata params) external

struct SlashParams {
        uint48 timestamp;
        bytes key;
        uint256 amount;
        bytes32 subnetwork;
        bytes[] slashHints;
    }

Slashes an operator’s stake across their active vaults. The slashing amount is distributed proportionally across the operator’s vaults based on their relative stake amounts. The function:

Verifies the operator and their vaults are active at the given timestamp
Calculates proportional slash amounts for each vault based on the would-be slashed operator stake percentage
Executes slashing on each vault, with any dust amount from rounding going to the final vault

For example, if an operator has:

Vault A with 1000 ETH staked (50%)
Vault B with 800 ETH staked (40%)
Vault C with 200 ETH staked (10%)

And a slash amount of 101 ETH is imposed:

Vault A would be slashed 50.5 ETH (50% of 101)
Vault B would be slashed 40.4 ETH (40% of 101)
Vault C would be slashed 10.1 ETH (10% of 101)

Due to integer division and rounding, the actual amounts would be:

Vault A: 50 ETH
Vault B: 40 ETH
Vault C: 11 ETH (10 ETH + 1 ETH remaining from rounding)

If the slash amount was 51 ETH instead, the extra 1 ETH “dust” from rounding would go to the final vault (Vault C), making its slash 6 ETH. Parameters:

Name	Type	Description
`params`	`SlashParams`	The parameters for the slash operation including key, timestamp, subnetwork, amount and hints

Query Functions

`activeOperatorsAt`

function activeOperatorsAt(uint48 timestamp) external view returns (address[] memory)

Retrieves the list of active operators at a specific timestamp. Parameters:

Name	Type	Description
`timestamp`	`uint48`	The timestamp to query active operators

`isOperatorRegistered`

function isOperatorRegistered(address operator) external view returns (bool)

Checks if an operator is registered in the system. Parameters:

Name	Type	Description
`operator`	`address`	The address of the operator to check

`activeOperatorVaults`

function isOperatorRegistered(address operator) external view returns (bool)

Gets the list of active vaults for a specific operator.

Name	Type	Description
`operator`	`address`	The address of the operator to check

`activeOperatorVaultsAt`

function activeOperatorVaultsAt(uint48 timestamp, address operator) external view returns (address[] memory)

Gets the list of active vaults for a specific operator at a specific timestamp. Parameters:

Name	Type	Description
`timestamp`	`uint48`	The timestamp to query active vaults
`operator`	`address`	The address of the operator to check

`activeVaults`

function activeVaults() external view returns (address[] memory

Gets the list of all active vaults.

`activeVaultsAt`

function activeVaultsAt(uint48 timestamp) external view returns (address[] memory)

Gets the list of active vaults at a specific timestamp. Parameters:

Name	Type	Description
`timestamp`	`uint48`	The timestamp to query active vaults

`getOperatorPower`

function getOperatorPower(
    address operator,
    address vault,
    uint96 subnetwork
) external view returns (uint256)

Gets the power of an operator for a specific vault and subnetwork. Parameters:

Name	Type	Description
`operator`	`address`	The address of the operator
`vault`	`address`	The address of the vault
`subnetwork`	`uint96`	The subnetwork identifier

getOperatorPowerAt

function getOperatorPowerAt(
    uint48 timestamp,
    address operator,
    address vault,
    uint96 subnetwork
) external view returns (uint256)

Gets the power of an operator for a specific vault and subnetwork at a specific timestamp. Parameters:

Name	Type	Description
`timestamp`	`uint48`	The timestamp to query operator power
`operator`	`address`	The address of the operator
`vault`	`address`	The address of the vault
`subnetwork`	`uint96`	The subnetwork identifier

totalPower

function totalPower() external view returns (uint256)

Gets the total power of all operators in the system.

`getOperatorCollaterals`

function getOperatorCollaterals(address operator) external view returns (
    address[] memory vaults,
    address[] memory collateralTokens,
    uint256[] memory stakedAmounts
)

Retrieves the collateral tokens and their staked quantities for a given operator’s active vaults. Parameters:

Name	Type	Description
`operator`	`address`	Address of the operator whose collateral stakes will be queried

Get Started

Build

Learn

Network Information

Network Middleware

Architecture Overview

Subnetwork Comparison

Symbiotic Integration

1. Validator Subnetwork Registration

2. Gateway Subnetwork Registration

3. Both Subnetworks via Self-Delegation (Full Participation)

Functions

Subnetwork Operations

Initialization Functions

`initialize`

Operator Management

`registerOperator`

`unregisterOperator`

`unpauseOperator`

Vault Management Functions

`registerOperatorVault`

`unregisterOperatorVault`

`pauseOperatorVault`

`unpauseOperatorVault`

Slashing Functions

`slash`

Query Functions

`activeOperatorsAt`

`isOperatorRegistered`

`activeOperatorVaults`

`activeOperatorVaultsAt`

`activeVaults`

`activeVaultsAt`

`getOperatorPower`

getOperatorPowerAt

totalPower

`getOperatorCollaterals`

Get Started

Build

Learn

Network Information

​Architecture Overview

​Subnetwork Comparison

​Symbiotic Integration

​1. Validator Subnetwork Registration

​2. Gateway Subnetwork Registration

​3. Both Subnetworks via Self-Delegation (Full Participation)

​Functions

​Subnetwork Operations

​Initialization Functions

​initialize

​Operator Management

​registerOperator

​unregisterOperator

​unpauseOperator

​Vault Management Functions

​registerOperatorVault

​unregisterOperatorVault

​pauseOperatorVault

​unpauseOperatorVault

​Slashing Functions

​slash

​Query Functions

​activeOperatorsAt

​isOperatorRegistered

​activeOperatorVaults

​activeOperatorVaultsAt

​activeVaults

​activeVaultsAt

​getOperatorPower

​getOperatorPowerAt

​totalPower

​getOperatorCollaterals

Architecture Overview

Subnetwork Comparison

Symbiotic Integration

1. Validator Subnetwork Registration

2. Gateway Subnetwork Registration

3. Both Subnetworks via Self-Delegation (Full Participation)

Functions

Subnetwork Operations

Initialization Functions

`initialize`

Operator Management

`registerOperator`

`unregisterOperator`

`unpauseOperator`

Vault Management Functions

`registerOperatorVault`

`unregisterOperatorVault`

`pauseOperatorVault`

`unpauseOperatorVault`

Slashing Functions

`slash`

Query Functions

`activeOperatorsAt`

`isOperatorRegistered`

`activeOperatorVaults`

`activeOperatorVaultsAt`

`activeVaults`

`activeVaultsAt`

`getOperatorPower`

getOperatorPowerAt

totalPower

`getOperatorCollaterals`