Overview | Disclaimer | Tests | Installation | Usage | Examples | Aknowledgements | License
Sigmund provides a CLI that allows users to collect function selectors from any EVM network and for any smart-contract, verified or not. It does so by searching for specific bytecode patterns which allows for efficient and EVM native interactions without the need for any APIs or ABI. Additionally, it provides the possibility to decode those function selectors and get the function signatures if they are known.
It's purpose is to be used as a tool for recon, analysis, general research and experimentation.
This library is in early development stages and subject to potential breaking changes. Backward compatibility is not guaranteed and the package is intentionally not published on crates.io until and if there's an alpha release in the future.
Contributions are welcome. Users are encouraged to submit pull requests, fork, or alter the code in accordance with the terms outlined in the LICENSE.
It's suggested that the signatures argument is used deliberately to not overload the external function signature API.
To run the implemented tests, execute the following command at the root of the repository:
cargo test
You can currently build from source by running the following command in the root of the repository:
cargo build --release
A tool for quickly collecting function selectors and decoding signatures from on-chain EVM bytecode
Usage: sigmund [OPTIONS] <--address <ADDRESS>|--file <FILE>>
Options:
-o, --output <OUTPUT> Path to export the signatures as a JSON file
--signatures Collect all known function signatures from the contract's selectors
--address <ADDRESS> The address of the EVM contract
-f, --file <FILE> Path to a local file containing the contract's bytecode
--deep Collect all four-byte pushes (fn, err, ...), including non-selectors
--all-matches Return all available signature matches for each selector
--rpc-url <RPC_URL> To use your own Node or collect bytecode from a different network, provide the relevant RPC URL [default: https://ethereum-rpc.publicnode.com]
-h, --help Print help
-V, --version Print version
# Get function selectors for an unverified contract on Mainnet
sigmund --address 0x0000130d512ca69ca38add5b9ab2f9deff95c882
# {"8da5cb5b", "3aeebedb", "c6723cc9", ...}
# Get function selectors from a local file containing the bytecode
sigmund --file bytecode.txt
# {"7b6e0f15", "3aeebedb", "b603cd80", ...}
# Get function signatures for an unverified contract on Mainnet
# Similarly, for a local file just point to that file's path
sigmund --signatures --address 0x0000130d512ca69ca38add5b9ab2f9deff95c882
# [8da5cb5b]: owner()
# [c86283c8]: withdrawTo(uint256,address)
# To generate a `json` output, you can use any combination
# as long as the input <--file | --address> is provided
sigmund --file bytecode.txt --output example.json
# { "selectors": Vec<String> , "signatures": <Vec<Signatures>) }
# You can use `Sigmund` in any EVM network
# by setting the --rpc-url to the relevant provider
sigmund --rpc-url <rpc-provider> <--signatures?> <--file <path>| --address <address>>
The underlying function signature API is Etherface.
This library is released under the terms of the Mozilla Public License version 2.0. See LICENSE.
11 Nov 24, 2022
148 Dec 31, 2022
14 Dec 24, 2022
11 Dec 15, 2022
166 Dec 29, 2022
252 Dec 21, 2022
7 Jan 9, 2023
![[ZenGo X]](https://avatars.githubusercontent.com/u/40664522?v=4&s=40)
61 Dec 28, 2022
13 Mar 14, 2021
50 Dec 25, 2022
11 Dec 22, 2022
3 Nov 18, 2022
18 Jul 8, 2024
16 Nov 29, 2022
230 Apr 25, 2023
15 Oct 25, 2022
10 Mar 11, 2024
3 Nov 4, 2022