Ethereum Data Access Utility

This utility offers crucial methods to query and retrieve foundational data directly from various blockchain infrastructures, focusing on supply metrics, chain identification, and connection point discovery.

Operational Capabilities

The component exposes three primary functions:

• Fetch Total Asset Volume: Queries the aggregate circulating quantity of a specified cryptographic asset on a designated ledger.
• Resolve Network Identifier: Determines the numerical chain ID corresponding to a supplied ledger moniker.
• Acquire Curated Node List: Obtains a filtered set of remote procedure call (RPC) endpoints tailored for a specific chain identifier.

Fetch Total Asset Volume

To determine the complete issuance of an asset, you must supply both the ledger network identifier and the asset's contract address.

Required Inputs:

• chain_id: The unique numerical designation for the distributed ledger.
• token_address: The unique contract identifier for the asset.

Illustrative Invocation:

To ascertain the total supply for the asset located at 0x6B2a01A5f79dEb4c2f3c0eDa7b01DF456FbD726a on network 56, execute with:

{ "chain_id": 56, "token_address": "0x6B2a01A5f79dEb4c2f3c0eDa7b01DF456FbD726a" }

The expected output will be the total quantity, for example:

46141292590

Resolve Network Identifier

This function requires only the descriptive designation of the blockchain network to return its numerical ID.

Required Input:

• chain_name: The human-readable name of the blockchain environment.

Illustrative Invocation:

For the network designated as BNB Smart Chain Mainnet, the call structure is:

{ "chain_name": "BNB Smart Chain Mainnet" }

The utility will subsequently yield the associated network identifier, such as:

56

Acquire Curated Node List

This method retrieves RPC connection points for a specified ledger ID. Filtering based on source availability (isOpenSource) and operational status (tracking) is optional.

Inputs:

• chain_id: The required numerical identifier of the ledger.
• isOpenSource (Optional): A boolean or criterion to restrict results to open-source node providers.
• tracking (Optional): A filter specifying the monitoring status (e.g., 'active', 'dormant', 'verified').

Illustrative Invocation:

To obtain the accessible node infrastructure list for network identifier 1:

{ "chain_id": "1" }

The outcome will be an array containing the relevant RPC connections applicable to network ID 1.