Skip to content
This repository has been archived by the owner on Oct 4, 2019. It is now read-only.
Stevan Lohja edited this page Feb 13, 2019 · 82 revisions

Go-Ethereum is a Go language implementation of Ethereum Classic, supporting the original blockchain and its philosophy of immutability, censorship-resistance, and resilient distributed applications.

🔭 For general information related to Ethereum Classic including:

  • whitepaper
  • yellow paper
  • protocol and interface specs
  • affiliated APIs
  • DAPP development guides

... please see our Ethereum Project Main Wiki or visit our website.

Geth

The main Ethereum Classic client is called Geth (the old english third person singular conjugation of "to go". Quite appropriate given geth is written in Go. Geth is a multipurpose command line tool that runs a full Ethereum Classic node. It offers three interfaces:

Platforms: Supported Platforms are Linux, Mac, and Windows. In order to install Geth, please vist our Releases Page. Please consider reviewing our Disclaimer Notice before use.

License: The Ethereum Classic Core Protocol licensed under the GNU Lesser General Public License 3.0. All frontend client software (under cmd) is licensed under the GNU General Public License.

By installing and running geth, you can take part in the Ethereum Classic live network and

  • mine real ether
  • transfer funds between addresses
  • create contracts and send transactions
  • explore block history
  • and much, much more

Basic Use Case Documentation

Developers

This is an open source project made by and for a passionate and welcoming community. The ETC Labs Core team is lead by @stevanlohja, and Go-Ethereum's lead developer is @meowsbits. Introduce yourself on Discord, read the Contributing Guidelines, and find or make an issue.

Install dependencies and build

Building and testing geth requires both Go >=1.8 and a C compiler.

Installing Go Wiki page

Get set up:

# Go get it! (get it? ;-)
go get github.com/ethereumproject/go-ethereum/...

# Install binary 'geth' to $GOPATH/bin:
# Note: You can run this command from $cwd.
# Note: Ensure $GOPATH/bin is added to your $PATH.
go install github.com/ethereumproject/go-ethereum/cmd/geth
# Or, install all executables, including geth:
go install github.com/ethereumproject/go-ethereum/cmd/...

# check it out!
geth --help

Testing

See the Testing Wiki page for information on unit, integration, and external tests.

Logging

Geth outputs stderr to the console. Output from the console can be logged or redirected:

geth 2>>geth.log

Additionally, you may can use --log-dir=PATH to specify a directly in which geth will write it's logs to a timestamped file.

You can also use geth attach to begin a Javascript console session with an already-running instance of geth; just use a second terminal.

Further

Issues and Support

Please browse our FAQ Wiki page to see if there's already an answer to your question. If there isn't, please file an issue or get in touch with us on Disorc (#help or #development channels, preferably).

Reporting

Security issues are best sent to stevan.l@etclabs.org, dean.p@etclabs.org, or shared in PM with devs on the Discord channel.

Non-sensitive bug reports are welcome on Github. Please always state the version (on master) or commit of your build (if on develop), give as much detail as possible about the situation and the anomaly that occurred. Provide logs or stacktrace if you can.

Contributors

Ethereum is joint work of ETCDEV and the community.

Name or blame = list of contributors: