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.
 
 
 
 
 
Lefteris Karapetsas 7583637c39 Merge pull request #798 from LefterisJP/natspec_OnContractCreation 10 years ago
..
dist Auto-generated commits, too. 10 years ago
example Cleaned up some unused functions 10 years ago
lib Fix for JS API formatting. 10 years ago
test Merge commit 'ab745d3b0eb89d67db1ed953020c665be3d072ed' into develop 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 '3871bac1d0ac3b0e7f8490fba646f159fa65d8b5' as 'libjsqrc/ethereumjs' 10 years ago
.jshintrc Merge commit '3871bac1d0ac3b0e7f8490fba646f159fa65d8b5' as 'libjsqrc/ethereumjs' 10 years ago
.npmignore Merge commit '3871bac1d0ac3b0e7f8490fba646f159fa65d8b5' as 'libjsqrc/ethereumjs' 10 years ago
.travis.yml Merge commit 'ab745d3b0eb89d67db1ed953020c665be3d072ed' into develop 10 years ago
LICENSE Merge commit '3871bac1d0ac3b0e7f8490fba646f159fa65d8b5' as 'libjsqrc/ethereumjs' 10 years ago
README.md Merge commit 'ab745d3b0eb89d67db1ed953020c665be3d072ed' into develop 10 years ago
bower.json Merge commit '3871bac1d0ac3b0e7f8490fba646f159fa65d8b5' as 'libjsqrc/ethereumjs' 10 years ago
gulpfile.js Merge commit '7963e26aeb39d4ecb24edf1b206b2ef0757a0c70' into ethereumjs_subtree 10 years ago
index.js Merge commit 'f29b44ef9eedf5ca7b6d6fde4394315bf2086b4b' into develop 10 years ago
package.json Merge commit 'ab745d3b0eb89d67db1ed953020c665be3d072ed' into develop 10 years ago

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

NPM version Build Status dependency status dev dependency status

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.

Contribute!

Requirements

  • Node.js
  • npm
  • gulp (build)
  • mocha (tests)
sudo apt-get update
sudo apt-get install nodejs
sudo apt-get install npm
sudo apt-get install nodejs-legacy

Building

npm run-script build

Testing

npm test

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