@substrate/connect

Polkadot JS Provider for Smoldot Light Client

This is a prototype for using @polkadot/api with the smoldot WASM light client either by passing chainspecs or using the extension by predefined chains (e.g. westend, kusama).

Detector check existence of substrate extension. If it is installed and activated then smoldot clients of extension will be used. If not, a new smoldot client will start and sync with given chainspecs.

Usage

Provide a known Chain Name ('kusama', 'polkadot', 'westend', 'rococo'):

import { Detector } from '@substrate/connect';

const detect = new Detector('my cool unstoppable app');

const api = await detect.connect('westend');

or provide your custom substrate chain's name and chainspec:

import { Detector }  from '@substrate/connect';
import mySubstrateChainSpec from './mySubstrateChainSpec.json';

const chainSpec =  JSON.stringify(mySubstrateChainSpec);
const detect = new Detector('my cool unstoppable app');

const api = await detect.connect({ name: 'mySubstrateChainName', spec: chainSpec });

Parachain support

For parachain support, you can providethe parachain's specs

import { Detector } from '@substrate/connect';
import myParaChainSpec from './myParaChainSpec.json';

const parachainSpec =  JSON.stringify(myParaChainSpec);

const detect = new Detector('my cool unstoppable app');
const api = await detect.connect('westend',  parachainSpec);

Options

In addition besides substrate chain's name and/or chainspec, a list of options can be passed to Detector, same way as in as passed in @polkadot/api. Without chainspec:

import { Detector }  from '@substrate/connect';

const detect = new Detector('my cool unstoppable app');
const options = { /* the options as per polkadot/api */ } as ApiOptions;
const api = await detect.connect('mySubstrateChainName', undefined, options);

or with:

import { Detector }  from '@substrate/connect';
import mySubstrateChainSpec from './mySubstrateChainSpec.json';

const chainSpec =  JSON.stringify(mySubstrateChainSpec);
const detect = new Detector('my cool unstoppable app');

const options = { /* the options as per polkadot/api */ } as ApiOptions;
const api = await detect.connect({ name: 'mySubstrateChainName', spec: chainSpec }, undefined options);

Scripts

• yarn test to run the unit tests
• yarn build to build @substrate-connect
• yarn lint to run linter for @substrate-connect