Skip to content

block-core/blockcore-provider

Repository files navigation

Blockcore

Blockcore Web Provider

Multi-Chain Web Provider for Blockcore

Work-in-Progress - use with caution!

Blockcore Web Provider

Web (Web3/Web5) Provider for Blockcore.

The provider is how apps talks to the blockchains and wallet (extension). Providers take JSON-RPC requests and return the response. This is normally done by submitting the request to an HTTP or IPC socket based server.

The provider also allows connection to be made between web site / web app and the Blockcore Wallet (browser extension).

Setup

Install:

npm install @blockcore/provider

Warning: This package is native ESM and does not provide a CommonJS export. If your project uses CommonJS, you'll have to convert to ESM or use the dynamic import() function.

Usage

import { WebProvider } from "@blockcore/provider";

// This will perform DNS lookup and indexer queries to check online statuses:
const webProvider = await WebProvider.Create();
webProvider.setNetwork('CITY');

const block = await provider.indexer.getBlockByIndex('1');
console.log('Block:', block);

// Without any key, user can pick any account they want:
const signing1 = await provider.request({ method: "signMessage", params: [{ key: "CdnpNqSeqaXBMVnY1e13Ksijgr6FyWPM9J", message: 'Hello World!' }] });
console.log('Signing1:', signing1);

// The key can be provided if user previously performed a signing request and the web app persisted the selected key.
const signing2 = await provider.request({ method: "signMessage", params: [{ message: 'Hello World!' }] });
console.log('Signing2:', signing2);

const supply: any = await webProvider.indexer.getCirculatingSupply();
console.log('Supply:', supply);

Screen recording demonstrating the use of the Blockcore Web Provider:

TODO

The interaction with the wallet is currently done through the generic request API, this provider will add typed methods for all the supported features within the wallet provider (in-page provider loaded by the wallet extension).

Development

Build

Simply run npm run build to build the library. Also run npm run lint to verify the code syntax.

Testing

The library is using ava for tests. Please refer to the documentation on how to write tests:

https://github.com/avajs/ava/blob/main/docs/01-writing-tests.md