You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
Gav Wood bc345316dc Don't accept default argument for eth. Fixes #1250. 10 years ago
..
dist Don't accept default argument for eth. Fixes #1250. 10 years ago
example Merge commit '3cf8dcb19983b41a387065746e6d3ce08ef7ef4c' into new_jsonrpc 10 years ago
lib Fixes #1369 10 years ago
test Fixes for getCode. 10 years ago
.bowerrc Merge commit '3871bac1d0ac3b0e7f8490fba646f159fa65d8b5' as 'libjsqrc/ethereumjs' 10 years ago
.editorconfig Merge commit '3871bac1d0ac3b0e7f8490fba646f159fa65d8b5' as 'libjsqrc/ethereumjs' 10 years ago
.gitignore Merge commit '4fbeff27d613a4e13452489acd6cfc5e94e8f620' into jsonrpc 10 years ago
.jshintrc Merge commit 'be3bfb76bef1d1f113033cd9093e03a00066d5d1' into ethereumjs_timeout 10 years ago
.npmignore Merge commit '3871bac1d0ac3b0e7f8490fba646f159fa65d8b5' as 'libjsqrc/ethereumjs' 10 years ago
.travis.yml Merge commit '3cf8dcb19983b41a387065746e6d3ce08ef7ef4c' into new_jsonrpc 10 years ago
.versions Merge commit '3cf8dcb19983b41a387065746e6d3ce08ef7ef4c' into new_jsonrpc 10 years ago
LICENSE Merge commit '3871bac1d0ac3b0e7f8490fba646f159fa65d8b5' as 'libjsqrc/ethereumjs' 10 years ago
README.md Merge commit '3cf8dcb19983b41a387065746e6d3ce08ef7ef4c' into new_jsonrpc 10 years ago
bower.json Merge commit '3d1af015048d11c07c4efd5a1f1fe82becf7a851' into quick_fix 10 years ago
gulpfile.js Merge commit '5bbd7b5c15de77c194ce72f72901da672faf64a0' into develop 10 years ago
index.js Merge commit '3cf8dcb19983b41a387065746e6d3ce08ef7ef4c' into new_jsonrpc 10 years ago
karma.conf.js Merge commit '3cf8dcb19983b41a387065746e6d3ce08ef7ef4c' into new_jsonrpc 10 years ago
package-init.js Merge commit '3cf8dcb19983b41a387065746e6d3ce08ef7ef4c' into new_jsonrpc 10 years ago
package.js Merge commit '5bbd7b5c15de77c194ce72f72901da672faf64a0' into develop 10 years ago
package.json Merge commit '5bbd7b5c15de77c194ce72f72901da672faf64a0' into develop 10 years ago
version.json Merge commit '5bbd7b5c15de77c194ce72f72901da672faf64a0' into develop 10 years ago

README.md

Ethereum JavaScript API

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 statusCoverage Status

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

Documentation

Installation

Node.js

$ npm install ethereum.js

Meteor.js

$ meteor add ethereum:js

As Browser module

Bower

$ bower install ethereum.js

Component

$ component install ethereum/ethereum.js
  • Include ethereum.min.js in your html file. (not required for the meteor package)
  • Include bignumber.js (not required for the meteor package)

Usage

Require the library (not required for the meteor package):

var web3 = require('web3');

Set a provider (QtSyncProvider, 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);

For another example see example/index.html.

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

Testing (karma)

Karma allows testing within one or several browsers.

npm run-script karma # default browsers are Chrome and Firefox
npm run-script karma -- --browsers="Chrome,Safari" # custom browsers

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

If you'd like to run a Http ethereum node check out cpp-ethereum.

Install ethereum and spawn a node:

eth -j