[关闭]
@zhenxi 2017-10-22T03:08:41.000000Z 字数 25903 阅读 2889

Asch-JS API 使用说明

Asch


1 Asch-js说明

1.1 asch-js安装

  1. npm install asch-js
  2. var AschJS = require('asch-js');

1.2 说明

很多函数都需要传入secret、secondSecret这2个参数,分表代表密码和二级密码,下面章节不再赘述。
自定如下全局变量,用于之后章节代码演示。

  1. > var secret = 'minor borrow display rebel depart core buzz right distance avocado immense push'
  2. > var publicKey = 'ebd4c62ebe2255b7ad5ee43120a9f9191c76e30928c92cd536351e3cc2c626ed';
  3. > var secondSecret = 'erjimima2017';

生成的json交易信息都需要通过http api进行广播。
- 主链交易通过 POST /peer/transactions
- dapp交易通过 PUT /api/dapps/dappID/transactions/signed

2 账户

2.1 根据密码获取密钥对

crypto.getKeys(secret)

  1. > AschJS.crypto.getKeys(secret)
  2. { publicKey: 'ebd4c62ebe2255b7ad5ee43120a9f9191c76e30928c92cd536351e3cc2c626ed',
  3. privateKey: '7ae536fa343281d9e9ed383e8b5ef62e0fd0d0cbed79786cac241d484e312fdeebd4c62ebe2255b7ad5ee43120a9f9191c76e30928c92cd536351e3cc2c626ed' }

2.1 根据公钥获取地址

crypto.getAddress(publicKey)

  1. > AschJS.crypto.getAddress(publicKey);
  2. 'AFUH568CbGC2GPcE4gXHiZhxdYQYfziz2J'

2.3 设置二级密码,type=1

crypto.signature.createSignature(secret, secondSecret)
备注 在主链的交易类型为1

  1. > AschJS.signature.createSignature(secret, secondSecret)
  2. { type: 1,
  3. amount: 0,
  4. fee: 500000000,
  5. recipientId: null,
  6. senderPublicKey: 'ebd4c62ebe2255b7ad5ee43120a9f9191c76e30928c92cd536351e3cc2c626ed',
  7. timestamp: 40566038,
  8. asset: { signature: { publicKey: '632a41caf7d3c8d3754f27a11004acaea6f5571eed28b42451b5560ee91e991c' } },
  9. signature: 'ee42f4dc17ace4f76f86fba93c7d86b61a69de46ac96e102e9f93668c8cdd9e6281821c63cb3e0c23099968cccdcfd0197aaab42afba4a98fa696c17b133be06',
  10. id: '2237134c11b3cbaa9b7951f4afd47454ca04af2c7c6a030729ec63f75230e9ad' }

2.4 账户锁仓,type=100

transaction.createLock(height, secret, secondSecret)
备注 在主链的交易类型为100

  1. > AschJS.transaction.createLock(8130, secret, secondSecret)
  2. { type: 100,
  3. amount: 0,
  4. fee: 10000000,
  5. recipientId: null,
  6. args: [ '8130' ],
  7. timestamp: 40566287,
  8. asset: {},
  9. senderPublicKey: 'ebd4c62ebe2255b7ad5ee43120a9f9191c76e30928c92cd536351e3cc2c626ed',
  10. signature: '06f6852d0e2e56ca441fa60b407aaa2197290ff096558c746c9c8bcdc971b8c4065ec08edd49c7292eca51849c16c5b8f0d33bb4ce972a932603dcf46a391e0e',
  11. signSignature: '3b645b0f6a2c597c55595669a856489c0c4f3a132c798c615b8e0241f3169a367edea7228ebc8915d5fd7a0571cc08c971d07520b9908c80c9b2c2c76ada5e07',
  12. id: 'c87d93af84939076a65a49c3b483897d262edc340b2d4184a4d2505b58711a91' }

3 普通交易transactions

3.1 在主链转账XAS,type=0

transaction.createTransaction(recipientId, amount, message, secret, secondSecret)
备注 在主链的交易类型为0

  1. > var targetAddress = "16358246403719868041";
  2. undefined
  3. > var amount = 100*100000000; //100 XAS
  4. undefined
  5. > var message = 'beizhu';
  6. undefined
  7. > AschJS.transaction.createTransaction(targetAddress, amount, message, secret, secondSecret)
  8. { type: 0,
  9. amount: 10000000000,
  10. fee: 10000000,
  11. recipientId: '16358246403719868041',
  12. message: 'beizhu',
  13. timestamp: 40566970,
  14. asset: {},
  15. senderPublicKey: 'ebd4c62ebe2255b7ad5ee43120a9f9191c76e30928c92cd536351e3cc2c626ed',
  16. signature: '9bef374be100fcfec59d245af59e5646ba5dcb79c6f1399ddd676a617542eeb45cc363822b84410e379f0caa501c25b66e59142353c04d23d1cb95cf64cef306',
  17. signSignature: '513e3efdbb65f8e60e85ca98d8d065ec9bd3bfa6f45a1f48cfade9c94d410338ee64bd55938c168b10f0749335c050312785dbf08882ffd0e40a65fde8c2b10b',
  18. id: '871554a8346d84cab2147324706d8ab5494fde928a7463a68d536ed6c0357897' }

3.2 根据交易内容获取交易id

crypto.getId(transaction)

  1. > var targetAddress = "16358246403719868041";
  2. > var amount = 100*100000000; //100 XAS
  3. > var message = 'beizhu';
  4. > transaction = AschJS.transaction.createTransaction(targetAddress, amount, message, secret, secondSecret)
  5. { type: 0,
  6. amount: 10000000000,
  7. fee: 10000000,
  8. recipientId: '16358246403719868041',
  9. message: 'beizhu',
  10. timestamp: 40566970,
  11. asset: {},
  12. senderPublicKey: 'ebd4c62ebe2255b7ad5ee43120a9f9191c76e30928c92cd536351e3cc2c626ed',
  13. signature: '9bef374be100fcfec59d245af59e5646ba5dcb79c6f1399ddd676a617542eeb45cc363822b84410e379f0caa501c25b66e59142353c04d23d1cb95cf64cef306',
  14. signSignature: '513e3efdbb65f8e60e85ca98d8d065ec9bd3bfa6f45a1f48cfade9c94d410338ee64bd55938c168b10f0749335c050312785dbf08882ffd0e40a65fde8c2b10b',
  15. id: '871554a8346d84cab2147324706d8ab5494fde928a7463a68d536ed6c0357897' }
  16. > AschJS.crypto.getId(transaction)
  17. '871554a8346d84cab2147324706d8ab5494fde928a7463a68d536ed6c0357897' // 返回结果,交易id

4 资产相关uia

4.1 资产发行商注册,type=9

uia.createIssuer(name, desc, secret, secondSecret)
备注 在主链的交易类型为9

  1. var name = 'IssuerName'
  2. var desc = 'IssuerDesc'
  3. AschJS.uia.createIssuer(name, desc, secret, secondSecret)
  4. {
  5. "type": 9,
  6. "amount": 0,
  7. "fee": 10000000,
  8. "recipientId": null,
  9. "senderPublicKey": "fafcd01f6b813fdeb3c086e60bc7fa9bfc8ef70ae7be47ce0ac5d06e7b1a8575",
  10. "timestamp": 19395607,
  11. "asset": {
  12. "uiaIssuer": {
  13. "name": "IssuerName",
  14. "desc": "IssuerDesc"
  15. }
  16. },
  17. "signature": "c6ed2a4bafe2b8aa31f4aaceacc2a96cb028abbabb2ed062937498c58e24ca5467a340ddd63b67f809a680ff91b83e685c64991eb695494ddb2fdc57e5761607",
  18. "signSignature": "8eceacbd47c2b8ed335145ced19d7a3a51f99bdd6631d16ed214180c6f80e29bd6d572f45e7c7d685584e55cb5c303cf340406553ece28c9c0a2fa7a777aac0b"
  19. }

4.2 资产注册,type=10

uia.createAsset(name, desc, maximum , precision, strategy, secret, secondSecret)
备注 在主链的交易类型为10

  1. var name = 'IssuerName.CNY'
  2. var desc = '资产描述'
  3. var maximum = '1000000'
  4. var precision = 3
  5. var strategy = ''
  6. AschJS.uia.createAsset(name, desc, maximum , precision, strategy, secret, secondSecret)
  7. {
  8. "type": 10,
  9. "amount": 0,
  10. "fee": 10000000,
  11. "recipientId": null,
  12. "senderPublicKey": "fafcd01f6b813fdeb3c086e60bc7fa9bfc8ef70ae7be47ce0ac5d06e7b1a8575",
  13. "timestamp": 19397444,
  14. "asset": {
  15. "uiaAsset": {
  16. "name": "IssuerName.CNY",
  17. "desc": "资产描述",
  18. "maximum": "1000000",
  19. "precision": 3,
  20. "strategy": ""
  21. }
  22. },
  23. "signature": "c755587d331dd2eb62ef91dce1511d83a3e603c7cdc7548a16052519c21ea89c78364e35e5d46da0e2103fa2fb7f037eec55a5deba18826fa13e4252422d750e",
  24. "signSignature": "1b7ed4c21c477b8ff3d2acfdfd7ff85617093f4c21de70938c46b61c9704b037dbcf7f9e5f5dd1a5dc8f22cf473aaa459e6e5b15ced388b8a1da1e307987a509"
  25. }

4.3 资产设置访问控制列表(acl)模式,type=11

uia.createFlags(currency, flagType, flag, secret, secondSecret)
备注 在主链的交易类型为11

  1. var currency = 'IssuerName.CNY'
  2. var flagType = 1
  3. var flag = 1
  4. AschJS.uia.createFlags(currency, flagType, flag, secret, secondSecret)
  5. {
  6. "type": 11,
  7. "amount": 0,
  8. "fee": 10000000,
  9. "recipientId": null,
  10. "senderPublicKey": "fafcd01f6b813fdeb3c086e60bc7fa9bfc8ef70ae7be47ce0ac5d06e7b1a8575",
  11. "timestamp": 19400996,
  12. "asset": {
  13. "uiaFlags": {
  14. "currency": "IssuerName.CNY",
  15. "flagType": 1,
  16. "flag": 1
  17. }
  18. },
  19. "signature": "b96fb3d1456e1f26357109cc24d82834eb9a4687f29e69c374bbb1d534568336e148cac52f213aa4d2a69185092f8e1143b49ec4b8048cd9b3af4e20f6ba0b08",
  20. "signSignature": "b37c77ebebe90341346be2aefe1e12bd7403e5d8f4d6e8f04630190b3e09494a28820da0ffd5f9ff011033aa6d70fc9bb4c159a4493be3b18fd7ff470103570d"
  21. }

