Multi-Chain Web Provider for Blockcore
Work-in-Progress - use with caution!
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).
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.
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:
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).
Simply run npm run build
to build the library. Also run npm run lint
to verify the code syntax.
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