跳转到主要内容

ape-hardhat: Ape网络提供商为Hardhat

项目描述

快速入门

这是一个为Ape提供的Hardhat网络提供程序插件。Hardhat是用Node.js编写的Ethereum开发框架,包括本地网络实现。使用此插件来管理Hardhat节点进程或连接到现有的一个。

依赖关系

  • python3 版本 3.9 至 3.12。
  • Node.js、NPM和Hardhat 2.12.0或更高版本。有关步骤,请参阅Hardhat的安装文档。

安装

通过pip

您可以通过pip安装最新版本

pip install ape-hardhat

通过setuptools

您可以克隆存储库并使用setuptools以获取最新版本

git clone https://github.com/ApeWorX/ape-hardhat.git
cd ape-hardhat
python3 setup.py install

快速使用

要使用此插件,首先在您的Ape项目目录中本地安装Hardhat

cd your-ape-project
npm install --save-dev hardhat

之后,您可以使用--network ethereum:local:hardhat命令行标志来使用Hardhat网络(如果它尚未配置为默认设置)。

此网络提供程序接受额外的Hardhat特定配置选项。要使用它们,请在您的项目的ape-config.yaml中添加这些配置。

hardhat:
  host: 127.0.0.1:8555

要选择随机端口,请使用“auto”值。

hardhat:
  host: auto

注意:如果您计划运行多个任何类型的Hardhat节点,您可能希望使用“auto”或配置多个主机(请参阅以下示例)。

这适用于多进程和启动多个提供程序。

您还可以调整请求超时设置

hardhat:
  request_timeout: 20  # Defaults to 30
  fork_request_timeout: 600  # Defaults to 300

主网分叉

ape-hardhat插件还包括主网分叉提供程序。它需要使用另一个可以访问主网的提供程序。

使用方式与大多数命令类似

ape console --network :mainnet-fork:hardhat

在您的ape-config.yaml中指定上游归档数据提供程序

hardhat:
  fork:
    ethereum:
      mainnet:
        upstream_provider: alchemy

否则,它默认为主网提供程序插件。您还可以指定一个block_number

注意:请确保您已安装ape的上游提供程序插件。

如果您希望同时运行分叉网络和本地Hardhat网络,您可以为分叉网络配置不同的主机。

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被禁用。如果您希望您的合约部署在您的分叉上运行,您可以在配置中将enable_hardhat_deployments设置为true

hardhat:
  fork:
    ethereum:
      mainnet:
        upstream_provider: alchemy
        enable_hardhat_deployments: true
ape plugins install alchemy

远程Hardhat节点

要连接到Hardhat节点,请设置您的配置如下

hardhat:
  host: https://hardhat.example.com

现在,它将尝试连接到远程Hardhat节点,并使用此插件作为ape接口。

自定义Hardhat配置文件

默认情况下,Ape会生成并使用一个基本的配置文件来启动Hardhat节点并拥有Ape期望的相同测试账户。为了避免与其他现有的Hardhat配置文件冲突,Ape在$HOME/.ape/hardhat中生成一个,并始终引用该文件。要使用不同的文件,例如您本地项目中的文件,请将以下内容添加到您的ape-config.yaml

hardhat:
  hardhat_config_file: ./hardhat.config.ts

注意:您可以选择Hardhat JS文件或Hardhat TS文件。

开发

请参阅贡献指南以了解更多有关如何为此项目做出贡献的信息。评论、问题、批评和拉取请求均受欢迎。

项目详情


下载文件

下载适用于您平台的文件。如果您不确定选择哪个,请了解有关 安装包 的更多信息。

源分布

ape-hardhat-0.8.1.tar.gz (92.8 kB 查看哈希值)

上传时间

构建分布

ape_hardhat-0.8.1-py3-none-any.whl (20.1 kB 查看哈希值)

上传时间 Python 3

由以下机构支持

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误日志 StatusPage StatusPage 状态页面