2018-11-23

http://blog.hubwiz.com/2018/09/15/EOS-eosjs-use/

怎样使用EOS.JS的API

 发表于 2018-09-15 |  分类于 EOS

在这篇文章中，我们将讨论EOSJS上常用的API并对其进行测试。

我们将使所有代码可用。为了可用，需要做些准备工作，安装Node.js和EOSJS并将以下代码内容放在javascript文件的顶部。

1

2

3

4

5

6

7

8

9

10

11

12

13

14

const Eos = require('eosjs');

const config = {

    expireInSeconds: 60,

    broadcast: true,

    debug: false,

    sign: true,

    // mainNet bp endpoint

    httpEndpoint: 'https://api.eosnewyork.io',

    // mainNet chainId

    chainId: 'aca376f206b8fc25a6ed44dbdc66547c36c6c33e3a119ffbeaef943642f0e906',

};

const eos = Eos(config);

完成此操作后，编写下面的api示例并使用node.js运行javascript以获取相应的值。

注意：由于每个BP端点具有不同的速度及可靠性，建议使用最适合您的BP。

getBlock(blockNumOrId)

用于得到相应的区块信息。

参数：

代码：

1

2

3

4

5

6

7

8

// Promise

eos.getBlock(1).then(result => console.log(result)).catch(error => console.error(error));

// callback

eos.getBlock(1, (error, result) => console.log(error, result));

// Parameters object

eos.getBlock({block_num_or_id: 1}).then(console.log);

结果：

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

{ timestamp: '2018-06-08T08:08:08.500',

  producer: '',

  confirmed: 1,

  previous:

  '0000000000000000000000000000000000000000000000000000000000000000',

  transaction_mroot:

  '0000000000000000000000000000000000000000000000000000000000000000',

  action_mroot:

  'aca376f206b8fc25a6ed44dbdc66547c36c6c33e3a119ffbeaef943642f0e906',

  schedule_version: 0,

  new_producers: null,

  header_extensions: [],

  producer_signature:

  'SIG_K1_111111111111111111111111111111111111111111111111111111111111111116uk5ne',

  transactions: [],

  block_extensions: [],

  id:

  '00000001405147477ab2f5f51cda427b638191c66d2c59aa392d5c2c98076cb0',

  block_num: 1,

  ref_block_prefix: 4126519930 }

要查看适用块中发生的活动，可查看交易。查看交易，执行以下操作：

1

2

3

4

5

6

7

8

9

10

11

12

13

14

[ { status: 'executed',

    cpu_usage_us: 1170,

    net_usage_words: 40,

    trx:

    { id:

        '8a29bfa66850b7d4a2b0b62173a24c5dfe4dbd7b39c211df6309d02a85374960',

      signatures: [Array],

      compression: 'none',

      packed_context_free_data: '',

      context_free_data: [],

      packed_trx:

        '9051595bad38f016a289000000000100a6823403ea3055000000572d3ccdcd0110e0a53cab294d7600000000a8ed3232dd0110e0a53cab294d76a0986af64b96bc65010000000000000004454f5300000000bb01496e74726f647563696e67204954414d204e6574776f726b2c20616e20454f532d426173656420444150502050726f6a656374206f6e20426c6f636b636861696e2047616d696e6720506c6174666f726d20666f722061205472616e73706172656e742047616d696e672045636f73797374656d2e202d2d576562736974653a2068747470733a2f2f6974616d2e67616d65732f656e202d2d54656c656772616d3a2068747470733a2f2f742e6d652f6974616d6e6574776f726b00',

      transaction: [Object] } }

]

如果使用上述值查看交易，则会有操作。通过查看操作，可以更深入地了解发生的活动。

getAccount(accountName)

用于获取帐户的信息。

参数：

代码：

1

2

3

4

5

6

7

8

9

10

11

12

// Promise

eos.getAccount('itamnetwork1')

    .then(result => console.log(result))

    .catch(error => console.error(error));

// callback

eos.getAccount('itamnetwork1', (error, result) => console.log(error, result));

// Parameters object

eos.getAccount({account_name: 'itamnetwork1'})

    .then(result => console.log(result))

    .catch(error => console.error(error));

结果：

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

{ account_name: 'itamnetwork1',

  head_block_num: 8516805,

  head_block_time: '2018-07-30T07:34:52.500',

  privileged: false,

  last_code_update: '1970-01-01T00:00:00.000',

  created: '2018-07-09T02:24:58.500',

  core_liquid_balance: '12.6131 EOS',

  ram_quota: 14976,

  net_weight: 201000,

  cpu_weight: 10401000,

  net_limit: { used: 1679786, available: 11108657, max: 12788443 },

  cpu_limit: { used: 7950353, available: 6356380, max: 14306733 },

  ram_usage: 10934,

  permissions:

  [ { perm_name: 'active', parent: 'owner', required_auth: [Object] },

    { perm_name: 'owner', parent: '', required_auth: [Object] } ],

  total_resources:

  { owner: 'itamnetwork1',

    net_weight: '20.1000 EOS',

    cpu_weight: '1040.1000 EOS',

    ram_bytes: 14976 },

  self_delegated_bandwidth:

  { from: 'itamnetwork1',

    to: 'itamnetwork1',

    net_weight: '0.1000 EOS',

    cpu_weight: '0.1000 EOS' },

  refund_request: null,

  voter_info:

  { owner: 'itamnetwork1',

    proxy: '',

    producers: [],

    staked: 4000,

    last_vote_weight: '0.00000000000000000',

    proxied_vote_weight: '0.00000000000000000',

    is_proxy: 0 } }

