# Quick Start
This is a Hardhat network provider plugin for Ape.
Hardhat is a development framework written in Node.js for Ethereum that includes a local network implementation.
Use this plugin to manage a Hardhat node process or connect to an existing one.
## Dependencies
- [python3](https://www.python.org/downloads) version 3.8 up to 3.12.
- Node.js, NPM, and Hardhat 2.12.0 or greater. See Hardhat's [Installation](https://hardhat.org/getting-started/#installation%3E) documentation for steps.
## Installation
### via `pip`
You can install the latest release via [`pip`](https://pypi.org/project/pip/):
```bash
pip install ape-hardhat
```
### via `setuptools`
You can clone the repository and use [`setuptools`](https://github.com/pypa/setuptools) for the most up-to-date version:
```bash
git clone https://github.com/ApeWorX/ape-hardhat.git
cd ape-hardhat
python3 setup.py install
```
## Quick Usage
To use the plugin, first install Hardhat locally into your Ape project directory:
```bash
cd your-ape-project
npm install --save-dev hardhat
```
After that, you can use the `--network ethereum:local:hardhat` command line flag to use the hardhat network (if it's not already configured as the default).
This network provider takes additional Hardhat-specific configuration options. To use them, add these configs in your project's `ape-config.yaml`:
```yaml
hardhat:
host: 127.0.0.1:8555
```
To select a random port, use a value of "auto":
```yaml
hardhat:
host: auto
```
**NOTE**: If you plan on running multiple Hardhat nodes of any kind, you likely will want to use `auto` or configure multiple hosts (see examples below).
This is useful for multiprocessing and starting up multiple providers.
You can also adjust the request timeout setting:
```yaml
hardhat:
request_timeout: 20 # Defaults to 30
fork_request_timeout: 600 # Defaults to 300
```
## Mainnet Fork
The `ape-hardhat` plugin also includes a mainnet fork provider. It requires using another provider that has access to mainnet.
Use it in most commands like this:
```bash
ape console --network :mainnet-fork:hardhat
```
Specify the upstream archive-data provider in your `ape-config.yaml`:
```yaml
hardhat:
fork:
ethereum:
mainnet:
upstream_provider: alchemy
```
Otherwise, it defaults to the default mainnet provider plugin. You can also specify a `block_number`.
**NOTE**: Make sure you have the upstream provider plugin installed for ape.
If you wish to run both a forked network and the local Hardhat network simultaneously, you may configure a separate host for the forked network(s).
```yaml
hardhat:
fork:
ethereum:
mainnet:
upstream_provider: alchemy
host: 127.0.0.1:8555
polygon:
mainnet:
upstream_provider: alchemy
host: 127.0.0.1:8556
```
[Hardhat deployments](https://github.com/wighawag/hardhat-deploy#deploy-scripts-tags-and-dependencies) are disabled for forks for performance reasons. If you want your contract deployments to run on your fork, you can set `enable_hardhat_deployments` to `true` in your config:
```yaml
hardhat:
fork:
ethereum:
mainnet:
upstream_provider: alchemy
enable_hardhat_deployments: true
```
```bash
ape plugins install alchemy
```
## Remote Hardhat Node
To connect to a Hardhat node, set up your config like this:
```yaml
hardhat:
host: https://hardhat.example.com
```
Now, instead of launching a local process, it will attempt to connect to the remote Hardhat node and use this plugin as the ape interace.
## Custom Hardhat Config File
By default, Ape generates and uses a basic config file for starting up a Hardhat node and having the same test accounts that Ape expects.
To avoid conflict with other pre-existing Hardhat config files, Ape generates one in `$HOME/.ape/hardhat` and always refers to that one.
To use a different one, such as the one in your local project instead, add the following to your `ape-config.yaml`:
```yaml
hardhat:
hardhat_config_file: ./hardhat.config.ts
```
**NOTE**: You can refer to either a Hardhat JS file or a Hardhat TS file.
## Development
Please see the [contributing guide](CONTRIBUTING.md) to learn more how to contribute to this project.
Comments, questions, criticisms and pull requests are welcomed.
Raw data
{
"_id": null,
"home_page": "https://github.com/ApeWorX/ape-hardhat",
"name": "ape-hardhat",
"maintainer": null,
"docs_url": null,
"requires_python": "<4,>=3.8",
"maintainer_email": null,
"keywords": "ethereum",
"author": "ApeWorX Ltd.",
"author_email": "admin@apeworx.io",
"download_url": "https://files.pythonhosted.org/packages/6a/a7/6148723adef8a3e34d0f218449f91597d9923448c4a8e07dd39e20842835/ape-hardhat-0.7.3.tar.gz",
"platform": null,
"description": "# Quick Start\n\nThis is a Hardhat network provider plugin for Ape.\nHardhat is a development framework written in Node.js for Ethereum that includes a local network implementation.\nUse this plugin to manage a Hardhat node process or connect to an existing one.\n\n## Dependencies\n\n- [python3](https://www.python.org/downloads) version 3.8 up to 3.12.\n- Node.js, NPM, and Hardhat 2.12.0 or greater. See Hardhat's [Installation](https://hardhat.org/getting-started/#installation%3E) documentation for steps.\n\n## Installation\n\n### via `pip`\n\nYou can install the latest release via [`pip`](https://pypi.org/project/pip/):\n\n```bash\npip install ape-hardhat\n```\n\n### via `setuptools`\n\nYou can clone the repository and use [`setuptools`](https://github.com/pypa/setuptools) for the most up-to-date version:\n\n```bash\ngit clone https://github.com/ApeWorX/ape-hardhat.git\ncd ape-hardhat\npython3 setup.py install\n```\n\n## Quick Usage\n\nTo use the plugin, first install Hardhat locally into your Ape project directory:\n\n```bash\ncd your-ape-project\nnpm install --save-dev hardhat\n```\n\nAfter that, you can use the `--network ethereum:local:hardhat` command line flag to use the hardhat network (if it's not already configured as the default).\n\nThis network provider takes additional Hardhat-specific configuration options. To use them, add these configs in your project's `ape-config.yaml`:\n\n```yaml\nhardhat:\n host: 127.0.0.1:8555\n```\n\nTo select a random port, use a value of \"auto\":\n\n```yaml\nhardhat:\n host: auto\n```\n\n**NOTE**: If you plan on running multiple Hardhat nodes of any kind, you likely will want to use `auto` or configure multiple hosts (see examples below).\n\nThis is useful for multiprocessing and starting up multiple providers.\n\nYou can also adjust the request timeout setting:\n\n```yaml\nhardhat:\n request_timeout: 20 # Defaults to 30\n fork_request_timeout: 600 # Defaults to 300\n```\n\n## Mainnet Fork\n\nThe `ape-hardhat` plugin also includes a mainnet fork provider. It requires using another provider that has access to mainnet.\n\nUse it in most commands like this:\n\n```bash\nape console --network :mainnet-fork:hardhat\n```\n\nSpecify the upstream archive-data provider in your `ape-config.yaml`:\n\n```yaml\nhardhat:\n fork:\n ethereum:\n mainnet:\n upstream_provider: alchemy\n```\n\nOtherwise, it defaults to the default mainnet provider plugin. You can also specify a `block_number`.\n\n**NOTE**: Make sure you have the upstream provider plugin installed for ape.\n\nIf you wish to run both a forked network and the local Hardhat network simultaneously, you may configure a separate host for the forked network(s).\n\n```yaml\nhardhat:\n fork:\n ethereum:\n mainnet:\n upstream_provider: alchemy\n host: 127.0.0.1:8555\n polygon:\n mainnet:\n upstream_provider: alchemy\n host: 127.0.0.1:8556\n```\n\n[Hardhat deployments](https://github.com/wighawag/hardhat-deploy#deploy-scripts-tags-and-dependencies) are disabled for forks for performance reasons. If you want your contract deployments to run on your fork, you can set `enable_hardhat_deployments` to `true` in your config:\n\n```yaml\nhardhat:\n fork:\n ethereum:\n mainnet:\n upstream_provider: alchemy\n enable_hardhat_deployments: true\n```\n\n```bash\nape plugins install alchemy\n```\n\n## Remote Hardhat Node\n\nTo connect to a Hardhat node, set up your config like this:\n\n```yaml\nhardhat:\n host: https://hardhat.example.com\n```\n\nNow, instead of launching a local process, it will attempt to connect to the remote Hardhat node and use this plugin as the ape interace.\n\n## Custom Hardhat Config File\n\nBy default, Ape generates and uses a basic config file for starting up a Hardhat node and having the same test accounts that Ape expects.\nTo avoid conflict with other pre-existing Hardhat config files, Ape generates one in `$HOME/.ape/hardhat` and always refers to that one.\nTo use a different one, such as the one in your local project instead, add the following to your `ape-config.yaml`:\n\n```yaml\nhardhat:\n hardhat_config_file: ./hardhat.config.ts\n```\n\n**NOTE**: You can refer to either a Hardhat JS file or a Hardhat TS file.\n\n## Development\n\nPlease see the [contributing guide](CONTRIBUTING.md) to learn more how to contribute to this project.\nComments, questions, criticisms and pull requests are welcomed.\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "ape-hardhat: Ape network provider for Hardhat",
"version": "0.7.3",
"project_urls": {
"Homepage": "https://github.com/ApeWorX/ape-hardhat"
},
"split_keywords": [
"ethereum"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "29e7285ea6f1b54c5dd6c2b4488c989dddebb2eee03ca199b2cdfecabbeb5a89",
"md5": "ee8f127c8bee4a54de33f5ba62da3a93",
"sha256": "d386358a01100f82e1eab81f23e20c1be3bd236a8deb08d46093a16120cf04d7"
},
"downloads": -1,
"filename": "ape_hardhat-0.7.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ee8f127c8bee4a54de33f5ba62da3a93",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4,>=3.8",
"size": 21340,
"upload_time": "2024-05-10T14:48:47",
"upload_time_iso_8601": "2024-05-10T14:48:47.011460Z",
"url": "https://files.pythonhosted.org/packages/29/e7/285ea6f1b54c5dd6c2b4488c989dddebb2eee03ca199b2cdfecabbeb5a89/ape_hardhat-0.7.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "6aa76148723adef8a3e34d0f218449f91597d9923448c4a8e07dd39e20842835",
"md5": "7df403864855e2a3d8bc5ef1b4172f44",
"sha256": "d9b0be292ca9588dc3c9146db8fcd8d5826d1ad2f75caefb9d6d81c7d8c189ae"
},
"downloads": -1,
"filename": "ape-hardhat-0.7.3.tar.gz",
"has_sig": false,
"md5_digest": "7df403864855e2a3d8bc5ef1b4172f44",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4,>=3.8",
"size": 94224,
"upload_time": "2024-05-10T14:48:49",
"upload_time_iso_8601": "2024-05-10T14:48:49.043605Z",
"url": "https://files.pythonhosted.org/packages/6a/a7/6148723adef8a3e34d0f218449f91597d9923448c4a8e07dd39e20842835/ape-hardhat-0.7.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-10 14:48:49",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ApeWorX",
"github_project": "ape-hardhat",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "ape-hardhat"
}