Go to file
Marian Oancea bd14b4d23e node < 0.10 fails travis build => remove 0.6 & 0.8
from travis.yml
2014-11-06 01:48:52 +02:00
dist Updated package.json 2014-11-05 20:12:21 +02:00
example Converted to node module 2014-11-05 19:46:01 +02:00
lib Updated package.json 2014-11-05 20:12:21 +02:00
.bowerrc Converted to node module 2014-11-05 19:46:01 +02:00
.editorconfig Updated bower.json & Readme 2014-11-05 22:33:28 +02:00
.gitignore Converted to node module 2014-11-05 19:46:01 +02:00
.jshintrc Converted to node module 2014-11-05 19:46:01 +02:00
.npmignore Updated package.json 2014-11-05 20:12:21 +02:00
.travis.yml node < 0.10 fails travis build => remove 0.6 & 0.8 2014-11-06 01:48:52 +02:00
LICENSE Converted to node module 2014-11-05 19:46:01 +02:00
README.md Updated bower.json & Readme 2014-11-05 22:33:28 +02:00
bower.json more json fixes 2014-11-05 23:07:13 +02:00
gulpfile.js Converted to node module 2014-11-05 19:46:01 +02:00
index.js Converted to node module 2014-11-05 19:46:01 +02:00
package.json gulp >= 3.4.0 2014-11-06 00:49:50 +02:00

README.md

Ethereum JavaScript API

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

Build Status dependency status dev dependency status

browser support

Installation

Node.js

npm install ethereum.js

For browser

Bower

bower install ethereum.js

Component

component install ethereum/ethereum.js
  • Include ethereum.min.js in your html file.
  • Include es6-promise or another ES6-Shim if your browser doesn't support ECMAScript 6.

Usage

Require the library:

var web3 = require('web3');

Set a provider (QtProvider, WebSocketProvider, HttpRpcProvider)

var web3.setProvider(new web3.providers.WebSocketProvider('ws://localhost:40404/eth'));

There you go, now you can use it:

web3.eth.coinbase.then(function(result){
  console.log(result);
  return web3.eth.balanceAt(result);
}).then(function(balance){
  console.log(web3.toDecimal(balance));
}).catch(function(err){
  console.log(err);
});

For another example see example/index.html.

Building

  • gulp build

Testing

Please note this repo is in it's early stage.

If you'd like to run a WebSocket ethereum node check out go-ethereum.

To install ethereum and spawn a node:

go get github.com/ethereum/go-ethereum/ethereum
ethereum -ws -loglevel=4