摘要：通信服務(wù)提供接口是如何與區(qū)塊鏈交互的關(guān)鍵。這通常通過將請求提交給基于或套接字的服務(wù)器來完成。初始化時(shí)會發(fā)生自動檢測有時(shí)，無法自動檢測節(jié)點(diǎn)的位置。使用自動檢測的示例一些節(jié)點(diǎn)提供超出標(biāo)準(zhǔn)的。是套接字的文件系統(tǒng)路徑。

通信服務(wù)提供接口是web3如何與區(qū)塊鏈交互的關(guān)鍵。接口接受JSON-RPC請求并返回響應(yīng)。這通常通過將請求提交給基于HTTP或IPC套接字的服務(wù)器來完成。

如果你已經(jīng)愉快地連接到你的以太坊節(jié)點(diǎn)，那么你可以跳過這部分內(nèi)容。

大多數(shù)節(jié)點(diǎn)都有多種連接方式。如果你尚未確定要使用哪種節(jié)點(diǎn)，請轉(zhuǎn)到如何選擇要使用的節(jié)點(diǎn)？

連接節(jié)點(diǎn)的最常用方法是：

1.IPC（使用本地文件系統(tǒng)：最快，最安全）

2.Websockets（遠(yuǎn)程工作，比HTTP更快）

3.HTTP（更多節(jié)點(diǎn)支持它）

如果你不確定如何決定，請選擇以下方式：

如果你可以選擇在與節(jié)點(diǎn)相同的計(jì)算機(jī)上運(yùn)行Web3.py，請選擇IPC。

如果必須連接到其他計(jì)算機(jī)上的節(jié)點(diǎn)，請使用Websockets。

如果你的節(jié)點(diǎn)不支持Websockets，請使用HTTP。

大多數(shù)節(jié)點(diǎn)都有“關(guān)閉”連接選項(xiàng)的方法。我們建議你關(guān)閉所有未使用的連接選項(xiàng)。這提供了更安全的設(shè)置：它減少了惡意黑客可以試圖竊取你的以太幣的方式。

確定連接后，可以使用通信服務(wù)提供接口Provider指定詳細(xì)信息。通信服務(wù)提供接口Provider程序是為所需類型的連接配置的Web3.py類。

看這幾個：

IPCProvider

WebsocketProvider

HTTPProvider

配置通信服務(wù)提供接口程序后，如：

from web3 import Web3
my_provider = Web3.IPCProvider("/my/node/ipc/path")

然后你就可以初始化Web3實(shí)例了，如下所示：

w3 = Web3(my_provider)

這樣，你就已準(zhǔn)備好開始使用Web3.py.

如果未指定通信服務(wù)提供接口程序，Web3對象將在幾個標(biāo)準(zhǔn)位置查找以太坊節(jié)點(diǎn)。初始化時(shí)會發(fā)生自動檢測：

from web3.auto import w3

# which is equivalent to:

from web3 import Web3
w3 = Web3()

有時(shí)，web3無法自動檢測節(jié)點(diǎn)的位置。

如果你不確定使用哪種連接方法，請看上文。

如果你知道連接方法，但不知道連接所需的其他信息（如IPC文件的路徑），則需要在節(jié)點(diǎn)的配置中查找該信息。

如果你不確定使用的是哪個節(jié)點(diǎn)，請參閱如何選擇要使用的節(jié)點(diǎn)？。

要深入了解自動檢測的工作原理，請接著看：

Web3嘗試按以下順序連接到節(jié)點(diǎn)，使用它可以進(jìn)行的第一個成功連接：

由環(huán)境變量指定的連接。

IPCProvider，它查找?guī)讉€IPC文件位置。

HTTPProvider，嘗試連接到http://localhost:8545。

如果沒有提供者成功，你仍然可以使用不需要連接的Web3 API，例如：

類型轉(zhuǎn)化(Type Conversions)。

貨幣單位轉(zhuǎn)換(Currency Conversions)。

地址相關(guān)(Addresses)。

使用本地私鑰(Local Private Keys)。

等等。

一些節(jié)點(diǎn)提供超出標(biāo)準(zhǔn)的API。有時(shí)，跨節(jié)點(diǎn)以不同方式提供相同的信息。如果要編寫跨多個節(jié)點(diǎn)工作的代碼，可能需要查找連接到的節(jié)點(diǎn)類型。

例如，以下內(nèi)容檢索geth和parity的客戶端enode端點(diǎn)：

from web3.auto import w3

connected = w3.isConnected()

if connected and w3.version.node.startswith("Parity"):
    enode = w3.parity.enode

elif connected and w3.version.node.startswith("Geth"):
    enode = w3.admin.nodeInfo["enode"]

