Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dapphub/dapptools
Dapp, Seth, Hevm, and more
https://github.com/dapphub/dapptools
dapp ethereum evm nix solc tools
Last synced: 22 days ago
JSON representation
Dapp, Seth, Hevm, and more
- Host: GitHub
- URL: https://github.com/dapphub/dapptools
- Owner: dapphub
- Created: 2018-06-12T12:34:20.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2023-09-11T06:53:03.000Z (about 1 year ago)
- Last Synced: 2024-09-30T16:41:23.510Z (about 1 month ago)
- Topics: dapp, ethereum, evm, nix, solc, tools
- Language: Haskell
- Homepage: https://dapp.tools
- Size: 8.46 MB
- Stars: 2,091
- Watchers: 51
- Forks: 325
- Open Issues: 171
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- my-awesome - dapphub/dapptools - 09 star:2.1k fork:0.3k Dapp, Seth, Hevm, and more (Haskell)
- awesome-solidity - dapphub/dapptools - Command-line-friendly tools for blockchain development. (Tools)
- awesome-solidity - dapphub/dapptools - Command-line-friendly tools for blockchain development. (Tools)
- awesome-solidity - dapphub/dapptools - Command-line-friendly tools for blockchain development. (Tools)
- awesome-dapptools - DappTools
- awesome-hacking-lists - dapphub/dapptools - Dapp, Seth, Hevm, and more (Haskell)
- awesome-smart-contract-development - DappTools
- best-of-crypto - GitHub - 39% open · ⏱️ 20.07.2023): (Others)
README
# Dapp tools by DappHub [](https://dapphub.chat)
Hello!
`dapptools` is a suite of Ethereum focused CLI tools following the Unix design philosophy,
favoring composability, configurability and extensibility.
This repository contains the source code for several programs
hand-crafted and maintained by DappHub, along with dependency management, courtesy of Nix.
- [dapp](./src/dapp) - All you need Ethereum development tool. Build, test, fuzz, formally verify, debug & deploy solidity contracts.
- [seth](./src/seth) - Ethereum CLI. Query contracts, send transactions, follow logs, slice & dice data.
- [hevm](./src/hevm) - Testing oriented EVM implementation. Debug, fuzz, or symbolically execute code against local or mainnet state.
- [ethsign](./src/ethsign) - Sign Ethereum transactions from a local keystore or hardware wallet.
## Development Status
dapptools is currently in a stage of clandestine development where support for the casual user may
be deprived. The software can now be considered free as in free puppy. Users seeking guidance can
explore using foundry as an alternative
## Installation
Install Nix if you haven't already ([instructions](https://nixos.org/download.html)). Then install dapptools:
### With flakes
```
nix profile install github:dapphub/dapptools#{dapp,ethsign,hevm,seth}
```
Nix will offer to use the dapptools binary cache, which will speed up installs,
but requires you to trust both us and the Cachix infrastructure.
### Legacy
```
curl https://dapp.tools/install | sh
```
This configures the dapphub binary cache and installs the `dapp`, `solc`, `seth` and `hevm` executables.
**NOTE:** Arm support in the GHC haskell compiler is still fairly bleeding edge, until this
situation stabilises, users of M1 macs must run dapptools (and the installer!) under rosetta 2 (i.e.
as an emulated x86 program). Make sure `/etc/nix/nix.conf` contains `system = x86_64-darwin`.
You can also install an individual tool with:
```sh
nix-env -iA -f $(curl -sS https://api.github.com/repos/dapphub/dapptools/releases/latest | jq -r .tarball_url)
```
If you instead want to build from `master`, change the url to `https://github.com/dapphub/dapptools/archive/master.tar.gz`.
### Prebuilt hevm binary
Static binaries for linux and macos of hevm are available for each release at https://github.com/dapphub/dapptools/releases.
Most functionality is available out of the box, but for symbolic execution you will need
[`solc`](https://github.com/ethereum/solidity) and ([`z3`](https://github.com/Z3Prover/z3/) or [`cvc4`](https://github.com/CVC4/CVC4) (or both)).
## Getting started
For more information about the tools, consult the individual README pages:
- [seth](./src/seth/README.md)
- [dapp](./src/dapp/README.md)
- [hevm](./src/hevm/README.md)
- [ethsign](./src/ethsign/README.md)
or use the `--help` flag for any tool.
We're also happy to answer any questions at https://dapphub.chat/.
## Examples
Deploy a 'Hello World' contract and call it:
```sh
export ETH_RPC_URL=https://mainnet.infura.io/v3/$YOUR_API_KEY
export ETH_FROM=$YOUR_ADDRESS
echo 'contract Hello { function hi() public pure returns(string memory) {return "Hello, World!";}}' | solc --bin -o . --overwrite -
HELLO=$(seth send --create $( daisrc.json && \
hevm symbolic --address 0x6b175474e89094c44da98b954eedeac495271d0f --rpc $ETH_RPC_URL --debug --sig "transfer(address,uint256)" --json-file daisrc.json
```
## Contributing
Contributions are always welcome! You may be interested in the
[architecture](./ARCHITECTURE.md) of this repository.
[](https://builtwithnix.org)