Featherjs server for caching giveth data.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
config Update ethConversionService to support crypto for fiat and move fiat … Dec 13, 2018
.editorconfig add prettier config from dapp Feb 6, 2018
.eslintrc closes #69 linting fixes Aug 3, 2018
.gitignore Revert gitignore Nov 19, 2018
.npmignore givers service and ignorn yarnlock Aug 2, 2017
.prettierrc add prettier config from dapp Feb 6, 2018
README.md Merge remote-tracking branch 'origin/develop' into feature/token-inte… Nov 15, 2018
package-lock.json add package-lock.json to fix web3 dep issues Dec 28, 2018
package.json set Frame-size when using WS provider Dec 27, 2018


Feathers Giveth

Real-time json cache server for blockchain data

Note: Please use develop branch for contributing.

Welcome to the server code for Giveth's dapp. The dapp uses feathers as a cache for its blockchain transactions. By utilizing websockets on both the blockchain and client devices, we can receive and push updates simultaneously to all users in real time.

Table of content

Getting Started


  1. Click Star on this repo near the top-right corner of this web page (if you want to).
  2. Join our slack if you haven't already.
  3. Fork this repo by clicking Fork button in top-right corner of this web page. Continue to follow instruction steps from your own feathers-giveth repo.
  4. The rest of these steps must be done from your machine's command line. Clone your own "feathers-giveth" repo. Copy the link from the "Clone or download" button near the top right of this repo's home page.
    git clone {paste your own repo link here}
  5. Change directories to feathers-giveth:
    cd feathers-giveth
  6. Make sure you have NodeJS (v8.4.0 or higher), yarn (v0.27.5 or higher), and npm (5.4.1 or higher) installed.
  7. Install dependencies from within feathers-giveth directory:
    npm install
    • note: due to a bug in yarn, yarn install currently does not work
  8. Install Mongo (we recommend installing via Brew)
  9. Run Mongo in a terminal window mongod or in the background mongod --fork --syslog
  10. (optionally) Install IPFS (we recommend installing via Brew)
  • If you don't install ipfs, image uploading will be affected. You can update the config ipfsGateway value to use a public ipfs gateway ex. https://ipfs.io/ipfs/, however your uploads will be removed at some point

Run server

The feathers server will need to connect to an ethereum node via websockets. Typically this will be a local TestRPC instance. The configuration param blockchain.nodeUrl is used to establish a connection. The default nodeUrl is ws://localhost:8545

  1. We need to deploy any contract to that we intend to call. NOTE: The following cmd will clear the data dir, thus starting off in a clean state.

    yarn deploy-local

    After deploying local, make sure to copy-paste the MiniMeToken address in default.json

  2. We provide an easy way to start the bridge & 2 ganache-cli instances.

    yarn start:networks
  3. Since the bridge & ganache-cli is now running, open a new terminal window and navigate to the same feathers-giveth directory.

  4. Optionally open a new terminal window and start the ipfs daemon

    ipfs daemon
  5. Start your app

    yarn start

Kill Ganache

If you run into errors like wallet balance not loading, it is very likely that Ganache is stuck netstat -vanp tcp | grep 8545 Find the process that is listening on *.8545 and and kill it with kill -9 PID (which is in the last colomn)

IPFS Support

If the ipfsApi is a valid ipfs node that we can connect to, we will pin every ipfs hash that is stored in feathers. We currently do not remove any orphaned (hashes with no references in feathers) ipfs hashs. In the future we will provide a script that you can run as a cronjob to unpin any orphaned hashes.

Video Walkthrough

Video tutorial walkthrough here: https://tinyurl.com/y9lx6jrl


  1. Start a production server

    yarn serve


The feathers-giveth/scripts directory contains a few scripts to help development.

deploy.js - deploys a new vault & liquidPledging contract

getState.js - prints the current state of the deployed vault & liquidPledging contracts.

confirm.js - confirms any payments that are pending in the vault


Simply run yarn test and all your tests in the test/ directory will be run.


You can control the logging level with the LOG_LEVEL env variable. Available levels can be found at: https://github.com/winstonjs/winston/tree/2.x#logging-levels

To enable debug logging simply start the server with LOG_LEVEL=debug yarn start


Each of these services are available via rest or websockets:


If the server is using default configurations, you can see data for any of these services through your web browser at http://localhost:3030/SERVICE_NAME


We use pm2 to manage our production servers. You can start the server using the yarn serve cmd. You will need to create an ecosystem.config.js file with the following contents:

module.exports = {
   * Application configuration section
   * http://pm2.keymetrics.io/docs/usage/application-declaration/
  apps: [
    // First application
      name: 'feathers',
      script: 'src/index.js',
      log_date_format: 'YYYY-MM-DD HH:mm',
      env: {
        COMMON_VARIABLE: 'true',
      env_production: {
        NODE_ENV: 'production',


  1. You will need to download the rsk node. After installing, you will run the node w/ the regtest network for local development.
java -jar rskj-core-0.5.2-ORCHID-all.jar co.rsk.Start --regtest


java -Drsk.conf.file=rsk.conf -jar rskj-core-0.5.2-ORCHID-all.jar co.rsk.Start
  1. We need to deploy any contracts that we intend to call. NOTE: You will also need to ensure that your rsk node is in a clean state (reset) for the configured addresses to be correct.

    npm run deploy-local:rsk
  2. Optionally open a new terminal window and start the ipfs daemon

    ipfs daemon
  3. Start your app

    yarn start:rsk


For more info on how to work with feathers checkout out their docs on service methods, service events, and database querying.

Also feel free to reach out to us on slack for any help or to share ideas.