通信服務提供接口是web3如何與區塊鏈交互的關鍵。接口接受JSON-RPC請求並返回響應。這通常通過將請求提交給基於HTTP或IPC套接字的服務器來完成。
如果你已經愉快地連接到你的以太坊節點,那麼你可以跳過這部分內容。
選擇如何連接到你的節點
大多數節點都有多種連接方式。如果你尚未確定要使用哪種節點,請轉到如何選擇要使用的節點?
連接節點的最常用方法是:
- 1.IPC(使用本地文件系統:最快,最安全)
- 2.Websockets(遠程工作,比HTTP更快)
- 3.HTTP(更多節點支持它)
如果你不確定如何決定,請選擇以下方式:
- 如果你可以選擇在與節點相同的計算機上運行Web3.py,請選擇IPC。
- 如果必須連接到其他計算機上的節點,請使用Websockets。
- 如果你的節點不支持Websockets,請使用HTTP。
大多數節點都有“關閉”連接選項的方法。我們建議你關閉所有未使用的連接選項。這提供了更安全的設置:它減少了惡意黑客可以試圖竊取你的以太幣的方式。
確定連接後,可以使用通信服務提供接口Provider指定詳細信息。通信服務提供接口Provider程序是爲所需類型的連接配置的Web3.py類。
看這幾個:
- IPCProvider
- WebsocketProvider
- HTTPProvider
配置通信服務提供接口程序後,如:
from web3 import Web3
my_provider = Web3.IPCProvider('/my/node/ipc/path')
然後你就可以初始化Web3實例了,如下所示:
w3 = Web3(my_provider)
這樣,你就已準備好開始使用Web3.py.
自動與手動通信服務提供接口
如果未指定通信服務提供接口程序,Web3對象將在幾個標準位置查找以太坊節點。初始化時會發生自動檢測:
from web3.auto import w3
# which is equivalent to:
from web3 import Web3
w3 = Web3()
有時,web3無法自動檢測節點的位置。
- 如果你不確定使用哪種連接方法,請看上文。
- 如果你知道連接方法,但不知道連接所需的其他信息(如IPC文件的路徑),則需要在節點的配置中查找該信息。
- 如果你不確定使用的是哪個節點,請參閱如何選擇要使用的節點?。
要深入瞭解自動檢測的工作原理,請接着看:
自動檢測如何工作
Web3嘗試按以下順序連接到節點,使用它可以進行的第一個成功連接:
- 由環境變量指定的連接。
-
IPCProvider
,它查找幾個IPC文件位置。 -
HTTPProvider
,嘗試連接到http://localhost:8545
。 -
如果沒有提供者成功,你仍然可以使用不需要連接的Web3 API,例如:
- 類型轉化(Type Conversions)。
- 貨幣單位轉換(Currency Conversions)。
- 地址相關(Addresses)。
- 使用本地私鑰(Local Private Keys)。
- 等等。
使用自動檢測的示例
一些節點提供超出標準的API。有時,跨節點以不同方式提供相同的信息。如果要編寫跨多個節點工作的代碼,可能需要查找連接到的節點類型。
例如,以下內容檢索geth和parity的客戶端enode端點:
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
通過環境變量
或者,你可以在啓動腳本之前設置環境變量WEB3_PROVIDER_URI
,web3將首先查找這種方式。
此環境變量的有效格式爲:
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
要輕鬆連接到Infura Mainnet遠程節點,如果你沒有https://infura.io/signup,請先註冊免費的API密鑰。
然後使用你的API密鑰設置環境變量INFURA_API_KEY
:
$ export INFURA_API_KEY=YourApiKey
>>> from web3.auto.infura import w3
# confirm that the connection succeeded
>>> w3.isConnected()
True
Geth dev PoA
要使用默認值連接到geth --dev PoA(Proof-of-authority)實例:
>>> from web3.auto.gethdev import w3
# confirm that the connection succeeded
>>> w3.isConnected()
True
內置通信服務提供接口
Web3附帶以下通信服務提供接口程序,這些通信服務提供接口程序適用於連接到本地和遠程JSON-RPC服務器。
HTTPProvider
class web3.providers.rpc.HTTPProvider(endpoint_uri[, request_kwargs])
此通信服務提供接口程序處理與基於HTTP或HTTPS的JSON-RPC服務器的交互。
-
endpoint_uri
應該是RPC端點的完整URI,例如'https://localhost:8545'
。對於在端口80上運行的HTTP連接後面的RPC服務器和在端口443上運行的HTTPS連接,可以從URI中省略該端口。 -
request_kwargs
這應該是關鍵字參數的字典,它將被傳遞到http/https請求。
>>> from web3 import Web3
>>> web3 = Web3(Web3.HTTPProvider("http://127.0.0.1:8545"))
請注意,每個python進程只應創建一個HTTPProvider
,因爲HTTPProvider會回收底層TCP/IP網絡連接,以獲得更好的性能。
HTTPProvider使用python請求庫來發出請求。如果你想修改請求的方式,可以使用request_kwargs
來執行此操作。一個常見的用例是增加每個請求的超時。
>>> from web3 import Web3
>>> web3 = Web3(Web3.HTTPProvider("http://127.0.0.1:8545", request_kwargs={'timeout': 60}))
IPCProvider
web3.providers.ipc.IPCProvider(ipc_path=None, testnet=False, timeout=10)
此通信服務提供接口程序處理與基於IPC Socket的JSON-RPC服務器的交互。
-
ipc_path
是IPC套接字的文件系統路徑。: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
WebsocketProvider
class web3.providers.websocket.WebsocketProvider(endpoint_uri[, websocket_kwargs])
此通信服務提供接口程序處理與基於WS或WSS的JSON-RPC服務器的交互。
-
endpoint_uri
應該是RPC端點的完整URI,例如ws://localhost:8546
。 -
websocket_kwargs
應該是關鍵字參數的字典,它將被傳遞到ws/wss websocket
連接。
>>> from web3 import Web3
>>> web3 = Web3(Web3.WebsocketProvider("ws://127.0.0.1:8546"))
WebsocketProvider
使用python websockets庫來發出請求。如果你想修改請求的方式,可以使用websocket_kwargs
來執行此操作。一個常見的用例是增加每個請求的超時。
>>> from web3 import Web3
>>> web3 = Web3(Web3.WebsocketProvider("http://127.0.0.1:8546", websocket_kwargs={'timeout': 60}))
分享個的交互式在線編程實戰教程:
python以太坊,主要是針對python工程師使用web3.py進行區塊鏈以太坊開發的詳解。
這裏是原文