This is small http web-service that allows get total information on particular block on Ethereum blockchain network. Internally for getting information used Etherescan API.
All actual external libraries used in application you can find in go.mod file. There are next:
- chi is used as router. It is a lightweight, idiomatic and composable router for building Go HTTP services.
- ttlcache library is used as in-memory cache.
One api endpoint is realized it's /api/block/{blockNumber}/total, where {blockNumber} is parameter and pointing to Ethereum network block you want getting information. Exploring blocks you are able on etherscan.
Http api response is in json format and has the next structure {"transactions":NumberOfTransactionsInBlock,"amount":TotalAmountOfAllTransactions}. For example for block 14797288 you get the next response {"transactions":160,"amount":10.49336032072198}.
Clone the repository locally https://github.com/vladmarchuk90/eth-block-api.git after that you can run service by command go run cmd/web/*.go or previously build it by command go build cmd/web/*.go and after run ./main (if you built with default name). As well, you can build and run docker image by command docker-compose up -d (be sure you are in the project folder before running this comand).
You can provide some settings (see config.json). File config json should be in project root folder if you use run command or together in one folder with executable if you previously built it. Default settings:
- "use_cache": true - turning on/off caching using, it's recommend to use cache.
- "api_key": "YourApiKeyToken" - you can get your personal api key at [https://etherscan.io/apis].
- "server_port": "80" - server port your service is running on.
- "api_template_url": "https://api.etherscan.io/api?module=proxy&action=eth_getBlockByNumber&tag=0xafa01b&boolean=true&apikey=YourApiKeyToken" - ethereum api template which used as template to compose block info request: tag is blockNumber in hex format and apikey is your personal api key.