🦄
🦄
🦄
🦄
Docs v4
Search
⌃K
Comment on page

SSV Scanner CLI

The SSV Scanner CLI tool is a command-line interface that retrieves events data from the SSV network contract.

Installation

Prerequisites - this tool requires NodeJS installed on your machine.
1 git clone https://github.com/bloxapp/ssv-scanner.git
2 cd ssv-scanner
3 yarn

Commands

Command
Description
cluster
This command is used to retrieve the latest snapshot of a provided cluster from the SSV network contract.
nonce
This command is used to retrieve the validator registration nonce of a provided account from the SSV network contract.

cluster Arguments

You can use yarn cli cluster --help to see all arguments and their descriptions.
Argument
Type
Description
--node-url (-n)
string
ETH1 (execution client) node endpoint URL
--ssv-contract-address (-ca)
string
The SSV network contract address (reference)
--owner-address (-oa)
int
The cluster owner address (in the SSV contract)
--operator-ids (-oids)
string
Comma-separated list of operator IDs. The amount must be 3f+1 compatible.
Run
yarn cli cluster -n <ETH1_NODE_ENDPOINT_URL> -ca <SSV_CONTRACT_ADDRESS> -oa <CLUSTER_OWNER_ADDRESS> -oids <OPERATOR1_ID, OPERATOR2_ID, OPERATOR3_ID, OPERATOR4_ID>
Output
The cluster snapshot breakdown and the cluster object in transaction payload format.
Example:
Cluster snapshot:
┌─────────────────┬────────────────────────┐
│ (index) │ Values │
├─────────────────┼────────────────────────┤
│ validatorCount │ '1' │
│ networkFeeIndex │ '0' │
│ index │ '4647545440' │
│ active │ true │
│ balance │ '11000000000000000000' │
└─────────────────┴────────────────────────┘
{
"block": 9215770,
"cluster snapshot": {
"validatorCount": "1",
"networkFeeIndex": "0",
"index": "4647545440",
"active": true,
"balance": "11000000000000000000"
},
"cluster": [
"1",
"0",
"4647545440",
true,
"11000000000000000000"
]
}

nonce Arguments

You can use yarn cli nonce --help to see all arguments and their descriptions.
Argument
Type
Description
--node-url (-n)
string
ETH1 (execution client) node endpoint URL
--ssv-contract-address (-ca)
string
The SSV network contract address (reference)
--owner-address (-oa)
int
The account owner address (in the SSV contract)
Run
yarn cli nonce -n <ETH1_NODE_ENDPOINT_URL> -ca <SSV_CONTRACT_ADDRESS> -oa <ACCOUNT_OWNER_ADDRESS>
Output
The validator registration nonce of the provided owner (to be used in the next validator registration).
Example:
Next nonce: 2
Tools - Previous
SSV Scanner
Next - Smart Contracts
SSVNetwork
Last modified 5mo ago