#graph #subgraph #firehose #substreams #blockchain #helper #api-bindings

graph-networks-registry

The Graph Networks Registry types and helpers

2 releases

new 0.6.1 Nov 19, 2024
0.6.0 Nov 19, 2024

#134 in Magic Beans

Download history 98/week @ 2024-11-14

98 downloads per month

MIT license

20KB
290 lines

Networks Registry

Rust types and helpers for working with The Graph Networks Registry.

Usage

If you want to always get up-to-date registry, make sure to use the latest version of the crate.

Cargo.toml:

[dependencies]
graph-networks-registry = "0.6.1"

Reading from a local file

To read the registry from a local file

use graph_networks_registry::NetworksRegistry;
fn main() {
    // Parse registry from JSON file
    let registry = NetworksRegistry::from_file("TheGraphNetworksRegistry_v0_6_0.json")
        .expect("Failed to parse registry");

    if let Some(network) = registry.get_network_by_id("mainnet") {
        println!("Found mainnet: {:?}", network);
    }
}

Fetching the latest registry

To fetch the latest registry version from the official source

use graph_networks_registry::NetworksRegistry;

#[tokio::main]
async fn main() {
    let registry = NetworksRegistry::from_latest_version()
        .await
        .expect("Failed to fetch registry");
    println!("Loaded {} networks", registry.networks.len());
}

Features

  • fetch - Enables remote registry fetching functionality using reqwest (enabled by default)

If you don't need to fetch the registry from the network, you can turn off the fetch feature in your Cargo.toml:

[dependencies]
graph-networks-registry = { version = "0.6.0", default-features = false }

Dependencies

~0.7–13MB
~158K SLoC