比原怎么通过create-account-receiver创建地址
本篇内容介绍了“比原怎么通过create-account-receiver创建地址”的有关知识,在实际案例的操作过程中,不少人都会遇到这样的困境,接下来就让小编带领大家学习一下如何处理这些情况吧!希望大家仔细阅读,能够学有所成!
创新互联长期为上1000+客户提供的网站建设服务,团队从业经验10年,关注不同地域、不同群体,并针对不同对象提供差异化的产品和服务;打造开放共赢平台,与合作伙伴共同营造健康的互联网生态环境。为宁洱企业提供专业的成都网站设计、成都网站制作、外贸网站建设,宁洱网站改版等技术服务。拥有十多年丰富建站经验和众多成功案例,为您定制开发。
前端是如何向后台接口发送请求的?
首先是页面中的"Create Address"对应的React组件
class AccountShow extends BaseShow { // ... // 2. createAddress() { // ... // 3. this.props.createAddress({ account_alias: this.props.item.alias }).then(({data}) => { this.listAddress() this.props.showModal() }) } render() { // ... view ={lang === 'zh' ? '拷贝这个地址以用于交易中:' : 'Copy this address to use in a transaction:'}
{lang === 'zh' ? '新建地址' : 'Create address'} , ]} /> // ... } // ... } }
上面的第1处就是"Create Address"链接对应的代码,它实际上是一个Button,当点击后,会调用createAddress
方法。而第2处就是这个createAddress
方法,在它里面的第3处,又将调用this.props.createAddress
,也就是由外部传进来的createAddress
函数。同时,它还要发送一个参数account_alias
,它对应就是当前帐户的alias。
继续可以找到createAddress
的定义
const accountsAPI = (client) => { return { // ... createAddress: (params, cb) => shared.create(client, '/create-account-receiver', params, {cb, skipArray: true}), // ... } }
可以看到,它调用的比原接口是/create-account-receiver
。
然后我们就将进入比原后台。
比原后台是如何创建地址的?
在比原的代码中,我们可以找到接口/create-account-receiver
对应的handler:
api/api.go#L164-L174
func (a *API) buildHandler() { // ... if a.wallet != nil { // ... m.Handle("/create-account-receiver", jsonHandler(a.createAccountReceiver))
原来是a.createAccountReceiver
。我们继续进去:
api/receivers.go#L9-L32
// 1. func (a *API) createAccountReceiver(ctx context.Context, ins struct { AccountID string `json:"account_id"` AccountAlias string `json:"account_alias"` }) Response { // 2. accountID := ins.AccountID if ins.AccountAlias != "" { account, err := a.wallet.AccountMgr.FindByAlias(ctx, ins.AccountAlias) if err != nil { return NewErrorResponse(err) } accountID = account.ID } // 3. program, err := a.wallet.AccountMgr.CreateAddress(ctx, accountID, false) if err != nil { return NewErrorResponse(err) } // 4. return NewSuccessResponse(&txbuilder.Receiver{ ControlProgram: program.ControlProgram, Address: program.Address, }) }
方法中的代码可以分成4块,看起来还是比较清楚:
第1块的关注点主要在参数这块。可以看到,这个接口可以接收2个参数
account_id
和account_alias
,但是刚才的前端代码中传过来了account_alias
这一个,怎么回事?从第2块这里可以看出,如果传了
account_alias
这个参数,则会以它为准,用它去查找相应的account,再拿到相应的id。否则的话,才使用account_id
当作account的id第3块是为
accountID
相应的account创建一个地址第4块返回成功信息,经由外面的
jsonHandler
转换为JSON对象后发给前端
这里面,需要我们关注的只有两个方法,即第2块中的a.wallet.AccountMgr.FindByAlias
和第3块中的a.wallet.AccountMgr.CreateAddress
,我们依次研究。
a.wallet.AccountMgr.FindByAlias
直接上代码:
account/accounts.go#L176-L195
// FindByAlias retrieves an account's Signer record by its alias func (m *Manager) FindByAlias(ctx context.Context, alias string) (*Account, error) { // 1. m.cacheMu.Lock() cachedID, ok := m.aliasCache.Get(alias) m.cacheMu.Unlock() if ok { return m.FindByID(ctx, cachedID.(string)) } // 2. rawID := m.db.Get(aliasKey(alias)) if rawID == nil { return nil, ErrFindAccount } // 3. accountID := string(rawID) m.cacheMu.Lock() m.aliasCache.Add(alias, accountID) m.cacheMu.Unlock() return m.FindByID(ctx, accountID) }
该方法的结构同样比较简单,分成了3块:
直接用alias在内存缓存
aliasCache
里找相应的id,找到的话调用FindByID
找出完整的account数据如果cache中没找到,则将该alias变成数据库需要的形式,在数据库里找id。如果找不到,报错
找到的话,把alias和id放在内存cache中,以备后用,同时调用
FindByID
找出完整的account数据
上面提到的aliasCache
是定义于Manager
类型中的一个字段:
account/accounts.go#L78-L85
type Manager struct { // ... aliasCache *lru.Cache
lru.Cache
是由Go语言提供的,我们就不深究了。
然后就是用到多次的FindByID
:
account/accounts.go#L197-L220
// FindByID returns an account's Signer record by its ID. func (m *Manager) FindByID(ctx context.Context, id string) (*Account, error) { // 1. m.cacheMu.Lock() cachedAccount, ok := m.cache.Get(id) m.cacheMu.Unlock() if ok { return cachedAccount.(*Account), nil } // 2. rawAccount := m.db.Get(Key(id)) if rawAccount == nil { return nil, ErrFindAccount } // 3. account := &Account{} if err := json.Unmarshal(rawAccount, account); err != nil { return nil, err } // 4. m.cacheMu.Lock() m.cache.Add(id, account) m.cacheMu.Unlock() return account, nil }
这个方法跟前面的套路一样,也比较清楚:
先在内存缓存
cache
中找,找到就直接返回。m.cache
也是定义于Manager
中的一个lru.Cache
对象内存缓存中没有,就到数据库里找,根据id找到相应的JSON格式的account对象数据
把JSON格式的数据变成
Account
类型的数据,也就是前面需要的把它放到内存缓存
cache
中,以id
为key
这里感觉没什么说的,因为基本上在前一篇都涉及到了。
a.wallet.AccountMgr.CreateAddress
继续看生成地址的方法:
account/accounts.go#L239-L246
// CreateAddress generate an address for the select account func (m *Manager) CreateAddress(ctx context.Context, accountID string, change bool) (cp *CtrlProgram, err error) { account, err := m.FindByID(ctx, accountID) if err != nil { return nil, err } return m.createAddress(ctx, account, change) }
由于这个方法里传过来的是accountID
而不是account
对象,所以还需要再用FindByID
查一遍,然后,再调用createAddress
这个私有方法创建地址:
account/accounts.go#L248-L263
// 1. func (m *Manager) createAddress(ctx context.Context, account *Account, change bool) (cp *CtrlProgram, err error) { // 2. if len(account.XPubs) == 1 { cp, err = m.createP2PKH(ctx, account, change) } else { cp, err = m.createP2SH(ctx, account, change) } if err != nil { return nil, err } // 3. if err = m.insertAccountControlProgram(ctx, cp); err != nil { return nil, err } return cp, nil }
该方法可以分成3部分:
在第1块中主要关注的是返回值。方法名为
CreateAddress
,但是返回值或者CtrlProgram
,那么Address
在哪儿?实际上Address
是CtrlProgram
中的一个字段,所以调用者可以拿到Address在第2块代码这里有一个新的发现,原来一个帐户是可以有多个密钥对的(提醒:在椭圆算法中一个私钥只能有一个公钥)。因为这里将根据该account所拥有的公钥数量不同,调用不同的方法。如果公钥数量为1,说明该帐户是一个独享帐户(由一个密钥管理),将调用
m.createP2PKH
;否则的话,说明这个帐户由多个公钥共同管理(可能是一个联合帐户),需要调用m.createP2SH
。这两个方法,返回的对象cp
,指的是ControlProgram
,强调了它是一种控制程序,而不是一个地址,地址Address
只是它的一个字段创建好以后,把该控制程序插入到该帐户中
我们先看第2块代码中的帐户只有一个密钥的情况,所调用的方法为createP2PKH
:
account/accounts.go#L265-L290
func (m *Manager) createP2PKH(ctx context.Context, account *Account, change bool) (*CtrlProgram, error) { idx := m.getNextContractIndex(account.ID) path := signers.Path(account.Signer, signers.AccountKeySpace, idx) derivedXPubs := chainkd.DeriveXPubs(account.XPubs, path) derivedPK := derivedXPubs[0].PublicKey() pubHash := crypto.Ripemd160(derivedPK) // TODO: pass different params due to config address, err := common.NewAddressWitnessPubKeyHash(pubHash, &consensus.ActiveNetParams) if err != nil { return nil, err } control, err := vmutil.P2WPKHProgram([]byte(pubHash)) if err != nil { return nil, err } return &CtrlProgram{ AccountID: account.ID, Address: address.EncodeAddress(), KeyIndex: idx, ControlProgram: control, Change: change, }, nil }
不好意思,这个方法的代码一看我就搞不定了,看起来是触及到了比较比原链中比较核心的地方。我们很难通过这几行代码以及快速的查阅来对它进行合理的解释,所以本篇只能跳过,以后再专门研究。同样,m.createP2SH
也是一样的,我们也先跳过。我们早晚要把这一块解决的,请等待。
我们继续看第3块中m.insertAccountControlProgram
方法:
account/accounts.go#L332-L344
func (m *Manager) insertAccountControlProgram(ctx context.Context, progs ...*CtrlProgram) error { var hash common.Hash for _, prog := range progs { accountCP, err := json.Marshal(prog) if err != nil { return err } sha3pool.Sum256(hash[:], prog.ControlProgram) m.db.Set(ContractKey(hash), accountCP) } return nil }
这个方法看起来就容易多了,主要是把前面创建好的CtrlProgram
传过来,对它进行保存数据库的操作。注意这个方法的第2个参数是...*CtrlProgram
,它是一个可变参数,不过在本文中用到的时候,只传了一个值(在其它使用的地方有传入多个的)。
在方法中,对progs
进行变量,对其中的每一个,都先把它转换成JSON格式,然后再对它进行摘要,最后通过ContractKey
函数给摘要加一个Contract:
的前缀,放在数据库中。这里的m.db
在之前文章中分析过,它就是那个名为wallet
的leveldb数据库。这个数据库的Key挺杂的,保存了各种类型的数据,以前缀区分。
我们看一下ContractKey
函数,很简单:
account/accounts.go#L57-L59
func ContractKey(hash common.Hash) []byte { return append(contractPrefix, hash[:]...) }
其中的contractPrefix
为常量[]byte("Contract:")
。从这个名字我们可以又将接触到一个新的概念:合约(Contract),看来前面的CtrlProgram
就是一个合约,而帐户只是合约中的一部分(是否如此,留待我们以后验证)
“比原怎么通过create-account-receiver创建地址”的内容就介绍到这里了,感谢大家的阅读。如果想了解更多行业相关的知识可以关注创新互联网站,小编将为大家输出更多高质量的实用文章!
网站栏目:比原怎么通过create-account-receiver创建地址
本文地址:http://azwzsj.com/article/jcchcs.html