摘要：主要版本變化意味著一些向后兼容的更改，以及這些更改啟用的一些全新功能。使用私鑰簽署消息和交易現(xiàn)在可以在沒有任何客戶端連接的情況下對消息和原始交易進(jìn)行簽名以及驗證它們。

Web3.py第4版的第一個測試版于2017年11月中旬發(fā)布，此后又發(fā)布了5個版本，目前已經(jīng)穩(wěn)定發(fā)布到4.6。主要版本變化意味著一些向后兼容的更改，以及這些更改啟用的一些全新功能。感興趣的話請繼續(xù)閱讀本概述。

等不及要玩了嗎？現(xiàn)在用pip安裝。Pip默認(rèn)不會安裝測試版，因此請使用--pre標(biāo)志立即獲取v4：

pip install --pre web3

其中一個更重要的變化是現(xiàn)在需要Python 3.5。你的項目仍然停留在py2上嗎？立即升級代碼。它比你想象的要快2to3。Python 3提供了許多有用的功能和庫，并且它消除了bytes和str的歧義，這為升級鋪平了道路。

如果瀏覽在v3中返回十六進(jìn)制字符串的函數(shù)，你會發(fā)現(xiàn)它們中的大多數(shù)在v4中返回類似bytes的對象。下面示例中的HexBytes類是內(nèi)置字bytes型的子類，因此可以在bytes所在的任何位置使用。

>>> from web3.auto import w3
>>> block_hash = w3.eth.getBlock(4359745).hash
HexBytes("0x03087766bf68e78671d1ea436ae087da74a12761dac020011a9eddc4900bf13b")
# get the first byte:
>>> block_hash[0]
3
# show how many bytes are in the hash
>>> len(block_hash)
32
# hex-encode the hash
>>> w3.toHex(block_hash)
"0x03087766bf68e78671d1ea436ae087da74a12761dac020011a9eddc4900bf13b"
# cast back to the basic `bytes` type
>>> bytes(block_hash)
b"x03x08wfxbfhxe7x86qxd1xeaCjxe0x87xdatxa1"axdaxc0 x01x1ax9exddxc4x90x0bxf1;"

如果合約返回ABI bytes類型，那么將獲得python bytes值。如果它返回ABI 字符串類型，那么你將得到一個python str。同樣，合約函數(shù)的參數(shù)也會匹配對應(yīng)。

如果提供的參數(shù)類型與相應(yīng)的ABI類型不完全匹配，則將嘗試轉(zhuǎn)換它。 例如：

發(fā)送到ABI字符串類型的字節(jié)值將是UTF-8解碼的

發(fā)送到ABI字節(jié)類型的str值將被轉(zhuǎn)換為十六進(jìn)制

合同函數(shù)的v3 API有點違反直覺，在指定函數(shù)之前指定如何處理函數(shù)，例如：contract.call().balanceOf(...)。我們使用類似web3.js的格式轉(zhuǎn)換這些格式：v1：contract.functions.balanceOf(...).call()。

現(xiàn)在可以在沒有任何客戶端連接的情況下對消息和原始交易進(jìn)行簽名以及驗證它們。

以下是簽署一個信息的的示例：

>>> from web3 import Account, Web3
>>> msg = "I?SF"
>>> key = b"xb2..."
>>> Account.sign(message_text=msg, private_key=key)
{"message": b"Ixe2x99xa5SF",
 "messageHash": HexBytes("0x1476abb745d423bf09273f1afd887d951181d25adc66c4834a70491911b7f750"),
 ...
 "signature": HexBytes("0xe6ca9bba58c88611fad66a6ce8f996908195593807c4b38bd528d2cff09d4eb33e5bfbbf4d3e39b1a2fd816a7680c19ebebaf3a141b239934ad43cb33fcec8ce1c")}

還有很多其他私鑰功能。有關(guān)更多信息，請參閱web3.eth.account文檔。

在v3中，沒有很好的方法來創(chuàng)建合約交易對象。這并不重要，因為除了廣播這個交易之外別無他法，這已經(jīng)很容易了。但是，在第4版中，我們可能希望在廣播之前在本地簽署該交易對象。所以添加了buildTransaction()選項，如下所示：

