status-im
/
web3.js
mirror of https://github.com/status-im/web3.js.git
2
0
Fork 0
Code Issues Projects Releases Wiki Activity
Ethereum JavaScript API
1,280 Commits 27 Branches 52 Tags 24 MiB
JavaScript 94.5%
HTML 5.5%
Go to file
phiferd f6b3ce5c0e Propagating unpacking errors to async callback to be consistent with synchronous case (#530) 
* buy fix to make synchronous and asynchronous cases compatible (avoid swallowing errors encountered during unpacking)

* removing example comments and whitespace changes

* reworking to avoid catching errors thrown by the callback

* exiting early if there is an error
 		2017-01-06 11:50:14 +01:00
dist added map file 2017-01-06 11:38:26 +01:00
example Update contract.html (#508) 2017-01-05 15:32:52 +01:00
lib Propagating unpacking errors to async callback to be consistent with synchronous case (#530) 2017-01-06 11:50:14 +01:00
test Fix staticPartLength calculation for multidimensional arrays. (#527) 2017-01-05 15:55:55 +01:00
.bowerrc fixed #149 2015-03-30 09:11:56 +02:00
.editorconfig Updated bower.json & Readme 2014-11-05 22:33:28 +02:00
.gitignore add Meteor server fix 2015-07-30 15:44:51 +02:00
.jshintrc sendIBANTransaction && tests 2015-05-23 15:59:19 +02:00
.npmignore Refactoring 2014-11-06 22:51:37 +02:00
.travis.yml bump node versions for travis 2015-10-06 01:00:06 +02:00
.versions updated versions file 2016-06-15 17:50:26 +02:00
LICENSE update license per name change to web3.js 2015-06-10 10:04:05 -07:00
README.md Improve visual appearance of the badges (#468) 2016-06-29 11:32:43 +02:00
bower.json bumped to version alpha 2016-05-30 10:50:13 +02:00
circle.yml CI - add circleCI config 2016-08-26 16:16:59 -07:00
gulpfile.js fixed #318, upgraded del package to 2.0.2 2015-10-05 09:25:25 +02:00
index.js add currentProvider back and fixed index.js 2015-10-08 11:20:45 +02:00
package-init.js add currentProvider back and fixed index.js 2015-10-08 11:20:45 +02:00
package.js bumped version to 0.18.0 2017-01-06 10:29:22 +01:00
package.json bumped version to 0.18.0 2017-01-06 10:29:22 +01:00
styleguide.md use 4 spaces instead of 2 2015-07-16 13:42:30 +02:00

README.md

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();

Ethereum JavaScript API

Join the chat at https://gitter.im/ethereum/web3.js

This is the Ethereum 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 Build Status dependency status dev dependency status Coverage Status Stories in Ready

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

Documentation

Installation

Node.js

npm install web3

Meteor.js

meteor add ethereum:web3

As Browser module

Bower

bower install web3

Component

component install ethereum/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)

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);

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