web3.py簡介

與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進行區塊鏈以太坊開發的詳解。

其餘以太坊相關教程：

• web3j教程，主要是針對java和android程序員進行區塊鏈以太坊開發的web3j詳解。
• 以太坊教程，主要介紹智能合約與dapp應用開發，適合入門。
• 以太坊開發，主要是介紹使用node.js、mongodb、區塊鏈、ipfs實現去中心化電商DApp實戰，適合進階。
• php以太坊，主要是介紹使用php進行智能合約開發交互，進行帳號建立、交易、轉帳、代幣開發以及過濾器和事件等內容。

轉載請標明出處。這裏是原文