Networks and manifest support
Atlas validates the manifest when you deploy. Graph CLI uploads the schema, ABIs and mappings first and the manifest last, so Atlas sees the network only after the upload. Check this page before deploying to avoid a wasted upload.
Networks
Use one of these names as network in every data source and template.
network | Chain | Chain ID | Notes |
|---|---|---|---|
mainnet | Ethereum | 1 | |
sepolia | Ethereum Sepolia | 11155111 | |
matic | Polygon PoS | 137 | Also accepted as polygon or matic-mainnet |
polygon-amoy | Polygon Amoy | 80002 | |
optimism | OP Mainnet | 10 | startBlock must be at least 105,235,064 (Bedrock) |
bsc | BNB Smart Chain | 56 | |
unichain-testnet | Unichain Sepolia | 1301 |
The names follow The Graph's networks registry. Aliases are recorded under the main name (for example, a polygon subgraph is listed as Polygon on matic), while your manifest, deployment ID and dataSource.network() keep the name you wrote. A subgraph indexes exactly one network.
Versions and data sources
| Item | Supported |
|---|---|
specVersion | up to 1.5.0 |
Mapping apiVersion | up to 0.0.10 |
Data source and template kind | ethereum (or the older ethereum/contract) |
| Event, block and call handlers | Yes. Call handlers need traces; Atlas warns when a manifest uses them. |
| Templates (dynamic data sources) | Yes |
| Grafting | No |
File data sources, ipfsOnEthereumContracts, Substreams | No |
History pruning
indexerHints.prune controls how many blocks of entity history Atlas keeps. Time-travel queries (block: { number: … }) work within that window.
indexerHints.prune | History kept |
|---|---|
A number up to 300000 | That many blocks |
auto | The minimum Graph Node allows (500 blocks) |
| Not set | The most recent 300,000 blocks |
never, or a number above 300,000 | Rejected at deploy |
Size limits
| Limit | Value |
|---|---|
| Data sources | 1 to 128 |
| Templates | up to 128 |
| Files referenced by one deployment | up to 256 |
| Manifest | 1 MiB |
| Any single file | 25 MiB |
| Whole deployment | 100 MiB |