Transforms Ethereum block's metadata

to a humanized view.

Transaction Types

• erc20, nft, transfer, unrecognized

Transaction Value, Gas

• average, minimum, maximum, median, summ value/gas in transactions array

Block Season

• winter, sprint, summer, autumn

Daytime

• night, morning, day, afterday, evening in UTC

This package uses block data structure via EthBlock.Art.

If you want to use this package outside of EthBlock.Art development boilerplate, you need to be sure if the block data structure from your API are prepared to this package structure based on useDApp's (and EthBlock.Art) block metadata response.

Different APIs are gives different 'block metadata'.

For example, web3 node module has input instead of data property in transactions array item.

Install & Use

npm i ethblockart-humanizer

import { getBlockHumanized } from 'ethblockart-humanizer';

// ...
const humanizedBlock = getBlockHumanized(block);
// ...

Result:

{
    "number": 13596479,
    "season": "autumn",
    "daytime": "evening",
    "time": "2021-11-11T18:20:00.000Z",
    "transactions": {
        "total": 294,
        "types": {
            "erc20": 93,
            "nft": 0,
            "transfer": 144,
            "unrecognized": 57
        },
        "values": {
            "value": {
                "avgValue": 0.3343366122304634,
                "minValue": 0,
                "medianValue": 0,
                "maxValue": 21.995,
                "sumValue": 98.29496399575623
            },
            "gas": {
                "avgGas": 0.035442864392160454,
                "medianGas": 0.017042417914345,
                "minGas": 0.0031647,
                "maxGas": 1.2892222294735,
                "sumGas": 10.420202131295174
            },
            "data": [
                {
                    "hash": "0xb41984c70cd05687fbc5d721c6bb2c02ee8158201c1749f8bb9645ea5899d7d7",
                    "type": "unrecognized",
                    "value": 0,
                    "gas": 0.07462853334800001
                },
                // ...
            ]
        }
    }
}

Created for EthBlockArt Humanizer

https://zashi.art/ebah

EthBlockArt is about facing a mirror towards the chain we use and data we create.

EthBlockArt Humanizer extends that, surfacing the connection between data and visual.

Functions

• getBlockHumanized(block), — get humanized metadata. block is Ethereum block metadata object. You can use only this function.

• getTransactionsHumanized(transaction), — get only { values, types } result. transaction is Ethereum block transaction object.

• getTransactionHumanizedTypeName(transaction) — get only calculated transaction's type.

• getBlockHumanizedSeason(block) — get calculated season name.

• getBlockHumanizedDaytime(block) — just get timestamp property in UTC format.

2021, MIT License, Zashi Frovano