Skip to main content

get in touch with Consensys Diligence
[ 🌐 📩 ]

Legions

License: MIT CircleCI Code style: black PyPI

Ethereum Node Security Toolkit

Handy toolkit for (security) researchers poking around Ethereum nodes and contracts, now with a slick command-line interface, with auto complete commands and history.

Other functionalities:

  • Conversions (toWei, fromWei, keccak, etc)
  • Query for balance, code, storage of smart contracts, ecrecover
  • etc

This package is extremely beta

Installation

Require Python 3.6.

clone https://github.com/shayanb/Legions
cd Legions
pip install .

or

pip install legions

Usage

If installed locally:

python legions/main.py

or if installed globally:

legions

Functions

demo

Command [Subcommand] Description
sethost Setup the Web3 connection (RPC, IPC, HTTP) (default to infura mainnet)
getnodeinfo Information about the connected node (run setnode before this)
conversions Conversions possible to do with Web3
fromWei Converts the input to ether (to currency default to ether)
toWei Converts the input to Wei (from currency default to ether)
keccak keccak hash of the input
toBytes Converts the input to hex representation of its Bytes
toChecksumAddress Converts the input to Checksum Address
toHex Converts the input text to Hex
fromWei Converts the input to ether (or specified currency)
query Query Blockchain (Storage, balance, etc)
balance Get Balance of an account
block Get block details by block number
code Get code of the smart contract at address
ecrecover Get address associated with the signature (ecrecover) BUGGY
storage Read the storage of a contract (count default = 10)
command Manual RPC method with args
investigate Investigate further in the node (e.g. check if accounts are unlocked, etc)
accounts Investigate accounts (e.g. check if accounts are unlocked, etc)
admin Investigate accounts (e.g. functionalities under the admin_ namespace)
sign Investigate signature functionalities
version Print Versions (If connected to a node it will print the host version too)

Acknowledgement

TODO:

  • Able to connect to ws / http / https / IPC
  • Fix Verbose Status bar (It does not change from OFF)
  • Print Accounts in getnodeinfo in a pretty format (One per line)
  • A way to reinitiate w3 (web3) by setting it to new host (right now it works for sethost but getnodeinfo still uses the first initiated w3)
  • add way more functionalities
  • chains.json depending on the execution path might not be found. fix it.
  • inline TODOs (tons)

Metadata

Release files for legions 0.7.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for legions 0.7.2
File Size Uploaded Provenance Actions
legions-0.7.2.tar.gz 15.5 kB Without provenance Details for legions-0.7.2.tar.gz

Release files / legions-0.7.2.tar.gz

Download URL legions-0.7.2.tar.gz
Size 15.5 kB
Tags Source
SHA-256 checksum
How to use checksums
a49d46b9b85c96b5d19b2bc3fa82dc0cc27d5349e741d18b108b731f108a2c70
BLAKE2b-256 checksum
How to use checksums
6aab46784b806ec0afa4e4de250f04034b0cee26caddd902b4c3bd0868d80cf4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/45.1.0 requests-toolbelt/0.8.0 tqdm/4.42.0 CPython/3.8.1

Security for legions 0.7.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page