A little e-book on Ethereum Development with Go.

<p align="center">
  <a href="https://goethereumbook.org"><img src="https://github.com/miguelmota/ethereum-development-with-go-book/raw/master/assets/cover.jpg" width="320" alt="Book cover" /></a>
</p>
<br>

# Ethereum Development with Go

> A little guide book on [Ethereum](https://www.ethereum.org/) Development with [Go](https://golang.org/) (golang)

[![License](http://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/miguelmota/merkletreejs/master/LICENSE)
[![Mentioned in Awesome Go](https://awesome.re/mentioned-badge.svg)](https://github.com/avelino/awesome-go)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](#contributing)

## Online

[https://goethereumbook.org](https://goethereumbook.org/)

## E-book

The e-book is avaiable in different formats.

- [PDF](https://goethereumbook.org/ethereum-development-with-go.pdf)
- [EPUB](https://goethereumbook.org/ethereum-development-with-go.epub)
- [MOBI](https://goethereumbook.org/ethereum-development-with-go.mobi)

## Languages

* [English](en/)
* [Chinese中文](zh/)

## Contents

* [Introduction](en/README.md)
* [Client](en/client/README.md)
  * [Setting up the Client](en/client-setup/README.md)
* [Accounts](en/accounts/README.md)
  * [Account Balances](en/account-balance/README.md)
  * [Account Token Balances](en/account-balance-token/README.md)
  * [Generating New Wallets](en/wallet-generate/README.md)
  * [Keystores](en/keystore/README.md)
  * [HD Wallets](en/hd-wallet/README.md)
  * [Address Check](en/address-check/README.md)
* [Transactions](en/transactions/README.md)
  * [Querying Blocks](en/block-query/README.md)
  * [Querying Transactions](en/transaction-query/README.md)
  * [Transferring ETH](en/transfer-eth/README.md)
  * [Transferring Tokens](en/transfer-tokens/README.md)
  * [Subscribing to New Blocks](en/block-subscribe/README.md)
  * [Create Raw Transaction](en/transaction-raw-create/README.md)
  * [Send Raw Transaction](en/transaction-raw-send/README.md)
* [Smart Contracts](en/smart-contracts/README.md)
  * [Smart Contract Compilation & ABI](en/smart-contract-compile/README.md)
  * [Deploying a Smart Contract](en/smart-contract-deploy/README.md)
  * [Loading a Smart Contract](en/smart-contract-load/README.md)
  * [Querying a Smart Contract](en/smart-contract-read/README.md)
  * [Writing to a Smart Contract](en/smart-contract-write/README.md)
  * [Reading Smart Contract Bytecode](en/smart-contract-bytecode/README.md)
  * [Querying an ERC20 Token Smart Contract](en/smart-contract-read-erc20/README.md)
* [Event Logs](en/events/README.md)
  * [Subscribing to Event Logs](en/event-subscribe/README.md)
  * [Reading Event Logs](en/event-read/README.md)
  * [Reading ERC-20 Token Event Logs](en/event-read-erc20/README.md)
  * [Reading 0x Protocol Event Logs](en/event-read-0xprotocol/README.md)
* [Signatures](en/signatures/README.md)
  * [Generating Signatures](en/signature-generate/README.md)
  * [Verifying Signatures](en/signature-verify/README.md)
* [Testing](en/test/README.md)
  * [Faucets](en/faucets/README.md)
  * [Using a Simulated Client](en/client-simulated/README.md)
* [Swarm](en/swarm/README.md)
  * [Setting Up Swarm](en/swarm-setup/README.md)
  * [Uploading Files to Swarm](en/swarm-upload/README.md)
  * [Download Files From Swarm](en/swarm-download/README.md)
* [Whisper](en/whisper/README.md)
  * [Connecting Whisper Client](en/whisper-client/README.md)
  * [Generating Whisper Key Pair](en/whisper-keys/README.md)
  * [Sending Messages on Whisper](en/whisper-send/README.md)
  * [Subscribing to Whisper Messages](en/whisper-subscribe/README.md)
* [Utilities](en/util/README.md)
  * [Collection of Utility Functions](en/util-go/README.md)
* [Glossary](en/GLOSSARY.md)
* [Resources](en/resources/README.md)

## Help & Support

- Join the [#ethereum](https://gophers.slack.com/messages/C9HP1S9V2/) channel on the [gophers slack](https://invite.slack.golangbridge.org/) for Go (golang) help

- The [Ethereum StackExchange](https://ethereum.stackexchange.com/) is a great place to ask general Ethereum question and Go specific questions

## Development

Install dependencies:

```bash
make install
```

Run gitbook server:

```bash
make serve
```

Generating e-book in pdf, mobi, and epub format:

```bash
make ebooks
```

Visit [http://localhost:4000](http://localhost:4000)

## Contributing

Pull requests are welcome!

If making general content fixes:

- please double check for typos and cite any relevant sources in the comments.

If updating code examples:

- make sure to update both the code in the markdown files as well as the code in the [code](code/) folder.

If wanting to add a new translation, follow these instructions:

1. Set up [development environment](#development)

2. Add language to `LANGS.md`

3. Copy the the `en` directory and rename it with the 2 letter language code of the language you're translating to (e.g. `zh`)

4. Translate content

5. Set `"root"` to `"./"` in `book.json` if not already set

## Thanks

Thanks to [@qbig](https://github.com/qbig) and [@gzuhlwang](https://github.com/gzuhlwang) for the Chinese translation.

And thanks to all the [contributors](https://github.com/miguelmota/ethereum-development-with-go-book/graphs/contributors) who have contributed to this guide book.

## License

Released under the [CC0-1.0](./LICENSE) license.

© [Miguel Mota](https://github.com/miguelmota)


Ethereum Development with Go

Collection of Go images, graphics, and art.

golang-graphics
================

A community repository for Go language vector (and bitmap) graphics. It includes the official graphics that ship with Go as well as 3rd-party contributions.

This is an *unofficial* repository.

The goal of this repository is to encourage creativity and innovation (as well as fair use) in the Go community. Having access to high-quality vector graphics and 3D models makes it possible to produce beautiful, creative works that feel familiar and recognizable.



## How to Contribute

Just submit a pull request with your creation or derivative work. Vector formats are preferred.

**Here's some tips for submitting a PR:**

- Files are organized into folders by type. If a folder for your file type doesn't already exist, you may create it.
- Each folder should have a plain-text file called `README`. It credits each file in alphabetical order in this kind of format (flexible depending on the contribution):
```
file-name.ext
	Contributed by Your Name
	If released under a different license, specify it here
	Adaptation of original-file.png (Original Creator)
	Any other source or historical information of interest
```
- If possible, please try to keep file names lowercase with hyphens between words (no spaces or other punctuation).



## Check the license!

[![CC-BY-4.0](http://i.creativecommons.org/l/by/4.0/88x31.png)](http://creativecommons.org/licenses/by/4.0)

By default, contributions fall under [Creative Commons Attribution 4.0 International](http://creativecommons.org/licenses/by/4.0). However, licenses vary among different files, so pay attention before you use.


#### Is a license specified for that file in the README?

Each folder has a file called `README` that contains information about its contents. If a certain file has an exceptional license, it will be specified in the `README`.



#### Is there a LICENSE file in the folder?

If a folder has a `LICENSE` file, that license applies, by default, to all files in that folder and all sub-folders. It may be overridden by subsequent `LICENSE` files or on a per-file basis in a `README`.





## Hotlinking

We advise against linking directly to these images. GitHub is not a CDN; if the paths ever change, your links will break.



## Original credit

The original Go gopher was created by [Renée French](http://reneefrench.blogspot.com) and is released under [Creative Commons Attribution 3.0 USA license](http://creativecommons.org/licenses/by/3.0/us). Thus all derivatives must provide attribution.

More information about the gopher can be found [on the Go blog](http://blog.golang.org/gopher).


golang-graphics

An opinionated guideline to structure & develop a Go web application/service.

goapp


# Working with Go

## View online at: https://mkaz.blog/working-with-go/

Working with Go is a set of examples for Go (golang) to help an experienced programmer become familiar with the Go language. Go is often referred to as golang to help searches.


## Resources

This set of examples assumes a base level of programming experience and is intended for someone learning the Go language from another language; not necessarily someone new to programming altogether.

If you are starting out and want to learn how to program and choose Go as your first language, check out [Learn Programming in Go](http://www.golang-book.com/)

The official site has a [Tour of Go](http://tour.golang.org/) which is an interactive walk through, another good introduction to the language.

I'm also a big fan of [Go by Example](https://gobyexample.com/) which is quite similar.


## Contribute

The site is sourced from markdown files in the `pages` directory. Any additions, corrections, suggestions or any contributions are appreciated.

To submit a pull request, make your edit to the file in `pages` directory.

Working with Go was started by Marcus Kazmierczak. Thanks to <a href="https://github.com/mkaz/working-with-go/graphs/contributors">all the contributors</a> who have helped make it even better.


## License

Working with Go is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/4.0/">Creative Commons Attribution 4.0 International License</a>.


The Best Go Libraries For Websites - Other (4)

Ethereum Development with Go

golang-graphics

goapp

Working with Go