simonzgconnex
v1.1.7
Published
Standard interface to connect DApp with Meter and user
Downloads
4
Maintainers
Readme
Connex
Introduction
Meter-Connex is the standard interface to connect DApps with Meter blockchain and user. Connex
is a set of well-designed APIs for developers, with injected Connex Object
in web applications they can easily build decentralized applications.
Get Started
Meter Wallet or other compatible clients will expose connex
API by an injected object on Window Object
.
Meter App Bootstrapping
Meter apps are usually web apps. On app load, you always need to detect Connex component. If Connex is not available, you may instruct people to setup Connex environment.
To simplify these steps, simply perform redirection:
if (!window.connex) {
location.href =
"https://shoal.meter.io/r/#" + encodeURIComponent(location.href);
}
Additionally, network can be specified:
if (!window.connex) {
// the app prefers running on test net
location.href =
"https://shoal.meter.io/r/#/test/" + encodeURIComponent(location.href);
}
Install
TypeScript(Recommended)
npm install meter-connex --save-dev
Place following line in any .ts file of your project
import "meter-connex";
or
add meter-connex
to compilerOptions.types
in tsconfig.json
then you are good to go!
Vanilla JS
No need to set up, just code in your favourite way.
Usage
const el = document.createElement("h1");
const status = connex.meter.status;
el.innerText =
"You are 'connexed' to meter, the status is " +
(status.progress === 1 ? "synced" : "syncing");
document.querySelector("body").append(el);
Resource
FAQ
TypeScript complier does not find Connex
First, check tsconfig.json
and make sure meter-connex
is present in compilerOptions.types
. Furthermore if you are doing an angular project and still get the error, you are probably using a larger project with multiple project roots, just adding meter-connex
to the root config is not enough in this case. You also have to find all tsconfig.app.ts
and tsconfig.spec.ts
files in your sub-projects. While these inherit from the main tsconfig.json
you have to make sure it does not override the types with for example "types": []
and that there is no conflict with typesRoots
License
Connex is licensed under the GNU Lesser General Public License v3.0, also included in LICENSE file in the repository.