Examples

Search…
Examples
This document describes how to interact with ICON Network using JavaScript SDK. This document contains SDK installation, API usage guide, and code examples.
This document is focused on serving the following groups.
Web Developer using JavaScript as the main language
Web Developer who wants to make dApp using ICON Network
This document is focused on how to use icon-sdk-js properly. If you would like to know about the details of icon-sdk-js API, see official icon-sdk-js API Reference document.
Get different types of examples as follows. Complete source code is found on Github at https://github.com/icon-project/icon-sdk-js/tree/master/quickstart​
Example
Description
​Wallet​
An example of creating and loading a keywallet.
​ICX Transfer​
An example of transferring ICX and confirming the result.
​Token Deploy and Transfer​
An example of deploying an IRC token, transferring the token and confirming the result.
​Sync Block​
An example of checking block confirmation and printing the ICX and token transfer information.
Installation
Usage in Node.js
Install icon-sdk-js module using npm.
1
npm install --save icon-sdk-js
Copied!
Import icon-sdk-js module.
1
const IconService = require('icon-sdk-js');
Copied!
Usage in browser
Install icon-sdk-js module using npm,
1
npm install --save icon-sdk-js
Copied!
or using CDN.
1
<script src="https://cdn.jsdelivr.net/gh/icon-project/[email protected]/build/icon-sdk-js.web.min.js"></script>
Copied!
Then, import icon-sdk-js module.
1
import IconService from 'icon-sdk-js';
Copied!
Usage in react-native environment
Install icon-sdk-js module using npm,
1
npm install --save icon-sdk-js
Copied!
Then, import icon-sdk-js/build/icon-sdk-js.web.min.js module.
1
import IconService from 'icon-sdk-js/build/icon-sdk-js.web.min.js';
Copied!
Using the SDK
Generate IconService
Generate IconService to communicate with the nodes.
The IconService class contains a set of API methods. It allows you to send transaction, check the result and get block information, etc. It accepts the HttpProvider which serves the purpose of connecting to HTTP and HTTPS based JSON-RPC servers. The HttpProvider takes the full URI where the server can be found. Here is a simple example how to initialize IconService class.
1
/*  HttpProvider is used to communicate with http. 
2
    In this example, we use Yeouido node as provider. */
3
const provider = new HttpProvider('https://bicon.net.solidwallet.io/api/v3');
4
​
5
/* Create IconService instance */
6
const iconService = new IconService(provider);
Copied!
Queries
All query methods of IconService returns a HttpCall instance. To execute the request and get the result value, you need to run execute() function of HttpCall instance. All requests will be executed asynchronously. Synchronous request is not available. For more information, check the API reference documentation.
1
const { CallBuilder } = IconService.IconBuilder;
2
​
3
/* Get block information by block height */
4
const block = await iconService.getBlockByHeight(1000).execute();
5
​
6
/* Get block information by block hash */
7
const block = await iconService.getBlockByHash('0xdb3···d95').execute();
8
​
9
/* Get latest block information */
10
const block = await iconService.getLastBlock().execute();
11
​
12
/* Returns the balance of a EOA address */
13
const balance = await iconService.getBalance('hx9d8···b57').execute();
14
​
15
/* Returns the SCORE API list */
16
const apiList = await iconService.getScoreApi('cx000···001').execute();
17
​
18
/* Returns the total number of issued ICX. */
19
const totalSupply = await iconService.getTotalSupply().execute();
20
​
21
/* Returns information about a transaction requested by transaction hash */
22
const txObj = await iconService.getTransaction('0xb90···238').execute();
23
​
24
/* Returns the result of a transaction by transaction hash */
25
const txObj = await iconService.getTransactionResult('0xb90···238').execute();
26
​
27
/* Generates a call instance using the CallBuilder */
28
const callObj = new CallBuilder()
29
    .to('cxc24···6c7')
30
    .method('balanceOf')
31
    .params({ _owner: 'hx87a···d6a' })
32
    .build()