4.4 更新访问控制列表(acl),type=12

uia.createAcl(currency, operator, flag, list, secret, secondSecret)
备注 在主链的交易类型为12

  1. var currency = 'IssuerName.CNY'
  2. var operator = '+'
  3. var list = ['15745540293890213312']
  4. var flag =1
  5. AschJS.uia.createAcl(currency, operator, flag, list, secret, secondSecret)
  6. {
  7. "type": 12,
  8. "amount": 0,
  9. "fee": 20000000,
  10. "recipientId": null,
  11. "senderPublicKey": "fafcd01f6b813fdeb3c086e60bc7fa9bfc8ef70ae7be47ce0ac5d06e7b1a8575",
  12. "timestamp": 19403125,
  13. "asset": {
  14. "uiaAcl": {
  15. "currency": "IssuerName.CNY",
  16. "operator": "+",
  17. "flag": 1,
  18. "list": ["15745540293890213312"]
  19. }
  20. },
  21. "signature": "ad4060e04c1a12256de114e34499f8add24326753f1f8362991ee14aefc4c0fe90ff394d2db97e83770855a5688d463de00656fdd2d04604605cf3c04fdaca0e",
  22. "signSignature": "63129c58b1b9fcce88cbe829f3104a10ab06037253e9b65feb50ce0d2bb988533b93e8edcad016a85675f9027758fc318cf899ca7ef161a95a8d8a055ae83a02"
  23. }

4.5 资产发行,type=13

uia.createIssue(currency, amount, secret, secondSecret)
备注 在主链的交易类型为13

  1. var currency = 'IssuerName.CNY'
  2. var amount = '100000'
  3. AschJS.uia.createIssue(currency, amount, secret, secondSecret)
  4. {
  5. "type": 13,
  6. "amount": 0,
  7. "fee": 10000000,
  8. "recipientId": null,
  9. "senderPublicKey": "fafcd01f6b813fdeb3c086e60bc7fa9bfc8ef70ae7be47ce0ac5d06e7b1a8575",
  10. "timestamp": 19475744,
  11. "asset": {
  12. "uiaIssue": {
  13. "currency": "IssuerName.CNY",
  14. "amount": "100000"
  15. }
  16. },
  17. "signature": "32b01a18eca2b0dc7e2ce77ba4e758eaae2532f60844760a762cc20918e7439ac6ca585b921db6ede833ed0bf1c62e30cec545a928abafe0b679183a6ad02202",
  18. "signSignature": "4fc290d7d7d788e9112a56233df0fe796cba39be3efa0cebf00cbc7e5bc5fd1369fad49e5698d967845b5c02e427926049cab25845d4d385e4a395791906f909"
  19. }

4.6 资产转账,type=14

uia.createTransfer(currency, amount, recipientId, secret, secondSecret)
备注 在主链的交易类型为14

  1. var currency = 'IssuerName.CNY'
  2. var amount = '10000'
  3. var recipientId = 'AKKHPvQb2A119LNicCQWLZQDFxhGVEY57a'
  4. AschJS.uia.createTransfer(currency, amount, recipientId, secret, secondSecret)
  5. {
  6. "type": 14,
  7. "amount": 0,
  8. "fee": 10000000,
  9. "recipientId": "AKKHPvQb2A119LNicCQWLZQDFxhGVEY57a",
  10. "senderPublicKey": "fafcd01f6b813fdeb3c086e60bc7fa9bfc8ef70ae7be47ce0ac5d06e7b1a8575",
  11. "timestamp": 19481489,
  12. "asset": {
  13. "uiaTransfer": {
  14. "currency": "IssuerName.CNY",
  15. "amount": "10000"
  16. }
  17. },
  18. "signature": "77789071a2ad6d407b9d1e0d654a9deb6d85340a3d2a13d786030e26ac773b4e9b5f052589958d2b8553ae5fc9449496946b5c225e0baa723e7ddecbd89f060a",
  19. "signSignature": "f0d4a000aae3dd3fa48a92f792d4318e41e3b56cdbaf98649261ae34490652b87645326a432d5deb69f771c133ee4b67d2d22789197be34249e6f7f0c30c1705"
  20. }

4.7 资产注销,type=11

