npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

earthweb-test

v0.3.5

Published

Interact with a local or remote full EARTH node

Downloads

2

Readme

What is EarthWeb?

EarthWeb aims to deliver a unified, seamless development experience influenced by Ethereum's Web3 implementation. We have taken the core ideas and expanded upon it to unlock the functionality of EARTH's unique feature set along with offering new tools for integrating DApps in the browser, Node.js and IoT devices.

Compatibility

  • Version built for Node.js v6 and above
  • Version built for browsers with more than 0.25% market share

You can access either version specifically from the dist folder.

EarthWeb is also compatible with frontend frameworks such as:

  • Angular
  • React
  • Vue.

You can also ship EarthWeb in a Chrome extension.

Installation

Node.js

npm install earthweb

or

yarn add earthweb

Browser

Then easiest way to use EarthWeb in a browser is to install it as above and copy the dist file to your working folder. For example:

cp node_modules/earthweb/dist/EarthWeb.js ./js/earthweb.js

so that you can call it in your HTML page as

<script src="./js/earthweb.js"><script>

Testnet

Ohio is the official EARTH testnet. To use it use the following endpoint:

https://ohio.earth.engineering

Get some Ohio EARTH at https://www.earth.engineering/ohio and play with it. Anything you do should be explorable on https://explore.earth.engineering

Your local private network for heavy testing

You can set up your own private network, running Spark. To do it you must install Docker

Once you have docker installed next pull the latest Spark image from Docker Hub:

docker pull earthengineering/spark:latest

And, when ready, run a command like

docker run -it -p 9090:9090  --rm --name earth earthengineering/spark

More details about Spark on GitHub

Creating an Instance

First off, in your javascript file, define EarthWeb:

const EarthWeb = require("earthweb");

When you instantiate EarthWeb you can define

  • fullNode
  • solidityNode
  • eventServer
  • privateKey

you can also set a

  • fullHost

which works as a jolly. If you do so, though, the more precise specification has priority. Supposing you are using a server which provides everything, like EarthGrid, you can instantiate EarthWeb as:

const earthWeb = new EarthWeb({
    fullHost: "https://rest.earth.engineering",
    privateKey: "your private key"
});

For retro-compatibility, though, you can continue to use the old approach, where any parameter is passed separately:

const earthWeb = new EarthWeb(fullNode, solidityNode, eventServer, privateKey);

If you are, for example, using a server as full and solidity node, and another server for the events, you can set it as:

const earthWeb = new EarthWeb({
    fullHost: "https://rest.earth.engineerin",
    eventServer: "https://api.someotherevent.io",
    privateKey: "your private key"
});

If you are using different servers for anything, you can do

const earthWeb = new EarthWeb({
    fullNode: "https://some-node.tld",
    solidityNode: "https://some-other-node.tld",
    eventServer: "https://some-event-server.tld",
    privateKey: "your private key"
});

A full example

The better way to understand how to work with Earth is to clone the MetaCoin example and follow the instructions at https://github.com/earthengineering/metacoin-box

Contributions

In order to contribute you can

  • fork this repo and clone it locally
  • install the dependencies — npm i
  • do your changes to the code
  • build the EarthWeb dist files — npm run build
  • run a local private network using Spark
  • run the tests — npm test:node
  • push your changes and open a pull request