189 8069 5689
这篇文章主要讲解了“比原怎么通过create-key接口创建密钥”，文中的讲解内容简单清晰，易于学习与理解，下面请大家跟着小编的思路慢慢深入，一起来研究和学习“比原怎么通过create-key接口创建密钥”吧！
创新互联建站网站建设公司，提供成都网站设计、网站制作，网页设计，建网站，PHP网站建设等专业做网站服务;可快速的进行网站开发网页制作和功能扩展；专业做搜索引擎喜爱的网站，是专业的做网站团队，希望更多企业前来合作!
在API.buildHandler方法中：
api/api.go#L164-L244
func (a *API) buildHandler() {
// ...
if a.wallet != nil {
// ...
m.Handle("/create-key", jsonHandler(a.pseudohsmCreateKey))
// ...可见，其路径为/create-key，而相应的handler是a.pseudohsmCreateKey（外面套着的jsonHandler在之前已经讨论过，这里不提）：
api/hsm.go#L23-L32
func (a *API) pseudohsmCreateKey(ctx context.Context, in struct {
Alias string `json:"alias"`
Password string `json:"password"`
}) Response {
xpub, err := a.wallet.Hsm.XCreate(in.Alias, in.Password)
if err != nil {
return NewErrorResponse(err)
}
return NewSuccessResponse(xpub)
}它主要是调用了a.wallet.Hsm.XCreate，让我们跟进去：
blockchain/pseudohsm/pseudohsm.go#L50-L66
// XCreate produces a new random xprv and stores it in the db.
func (h *HSM) XCreate(alias string, auth string) (*XPub, error) {
// ...
// 1.
normalizedAlias := strings.ToLower(strings.TrimSpace(alias))
// 2.
if ok := h.cache.hasAlias(normalizedAlias); ok {
return nil, ErrDuplicateKeyAlias
}
// 3.
xpub, _, err := h.createChainKDKey(auth, normalizedAlias, false)
if err != nil {
return nil, err
}
// 4.
h.cache.add(*xpub)
return xpub, err
}其中出现了HSM这个词，它是指Hardware-Security-Module，原来比原还预留了跟硬件相关的模块（暂不讨论）。
上面的代码分成了4部分，分别是：
首先对传进来的alias参数进行标准化操作，即去两边空白，并且转换成小写
检查cache中有没有，有的话就直接返回并报个相应的错，不会重复生成，因为私钥和别名是一一对应的。在前端可以根据这个错误提醒用户检查或者换一个新的别名。
调用createChainKDKey生成相应的密钥，并拿到返回的公钥xpub
把公钥放入cache中。看起来公钥和别名并不是同一个东西，那前面为什么可以查询alias呢？
所以我们进入h.cache.hasAlias看看：
blockchain/pseudohsm/keycache.go#L76-L84
func (kc *keyCache) hasAlias(alias string) bool {
xpubs := kc.keys()
for _, xpub := range xpubs {
if xpub.Alias == alias {
return true
}
}
return false
}通过xpub.Alias我们可以了解到，原来别名跟公钥是绑定的，alias可以看作是公钥的一个属性（当然也属于相应的私钥）。所以前面把公钥放进cache，之后就可以查询别名了。
那么第3步中的createChainKDKey又是如何生成密钥的呢？
blockchain/pseudohsm/pseudohsm.go#L68-L86
func (h *HSM) createChainKDKey(auth string, alias string, get bool) (*XPub, bool, error) {
// 1.
xprv, xpub, err := chainkd.NewXKeys(nil)
if err != nil {
return nil, false, err
}
// 2.
id := uuid.NewRandom()
key := &XKey{
ID: id,
KeyType: "bytom_kd",
XPub: xpub,
XPrv: xprv,
Alias: alias,
}
// 3.
file := h.keyStore.JoinPath(keyFileName(key.ID.String()))
if err := h.keyStore.StoreKey(file, key, auth); err != nil {
return nil, false, errors.Wrap(err, "storing keys")
}
// 4.
return &XPub{XPub: xpub, Alias: alias, File: file}, true, nil
}这块代码内容比较清晰，我们可以把它分成4步，分别是：
调用chainkd.NewXKeys生成密钥。其中chainkd对应的是比原代码库中的另一个包"crypto/ed25519/chainkd"，从名称上来看，使用的是ed25519算法。如果对前面文章“如何连上一个比原节点”还有印象的话，会记得比原在有新节点连上的时候，就会使用该算法生成一对密钥，用于当次连接进行加密通信。不过需要注意的是，虽然两者都是ed25519算法，但是上次使用的代码却是来自第三方库"github.com/tendermint/go-crypto"的。它跟这次的算法在细节上究竟有哪些不同，目前还不清楚，留待以后合适的机会研究。然后是传入chainkd.NewXKeys(nil)的参数nil，对应的是“随机数生成器”。如果传的是nil，NewXKeys就会在内部使用默认的随机数生成器生成随机数并生成密钥。关于密钥算法相关的内容，在本文中并不探讨。
给当前密钥生成一个唯一的id，在后面用于生成文件名，保存在硬盘上。id使用的是uuid，生成的是一个形如62bc9340-f6a7-4d16-86f0-4be61920a06e这样的全球唯一的随机数
把密钥以文件形式保存在硬盘上。这块内容比较多，下面详细讲。
把公钥相关信息组合在一起，供调用者使用。
我们再详细讲一下第3步，把密钥保存成文件。首先是生成文件名，keyFileName函数对应的代码如下：
blockchain/pseudohsm/key.go#L96-L101