Lido-vsmelov 0.2.1

Network helpers for Lido

Lido

This library consolidates various functions to efficiently load network data for Lido, validate node operator keys and find key duplicates.

Installation

This library is available on PyPi:

pip install lido

Main Features

Multicall Function Calls

Instead of making network requests one-by-one, this library combines many requests into one RPC call. It uses banteg/multicall.py, a Python wrapper for makerdao/multicall.

Multiprocess Signature Validations

When using validate_keys_multi(), this library spreads processing of key signature validations to all system cores.

Automatic Testnet / Mainnet Switching

Depending on the supplied WEB3_PROVIDER_URI, a correct network will be used. Even an appropriate ABI will be loaded for the chain automatically.

Helpers Provided

• get_operators_data() -> operator_data - load node operator data

• get_operators_keys(operator_data) -> operator_data - fetches and adds keys to operator_data

• validate_keys_mono(operator_data) -> operator_data - validates keys in single process and adds validation results to operator_data

• validate_keys_multi(operator_data) -> operator_data - validates keys in multiple processes and adds validation results to operator_data, requires a main function (see example)

• validate_key([[key,depositSignature]]) -> Boolean - low-level validation function

• find_duplicates(operator_data) -> operator_data - finds duplicate keys and adds results to operator_data

• fetch_and_validate() -> operator_data - combines fetching operator data and running all validations on it - useful when you would be running all validations on data anyway

• get_stats() -> stats - fetches various constants from Lido contract, but you can even pass a list of functions to fetch eg get_stats([isStopped])

You can mix and match these functions, but make sure to use get_operators_data() first.

Notes

1. Signature validation will be skipped if its results are already present in operator_data. This way you can safely load validation results from cache and add ["valid_signature"] = Boolean to already checked keys.

How to Use

Use a RPC provider url as an environment variable and run your script:

WEB3_PROVIDER_URI=https://eth-mainnet.provider.xx example.py

See example.py for a complete example, make sure to use a main function and a script entry point check when using validate_keys_multi() or fetch_and_validate().

Options

If you are testing a new deployment of Lido, these environment variables can override addresses and ABIs:

• LIDO_ADDRESS
• REGISTRY_ADDRESS
• LIDO_ABI (the file-path to the contract's ABI)
• REGISTRY_ABI (the file-path to the contract's ABI)

WEB3_PROVIDER_URI=https://eth-mainnet.provider.xx LIDO_ADDRESS=XXX REGISTRY_ADDRESS=XXX LIDO_ABI=xxx.json REGISTRY_ABI=xxx.json example.py