README
¶
mn spread
mn spread is a visualization tool that allows you to check how masternodes are distributed around the world by processing a list of unique ip addresses. It resolves ISP and geo location and groups this by region and ISP in real-time.
Three ways of fetching ip list information implemented:
- Parse the IP list from a specific
web explorer. - Use a local
wallet clito get recent masternode information - Use a webcrawler that returns you recent information about masternodes
Flow
- get list of all active masternode ip addresses of a coin
- request
ipstack apiwith ip address to retrieve information - analyze and group by location and provider
- visualize
Example visualization
coins implemented
basic coin view
Installation
Its a simple go project that you can just checkout and build an executable. Requires go v1.10+
go get -u "github.com/cwntr/mn-spread"
Code dependencies
github.com/dnaeon/go-vcr/recorderHTTP request/response recorder
github.com/gin-gonic/ginGin Framework to utilize the frontend + APIs
github.com/cwntr/go-crypto-toolsfor client, wallet cli and webcrawler's
mn spread API
Coins Details
| Symbol | Name | API endpoint | Data point | Date implemented |
|---|---|---|---|---|
| XSN | Stakenet | (GET) /api/xsn |
local wallet cli |
2019-02 |
| DASH | Dash | (GET) /api/dash |
https://chainz.cryptoid.info | 2019-02 |
| XLQ | ALQO | (GET) /api/xlq |
https://masternodes.online | 2019-03 |
| GRPH | Graphcoin | (GET) /api/grph |
local wallet cli |
2019-02 |
| XZC | Zcoin | (GET) /api/xzc |
https://www.coinexplorer.net | 2019-02 |
| SYS | Syscoin | (GET) /api/sys |
https://chainz.cryptoid.info | 2019-02 |
| NIX | NIX | (GET) /api/nix |
https://chainz.cryptoid.info | 2019-02 |
| PHR | PHORE | (GET) /api/phr |
https://chainz.cryptoid.info | 2019-02 |
| PIVX | PIVX | (GET) /api/pivx |
https://masternodes.online | 2019-03 |
| BEET | Beetle Coin | (GET) /api/beet |
https://masternodes.online | 2019-03 |
| GIN | GINcoin | (GET) /api/gin |
https://masternodes.online | 2019-03 |
| POLIS | Polis | (GET) /api/polis |
https://masternodes.online | 2019-03 |
| RUPX | Rupaya | (GET) /api/rupx |
https://masternodes.online | 2019-03 |
| BITG | BitcoinGreen | (GET) /api/bitg |
https://masternodes.online | 2019-03 |
| CCBC | Crypto Cash Back Coin | (GET) /api/ccbc |
https://masternodes.online | 2019-03 |
| BWK | Bulwark | (GET) /api/bwk |
https://masternodes.online | 2019-03 |
| XLR | Solaris | (GET) /api/xlr |
https://masternodes.online | 2019-03 |
| PAWS | PAWS Fund | (GET) /api/paws |
https://masternodes.online | 2019-03 |
| DASHG | Dash Green | (GET) /api/dashg |
https://masternodes.online | 2019-03 |
Util
(GET)
/api/totalslists current MN nodes IPs counts
(GET)
/history/:coin/:start-date/:end-datereturns archived .json objects in the given time range. e.g./history/xsn/2019-02-01/2019-02-10will return a list of 10 MN spread result objects.
XSN Governance
Available on: https://mn-spread.de/xsn/gov
(GET)
/api/xsn/governance/totalsreads local XSN wallet cli for total governance stats
(GET)
/api/xsn/governance/objectsreads local XSN wallet cli for proposal information
(GET)
/api/xsn/governance/object/:hashreads local XSN wallet cli for a specific object (:hash) parameter the object hash
XSN Merchants (TPoS)
Available on: https://mn-spread.de/xsn/merchants
(GET)
/api/xsn/merchants/listreads local XSN wallet cli for merchant contracts and calculates commission rate based on last rewards
External Tools
Translate IP to Geo Location / ISP info:
ipstack.com(https://ipstack.com/)
Using a free api key for the ipstack api is request limited by 10k requests/ month, I decided to record the results. If same
ip is requested again, it will replay the response it received before. So only new ip's will be requested.
Visualization Tools
free template provided by web-framework:
mdbootstrap(https://mdbootstrap.com)
map:
jVectorMap(http://jvectormap.com/)
Documentation
¶
There is no documentation for this package.
Source Files
Directories