uia.createTransfer(currency, amount, recipientId, secret, secondSecret)
备注 在主链的交易类型为11

  1. var currency = 'IssuerName.CNY'
  2. var flagType = 2
  3. var flag =1
  4. AschJS.uia.createFlags(currency, flagType, flag, secret, secondSecret)
  5. {
  6. "type": 11,
  7. "amount": 0,
  8. "fee": 10000000,
  9. "recipientId": null,
  10. "senderPublicKey": "fafcd01f6b813fdeb3c086e60bc7fa9bfc8ef70ae7be47ce0ac5d06e7b1a8575",
  11. "timestamp": 19488690,
  12. "asset": {
  13. "uiaFlags": {
  14. "currency": "IssuerName.CNY",
  15. "flagType": 2,
  16. "flag": 1
  17. }
  18. },
  19. "signature": "cbd656552417604704703e1236ec2bbed8eba6a2ccfcb54cc0b2d629c0a9d1335a264fc9f6dee1705f4a86c36a5ce2ba8e039d913a189b7c273c8ac0d9e3780c",
  20. "signSignature": "3c7b91d03efeed2dc86e1f2301da60789751c1be8850460d8c66c0ae8f55ea27d26f0bc79541d74b4777d9b85c518c1c73c0284dbf3e826db0a686560e57a80b"
  21. }

5 受托人delegate

5.1 注册受托人,type=2

delegate.createDelegate(username, secret, secondSecret)
备注 在主链的交易类型为2

  1. > var userName='zhenxi'
  2. undefined
  3. > AschJS.delegate.createDelegate(userName, secret, secondSecret || undefined)
  4. { type: 2,
  5. amount: 0,
  6. fee: 10000000000,
  7. recipientId: null,
  8. senderPublicKey: 'ebd4c62ebe2255b7ad5ee43120a9f9191c76e30928c92cd536351e3cc2c626ed',
  9. timestamp: 40568017,
  10. asset:
  11. { delegate:
  12. { username: 'zhenxi',
  13. publicKey: 'ebd4c62ebe2255b7ad5ee43120a9f9191c76e30928c92cd536351e3cc2c626ed' } },
  14. signature: 'e471ade7ded7785f597821f8946d4e98da5ba4331505141c5bea5ff80bbf30b649218ef03254ac703ce93e15207c8b71c69c0d1400cb5790440860ed0e51a30a',
  15. signSignature: 'ec47d565a70e6ad075abaf1ff55c129bde9495e4cc7ab2a9404b698ef257f3b1cfd0ce4f9f1854a1bbfec0f663867823a544f80964e3be05ddf03a50a9b77d07',
  16. id: '774ccf5e7d9d9fefa459b23d96e10ffae4bb891e1e07912ac1370af04192e810' }

5.2 给受托人增加/取消投票,type=3

vote.createVote(keyList, secret, secondSecret)
备注 在主链的交易类型为3

  1. // 投票内容是一个列表,列表中的每一个元素是一个符号加上所选择的受托人的公钥,符号为+表示投票,符号为-表示取消投票
  2. > var voteContent = [
  3. ... '-ae256559d06409435c04bd62628b3e7ea3894c43298556f52b1cfb01fb3e3dc7',
  4. ... '+c292db6ea14d518bc29e37cb227ff260be21e2e164ca575028835a1f499e4fe2'
  5. ... ];
  6. undefined
  7. > transaction=AschJS.vote.createVote(voteContent, secret, secondSecret || undefined);
  8. { type: 3,
  9. amount: 0,
  10. fee: 10000000,
  11. recipientId: null,
  12. senderPublicKey: 'ebd4c62ebe2255b7ad5ee43120a9f9191c76e30928c92cd536351e3cc2c626ed',
  13. timestamp: 40568669,
  14. asset: { vote: { votes: [Array] } },
  15. signature: '66f6f3c4fbb8545df53ea35ff655fc1a28815591885757d0b735e77ed348caf33d8d9cb2895f85cd40bf2d3b4633f45a19ebd1dd130233305a603304a92ce003',
  16. signSignature: 'c026d373e026b524efd82ad1ab046708ee1ff68573f016490d12908f5ad00a97fa7501f46834c94f6dd64afd00aa77f9d29ded087977ac6601778d4aacb5cd0e',
  17. id: '0789524787384e2e4da7773afdd3871193a67303c4da69c4a9070eaa5676d36c' }
  18. > transaction.asset.vote.votes
  19. [ '-ae256559d06409435c04bd62628b3e7ea3894c43298556f52b1cfb01fb3e3dc7',
  20. '+c292db6ea14d518bc29e37cb227ff260be21e2e164ca575028835a1f499e4fe2' ]

6 dapp相关

6.1 dapp注册,type=5

