Add Subgraph Composition examples (#1977)

* Adding Subgraph Composition Repos

* change links to repos, fix some typos

* changeset

---------

Co-authored-by: YaroShkvorets <shkvorets@gmail.com>

Author: idalithb

.changeset/plenty-dancers-trade.md

@@ -0,0 +1,5 @@
+---
+'@graphprotocol/graph-cli': patch
+---
+
+Added subgraph composition examples

.gitmodules

@@ -0,0 +1,6 @@
+[submodule "examples/subgraph-composition-example"]
+	path = examples/subgraph-composition-example
+	url = https://github.com/isum/subgraph-composition-example.git
+[submodule "examples/subgraph-composition-sample-subgraph"]
+	path = examples/subgraph-composition-sample-subgraph
+	url = https://github.com/incrypto32/subgraph-composition-sample-subgraph.git

examples/README.md

@@ -4,43 +4,49 @@ This section contains several subgraph examples to help you get started with [Th
 
 ## Table of Contents
 
-1. **[Aggregations](/examples/aggregations)**  
+1. **[Aggregations](/examples/aggregations)**
    This example demonstrates how to aggregate data using block numbers as predictable values. The comments in the schema, subgraph manifest, and mappings provide guidance for implementing custom aggregations.
 
-2. **[Arweave Blocks and Transactions](/examples/arweave-blocks-transactions)**  
+2. **[Arweave Blocks and Transactions](/examples/arweave-blocks-transactions)**
    This example indexes blocks, transactions, tags, and POAs on the Arweave blockchain. Please note that it requires `graph-cli` version 0.30.2 or above to build.
 
-3. **[Cosmos Block Filtering](/examples/cosmos-block-filtering)**  
+3. **[Cosmos Block Filtering](/examples/cosmos-block-filtering)**
    This example stores `Block` objects that represent blocks appended to a Cosmos chain, saving only the block number and timestamp to the store.
 
-4. **[Cosmos Osmosis Token Swaps](/examples/cosmos-osmosis-token-swaps)**  
+4. **[Cosmos Osmosis Token Swaps](/examples/cosmos-osmosis-token-swaps)**
    This example stores `TokenSwap` objects that represent token swaps made using the Generalized Automated Market Maker (GAMM) in the Osmosis chain.
 
-5. **[Cosmos Validator Delegations](/examples/cosmos-validator-delegations)**  
+5. **[Cosmos Validator Delegations](/examples/cosmos-validator-delegations)**
    This example stores `Delegation` objects representing validator delegations on a Cosmos chain.
 
-6. **[Cosmos Validator Rewards](/examples/cosmos-validator-rewards)**  
+6. **[Cosmos Validator Rewards](/examples/cosmos-validator-rewards)**
    This example stores `Reward` objects representing rewards received by validators on a Cosmos chain.
 
-7. **[Ethereum Basic Event Handlers](/examples/ethereum-basic-event-handlers)**  
+7. **[Ethereum Basic Event Handlers](/examples/ethereum-basic-event-handlers)**
    This example shows how to handle basic events on the Ethereum blockchain using The Graph. It provides a practical implementation of event handlers, showcasing how to index and query blockchain data.
 
-8. **[Ethereum Gravatar](/examples/ethereum-gravatar)**  
+8. **[Ethereum Gravatar](/examples/ethereum-gravatar)**
    This example indexes data from the Ethereum Gravatar smart contract. Gravatar is a service where users can create and manage globally unique avatars.
 
-9. **[Example Subgraph](/examples/example-subgraph)**  
-   This example shows the structure of a minimal,basic subgraph. It provides a generic setup with a simple contract and schema designed to teach the fundamentals of defining, mapping, and querying subgraph data.
+9. **[Example Subgraph](/examples/example-subgraph)**
+   This example shows the structure of a minimal, basic subgraph. It provides a generic setup with a simple contract and schema designed to teach the fundamentals of defining, mapping, and querying subgraph data.
 
-10. **[Matic Lens Protocol Posts Subgraph](/examples/matic-lens-protocol-posts-subgraph)**  
+10. **[Matic Lens Protocol Posts Subgraph](/examples/matic-lens-protocol-posts-subgraph)**
     This example demonstrates how to index data from the Lens Protocol deployed on the Polygon (Matic) network.
 
-11. **[NEAR Blocks](/examples/near-blocks)**  
+11. **[NEAR Blocks](/examples/near-blocks)**
     This example indexes blockchain data from the NEAR Protocol. It listens to block-related events and stores key data such as block number, timestamp, and hash in a queryable format.
 
-12. **[NEAR Receipts](/examples/near-receipts)**  
+12. **[NEAR Receipts](/examples/near-receipts)**
     This example indexes transaction receipts from the NEAR Protocol. It tracks and stores receipt data such as transaction hash, status, and execution details.
 
-13. **[Substreams Powered Subgraph](/examples/substreams-powered-subgraph)**  
+13. **[Substreams Powered Subgraph](/examples/substreams-powered-subgraph)**
     This example is a basic Substreams-powered subgraph, which includes the Substreams definition. It tracks new contract deployments on Ethereum and demonstrates integration with Graph Node using `substreams_entity_change` types and helpers.
 
+14. **[Subgraph Composition Using Sushiswap v3 Subgraph on Base](https://github.com/incrypto32/subgraph-composition-sample-subgraph)**
+    This example illustrates how to optimize a Subgraph using Subgraph Composition. It uses a source Subgraph and a dependent Subgraph, where the source Subgraph tracks events from Sushiswap v3 subgraph on Base.
+
+15. **[Subgraph Composition Using Three Source Subgraph](https://github.com/isum/subgraph-composition-example)**
+    This example shows how to combine three source Subgraphs into one composable Subgraph to efficiently aggregate data.
+
 To learn more about subgraphs, review [subgraphs](https://thegraph.com/docs/en/subgraphs/developing/subgraphs/) on [The Graph docs](https://thegraph.com/docs/en/).