我来解释一些上述结果值。

account_name：这是EOS帐户名。

ram_quota：持有的RAM量，单位字节。

net_limit：帐户的总额、可用额、已用额，单位字节。

cpu_limit：CPU总量、可用CPU和已用CPU的总量，单位us。

ram_usage：帐户使用的RAM量，单位字节。

total_resources：分配给自己的EOS资源。

self_delegated_bandwidth：自己的委托信息。

voter_info：有关投票的信息。留意staked部分，显示我押注的数量。更具体地说，它的价值包括我委托给自己以及其他人委托的内容。

getKeyAccounts(publicKey)

用于获取公钥对应的帐户。

参数：

代码：

1

2

3

4

5

6

7

8

9

10

11

12

// Promise

eos.getKeyAccounts('EOS6S6C5ExCM7VHGdmG5h6VREVJEC33bpMJtLucwhyByPmzB58KW5')

    .then(result => console.log(result))

    .catch(error => console.error(error));

// callback

eos.getKeyAccounts('EOS6S6C5ExCM7VHGdmG5h6VREVJEC33bpMJtLucwhyByPmzB58KW5',

    (error, result) => console.log(error, result));

// Parameters object

eos.getKeyAccounts({public_key: 'EOS6S6C5ExCM7VHGdmG5h6VREVJEC33bpMJtLucwhyByPmzB58KW5'})

    .then(console.log);

结果：

1

{ account_names: [ 'itamnetwork1' ] }

可以使用一个EOS公钥创建许多帐户。这就是为什么account_name的值是一个字符串形式的数组。

getCurrencyBalance(code, account, symbol)

获取账号余额。

参数：

代码：

1

2

3

4

5

6

7

8

9

10

11

12

// Promise

eos.getCurrencyBalance('eosio.token', 'itamnetwork1', 'EOS')

    .then(result => console.log(result))

    .catch(error => console.error(error));

// callback

eos.getCurrencyBalance('eosio.token', 'itamnetwork1', 'EOS',

    (error, result) => console.log(error, result));

// Parameters object

eos.getCurrencyBalance({account: 'itamnetwork1', code: 'eosio.token', symbol: 'EOS'})

    .then(console.log);

结果：

1

[ '12.6131 EOS' ]

如果查看结果值，可以以字符串的形式查看数组。这是因为帐户中可能存在许多不同符号的token。在EOS testnet，Jungle Net上，如果你不包括搜索eosio.token，你可以看到2个token。

getCurrencyStats(code, symbol)

获取某种代币的信息。

参数：

代码：

1

2

3

4

5

6

7

8

9

10

11

12

// Promise

eos.getCurrencyStats('eosio.token', 'EOS')

    .then(result => console.log(result))

    .catch(error => console.error(error));

// callback

eos.getCurrencyStats('eosio.token', 'EOS',

    (error, result) => console.log(error, result));

// Parameters object

eos.getCurrencyStats({code: 'eosio.token', symbol: 'EOS'})

    .then(console.log);

结果：

1

2

3

4

{ EOS:

  { supply: '1006148640.3388 EOS',

    max_supply: '10000000000.0000 EOS',

    issuer: 'eosio' } }

以下是结果值的说明。

supply：当前提供的token数量。

max_supply：token总数。

issuer：发行人。

结论

我们浏览了5个最常用的EOSJS API。 我们还没有涵盖很多API，我打算在以后的帖子中继续讨论。谢谢。

======================================================================

分享一个交互式的在线编程实战，EOS智能合约与DApp开发入门：

EOS教程

本课程帮助你快速入门EOS区块链去中心化应用的开发，内容涵盖EOS工具链、账户与钱包、发行代币、智能合约开发与部署、使用代码与智能合约交互等核心知识点，最后综合运用各知识点完成一个便签DApp的开发。

web3j教程，主要是针对java和android程序员进行区块链以太坊开发的web3j详解。

以太坊教程，主要介绍智能合约与dapp应用开发，适合入门。

以太坊开发，主要是介绍使用node.js、mongodb、区块链、ipfs实现去中心化电商DApp实战，适合进阶。

python以太坊，主要是针对python工程师使用web3.py进行区块链以太坊开发的详解。

php以太坊，主要是介绍使用php进行智能合约开发交互，进行账号创建、交易、转账、代币开发以及过滤器和事件等内容。

C#以太坊，主要讲解如何使用C#开发基于.Net的以太坊应用，包括账户管理、状态与交易、智能合约开发与交互、过滤器和事件等。

汇智网原创翻译，转载请标明出处。这里是原文

# 智能合约 # 区块链 # EOS