The Graph Subgraph Deployer

WHAT IT DOES

The Graph Subgraph Deployer helps you prepare and deploy subgraphs to The Graph's hosted service or decentralized network. You provide your subgraph configuration files (subgraph.yaml, schema.graphql, mapping.ts), your subgraph name, version label, and Graph Studio API key, and the tool generates the exact Graph CLI commands needed for deployment. It parses your subgraph files to extract the schema, manifest, and mapping content, then constructs the authentication and deployment commands. This saves time and reduces errors when deploying subgraphs, especially for developers who are new to The Graph ecosystem. It reads the current network chain ID from your wallet provider to ensure the network is set correctly in the manifest.

HOW TO USE

Connect your wallet using the "Connect" button (required for network detection). Select the target network (Ethereum Mainnet, Sepolia, Polygon, BSC, Arbitrum, Optimism, and testnets are supported). Enter your subgraph name (e.g., username/subgraph-name), version label (e.g., v0.0.1), and your Graph Studio API key. Paste your subgraph files (subgraph.yaml, schema.graphql, and mapping.ts) into the text area — you can use the Subgraph Builder tool to generate these files. Click "Generate deploy commands" — the tool parses your files and displays the deploy commands with your API key and subgraph name. Click the deploy button to copy the full command to your clipboard. The entire operation is read-only — no transactions are signed or sent.

TECHNICAL MECHANISM

The tool parses the provided text input to identify the subgraph.yaml, schema.graphql, and mapping.ts sections. It uses simple heuristics to detect each section: presence of "specVersion:" for YAML, "type" and "@entity" for schema, and "export" or "import" for mapping files. It then constructs the Graph CLI commands: `graph auth --product hosted-service "${API_KEY}"` and `graph deploy ${SUBGRAPH_NAME} --version-label ${VERSION_LABEL}`. The tool does not actually deploy the subgraph — it generates the commands that you run in your terminal. The API key is never sent to any server; it is only used to build the command string locally. The tool uses ethers.js v5.7.2 and the wallet's provider for network detection, but does not make any on-chain calls.

WHAT IT CANNOT SEE

The tool cannot validate the correctness of the subgraph files or ensure they will compile — you must test your subgraph locally before deploying. It cannot handle complex nested types or dynamic arrays reliably without full ABI parsing. It cannot deploy to The Graph's decentralized network without a valid API key and permissions. It is limited by RPC provider availability for network detection. It cannot deploy subgraphs for non-EVM chains. It cannot automatically resolve import paths or dependencies in your mapping files. It does not run the Graph CLI — it only generates the commands for you to run.

PLEASE NOTE

This tool is for scaffolding and educational purposes. Always test your subgraph locally using `graph codegen` and `graph build` before deploying. Ensure your Graph Studio API key is kept secure and never shared. The tool does not persist any data; all state is lost on page reload. EVM chains only.