Skip to content

feat: add Stader validator registry support #465

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
PedroCM96 wants to merge 10 commits into
base: main
Choose a base branch
from
Open

feat: add Stader validator registry support #465

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
56a85a1
feat: add Stader validator registry support
PedroCM96 May 7, 2026
5304f6c
Merge remote-tracking branch 'origin/main' into pr-465
JasonVranek May 12, 2026
f984dae
reformat and fix broken tests
JasonVranek May 12, 2026
f5b4bec
Minor cleanups
JasonVranek May 12, 2026
d17a3a6
Merge branch 'main' into support-stader
PedroCM96 May 27, 2026
2d527f9
Merge branch 'main' into support-stader
PedroCM96 Jun 4, 2026
11856cf
Merge remote-tracking branch 'origin/main' into support-stader
JasonVranek Jul 30, 2026
242780b
fix(mux): use wire::safe_read_http_response after its move from config
JasonVranek Jul 30, 2026
b69219a
Update config.example.toml
JasonVranek Jul 30, 2026
995544f
chore: re-trigger PR sync
JasonVranek Jul 31, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 5 additions & 1 deletion config.example.toml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -142,10 +142,13 @@ validator_pubkeys = [
# - Registry: details of a registry to load keys from. Supported registries:
# - Lido: NodeOperatorsRegistry
# - SSV: SSV API
# You can toggle the 'enable_refreshing' flag to let this registry periodically query Lido or SSV and refresh the list of validator pubkeys belonging to the corresponding operator.
# - Stader: Stader Permissioned/Permissionless NodePool (mainnet only). Requires the PBS `rpc_url` to be set (like Lido),
# and a `stader_pool` ("permissioned" or "permissionless") in the mux loader.
# You can toggle the 'enable_refreshing' flag to let this registry periodically query Lido, SSV, or Stader and refresh the list of validator pubkeys belonging to the corresponding operator.
# Each of these registry entries must be unique:
# - There can only be one Lido entry with a given Lido node operator ID.
# - There can only be one SSV entry with a given SSV node operator ID.
# - There can only be one Stader entry with a given pool and node operator ID.
# - A Lido entry can have the same node operator ID as an SSV entry if they happen to coincide; they're treated as separate entities.
#
# Example JSON list:
Expand All @@ -158,6 +161,7 @@ loader = "./tests/data/mux_keys.example.json"
# loader = { url = "http://localhost:8000/keys" }
# loader = { registry = "lido", node_operator_id = 8, lido_module_id = 1, enable_refreshing = false }
# loader = { registry = "ssv", node_operator_id = 8, enable_refreshing = false }
# loader = { registry = "stader", node_operator_id = 8, stader_pool = "permissionless", enable_refreshing = false }
late_in_slot_time_ms = 1500
timeout_get_header_ms = 900
# For each mux, one or more [[mux.relays]] can be defined, which will be used for the matching validator pubkeys
Expand Down
244 changes: 244 additions & 0 deletions crates/common/src/abi/StaderRegistry.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,244 @@
[
{
"constant": true,
"inputs": [
{
"name": "_operatorId",
"type": "uint256"
}
],
"name": "operatorStructById",
"outputs": [
{
"name": "active",
"type": "bool"
},
{
"name": "optedForSocializingPool",
"type": "bool"
},
{
"name": "operatorName",
"type": "string"
},
{
"name": "operatorRewardAddress",
"type": "address"
},
{
"name": "operatorAddress",
"type": "address"
}
],
"payable": false,
"stateMutability": "view",
"type": "function"
},
{
"constant": true,
"inputs": [
{
"name": "_operator",
"type": "address"
}
],
"name": "operatorIDByAddress",
"outputs": [
{
"name": "",
"type": "uint256"
}
],
"payable": false,
"stateMutability": "view",
"type": "function"
},
{
"constant": true,
"inputs": [
{
"name": "_operatorId",
"type": "uint256"
}
],
"name": "getOperatorTotalKeys",
"outputs": [
{
"name": "_totalKeys",
"type": "uint256"
}
],
"payable": false,
"stateMutability": "view",
"type": "function"
},
{
"constant": true,
"inputs": [
{
"name": "_operator",
"type": "address"
},
{
"name": "_pageNumber",
"type": "uint256"
},
{
"name": "_pageSize",
"type": "uint256"
}
],
"name": "getValidatorsByOperator",
"outputs": [
{
"name": "",
"type": "tuple[]",
"components": [
{
"name": "status",
"type": "uint8"
},
{
"name": "pubkey",
"type": "bytes"
},
{
"name": "preDepositSignature",
"type": "bytes"
},
{
"name": "depositSignature",
"type": "bytes"
},
{
"name": "withdrawVaultAddress",
"type": "address"
},
{
"name": "operatorId",
"type": "uint256"
},
{
"name": "depositBlock",
"type": "uint256"
},
{
"name": "withdrawnBlock",
"type": "uint256"
}
]
}
],
"payable": false,
"stateMutability": "view",
"type": "function"
},
{
"constant": true,
"inputs": [
{
"name": "_operatorId",
"type": "uint256"
},
{
"name": "_index",
"type": "uint256"
}
],
"name": "validatorIdsByOperatorId",
"outputs": [
{
"name": "",
"type": "uint256"
}
],
"payable": false,
"stateMutability": "view",
"type": "function"
},
{
"constant": true,
"inputs": [
{
"name": "_validatorId",
"type": "uint256"
}
],
"name": "validatorRegistry",
"outputs": [
{
"name": "status",
"type": "uint8"
},
{
"name": "pubkey",
"type": "bytes"
},
{
"name": "preDepositSignature",
"type": "bytes"
},
{
"name": "depositSignature",
"type": "bytes"
},
{
"name": "withdrawVaultAddress",
"type": "address"
},
{
"name": "operatorId",
"type": "uint256"
},
{
"name": "depositBlock",
"type": "uint256"
},
{
"name": "withdrawnBlock",
"type": "uint256"
}
],
"payable": false,
"stateMutability": "view",
"type": "function"
},
{
"constant": true,
"inputs": [
{
"name": "_operatorId",
"type": "uint256"
}
],
"name": "getOperatorRewardAddress",
"outputs": [
{
"name": "",
"type": "address"
}
],
"payable": false,
"stateMutability": "view",
"type": "function"
},
{
"constant": true,
"inputs": [
{
"name": "_operAddr",
"type": "address"
}
],
"name": "isExistingOperator",
"outputs": [
{
"name": "",
"type": "bool"
}
],
"payable": false,
"stateMutability": "view",
"type": "function"
}
]
Loading
Loading