@expanse/web3

Migration 0.13.0 -> 0.14.0

web3.js version 0.14.0 supports multiple instances of web3 object. To migrate to this version, please follow the guide:

-var web3 = require('web3');
+var Web3 = require('web3');
+var web3 = new Web3();

Expanse Support

This API has been modified to support both Expanse and Ethereum Applications. Calls may be made through either web3.exp or web3.eth interchangably and both Ethereum and Expanse units are supported. For information on porting software that uses ethereum to expanse, please see our Expanse/Ethereum Cross Compatibility Guide

Expanse and Ethereum JavaScript API

This is the Ethereum and Expanse compatible JavaScript API which implements the Generic JSON RPC spec. It's available on npm as a node module, for bower and component as an embeddable js and as a meteor.js package.

[![NPM version][npm-image]][npm-url] [![Build Status][travis-image]][travis-url] [![dependency status][dep-image]][dep-url] [![dev dependency status][dep-dev-image]][dep-dev-url][![Coverage Status][coveralls-image]][coveralls-url][![Stories in Ready][waffle-image]][waffle-url]

You need to run a local Ethereum node to use this library.

Documentation

Installation

Node.js

npm install web3-expanse

Meteor.js

meteor add expanse:web3

As Browser module

Bower

bower install web3-expanse

Component

component install expanse-org/web3.js

• Include web3.min.js in your html file. (not required for the meteor package)

Usage

Use the web3 object directly from global namespace:

console.log(web3); // {eth: .., shh: ...} // it's here!

Set a provider (HttpProvider)

Expanse: ```js web3.setProvider(new web3.providers.HttpProvider('http://localhost:9656'));

Ethereum: ```js
web3.setProvider(new web3.providers.HttpProvider('http://localhost:8545'));

There you go, now you can use it:

var coinbase = web3.eth.coinbase;
var balance = web3.eth.getBalance(coinbase);

or

var coinbase = web3.exp.coinbase;
var balance = web3.exp.getBalance(coinbase);

You can find more examples in example directory.

Contribute!

Requirements

• Node.js
• npm

sudo apt-get update
sudo apt-get install nodejs
sudo apt-get install npm
sudo apt-get install nodejs-legacy

Building (gulp)

npm run-script build

Testing (mocha)

npm test

These urls are pending update for Expanse: [npm-image]: https://badge.fury.io/js/web3.png [npm-url]: https://npmjs.org/package/web3-expanse [travis-image]: https://travis-ci.org/ethereum/web3.js.svg [travis-url]: https://travis-ci.org/ethereum/web3.js [dep-image]: https://david-dm.org/ethereum/web3.js.svg [dep-url]: https://david-dm.org/ethereum/web3.js [dep-dev-image]: https://david-dm.org/ethereum/web3.js/dev-status.svg [dep-dev-url]: https://david-dm.org/ethereum/web3.js#info=devDependencies [coveralls-image]: https://coveralls.io/repos/ethereum/web3.js/badge.svg?branch=master [coveralls-url]: https://coveralls.io/r/ethereum/web3.js?branch=master [waffle-image]: https://badge.waffle.io/ethereum/web3.js.svg?label=ready&title=Ready [waffle-url]: http://waffle.io/ethereum/web3.js