phylaxsystems
diff --git a/Diff for: ‎Cargo.lock
+221-212 b/Diff for: ‎Cargo.lock
+221-212
diff --git a/Diff for: ‎Cargo.toml
+6-4 b/Diff for: ‎Cargo.toml
+6-4
diff --git a/Diff for: ‎README.md
+114-133 b/Diff for: ‎README.md
+114-133
diff --git a/Diff for: ‎assets/ContractTemplate.sol
+4 b/Diff for: ‎assets/ContractTemplate.sol
+4
diff --git a/Diff for: ‎assets/ContractTemplate.t.sol
+6 b/Diff for: ‎assets/ContractTemplate.t.sol
+6
diff --git a/Diff for: ‎assets/demo.svg
+1 b/Diff for: ‎assets/demo.svg
+1
diff --git a/Diff for: ‎seth/Cargo.toml renamed to ‎cast/Cargo.toml
+2-2 b/Diff for: ‎seth/Cargo.toml renamed to ‎cast/Cargo.toml
+2-2
diff --git a/Diff for: ‎cast/README.md
+59 b/Diff for: ‎cast/README.md
+59
@@ -2,10 +2,9 @@
 members = [
     "evm-adapters",
     "utils",
-    "seth",
-    "dapp",
-    "dapptools",
-    "solc",
+    "cast",
+    "forge",
+    "cli",
 ]
 
 # Binary size optimizations
@@ -14,3 +13,6 @@ opt-level = "z"
 lto = true
 codegen-units = 1
 panic = "abort"
+
+[patch."https://github.com/rust-blockchain/evm"]
+evm = { git = "https://github.com/gakonst/evm", branch = "feat/auto-impl" }
@@ -1,140 +1,103 @@
-# <h1 align="center"> dapptools.rs </h1>
+# <h1 align="center"> foundry </h1>
 
