Edits

website/pages/en/developing/developer-faqs.mdx

@@ -2,21 +2,21 @@
 title: Developer FAQs
 ---
 
-This page summarizes some of the common questions for developers building on The Graph.
+This page summarizes some of the most common questions for developers building on The Graph.
 
 ## Subgraph Related
 
 ### 1. What is a subgraph?
 
-A subgraph is a custom API built on blockchain data. Subgraphs are queried using the GraphQL query language and are deployed to a Graph Node using The Graph CLI. Once deployed and published to The Graph's decentralized network, Indexers process subgraphs and make them available for subgraph consumers to query them.
+A subgraph is a custom API built on blockchain data. Subgraphs are queried using the GraphQL query language and are deployed to a Graph Node using The Graph CLI. Once deployed and published to The Graph's decentralized network, Indexers process subgraphs and make them available for subgraph consumers to query.
 
 ### 2. What is the first step to create a subgraph?
 
 To successfully create a subgraph, you will need to install The Graph CLI. Review the [Quick Start](/quick-start/) to get started. For detailed information, see [Creating a Subgraph](/developing/creating-a-subgraph/).
 
 ### 3. Can I still create a subgraph if my smart contracts don't have events?
 
-It is highly recommended that you structure your smart contracts to have events associated with data you are interested in querying. Event handlers in the subgraph are triggered by contract events and are by far the fastest way to retrieve useful data.
+It is highly recommended that you structure your smart contracts to have events associated with data you are interested in querying. Event handlers in the subgraph are triggered by contract events and are the fastest way to retrieve useful data.
 
 If the contracts you work with do not contain events, your subgraph can use call and block handlers to trigger indexing. However, this is not recommended, as performance will be significantly slower.
 
@@ -28,35 +28,35 @@ No. Once a subgraph is created, the associated GitHub account cannot be changed.
 
 You can deploy a new version of your subgraph to Subgraph Studio using the CLI. This action maintains your subgraph private, but once you’re happy with it, you can publish to Graph Explorer. This will create a new version of your subgraph that Curators can start signaling on.
 
-### 6. When listening to multiple contracts, is it possible to select the contract order to listen to events?
+### 6. Is it possible to duplicate a subgraph to another account or endpoint without redeploying?
 
