namechain 體驗(yàn)過程解析
nsd init <moniker> --chain-id=namechain
初始化配置文件和創(chuàng)世文件
生成文件結(jié)構(gòu)如下：
├── config
│ ├── app.toml
│ ├── config.toml
│ ├── genesis.json
│ ├── node_key.json
│ └── priv_validator_key.json
└── data
└── priv_validator_state.json
app.toml
minimum-gas-prices = ""
最小交易gas費(fèi)用
halt-height=0
暫停的區(qū)塊高度挟秤，用于升級(jí)（升級(jí)高度）或測(cè)試
halt-time=0
暫停的區(qū)塊時(shí)間峭判，到達(dá)該時(shí)間時(shí)暫停出塊，用于升級(jí)或測(cè)試
inter-block-cache = true
啟用 inter-block cache
pruning = "syncable"
state 存儲(chǔ)策略 (syncable, nothing, everything)
config.toml
advanced configuration options
proxy_app="tcp://127.0.0.1:26658"
ABCI socket 地址
moniker="namechain"
節(jié)點(diǎn)名稱
fast_sync=true
快速同步，允許并發(fā)下載區(qū)塊算柳，同時(shí)驗(yàn)證commit
db_backend="goleveldb"
數(shù)據(jù)庫(kù) (goleveldb | cleveldb | boltdb | rocksdb)
db_dir="data"
數(shù)據(jù)庫(kù)存放位置
log_level="main:info,state:info,*:error"
日志輸出
log_format="plain"
日志格式化
genesis_file="config/genesis.json"
創(chuàng)世文件位置媒役，包含 初始 validator 集合和其他元數(shù)據(jù)
priv_validator_key_file = "config/priv_validator_key.json"
validator 私鑰文件
priv_validator_state_file = "data/priv_validator_state.json"
存放 validator 最后的簽名狀態(tài)
priv_validator_laddr = ""
Tendermint 監(jiān)聽來自外部 validator 連接進(jìn)程的地址
node_key_file="config/node_key.json"
在 P2P 中進(jìn)行節(jié)點(diǎn)驗(yàn)證的私鑰
abci="socket"
abci 連接機(jī)制 (socket | grpc)
prof_laddr = "localhost:6060"
profiling server 監(jiān)聽地址
filter_peers = false
連接新節(jié)點(diǎn)時(shí)偿曙，是否查詢 ABCI 應(yīng)用
rpc server configuration options
laddr = "tcp://127.0.0.1:26657"
RPC server 監(jiān)聽地址
cors_allowed_origins = []
允許的跨域請(qǐng)求 origins
cors_allowed_methods = ["HEAD", "GET", "POST", ]
允許的跨域請(qǐng)求方法
cors_allowed_headers = ["Origin", "Accept", "Content-Type", "X-Requested-With", "X-Server-Time", ]
跨域請(qǐng)求中允許攜帶的請(qǐng)求頭
grpc_laddr = ""
grpc 監(jiān)聽地址
grpc_max_open_connections = 900
grpc 最大并發(fā)連接數(shù)
unsafe=false
是否允許非安全 RPC 命令
max_open_connections = 900
最大并發(fā)連接數(shù)
genesis.json
{
"genesis_time": "2020-03-23T10:04:56.163902Z",
"chain_id": "namechain",
"consensus_params": {
"block": {
"max_bytes": "22020096",
"max_gas": "-1",
"time_iota_ms": "1000"
},
"evidence": {
"max_age_num_blocks": "100000",
"max_age_duration": "172800000000000"
},
"validator": {
"pub_key_types": [
"ed25519"
]
}
},
"app_hash": "",
"app_state": {
"distribution": {
"params": {
"community_tax": "0.020000000000000000",
"base_proposer_reward": "0.010000000000000000",
"bonus_proposer_reward": "0.040000000000000000",
"withdraw_addr_enabled": true
},
"fee_pool": {
"community_pool": []
},
"delegator_withdraw_infos": [],
"previous_proposer": "",
"outstanding_rewards": [],
"validator_accumulated_commissions": [],
"validator_historical_rewards": [],
"validator_current_rewards": [],
"delegator_starting_infos": [],
"validator_slash_events": []
},
"genutil": {
"gentxs": []
},
"auth": {
"params": {
"max_memo_characters": "256",
"tx_sig_limit": "7",
"tx_size_cost_per_byte": "10",
"sig_verify_cost_ed25519": "590",
"sig_verify_cost_secp256k1": "1000"
},
"accounts": []
},
"staking": {
"params": {
"unbonding_time": "1814400000000000",
"max_validators": 100,
"max_entries": 7,
"historical_entries": 0,
"bond_denom": "stake"
},
"last_total_power": "0",
"last_validator_powers": null,
"validators": null,
"delegations": null,
"unbonding_delegations": null,
"redelegations": null,
"exported": false
},
"bank": {
"send_enabled": true
},
"nameservice": {
"whois_records": []
},
"params": null,
"slashing": {
"params": {
"signed_blocks_window": "100",
"min_signed_per_window": "0.500000000000000000",
"downtime_jail_duration": "600000000000",
"slash_fraction_double_sign": "0.050000000000000000",
"slash_fraction_downtime": "0.010000000000000000"
},
"signing_infos": {},
"missed_blocks": {}
},
"supply": {
"supply": []
}
}
}
nscli keys add jack
nscli keys add rose
創(chuàng)建兩個(gè)賬號(hào)龙亲，分別為 jack 和 rose，使用了 cosmos 內(nèi)置命令 keys
調(diào)用鏈
- nameservice/cmd/nscli/main.go#rootCmd.addCommand(keys.Commands())
- cosmos-sdk/client/keys/root.go
- cosmos-sdk/client/keys/add.go#AddKeyCommand()
nsd add-genesis-account $(nscli keys show jack -a) 100000000stake,1000000nametoken
nsd add-genesis-account $(nscli keys show rose -a) 1000000stake,10000nametoken
往 genesis.json 中添加創(chuàng)世賬號(hào)恳不，賬號(hào)需要包括地址和初始的幣
調(diào)用鏈
- nameservice/cmd/nsd/main.go#rootCmd.AddCommand(AddGenesisAccountCmd(ctx, cdc, app.DefaultNodeHome, app.DefaultCLIHome))
- nameservice/cmd/nsd/genaccounts.go#AddGenesisAccountCmd()
// 創(chuàng)建創(chuàng)世賬戶
genAccount = auth.NewBaseAccount(address, coins.Sort(), nil, 0, 0)
...
// 重入校驗(yàn)
if authGenState.Accounts.Contains(addr) {
return fmt.Errorf("cannot add account at existing address %s", addr)
}
...
// 添加到 state
authGenState.Accounts = append(authGenState.Accounts, genAccount)
authGenState.Accounts = auth.SanitizeGenesisAccounts(authGenState.Accounts)
...
// 更新到 appState
appState[auth.ModuleName] = authGenStateBz
...
// 寫入 genesis.json
genutil.ExportGenesisFile(genDoc, genFile)
genesis.json 文件中新增內(nèi)容
"accounts": [
{
"type": "cosmos-sdk/Account",
"value": {
"address": "cosmos1d8grdhlg87vnlz6ld22tcl9y3s04gl8sc57q4w",
"coins": [
{
"denom": "nametoken",
"amount": "1000000"
},
{
"denom": "stake",
"amount": "100000000"
}
],
"public_key": "",
"account_number": 0,
"sequence": 0
}
},
{
"type": "cosmos-sdk/Account",
"value": {
"address": "cosmos1zcdqgl4d0jk4vglg058r76hx5hspln2hnxrclv",
"coins": [
{
"denom": "nametoken",
"amount": "10000"
},
{
"denom": "stake",
"amount": "1000000"
}
],
"public_key": "",
"account_number": 0,
"sequence": 0
}
}
]
nscli config output json
nscli config indent true
nscli config trust-node true
nscli config chain-id namechain
nscli config
nsd gentx --name jack
: cosmos-sdk/x/genutil/client/cli/gentx.go
創(chuàng)建一筆創(chuàng)世交易, 交易生成在 /config/gentx/filename.json
{
"type": "cosmos-sdk/StdTx",
"value": {
"msg": [
{
"type": "cosmos-sdk/MsgCreateValidator",
"value": {
"description": {
"moniker": "namechain",
"identity": "",
"website": "",
"security_contact": "",
"details": ""
},
"commission": {
"rate": "0.100000000000000000",
"max_rate": "0.200000000000000000",
"max_change_rate": "0.010000000000000000"
},
"min_self_delegation": "1",
"delegator_address": "cosmos1d8grdhlg87vnlz6ld22tcl9y3s04gl8sc57q4w",
"validator_address": "cosmosvaloper1d8grdhlg87vnlz6ld22tcl9y3s04gl8saq24ea",
"pubkey": "cosmosvalconspub1zcjduepqvrd5ec72t07ajaextgk7z3ue5t9zakeuqr5m5x9qk7q8falt2szqkgl8z4",
"value": {
"denom": "stake",
"amount": "100000000"
}
}
}
],
"fee": {
"amount": [
],
"gas": "200000"
},
"signatures": [
{
"pub_key": {
"type": "tendermint/PubKeySecp256k1",
"value": "AqKWqOjfqWVKsPDhheTYtEg5gipkndUeYdma/5CWAtrH"
},
"signature": "o3+TzpaQVZObp6sHRv0L5yr9fBOAGsGxdGrx2I4FU2sdz4zaBj8Vwm8u57esCaaYiv4+0HBdr+Usms+wxcPZbQ=="
}
],
"memo": "913be662b8e15b21f87ba7a0a88aa2da690d087f@192.168.0.113:26656"
}
}
這里包含了一個(gè) msg: MsgCreateValidator
表示創(chuàng)建 validator
nsd collect-gentxs
: cosmos-sdk/x/genutil/client/cli/collect.go
將上一步生成的創(chuàng)世交易寫入 genesis.json
nsd validate-genesis
: cosmos-sdk/x/genutil/client/cli/validate_genesis.go
校驗(yàn) genesis 信息
nsd start
啟動(dòng) namachain
nscli tx nameservice buy-name namechain.com 20nametoken --from jack
jack 花費(fèi) 20 nametoken 購(gòu)買 namechain.com
Action: tx
Route: nameservice
Msg: buy-name
{
"chain_id": "namechain",
"account_number": "3",
"sequence": "2",
"fee": {
"amount": [],
"gas": "200000"
},
"msgs": [
{
"type": "nameservice/BuyName",
"value": {
"name": "namechain.com",
"bid": [
{
"denom": "nametoken",
"amount": "20"
}
],
"buyer": "cosmos1d8grdhlg87vnlz6ld22tcl9y3s04gl8sc57q4w"
}
}
],
"memo": ""
}
confirm transaction before signing and broadcasting [y/N]: y
{
"height": "0",
"txhash": "4F5B53E7B69F5D53398341E336709B4C4B92752ABA970AF6743977A1BEA7ABE7",
"raw_log": "[]"
}
- /x/nameservice/client/cli/tx.go 中 GetCmdBuyName 會(huì)對(duì)原始 cli 消息進(jìn)行處理檩小，包裝成對(duì)應(yīng)的 Msg 廣播出去，這里是 MsgBuyName
- /x/nameservice/handler.go 對(duì)接受到的 Msg 進(jìn)行處理和執(zhí)行烟勋，這里借助 keeper 來完成具體的操作
- /x/nameservice/internal/keeper/keeper.go 中實(shí)現(xiàn)了業(yè)務(wù)的具體操作并供外部調(diào)用规求，這里需要使用到 GetPrice，HasOwner卵惦，SetOwner阻肿，SetPrice，數(shù)據(jù)存儲(chǔ)在 KVStore 中
nscli tx nameservice set-name namechain.com 8.8.8.8 --from jack
jack 發(fā)起一筆交易沮尿，給 namechain 設(shè)置 DNS 解析為 8.8.8.8
{
"chain_id": "namechain",
"account_number": "3",
"sequence": "3",
"fee": {
"amount": [],
"gas": "200000"
},
"msgs": [
{
"type": "nameservice/SetName",
"value": {
"name": "namechain.com",
"value": "8.8.8.8",
"owner": "cosmos1d8grdhlg87vnlz6ld22tcl9y3s04gl8sc57q4w"
}
}
],
"memo": ""
}
confirm transaction before signing and broadcasting [y/N]: y
{
"height": "0",
"txhash": "C3389B9D37D2018E026424783A8B1C4C973A6CC52AA9B226BEE4BFD4F2366BB5",
"raw_log": "[]"
}
- /x/nameservice/client/cli/tx.go 中 GetCmdSetName 會(huì)對(duì)原始 cli 消息進(jìn)行處理丛塌，包裝成對(duì)應(yīng)的 Msg 廣播出去，這里是 MsgSetName
- /x/nameservice/handler.go 對(duì)接受到的 Msg 進(jìn)行處理和執(zhí)行
- /x/nameservice/internal/keeper/keeper.go handler 借助 keeper 提供的具體業(yè)務(wù)實(shí)現(xiàn)來完成對(duì) Msg 的處理畜疾，結(jié)果存儲(chǔ)在 KVStore 中
nscli query nameservice resolve namechain.com
查詢 namechain.com 的信息
{
"value": "8.8.8.8"
}
- /x/nameservice/client/cli/query.go 中 GetCmdResolveName 會(huì)對(duì)原始 cli 消息進(jìn)行處理赴邻，向 tendermint node 查詢數(shù)據(jù)，
cliCtx.QueryWithData(fmt.Sprintf("custom/%s/resolve/%s", queryRoute, name), nil)
相關(guān)文件
/x/nameservice/module.go
module 文件對(duì) nameservice 模塊向 cosmos 進(jìn)行了頂層描述啡捶，
AppModuleBasic
AppModuleBasic 中 GetQueryCmd 和 GetTxCmd 傳入了 nameservice 模塊對(duì)交易和查詢指令的具體實(shí)現(xiàn)姥敛；RegisterCodec 配置了所使用的 codec；DefaultGenesis 設(shè)置了該模塊在鏈初始狀態(tài)下的相關(guān)配置信息届慈；RegisterRESTRoutes 設(shè)定 rest 服務(wù)路由徒溪。
AppModule
應(yīng)用模塊的最頂層包裝，指定了 AppModuleBasic金顿，注冊(cè)相關(guān) keeper，實(shí)現(xiàn)了 AppModule 的基本方法
type AppModule interface {
AppModuleGenesis
// registers
RegisterInvariants(sdk.InvariantRegistry)
// routes
Route() string
NewHandler() sdk.Handler
QuerierRoute() string
NewQuerierHandler() sdk.Querier
// ABCI
BeginBlock(sdk.Context, abci.RequestBeginBlock)
EndBlock(sdk.Context, abci.RequestEndBlock) []abci.ValidatorUpdate
}