dapp.createDApp(options, secret, secondSecret)
备注 在主链的交易类型为5

  1. > var options = { name: 'asch-dapp-cctime',
  2. ... link: 'https://github.com/AschPlatform/asch-dapp-cctime/archive/master.zip',
  3. ... category: 1,
  4. ... description: 'Decentralized news channel',
  5. ... tags: 'asch,dapp,demo,cctime',
  6. ... icon: 'http://o7dyh3w0x.bkt.clouddn.com/hello.png',
  7. ... type: 0,
  8. ... delegates:
  9. ... [ '8b1c24a0b9ba9b9ccf5e35d0c848d582a2a22cca54d42de8ac7b2412e7dc63d4',
  10. ... 'aa7dcc3afd151a549e826753b0547c90e61b022adb26938177904a73fc4fee36',
  11. ... 'e29c75979ac834b871ce58dc52a6f604f8f565dea2b8925705883b8c001fe8ce',
  12. ... '55ad778a8ff0ce4c25cb7a45735c9e55cf1daca110cfddee30e789cb07c8c9f3',
  13. ... '982076258caab20f06feddc94b95ace89a2862f36fea73fa007916ab97e5946a' ],
  14. ... unlockDelegates: 3 };
  15. undefined
  16. > trs=AschJS.dapp.createDApp(options, secret);
  17. { type: 5,
  18. amount: 0,
  19. fee: 10000000000,
  20. recipientId: null,
  21. senderPublicKey: 'ebd4c62ebe2255b7ad5ee43120a9f9191c76e30928c92cd536351e3cc2c626ed',
  22. timestamp: 40572296,
  23. asset:
  24. { dapp:
  25. { category: 1,
  26. name: 'asch-dapp-cctime',
  27. description: 'Decentralized news channel',
  28. tags: 'asch,dapp,demo,cctime',
  29. type: 0,
  30. link: 'https://github.com/AschPlatform/asch-dapp-cctime/archive/master.zip',
  31. icon: 'http://o7dyh3w0x.bkt.clouddn.com/hello.png',
  32. delegates: [Array],
  33. unlockDelegates: 3 } },
  34. signature: '5a8e2dba5e14b4ec62ce1b8543de2796d3cded249ed899c5049dd0adeff00963dd40436e7cfc6f9952e09d5c6ac8f5144d3e568f263586520c68012d3c7ca509',
  35. id: 'ecf9366a128408b843f0e6b2bd7261a4d602c32ae36a8c3cef609e904f180735' }
  36. > trs.asset.dapp.delegates
  37. [ '8b1c24a0b9ba9b9ccf5e35d0c848d582a2a22cca54d42de8ac7b2412e7dc63d4',
  38. 'aa7dcc3afd151a549e826753b0547c90e61b022adb26938177904a73fc4fee36',
  39. 'e29c75979ac834b871ce58dc52a6f604f8f565dea2b8925705883b8c001fe8ce',
  40. '55ad778a8ff0ce4c25cb7a45735c9e55cf1daca110cfddee30e789cb07c8c9f3',
  41. '982076258caab20f06feddc94b95ace89a2862f36fea73fa007916ab97e5946a' ]

6.2 dapp充值,type=6

transfer.createInTransfer(dappid, currency, amount, secret, secondSecret);
备注 在主链的交易类型为6

  1. var dappid = "bebe3c57d76a5bbe3954bd7cb4b9e381e8a1ba3c78e183478b4f98b9d532f024";
  2. var currency = "XAS";
  3. var amount = 10*100000000 ;
  4. > AschJS.transfer.createInTransfer(dappid, currency, amount, secret, secondSecret || undefined);
  5. { type: 6,
  6. amount: 1000000000,
  7. fee: 10000000,
  8. recipientId: null,
  9. senderPublicKey: 'ebd4c62ebe2255b7ad5ee43120a9f9191c76e30928c92cd536351e3cc2c626ed',
  10. timestamp: 40578327,
  11. asset:
  12. { inTransfer:
  13. { dappId: 'bebe3c57d76a5bbe3954bd7cb4b9e381e8a1ba3c78e183478b4f98b9d532f024',
  14. currency: 'XAS' } },
  15. signature: '6907c1402c702e0fd504a8734a047c1bb216d437e65d5675325846b92ef8b916fc634ea7e33a7c72c60c058d1496d0385c95e39a8291e27b2dceb2f40b6aed02',
  16. signSignature: '86de438431c639124a13429e8c6a8c13a5cbbbab3a8323ae08b56f65faeff6d816815d7cdecfdb7287077b14e4d14865637efc9d7fd72d085b0aa9d82f27170c',
  17. id: '25be71c296430a409cfeaf1ffaa957d18793f3695db07a846c22a7c467c45994' }

6.3 dapp内部合约调用

dapp.createInnerTransaction(options, secret)

自定如下全局变量,用于下面子章节代码演示。

  1. > var fee = String(0.1 * 100000000); // 目前dapp内置合约调用的手续费统一为10000000 对应的资产

6.3.1 dapp提现,合约type=2

args '["资产名字","提现数额"]'

  1. > var type = 2; // 这里的type指的是合约标号,而非主链的交易类型
  2. > var options = {fee: fee, type: type, args: '["CCTime.XCT", "100000000"]'};
  3. > AschJS.dapp.createInnerTransaction(options, secret);
  4. { fee: '10000000',
  5. timestamp: 40572732,
  6. senderPublicKey: 'ebd4c62ebe2255b7ad5ee43120a9f9191c76e30928c92cd536351e3cc2c626ed',
  7. type: 2,
  8. args: '["CCTime.XCT", "100000000"]',
  9. signature: 'a0d860a0c13cf40d6be08f42a66bf01264f96fadc8ed2997139c583ba7fcd5e7ceeda9207c635215ddfd60bde8c35914cdfe2b03a4862cdd187b9142d497c301' }

6.3.2 dapp内部转账,合约type=3

