web3.py是Python開發以太坊應用的利器
與web3.py庫互動的共同入口是web3
物件。web3物件提供API,用於python開發的應用與以太坊區塊鏈進行互動,通常是通過連線JSON-RPC伺服器進行。
Providers提供者
Providers
使web3連線到區塊鏈上。Web3.py庫帶有以下內建的providers
,它們能夠適用於大多數用例。
web3.HTTPProvider
:用於連線基於http和https的JSON-RPC伺服器。web3.IPCProvider
:用於連線基於ipc套接字的JSON-RPC伺服器。web3.WebsocketProvider
:用於連線基於ws和wss的websocket的JSON-RPC伺服器。
HTTPProvider
:用於獲取可以找到伺服器的完整URI。對於本地開發,這類似http://localhost:8545
。
IPCProvider
:用於獲取可以找到IPC套接字的檔案系統路徑。如果不提供任何引數,它將使用作業系統的預設路徑。
WebsocketProvider
:用於獲取可以找到伺服器的完整URI。對於本地開發,這類似ws://127.0.0.1:8546
。
示例程式碼如下:
>>> from web3 import Web3, HTTPProvider, IPCProvider, WebsocketProvider # Note that you should create only one RPCProvider per # process, as it recycles underlying TCP/IP network connections between # your process and Ethereum node >>> web3 = Web3(HTTPProvider('http://localhost:8545')) # or for an IPC based connection >>> web3 = Web3(IPCProvider()) # or for Websocket based connection >>> web3 = Web3(WebsocketProvider('ws://127.0.0.1:8546'))
基本API
web3類提供了以下十分便利的基本API:
型別轉換
web3.toHex
Web3.toHex(primitive=None, hexstr=None, text=None)
獲取各種輸入並以十六進位制表示形式返回它。它遵循在JSON-RPC規範中轉換為十六進位制的規則。
>>> Web3.toHex(0) '0x0' >>> Web3.toHex(1) '0x1' >>> Web3.toHex(0x0) '0x0' >>> Web3.toHex(0x000F) '0xf' >>> Web3.toHex(b'') '0x' >>> Web3.toHex(b'\x00\x0F') '0x000f' >>> Web3.toHex(False) '0x0' >>> Web3.toHex(True) '0x1' >>> Web3.toHex(hexstr='0x000F') '0x000f' >>> Web3.toHex(hexstr='000F') '0x000f' >>> Web3.toHex(text='') '0x' >>> Web3.toHex(text='cowmö') '0x636f776dc3b6'
web3.toText
Web3.toText(primitive=None, hexstr=None, text=None)
獲取各種輸入並返回其字串等效項。文字被解碼為UTF-8。
>>> Web3.toText(0x636f776dc3b6)
'cowmö'
>>> Web3.toText(b'cowm\xc3\xb6')
'cowmö'
>>> Web3.toText(hexstr='0x636f776dc3b6')
'cowmö'
>>> Web3.toText(hexstr='636f776dc3b6')
'cowmö'
>>> Web3.toText(text='cowmö')
'cowmö'
Web3.toBytes
Web3.toBytes(primitive=None, hexstr=None, text=None)
接受各種輸入並返回等效位元組。文字被編碼為UTF-8。
>>> Web3.toBytes(0)
b'\x00'
>>> Web3.toBytes(0x000F)
b'\x0f'
>>> Web3.toBytes(b'')
b''
>>> Web3.toBytes(b'\x00\x0F')
b'\x00\x0f'
>>> Web3.toBytes(False)
b'\x00'
>>> Web3.toBytes(True)
b'\x01'
>>> Web3.toBytes(hexstr='0x000F')
b'\x00\x0f'
>>> Web3.toBytes(hexstr='000F')
b'\x00\x0f'
>>> Web3.toBytes(text='')
b''
>>> Web3.toBytes(text='cowmö')
b'cowm\xc3\xb6'
Web3.toInt
Web3.toInt(primitive=None, hexstr=None, text=None)
接受各種輸入並返回其整數等效項。
>>> Web3.toInt(0)
0
>>> Web3.toInt(0x000F)
15
>>> Web3.toInt(b'\x00\x0F')
15
>>> Web3.toInt(False)
0
>>> Web3.toInt(True)
1
>>> Web3.toInt(hexstr='0x000F')
15
>>> Web3.toInt(hexstr='000F')
15
幣值轉換
Web3.toWei
Web3.toWei(value, currency)
返回轉換為wei的由currency
引數指定的面額中的值。
>>> Web3.toWei(1, 'ether')
1000000000000000000
Web3.fromWei
Web3.fromWei(value, currency)
返回wei轉換為給定貨幣的值。該值以Decimal
返回,以確保精度降至wei。
>>> web3.fromWei(1000000000000000000, 'ether')
Decimal('1')
地址
Web3.isAddress
Web3.isAddress(value)
如果該值是已識別的地址格式之一,則返回true。
- 允許0x字首和沒有字首的值。
- 如果地址包含混合的大小寫字元,則該函式還進行地址校驗和是否符合
EIP55
。
>>> web3.isAddress('0xd3CdA913deB6f67967B99D67aCDFa1712C293601')
True
Web3.isChecksumAddress
Web3.isChecksumAddress(value)
如果該值符合EIP55
而且是有效的地址,則返回true
>>> web3.isChecksumAddress('0xd3CdA913deB6f67967B99D67aCDFa1712C293601')
True
>>> web3.isChecksumAddress('0xd3cda913deb6f67967b99d67acdfa1712c293601')
False
Web3.toChecksumAddress
Web3.toChecksumAddress(value)
返回帶有EIP55校驗和給定地址。
>>> Web3.toChecksumAddress('0xd3cda913deb6f67967b99d67acdfa1712c293601')
'0xd3CdA913deB6f67967B99D67aCDFa1712C293601'
加密hash
Web3.sha3
classmethod Web3.sha3(primitive=None, hexstr=None, text=None)
返回給定值的Keccak SHA256
。在計算雜湊之前,文字被編碼到UTF-8,就像solidity一樣。下列任何一種方式都是有效和一樣的:
>>> Web3.sha3(0x747874)
>>> Web3.sha3(b'\x74\x78\x74')
>>> Web3.sha3(hexstr='0x747874')
>>> Web3.sha3(hexstr='747874')
>>> Web3.sha3(text='txt')
HexBytes('0xd7278090a36507640ea6b7a0034b69b0d240766fa3f98e3722be93c613b29d2e')
Web3.soliditySha3
classmethod Web3.soliditySha3(abi_types, value)
返回Sha3,它將根據所提供的value
和abi_types
通過soliditySha3
函式計算。abi_types
應該是對應於所提供的每個值的solidity型別字串的列表。
>>> Web3.soliditySha3(['bool'], True)
HexBytes("0x5fe7f977e71dba2ea1a68e21057beebb9be2ac30c6410aa38d4f3fbe41dcffd2")
>>> Web3.soliditySha3(['uint8', 'uint8', 'uint8'], [97, 98, 99])
HexBytes("0x4e03657aea45a94fc7d47ba826c8d667c0d1e6e33a64a036ec44f58fa12d6c45")
>>> Web3.soliditySha3(['uint8[]'], [[97, 98, 99]])
HexBytes("0x233002c671295529bcc50b76a2ef2b0de2dac2d93945fca745255de1a9e4017e")
>>> Web3.soliditySha3(['address'], ["0x49eddd3769c0712032808d86597b84ac5c2f5614"])
HexBytes("0x2ff37b5607484cd4eecf6d13292e22bd6e5401eaffcc07e279583bc742c68882")
>>> Web3.soliditySha3(['address'], ["ethereumfoundation.eth"])
HexBytes("0x913c99ea930c78868f1535d34cd705ab85929b2eaaf70fcd09677ecd6e5d75e9")
模組Modules
web3.py在JSON-RPC功能在多個模組上進行了分割,這些模組鬆散地對應於JSON-RPC方法的名稱空間。
希望快速開始進行python開發以太坊學習的可以看看這個:
python以太坊,主要是針對python工程師使用web3.py進行區塊鏈以太坊開發的詳解。
其他以太坊相關教程:
- 以太坊入門教程,主要介紹智慧合約與dapp應用開發,適合入門。
- 以太坊開發進階教程,主要是介紹使用node.js、mongodb、區塊鏈、ipfs實現去中心化電商DApp實戰,適合進階。
- java以太坊開發教程,主要是針對java和android程式設計師進行區塊鏈以太坊開發的web3j詳解。
- php以太坊,主要是介紹使用php進行智慧合約開發互動,進行賬號建立、交易、轉賬、代幣開發以及過濾器和交易等內容。
- C#以太坊,主要講解如何使用C#開發基於.Net的以太坊應用,包括賬戶管理、狀態與交易、智慧合約開發與互動、過濾器和交易等。
- php比特幣開發教程,本課程面向初學者,內容即涵蓋比特幣的核心概念,例如區塊鏈儲存、去中心化共識機制、金鑰與指令碼、交易與UTXO等,同時也詳細講解如何在Php程式碼中整合比特幣支援功能,例如建立地址、管理錢包、構造裸交易等,是Php工程師不可多得的比特幣開發學習課程。
- java比特幣開發教程,本課程面向初學者,內容即涵蓋比特幣的核心概念,例如區塊鏈儲存、去中心化共識機制、金鑰與指令碼、交易與UTXO等,同時也詳細講解如何在Java程式碼中整合比特幣支援功能,例如建立地址、管理錢包、構造裸交易等,是Java工程師不可多得的比特幣開發學習課程。
- EOS入門教程,本課程幫助你快速入門EOS區塊鏈去中心化應用的開發,內容涵蓋EOS工具鏈、賬戶與錢包、發行代幣、智慧合約開發與部署、使用程式碼與智慧合約互動等核心知識點,最後綜合運用各知識點完成一個便籤DApp的開發。
匯智網原創翻譯,轉載請標明出處。這裡是原文