>>> from web3.auto import w3
>>> token = w3.eth.contract(abi=...)
>>> transfer = token.functions.transfer("ethereumfoundation.eth", 1).buildTransaction()

>>> signed = w3.eth.account.signTransaction(transfer, key)
>>> w3.eth.sendRawTransaction(signed.rawTransaction)

在第3版中，過濾器從未按照人們想要的方式運行。標(biāo)準(zhǔn)JSON-RPC API僅支持輪詢更新篩選器。因此，為了模擬回調(diào)機制，Web3.py必須以線程為主，并支持多種方法（如stdlib或gevent）。它很麻煩，容易出現(xiàn)故障。這些失敗很難在運行時調(diào)試和捕獲。

在v4中，Web3.py將用戶的選擇添加到監(jiān)視線程，并在你的應(yīng)用程序合適時調(diào)用get_new_entries()。這允許你捕獲可能引發(fā)的Exception，并調(diào)試你的過濾器。新系統(tǒng)更可靠，更容易追蹤正在發(fā)生的事情，但還有更多的改進(jìn)空間。因此，請注意v4中的更多過濾更新以及v5中的更新。

在可以輸入地址的任何地方，v4都接受作為一個名稱。然后Web3.py將為你查找該地址。有關(guān)以太坊名稱服務(wù)的更多詳細(xì)信息，請參閱此文章，了解ENS如何適合Web3.py。

例如，我們可以在ethereumfoundation.eth獲得地址的余額：

>>> from web3.auto import w3
>>> w3.eth.getBalance("ethereumfoundation.eth")
2963803006730275571720

猜測連接到普通客戶端需要哪些參數(shù)并不難。然而，在第3版中，有必要指定使用哪個接口，例如：

from web3 import Web3, IPCProvider
w3 = Web3(IPCProvider())

也許你從之前的例子中注意到，在v4中，這可以通過單行實現(xiàn)：

from web3.auto import w3

此外，可以在沒有任何接口的情況下初始化Web3，這具有相同的效果：

from web3 import Web3
w3 = Web3()

自動接口檢測可以猜測生產(chǎn)網(wǎng)絡(luò)的常見IPC和HTTP連接設(shè)置。它還會檢查你是否設(shè)置了環(huán)境變量。

EIP55定義了十六進(jìn)制地址的校驗和機制，它將一些十六進(jìn)制字符轉(zhuǎn)換為大寫字母。Web3.py選擇支持該機制有一段時間，它現(xiàn)在是所有地址所必需的。全小寫十六進(jìn)制地址將被拒絕為無效（除了在校驗和產(chǎn)生全小寫十六進(jìn)制地址的極少數(shù)情況下）。

此外，現(xiàn)在從所有方法返回校驗地址。這樣做的好處是地址相等性測試可以簡單地使用addr1 == addr2，因為只有一個EIP 55地址的有效表示。

感謝https://ethgasstation.info/發(fā)布他們的算法。我們將其中的一個版本合并到Web3.py中的新gas價格估算的后端代碼中。這樣：

from web3 import Web3, middleware
from web3.gas_strategies.time_based import medium_gas_price_strategy

w3 = Web3()
w3.eth.setGasPriceStrategy(medium_gas_price_strategy)

w3.middleware_stack.add(middleware.time_based_cache_middleware)
w3.middleware_stack.add(middleware.latest_block_based_cache_middleware)
w3.middleware_stack.add(middleware.simple_cache_middleware)
w3.eth.generateGasPrice()

你肯定會想要那些新的緩存中間件，因為它會對你的節(jié)點進(jìn)行大量調(diào)用。只有在自動獲得更好的價格估算時才進(jìn)行此設(shè)置，這至關(guān)重要，值得花點兒時間。第一次估計測試計算大約50秒。

要查看完整的更改列表，請訪問v4發(fā)行說明。

當(dāng)然，python用web3.py庫開發(fā)以太坊來說非常的方便，有興趣的用戶可以關(guān)注我們的python以太坊教程，主要是針對python工程師使用web3.py進(jìn)行區(qū)塊鏈以太坊開發(fā)的詳解。

這里是原文