args '["资产名字","转账数额","接收地址"]'

  1. > var type = 3;
  2. > var options = {fee: fee, type: type, args: '["CCTime.XCT", "100000000", "A6H9rawJ7qvE2rKwQfdtBHdeYVehB8gFzC"]'};
  3. > AschJS.dapp.createInnerTransaction(options, secret);
  4. { fee: '10000000',
  5. timestamp: 40573272,
  6. senderPublicKey: 'ebd4c62ebe2255b7ad5ee43120a9f9191c76e30928c92cd536351e3cc2c626ed',
  7. type: 3,
  8. args: '["CCTime.XCT", "100000000", "A6H9rawJ7qvE2rKwQfdtBHdeYVehB8gFzC"]',
  9. signature: '3843bef77ad7c6f2b57083270055720186b8ba286cd44e263028eef9b8650ecf6d243c1861f9b9416e123b594695934430deb0f5146a173ebfcdccb6915acf0c' }

6.3.4 dapp内设置昵称,合约type=3

args '["昵称"]'

  1. > var type = 4;
  2. > var options = {fee: fee, type: type, args: '["nicheng"]'};
  3. > AschJS.dapp.createInnerTransaction(options, secret);
  4. { fee: '10000000',
  5. timestamp: 40573343,
  6. senderPublicKey: 'ebd4c62ebe2255b7ad5ee43120a9f9191c76e30928c92cd536351e3cc2c626ed',
  7. type: 4,
  8. args: '["nicheng"]',
  9. signature: '172998ddbb2ef72037be673d658dbc64760da307d451257666c956868b142707cd4aa38668b52d1d0d7cc62c01866daef2bae8d427844194d42ca9fea97ea70b' }

6.4 dapp提现

6.4.1 创建提现交易,type=7

transfer.createOutTransfer(recipientId, dappId, transactionId, currency, amount, secret, secondSecret)
备注 在主链的交易类型为7,该接口一般由dapp受托人来调用(受托人每隔10秒扫描侧链上由智能合约所创建的提现交易,发现后则在主链创建type=7的提现交易),所以一般情况下开发人员用不到。

  1. let recipientId = 'AFUH568CbGC2GPcE4gXHiZhxdYQYfziz2J';
  2. let dappId = 'bebe3c57d76a5bbe3954bd7cb4b9e381e8a1ba3c78e183478b4f98b9d532f024';
  3. let transactionId = '123b04a6e380500903d8942622d57987661e72b2ae95464066d0af3f02c3c691';
  4. let currency = 'XAS'
  5. let amount = '10000000'
  6. > transaction = AschJS.transfer.createOutTransfer(recipientId, dappId, transactionId, currency, amount, secret, secondSecret);
  7. { type: 7,
  8. amount: 0,
  9. fee: 10000000,
  10. recipientId: 'AFUH568CbGC2GPcE4gXHiZhxdYQYfziz2J',
  11. senderPublicKey: 'ebd4c62ebe2255b7ad5ee43120a9f9191c76e30928c92cd536351e3cc2c626ed',
  12. timestamp: 40668981,
  13. asset:
  14. { outTransfer:
  15. { dappId: 'bebe3c57d76a5bbe3954bd7cb4b9e381e8a1ba3c78e183478b4f98b9d532f024',
  16. transactionId: '123b04a6e380500903d8942622d57987661e72b2ae95464066d0af3f02c3c691',
  17. currency: 'XAS',
  18. amount: '10000000' } },
  19. signature: '432d25e5c5b81fa3a5937adca2dd4a1e2a38e51f8896838601902e0c123a5ccb664bbc8a55344b9fedb773da98e0988e4e8d1ca99dcbc51a80ea3bc9a6b61806',
  20. signSignature: '8154c1f8305b9b957974e778de1e08dd3f08afcb70f27624d1385dbae9dfa6d0a3aaed6211ed8a40f4015f7e47312f0f205d94518c68e4deec8d76567f56f10f',
  21. id: '237925a60ccc0abfc1494720aab8c11c74ba61e8ab3ca4bd8ded8c3215c201a7' }

6.4.2 受托人对提现交易进行签名

