EOS狀態處理程式demux-js
Demux是一種後端基礎架構模式,用於處理區塊鏈事件,以便確定性地更新可查詢資料儲存並觸發side effects。Demux.js庫用作該模式的參考實現,可以與Node應用程式一起使用。
安裝
# Using yarn yarn add demux # Using npm npm install demux --save
概述
從 Flux Architecture 模式和 Redux 中汲取靈感,Demux誕生於以下資格:
- 區塊鏈中狀態如何存在與客戶端前端如何查詢之間關注點的分離。
- 客戶端前端不僅僅負責確定派生,還有減少或累積的狀態。
- 區塊鏈事件能夠觸發新交易,以及區塊鏈之外的其他副作用。
- 區塊鏈是所有應用程式狀態的唯一真實來源。
分離的持久層
在區塊鏈上以索引狀態儲存資料可能有用,原因有三:計算結果的分散共識,其他區塊鏈計算中的狀態使用,以及客戶端前端使用狀態的查詢。在構建更復雜的前端時,直接從索引的區塊鏈狀態查詢時會遇到一些問題:
- 用於查詢索引資料的查詢介面是有限的。複雜的資料要求可能意味著你必須在客戶端上進行大量的查詢並處理資料,或者必須在區塊鏈本身上儲存其他衍生資料。擴充套件查詢負載意味著建立更多的區塊鏈端點節點,這可能非常昂貴。
- Demux通過將查詢解除安裝到你想要的任何持久層來解決這些問題。當區塊鏈事件發生時,你選擇的持久層將由
updater
函式更新,這些函式確定性地處理Action
物件陣列。然後,你的前端可以通過合適的API(例如,REST或GraphQL)查詢持久層。
這意味著我們可以將我們的問題分開:對於需要去中心化的計算共識或來自其他區塊鏈事件訪問的資料,我們仍然可以將資料儲存在索引的區塊鏈狀態中,而不必擔心定製到前端查詢。對於我們前端所需的資料,我們可以在我們選擇的可水平擴充套件的持久層中以一種易於查詢資料的方式預處理和索引資料。最終結果是兩個系統都能更有效地發揮其作用。
Side Effects
由於我們有一個確定性地處理特定區塊鏈事件的系統,我們也可以利用這個系統來管理非確定性事件。這些效果函式與 updater
函式幾乎完全相同,除非它們非同步執行,在延時期間不執行,並且修改確定性資料儲存區是禁止的。示例包括:簽署和廣播交易,傳送電子郵件以及啟動傳統的法定付款。
真正來源
對於上述問題還有其他解決方案涉及legacy持久層,這些legacy層是它們自己的真實來源。然而,通過從區塊鏈中獲得所有狀態,我們獲得了以下好處:
- 如果累積的資料儲存區丟失或刪除,則可以通過區塊鏈延時操作來重新生成。
- 只要應用程式程式碼是開源的,並且區塊鏈是公共的,就可以審計所有應用程式狀態。
- 無需維護多種更新狀態的方式(提交交易是唯一的方式)。
資料流向
- 1.客戶端將交易傳送到區塊鏈。
- 2.Action Watcher呼叫Action Reader來檢查新塊。
- 3.Action Reader在新塊中檢視交易,解析操作。
- 4.Action Watcher向Action Handler傳送操作。
- 5.Action Handler通過Updaters和Effects處理操作。
- 6.Actions會執行相應的Updaters,更新資料儲存區的狀態。
- 7.動作執行相應的效果,觸發外部事件。
- 8.客戶端查詢API以獲取更新的資料。
類實現
|Repository | Description| |—|—| | EOSIO / demux-js-eos | Action Reader implementations for EOSIO blockchains| | EOSIO / demux-js-postgres | Action Handler implementation for Postgres databases| | Zapata / demux-js-bitshares | Action Reader implementations for BitShares blockchain|
Block.one正式支援
要列出你的專案,請在此處新增並提交PR!
用法
該庫提供以下類:
- AbstractActionReader :用於實現自己的Action Readers的抽象類。
- AbstractActionHandler :用於實現自己的Action Handler的抽象類。
- BaseActionWatcher :實現即用型Action Watcher的基類。
- ExpressActionWatcher :通過Express伺服器公開BaseActionWatcher中的API方法。
為了處理操作,我們需要以下內容:
-
AbstractActionReader
的實現。 -
AbstractActionHandler
的實現。 - 至少一個
HandlerVersion
,包含Updater
和Effect
陣列。
有了它們之後,我們需要:
- 使用任何所需的配置例項化實現的
AbstractActionReader
。 - 例項化實現的
AbstractActionHandler
,傳入HandlerVersion
和任何其他所需的配置。 - 例項化
BaseActionWatcher
(或子類),傳入Action Handler
和Action Watcher
例項。 - 通過
Action Watcher的watch()
方法開始索引(通過直接呼叫或以其他方式呼叫)。
例子
const { BaseActionWatcher, ExpressActionWatcher } = require("demux") const { MyActionReader } = require("./MyActionReader") const { MyActionHandler } = require("./MyActionHandler") const { handlerVersions } = require("./handlerVersions") const { readerConfig, handlerConfig, pollInterval, portNumber } = require("./config") const actionReader = new MyActionReader(readerConfig) const actioHandler = new MyActionHandler(handlerVersions, handlerConfig)
然後,要麼這樣:
const watcher = new BaseActionWatcher( actionReader, actionHandler, pollInterval, ) watcher.watch()
或者,
const expressWatcher = new ExpressActionWatcher( actionReader, actionHandler, pollInterval, portNumber, ) expressWatcher.listen() // You can then make a POST request to `/start` on your configured endpoint
其他
======================================================================
分享一些以太坊、EOS、比特幣等區塊鏈相關的互動式線上程式設計實戰教程:
- java以太坊開發教程,主要是針對java和android程式設計師進行區塊鏈以太坊開發的web3j詳解。
- php以太坊,主要是介紹使用php進行智慧合約開發互動,進行賬號建立、交易、轉賬、代幣開發以及過濾器和交易等內容。
- python以太坊,主要是針對python工程師使用web3.py進行區塊鏈以太坊開發的詳解。
- 以太坊入門教程,主要介紹智慧合約與dapp應用開發,適合入門。
- 以太坊開發進階教程,主要是介紹使用node.js、mongodb、區塊鏈、ipfs實現去中心化電商DApp實戰,適合進階。
- C#以太坊,主要講解如何使用C#開發基於.Net的以太坊應用,包括賬戶管理、狀態與交易、智慧合約開發與互動、過濾器和交易等。
- EOS教程,本課程幫助你快速入門EOS區塊鏈去中心化應用的開發,內容涵蓋EOS工具鏈、賬戶與錢包、發行代幣、智慧合約開發與部署、使用程式碼與智慧合約互動等核心知識點,最後綜合運用各知識點完成一個便籤DApp的開發。
- java比特幣開發教程,本課程面向初學者,內容即涵蓋比特幣的核心概念,例如區塊鏈儲存、去中心化共識機制、金鑰與指令碼、交易與UTXO等,同時也詳細講解如何在Java程式碼中整合比特幣支援功能,例如建立地址、管理錢包、構造裸交易等,是Java工程師不可多得的比特幣開發學習課程。
- php比特幣開發教程,本課程面向初學者,內容即涵蓋比特幣的核心概念,例如區塊鏈儲存、去中心化共識機制、金鑰與指令碼、交易與UTXO等,同時也詳細講解如何在Php程式碼中整合比特幣支援功能,例如建立地址、管理錢包、構造裸交易等,是Php工程師不可多得的比特幣開發學習課程。
- tendermint區塊鏈開發詳解 ,本課程適合希望使用tendermint進行區塊鏈開發的工程師,課程內容即包括tendermint應用開發模型中的核心概念,例如ABCI介面、默克爾樹、多版本狀態庫等,也包括代幣發行等豐富的實操程式碼,是go語言工程師快速入門區塊鏈開發的最佳選擇。
匯智網原創翻譯,轉載請標明出處。這裡是 eos狀態處理程式demux-js