Terra FCD

Modules

• Collector(Indexer)

  • Takes block and tx from LCD and stores into the database in a usable form
  • Stores issuance, network and staking information to database every minute
  • Collect & cache validator info and store in db
  • Calculate validator daily return
  • Collect & cache proposal info

• Rest API server

  • Serves data via RESTFul API

Prerequisites

1. Node.js version 14 or later
2. PostgreSQL version 12 or later

Terra Core

1. Setup a LCD
2. Configure firewall (Reference)

Project setup

1. Clone

$ git clone https://github.com/terra-money/fcd.git

2. Install packages

npm i

3. Setup the database

FCD requires PostgreSQL as a backend database and TypeORM as an ORM.

Create a new database for FCD

postgres=> CREATE DATABASED fcd OWNER terra;

Synchronize Database Scheme

Table schema has to be synced before running Collector by setting synchronize to true. There is many way to configure TypeORM. Example is below:

ormconfig.js

module.exports = {
  name: 'default',
  type: 'postgres',
  host: 'localhost',
  database: 'fcd',
  username: 'terra',
  password: '<password>',
  synchronize: true
}

You shall not use CLI method, and it is good to disable synchronize option after the first sync.

4. Configure Environment Variables

In Terra, we use direnv for managing environment variable for development. See sample of .envrc

Running modules

Developement

• Collector

  npm run coldev

• API

  npm run dev

• Test

  npm run test

  • Tests are designed to use testnet

Production

• Collector

  npm run collector

• API

  npm run start

APIDoc & Swagger

apiDoc (https://apidocjs.com)

• Generate by npm run apidoc
• Access UI from: http://localhost:3060/apidoc

Swagger 2.0 (https://swagger.io)

• Generate by npm run swagger
• Access UI from: http://localhost:3060/swagger
• Access the definition from: http://localhost:3060/static/swagger.json

Generate swagger for AWS api gateway

npm run swagger -- --apigateway

• Generated file can be directly imported to aws api gateway
• NB : its uses empty schema for response object as api gateway support object and properties name only having alphanum.

Generate combined swagger for lcd and fcd

npm run mergeswagger -- -o filename

• Combined swagger file will be saved in static directory in project root
• If no filename provided as command line argument then default saved file name is combined-swagger.json
• To generate combined swagger for AWS API Gateway add --apigateway parameter

Find LocalTerra to run whole ecosystem locally

https://github.com/terra-money/localterra