js-conflux-sdk

js-conflux-sdk

JavaScript Conflux Software Development Kit is a complete library for interacting with the Conflux Blockchain Core Space in both Node.js and browser environment.

Docs

• js-conflux-sdk documentation
• SDK API doc
• Examples
• Community examples
• Fullnode JSONRPC API
• Public RPC endpoints
• Testnet faucet
• FAQs

Install

Install through npm

$ npm install js-conflux-sdk

How to import

Nodejs

Use in Node.js script

const { Conflux } = require('js-conflux-sdk');

const conflux = new Conflux({
  url: 'https://test.confluxrpc.com',
  networkId: 1,  // Note: network is required
  logger: console, // for debug
});

require deep nested file/dir

const util = require('js-conflux-sdk/src/util');

Frontend

umd

The front-packed package is located in js-conflux-sdk's dist folder.

import { Conflux } from 'js-conflux-sdk/dist/js-conflux-sdk.umd.min.js';

or if your bundler supports the browser field in package.json

import { Conflux } from 'js-conflux-sdk';

or

<script type="text/javascript" src="node_modules/js-conflux-sdk/dist/js-conflux-sdk.umd.min.js"></script>
<script type="text/javascript">
  const conflux = new window.TreeGraph.Conflux({
    url: 'https://test.confluxrpc.com',
    logger: console,
    networkId: 1,
  });
</script>

From v2.0 the exported class to browser window name changed from Conflux to TreeGraph

Or you can use public CDN links:

• jsdelivr

Address conversion performance

To gain an address conversion(hex->base32 or reverse) performance boost, you can install @conflux-dev/conflux-address-rust in your project. Which will be used to replace the purejs version and can gain a 10-100 performance boost.

Note: @conflux-dev/conflux-address-rust required a rust environment to install.

SDK version relation with Conflux-rust

How to know SDK's version

const { Conflux } = require('js-conflux-sdk');
const conflux = new Conflux({
  url: 'https://test.confluxrpc.com',
  networkId: 1,
});
console.log(conflux.version);
// 2.0.0

How to know fullnode's version

const clientVersion = await conflux.cfx.getClientVersion();
console.log(clientVersion);
// conflux-rust-2.0.0

js-conflux-sdk	conflux-rust(node)
v2.0.0+	v2.0.0+
v1.7.0+	v1.1.5+
v1.6.0+	v1.1.3+
v1.5.11+	v1.1.1+

Related Projects | Tools

• CIP-23 can be used to work with Conflux signTypedData
• hardhat-conflux hardhat plugin that can be used to interact with Conflux Core network
• @conflux-dev/hdwallet HD Wallet