Skip to content

Repository files navigation

Conch(贝壳)

Build StatusGoDoc

一个基于tendermint的共识机制引擎实现的简单虚拟货币

一些相关知识的链接

拜占庭容错

状态机副本

区块链

什么是tendermint

Tendermint Core 是一个拜占庭容错�中间件, 它实现了一套共识机制引擎. 可以基于此项目使用任意的编程语言实现�基于此共识�机制的各种项目。如分布式系统, 虚拟货币等. 下面是一些基于此引擎开源的一些明星项目. 我们使用此共识机制�更大的目的是在于学习。 感谢tendermint这个伟大的开源项目. 让开发区块链工程更easy, 也能从此开源项目中学习到很多有用的知识.

cosmos network

ethermint 基于POS+BFT以太坊实现

Hyperledger Burrow

测试链已经启动

使用docker镜像连接到测试链

  • 创建配置和数据存储路径

     mkdir /opt/conch/config
    mkdir /opt/conch/data
  • 将genesis.json, config.toml文件放入/opt/conch/config

    genesis.json

     {
    "genesis_time": "2018-08-31T09:19:29.144335522Z",
    "chain_id": "conch-testnet-wupeaking",
    "consensus_params": {
    "block_size_params": {
    "max_bytes": "22020096",
    "max_txs": "10000",
    "max_gas": "-1"
    },
    "tx_size_params": {
    "max_bytes": "10240",
    "max_gas": "-1"
    },
    "block_gossip_params": {
    "block_part_size_bytes": "65536"
    },
    "evidence_params": {
    "max_age": "100000"
    }
    },
    "validators": [
    {
    "pub_key": {
    "type": "tendermint/PubKeySecp256k1",
    "value": "A7C1pYP/mrQ6Jnp3oQMpAVKpUOnAQjKpLA95e7MbV/eR"
    },
    "power": "10",
    "name": "zhangsan"
    }
    ],
    "app_hash": ""
    }

    config.tmol

    
    # TCP or UNIX socket address of the ABCI application,
    # or the name of an ABCI application compiled in with the Tendermint binary
    proxy_app = "conchapp"
    # A custom human readable name for this node
    moniker = "conchapp-pc"
    # If this node is many blocks behind the tip of the chain, FastSync
    # allows them to catchup quickly by downloading blocks in parallel
    # and verifying their commits
    fast_sync = true
    # Database backend: leveldb | memdb
    db_backend = "leveldb"
    # Database directory
    db_path = "data"
    # Output level for logging, including package level options
    log_level = "main:info,state:info,*:error"
    ##### additional base config options #####
    # Path to the JSON file containing the initial validator set and other meta data
    genesis_file = "config/genesis.json"
    # Path to the JSON file containing the private key to use as a validator in the consensus protocol
    priv_validator_file = "config/priv_validator.json"
    # Path to the JSON file containing the private key to use for node authentication in the p2p protocol
    node_key_file = "config/node_key.json"
    # Mechanism to connect to the ABCI application: socket | grpc
    abci = "socket"
    # TCP or UNIX socket address for the profiling server to listen on
    prof_laddr = ""
    # If true, query the ABCI app on connecting to a new peer
    # so the app can decide if we should keep the connection or not
    filter_peers = false
    ##### advanced configuration options #####
    ##### rpc server configuration options #####
    [rpc]
    # TCP or UNIX socket address for the RPC server to listen on
    laddr = "tcp://0.0.0.0:26657"
    # TCP or UNIX socket address for the gRPC server to listen on
    # NOTE: This server only supports /broadcast_tx_commit
    grpc_laddr = ""
    # Maximum number of simultaneous connections.
    # Does not include RPC (HTTP&WebSocket) connections. See max_open_connections
    # If you want to accept more significant number than the default, make sure
    # you increase your OS limits.
    # 0 - unlimited.
    grpc_max_open_connections = 900
    # Activate unsafe RPC commands like /dial_seeds and /unsafe_flush_mempool
    unsafe = false
    # Maximum number of simultaneous connections (including WebSocket).
    # Does not include gRPC connections. See grpc_max_open_connections
    # If you want to accept more significant number than the default, make sure
    # you increase your OS limits.
    # 0 - unlimited.
    max_open_connections = 900
    ##### peer to peer configuration options #####
    [p2p]
    # Address to listen for incoming connections
    laddr = "tcp://0.0.0.0:26656"
    # Address to advertise to peers for them to dial
    # If empty, will use the same port as the laddr,
    # and will introspect on the listener or use UPnP
    # to figure out the address.
    external_address = ""
    # Comma separated list of seed nodes to seeds = ""
    persistent_peers = "bf3e958f7d8a935bff9d0d10396d4916009c4ee5@120.55.49.80:26656"
    # UPNP port forwarding
    upnp = false
    # Path to address book
    addr_book_file = "config/addrbook.json"
    # Set true for strict address routability rules
    addr_book_strict = true
    # Time to wait before flushing messages out on the connection, in ms
    flush_throttle_timeout = 100
    # Maximum number of peers to connect to
    max_num_peers = 50
    # Maximum size of a message packet payload, in bytes
    max_packet_msg_payload_size = 1024
    # Rate at which packets can be sent, in bytes/second
    send_rate = 5120000
    # Rate at which packets can be received, in bytes/second
    recv_rate = 5120000
    # Set true to enable the peer-exchange reactor
    pex = true
    # Seed mode, in which node constantly crawls the network and looks for
    # peers. If another node asks it for addresses, it responds and disconnects.
    #
    # Does not work if the peer-exchange reactor is disabled.
    seed_mode = false
    # Comma separated list of peer IDs to keep private (will not be gossiped to other peers)
    private_peer_ids = ""
    ##### mempool configuration options #####
    [mempool]
    recheck = true
    recheck_empty = true
    broadcast = true
    wal_dir = "data/mempool.wal"
    # size of the mempool
    size = 100000
    # size of the cache (used to filter transactions we saw earlier)
    cache_size = 100000
    ##### consensus configuration options #####
    [consensus]
    wal_file = "data/cs.wal/wal"
    # All timeouts are in milliseconds
    timeout_propose = 3000
    timeout_propose_delta = 500
    timeout_prevote = 1000
    timeout_prevote_delta = 500
    timeout_precommit = 1000
    timeout_precommit_delta = 500
    timeout_commit = 1000
    # Make progress as soon as we have all the precommits (as if TimeoutCommit = 0)
    skip_timeout_commit = false
    # EmptyBlocks mode and possible interval between empty blocks in seconds
    create_empty_blocks = true
    create_empty_blocks_interval = 20
    # Reactor sleep duration parameters are in milliseconds
    peer_gossip_sleep_duration = 100
    peer_query_maj23_sleep_duration = 2000
    ##### transactions indexer configuration options #####
    [tx_index]
    # What indexer to use for transactions
    #
    # Options:
    # 1) "null" (default)
    # 2) "kv" - the simplest possible indexer, backed by key-value storage (defaults to levelDB; see DBBackend).
    indexer = "kv"
    # Comma-separated list of tags to index (by default the only tag is tx hash)
    #
    # It's recommended to index only a subset of tags due to possible memory
    # bloat. This is, of course, depends on the indexer's DB and the volume of
    # transactions.
    index_tags = ""
    # When set to true, tells indexer to index all tags. Note this may be not
    # desirable (see the comment above). IndexTags has a precedence over
    # IndexAllTags (i.e. when given both, IndexTags will be indexed).
    index_all_tags = false
    ##### instrumentation configuration options #####
    [instrumentation]
    # When true, Prometheus metrics are served under /metrics on
    # PrometheusListenAddr.
    # Check out the documentation for the list of available metrics.
    prometheus = false
    # Address to listen for Prometheus collector(s) connections
    prometheus_listen_addr = ":26660"
    # Maximum number of simultaneous connections.
    # If you want to accept more significant number than the default, make sure
    # you increase your OS limits.
    # 0 - unlimited.
    max_open_connections = 3
    
  • 启动docker镜像

    docker run --name=conch-node --net=host -v /opt/conch:/opt/conch/data -d blockchainworkers/conch 

使用二进制文件加入测试链

  • 编译二进制文件

    > mkdir -p /opt/conch/src/github.com/blockchainworkers
    > mkdir -p /opt/conch/data/config && mkdir -p /opt/conch/data/data
    >export BUILD_FLAGS=-ldflags "-X github.com/blockchainworkers/conch/version.GitCommit=`git rev-parse --short=8 HEAD`">export GOPATH=/opt/conch
    >cd /opt/conch/src/github.com/blockchainworkers && git clone https://github.com/blockchainworkers/conch.git conch
    >cd conch
    > go build $(BUILD_FLAGS) -o conchd ./cmd/conch/main.go
  • 将genesis.json, config.toml文件放入/opt/conch/data/config

  • 启动节点

     ./conchd node --home /opt/conch/data

关于API说明以及转账说明文档即将到来

未完待续...

About

a blockchain project based pos+pbft consensus algorithm and evm powered by tendermint and ethereum

Topics

Resources

Stars

42 stars

Watchers

4 watching

Forks

Releases

Packages

Used by

Contributors

Languages