https://github.com/alejoacosta74/processing-crypto-payments-bitcoind
Javascript based solution that reads deposit transactions from bitcoind’s rpc call listsinceblock, filters and store them in a database for later usage.
https://github.com/alejoacosta74/processing-crypto-payments-bitcoind
docker-compose mongodb mongoose nodejs
Last synced: 3 months ago
JSON representation
Javascript based solution that reads deposit transactions from bitcoind’s rpc call listsinceblock, filters and store them in a database for later usage.
- Host: GitHub
- URL: https://github.com/alejoacosta74/processing-crypto-payments-bitcoind
- Owner: alejoacosta74
- Created: 2021-03-02T04:01:37.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2021-03-05T13:05:22.000Z (over 5 years ago)
- Last Synced: 2025-05-15T20:08:33.277Z (about 1 year ago)
- Topics: docker-compose, mongodb, mongoose, nodejs
- Language: JavaScript
- Homepage:
- Size: 43.9 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Bitcoin daemon RPC TX deposit validation
## About
This project implements a solution that reads **deposit transactions** from bitcoind’s rpc call `listsinceblock`, filters and store them in a database for later usage.
## Assumptions
A deposit will be considered valid when the transaction's attributes match the following criteria:
- `"category"` of type `"receive"`
- `"amount"` greater than zero (a TX with 'amount == 0' has not been considered as a valid deposit)
- `"confirmations"` equal or greater than 6
## Considerations
- Only **unique** transactions are stored in the database.
- When reading transactions from files `transactions-1.json` and `transactions-2.json`, if the transaction already exists in the database, the duplicated transaction is discarded.
- Floating type is used to store the `amount` attribute in the database, in order to handle values up to 8 decimals.
## Tools and dependencies
This project is implemented in *javascript* with *Node.js* and *MongoDb / Mongoose*
## Requirements
Docker Engine must be installed on local machine
## Usage
```bash
$ clone https://github.com/alejoacosta74/processing-crypto-payments-bitcoind.git bitcoind-deposit-filter
$ cd bitcoind-deposit-filter
$ docker-compose up --build
```
## Expected output
```bash
Deposited for Wesley Crusher: count=35 sum=217.00000000
Deposited for Leonard McCoy: count=15 sum=64.00000000
Deposited for Jonathan Archer: count=18 sum=99.69000000
Deposited for Jadzia Dax: count=11 sum=55.13000000
Deposited for Montgomery Scott: count=24 sum=108.04593000
Deposited for James T. Kirk: count=27 sum=1267.00848015
Deposited for Spock: count=14 sum=688.88081478
Deposited without reference: count=167 sum=3453.79101076
Smallest valid deposit: 0.00000010
Largest valid deposit: 99.49379661
```