engram-network / address-watcher

🦄 Engram Address Metrics Exporter 🦄

A Prometheus metrics exporter for Ethereum externally owned account and contract addresses including;

• Externally owned account and contract addresses
• ERC20 contracts
• ERC721 contracts
• ERC1155 contracts
• Uniswap pair contracts
• Chainlink data feed contracts

Usage

Engram Address Metrics Exporter requires a config file. An example file can be found here.

A tool to export the ethereum address state

Usage:
  ethereum-address-metrics-exporter [flags]

Flags:
      --config string   config file (default is config.yaml) (default "config.yaml")
  -h, --help            help for ethereum-address-metrics-exporter

Configuration

Engram Address Metrics Exporter relies entirely on a single yaml config file.

Name	Default	Description
global.logging	warn	Log level (panic, fatal, warn, info, debug, trace)
global.metricsAddr	:9090	The address the metrics server will listen on
global.namespace	eth_address	The prefix added to every metric
global.checkInterval	15s	How often the service should check the addresses for balance
global.labels[]		Key value pair of labels to add to every metric (optional)
execution.url	http://localhost:8545	URL to the execution node
execution.timeout	10s	Timeout for requests to the execution node
execution.headers[]		Key value pair of headers to add on every request
addresses.account		List of ethereum externally owned account or contract addresses
addresses.account[].name		Name of the address, will be a label on the metric
addresses.account[].address		Account address
addresses.account[].labels[]		Key value pair of labels to add to this address only (optional)
addresses.erc20		List of ethereum ERC20 addresses
addresses.erc20[].name		Name of the address, will be a label on the metric
addresses.erc20[].address		Ethereum address
addresses.erc20[].contract		Ethereum contract address
addresses.erc20[].labels[]		Key value pair of labels to add to this address only (optional)
addresses.erc721		List of ethereum ERC721 addresses
addresses.erc721[].name		Name of the address, will be a label on the metric
addresses.erc721[].address		Ethereum address
addresses.erc721[].contract		Ethereum contract address
addresses.erc721[].labels[]		Key value pair of labels to add to this address only (optional)
addresses.erc1155		List of ethereum ERC1155 addresses
addresses.erc1155[].name		Name of the address, will be a label on the metric
addresses.erc1155[].address		Ethereum address
addresses.erc1155[].contract		Ethereum contract address
addresses.erc1155[].tokenID		NFT Token Identifier
addresses.erc1155[].labels[]		Key value pair of labels to add to this address only (optional)
addresses.uniswapPair		List of uniswap pair addresses
addresses.uniswapPair[].name		Name of the address, will be a label on the metric
addresses.uniswapPair[].from		First symbol name, will be a label on the metric
addresses.uniswapPair[].to		Second symbol name, will be a label on the metric
addresses.uniswapPair[].contract		Ethereum contract address of the uniswap pair
addresses.uniswapPair[].labels[]		Key value pair of labels to add to this address only (optional)
addresses.chainlinkDataFeed		List of chainlink data feed addresses
addresses.chainlinkDataFeed[].name		Name of the address, will be a label on the metric
addresses.chainlinkDataFeed[].from		First symbol name, will be a label on the metric
addresses.chainlinkDataFeed[].to		Second symbol name, will be a label on the metric
addresses.chainlinkDataFeed[].contract		Ethereum contract address of the chainlink data feed
addresses.chainlinkDataFeed[].labels[]		Key value pair of labels to add to this address only (optional)

Example

global:
  logging: "debug" # panic,fatal,warm,info,debug,trace
  metricsAddr: ":9090"
  namespace: eth_address
  labels:
    extra: label

execution:
  url: "http://localhost:8545"
  timeout: 10s
  headers:
    authorization: "Basic abc123"

addresses:
  account:
    - name: John smith
      address: 0x4B1D3c9BEf9D097F564DcD6cdF4558CB389bE3d5
      labels:
        type: friend
    - name: Jane Doe
      address: 0x4B1Df3549940C56d962F248f211788D66B4aAF39
      labels:
        type: acquaintance
        company: NSA
  erc20:
    - name: Some ERC20 Contract
      contract: 0x4B1DB272F63E03Dd37ea45330266AC9328A66DB6
      address: 0x4B1D1465b14cA06e72b942F361Fd3352Aa9c5368
  erc721:
    - name: Some ERC721 Contract
      contract: 0x4B1D23bf5018189fDad68a0E607b6005ccF7E593
      address: 0x4B1DB5c493955C8eF6D2a30CFf47495023b85C8d
  erc1155:
    - name: Some ERC1155 Contract
      contract: 0x4B1D8DC12da8f658FA8BF0cdB18BB7D4dABB2DB3
      tokenID: 100
      address: 0x4B1D6D35f293AB699Bfc6DE141E031F3E3997BBe
  # https://v2.info.uniswap.org/pairs
  uniswapPair:
    - name: eth->usdt
      from: eth
      to: usdt
      contract: 0x0d4a11d5eeaac28ec3f61d100daf4d40471f1852
  # https://docs.chain.link/docs/ethereum-addresses/
  chainlinkDataFeed:
    - name: eth->usd
      from: eth
      to: usd
      contract: 0x5f4eC3Df9cbd43714FE2740f5E3616155c5b8419

Getting Started

Download a release

Download the latest release from the Releases page. Extract and run with:

./engram-address-metrics-exporter --config your-config.yaml