bitswipe-admin
Lamassu admin server. First part of Lamassu stack you need to install.
Last updated 3 years ago by sethbergman .
UNLICENSED · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install bitswipe-admin 
SYNC missed versions from official npm registry.

Bitswipe Admin Frontend

Lamassu ATM Process Improvement Documentation


Background

BitSwipe has been contracted to assist a client with their conversion of fiat currency to Bitcoin. This client receives fiat currency from their deployed Lamassu ATMs and needs to convert this currency to Bitcoin in order to pay their ATM customers. In the process, the client receives a percent of each transaction in the form of revenue.

Current process

  1. The client receives fiat currency from the Lamassu ATM and deposits the currency into their bank account.
  2. The client then wires this currency over to a BitSwipe bank account.
  3. BitSwipe wires these funds to the Kraken exchange.
  4. BitSwipe exhanges these funds for Bitcoin.
  5. BitSwipe sends Bitcoin to the client’s wallet.
  6. The client uses the new Bitcoin to pay customer when they deposit fiat currency into the Lamassu ATM.

Proposed process

  1. The client receives fiat currency from the Lamassu ATM.
  2. The Lamassu server initiates an exchange of fiat currency to Bitcoin on the client’s behalf.
  3. The Lamassu server sends the Bitcoin to the customer’s wallet
  4. The client deposits fiat currency received from the ATM to their bank account and then wires these funds to their Kraken account.

Technical background

The Lamassu ATM runs on open source technology. The front-end ATM interface runs on javascript and Ruby and the back-end server runs on Javascript. There are various plugins for wallets (BitGo, Bitcoind, Coinapult, Blockchain.info, GreenAddress) and exchanges (Kraken, Bitstamp, Coinbase, Coinapult, Coinfloor, itBit).


Implementation Requirements for Kraken API

Signup

Create an API key

Under settings, and API, create a new key:

https://www.kraken.com/u/settings/api

Assign it the following permissions:

Copy down the API Key and Private Key shown.

Configuring in your admin

Open the 'Third Party Services / Kraken' panel in your Lamassu admin. Input the API Key and Private Key credentials, clicking Submit:

Then navigate to the 'Global Settings / Wallet Settings' panel. Select Kraken from the Exchange and Ticker drop-down list under the tab for each currency that you'd like to enable trading for:

Testing

Test trades by placing purchases at the machine and ensure fiat is converted into the relevant cryptocurrency in your Kraken balances.

Documentation Articles

  • Setting up the Lamassu admin
  • Configuring Bitcoin Core (bitcoind)
  • Updating your backend software
  • Unpairing your machine
  • Latest software releases & notices
  • Lamassu server commands

  • TODO

    • Research implementation for cloud infrastructure
    • Kubernetes or Docker
    • Simplify setup process
    • Security and penetration testing
    • Automate server configuration
    • Documentation updates and fix broken links
    • Process improvement for user experience
    • Engineering team call =======

    lamassu-admin

    Lamassu admin server. First part of Lamassu stack you need to install.

    Installation

    git clone git@github.com:lamassu/lamassu-admin.git
    cd lamassu-admin
    npm install
    

    You also need a Postgres running. Postgres is required for storing configuration of the remote server. Install Postgres with your package manager of choice, then:

    sudo su - postgres
    createuser --superuser lamassu
    createdb -U lamassu lamassu
    

    Then you need SQL scripts to seed initial configs. They are under /database. You can bootstrap your database by running:

    psql lamassu lamassu < database/lamassu.sql
    

    Configuration

    You'll be able to configure your stack when you start the server for the first time.

    Running

    node app.js
    

    Then, open it.

    Deployment

    Heroku

    Both lamassu-admin and lamassu-server are deployable to Heroku.

    First, you need to get a Heroku account and install the Heroku toolkit.

    The easy way

    deploy-all.sh is an easy installation and deployment script. You can run it standalone, without cloning lamassu-admin. It'll clone both repositories to your current working directory and deploy them to Heroku:

    mkdir lamassu
    curl https://raw.github.com/lamassu/lamassu-admin/master/deploy-all.sh > deploy-all.sh
    chmod +x deploy-all.sh
    ./deploy-all.sh
    

    You can deploy updates to your applications by rerunning deploy-all.sh.

    A bit harder way

    You can also clone and deploy each app individually. To do that, clone both lamassu-admin and lamassu-server.

    git clone https://github.com/lamassu/lamassu-admin.git
    git clone https://github.com/lamassu/lamassu-server.git
    

    Next, deploy lamassu-admin:

    cd lamassu-admin
    ./deploy.sh
    

    Visit the deployed application to configure your Lamassu ATM. Make sure to input all required API keys.

    Next, to deploy lamassu-server you need to grab DATABASE_URL for the Postgres database our deployment script created.

    db=$(heroku config:get DATABASE_URL)
    

    Then, go to lamassu-server and deploy it:

    DATABASE_URL="$db" ./deploy.sh
    

    You need to pass DATABASE_URL to it since both lamassu-admin and lamassu-server use the same database.

    Both applications should be deployed and running.

    Current Tags

    • 0.5.14                                ...           latest (3 years ago)

    1 Versions

    • 0.5.14                                ...           3 years ago
    Maintainers (1)
    Downloads
    Today 0
    This Week 0
    This Month 0
    Last Day 0
    Last Week 0
    Last Month 0
    Dependencies (17)
    Dev Dependencies (1)
    Dependents (0)
    None

    Copyright 2014 - 2017 © taobao.org |