33
​
34
/* Executes a call method to call a read-only API method on the SCORE immediately without creating a transaction on Loopchain */
35
const result = await iconService.call(callObj).execute();
Copied!
Transactions
To invoke SCORE API for changing states, you need to send a transaction. Before sending a transaction, the transaction should be signed. It can be done using the Wallet object.
1
const { IconWallet } = IconService;
2
​
3
/* Creates an instance of Wallet. */
4
const wallet = IconWallet.create();
5
​
6
/* Load Wallet object by private key */
7
const wallet = IconWallet.loadPrivateKey('2ab···e4c');
8
​
9
/* Load Wallet object by keystore object */
10
const ks = { "version": 3 ··· "coinType": "icx" };
11
const pw = 'qwer1234!';
12
const wallet = IconWallet.loadKeystore(ks, pw);
Copied!
Next, you need to build the transaction object using builder class.
1
/* Build `IcxTransaction` instance for sending ICX. */
2
const txObj = new IcxTransactionBuilder()
3
    .from('hx462···bfd')
4
    .to('hx87a···d6a')
5
    .value(IconAmount.of(7, IconAmount.Unit.ICX).toLoop())
6
    .stepLimit(IconConverter.toBigNumber(100000))
7
    .nid(IconConverter.toBigNumber(3))
8
    .nonce(IconConverter.toBigNumber(1))
9
    .version(IconConverter.toBigNumber(3))
10
    .timestamp((new Date()).getTime() * 1000)
11
    .build()
12
​
13
/* Build `MessageTransaction` instance for sending data. */
14
const txObj = new MessageTransactionBuilder()
15
    .from('hx462···bfd')
16
    .to('hx87a···d6a')
17
    .stepLimit(IconConverter.toBigNumber(100000))
18
    .nid(IconConverter.toBigNumber(3))
19
    .nonce(IconConverter.toBigNumber(1))
20
    .version(IconConverter.toBigNumber(3))
21
    .timestamp((new Date()).getTime() * 1000)
22
    .data(IconConverter.fromUtf8('Hello'))
23
    .build()
24
​
25
/* Build `DeployTransaction` instance for deploying SCORE. */
26
const txObj = new DeployTransactionBuilder()
27
    .from('hx462···bfd')
28
    .to('cx000···000')
29
    .stepLimit(IconConverter.toBigNumber(2500000))
30
    .nid(IconConverter.toBigNumber(3))
31
    .nonce(IconConverter.toBigNumber(1))
32
    .version(IconConverter.toBigNumber(3))
33
    .timestamp((new Date()).getTime() * 1000)
34
    .contentType('application/zip')
35
    .content('0x504···000')
36
    .params({
37
        initialSupply: IconConverter.toHex('100000000000'),
38
        decimals: IconConverter.toHex(18),
39
        name: 'StandardToken',
40
        symbol: 'ST',
41
    })
42
    .build()
43
​
44
/* Build `CallTransaction` instance for executing SCORE function. */
45
const txObj = new CallTransactionBuilder()
46
    .from('hx902···3b5')
47
    .to('cx350···48d')
48
    .stepLimit(IconConverter.toBigNumber('2000000'))
49
    .nid(IconConverter.toBigNumber('3'))
50
    .nonce(IconConverter.toBigNumber('1'))
51
    .version(IconConverter.toBigNumber('3'))
52
    .timestamp((new Date()).getTime() * 1000)
53
    .method('transfer')
54
    .params({
55
        _to: 'hxd00···497',
56
        _value: IconConverter.toHex(IconAmount.of(1, IconAmount.Unit.ICX).toLoop()),
57
    })
58
    .build()
