fin4-core

⚠️ This repository is no longer active. Together with other strands of work it is further pursued here: FIN4XPLORER

Finance 4.0

Finance 4.0 aims for a multi-dimensional incentive system to motivate sustainable behavior. Communities can creat cryptographic tokens to incentivize certain behavior, e.g. collecting waste, avoiding C02, helping others, etc. Users can obtain these tokens by proving that they performed such actions. The number of different token types is unlimited, leading over time to a multi-dimensional system of different incentives -- smart coordination through "sustainable money". In the same spirit, the system uses tokens for democratic governance. A live instance can be found here: www.finfour.net . Main concepts of the Finance 4.0 system are explained in Decrypting Distributed Ledger Systems. This document is a good starter for everyone who wants to know

• What is a cryptoeconomic token?
• What is the difference between Ethereum, Bitcoin and Hyperledger?
• What are actions in a distributed ledger technology (DLT) system?
• What are claims?
• How do cryptoeconomic tokens have value?

To learn more about the finance 4.0 system:

Short video: Youtube - Distributed Sustainability

Social media: Twitter

Concept paper: Finance4.0

Slack: todo

Content

• Fin4 Demonstrator.
• Installation.
• Documentation.
• Contribution.

Fin4 Demonstrator | This repository

This repository contains a backend server (written in Golang) and a web front-end (written in Elm) of the Finance 4.0 demonstrator. The ELM web app enables a user to

• Create a new Type of cryptoeconomic Token, which is deployed on the server and Ethereum Blockchain
• Obtain units of created tokens via performing an action, such as planting a tree
• Performing Oracle tasks in order to approve actions

The server provides

• APIs for clients, such as the ELM app
• Communication functionalities with the Ethereum Blockchain
• Smart contract deployer
• Functionality to store actions

The smart contracts are written in Solidity for the Ethereum platform.

In the following Section we explain how the web app and server can be set up.

Install Finance 4.0 demonstrator

We assume a fresh Ubuntu 18.10 system for the following.

Dependencies

• Golang 1.10 (https://golang.org/doc/install): install via package manager

• configure env variables:

export GOROOT=/usr/local/go #try whereis go to see where the root is installed
export GOPATH=$HOME/Projects/goprojects #folder where fin-4 will be installed in
export PATH=$GOPATH/bin:$GOROOT/bin:$PATH
export GOBIN=$GOPATH/bin

Best is to store this in ~/.bashrc, so that this automatically set whenever you start a new terminal session.

• Ganache-cli (https://github.com/trufflesuite/ganache-cli): npm install -g ganache-cli

• gin (https://github.com/codegangsta/gin) is a simple command line utility for live-reloading Go web applications: go get github.com/codegangsta/gin

• Elmlang 0.18.0 (you must not use a newer version): npm install -g elm@elm0.18.0

• MySQL server: apt-get install mysql-server

Set up

$ git clone https://github.com/FuturICT2/fin4-core.git
$ cd fin4-core
$ go get
$ npm install #install server dependencies
$ elm package install #install elm web app dependencies

Setting up database:

sudo mysql_secure_installation
set the root password
sudo mysql -u root -p
enter password

Inside MySQL, create a new database called fin4.

CREATE DATABASE fin4 default charset utf8;

Assign a user full access right to the fin4 database (or leave it with root).

Env variables

Copy the .env_sample file to .env:

cp fin4-core/.env_sample fin4-core/.env

Open the .env file and add the following information:

modify DATA_SOURCE_NAME by adding USERNAME, PASSWORD and DB_NAME. Assuming a root user for the fin4 database and the password "password1" (use the one you set above) the expression should look as follow:

$ export DATA_SOURCE_NAME="root:password1@/fin4?charset=utf8mb4,utf8&parseTime=true"

Running the development-server

$ source .env # load the environment variables - Do not forget this whenever you open a new terminal
$ ganache-cli # simulates the ethereum blockchain. Alternatively, you can use the Ganache application
$ make server-dev # deploy the server

Running the development-client (web front-end)

$ make client-dev

After the build, open https://localhost:8888/ in your favourite browser.

Testing

requires go get github.com/gorilla/websocket

$ make test
$ make test-cover
$ make cover-view

Documentation

In the following we document the basic execution of the server and the elm app are explained. Detailed information can/ will be found in the respective packages.

fin4 Server

The main functioning of the server is explained in the server package.

Entry point - main.go

When executing

make server-dev

A new server instance is exportet to the port 8181, which listens to port 3000 (hence all http request will need to be send to this port). You dont know what ports are? Find brief example explanation here . In particular, main.go is executed which

• loads the necessary environment variables into the program
• connects to the local database (which you specified in the .env file)
• initiates the token and user services
• connects with AWS (is used in our live instance, which is deployed to www.finfour.net)
• connects with an instance of Ethereum
• start listening to http request (which internally uses the gin library)

fin4 webapp

Contribute!

We are looking for collaboration from the Open Source community. The project needs enhancements regarding code quality, documentation, and testing. To contribute to the project please take a look at open issues.