diff --git a/pages/building-with-pgn.mdx b/pages/building-with-pgn.mdx index bfe4656..aa2115f 100644 --- a/pages/building-with-pgn.mdx +++ b/pages/building-with-pgn.mdx @@ -5,6 +5,7 @@ * [Network and Contract details](/network-and-contract-details) * [Deploying on PGN](/building-with-pgn/deploying-on-pgn) * [Ethereum vs PGN](/building-with-pgn/fees) +* [Subgraphs](/building-with-pgn/subgraphs) * [Fees](/building-with-pgn/ethereum-vs-pgn) diff --git a/pages/building-with-pgn/_meta.json b/pages/building-with-pgn/_meta.json index 2975c1d..e05649c 100644 --- a/pages/building-with-pgn/_meta.json +++ b/pages/building-with-pgn/_meta.json @@ -1,5 +1,6 @@ { "deploying-to-pgn": "Deploying to PGN", "ethereum-vs-pgn": "Ethereum vs PGN", + "subgraphs": "Subgraphs", "fees": "Fees" } diff --git a/pages/building-with-pgn/subgraphs.mdx b/pages/building-with-pgn/subgraphs.mdx new file mode 100644 index 0000000..a2a395c --- /dev/null +++ b/pages/building-with-pgn/subgraphs.mdx @@ -0,0 +1,15 @@ +# Subgraphs + +## Overview + +Subgraphs are custom APIs built on top of blockchain data that can be queried using GraphQL. Developers can build and deploy subgraphs to transform raw blockchain data into more useful formats to power their applications. + +PGN subgraphs can be deployed on Goldsky; for more information on getting started, visit [Goldsky's documentation](https://docs.goldsky.com/). + +## How to deploy subgraphs + +PGN subgraphs on Goldsky can be deployed in 2 ways: +* Via CLI from a local subgraph configuration file. If you are familiar with developing subgraphs already, you'll be familiar with this approach; after defining a subgraph lcoally (with a subgraph.yaml file, a schema.graphql file, and the necessary mappings to translate raw event data into the entities defined in the schema), you can deploy subgraphs to Goldsky (once the Goldsky CLI is installed) using `goldsky subgraph deploy / --path`. +* Via [instant subgraphs](https://docs.goldsky.com/indexing/instant-subgraphs), where you can pass through a contract address and the ABI for that contract. This is a quick-start option that automatically generates the underlying subgraph configuration files on your behalf, making it easy to extract blockchain event data and serve it as an API endpoint without complex setup. Use the `--from-ipfs-hash` flag in the command above instead of `--path`. + +Both PGN mainnet and testnet are available at the chain slugs `publicgoods` and `publigoods-testnet` respectively. diff --git a/pages/faq.mdx b/pages/faq.mdx index 7c28aed..d724f32 100644 --- a/pages/faq.mdx +++ b/pages/faq.mdx @@ -175,6 +175,7 @@ As of July 25th, 2023, we have had several partners either fully deploy or deplo * [Beamer](https://app.beamerbridge.com/#/) * [Safe](https://safe.global/) * [The Graph](https://thegraph.com/) +* [Goldsky](https://goldsky.com/) ## Deploying contracts @@ -216,7 +217,7 @@ Graph nodes: * Mainnet: [graph-gitcoin-mainnet.hirenodes.io](https://graph-gitcoin-mainnet.hirenodes.io) * Testnet: [graph-gitcoin-testnet.hirenodes.io](https://graph-gitcoin-testnet.hirenodes.io) - +Subgraphs can also be deployed on [Goldsky](https://goldsky.com/), a high-performance hosted subgraph service. ## Blockscout