transfer.signOutTransfer(transaction, secret)
备注 dapp提现交易,需要多个受托人签名后才能生效。受托人签名的最小数量取决于dapp的注册参数:unlockDelegates。受托人每隔10秒扫描侧链上由智能合约所创建的提现交易,发现有交易且签名个数未满足时,会对其进行签名。一般情况下普通开发人员用不到。

  1. // 沿用上一章节《6.4.1 创建提现交易,type=7》的变量
  2. transaction.signatures = [] // 受托人签名列表
  3. // 第1个受托人对提现交易transaction进行签名
  4. delegate1_secret = 'chalk flame jeans rebuild dutch stone abstract capital lucky pottery raven depend'
  5. > signature1 = AschJS.transfer.signOutTransfer(transaction,delegate1_secret);
  6. 'ac0ea4c10b911f2134e5adfb3535ffc070ffa8f2858a5a1bc4e9bef442863e117e6bce552bba0d5b0160c4076dd3c657ebc33cbe077a8ef719798a8bb0fac30c'
  7. transaction.signatures.push(signature1) // 将签名加入到transaction的签名列表中
  8. // 第2个受托人对提现交易transaction进行签名
  9. delegate2_secret = 'twist arrange matter twice daughter cave cause never enough scare warfare uncover'
  10. > signature2 = AschJS.transfer.signOutTransfer(transaction,delegate2_secret);
  11. '480e0717e4be02e48a27e2323bf6507c4c72d1033b4e7e674651e9e4feced17836f0b81b91ade99b61620a2766ecc901f090d81cc72d22b86807ae981eb2d10c'
  12. transaction.signatures.push(signature2) // 将签名加入到transaction的签名列表中
  13. // 依次类推,多个受托人都对该交易进行签名,当满足最小签名个数时,该提现交易才会真正生效
  14. > transaction
  15. { type: 7,
  16. amount: 0,
  17. fee: 10000000,
  18. recipientId: 'AFUH568CbGC2GPcE4gXHiZhxdYQYfziz2J',
  19. senderPublicKey: 'ebd4c62ebe2255b7ad5ee43120a9f9191c76e30928c92cd536351e3cc2c626ed',
  20. timestamp: 40669013,
  21. asset:
  22. { outTransfer:
  23. { dappId: 'bebe3c57d76a5bbe3954bd7cb4b9e381e8a1ba3c78e183478b4f98b9d532f024',
  24. transactionId: '123b04a6e380500903d8942622d57987661e72b2ae95464066d0af3f02c3c691',
  25. currency: 'XAS',
  26. amount: '10000000' } },
  27. signature: '1dfae733408d374cd7be5f4b55183c0c05dc31341f93daaf82c26c80ab11035202502180dd78c5643edcd3bb481a38f352408bc35e44e6c1c53c95612fbca804',
  28. signSignature: '8f4f7aa06c02c0a3d637329e1a3b23489b91797b9f3477afd4314b2f78d1e8e8a369a640d75916bd9477e69363cf440c27124db615dced1701a1a934714afe05',
  29. id: '95a0c4ac9d5397452629b89410413f54ed37caee84a13edf3c9c26d3d0606dab',
  30. signatures:
  31. [ 'ac0ea4c10b911f2134e5adfb3535ffc070ffa8f2858a5a1bc4e9bef442863e117e6bce552bba0d5b0160c4076dd3c657ebc33cbe077a8ef719798a8bb0fac30c',
  32. '480e0717e4be02e48a27e2323bf6507c4c72d1033b4e7e674651e9e4feced17836f0b81b91ade99b61620a2766ecc901f090d81cc72d22b86807ae981eb2d10c' ] // 受托人签名数组
  33. }

7 存储storage

7.1 创建存储交易,type=8

storage.createStorage(content, secret, secondSecret)
备注 在主链的交易类型为8

  1. > var content = new Buffer('helloworld').toString('hex')
  2. > AschJS.storage.createStorage(content, secret, secondSecret)
  3. { type: 8,
  4. amount: 0,
  5. fee: 10000000,
  6. recipientId: null,
  7. senderPublicKey: 'ebd4c62ebe2255b7ad5ee43120a9f9191c76e30928c92cd536351e3cc2c626ed',
  8. timestamp: 40578932,
  9. asset: { storage: { content: '68656c6c6f776f726c64' } },
  10. signature: 'd7f3f29549542d6716bdb13e8e1f97e3965c6fbe34f1ee18dbdcad7ba9cbf83ee7cb2b7fcbaab5ffed5d569771731bb5a40efc4fabd142cb30becdad8bc8bb06',
  11. signSignature: '38315bf369540cc7a793139b1b6195f4c0e1512514d62bf028d454182a4b7a8912c1b1e6f617f6fb4ff8d80bd141a2ebb9dfcaa8fee68cfc81f8872611bba803',
  12. id: '4d0b04a6e380500903d8942622d57987661e72b2ae95464066d0af3f02c3c691' }

8 签名验证相关crypto

自定义如下已签名的转账交易内容(在主链给16358246403719868041转账100XAS),用于下面章节演示。

  1. > var targetAddress = "16358246403719868041";
  2. > var amount = 100*100000000; //100 XAS
  3. > var message = 'beizhu';
  4. > transaction = AschJS.transaction.createTransaction(targetAddress, amount, message, secret, secondSecret)
  5. { type: 0,
  6. amount: 10000000000,
  7. fee: 10000000,
  8. recipientId: '16358246403719868041',
  9. message: 'beizhu',
  10. timestamp: 40566970,
  11. asset: {},
  12. senderPublicKey: 'ebd4c62ebe2255b7ad5ee43120a9f9191c76e30928c92cd536351e3cc2c626ed',
  13. signature: '9bef374be100fcfec59d245af59e5646ba5dcb79c6f1399ddd676a617542eeb45cc363822b84410e379f0caa501c25b66e59142353c04d23d1cb95cf64cef306',
  14. signSignature: '513e3efdbb65f8e60e85ca98d8d065ec9bd3bfa6f45a1f48cfade9c94d410338ee64bd55938c168b10f0749335c050312785dbf08882ffd0e40a65fde8c2b10b',
  15. id: '871554a8346d84cab2147324706d8ab5494fde928a7463a68d536ed6c0357897' }

8.1 根据交易内容获取字节Buffer对象

getBytes(transaction, skipSignature, skipSecondSignature)

  1. // 此时transaction.signature和transaction.signSignature都会计算在内
  2. > AschJS.crypto.getBytes(transaction)
  3. <Buffer 00 ba 00 6b 02 eb d4 c6 2e be 22 55 b7 ad 5e e4 31 20 a9 f9 19 1c 76 e3 09 28 c9 2c d5 36 35 1e 3c c2 c6 26 ed e3 04 2a 6f 3a 08 ae 89 00 e4 0b 54 02 ... > // 返回的字节buffer对象

