{"id":23519671,"url":"https://github.com/graphprotocol/networks-registry","last_synced_at":"2026-02-12T20:05:18.358Z","repository":{"id":258397064,"uuid":"870717235","full_name":"graphprotocol/networks-registry","owner":"graphprotocol","description":null,"archived":false,"fork":false,"pushed_at":"2026-01-16T19:34:56.000Z","size":1156,"stargazers_count":12,"open_issues_count":2,"forks_count":20,"subscribers_count":18,"default_branch":"main","last_synced_at":"2026-01-17T01:56:52.177Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/graphprotocol.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-10-10T14:39:26.000Z","updated_at":"2026-01-14T21:44:35.000Z","dependencies_parsed_at":"2024-10-18T20:14:22.970Z","dependency_job_id":"40b33a83-1fe1-4e46-90aa-19b7317e5c87","html_url":"https://github.com/graphprotocol/networks-registry","commit_stats":null,"previous_names":["graphprotocol/supported-networks","graphprotocol/networks-registry"],"tags_count":141,"template":false,"template_full_name":null,"purl":"pkg:github/graphprotocol/networks-registry","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/graphprotocol%2Fnetworks-registry","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/graphprotocol%2Fnetworks-registry/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/graphprotocol%2Fnetworks-registry/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/graphprotocol%2Fnetworks-registry/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/graphprotocol","download_url":"https://codeload.github.com/graphprotocol/networks-registry/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/graphprotocol%2Fnetworks-registry/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29313096,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-10T17:48:59.043Z","status":"ssl_error","status_checked_at":"2026-02-10T17:45:37.240Z","response_time":65,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-25T16:09:38.146Z","updated_at":"2026-02-10T19:10:22.055Z","avatar_url":"https://github.com/graphprotocol.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# The Graph networks registry\n\n[![GitHub Release](https://img.shields.io/github/v/release/graphprotocol/networks-registry)](https://github.com/graphprotocol/networks-registry/releases/latest)\n\nThis repository manages a registry of networks in The Graph ecosystem.\n\nSee [Releases](https://github.com/graphprotocol/networks-registry/releases) page for the latest version of the registry.\nSee [Networks Table](./docs/networks-table.md) for an up-to-date auto-generated networks list.\nSee [Subgraphs Arbitration Policy](./docs/subgraphs-arbitration-policy.md) for information about network arbitration support.\n\n[Libraries](https://github.com/pinax-network/graph-networks-libs) for Typescript, Go and Rust.\n\n[Demo app](https://graph-networks-app.vercel.app/) for the registry.\n\n## Adding/updating a chain\n\n- add/update a network JSON in the `registry` directory. See [Adding a Chain](./docs/adding-a-chain.md) for details\n- validate with `bun validate` (see below for local setup steps)\n- [optional] format with `bun format`\n- open a PR. This will bump the version, trigger validation checks and will signal if there are any issues with your definition\n\n## Structure of the repository\n\n- `schemas/`: Contains the schema for the registry\n- `registry/`: Contains the networks JSONs (edit these)\n- `docs/`: Contains docs and auto-generated networks table\n- `public`: Contains all generated registry versions (don't edit those)\n- `src/`: Contains scripts to validate networks JSONs and generate the resulting registry JSON\n\n## Setup\n\n- install `bun`: https://bun.sh/\n- `git clone` the repository\n- install dependencies `bun install --no-save`\n- rename `.env.example` to `.env`\n- [optional] get your free [Studio API key](https://thegraph.com/studio/apikeys/) and set it in the `.env` file - we will need it to run a few queries to do some network validation\n\n## Scripts usage\n\n- `bun generate:types` - generate types from schema if schema has changed to use for validation\n- `bun validate:schema` - validate networks JSONs against the schema\n- `bun validate:networks` - additional semantic validation of networks JSONs, i.e. uniqueness, relations, urls, ethereum chain list, graph network, icons, etc\n- `bun generate:registry` - generate resulting registry JSON in `./dist`\n- `bun validate:registry` - validate generated registry in `./dist` against the schema\n- `bun format` - format JSON and TS files with prettier\n- `bun format:check` - check JSON and TS formatting with prettier\n- `bun all` - do all of the above\n\n## Versioning\n\n### Schema Version\n\nRegistry schema has a MAJOR.MINOR semantic version, i.e. `v1.2`\n\nWhen version needs to be incremented:\n\n- MAJOR version: breaking schema change, i.e. field type change, new mandatory field, field removal\n- MINOR version: backward compatible schema change, i.e. new optional field, new enum variant\n\n### Registry version\n\nPublished registry has a MAJOR.MINOR.PATCH semantic version, i.e. `v1.2.3` where MAJOR.MINOR corresponds to the schema version\n\nWhen version needs to be incremented:\n\n- MAJOR/MINOR version: when schema is updated change MAJOR and MINOR versions to reflect the schema\n- PATCH version: new network added, existing network entry updated\n\n## Releases\n\nEvery PR merge triggers a GitHub action that generates new registry version, formats it, commits, publishes a release and deploys\n4 registry JSON files with the identical contents are deployed in addition to existing ones.\nAssuming current version is v1.2.3, the following files with identical content are published:\n\n- TheGraphNetworksRegistry.json\n- TheGraphNetworksRegistry_v1_2_3.json\n- TheGraphNetworksRegistry_v1_2_x.json\n- TheGraphNetworksRegistry_v1_x_x.json\n\nIn addition to the above, the JSON Schema is available at TheGraphNetworksRegistrySchema_v1_2.json\n\n## Registry Usage\n\nIn your application you can use one of the generated registry JSONs above depending on your use case.\n\nLibraries for Typescript, Go and Rust [exist](https://github.com/pinax-network/graph-networks-libs) to make it easier to work with the registry.\n\nTypical use cases:\n\n- Codegens and other tools for The Graph ecosystem\n- Indexer infrastructure setup/validation\n- Marketing and website\n- Docs\n\n## References\n\n- [The Graph Networks Registry libraries](https://github.com/pinax-network/graph-networks-libs)\n- [Ethereum chains list](https://github.com/ethereum-lists/chains)\n- [CAIP-2 chain ids](https://chainagnostic.org/CAIPs/caip-2)\n- [Web3Icons](https://github.com/0xa3k5/web3icons/tree/main/raw-svgs/networks/branded)\n- [EBO subgraph](https://thegraph.com/explorer/subgraphs/4KFYqUWRTZQ9gn7GPHC6YQ2q15chJfVrX43ezYcwkgxB)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgraphprotocol%2Fnetworks-registry","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgraphprotocol%2Fnetworks-registry","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgraphprotocol%2Fnetworks-registry/lists"}