AI 助理
备案控制台
文档
输入文档关键字查找
首页 区块链服务 区块链 BaaS 开发参考 蚂蚁区块链-合约链 SDK 开发指南 JS SDK 开发指南 账户接口

账户接口

更新时间：
产品详情
相关技术圈
我的收藏

创建账户

CreateAccount 接口用于在链上创建一个新的账户。

请求参数

将以下参数整体封装为 object 传入。

参数 必选 类型 说明
from true string 使用的账户名，用此账户来创建新账户。
to true string 创建的新账户名。
data true object 数据内容，包含创建账户需要的数据。

data 字段内容：

字段 必选 类型 说明
recover_key false string 内容为“0x”开头的 16 进制字符串，长度为 64（不含“0x”）。
auth_key false string 内容为“0x”开头的 16 进制字符串，长度为 64（不含“0x”）。
auth_weight false string 目前 JS SDK 支持一个 auth key，此值应设为 100。

示例

  • 使用已有 public key 创建账户。

    1.   chain.ctr.CreateAccount({
    2.     from: 'Tester001',
    3.     to: 'Tester002',
    4.     data: {
    5.       recover_key: '0xf5e50510a04a3f659a0e89f2063f79f8c1aed5ddaab6420ac47700020d9889dc14dae4dc9843c88d8222167095d9e6ce052e8a19cbc737c3f3cddf66409dbb0a',
    6.       auth_key: '0xf5e50510a04a3f659a0e89f2063f79f8c1aed5ddaab6420ac47700020d9889dc14dae4dc9843c88d8222167095d9e6ce052e8a19cbc737c3f3cddf66409dbb0a',
    7.       auth_weight: 100
    8.     }
    9.   }, (err, data) => {
    10.     console.log(data)
    11.   })

  • 使用新创建的 key 创建账户。

    1.     const newKey = Chain.utils.generateECKey();
    2.     console.log('newKey priKey:', newKey.privateKey.toString('hex'))
    3.     console.log('newKey pubKey:', newKey.publicKey.toString('hex'))
    5.     chain.ctr.CreateAccount({
    6.       from: 'Tester001',
    7.       to: 'Tester003',
    8.       data: {
    9.         recover_key: '0x'+ newKey.publicKey.toString('hex'),
    10.         auth_key: '0x'+ newKey.publicKey.toString('hex'),
    11.         auth_weight: 100
    12.       }
    13.     }, (err, data) => {
    14.       console.log(data)
    15.     })

  • 使用新创建的 key 创建账户，然后使用新账户发起交易。注意，需要切换账户配置。

    1.     const newKey = Chain.utils.generateECKey();
    2.     console.log('newKey priKey:', newKey.privateKey.toString('hex'))
    3.     console.log('newKey pubKey:', newKey.publicKey.toString('hex'))
    5.     const newAccountName = 'Tester001' + Date.now()
    6.     chain.ctr.CreateAccount({
    7.       from: 'Tester001',
    8.       to: newAccountName,
    9.       data: {
    10.         recover_key: '0x'+ newKey.publicKey.toString('hex'),
    11.         auth_key: '0x'+ newKey.publicKey.toString('hex'),
    12.         auth_weight: 100
    13.       }
    14.     }, (err, data) => {
    15.       console.log('New Account:', data)
    16.       //当前的 chain 实例 切换配置账户
    17.       opt.userPrivateKey = '0x'+ newKey.privateKey.toString('hex')
    18.       opt.userPublicKey = '0x'+ newKey.publicKey.toString('hex')
    19.       opt.userRecoverPrivateKey = '0x'+ newKey.privateKey.toString('hex')
    20.       opt.userRecoverPublicKey = '0x'+ newKey.publicKey.toString('hex')
    22.       chain.setUserKey(opt)
    23.       chain.setUserRecoverKey(opt)
    24.       //当前的 chain 实例 切换配置账户完成
    26.       //使用刚才新创建的账户发起交易（此示例使用的“存证交易”，在下文内容有详细介绍）
    27.       chain.ctr.NativeDepositData({
    28.         from: newAccountName,
    29.         to: newAccountName,
    30.         data: {
    31.           payload: '0x1234'
    32.         }
    33.       }, (err, data) => {
    34.         chain.ctr.QueryTransaction({
    35.           hash: data.txhash
    36.         }, (err, data) => {
    37.           console.log('TX data(NativeDepositData):', data)
    38.         })
    40.         chain.ctr.QueryTransactionReceipt({
    41.           hash: data.txhash
    42.         }, (err, data) => {
    43.           console.log('Receipt data(NativeDepositData):', data)
    44.         })
    45.       })
    46.     })

