ape-foundry: Ape network provider for Foundry
Project description
Quick Start
Foundry network provider plugin for Ape. Foundry is a development framework written in Rust for Ethereum that includes a local network implementation.
Dependencies
- python3 version 3.8 up to 3.11.
- Foundry. See Foundry's Installation documentation for steps.
Installation
via pip
You can install the latest release via pip:
pip install ape-foundry
via setuptools
You can clone the repository and use setuptools for the most up-to-date version:
git clone https://github.com/ApeWorX/ape-foundry.git
cd ape-foundry
python3 setup.py install
Quick Usage
Use the --network ethereum:local:foundry command line flag to use the foundry network (if it's not already configured as the default).
This network provider takes additional Foundry-specific configuration options. To use them, add these configs in your project's ape-config.yaml:
foundry:
port: 8555
To select a random port, use a value of "auto":
foundry:
port: auto
This is useful for multiprocessing and starting up multiple providers.
You can also adjust the request timeout setting:
foundry:
request_timeout: 20 # Defaults to 30
fork_request_timeout: 600 # Defaults to 300
Mainnet Fork
The ape-foundry plugin also includes a mainnet fork provider.
It requires using another provider that has access to mainnet.
Use it in most commands like this:
ape console --network :mainnet-fork:foundry
Specify the upstream archive-data provider in your ape-config.yaml:
foundry:
fork:
ethereum:
mainnet:
upstream_provider: alchemy
Otherwise, it defaults to the default mainnet provider plugin.
You can also specify a block_number and evm_version.
If the block number is specified, but no EVM version is specified, it is automatically set based on the block height for known networks.
NOTE: Make sure you have the upstream provider plugin installed for ape.
ape plugins install alchemy
Remote Anvil Node
To connect to a remote anvil node, set up your config like this:
foundry:
host: https://anvil.example.com
Now, instead of launching a local process, it will attempt to connect to the remote anvil node and use this plugin as the ape interface.
Impersonate Accounts
You can impersonate accounts using the ape-foundry plugin.
To impersonate an account, do the following:
import pytest
@pytest.fixture
def whale(accounts):
return accounts["example.eth"]
To transact, your impersonated account must have a balance.
You can achieve this by using a forked network and impersonating an account with a balance.
Alternatively, you can set your node's base fee and priority fee to 0.
To programtically set an account's balance, do the following:
from ape import accounts
account = accounts["example.eth"]
account.balance = "1000 ETH" # This calls `anvil_setBalance` under-the-hood.
Base Fee and Priority Fee
Configure your node's base fee and priority fee using the ape-config.yaml file.
foundry:
base_fee: 0
priority_fee: 0
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file ape-foundry-0.6.11.tar.gz.
File metadata
- Download URL: ape-foundry-0.6.11.tar.gz
- Upload date:
- Size: 92.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.10.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 469bc376ee0a144f95ed3081cfc366c469c93b59a031e10f8a313858adbb3f12 |
|
| MD5 | 1f8d53cb38afdc50670f575709618dad |
|
| BLAKE2b-256 | 1552fa44d8d39cdafb8e1f944336f645722366e4be866e312c1990e62de986a3 |
File details
Details for the file ape_foundry-0.6.11-py3-none-any.whl.
File metadata
- Download URL: ape_foundry-0.6.11-py3-none-any.whl
- Upload date:
- Size: 18.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.10.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | d3e7e7eb692e7e164ecc57c236a046a61ff4e3dcc97f0c50c2e744dd362c5f49 |
|
| MD5 | 5239f043050e26e0265ff5320c9572ad |
|
| BLAKE2b-256 | 7b92a20eb3fff567ac0f5ce758fe434c1423e1e66c7abc25a98e1c0185a63466 |