Copied!
Using SignedTransaction object, you can make signature for transaction object. By passing SignedTransaction instance to IconService.sendTransaction() method, it will automatically generate transaction object including signature, and send to ICON node.
sendTransaction method returns a HttpCall instance. To execute the request and get the result value, you need to run execute() function of HttpCall instance. All requests will be executed asynchronously. Synchronous request is not available.
1
/* Create SignedTransaction instance */
2
const signedTransaction = new SignedTransaction(txObj, wallet)
3
​
4
/* Send transaction. It returns transaction hash. */
5
const txHash = await iconService.sendTransaction(signedTransaction).execute();
Copied!
Code Examples
Install Dependency
Please go to quickstart directory and install dependency to use icon-sdk-js.
1
npm install   // install dependencies for executing the quickstart project (including icon-sdk-js package)
Copied!
Run example file
Run example file.
1
npm start   // open http://localhost:3000/ in browser
Copied!
If you want to rebuild icon-sdk-js library and run quickstart project, go to icon-sdk-js root directory and run npm run quickstart:rebuild command.
1
npm run quickstart:rebuild   // open http://localhost:3000/ in browser
Copied!
Set Node URL
If you want to use custom ICON node URL, change the value of NODE_URL variable in ./mockData/index.js. Default value of NODE_URL is https://bicon.net.solidwallet.io/api/v3
For more information on the testnet, see the documentation for the ICON network.
1
const NODE_URL = 'https://bicon.net.solidwallet.io/api/v3';
Copied!
​
Wallet
This example shows how to create a new Wallet and load wallet with privateKey or Keystore file.
Create a wallet
Create new EOA by calling create function. After creation, the address and private Key can be looked up.
1
const wallet = IconWallet.create(); //Wallet Creation
2
console.log("Address: " + wallet.getAddress()); // Address Check
3
console.log("PrivateKey: " + wallet.getPrivateKey()); // PrivateKey Check
4
​
5
// Output
6
Address: hx4d37a7013c14bedeedbe131c72e97ab337aea159
7
PrivateKey: 00e1d6541bfd8be7d88be0d24516556a34ab477788022fa07b4a6c1d862c4de516
Copied!
Load a wallet
You can call existing EOA by calling loadKeystore and loadPrivateKey function.
After creation, address and private Key can be looked up.
1
// Load Wallet with private key
2
const walletLoadedByPrivateKey = IconWallet.loadPrivateKey('38f792b95a5202ab431bfc799f7e1e5c74ec0b9ede5c6142ee7364f2c84d72f6');
3
console.log(walletLoadedByPrivateKey.getAddress());
4
// Output: hx902ecb51c109183ace539f247b4ea1347fbf23b5
5
console.log(walletLoadedByPrivateKey.getPrivateKey());
6
// Output: 38f792b95a5202ab431bfc799f7e1e5c74ec0b9ede5c6142ee7364f2c84d72f6);
7
​
8
// Get keystore object from wallet
9
const keystoreFile = walletLoadedByPrivateKey.store('qwer1234!');
10
// Load wallet with keystore file
11
const walletLoadedByKeyStore = IconWallet.loadKeystore(keystoreFile, 'qwer1234!');
12
console.log(walletLoadedByKeyStore.getAddress());
13
// Output: hx902ecb51c109183ace539f247b4ea1347fbf23b5
14
console.log(walletLoadedByKeyStore.getPrivateKey());
15
// Output: 38f792b95a5202ab431bfc799f7e1e5c74ec0b9ede5c6142ee7364f2c84d72f6);
Copied!
Store the wallet
After Wallet object creation, Keystore file can be stored by calling store function.
After calling store, Keystore JSON object can be looked up with the returned value.
1
const privateKey = '38f792b95a5202ab431bfc799f7e1e5c74ec0b9ede5c6142ee7364f2c84d72f6'
2
const wallet = IconWallet.loadPrivateKey(privateKey);
3
console.log(wallet.store('qwer1234!'));
4
// Output: 
5
// {
6
//     "version": 3,
7
//     "id": "e00e113c-1e45-47e4-b732-10f3d1903d75",
8
//     "address": "hx7d3d4c743bb82b927ea8a0551a3b9288e722ac84",
9
//     "crypto": {
10
//         "ciphertext": "d5df37230528bbfc0015e93c61e60041a31fb63266f61ffec60a31f474d4d7d0",
11
//         "cipherparams": {
12
//             "iv": "feaf0cc19678e4b78369904a99ba411e"
13
//         },
14
//         "cipher": "aes-128-ctr",
15
//         "kdf": "scrypt",
16
//         "kdfparams": {
17
//             "dklen": 32,
18
//             "salt": "e2e3666919161044f7b369d6ad4296380d4a13b9b5e844301c64a502ea3da240",
19
//             "n": 16384,
20
//             "r": 8,
21
//             "p": 1
22
//         },
23
//         "mac": "43789e78de4744d06c14cf966b9609fadbcd815b5380caf3f778797f9824d9d7"
24
//     }
25
// }
Copied!
ICX Transfer
This example shows how to transfer ICX and check the result.
For the Wallet and IconService creation, please refer to the information above.
ICX transfer transaction
In this example, you can create a Wallet with MockData.PRIVATE_KEY_1 and transfer 1 ICX to MockData.WALLET_ADDRESS_2.
1
const wallet = IconWallet.loadPrivateKey(MockData.PRIVATE_KEY_1);
2
const walletAddress = wallet.getAddress();
3
// 1 ICX -> 1000000000000000000 conversion
4
const value = IconAmount.of(1, IconAmount.Unit.ICX).toLoop();
5
console.log(value);
6
// Output: BigNumber {s: 1, e: 18, c: Array(1)}
Copied!
You can get a step cost for transferring icx as follows.
1
async getDefaultStepCost() {
2
    const { CallBuilder } = IconBuilder;
3
    // Get governance score api list
4
    const governanceApi = await this.iconService.getScoreApi(MockData.GOVERNANCE_ADDRESS).execute();
5
    console.log(governanceApi)
6
    const methodName = 'getStepCosts';
7
    // Check input and output parameters of api if you need
8
    const getStepCostsApi = governanceApi.getMethod(methodName);
9
    const getStepCostsApiInputs = getStepCostsApi.inputs.length > 0 ? JSON.stringify(getStepCostsApi.inputs) : 'none';
10
    const getStepCostsApiOutputs = getStepCostsApi.outputs.length > 0 ? JSON.stringify(getStepCostsApi.outputs) : 'none';
11
    console.log(`[getStepCosts]\n inputs: ${getStepCostsApiInputs} \n outputs: ${getStepCostsApiOutputs}`);
12
​
13
    // Get step costs by iconService.call
14
    const callBuilder = new CallBuilder();
15
    const call = callBuilder
16
        .to(MockData.GOVERNANCE_ADDRESS)
17
        .method(methodName)
18
        .build();
19
    const stepCosts = await this.iconService.call(call).execute();
20
    return stepCosts.default
21
}
Copied!
Generate transaction using the values above.
1
// networkId of node 1:mainnet, 2~:etc
2
const networkId = new BigNumber("3"); // input node’s networkld
3
const version = new BigNumber("3"); // version
4
​
5
// Recommended icx transfer step limit :
6
// use 'default' step cost in the response of getStepCosts API
7
const stepLimit = await this.getDefaultStepCost(); // Please refer to the above description.
8
​
9
// Timestamp is used to prevent the identical transactions. Only current time is required (Standard unit : us)
10
// If the timestamp is considerably different from the current time, the transaction will be rejected.
11
const timestamp = (new Date()).getTime() * 1000;
12
​
13
//Enter transaction information
14
const icxTransactionBuilder = new IcxTransactionBuilder();
15
const transaction = icxTransactionBuilder
16
      .nid(networkId)
