squirrel-nation / lama

Ledger Account Manager API - Synchronization and management of account states across Blockchain protocols

Lama

Synchronization and management of account states (transactions, balance, ...) across Blockchain protocols.

Main features of Lama are:

• Scalable and stateless components
• Event-driven architecture
• Account manager component for handling account metadata and sending sync event messages
• Easy support of new coin integration by having coin specific components:
  • Worker: fetching data from blockchain
  • Interpreter: computing and inserting data (operations, balance, ...)
  • Api: exposing http endpoints to get synced transactions, estimate fees, create and broadcast transactions

How Lama works?

Run lama components through docker

docker-compose up

Please have a look on docker-compose.yml file for more details on the configuration.

Account manager

The account manager handles account registration and unregistration and emits events to the dedicated coin worker. Please refer to the account manager README for more details on how it works.

Run through docker (recommended)

Install docker then run docker-compose up account-manager.

This will create a PostgreSql, a RabbitMQ, a Redis and the latest published image of the lama account manager.

Please have a look on docker-compose.yml file for more details on the configuration.

Build and publish image in local

sbt accountManager/docker:publishLocal

Run manually

Please refer to the getting started section of the account manager README.

Coin integration

Bitcoin REST API

Run through docker (recommended)

Run docker-compose up bitcoin-api.

Please have a look on docker-compose.yml file for more details on the configuration.

Build and publish image in local

sbt bitcoinApi/docker:publishLocal

Run manually

Please refer to the getting started section of the bitcoin api README.

Bitcoin Worker

Run through docker (recommended)

Run docker-compose up bitcoin-worker.

Please have a look on docker-compose.yml file for more details on the configuration.

Build and publish image in local

sbt bitcoinWorker/docker:publishLocal

Run manually

Please refer to the getting started section of the bitcoin worker README.

Bitcoin Interpreter

Run through docker (recommended)

Run docker-compose up bitcoin-interpreter.

Please have a look on docker-compose.yml file for more details on the configuration.

Build and publish image in local

sbt bitcoinInterpreter/docker:publishLocal

Run manually

Please refer to the getting started section of the bitcoin interpreter README.

Bitcoin transactor

Run through docker (recommended)

Run docker-compose up bitcoin-transactor.

Please have a look on docker-compose.yml file for more details on the configuration.

Build and publish image in local

sbt bitcoinTransactor/docker:publishLocal

Run manually

Please refer to the getting started section of the bitcoin transactor README.