go-ethereum/README.md
Christopher Franko 61796668c8 continue merging 1
Merge continue 2

Fake commit to restart the build servers

Fake commit to hopefully fix the PPA issue.

update versionOracle address for expanse

Merge continue 3

Merge continue 4

cleaned up a few Eth stragglers

Merge continue 5

Not sure why the merge tool changed this file and removed that but it
did.

merge continue 6

fixing expanse.js

Again not sure why this one got edited from the last one but -shrug-

fixing rpc calls for eth_ for compatibility

rpc calls still acting crazy

more rpc fixes

make jsre console accept both exp and eth cmds

rpc fixes continued

adding eth api calls

rpc and js-console both have eth calls on by default now
2016-05-18 23:06:16 -04:00

6.4 KiB

Expanse Go

Expanse Go Client, by Christopher Franko (forked from Jeffrey Wilcke (and some other people)'s Expanse Go client).

      | Linux   | OSX | ARM | Windows | Tests

----------|---------|-----|-----|---------|------ develop | Build+Status | Build+Status | Build+Status | Build+Status | Buildr+Status Coverage Status master | Build+Status | Build+Status | Build+Status | Build+Status | Buildr+Status Coverage Status

Bugs Stories in Ready ![Stories in Progress](https://badge.waffle.io/expanse-project/go-expanse.svg?label=in%20progress&title=In Progress) Gitter

Automated development builds

The following builds are build automatically by our build servers after each push to the develop branch.

Building the source

For prerequisites and detailed build instructions please read the Installation Instructions on the wiki.

Building gexp requires both a Go and a C compiler. You can install them using your favourite package manager. Once the dependencies are installed, run

make gexp

Executables

Go Expanse comes with several wrappers/executables found in the cmd directory:

  • gexp Expanse CLI (expanse command line interface client)
  • bootnode runs a bootstrap node for the Discovery Protocol
  • exptest test tool which runs with the tests suite: /path/to/test.json > exptest --test BlockTests --stdin.
  • evm is a generic Expanse Virtual Machine: evm -code 60ff60ff -gas 10000 -price 0 -dump. See -h for a detailed description.
  • disasm disassembles EVM code: echo "6001" | disasm
  • rlpdump prints RLP structures

Contribution

gexp can be configured via command line options, environment variables and config files.

If you'd like to contribute to go-expanse, please fork, fix, commit and send a pull request for the maintainers to review and merge into the main code base. If you wish to submit more complex changes though, please check up with the core devs first on our gitter channel to ensure those changes are in line with the general philosophy of the project and/or get some early feedback which can make both your efforts much lighter as well as our review and merge procedures quick and simple.

Please make sure your contributions adhere to our coding guidlines:

  • Code must adhere to the official Go formatting guidelines (i.e. uses gofmt).
  • Code must be documented adherign to the official Go commentary guidelines.
  • Pull requests need to be based on and opened against the develop branch.
  • Commit messages should be prefixed with the package(s) they modify.
    • E.g. "exp, rpc: make trace configs optional"

Please see the Developers' Guide for more details on configuring your environment, managing project dependencies and testing procedures.

License

The go-expanse library (i.e. all code outside of the cmd directory) is licensed under the GNU Lesser General Public License v3.0, also included in our repository in the COPYING.LESSER file.

The go-expanse binaries (i.e. all code inside of the cmd directory) is licensed under the GNU General Public License v3.0, also included in our repository in the COPYING file.