SSV Scanner

Important dependencies:

This repository contains The ssv scanner library and CLI. It is used to retrieve events data from the SSV network contract. The tool is used for retrieving the latest cluster snapshot or owner nonce from the blockchain, which are required as inputs for SSV tooling and smart contract transactions.

Running from the CLI

Installation

This installation requires NodeJS on your machine. You can download it here.

Once you have installed NodeJS, follow these instructions to prepare the project:

git clone https://github.com/ssvlabs/ssv-scanner.git
cd ssv-scanner
npm i yarn -g
yarn
yarn cli --help

Running as a CLI from the repository

Help

Help on available actions:

yarn cli --help

Example cluster scanner

Input parameters:

• node-url (n) = The ETH1 node url
• network (nw) = The network (mainnet, hoodi)
• owner-address (oa) = Cluster owner address
• operator-ids (oids) = Comma separated operator ids list

Example of running cluster scanner in the CLI:

yarn cli cluster -n .... -nw mainnet -oa ..... -oids 1,2,3,4

Output: Latest cluster data (serialized).

Example nonce scanner

Input parameters:

• node-url (n) = The ETH1 node url
• network (nw) = The network (mainnet, hoodi)
• owner-address (oa) = Cluster owner address

Example of running nonce scanner in the CLI:

yarn cli nonce -n https://the_eth_node -nw network -oa 0xeth_address

**Output:**  Current owner nonce.

### Example operator scanner

**Input parameters:**

- node-url (n) = The ETH1 node url
- network (nw) = The network (mainnet, hoodi, hoodi_stage, local_testnet)
- owner-address (oa) = Owner address
- output-path (o) = A full output path (not mandatory, default output path is .../ssv-scanner/dist/tsc/src/data/)

Example of running cluster scanner in the CLI:
```bash

yarn cli operator -n https://the_eth_node -nw network -oa 0xeth_address -oids 1,2,3....

Output: File output path (json with all pubkeys from the net)

Integration in your projects

Node Project

To run an example of a NodeJS project containing all the code snippets to build the share and transaction payload, simply follow these instructions!

cd examples
yarn install

To run a JavaScript example:

yarn start:js

To run a Typescript example:

yarn start

Development

Run the CLI as a TypeScript executable:

yarn dev:cli ...

Run the CLI as a JavaScript compiled executable:

yarn cli ...

Lint

yarn lint

Building

Build TypeScript into JavaScript

yarn build

Build for NodeJs using esbuild

yarn esbuild

Build everything

yarn build-all

TODO

License

The ssv-api is licensed under the GNU General Public License v3.0, also included in our repository in the LICENSE file.