Comment on page

v2.0 Changes

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 1yr ago