v2.0 Changes

js-conflux-sdk

Conflux Developer JSON RPC Solidity

Search…

Home

QuickStart

Introduction

Overview

Contrast with web3.js

js-conflux-sdk v2.0 has imported several big features.
Group RPC methods by namespace
From Conflux-rust v2.0.0, the pos RPC group has been added, which can be used to get PoS chain info. js-conflux-sdk will add support to PoS related RPC in v2.0. These methods are located at Conflux's sub object pos conflux.pos, for example:
async function main() {
  const conflux = new Conflux({
    url: 'https://test.confluxrpc.com',
    networkId: 1
  });
  const status = await conflux.pos.getStatus();
  console.log('Current PoS status: ', status);
  /*
  {
    epoch: 29,
    latestCommitted: 1725,
    latestTxNumber: '0x1e36',
    latestVoted: 1728,
    pivotDecision: {
      blockHash: '0xc8c2c58ef952f48adf00d6204d6e930f23aee26c6b9a903820bea1c012f72f3e',
      height: 120480
    }
  }
  */
}
Check PoS RPC documentation for the complete method list.
And previous cfx RPC methods are also been moved to their own namespace, for example:
const balance = await conflux.cfx.getBalance('cfxtest:aaawgvnhveawgvnhveawgvnhveawgvnhvey1umfzwp');
Besides txpool and trace namespace is also added, so js-sdk v2.0 have four RPC namespace:
cfx
pos
txpool
trace
There also is an advanced namespace, which will provide some useful combined RPC utilities, for example:
getNextUsableNonce
getPoSInterestRate
Add new Internal contracts
Two more internal contracts are added:
ConfluxContext
PoSRegister
Add support for batch request RPC
v2.0 has add support for RPC batch invoke, for example:
const batcher = conflux.BatchRequest();
batcher.add(conflux.cfx.getStatus.request());
batcher.add(conflux.cfx.getBalance.request('cfxtest:aaawgvnhveawgvnhveawgvnhveawgvnhvey1umfzwp'));
​
const [status, balance] = await batcher.execute();
Check here for detail introduction.
Browser exported SDK name changed to TreeGraph
Note this is a breaking change
From v2.0 the browser exported SDK class name has change from Conflux to TreeGraph.
Previous
<script type="text/javascript">
  const conflux = new window.Conflux.Conflux({
    url: 'https://test.confluxrpc.com',
    logger: console,
    networkId: 1,
  });
</script>
Currently:
<script type="text/javascript">
  const conflux = new window.TreeGraph.Conflux({
    url: 'https://test.confluxrpc.com',
    logger: console,
    networkId: 1,
  });
</script>
Enable fast send transaction
If your RPC endpoint support txpool RPC methods, now you can fast send transaction sequencely. For example:
for(let i = 0; i < 100; i++) {
  let hash = await conflux.cfx.sendTransaction({
    from: account,
    to: 'cfxtest:aaawgvnhveawgvnhveawgvnhveawgvnhvey1umfzwp',
    value: 1
  });
  console.log(`TX hash: ${hash}`);
}
Note the max sequence transaction send count can not surpass 2000
Readable ABI support
const tokenAbi = [
  // Some details about the token
  "function name() view returns (string)",
  "function symbol() view returns (string)",
​
  // Get the account balance
  "function balanceOf(address) view returns (uint)",
​
  // Send some of your tokens to someone else
  "function transfer(address to, uint amount)",
​
  // An event triggered whenever anyone transfers to someone else
  "event Transfer(address indexed from, address indexed to, uint amount)"
];
​
const contract = conflux.Contract({
  abi: tokenAbi,
  address: 'cfxtest:aaawgvnhveawgvnhveawgvnhveawgvnhvey1umfzwp' // use a valid token address here
});
​
const balance = await contract.balanceOf('cfxtest:aaawgvnhveawgvnhveawgvnhveawgvnhvey1umfzwp');

Release notes

Last modified 8mo ago

Copy link

Edit on GitHub

On this page

Group RPC methods by namespace

Add new Internal contracts

Add support for batch request RPC

Browser exported SDK name changed to TreeGraph

Enable fast send transaction

Readable ABI support