2017-10-09 14:11:12 +00:00
# Status bindings for go-ethereum
[](https://travis-ci.org/status-im/status-go)
[](https://godoc.org/github.com/status-im/status-go) [](https://github.com/status-im/status-go/tree/master) [](https://github.com/status-im/status-go/tree/develop)
2016-09-28 14:35:39 +00:00
2017-10-09 14:11:12 +00:00
# Docs
- [How To Build ](https://www.notion.so/status/Building-status-go-f6b827dd1302436ba0575f4c543a352e )
- [Notes on Bindings ](https://www.notion.so/status/Binding-notes-344f30ce0f2845a2b43e2de70931284a )
- [Status-go docs ](https://www.notion.so/status/status-go-4fbe361e8e75484abeadadc80dd4dcdc )
2016-12-19 20:51:08 +00:00
2017-10-09 14:11:12 +00:00
# Intro
status-go is an underlying part of [Status ](status.im ) - a browser, messenger, and gateway to a decentralized world.
2016-09-28 14:35:39 +00:00
2017-10-09 14:11:12 +00:00
It's written in Go and requires Go 1.8 or above.
2016-09-28 14:35:39 +00:00
2017-10-09 14:11:12 +00:00
It uses Makefile to do most common actions. See `make help` output for available commands.
2016-09-01 13:39:04 +00:00
2018-01-26 02:14:29 +00:00
status-go uses [forked ethereum-go ](https://github.com/status-im/go-ethereum ) with [some patches applied ](https://github.com/status-im/status-go/geth-patches/ ) in it, located under [`vendor/` dir ](https://github.com/status-im/status-go/tree/develop/vendor/github.com/ethereum/go-ethereum ). See [geth-patches README ](https://github.com/status-im/status-go/tree/develop/geth-patches ) for more info.
2016-09-28 12:31:09 +00:00
2017-10-09 14:11:12 +00:00
# Build
There are two main modes status-go can be built:
- standalone server
- library to link for Android or iOS
Use following Makefile commands:
- `make statusgo` (builds binary into `build/bin/statusd` )
- `make statusgo-android` ) (builds .aar file `build/android-16/aar` )
- `make statusgo-ios` and `make statusgo-ios-simulator` (builds iOS related artifacts in `build/os-9.3/framework` )
# Testing
2017-11-07 17:46:11 +00:00
To setup accounts passphrase you need to setup an environment variable: `export ACCOUNT_PASSWORD="secret_pass_phrase"` .
2018-01-04 16:04:40 +00:00
Make sure the dependencies are installed first by running:
```
make lint-install
make mock-install
```
2018-01-29 10:14:55 +00:00
2018-01-04 16:04:40 +00:00
To test fully statusgo, use:
```
make ci
```
To test statusgo using a given network by name, use:
```
make ci networkid=rinkeby
```
To test statusgo using a given network by number ID, use:
```
make ci networkid=3
```
2017-10-09 14:11:12 +00:00
2018-01-29 10:14:55 +00:00
If you have problems running tests on public network we suggest reading [e2e guide ](e2e/README.md ).
2017-10-09 14:11:12 +00:00
If you want to launch specific test, for instance `RPCSendTransactions` , use the following command:
```
2017-11-04 04:20:17 +00:00
go test -v ./geth/api/ -testify.m ^RPCSendTransaction$
2017-10-09 14:11:12 +00:00
```
Note `-testify.m` as [testify/suite ](https://godoc.org/github.com/stretchr/testify/suite ) is used to group individual tests.
2016-09-28 12:31:09 +00:00
2017-10-09 14:11:12 +00:00
# Licence
[Mozilla Public License 2.0 ](https://github.com/status-im/status-go/blob/develop/LICENSE.md )