转账

TransferBalance 接口用于从一个账户转账到另一个账户。

请求参数

将以下参数整体封装为 object 传入。

参数 必选 类型 说明
from true string 使用的账户名
to true string 转账的目标账户名
value true number 转账额度

示例

  1.   chain.ctr.TransferBalance({
  2.         from: 'Tester001',
  3.         to: 'Tester002',
  4.         value: 0
  5.       }, (err, data) => {
  6.         console.log(data)
  7.       })

设置恢复公钥

SetRecoverkey 接口用于设置一个账户的恢复公钥。

请求参数

将以下参数整体封装为 object 传入。

参数 必选 类型 说明
from true string 需要配置的当前账户名
data true object 数据字段

data 字段内容：

字段 必选 类型 说明
recover_key true string 内容为“0x”开头的 16 进制字符串，长度为 64（不含“0x”）。

示例

  1.   chain.ctr.SetRecoverkey({
  2.         from: account,
  3.         data: {
  4.           recover_key: publicKey
  5.         }
  6.       }, (err, data) => {
  7.         console.log(data)
  8.       })

预重置公钥

PreResetPubKey 接口用来预重置一个账户的公钥。

请求参数

将以下参数整体封装为 object 传入。

参数 必选 类型 说明
from true string 需要配置的当前账户名

示例

  1.   chain.ctr.PreResetPubKey({
  2.        from: 'Tester001'
  3.      }, (err, data) => {
  4.        console.log(data)
  5.      })

重置公钥

ResetPubKey 接口用来重置一个账户的公钥。

请求参数

将以下参数整体封装为 object 传入。

参数 必选 类型 说明
from true string 需要配置的当前账户名
data true object 数据字段

data 字段内容：

字段 必选 类型 说明
auth_key true string 内容为“0x”开头的 16 进制字符串，长度为 64（不含“0x”）。
auth_weight true number 权重值，为 100，当前 JS SDK 支持一个 auth key，因此权重值为 100，未来支持多 auth key，权重值和为 100。

示例

  1. chain.ctr.ResetPubKey({
  2.   from: 'Tester001',
  3.   data: {
  4.     auth_key:'0xf5e50510a04a3f659a0e89f2063f79f8c1aed5ddaab6420ac47700020d9889dc14dae4dc9843c88d8222167095d9e6ce052e8a19cbc737c3f3cddf66409dbb0a',
  5.     auth_weight: 100,
  6.   }
  7. }, (err, data) => {
  8.   console.log(data)
  9. })

更新权重

UpdateAuthMap 接口用于更新一个账户的公钥的权重值。

请求参数

将以下参数整体封装为 object 传入。

参数 必选 类型 说明
from true string 需要配置的当前账户名
data true object 数据字段

data 字段内容：

字段 必选 类型 说明
auth_key true string 内容为“0x”开头的 16 进制字符串，长度为 64（不含“0x”）。
auth_weight true number 权重值，为 100，当前 JS SDK 支持一个 auth key，因此权重值为 100，未来支持多 auth key，权重值和为 100。

示例

  1. chain.ctr.UpdateAuthMap({
  2.   from: 'Tester001',
  3.   data: {
  4.     auth_key:'0xf5e50510a04a3f659a0e89f2063f79f8c1aed5ddaab6420ac47700020d9889dc14dae4dc9843c88d8222167095d9e6ce052e8a19cbc737c3f3cddf66409dbb0a',
  5.     auth_weight: 100,
  6.   }
  7. }, (err, data) => {
  8.   console.log(data)
  9. })
上一篇：环境接口下一篇：合约接口
文档推荐