else:
    enode = None

或者，你可以在啟動腳本之前設(shè)置環(huán)境變量WEB3_PROVIDER_URI，web3將首先查找這種方式。

此環(huán)境變量的有效格式為：

file:///path/to/node/rpc-json/file.ipc

http://192.168.1.2:8545

https://node.ontheweb.com

ws://127.0.0.1:8546

常見方法中有幾個自動初始化的快捷方式。

要輕松連接到Infura Mainnet遠(yuǎn)程節(jié)點(diǎn)，如果你沒有https://infura.io/signup，請先注冊免費(fèi)的API密鑰。

然后使用你的API密鑰設(shè)置環(huán)境變量INFURA_API_KEY：

$ export INFURA_API_KEY=YourApiKey

>>> from web3.auto.infura import w3

# confirm that the connection succeeded
>>> w3.isConnected()
True

要使用默認(rèn)值連接到geth --dev PoA(Proof-of-authority)實(shí)例：

>>> from web3.auto.gethdev import w3

# confirm that the connection succeeded
>>> w3.isConnected()
True

Web3附帶以下通信服務(wù)提供接口程序，這些通信服務(wù)提供接口程序適用于連接到本地和遠(yuǎn)程JSON-RPC服務(wù)器。

 class web3.providers.rpc.HTTPProvider(endpoint_uri[, request_kwargs])

此通信服務(wù)提供接口程序處理與基于HTTP或HTTPS的JSON-RPC服務(wù)器的交互。

endpoint_uri應(yīng)該是RPC端點(diǎn)的完整URI，例如"https://localhost:8545"。對于在端口80上運(yùn)行的HTTP連接后面的RPC服務(wù)器和在端口443上運(yùn)行的HTTPS連接，可以從URI中省略該端口。

request_kwargs這應(yīng)該是關(guān)鍵字參數(shù)的字典，它將被傳遞到http/https請求。

>>> from web3 import Web3
>>> web3 = Web3(Web3.HTTPProvider("http://127.0.0.1:8545"))

請注意，每個python進(jìn)程只應(yīng)創(chuàng)建一個HTTPProvider，因?yàn)镠TTPProvider會回收底層TCP/IP網(wǎng)絡(luò)連接，以獲得更好的性能。

HTTPProvider使用python請求庫來發(fā)出請求。如果你想修改請求的方式，可以使用request_kwargs來執(zhí)行此操作。一個常見的用例是增加每個請求的超時(shí)。

>>> from web3 import Web3
>>> web3 = Web3(Web3.HTTPProvider("http://127.0.0.1:8545", request_kwargs={"timeout": 60}))

web3.providers.ipc.IPCProvider(ipc_path=None, testnet=False, timeout=10)

此通信服務(wù)提供接口程序處理與基于IPC Socket的JSON-RPC服務(wù)器的交互。

ipc_path是IPC套接字的文件系統(tǒng)路徑。:56

>>> from web3 import Web3
>>> web3 = Web3(Web3.IPCProvider("~/Library/Ethereum/geth.ipc"))

如果沒有指定ipc_path，它將使用它可以從下表中找到的第一個IPC文件：

On Linux and FreeBSD:

~/.ethereum/geth.ipc

~/.local/share/io.parity.ethereum/jsonrpc.ipc

On Mac OS:

~/Library/Ethereum/geth.ipc

~/Library/Application Support/io.parity.ethereum/jsonrpc.ipc

On Windows:

.pipegeth.ipc

.pipejsonrpc.ipc

 class web3.providers.websocket.WebsocketProvider(endpoint_uri[, websocket_kwargs])

此通信服務(wù)提供接口程序處理與基于WS或WSS的JSON-RPC服務(wù)器的交互。

endpoint_uri應(yīng)該是RPC端點(diǎn)的完整URI，例如ws://localhost:8546。

websocket_kwargs應(yīng)該是關(guān)鍵字參數(shù)的字典，它將被傳遞到ws/wss websocket連接。

>>> from web3 import Web3
>>> web3 = Web3(Web3.WebsocketProvider("ws://127.0.0.1:8546"))

WebsocketProvider使用python websockets庫來發(fā)出請求。如果你想修改請求的方式，可以使用websocket_kwargs來執(zhí)行此操作。一個常見的用例是增加每個請求的超時(shí)。

>>> from web3 import Web3
>>> web3 = Web3(Web3.WebsocketProvider("http://127.0.0.1:8546", websocket_kwargs={"timeout": 60}))

分享個的交互式在線編程實(shí)戰(zhàn)教程：

python以太坊，主要是針對python工程師使用web3.py進(jìn)行區(qū)塊鏈以太坊開發(fā)的詳解。

這里是原文