Connect to GoCryptoTrader using its gRPC interface
GCTViewer is a multi-platform gRPC based app that acts as a visual interface to GoCryptoTrader. GoCryptoTrader is a cryptocurrency trading bot supporting multiple exchanges written in Golang.
GCTViewer is created to experiment with mobile platforms, gRPC and GoCryptoTrader. It is at this point in no way designed or intended to be used beyond experimentation.
This project is a starting point for building a Flutter application on top of GoCryptoTrader.
A few resources to get you started if this is your first Flutter project:
For help getting started with Flutter, view our online documentation, which offers tutorials, samples, guidance on mobile development, and a full API reference.
Install and configure Dart and Flutter following their official guides:
Do not forget to run flutter doctor and be sure to setup a mobile phone emulator as described in the Flutter manual.
Retrieve and prepare GCTViewer as follows:
git clone https://github.com/Talta/gctviewer.git
cd gctviewer
flutter pub getTo connect GCTViewer to GoCryptoTrader, it needs to be configured with GoCryptoTrader's connection details as
specified in GoCryptoTrader's remoteControl section in its config.json. A sample configuration file is provided in
assets/cfg/config_sample.json. Copy this file to assets/cfg/config.json and edit the connection details.
cp ./assets/cfg/config_sample.json ./assets/cfg/config.jsonGCTViewer also needs to be provided the TLS public key for connecting to GoCryptoTrader's gRPC channel. Copy the TLS certificate from GoCryptoTrader's config folder to GCTViewer's config.
Assuming the default GoCryptoTrader config folder is used, the certificate file is copied as follows:
cp ~/.gocryptotrader/tls/cert.pem ./assets/cfg/cert.pemOne way to run the app is through an emulator connected to Flutter. Identify a device ID to use in the emulator:
flutter emulators
flutter emulators --launch <emulator-ID>Run GCTViewer on an attached device:
flutter devices
flutter run -d <device-ID> lib/main.dartAlternatively, the gctview folder can be opened as a project in Android Studio or in Visual Studio Code, after which the emulator and the app can be run through the IDE.
Optionally, update the protocol buffer Dart code by generating the Dart files based on GoCryptoTrader's .proto file. See:
- Protocol Buffers - Dart Generated Code
- GoCryptoTrader gRPC Service
- Using Flutter with a gRPC backend
Note that in addition to GoCryptoTrader's protobuffer files, GCTViewer needs Google's timestamp protobuffer files.
Install the Dart plugin for the protoc compiler:
git clone https://github.com/dart-lang/protobuf/ dart-lang_protobuf
cd dart-lang_protobuf/protoc_plugin
pub installAnd optionally:
pub global activate protoc_pluginCompile updated dart include files, and move them to the GCTViewer source tree ./lib/model/grpc/:
protoc -I=. -I=$GOPATH/src -I=$GOPATH/src/github.com/grpc-ecosystem/grpc-gateway/third_party/googleapis --dart_out=grpc:$GCTVIEWERPATH/lib/model/grpc/ rpc.protoThe Dart plugin for the protoc compiler does not include the needed include files for timestamps, as documented here on Github. Although unlikely the include files need updating soon, a manual process is available. E.g.:
protoc -I=$GOPATH/src/github.com/grpc-ecosystem/grpc-gateway/third_party/googleapis --dart_out=grpc:$GCTVIEWERPATH/lib/model/grpc/ /usr/include/google/protobuf/timestamp.protoGCTViewer is written while exploring the many excellent Flutter and Dart tutorials by the Flutter and Dart teams:
Dart has a gRPC plugin, with limited support from its creators. There are however some excellent community provided tutorials and examples to exploit its possibilities and work around the limitations.