goipay

README

Description

A lightweight crypto payment processor microservice, written in Golang, designed for creating and processing cryptocurrency invoices via gRPC.

Supported Crypto

• XMR
• BTC
• LTC
• ETH (USDT, USDC, DAI, WBTC, UNI, LINK, AAVE, CRV, MATIC, SHIB, BNB, ATOM, ARB)
• BNB (BSC-USD, USDC, DAI, BUSD, WBTC, BTCB, UNI, LINK, AAVE, MATIC, SHIB, ATOM, ARB, ETH, XRP, ADA, TRX, DOGE, LTC, BCH, TWT, AVAX, CAKE)

Getting Started

Prerequisites

• Go ≥ 1.22
• PostgreSQL ≥ 12

Installation

Docker

• Clone the repo

  git clone https://github.com/goipay/goipay.git
  

• Inside the root dir create and populate .env file on the base of .env.example file

  SERVER_HOST=0.0.0.0
  SERVER_PORT=3000
  
  SERVER_TLS_MODE=tls
  SERVER_TLS_CA=/app/cert/server/ca.crt
  SERVER_TLS_CERT=/app/cert/server/server.crt
  SERVER_TLS_KEY=/app/cert/server/server.key
  
  # As for now, only PostgreSQL is supported
  DATABASE_HOST=db
  DATABASE_PORT=5432
  DATABASE_USER=postgres
  DATABASE_PASS=postgres
  DATABASE_NAME=goipay_db
  
  XMR_DAEMON_URL=http://node.monerodevs.org:38089
  XMR_DAEMON_USER=
  XMR_DAEMON_PASS=
  
  BTC_DAEMON_URL=http://localhost:38332
  BTC_DAEMON_USER=user
  BTC_DAEMON_PASS=pass
  
  LTC_DAEMON_URL=http://localhost:18444
  LTC_DAEMON_USER=user
  LTC_DAEMON_PASS=pass
  
  ETH_DAEMON_URL=https://ethereum.publicnode.com
  
  BNB_DAEMON_URL=https://bsc-dataseed.binance.org
  

• Inside the root dir you can find an example docker-compose.yml file. For testing purposes can be run without editing.

  docker compose up
  

Native

• Clone the repo

  git clone https://github.com/goipay/goipay.git
  

• Build using make

  cd goipay && make build
  

• Under the bin folder you will find server binary

  ./bin/server -h
  
  Usage of ./bin/server:
    -client-ca string
          Comma-separated list of paths to client certificate authority files (for mTLS)
    -config string
          Path to the config file (default "config.yml")
    -log-level string
          Defines the logging level
    -reflection
          Enables gRPC server reflection
  

Usage

• Get a quick overview of how GoiPay works by watching this simple showcase video.
• Check out an example project to see GoiPay in action.
• For detailed information on using GoiPay's API, refer to the API Reference.

Use cases

GoiPay is designed as a microservice that can be integrated into larger projects. If you need a simple, lightweight solution for just generating and processing crypto invoices, GoiPay is the perfect choice.