Skip to content

syscoin/syscoin-info-api

Folders and files

NameName
Last commit message
Last commit date
Dec 9, 2022
Mar 2, 2024
Apr 25, 2025
Dec 2, 2022
Apr 25, 2025
Apr 25, 2025
Apr 25, 2025
Apr 25, 2025
Apr 24, 2025
Apr 24, 2025
Feb 3, 2025

Repository files navigation

Syscoin Info API

Description

This is a simple NodsJS Express server to fetch information on Syscoin.

Endpoints

Host: https://info.syscoin.org/

GET /totalsupply

  • This returns total supply calculated on both UTXO and NEVM blockchain in plaintext.

GET /triggerRecordSupply

  • Normally total supply is calculated and recorded when new block hash is detected.
  • This endpoints acts as manual trigger in calculation.

GET /health

  • This is a health check endpoint. Useful for monitoring if API is running.

Syscoin Core (/syscoin-core)

  • Dockerized version of the Syscoin Daemon
  • JSON RPC is used by the API in retrieving UTXO supply

API Environment Variables (Required*)

  • SYSCOIN_CORE_RPC_HOST ex. localhost
  • SYSCOIN_CORE_RPC_PORT ex. 8370
  • SYSCOIN_CORE_RPC_PASSWORD - password for auth to RPC
  • SYSCOIN_CORE_RPC_USERNAME - username for auth to RPC

An .env.example is provided for convenience.

You can generate password and username:

curl -sSL https://raw.githubusercontent.com/syscoin/syscoin/master/share/rpcauth/rpcauth.py | python - <username>

For more information you can check it here: https://github.com/syscoin/docker-syscoin-core#usage

Syscoin Vault Manager

Please refer to config.js for the current official address of SyscoinVaultManager contract.