Halmos
Install | Getting Started | Examples | FAQ | Chat | awesome-halmos
Halmos is a symbolic testing tool for EVM smart contracts. A Solidity/Foundry frontend is currently offered by default, with plans to provide support for other languages, such as Vyper and Huff, in the future.
You can read more in our post: "Symbolic testing with Halmos: Leveraging existing tests for formal verification."
Join the Halmos Telegram Group for any inquiries or further discussions.
Installation
⭐ Using uv (recommended for most users)
# install uv if you don't have it already
curl -LsSf https://astral.sh/uv/install.sh | sh
# install the latest version of halmos for the current user and add it to PATH
uv tool install --python 3.12 halmos
# or, install the development version from the repository
# uv tool install --python 3.12 git+https://github.com/a16z/halmos
# after installing, you can update halmos to the latest version with:
uv tool upgrade halmos
Using docker
You can download a pre-built Docker image that contains python, halmos, its dependencies, foundry, solvers, etc.:
docker pull ghcr.io/a16z/halmos:latest
Using pip (for advanced users)
Note: this is not recommended because of the extra work required to manage the python version and the virtual environment. But if you know what you are doing, and need the extra control, you can do it like this:
# make sure you have a suitable python version installed, e.g.:
python3.12 --version
# create and activate a virtual environment with an explicit python version
python3.12 -m venv .venv && source .venv/bin/activate
# install the latest version of halmos
pip install halmos
# or, install the development version from the repository
pip install git+https://github.com/a16z/halmos
Usage
cd /path/to/src
halmos
For more details:
halmos --help
Alternatively, you can run the latest halmos Docker image available at ghcr.io/a16z/halmos:
cd /path/to/src
# mount '.' under /workspace in the container
docker run -v .:/workspace ghcr.io/a16z/halmos:latest
Getting Started
Refer to the getting started guide and the examples directory.
Contributing / Developing
Refer to the contributing guidelines, and explore the list of issues labeled "good first issue" or "help wanted."
Disclaimer
These smart contracts and code are being provided as is. No guarantee, representation or warranty is being made, express or implied, as to the safety or correctness of the user interface or the smart contracts and code. They have not been audited and as such there can be no assurance they will work as intended, and users may experience delays, failures, errors, omissions or loss of transmitted information. THE SMART CONTRACTS AND CODE CONTAINED HEREIN ARE FURNISHED AS IS, WHERE IS, WITH ALL FAULTS AND WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING ANY WARRANTY OF MERCHANTABILITY, NON-INFRINGEMENT OR FITNESS FOR ANY PARTICULAR PURPOSE. Further, use of any of these smart contracts and code may be restricted or prohibited under applicable law, including securities laws, and it is therefore strongly advised for you to contact a reputable attorney in any jurisdiction where these smart contracts and code may be accessible for any questions or concerns with respect thereto. Further, no information provided in this repo should be construed as investment advice or legal advice for any particular facts or circumstances, and is not meant to replace competent counsel. a16z is not liable for any use of the foregoing, and users should proceed with caution and use at their own risk. See a16z.com/disclosures for more info.
3 maintainers
Release files for halmos 0.3.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| halmos-0.3.3.tar.gz | 328.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| halmos-0.3.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 519.2 kB
Release files / halmos-0.3.3.tar.gz
| Download URL | halmos-0.3.3.tar.gz |
|---|---|
| Size | 328.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2830f421fecea413919c52f499597d796d4d49f5a0f3f0741c2a8399e2bd6abf
|
|
BLAKE2b-256 checksum How to use checksums |
01c4a32e61e65876910c15e77d44c48f44e5c67c7350e3720d5aa3ad8d23c575
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 31, 2025.
Transparency logRelease files / halmos-0.3.3-py3-none-any.whl
| Download URL | halmos-0.3.3-py3-none-any.whl |
|---|---|
| Size | 190.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3967291bdd4aaac96a4c42dd18bf25bd76215acad53697d98f02b986ac8d3f67
|
|
BLAKE2b-256 checksum How to use checksums |
228de4667d7271b93456f1af50234f8dd4e3e7fc7ee3f1b25d3a2e3f9e17d930
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 31, 2025.
Transparency log