17
      .from(walletAddress)
18
      .to(MockData.WALLET_ADDRESS_2)
19
      .value(value)
20
      .version(version)
21
      .stepLimit(stepLimit)
22
      .timestamp(timestamp)
23
      .build();
Copied!
Generate SignedTransaction to add the signature of the transaction.
1
// Create signature of the transaction
2
const signedTransaction = new SignedTransaction(transaction, wallet);
3
// Read params to transfer to nodes
4
console.log(signedTransaction.getProperties());
5
// Output: 
6
// {
7
//     from: "hx902ecb51c109183ace539f247b4ea1347fbf23b5",
8
//     nid: "0x3",
9
//     nonce: "0x1",
10
//     signature: "OE/yJbKn+3kXiC/5x1mvOCpdbTiCAvdlZDgSH31//alTe4kTEVRCETXsQx+Jkbfwa6Qel1PUddoowdkQJDLPrgE=",
11
//     stepLimit: "0x186a0",
12
//     timestamp: "0x578ed370a3780",
13
//     to: "hxd008c05cbc0e689f04a5bb729a66b42377a9a497",
14
//     value: "0xde0b6b3a7640000",
15
//     version: "0x3",
16
// }
Copied!
After calling sendTransaction from IconService, you can send a transaction and check the transaction’s hash value. ICX transfer is now sent.
1
// Send transaction
2
const txHash = await iconService.sendTransaction(signedTransaction).execute();
3
// Print transaction hash
4
console.log(txHash);
5
// Output
6
// 0x69c07ff23e2eafb068ec026f1a116082f0d869b3964531e43088f6638bcfe0f7
Copied!
Check the transaction result
After the transaction is sent, the result can be looked up with the returned hash value.
In this example, you can check your transaction result every 2 seconds because of the block confirmation time. Checking the result is as follows:
1
// Check the result with the transaction hash
2
const transactionResult = await iconService.getTransactionResult(txHash).execute();
3
console.log("transaction status(1:success, 0:failure): "+transactionResult.status);
4
// Output
5
// transaction status(1:success, 0:failure): 1
Copied!
You can check the following information using the TransactionResult.
status : 1 (success), 0 (failure)
to : transaction’s receiving address
failure : Only exists if status is 0(failure). code(str), message(str) property included
txHash : transaction hash
txIndex : transaction index in a block
blockHeight : Block height of the transaction
blockHash : Block hash of the transaction
cumulativeStepUsed : Accumulated amount of consumed step’s until the transaction is executed in block
stepUsed : Consumed step amount to send the transaction
stepPrice : Consumed step price to send the transaction
scoreAddress : SCORE address if the transaction generated SCORE (optional)
eventLogs : List of EventLogs written during the execution of the transaction.
logsBloom : Bloom Filter of the indexed data of the Eventlogs.
Check the ICX balance
In this example, you can check the ICX balance by looking up the transaction before and after the transaction.
ICX balance can be confirmed by calling getBalance function from IconService
1
// create or load wallet
2
const wallet = IconWallet.loadPrivateKey(MockData.PRIVATE_KEY_2);
3
// Check the wallet balance
4
const balance = await iconService.getBalance(wallet.getAddress()).execute();
5
console.log(balance);
6
​
7
// Output: 
8
// 100432143214321432143
Copied!
Token Deploy and Transfer
This example shows how to deploy IRC token and transfer deployed token.
For the Wallet and IconService generation, please refer to the information above.
Token deploy transaction
You need the SCORE Project to deploy token.
In this example, you will use ‘test.zi’ from the ‘resources’ folder.
*test.zi : SampleToken SCORE Project Zip file.
Generate a wallet using MockData.PRIVATE_KEY_1, then read the binary data from ‘test.zi’
1
const { Wallet } = this.iconService;
2
this.wallet = IconWallet.loadPrivateKey(MockData.PRIVATE_KEY_1);
3
​
4
this.content = '';
5
// Read test.zi from ‘resources’ folder.
Copied!
Enter the basic information of the token you want to deploy.
1
const initialSupply = IconConverter.toBigNumber("100000000000");
2
const decimals = IconConverter.toBigNumber("18");
3
const tokenName = "StandardToken";
4
const tokenSymbol = "ST";
Copied!
You can get the maximum step limit value as follows.
1
// Get apis that provides Governance SCORE
2
// GOVERNANCE_ADDRESS : cx0000000000000000000000000000000000000001
3
async getMaxStepLimit() {
4
    const { CallBuilder } = IconBuilder;
5
​
6
    const governanceApi = await this.iconService.getScoreApi(MockData.GOVERNANCE_ADDRESS).execute();
7
    // "getMaxStepLimit" : the maximum step limit value that any SCORE execution should be bounded by.
8
    const methodName = 'getMaxStepLimit';
9
    // Check input and output parameters of api if you need
10
    const getMaxStepLimitApi = governanceApi.getMethod(methodName);
11
​
12
    const params = {};
13
    params[getMaxStepLimitApi.inputs[0].name] = 'invoke';
14
​
15
    // Get max step limit by iconService.call
16
    const callBuilder = new CallBuilder();
17
    const call = callBuilder
18
        .to(MockData.GOVERNANCE_ADDRESS)
19
        .method(methodName)
20
        .params(params)
21
        .build();
22
    const maxStepLimit = await this.iconService.call(call).execute();
23
    return IconConverter.toBigNumber(maxStepLimit)
24
}
Copied!
Generate transaction with the given values above.
1
async buildDeployTransaction() {
2
    const { DeployTransactionBuilder } = IconBuilder;
3
​
4
    const initialSupply = IconConverter.toBigNumber("100000000000");
5
    const decimals = IconConverter.toBigNumber("18");
6
    const tokenName = "StandardToken";
7
    const tokenSymbol = "ST";
8
    const contentType = "application/zip";
9
    // Enter token information
10
    // key name ("initialSupply", "decimals", "name", "symbol")
11
    // You must enter the given values. Otherwise, your transaction will be rejected.
12
    const params = {
13
        initialSupply: IconConverter.toHex(initialSupply),
14
        decimals: IconConverter.toHex(decimals),
15
        name: tokenName,
16
        symbol: tokenSymbol
17
    }
18
    const installScore = MockData.SCORE_INSTALL_ADDRESS;
19
    const stepLimit = await this.getMaxStepLimit();
20
    const walletAddress = this.wallet.getAddress();
21
    // networkId of node 1:mainnet, 2~:etc
22
    const networkId = IconConverter.toBigNumber(3);
23
    const version = IconConverter.toBigNumber(3);
24
    // Timestamp is used to prevent the identical transactions. Only current time is required (Standard unit : us)
25
    // If the timestamp is considerably different from the current time, the transaction will be rejected.
26
    const timestamp = (new Date()).getTime() * 1000;
27
​
28
    //Enter transaction information
29
    const deployTransactionBuilder = new DeployTransactionBuilder();
30
    const transaction = deployTransactionBuilder
31
        .nid(networkId)
32
        .from(walletAddress)
33
        .to(installScore)
34
        .stepLimit(stepLimit)
35
        .timestamp(timestamp)
36
        .contentType(contentType)
37
        .content(`0x${this.content}`)
38
        .params(params)
39
        .version(version)
40
        .build();        
41
    return transaction; 
42
}
Copied!
Generate SignedTransaction to add signature to the transaction.
1
// Create signature of the transaction
2
const signedTransaction = new SignedTransaction(transaction, this.wallet);
3
// Read params to transfer to nodes
4
const signedTransactionProperties = JSON.stringify(signedTransaction.getProperties()).split(",").join(", \n");
Copied!
You can check the transaction hash value by calling sendTransaction from ‘IconService`. Deployment is now completed.
1
this.deployTxHash = await this.iconService.sendTransaction(signedTransaction).execute();
Copied!
Check the deploy transaction result
After the transaction is sent, the result can be looked up with the returned hash value. You can also check the ST Token score address that you deployed.
Checking the result is as follows:
1
// Check the result with the transaction hash
2
const transactionResult = await iconService.getTransactionResult(this.deployTxHash).execute();
3
​
4
console.log("transaction status(1:success, 0:failure): "+transactionResult.status);
5
console.log("Your score address: " + transactionResult.scoreAddress);
6
​
7
// Output
8
// transaction status(1:success, 0:failure): 1
9
// Your score address: cx19584dcfacd0d7cc5e0562a53959069213d7adca
Copied!
For the 'TransactionResult', please refer to the IcxTransactionExample.
Token transfer transaction
You can send the ST token that you deployed right before.
You can generate Wallet using MockData.PRIVATE_KEY_1 just like in the case of IcxTransactionExample, then send 1 ST Token to MockData.WALLET_ADDRESS_2
You need the token address to send your token.
1
const wallet = IconWallet.loadPrivateKey(MockData.PRIVATE_KEY_1);
2
const toAddress = MockData.WALLET_ADDRESS_2;
3
const tokenAddress = this.scoreAddress; //ST Token Address that you deployed
4
const tokenDecimals = 18; // token decimal
5
// 1 ICX -> 1000000000000000000 conversion
6
const value = IconAmount.of(1, IconAmount.Unit.ICX).toLoop();
Copied!
You can get a step cost to send token as follows.
1
async getDefaultStepCost() {
2
    const { CallBuilder } = IconBuilder;
3
​
4
    // Get apis that provides Governance SCORE
5
    // GOVERNANCE_ADDRESS : cx0000000000000000000000000000000000000001
6
    const governanceApi = await this.iconService.getScoreApi(MockData.GOVERNANCE_ADDRESS).execute();
7
    console.log(governanceApi)
8
    const methodName = 'getStepCosts';
9
​
10
    // Get step costs by iconService.call
11
    const callBuilder = new CallBuilder();
12
    const call = callBuilder
13
        .to(MockData.GOVERNANCE_ADDRESS)
14
        .method(methodName)
15
        .build();
16
    const stepCosts = await this.iconService.call(call).execute();
17
    // For sending token, it is about twice the default value.
18
    return IconConverter.toBigNumber(stepCosts.default).times(2)
19
}
Copied!
Generate Transaction with the given parameters above. You have to add receiving address and value to param object to send token.
1
async buildTokenTransaction() {
2
    const { CallTransactionBuilder } = IconBuilder;
3
​
4
    const walletAddress = this.wallet.getAddress();
5
    // You can use "governance score apis" to get step costs.
6
    const value = IconAmount.of(1, IconAmount.Unit.ICX).toLoop();
7
    const stepLimit = await this.getDefaultStepCost();
8
    // networkId of node 1:mainnet, 2~:etc
9
    const networkId = IconConverter.toBigNumber(3);
10
    const version = IconConverter.toBigNumber(3);
11
    // Timestamp is used to prevent the identical transactions. Only current time is required (Standard unit : us)
12
    // If the timestamp is considerably different from the current time, the transaction will be rejected.
13
    const timestamp = (new Date()).getTime() * 1000;
14
    // SCORE name that send transaction is “transfer”.
15
    const methodName = "transfer";
16
    // Enter receiving address and the token value.
17
    // You must enter the given key name("_to", "_value"). Otherwise, the transaction will be rejected.
18
    const params = {
19
        _to: MockData.WALLET_ADDRESS_2,
20
        _value: IconConverter.toHex(value)
21
    }
22
​
23
    //Enter transaction information
24
    const tokenTransactionBuilder = new CallTransactionBuilder();
25
    const transaction = tokenTransactionBuilder
26
        .nid(networkId)
27
        .from(walletAddress)
28
        .to(this.scoreAddress)
29
        .stepLimit(stepLimit)
30
        .timestamp(timestamp)
31
        .method(methodName)
32
        .params(params)
33
        .version(version)
34
        .build();        
35
    return transaction;
36
}
Copied!
Generate SignedTransaction to add signature to your transaction.
1
// Generate transaction signature.
2
const signedTokenTransfer = new SignedTransaction(transaction, wallet);
3
// Read params to send to nodes.
4
console.log(signedTokenTransfer.getProperties());
Copied!
Call sendTransaction from ‘IconService’ to check the transaction hash. Token transaction is now sent.
1
// Send transaction
2
this.transactionTxHash = await iconService.sendTransaction(signedTokenTransfer).execute();
3
// Print transaction hash
4
console.log(this.transactionTxHash);
5
// Output
6
// 0x6b17886de346655d96373f2e0de494cb8d7f36ce9086cb15a57d3dcf24523c8f
Copied!
Check the transfer transaction result
You can check the result with the returned hash value of your transaction.
In this example, you can check your transaction result in every 2 seconds because of the block confirmation time. Checking the result is as follows:
1
// Check the result with the transaction hash
2
const transactionResult = await iconService.getTransactionResult(this.transactionTxHash).execute();
3
console.log("transaction status(1:success, 0:failure): "+transactionResult.status);
4
// Output
5
// transaction status(1:success, 0:failure):1
Copied!
For the TransactionResult, please refer to the IcxTransactionExample.
Check the token balance
In this example, you can check the token balance before and after the transaction.
You can check the token balance by calling ‘balanceOf’ from the token SCORE.
1
const { CallBuilder } = IconBuilder;
2
const tokenAddress = this.scoreAddress;
3
// Method name to check the balance
4
const methodName = "balanceOf";
5
// You must enter the given key name (“_owner”).
6
const params = {
7
    _owner: address
8
}
9
const callBuilder = new CallBuilder();
10
const call = callBuilder
11
    .to(tokenAddress)
12
    .method(methodName)
13
    .params(params)
14
    .build();
15
// Check the wallet balance
16
const balance = await this.iconService.call(call).execute();
Copied!
Sync Block
This example shows how to read block information and print the transaction result for every block creation.
Please refer to above for Wallet and IconService creation.
Read the block information
In this example, 'getLastBlock' is called periodically in order to check the new blocks,
by updating the transaction information for every block creation.
1
// Check the recent blocks
2
const block = await iconService.getLastBlock().execute();
3
console.log(block.height);
4
// Output
5
// 237845
Copied!
If a new block has been created, get the transaction list.
1
const txList = block.getTransactions();
Copied!
You can check the following information using the ConfirmedTransaction:
version : json rpc server version
to : Receiving address of transaction
value: The amount of ICX coins to transfer to the address. If omitted, the value is assumed to be 0
timestamp: timestamp of the transmitting transaction (unit: microseconds)
nid : network ID
signature: digital signature data of the transaction
txHash : transaction hash
dataType: A value indicating the type of the data item (call, deploy, message)
data: Various types of data are included according to dataType.
Transaction output
1
async syncBlock(block) {
2
    // the transaction list of blocks
3
    console.log(block)
4
    const txList = block.getTransactions();
5
​
6
    Promise.all(
7
        txList.map(async transaction => {
8
            const txResult = await this.iconService.getTransactionResult(transaction.txHash).execute();
9
​
10
            // Print icx transaction
11
            if ((transaction.value !== undefined) && transaction.value > 0) {
12
                document.getElementById("S03-2").innerHTML += `<li>${block.height} - [ICX] status: ${txResult.status === 1 ? 'success' : 'failure'}  |  amount: ${transaction.value}</li>`
13
            }
14
​
15
            // Print token transaction
16
            if (transaction.dataType !== undefined &&
17
                transaction.dataType === "call") {
18
                const method = transaction.data.method;
19
​
20
                if (method !== null && method === "transfer") {
21
                    const params = transaction.data.params;
22
                    const value = IconConverter.toBigNumber(params["_value"]); // value
23
                    const toAddr = params["_to"];
24
​
25
                    const tokenName = await this.getTokenName(transaction.to);
26
                    const symbol = await this.getTokenSymbol(transaction.to);
27
​
28
                    document.getElementById("S03-2").innerHTML += `<li>${block.height} - [${tokenName} - ${symbol}] status: ${txResult.status === 1 ? 'success' : 'failure'}  |  amount: ${value}</li>`;
29
                }
30
            }
31
        })
32
    )
33
​
34
    this.prevHeight = block.height;
35
}
Copied!
Check the token name & symbol
You can check the token SCORE by calling the name and symbol functions.
1
async getTokenName(to) {
2
    const { CallBuilder } = IconBuilder;
3
    const tokenAddress = to; // token address
4
    const callBuilder = new CallBuilder();
5
    const call = callBuilder
6
        .to(tokenAddress)
7
        .method("name")
8
        .build();
9
    const result = await this.iconService.call(call).execute();
10
    return result;
11
}
Copied!
1
async getTokenSymbol(to) {
2
    const { CallBuilder } = IconBuilder;
3
    const tokenAddress = to; // token address
4
    const callBuilder = new CallBuilder();
5
    const call = callBuilder
6
        .to(tokenAddress)
7
        .method("symbol")
8
        .build();
9
    const result = await this.iconService.call(call).execute();
10
    return result;
11
}
Copied!
Changelog
​https://github.com/icon-project/icon-sdk-js/blob/master/CHANGELOG.md​
References
​API Reference​
​ICON JSON-RPC API v3​
​ICON Network​
Licenses
This project follows the Apache 2.0 License. Please refer to LICENSE for details.