github.com/yinchengtsinghua/golang-Eos-dpos-Ethereum@v0.0.0-20190121132951-92cc4225ed8e/core/rawdb/accessors_metadata.go (about)

     1  
     2  //此源码被清华学神尹成大魔王专业翻译分析并修改
     3  //尹成QQ77025077
     4  //尹成微信18510341407
     5  //尹成所在QQ群721929980
     6  //尹成邮箱 yinc13@mails.tsinghua.edu.cn
     7  //尹成毕业于清华大学,微软区块链领域全球最有价值专家
     8  //https://mvp.microsoft.com/zh-cn/PublicProfile/4033620
     9  //版权所有2018 Go Ethereum作者
    10  //此文件是Go以太坊库的一部分。
    11  //
    12  //Go-Ethereum库是免费软件：您可以重新分发它和/或修改
    13  //根据GNU发布的较低通用公共许可证的条款
    14  //自由软件基金会，或者许可证的第3版，或者
    15  //（由您选择）任何更高版本。
    16  //
    17  //Go以太坊图书馆的发行目的是希望它会有用，
    18  //但没有任何保证；甚至没有
    19  //适销性或特定用途的适用性。见
    20  //GNU较低的通用公共许可证，了解更多详细信息。
    21  //
    22  //你应该收到一份GNU较低级别的公共许可证副本
    23  //以及Go以太坊图书馆。如果没有，请参见<http://www.gnu.org/licenses/>。
    24  
    25  package rawdb
    26  
    27  import (
    28  	"encoding/json"
    29  
    30  	"github.com/ethereum/go-ethereum/common"
    31  	"github.com/ethereum/go-ethereum/log"
    32  	"github.com/ethereum/go-ethereum/params"
    33  	"github.com/ethereum/go-ethereum/rlp"
    34  )
    35  
    36  //readdatabaseversion检索数据库的版本号。
    37  func ReadDatabaseVersion(db DatabaseReader) int {
    38  	var version int
    39  
    40  	enc, _ := db.Get(databaseVerisionKey)
    41  	rlp.DecodeBytes(enc, &version)
    42  
    43  	return version
    44  }
    45  
    46  //WriteDatabaseVersion存储数据库的版本号
    47  func WriteDatabaseVersion(db DatabaseWriter, version int) {
    48  	enc, _ := rlp.EncodeToBytes(version)
    49  	if err := db.Put(databaseVerisionKey, enc); err != nil {
    50  		log.Crit("Failed to store the database version", "err", err)
    51  	}
    52  }
    53  
    54  //readchainconfig根据给定的genesis散列检索共识设置。
    55  func ReadChainConfig(db DatabaseReader, hash common.Hash) *params.ChainConfig {
    56  	data, _ := db.Get(configKey(hash))
    57  	if len(data) == 0 {
    58  		return nil
    59  	}
    60  	var config params.ChainConfig
    61  	if err := json.Unmarshal(data, &config); err != nil {
    62  		log.Error("Invalid chain config JSON", "hash", hash, "err", err)
    63  		return nil
    64  	}
    65  	return &config
    66  }
    67  
    68  //writechainconfig将链配置设置写入数据库。
    69  func WriteChainConfig(db DatabaseWriter, hash common.Hash, cfg *params.ChainConfig) {
    70  	if cfg == nil {
    71  		return
    72  	}
    73  	data, err := json.Marshal(cfg)
    74  	if err != nil {
    75  		log.Crit("Failed to JSON encode chain config", "err", err)
    76  	}
    77  	if err := db.Put(configKey(hash), data); err != nil {
    78  		log.Crit("Failed to store chain config", "err", err)
    79  	}
    80  }
    81  
    82  //readpreimage检索所提供哈希的单个preimage。
    83  func ReadPreimage(db DatabaseReader, hash common.Hash) []byte {
    84  	data, _ := db.Get(preimageKey(hash))
    85  	return data
    86  }
    87  
    88  //writepreimages将提供的一组preimages写入数据库。“数字”是
    89  //current block number, and is used for debug messages only.
    90  func WritePreimages(db DatabaseWriter, number uint64, preimages map[common.Hash][]byte) {
    91  	for hash, preimage := range preimages {
    92  		if err := db.Put(preimageKey(hash), preimage); err != nil {
    93  			log.Crit("Failed to store trie preimage", "err", err)
    94  		}
    95  	}
    96  	preimageCounter.Inc(int64(len(preimages)))
    97  	preimageHitCounter.Inc(int64(len(preimages)))
    98  }