内容字号:默认大号超大号

段落设置:段首缩进取消段首缩进

字体设置:切换到微软雅黑切换到宋体

Python的Geth封装库PyGeth

2019-01-06 20:24 出处:清屏网 人气: 评论(0

PyGeth是一个Python封装库,用来作为子进程运行 geth

系统依赖

该库需要 geth 可执行文件。

安装

pip install py-geth

快速启动

运行连接到 mainnetgeth

>>> from geth import LiveGethProcess
>>> geth = LiveGethProcess()
>>> geth.start()

或者是用于测试的私人本地区块链。这就要求你给他们一个名字。

>>> from geth import DevGethProcess
>>> geth = DevGethProcess('testing')
>>> geth.start()

默认情况下, DevGethProcessgeth 使用的默认 datadir 设置测试链。如果要更改这些测试链的位置,可以指定替代 base_dir

>>> geth = DevGethProcess('testing', '/tmp/some-other-base-dir/')
>>> geth.start()

每个实例都有一些方便的属性。

>>> geth.data_dir
"~/.ethereum"
>>> geth.rpc_port
8545
>>> geth.ipc_path
"~/.ethereum/geth.ipc"
>>> geth.accounts
['0xd3cda913deb6f67967b99d67acdfa1712c293601']
>>> geth.is_alive
False
>>> geth.is_running
False
>>> geth.is_stopped
False
>>> geth.start()
>>> geth.is_alive
True  # 表示子进程尚未退出
>>> geth.is_running
True  # 表示调用了start(),但是没有stop()
>>> geth.is_stopped
False
>>> geth.stop()
>>> geth.is_alive
False
>>> geth.is_running
False
>>> geth.is_stopped
True

在测试时,可以很好地查看 geth 进程生成的日志记录输出。 py-geth 提供了一个 mixin 类,可用于将 stdoutstderr 输出记录到日志文件中。

>>> from geth import LoggingMixin, DevGethProcess
>>> class MyGeth(LoggingMixin, DevGethProcess):
...     pass
>>> geth = MyGeth()
>>> geth.start()

所有日志都将写入当前目录 ./logs/ 中的日志文件。

底层 geth 进程可能需要额外的时间来打开RPC或IPC连接,以及在需要生成DAG时开始挖掘。你可以使用以下接口来查询这些接口是否已准备就绪。

>>> geth.is_rpc_ready
True
>>> geth.wait_for_rpc(timeout=30)  # 等待最多30秒,以便打开RPC连接。
>>> geth.is_ipc_ready
True
>>> geth.wait_for_ipc(timeout=30)  # 等待最多30秒,以便IPC套接字打开。
>>> geth.is_dag_generated
True
>>> geth.is_mining
True
>>> geth.wait_for_dag(timeout=600)  # 等待最多10分钟,以便生成DAG。

DAG功能目前仅适用于epoch 0。

安装特定版本的 geth

此功能是实验性的,可能会发生重大变化。

可以使用py-geth在列出的平台上安装以下任何版本的geth 。

v1.5.6
v1.5.7
v1.5.8
v1.5.9
v1.6.0
v1.6.1
v1.6.2
v1.6.3
v1.6.4
v1.6.5
v1.6.6
v1.6.7
v1.7.0
v1.7.2
v1.8.1

可以通过命令行完成安装:

$ python -m geth.install v0.4.12

或者使用 install_geth 函数从python安装。

>>> from geth import install_geth
>>> install_geth('v1.7.0')

已安装的二进制文件可以在 $HOME/.py-geth 目录下找到。 v1.7.0 二进制文件位于 $HOME/.py-geth/geth-v1.7.0/bin/geth

关于 DevGethProcess

DevGethProcess 旨在促进测试。在这方面,它预先配置如下。

  • 创建一个帐户并分配10亿以太。
  • rpcipc 接口上都启用了所有API。
  • 帐户0已解锁。
  • 网络配置为不查找或连接到任何对等方。
  • 使用 1234networkid
  • 测试程度设为 5 (DEBUG)
  • 使用单个线程启用挖掘。
  • RPC接口尝试绑定到8545,但如果此端口不可用,则会找到一个开放端口。
  • DevP2P接口尝试绑定到30303,但如果此端口不可用,将找到一个开放端口。

Gotchas

如果你在启用 mining 情况下运行(这是 DevGethProcess 默认设置,那么你可能需要手动生成DAG。如果不这样做,那么它将在你第一次运行该过程时自动生成,这需要一段时间。

要手动生成它:

$ geth makedag 0 ~/.ethash

这在像Travis-CI这样的CI环境中尤其重要,在这种情况下,你的流程可能会在生成期间超时。

开发

克隆存储库然后运行:

pip install -e . -r requirements-dev.txt

运行测试

可以使用以下命令运行测试:

py.test tests

或者你可以安装 tox 来运行完整的测试套件。

发布

需要Pandoc才能将markdown README转换为正确的格式,以便在pypi上正确呈现。

对于类似Debian的系统:

apt install pandoc

或者在OSX上:

brew install pandoc

要发布新版本:

make release bump=$$VERSION_PART_TO_BUMP$$

如何bump版本

此repo的版本格式为 {major}.{minor}.{patch} 表示stable, {major}.{minor}.{patch} {major}.{minor}.{patch}-{stage}.{devnum} 表示unstable( stage 可以是alpha或beta)。

要在行中发布下一个版本,请指定要bump的部分,例如 make release bump=minormake release bump=devnum

如果你处于测试版,则 make release bump=stage 将切换为稳定版。

要在当前版本稳定时发出不稳定版本,请明确指定新版本,例如 make release bump="--new-version 4.0.0-alpha.1 devnum"

======================================================================

分享一些以太坊、EOS、比特币等区块链相关的交互式在线编程实战教程:

java以太坊开发教程,主要是针对java和android程序员进行区块链以太坊开发的web3j详解。

  • java比特币开发教程,本课程面向初学者,内容即涵盖比特币的核心概念,例如区块链存储、去中心化共识机制、密钥与脚本、交易与UTXO等,同时也详细讲解如何在Java代码中集成比特币支持功能,例如创建地址、管理钱包、构造裸交易等,是Java工程师不可多得的比特币开发学习课程。
  • python以太坊,主要是针对python工程师使用web3.py进行区块链以太坊开发的详解。
  • php以太坊,主要是介绍使用php进行智能合约开发交互,进行账号创建、交易、转账、代币开发以及过滤器和交易等内容。
  • 以太坊入门教程,主要介绍智能合约与dapp应用开发,适合入门。
  • 以太坊开发进阶教程,主要是介绍使用node.js、mongodb、区块链、ipfs实现去中心化电商DApp实战,适合进阶。
  • C#以太坊,主要讲解如何使用C#开发基于.Net的以太坊应用,包括账户管理、状态与交易、智能合约开发与交互、过滤器和交易等。
  • EOS教程,本课程帮助你快速入门EOS区块链去中心化应用的开发,内容涵盖EOS工具链、账户与钱包、发行代币、智能合约开发与部署、使用代码与智能合约交互等核心知识点,最后综合运用各知识点完成一个便签DApp的开发。
  • php比特币开发教程,本课程面向初学者,内容即涵盖比特币的核心概念,例如区块链存储、去中心化共识机制、密钥与脚本、交易与UTXO等,同时也详细讲解如何在Php代码中集成比特币支持功能,例如创建地址、管理钱包、构造裸交易等,是Php工程师不可多得的比特币开发学习课程。
  • tendermint区块链开发详解 ,本课程适合希望使用tendermint进行区块链开发的工程师,课程内容即包括tendermint应用开发模型中的核心概念,例如ABCI接口、默克尔树、多版本状态库等,也包括代币发行等丰富的实操代码,是go语言工程师快速入门区块链开发的最佳选择。
分享给小伙伴们:
本文标签: PyGethGethPython

相关文章

发表评论愿您的每句评论,都能给大家的生活添色彩,带来共鸣,带来思索,带来快乐。

CopyRight © 2015-2016 QingPingShan.com , All Rights Reserved.

清屏网 版权所有 豫ICP备15026204号