Skip to content

Conflux-Chain/ConfluxWeb

 
 

Repository files navigation

conflux-web.js - Conflux JavaScript API

This project is no longer actively maintained, please move to New JavaScript SDK.

This is the Conflux JavaScript API which connects to the Generic JSON RPC spec.

You need to run a local or remote Conflux node to use this library.

Please read the documentation for more.

Installation

Node

npm install conflux-web

Yarn

yarn add conflux-web

Usage

import ConfluxWeb from 'conflux-web';
// const ConfluxWeb = require('conflux-web'); // for nodejs

const confluxWeb = new ConfluxWeb('ws://localhost:8546');
console.log(confluxWeb);
> {
    cfx: ...,
    utils: ...,
    ...
}

Additionally you can set a provider using confluxWeb.setProvider() (e.g. WebsocketProvider)

confluxWeb.setProvider('ws://localhost:8546');
// or
confluxWeb.setProvider(new ConfluxWeb.providers.WebsocketProvider('ws://localhost:8546'));

There you go, now you can use it:

confluxWeb.cfx.getAccounts()
.then(console.log);

Usage with TypeScript

We support types within the repo itself. Please open an issue here if you find any wrong types.

You can use conflux-web.js as follows:

import ConfluxWeb from 'conflux-web';
const confluxWeb = new ConfluxWeb("ws://localhost:8546");

If you are using the types in a commonjs module like for example a node app you just have to enable esModuleInterop in your tsconfig compile option, also enable allowSyntheticDefaultImports for typesystem compatibility:

"compilerOptions": {
    "allowSyntheticDefaultImports": true,
    "esModuleInterop": true,
    ....

Documentation

Documentation can be found at read the docs

Contributing

  • All contributions have to go into the 1.0 branch
  • Please follow the code style of the other files, we use 4 spaces as tabs.

Requirements

Commands

npm run clean // removes all the node_modules folders in all modules
npm run bootstrap // install all dependencies and symlinks the internal modules for all modules
npm run test // runs all tests 
npm run build // runs rollup
npm run dev // runs rollup with a watcher

Support

browsers node

Community

About

Conflux JavaScript API, under active development

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 87.5%
  • TypeScript 12.5%