-_Rust port of DappTools_
-
-![Github Actions](https://github.com/gakonst/dapptools-rs/workflows/Tests/badge.svg)
-[![Telegram Chat](https://img.shields.io/endpoint?color=neon&style=flat-square&url=https%3A%2F%2Ftg.sumanjay.workers.dev%2Fturbodapptools)](https://t.me/turbodapptools)
+![Github Actions](https://github.com/gakonst/foundry/workflows/Tests/badge.svg)
+[![Telegram Chat](https://img.shields.io/endpoint?color=neon&style=flat-square&url=https%3A%2F%2Ftg.sumanjay.workers.dev%2Ffoundry_rs)](https://t.me/foundry_rs)
 [![Crates.io][crates-badge]][crates-url]
 
-[crates-badge]: https://img.shields.io/crates/v/turbodapp.svg
-[crates-url]: https://crates.io/crates/turbodapp
+[crates-badge]: https://img.shields.io/crates/v/foundry.svg
+[crates-url]: https://crates.io/crates/foundry-rs
+
+**Foundry is a blazing fast, portable and modular toolkit for Ethereum
+application development written in Rust.**
+
+Foundry consists of:
+
+- [**Forge**](./forge): Ethereum testing framework (like Truffle, Hardhat and
+  Dapptools).
+- [**Cast**](./cast): Swiss army knife for interacting with EVM smart contracts,
+  sending transactions and getting chain data.
 
-## Installing
+![demo](./assets/demo.svg)
+
+## Forge
+
+```
+cargo install --git https://github.com/gakonst/foundry --bin forge
+```
 
-We have not published a release yet. Until we do, please use the command below.
-Because our dependencies may not be stable, do not forget the `--locked`
-parameter, which will force the installer to use the checked in `Cargo.lock`
-file.
+More documentation can be found in the [forge package](./forge/README.md) and in
+the [CLI README](./cli/README.md).
+
+### Features
+
+1. Fast & flexible compilation pipeline:
+   1. Automatic Solidity compiler version detection & installation (under
+      `~/.svm`)
+   1. Incremental compilation & caching: Only changed files are re-compiled
+   1. Parallel compilation
+   1. Non-standard directory structures support (e.g. can build
+      [Hardhat repos](https://twitter.com/gakonst/status/1461289225337421829))
+1. Tests are written in Solidity (like in DappTools)
+1. Fast fuzz Tests with shrinking of inputs & printing of counter-examples
+1. Fast remote RPC forking mode leveraging Rust's async infrastructure like
+   tokio
+1. Flexible debug logging:
+   1. Dapptools-style, using `DsTest`'s emitted logs
+   1. Hardhat-style, using the popular `console.sol` contract
+1. Portable (5-10MB) & easy to install statically linked binary without
+   requiring Nix or any other package manager
+1. Abstracted over EVM implementations (currently supported: Sputnik, EvmOdin)
+
+### How Fast?
+
+Forge is quite fast at both compiling (leveraging the
+[ethers-solc](https://github.com/gakonst/ethers-rs/tree/master/ethers-solc/)
+package) and testing.
+
+Some benchmarks below:
+
+| Project                                             | Forge | DappTools | Speedup |
+| --------------------------------------------------- | ----- | --------- | ------- |
+| [guni-lev](https://github.com/hexonaut/guni-lev/)   | 28.6s | 2m36s     | 5.45x   |
+| [solmate](https://github.com/Rari-Capital/solmate/) | 6s    | 46s       | 7.66x   |
+| [geb](https://github.com/reflexer-labs/geb)         | 11s   | 40s       | 3.63x   |
+| [vaults](https://github.com/rari-capital/vaults)    | 1.4s  | 5.5s      | 3.9x    |
+
+It also works with "non-standard" directory structures (i.e. contracts not in
+`src/`, libraries not in `lib/`). When
+[tested](https://twitter.com/gakonst/status/1461289225337421829) with
+[`openzeppelin-contracts`](https://github.com/OpenZeppelin/openzeppelin-contracts),
+Hardhat compilation took 15.244s, whereas Forge took 9.449 (~4s cached)
+
+## Cast
+
+Cast is a swiss army knife for interacting with Ethereum applications from the
+command line.
 
 ```
-cargo install --git https://github.com/gakonst/dapptools-rs --locked
+cargo install --git https://github.com/gakonst/foundry --bin cast
+// Get USDC's total supply
+cast call 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48 "totalSupply()(uint256)" --rpc-url <..your node url>
 ```
 
-Alternatively, clone the repository and run: `cargo build --release`
-
-## Why?! DappTools is great!
-
-Developer experience is the #1 thing we should be optimizing for in development.
-Tests MUST be fast, non-trivial tests (e.g. proptests) MUST be easy to write,
-and compilation MUST be fast.
-
-Before getting into technical reasons, my simple answer is: rewriting software
-in Rust is fun. I enjoy it, and that could be the end of the "why" section.
-
-DappTools is REALLY great.
-[You should try it](https://github.com/dapphub/dapptools/), especially the
-symbolic execution and step debugger features.
-
-But it has some shortcomings:
-
-It's written in a mix of Bash, Javascript and Haskell. In my opinion, this makes
-it hard to contribute, you don't have a "standard" way to test things, and it
-happens to be that there are not that many Haskell developers in the Ethereum
-community.
-
-It is also hard to distribute. It requires installing Nix, and that's a barrier
-to entry to many already because (for whatever reason) Nix doesn't always
-install properly the first time.
-
-The more technical reasons I decided to use it are:
-
-1. It is easier to write regression tests in Rust than in Bash.
-1. Rust binaries are cross-platform and easy to distribute.
-1. Compilation speed: We can use native bindings to the Solidity compiler
-   (instead of calling out to solcjs or even to the compiled binary) for extra
-   compilation speed.
-1. Testing speed: HEVM tests are really fast, but I believe we can go faster by
-   leveraging Rust's high performance multithreading and resource allocation
-   system.
-1. There seems to be an emerging community of Rust-Ethereum developers.
-
-Benchmarks TBD in the future, but:
-
-1. [Using a Rust EVM w/ forked RPC mode](https://github.com/brockelmore/rust-cevm/#compevm-rust-ethereum-virtual-machine-implementation-designed-for-smart-contract-composability-testing)
-   was claimed to be as high as 10x faster than HEVM's forking mode.
-1. Native bindings to the Solidity compiler have been shown to be
-   [10x](https://forum.openzeppelin.com/t/a-faster-solidity-compiler-cli-in-rust/2546)
-   faster than the JS bindings or even just calling out to the native binary.
-1. `seth` and `dapp` are less than 7mb when built with `cargo build --release`.
-
-## Features
-
-- seth
-  - [x] `--from-ascii` / `--from-utf8`
-  - [x] `--to-hex`
-  - [x] `--to-checksum-address`
-  - [x] `--to-ascii`
-  - [x] `--to-bytes32`
-  - [x] `--to-dec`
-  - [x] `--to-fix`
-  - [x] `--to-uint256`
-  - [x] `--to-wei`
-  - [x] `block`
-  - [x] `block-number`
-  - [x] `chain-id`
-  - [x] `age`
-  - [x] `basefee`
-  - [x] `gas-price`
-  - [x] `call` (partial)
-  - [x] `send` (partial)
-  - [x] `balance`
-  - [x] `ens`
-  - abi encoding
-  - 4byte resolution
-- dapp
-  - [ ] test
-    - [x] Simple unit tests
-      - [x] Gas costs
-      - [x] DappTools style test output
-      - [x] JSON test output
-      - [x] Matching on regex
-      - [x] DSTest-style assertions support
-    - [x] Fuzzing
-    - [ ] Symbolic execution
-    - [ ] Coverage
-    - [ ] HEVM-style Solidity cheatcodes
-      - [x] roll
-      - [x] warp
-      - [x] ffi
-      - [x] store
-      - [x] load
-      - [ ] sign
-      - [ ] addr
-      - [ ] makeEOA
-      - ...?
-    - [ ] Structured tracing with abi decoding
-    - [ ] Per-line gas profiling
-    - [x] Forking mode
-    - [x] Automatic solc selection
-  - [x] build
-    - [x] Can read DappTools-style .sol.json artifacts
-    - [x] Manual remappings
-    - [x] Automatic remappings
-    - [x] Multiple compiler versions
-    - [ ] Incremental compilation
-    - [ ] Can read Hardhat-style artifacts
-    - [ ] Can read Truffle-style artifacts
-  - [x] install
-  - [x] update
-  - [ ] debug
-  - [x] CLI Tracing with `RUST_LOG=dapp=trace`
-
-## Tested Against
-
-This repository has been tested against a few repositories which you can monitor
-[here](https://github.com/gakonst/dapptools-benchmarks)
-
-## Development
+More documentation can be found in the [cast package](./cast/README.md).
+
+## Contributing
+
+### Directory structure
+
+This repository contains several Rust crates:
+
+- [`forge`](forge): Library for building and testing a Solidity repository.
+- [`cast`](cast): Library for interacting with a live Ethereum JSON-RPC
+  compatible node, or for parsing data.
+- [`cli`](cli): Command line interfaces to `cast` and `forge`.
+- [`evm-adapters`](evm-adapters): Unified layer of abstraction over multiple EVM
+  types. Currently supported EVMs:
+  [Sputnik](https://github.com/rust-blockchain/evm/),
+  [Evmodin](https://github.com/vorot93/evmodin).
+- [`utils`](utils): Utilities for parsing ABI data, will eventually be
+  upstreamed to [ethers-rs](https://github.com/gakonst/ethers-rs/).
 
 ### Rust Toolchain
 
@@ -156,16 +119,34 @@ cargo doc --open
 
 ### Formatting
 
+We use the nightly toolchain for formatting and linting.
+
 ```
 cargo +nightly fmt
-cargo clippy
+cargo +nightly clippy --all-features -- -D warnings
 ```
 
 ## Getting Help
 
 First, see if the answer to your question can be found in the API documentation.
 If the answer is not there, try opening an
-[issue](https://github.com/gakonst/dapptools-rs/issues/new) with the question.
-
-Join the [turbodapptools telegram](https://t.me/turbodapptools) to chat with the
-community!
+[issue](https://github.com/gakonst/foundry/issues/new) with the question.
+
+Join the [foundry telegram](https://t.me/foundry_rs) to chat with the community!
+
+## Acknowledgements
+
+- Foundry is a clean-room rewrite of the testing framework
+  [dapptools](https://github.com/dapphub/dapptools). None of this would have
+  been possible without the DappHub team's work over the years.
+- [Matthias Seitz](https://twitter.com/mattsse_): Created
+  [ethers-solc](https://github.com/gakonst/ethers-rs/tree/master/ethers-solc/)
+  which is the backbone of our compilation pipeline, as well as countless
+  contributions to ethers, in particular the `abigen` macros.
+- [Rohit Narunkar](https://twitter.com/rohitnarurkar): Created the Rust Solidity
+  version manager [svm-rs](https://github.com/roynalnaruto/svm-rs) which we use
+  to auto-detect and manage multiple Solidity versions.
+- All the other
+  [contributors](https://github.com/gakonst/foundry/graphs/contributors) to the
+  [ethers-rs](https://github.com/gakonst/ethers-rs) &
+  [foundry](https://github.com/gakonst/foundry) repositories and chatrooms.
@@ -0,0 +1,4 @@
+// SPDX-License-Identifier: Unlicense
+pragma solidity 0.8.10;
+
+contract Contract {}
@@ -0,0 +1,6 @@
+// SPDX-License-Identifier: Unlicense
+pragma solidity 0.8.10;
+
+contract ContractTest {
+    function setUp() public {}
+}
@@ -1,13 +1,13 @@
 [package]
-name = "seth"
+name = "cast"
 version = "0.1.0"
 edition = "2018"
 license = "MIT OR Apache-2.0"
 
 # See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
 
 [dependencies]
-dapp-utils = { path = "../utils" }
+foundry-utils = { path = "../utils" }
 # ethers = "0.5"
 ethers-core = { git = "https://github.com/gakonst/ethers-rs", default-features = false }
 ethers-providers = { git = "https://github.com/gakonst/ethers-rs", default-features = false }
 
@@ -0,0 +1,59 @@
+# `cast`
+
+## Features
+
+- [ ] `--abi-decode`
+- [ ] `--calldata-decode`
+- [x] `--from-ascii` (with `--from-utf8` alias)
+- [ ] `--from-bin`
+- [ ] `--from-fix`
+- [ ] `--from-wei`
+- [ ] `--max-int`
+- [ ] `--max-uint`
+- [ ] `--min-int`
+- [x] `--to-checksum-address` (`--to-address` in dapptools)
+- [x] `--to-ascii`
+- [x] `--to-bytes32`
+- [x] `--to-dec`
+- [x] `--to-fix`
+- [x] `--to-hex`
+- [x] `--to-hexdata`
+- [ ] `--to-int256`
+- [x] `--to-uint256`
+- [x] `--to-wei`
+- [ ] `4byte`
+- [ ] `4byte-decode`
+- [ ] `4byte-event`
+- [ ] `abi-encode`
+- [x] `age`
+- [x] `balance`
+- [x] `basefee`
+- [x] `block`
+- [x] `block-number`
+- [ ] `bundle-source`
+- [x] `call` (partial)
+- [x] `calldata`
+- [x] `chain`
+- [x] `chain-id`
+- [ ] `code`
+- [ ] `debug`
+- [ ] `estimate`
+- [ ] `etherscan-source`
+- [ ] `events`
+- [x] `gas-price`
+- [ ] `index`
+- [x] `keccak`
+- [ ] `logs`
+- [x] `lookup-address`
+- [ ] `ls`
+- [ ] `mktx`
+- [x] `namehash`
+- [ ] `nonce`
+- [ ] `publish`
+- [ ] `receipt`
+- [x] `resolve-name`
+- [ ] `run-tx`
+- [x] `send` (partial)
+- [ ] `sign`
+- [x] `storage`
+- [ ] `tx`