1. 為什么我在2024年選擇Substrate搭鏈而不是從零開發(fā)或直接fork其他鏈1.1 先說結(jié)論Substrate解決的是“業(yè)務(wù)鏈長期演進(jìn)”這件事我大概從2023年下半年開始密集評估區(qū)塊鏈底層方案當(dāng)時(shí)接了一個(gè)偏業(yè)務(wù)性質(zhì)的項(xiàng)目要把一套存證確權(quán)加積分流轉(zhuǎn)的邏輯搬到鏈上同時(shí)又要保證后續(xù)能不斷加新功能而不是上線即凍結(jié)。評估了一圈之后最后選定了Substrate這個(gè)決定到今天回看依然不后悔。Substrate給我的第一印象是它特別不像傳統(tǒng)意義上的“公鏈代碼庫”。Parity Team維護(hù)的這套框架本質(zhì)上是把區(qū)塊鏈公共組件——存儲(chǔ)、P2P網(wǎng)絡(luò)、共識(shí)、交易隊(duì)列、運(yùn)行時(shí)執(zhí)行環(huán)境——全部模塊化讓你能用搭積木的方式快速產(chǎn)出一條鏈。它不是一個(gè)給你“現(xiàn)成產(chǎn)品”的項(xiàng)目而是一套“生產(chǎn)工具”。這也是為什么很多團(tuán)隊(duì)會(huì)用“Substrate搭一條鏈”而不是“抄一份鏈代碼”來形容這個(gè)過程。不過我在這里要強(qiáng)調(diào)一點(diǎn)選Substrate不等于選Polkadot。雖然兩者關(guān)系緊密但Substrate可以獨(dú)立使用你可以跑出完全屬于自己的單鏈不接Polkadot中繼鏈不用Polkadot的代幣經(jīng)濟(jì)模型。這一點(diǎn)對內(nèi)部項(xiàng)目、聯(lián)盟鏈、私有業(yè)務(wù)鏈特別友好。很多人誤以為用了Substrate就要發(fā)幣、接波卡生態(tài)事實(shí)上完全可以切成 solo chain 模式自由度高得多。我最終敲定用Substrate核心原因是三個(gè)第一鏈上升級不需要硬分叉第二業(yè)務(wù)邏輯以pallet形式拆分模塊間邊界清晰第三Rust實(shí)現(xiàn)的性能和工程化成熟度在區(qū)塊鏈框架里屬于第一梯隊(duì)。接下來這幾段我會(huì)圍繞這三點(diǎn)展開把這些年的實(shí)踐過程記錄下來也給想入坑Substrate的朋友一些能直接用的經(jīng)驗(yàn)。1.2 為什么我堅(jiān)決排除了“從零開發(fā)”和“fork一條現(xiàn)成鏈”先說從零開發(fā)。區(qū)塊鏈最麻煩的不是鏈本身而是那些容易被忽略的周邊網(wǎng)絡(luò)層、序列化、密碼學(xué)、存儲(chǔ)引擎、共識(shí)協(xié)議、P2P同步、交易池。真要自己寫光是把區(qū)塊同步和雙花防護(hù)做對就足夠燒掉大半年人力。而且即便你把主線功能跑通了安全性驗(yàn)證又是另一座山。業(yè)務(wù)團(tuán)隊(duì)真正需要的是把業(yè)務(wù)邏輯放在鏈上而不是花一年時(shí)間證明你的共識(shí)實(shí)現(xiàn)沒有bug。也有團(tuán)隊(duì)喜歡直接用EVM兼容鏈比如fork一份geth或者基于某種現(xiàn)成鏈改。這個(gè)方案對“純智能合約”的業(yè)務(wù)確實(shí)省事但如果業(yè)務(wù)上需要自定義密碼學(xué)、自定義存儲(chǔ)結(jié)構(gòu)、自定義共識(shí)規(guī)則、自定義出塊邏輯你會(huì)發(fā)現(xiàn)智能合約抽象限制非常多。最典型的問題是合約只能跑在沙箱環(huán)境里訪問不到鏈層狀態(tài)定價(jià)、存儲(chǔ)模型、手續(xù)費(fèi)機(jī)制都受制于底層實(shí)現(xiàn)能做定制化的空間非常有限。這種時(shí)候Substrate的“framework”定位就顯得非常合適。它把最復(fù)雜的底層封裝好了同時(shí)把業(yè)務(wù)層徹底開放給你。你沒必要關(guān)心P2P網(wǎng)絡(luò)細(xì)節(jié)但你有權(quán)決定一條交易怎么處理、一個(gè)存儲(chǔ)項(xiàng)怎么組織、一個(gè)區(qū)塊的weight怎么計(jì)算。用我們工程上的話講它把“可替換部分”和“不可替換部分”分得很清楚。1.3 Substrate最打動(dòng)我的是哪三個(gè)設(shè)計(jì)先說無分叉升級。傳統(tǒng)鏈一旦部署邏輯代碼就凍結(jié)在創(chuàng)世區(qū)塊里想改業(yè)務(wù)邏輯只能通過硬分叉協(xié)調(diào)全節(jié)點(diǎn)升級。而Substrate把鏈的“業(yè)務(wù)邏輯”放進(jìn)了RuntimeRuntime是一個(gè)Wasm blob存在鏈上。于是升級變成了一次普通鏈上調(diào)用只要治理機(jī)制通過調(diào)用set_code就可以換上新的Runtime邏輯普通節(jié)點(diǎn)會(huì)自動(dòng)同步到新區(qū)塊并執(zhí)行新邏輯。聽起來像魔法但它就是這么運(yùn)作的。對一個(gè)需要持續(xù)迭代的業(yè)務(wù)系統(tǒng)來說這個(gè)能力可以說是“續(xù)命”級別的。第二點(diǎn)是pallet機(jī)制。pallet可以理解成Substrate里的“業(yè)務(wù)模塊插件”一個(gè)存儲(chǔ)定義、一組事件、一組調(diào)用函數(shù)打包成一個(gè)獨(dú)立的Rust模塊。Substrate官方提供了幾十個(gè)pallet比如Balances、Staking、Session、Sudo、Treasury業(yè)務(wù)上排名靠前的社區(qū)也都貢獻(xiàn)了。自己的業(yè)務(wù)邏輯只要照著pallet的規(guī)范寫就能像插USB設(shè)備一樣把它集成進(jìn)Runtime。模塊內(nèi)部可以獨(dú)立測試模塊間還可以用Config接口做依賴解耦工程體驗(yàn)非常舒服。第三點(diǎn)是共識(shí)的可插拔性。Substrate支持Aura、Babe、Grandpa、PoW等多種共識(shí)方案還能混合使用。我在項(xiàng)目初期用Aura加Grandpa跑后面切到Babe加Grandpa做更復(fù)雜的出塊策略整個(gè)切換并沒有傷筋動(dòng)骨。對業(yè)務(wù)場景來說有好幾種共識(shí)選項(xiàng)兜底就不用被鎖死在某一種設(shè)計(jì)上。2. Substrate核心設(shè)計(jì)拆解Runtime、FRAME和pallet是如何協(xié)作的2.1 節(jié)點(diǎn)殼與Runtime先分清“外面”和“里面”Substrate的架構(gòu)我習(xí)慣用“殼”和“核”來理解。殼就是節(jié)點(diǎn)客戶端負(fù)責(zé)網(wǎng)絡(luò)同步、交易池、數(shù)據(jù)庫存儲(chǔ)、RPC接口和共識(shí)引擎等外部工作。核心則是Runtime也就是鏈上狀態(tài)機(jī)的業(yè)務(wù)規(guī)則它被編譯成Wasm字節(jié)碼后被節(jié)點(diǎn)加載執(zhí)行。節(jié)點(diǎn)殼和Runtime之間通過一套Host接口通信比如讀寫鏈上存儲(chǔ)、調(diào)用指定函數(shù)等。這種“殼核分離”最大的好處是Runtime升級后節(jié)點(diǎn)客戶端完全不需要重新編譯。舊的節(jié)點(diǎn)只需同步新的Runtime Wasm并通過執(zhí)行環(huán)境運(yùn)行新的業(yè)務(wù)邏輯即可。也就是說你不用催促全網(wǎng)節(jié)點(diǎn)手動(dòng)升級軟件業(yè)務(wù)升級就能生效。這在整個(gè)區(qū)塊鏈系統(tǒng)設(shè)計(jì)里就是顛覆性的思路。從開發(fā)視角看Runtime代碼不直接跑在物理CPU上而是通過Wasm解釋器或JIT執(zhí)行。這意味著你不僅不能用標(biāo)準(zhǔn)庫里的std能力連浮點(diǎn)數(shù)都要小心不同Wasm運(yùn)行時(shí)對浮點(diǎn)運(yùn)算的舍入行為可能不同。這也是為什么Substrate的pallet源碼里文件開頭經(jīng)常能看到#![cfg_attr(not(feature std), no_std)]這樣的聲明。它告訴編譯器當(dāng)作為鏈上Runtime編譯時(shí)不要鏈接標(biāo)準(zhǔn)庫只用core子集。2.2 FRAME用宏把業(yè)務(wù)代碼變成鏈上模塊FRAME是Substrate上最常用的一套R(shí)untime構(gòu)建框架它通過一系列過程宏procedural macro來批量生成樣板代碼。你只需要寫業(yè)務(wù)關(guān)心的部分比如存儲(chǔ)項(xiàng)、事件、調(diào)用函數(shù)、錯(cuò)誤類型其余的模塊注冊、事件分發(fā)、存儲(chǔ)讀寫接口宏都會(huì)幫你生成。舉個(gè)例子在Substrate上寫一個(gè)“篡改審計(jì)”pallet最核心的代碼大概分為這么幾塊#[pallet::config]定義pallet對外需要的配置項(xiàng)和依賴的類型比如事件類型、外部賬戶類型。#[pallet::storage]定義鏈上存儲(chǔ)結(jié)構(gòu)可以用StorageValue存單個(gè)值StorageMap存鍵值映射StorageDoubleMap存雙層映射。#[pallet::event]定義業(yè)務(wù)事件比如“某賬戶寫入了一條存證”。#[pallet::call]定義可被外部觸發(fā)的函數(shù)即鏈上業(yè)務(wù)接口。#[pallet::error]定義業(yè)務(wù)錯(cuò)誤類型方便調(diào)用方理解失敗原因。這個(gè)模式對后端工程師來說很友好因?yàn)楸举|(zhì)上它就像寫一個(gè)面向接口的Rust服務(wù)只不過持久化層由Substrate的存儲(chǔ)封裝好了并發(fā)安全也由Runtime執(zhí)行環(huán)境保證了。你基本不用考慮數(shù)據(jù)庫事務(wù)問題因?yàn)槊看握{(diào)用函數(shù)要么完整執(zhí)行成功要么結(jié)果全部回滾——和數(shù)據(jù)庫事務(wù)的原子性一個(gè)道理。2.3 無分叉升級為什么能改變鏈的運(yùn)營方式傳統(tǒng)項(xiàng)目的升級流程是發(fā)版、協(xié)調(diào)全節(jié)點(diǎn)、等待社區(qū)跟進(jìn)、切到新邏輯。Substrate只要求你有合適的“鏈上治理”流程。一個(gè)常見的實(shí)踐是用Sudo pallet設(shè)一個(gè)超級管理員賬戶來調(diào)用set_code完成Runtime替換。更成熟的做法是用Democracy pallet組織鏈上投票票數(shù)通過后自動(dòng)執(zhí)行升級。我在實(shí)際項(xiàng)目中早期用的是Sudo模式因?yàn)閳F(tuán)隊(duì)還在快速迭代每天可能升級兩三次。等業(yè)務(wù)穩(wěn)定后再引入多簽治理或民主投票機(jī)制。這里有個(gè)經(jīng)驗(yàn)升級前一定要備份鏈上狀態(tài)并且在小范圍測試網(wǎng)絡(luò)里演練一遍全套升級動(dòng)作。雖然Substrate升級本身是“輕量”的但你的業(yè)務(wù)數(shù)據(jù)遷移邏輯如果寫成鏈上函數(shù)那它有bug同樣會(huì)讓整條鏈進(jìn)入不健康狀態(tài)。升級方案簡單不等于可以不做預(yù)案。另外升級時(shí)還要注意Runtime版本號(hào)的維護(hù)。Substrate在Runtime中有一個(gè)RuntimeVersion結(jié)構(gòu)包含specific_version、impl_name、authoring_version等字段。這些字段不只是抬顯客戶端會(huì)依據(jù)它們判斷是否需要執(zhí)行狀態(tài)遷移State Migration。版本號(hào)不更新可能導(dǎo)致升級后舊節(jié)點(diǎn)無法同步新邏輯或者客戶端直接從緩存里返回舊版本這種坑很隱蔽。3. 從零搭建并運(yùn)行第一條Substrate鏈環(huán)境準(zhǔn)備與工程結(jié)構(gòu)3.1 Rust工具鏈和Wasm編譯目標(biāo)Substrate開發(fā)基本綁定Rust所以第一步是裝好Rust工具鏈。我是用rustup管理的因?yàn)樵赟ubstrate項(xiàng)目里經(jīng)常需要切換stable和nightly工具鏈。Substrate本身要求nightly版本編譯Runtime原因是部分宏和編譯器特性還沒有完全穩(wěn)定到stable。我這里給一份安裝流程直接復(fù)制粘貼可以跑curl --proto https --tlsv1.2 -sSf https://sh.rustup.rs | sh rustup default stable rustup toolchain install nightly-2024-03-01 rustup target add wasm32-unknown-unknown --toolchain nightly-2024-03-01注意后面的版本號(hào)建議你打開Substrate官方倉庫的rust-toolchain.toml確認(rèn)推薦的nightly版本不要隨意裝最新。因?yàn)镽ust編譯器偶爾有回歸Substrate生態(tài)里最穩(wěn)妥的做法是鎖定官方驗(yàn)證過的某一天版本。我吃過一次虧用了一個(gè)很新的nightly結(jié)果編譯Wasm時(shí)報(bào)了一堆宏展開錯(cuò)誤后來回退到官方指定版本就好了。裝完工具鏈后還需要安裝一些系統(tǒng)依賴比如Ubuntu上需要clang、libssl-dev、protobuf-compiler。這些主要是編譯節(jié)點(diǎn)二進(jìn)制和生成RPC代碼需要的。如果是macOS一般只需要確保Xcode Command Line Tools裝好。3.2 用node-template快速起項(xiàng)目初始化項(xiàng)目建議直接用官方模板省去自己配構(gòu)建腳本的時(shí)間。Substrate官方維護(hù)了幾個(gè)模板倉庫最簡單的是substrate-node-template。clone下來后目錄結(jié)構(gòu)里最關(guān)鍵的是pallets目錄和runtime目錄前者放業(yè)務(wù)pallet后者負(fù)責(zé)把pallet組合成完整的鏈。git clone -b latest --depth 1 https://github.com/substrate-developer-hub/substrate-node-template cd substrate-node-template cargo build --release首次編譯會(huì)非常久我印象中在一臺(tái)8核的機(jī)器上要半小時(shí)以上主要是在編譯幾百個(gè)依賴項(xiàng)目。如果你只是想快速驗(yàn)證可以先用cargo check來檢查代碼能不能過編譯速度會(huì)快很多。真正需要跑節(jié)點(diǎn)的時(shí)候再執(zhí)行release編譯。編譯完成之后模板里自帶了一個(gè)最簡單的runtime包含Balances、Sudo、Template pallet等初始模塊。它默認(rèn)跑的是dev配置開發(fā)者不需要配置創(chuàng)世驗(yàn)證者就能直接啟動(dòng)。3.3 啟動(dòng)節(jié)點(diǎn)和前端調(diào)試臺(tái)的完整過程本地啟動(dòng)節(jié)點(diǎn)很簡單./target/release/node-template --dev --tmp--dev表示單節(jié)點(diǎn)開發(fā)模式--tmp表示臨時(shí)存儲(chǔ)重啟后數(shù)據(jù)清空。跑起來后你會(huì)看到終端持續(xù)打印出塊日志說明節(jié)點(diǎn)已經(jīng)開始出塊了。這時(shí)候需要有前端工具來交互。官方提供了substrate-front-end-template它基于React和polkadot.js API用起來非常方便git clone -b latest --depth 1 https://github.com/substrate-developer-hub/substrate-front-end-template cd substrate-front-end-template yarn yarn start啟動(dòng)前端后它會(huì)默認(rèn)連接本地節(jié)點(diǎn)的ws://127.0.0.1:9944。你可以在頁面上查余額、發(fā)交易、調(diào)用runtime的extrinsic還能看鏈上事件和存儲(chǔ)的變化。這個(gè)工具在調(diào)試階段幾乎是必需品因?yàn)楹芏喙?jié)點(diǎn)日志不會(huì)暴露的狀態(tài)變化在它上面一眼就能看到。我第一次跑通的時(shí)候其實(shí)有點(diǎn)驚訝于整個(gè)體系的成熟度一個(gè)空模板就能讓你直接在瀏覽器里操作鏈上狀態(tài)后面寫業(yè)務(wù)pallet時(shí)每次新增一個(gè)extrinsic前端模板幾乎不需要改動(dòng)就能調(diào)用到。這對團(tuán)隊(duì)里不熟Rust的同事非常友好他們可以用前端快速驗(yàn)證功能。4. 手寫第一個(gè)業(yè)務(wù)pallet從需求到鏈上邏輯落地4.1 先設(shè)計(jì)業(yè)務(wù)再寫存儲(chǔ)存證場景的建模過程業(yè)務(wù)pallet聽起來高大上但落到代碼層面其實(shí)就是把業(yè)務(wù)規(guī)則翻譯成“存儲(chǔ) 調(diào)用函數(shù) 事件”。我在第一個(gè)實(shí)戰(zhàn)項(xiàng)目里寫的是一個(gè)簡單的存證pallet用戶提交數(shù)據(jù)的哈希值鏈上保存哈希、提交賬戶和提交時(shí)間任何人可以驗(yàn)證某條數(shù)據(jù)在某個(gè)時(shí)間點(diǎn)已經(jīng)存在過。存儲(chǔ)設(shè)計(jì)很直接我用的是一張StorageMap#[pallet::storage] #[pallet::getter(fn evidence_digest)] pub type EvidenceStoreT: Config StorageMap_, Blake2_128Concat, Vecu8, (T::AccountId, BlockNumberForT);存儲(chǔ)結(jié)構(gòu)里digest是值賬戶和塊號(hào)用來記錄提交者和提交時(shí)間。之所以用Blake2_128Concat哈希key是因?yàn)樗m合隨機(jī)key分布且能提供部分key信息避免遍歷時(shí)的額外成本。設(shè)計(jì)存儲(chǔ)時(shí)一定要想清楚未來會(huì)不會(huì)按某個(gè)維度查詢會(huì)不會(huì)有刪除操作會(huì)不會(huì)有數(shù)據(jù)增長上限存證場景數(shù)據(jù)只增不減所以我沒有做清理邏輯后續(xù)如果擔(dān)心膨脹再通過鏈上治理加一個(gè)歸檔機(jī)制即可。4.2 代碼落地存儲(chǔ)、事件、錯(cuò)誤與調(diào)用函數(shù)pallet的核心代碼我盡量寫得精簡實(shí)際開發(fā)時(shí)可以按自己風(fēng)格組織。下面是我項(xiàng)目里一個(gè)簡化版的核心邏輯#![cfg_attr(not(feature std), no_std)] pub use pallet::*; #[frame_support::pallet] pub mod pallet { use frame_support::pallet_prelude::*; use frame_system::pallet_prelude::*; #[pallet::config] pub trait Config: frame_system::Config { type RuntimeEvent: IsTypeSelf as frame_system::Config::RuntimeEvent; } #[pallet::pallet] #[pallet::generate_store(pub(super) trait Store)] pub struct PalletT(_); #[pallet::storage] #[pallet::getter(fn evidence_digest)] pub type EvidenceStoreT: Config StorageMap_, Blake2_128Concat, Vecu8, (T::AccountId, BlockNumberForT); #[pallet::event] #[pallet::generate_deposit(pub(super) fn deposit_event)] pub enum EventT: Config { EvidenceStored { who: T::AccountId, digest: Vecu8, block: BlockNumberForT }, } #[pallet::error] pub enum ErrorT { ExistingEvidence, } #[pallet::call] implT: Config PalletT { #[pallet::weight(10_000)] pub fn store_evidence( origin: OriginForT, digest: Vecu8, ) - DispatchResult { let who ensure_signed(origin)?; ensure!(!EvidenceStore::T::contains_key(digest), Error::T::ExistingEvidence); let block frame_system::Pallet::T::block_number(); EvidenceStore::T::insert(digest, (who.clone(), block)); Self::deposit_event(Event::EvidenceStored { who, digest, block }); Ok(()) } } }這個(gè)調(diào)用的邏輯就是標(biāo)準(zhǔn)的三步確認(rèn)調(diào)用者身份、檢查數(shù)據(jù)是否重復(fù)、寫入存儲(chǔ)并發(fā)出事件。事件在Substrate里不只是日志它是客戶端追蹤鏈上變化的主要途徑所以業(yè)務(wù)上重要?jiǎng)幼饕欢ㄒl(fā)出事件方便前端和索引服務(wù)監(jiān)聽。有兩點(diǎn)是新手容易漏的。第一是ensure_signed如果沒有這一步任何人都能以無簽名方式調(diào)用這個(gè)函數(shù)安全模型直接崩掉。第二是存儲(chǔ)key的哈希方式我選的是Blake2_128Concat如果業(yè)務(wù)key本身有規(guī)律切忌用Twox64Concat那個(gè)哈希強(qiáng)度弱容易被人為制造碰撞。4.3 集成進(jìn)Runtime并跑通測試pallet寫好后要把它“插”進(jìn)runtime主要改兩個(gè)文件。一個(gè)是runtime/src/lib.rs需要在construct_runtime!宏里注冊模塊同時(shí)給pallet配置Config接口impl pallet_evidence::Config for Runtime { type RuntimeEvent RuntimeEvent; }然后是construct_runtime!宏中添加一行Evidence: pallet_evidence,編譯完成后用前面提到的前端模板就能看到新增的evidence.storeEvidence調(diào)用。首次集成時(shí)如果報(bào)錯(cuò)多半是Config接口的類型沒對齊尤其是RuntimeEvent和RuntimeOrigin這兩個(gè)關(guān)聯(lián)類型很多新手在這里卡住。其實(shí)它們都是編譯期檢查只要根據(jù)編譯器提示逐項(xiàng)補(bǔ)齊就行。測試方面Substrate推薦在pallet內(nèi)建單元測試用sp_io::TestExternalities模擬運(yùn)行時(shí)環(huán)境。一個(gè)最簡單的測試是先創(chuàng)建測試外部環(huán)境用new_test_ext()初始化存儲(chǔ)然后調(diào)用store_evidence斷言事件是否正確發(fā)出。寫測試的過程本身也是在加深對pallet執(zhí)行流程的理解。這里我多說一句不要跳過測試就急著上鏈。鏈上邏輯一旦部署很難像傳統(tǒng)服務(wù)那樣隨便回滾。pallet級別的mock測試成本很低但能擋掉大部分低級錯(cuò)誤比如存儲(chǔ)key寫錯(cuò)、事件類型不匹配、權(quán)限校驗(yàn)缺失?？蚣芗壍臏y試工具已經(jīng)給你準(zhǔn)備好了不用白不用。5. 鏈級定制與升級實(shí)操共識(shí)、創(chuàng)世配置和鏈上升級5.1 不同共識(shí)方案的取舍Aura、Babe與Grandpa怎么選Substrate的一個(gè)優(yōu)勢就是共識(shí)可插拔。實(shí)際開發(fā)中我遇到過三種情況正好對應(yīng)三種常見選擇。第一種是內(nèi)部開發(fā)鏈或測試鏈驗(yàn)證者少、可信度高直接用Aura最省事。Aura就是輪流出塊每個(gè)驗(yàn)證者按照名單順序依次生產(chǎn)區(qū)塊邏輯簡單延遲低調(diào)試也很直觀。第二種是公鏈或半去中心化鏈希望出塊更均勻、抗惡意驗(yàn)證者那就用Babe作為出塊引擎。Babe通過VRF隨機(jī)選擇出塊者每個(gè)slot可能有多個(gè)候選也可能一個(gè)都沒有所以通常還要配合延遲出塊機(jī)制來提高穩(wěn)定性。它的代碼復(fù)雜度比Aura高一截但更貼近真實(shí)公鏈的生態(tài)預(yù)期。第三種是所有鏈都必須搭配的確定性終結(jié)工具Substrate里常見的是Grandpa。Babe或Aura負(fù)責(zé)“出塊”Grandpa負(fù)責(zé)“最終確認(rèn)”。只有Grandpa確認(rèn)過的區(qū)塊才不可回滾。所以一般配置是“Aura/Babe Grandpa”組合單獨(dú)只跑Babe或Aura是不完整的因?yàn)闀?huì)面臨鏈分叉時(shí)無法確定哪條是規(guī)范鏈的問題。我在模板里看到默認(rèn)配置就是Aura Grandpa作為起步非常合理。如果團(tuán)隊(duì)目標(biāo)不是做公鏈完全可以只用Aura單節(jié)點(diǎn)甚至跑一個(gè)“許可網(wǎng)絡(luò)”——只有通過驗(yàn)證的節(jié)點(diǎn)才能參與共識(shí)這在企業(yè)場景里很常用。5.2 創(chuàng)世配置與本地多節(jié)點(diǎn)組網(wǎng)節(jié)點(diǎn)的創(chuàng)世配置位于chain_spec.rs文件中。模板默認(rèn)提供的是development_config()和local_testnet_config()兩個(gè)函數(shù)。我一開始以為多節(jié)點(diǎn)組網(wǎng)很復(fù)雜后來發(fā)現(xiàn)關(guān)鍵是改這幾項(xiàng)name和id鏈的名稱和標(biāo)識(shí)所有節(jié)點(diǎn)必須一致。chain_type設(shè)置為Local或Custom不能是Development否則驗(yàn)證者數(shù)量會(huì)被外部強(qiáng)行限制。session相關(guān)key為每個(gè)初始驗(yàn)證者生成Aura和Grandpa的key。endowed_accounts預(yù)置賬戶余額方便測試交易。用本地多節(jié)點(diǎn)測試時(shí)我一般先起第一個(gè)節(jié)點(diǎn)./target/release/node-template --chain local --validator --alice --tmp再起第二個(gè)節(jié)點(diǎn)并讓它連接到第一個(gè)節(jié)點(diǎn)的p2p地址./target/release/node-template --chain local --validator --bob --tmp \ --bootnodes /ip4/127.0.0.1/tcp/30333/p2p/alice-node-id這里需要從第一個(gè)節(jié)點(diǎn)日志里找到真實(shí)節(jié)點(diǎn)ID然后替換進(jìn)去。依賴操作時(shí)需要多嘗試幾次因?yàn)樗蕾嘝2P握手成功后驗(yàn)證者集合才真正開始協(xié)作。如果日志里出現(xiàn)“cannot finalize”之類的報(bào)錯(cuò)八成是驗(yàn)證者key配置不全或者兩個(gè)節(jié)點(diǎn)用的chain_spec不一致。5.3 用sudo調(diào)set_code做運(yùn)行時(shí)升級這是Substrate最吸引人的能力。我用最原始的方式演示一遍先把新Runtime編譯成Wasm然后通過sudo pallet的setCode調(diào)用把新代碼上傳到鏈上。操作流程大概是這樣的修改pallet代碼更新RuntimeVersion里的specific_version。重新執(zhí)行cargo build --release生成新的Wasm二進(jìn)制。在前端模板里找到sudo.sudo調(diào)用填寫參數(shù)目標(biāo)方法為system.setCode代碼內(nèi)容選擇剛才生成的wasm文件通常是target/release/wbuild/node-template-runtime/node_template_runtime.compact.wasm。提交交易等待出塊之后鏈就會(huì)執(zhí)行新邏輯。我第一次做的時(shí)候提心吊膽擔(dān)心萬一新Runtime有bug就把鏈跑掛了。后來發(fā)現(xiàn)測試階段真的出現(xiàn)了類似情況我的處理方法是保持舊節(jié)點(diǎn)的數(shù)據(jù)庫備份必要時(shí)直接刪除本地?cái)?shù)據(jù)重新同步。鏈上治理早期可以給sudo設(shè)置多簽任何人不能單獨(dú)升級。等業(yè)務(wù)成熟后再切換到民主投票這樣操作更穩(wěn)。這里必須提醒不要忽略RuntimeVersion更新。很多新手升級后鏈直接不認(rèn)賬就是因?yàn)樾屡f版本號(hào)一模一樣客戶端緩存了舊Wasm拒絕重新執(zhí)行。這個(gè)字段就是Substrate區(qū)分“是否更新”的關(guān)鍵標(biāo)記。6. 跑完一輪后我留下的幾條經(jīng)驗(yàn)與避坑總結(jié)6.1 編譯期最容易摔的跟頭第一次編譯Substrate項(xiàng)目我差點(diǎn)被自己逼瘋問題幾乎都集中在環(huán)境上。最大的坑是Rust nightly版本不對。Substrate的宏展開非常依賴rustc內(nèi)部行為版本差異可能導(dǎo)致宏直接展開失敗。所以一定要用倉庫里rust-toolchain.toml指定的版本不要自己隨手裝一個(gè)。我在三臺(tái)不同環(huán)境上測試過遵循指定版本是復(fù)現(xiàn)成功最關(guān)鍵的變量。第二個(gè)坑是Wasm目標(biāo)沒裝。Runtime編譯時(shí)要把Rust代碼編譯成Wasm這一步如果報(bào)錯(cuò)target wasm32-unknown-unknown not found執(zhí)行rustup target add wasm32-unknown-unknown --toolchain nightly-version裝完后重新編譯。很多時(shí)候編譯失敗并不是代碼問題而是這個(gè)目標(biāo)缺失。第三個(gè)坑是磁盤空間。一個(gè)release構(gòu)建加緩存的依賴輕輕松松吃掉20GB以上。開發(fā)機(jī)至少預(yù)留50GB不然編譯到一半磁盤寫滿非常崩潰。6.2 運(yùn)行期存儲(chǔ)、Weight與調(diào)試手段運(yùn)行期最容易出問題的一個(gè)是存儲(chǔ)設(shè)計(jì)一個(gè)是Weight計(jì)算。存儲(chǔ)上我見過不少新人把很長的文本直接塞進(jìn)StorageValue完全不管鏈上存儲(chǔ)的膨脹。鏈上存儲(chǔ)的讀寫成本遠(yuǎn)高于內(nèi)存或磁盤設(shè)計(jì)時(shí)應(yīng)該盡量只存精簡狀態(tài)和哈希引用。大文件數(shù)據(jù)放到鏈下存儲(chǔ)鏈上只放哈希。Weight也就是手續(xù)費(fèi)和計(jì)算資源配額直接寫固定值是最省事的但不合理。如果調(diào)用函數(shù)邏輯變復(fù)雜固定的低Weight可能導(dǎo)致交易永遠(yuǎn)無法打包或者更糟被惡意用戶濫用。Substrate提供了#[pallet::weight]注解方式配合計(jì)算函數(shù)來進(jìn)行復(fù)雜估算。初期不追求精確但一定要給一個(gè)合理上限后續(xù)再通過基準(zhǔn)測試優(yōu)化。調(diào)試方面我強(qiáng)烈建議用substrate-contracts-node和前端模板而不是只靠終端日志。前端模板能直接看到鏈上狀態(tài)變化、事件日志、交易詳情還能直接調(diào)用最新加入的extrinsic調(diào)試效率高一個(gè)量級。如果要更底層的調(diào)試試試在runtime里加log輸出或用frame_support::debug打印信息。運(yùn)行期的另一個(gè)坑是區(qū)塊生成的“時(shí)區(qū)感”。默認(rèn)Aura出塊時(shí)間是6秒你跨地域跑多節(jié)點(diǎn)時(shí)網(wǎng)絡(luò)延遲可能導(dǎo)致出塊不穩(wěn)定。當(dāng)時(shí)我調(diào)整了MinimumPeriod和出塊slot時(shí)長讓鏈適應(yīng)跨機(jī)房部署。6.3 給計(jì)劃用Substrate團(tuán)隊(duì)的幾條建議回顧整個(gè)周期我認(rèn)為如果團(tuán)隊(duì)要正式用Substrate做業(yè)務(wù)鏈有幾件事最好在早期就想清楚。一是不要貪多。Substrate官方的pallet非常豐富但每引入一個(gè)pallet就會(huì)增加runtime體積和治理復(fù)雜度。初期能用最小集解決問題就盡量保持精簡Balances、Sudo、System加上你自己的業(yè)務(wù)pallet足夠了。二是升級設(shè)計(jì)要提前。既然Substrate支持無分叉升級那業(yè)務(wù)上就要設(shè)計(jì)好“舊數(shù)據(jù)兼容策略”比如存儲(chǔ)key變更時(shí)的遷移函數(shù)。不要等上線后再去想。三是多節(jié)點(diǎn)多環(huán)境測試一定要前置。我見過太多項(xiàng)目在開發(fā)機(jī)上跑得漂亮一上測試網(wǎng)就出各種共識(shí)問題。本地至少要從三節(jié)點(diǎn)起驗(yàn)證賬本一致性和重啟穩(wěn)定性。最后對團(tuán)隊(duì)現(xiàn)有的技術(shù)棧要做個(gè)判斷。Substrate開發(fā)依賴Rust和宏編程團(tuán)隊(duì)里至少要有兩位能看懂Rust宏的成員否則后期遇到宏報(bào)錯(cuò)會(huì)很痛苦。如果團(tuán)隊(duì)是Java或Go背景也不是不能用只是要提前預(yù)留學(xué)習(xí)時(shí)間Rust的所有權(quán)模型和trait系統(tǒng)跟常見后端語言差異很大。如果用一句話總結(jié)我的體會(huì)就是Substrate不是一條鏈而是一套搭鏈的基礎(chǔ)設(shè)施它把“自定義區(qū)塊鏈”的門檻從底層協(xié)議拉低到了業(yè)務(wù)模塊層。只要你能設(shè)計(jì)好業(yè)務(wù)pallet剩下的大部分臟活累活框架已經(jīng)幫你扛了一半。那些在草稿里反復(fù)斟酌存儲(chǔ)字段的夜晚在編譯Wasm時(shí)等得發(fā)慌的幾分鐘以及終于看到自己寫的pallet在瀏覽器前端被調(diào)用成功那一刻都是這條技術(shù)路線上很真實(shí)的記憶。如果你也在評估Substrate我的建議是別只看文檔直接拿一個(gè)最小的業(yè)務(wù)場景從模板開始跑通一遍。跑通之后你自己就會(huì)知道它到底適不適合你的業(yè)務(wù)。