cosmos-sdk-tutorials namechain 體驗(yàn)過(guò)程解析

namechain 體驗(yàn)過(guò)程解析

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)聽(tīng)來(lái)自外部 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)聽(tīng)地址

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)聽(tīng)地址

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)聽(tīng)地址

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": "[]"
}
  1. /x/nameservice/client/cli/tx.go 中 GetCmdBuyName 會(huì)對(duì)原始 cli 消息進(jìn)行處理，包裝成對(duì)應(yīng)的 Msg 廣播出去，這里是 MsgBuyName
  2. /x/nameservice/handler.go 對(duì)接受到的 Msg 進(jìn)行處理和執(zhí)行，這里借助 keeper 來(lái)完成具體的操作
  3. /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": "[]"
}
  1. /x/nameservice/client/cli/tx.go 中 GetCmdSetName 會(huì)對(duì)原始 cli 消息進(jìn)行處理，包裝成對(duì)應(yīng)的 Msg 廣播出去，這里是 MsgSetName
  2. /x/nameservice/handler.go 對(duì)接受到的 Msg 進(jìn)行處理和執(zhí)行
  3. /x/nameservice/internal/keeper/keeper.go handler 借助 keeper 提供的具體業(yè)務(wù)實(shí)現(xiàn)來(lái)完成對(duì) Msg 的處理，結(jié)果存儲(chǔ)在 KVStore 中

nscli query nameservice resolve namechain.com

查詢 namechain.com 的信息

{
  "value": "8.8.8.8"
}
  1. /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
}
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點(diǎn)，簡(jiǎn)書系信息發(fā)布平臺(tái)，僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容