-Within a subgraph, the events are always processed in the order they appear in the blocks, regardless of whether that is across multiple contracts or not.
+You have to redeploy the subgraph, but if the subgraph ID (IPFS hash) doesn't change, it won't have to sync from the beginning.
 
 ### 7. How do I call a contract function or access a public state variable from my subgraph mappings?
 
 Take a look at `Access to smart contract` state inside the section [AssemblyScript API](/developing/graph-ts/api/#access-to-smart-contract-state).
 
-### 8. Can I import ethers.js or other JS libraries into my subgraph mappings?
+### 8. Can I import `ethers.js` or other JS libraries into my subgraph mappings?
 
 Not currently, as mappings are written in AssemblyScript.
 
 One possible alternative solution to this is to store raw data in entities and perform logic that requires JS libraries on the client.
 
-### 9. Is it possible to duplicate a subgraph to another account or endpoint without redeploying?
+### 9. When listening to multiple contracts, is it possible to select the contract order to listen to events?
 
-You have to redeploy the subgraph, but if the subgraph ID (IPFS hash) doesn't change, it won't have to sync from the beginning.
+Within a subgraph, the events are always processed in the order they appear in the blocks, regardless of whether that is across multiple contracts or not.
 
 ### 10. How are templates different from data sources?
 
-Templates allow you to create data sources on the quickly, while your subgraph is indexing. Your contract might spawn new contracts as people interact with it. Since you know the shape of those contracts (ABI, events, etc.) upfront, you can define how you want to index them in a template. When they are spawned, your subgraph will create a dynamic data source by supplying the contract address.
+Templates allow you to create data sources quickly, while your subgraph is indexing. Your contract might spawn new contracts as people interact with it. Since you know the shape of those contracts (ABI, events, etc.) upfront, you can define how you want to index them in a template. When they are spawned, your subgraph will create a dynamic data source by supplying the contract address.
 
 Check out the "Instantiating a data source template" section on: [Data Source Templates](/developing/creating-a-subgraph#data-source-templates).
 
-### 11. Is it possible to set up a subgraph using `graph init` from `graph-cli` with two contracts? Or should I manually add another datasource in `subgraph.yaml` after running `graph init`?
+### 11. Is it possible to set up a subgraph using `graph init` from `graph-cli` with two contracts? Or should I manually add another dataSource in `subgraph.yaml` after running `graph init`?
 
-Yes. On `graph init` command itself you can add multiple datasources by entering contracts one after the other.
+Yes. On `graph init` command itself you can add multiple dataSources by entering contracts one after the other.
 
-You can also use `graph add` command to add new datasource.
+You can also use `graph add` command to add a new dataSource.
 
 ### 12. In what order are the event, block, and call handlers triggered for a data source?
 
@@ -72,23 +72,23 @@ You can run the following command:
 docker pull graphprotocol/graph-node:latest
 ```
 
-> Note: docker / docker-compose will always use whatever graph-node version was pulled the first time you ran it, so it is important to do this to make sure you are up to date with the latest version of graph-node.
+> Note: docker / docker-compose will always use whatever graph-node version was pulled the first time you ran it, so make sure you're up to date with the latest version of graph-node.
 
 ### 14. What is the recommended way to build "autogenerated" ids for an entity when handling events?
 
 If only one entity is created during the event and if there's nothing better available, then the transaction hash + log index would be unique. You can obfuscate these by converting that to Bytes and then piping it through `crypto.keccak256` but this won't make it more unique.
 
 ### 15. Can I delete my subgraph?
 
-It is not possible to delete subgraphs once they are created. However, you can [transfer and deprecate your subgraph](/managing/transfer-and-deprecate-a-subgraph/)
+It is not possible to delete subgraphs once they are created. However, you can [transfer and deprecate your subgraph](/managing/transfer-and-deprecate-a-subgraph/).
 
 ## Network Related
 
 ### 16. What networks are supported by The Graph?
 
 You can find the list of the supported networks [here](/developing/supported-networks).
 
-### 17. Is it possible to differentiate between networks (mainnet, Sepolia, local) from within event handlers?
+### 17. Is it possible to differentiate between networks (mainnet, Sepolia, local) within event handlers?
 
 Yes. You can do this by importing `graph-ts` as per the example below:
 
@@ -107,11 +107,11 @@ Yes. Sepolia supports block handlers, call handlers and event handlers. It shoul
 
 ### 19. Is it possible to specify what block to start indexing on?
 
-Yes. `dataSources.source.startBlock` in the `subgraph.yaml` file specifies the number of the block that the data source starts indexing from. In most cases, we suggest using the block in which the contract was created: [Start blocks](/developing/creating-a-subgraph#start-blocks)
+Yes. `dataSources.source.startBlock` in the `subgraph.yaml` file specifies the number of the block that the dataSource starts indexing from. In most cases, we suggest using the block where the contract was created: [Start blocks](/developing/creating-a-subgraph#start-blocks)
 
-### 20. Are there some tips to increase the performance of indexing? My subgraph is taking a very long time to sync
+### 20. What are some tips to increase the performance of indexing? My subgraph is taking a very long time to sync
 
-Yes, you should take a look at the optional start block feature to start indexing from the block that the contract was deployed: [Start blocks](/developing/creating-a-subgraph#start-blocks)
+Yes, you should take a look at the optional start block feature to start indexing from the block where the contract was deployed: [Start blocks](/developing/creating-a-subgraph#start-blocks)
 
 ### 21. Is there a way to query the subgraph directly to determine the latest block number it has indexed?
 
@@ -133,11 +133,11 @@ someCollection(first: 1000, skip: <number>) { ... }
 
 Currently, the recommended approach for a dapp is to add the key to the frontend and expose it to end users. That said, you can limit that key to a hostname, like _yourdapp.io_ and subgraph. The gateway is currently being run by Edge & Node. Part of the responsibility of a gateway is to monitor for abusive behavior and block traffic from malicious clients.
 
-Miscellaneous
+## Miscellaneous
 
-### 24. Is this possible to use Apollo Federation on top of graph-node?
+### 24. Is it possible to use Apollo Federation on top of graph-node?
 
-Federation is not supported yet, although we do want to support it in the future. At the moment, something you can do is use schema stitching, either on the client or via a proxy service.
+Federation is not supported yet. At the moment, you can use schema stitching, either on the client or via a proxy service.
 
 ### 25. I want to contribute or add a GitHub issue. Where can I find the open source repositories?