8.2 根据交易内容获取Hash Buffer对象

getHash(transaction, skipSignature, skipSecondSignature)

  1. // 此时transaction.signature和transaction.signSignature都会计算在内
  2. > AschJS.crypto.getHash(transaction)
  3. <Buffer 87 15 54 a8 34 6d 84 ca b2 14 73 24 70 6d 8a b5 49 4f de 92 8a 74 63 a6 8d 53 6e d6 c0 35 78 97> // 返回的Hash Buffer

8.3 根据交易内容获取交易id

crypto.getId(transaction)

  1. > AschJS.crypto.getId(transaction)
  2. '871554a8346d84cab2147324706d8ab5494fde928a7463a68d536ed6c0357897' // 返回结果,交易id

8.4 对交易Bytes Buffer进行签名

crypto.signBytes(bytes, keys)

  1. // 定义未签名交易
  2. > var trs = { type: 0,
  3. ... amount: 10000000000,
  4. ... fee: 10000000,
  5. ... recipientId: '16358246403719868041',
  6. ... message: 'beizhu',
  7. ... timestamp: 40566970,
  8. ... asset: {}}
  9. // 根据密码,生成
  10. > keys = AschJS.crypto.getKeys(secret)
  11. { publicKey: 'ebd4c62ebe2255b7ad5ee43120a9f9191c76e30928c92cd536351e3cc2c626ed',
  12. privateKey: '7ae536fa343281d9e9ed383e8b5ef62e0fd0d0cbed79786cac241d484e312fdeebd4c62ebe2255b7ad5ee43120a9f9191c76e30928c92cd536351e3cc2c626ed' }
  13. > trs.senderPublicKey = keys.publicKey;
  14. 'ebd4c62ebe2255b7ad5ee43120a9f9191c76e30928c92cd536351e3cc2c626ed'
  15. // 获取交易的Bytes Buffer
  16. > buf = AschJS.crypto.getBytes(trs)
  17. // 通过私钥对交易Bytes Buffer进行签名
  18. > signature = AschJS.crypto.signBytes(buf,keys)
  19. '9bef374be100fcfec59d245af59e5646ba5dcb79c6f1399ddd676a617542eeb45cc363822b84410e379f0caa501c25b66e59142353c04d23d1cb95cf64cef306' // 返回值与上面自定义的已签名交易中的签名一致

8.5 验证交易签名是否和已存在的签名一致

crypto.verifyBytes(bytes, signature, publicKey) 返回true/false

  1. // 沿用上一章节《对交易Bytes Buffer进行签名》的变量
  2. > AschJS.crypto.verifyBytes(buf,transaction.signature,transaction.senderPublicKey)
  3. true // 本章最上面自定义的transaction签名一致

9 其它

9.1 全局参数变量options

9.1.1 设置变量k/v

options.set(key, values)

  1. > AschJS.options.set('secret','minor borrow display rebel depart core buzz right distance avocado immense push')
  2. undefined

9.1.2 根据key获取value

options.get(key)

  1. > AschJS.options.get('secret')
  2. 'minor borrow display rebel depart core buzz right distance avocado immense push'

9.1.3 获取所有的k/v

options.getAll()

  1. > AschJS.options.getAll()
  2. { clientDriftSeconds: 5, // asch-js内置变量
  3. secret: 'minor borrow display rebel depart core buzz right distance avocado immense push' }

9.2 时间相关slot.time

9.2.1 asch主网创世块生成时间

utils.slots.beginEpochTime()
备注 结果为UTC时间,即Asch纪元的开始时间。

  1. > AschJS.utils.slots.beginEpochTime()
  2. 2016-06-27T20:00:00.000Z // Asch主网创世块生成时间,但主网正式运行是在8月16号那天(主网正式运行的标志是 生成了block heihgt=2的区块)

9.2.2 根据unix时间戳获获Asch时间戳

utils.slots.getTime(time)
备注 获得结果叫做EpochTim(Asch时间戳),传入的time相对于Asch纪元经历的秒数

  1. > AschJS.utils.slots.getTime()
  2. 40655681 // Asch时间戳
  3. > unix_timestamp = 1507713496
  4. > epochTime = AschJS.utils.slots.getTime(unix_timestamp * 1000)
  5. 40655896 // Asch时间戳

9.2.3 根据Asch时间戳获取unix时间戳

utils.slots.getRealTime(epochTime)
备注 返回结果是真实的 unix时间戳* 1000

  1. > unix_timestamp = 1507713496 // unix时间戳
  2. > epochTime = AschJS.utils.slots.getTime(unix_timestamp * 1000)
  3. 40655896 // 通过unix时间戳获取到asch时间戳
  4. > real_time = AschJS.utils.slots.getRealTime(epochTime)
  5. 1507713496000 // 通过asch时间戳获取unix时间戳
  6. > unix_timestamp === real_time/1000
  7. true // 换算结果一致
添加新批注
在作者公开此批注前,只有你和作者可见。
回复批注