.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,43 @@ 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.
 
 To learn more about subgraphs, review [subgraphs](https://thegraph.com/docs/en/subgraphs/developing/subgraphs/) on [The Graph docs](https://thegraph.com/docs/en/).

examples/arweave-blocks-transactions/schema.graphql

@@ -1,4 +1,4 @@
-type Block @entity {
+type Block @entity(immutable: true) {
   id: ID!
 
   timestamp: BigInt!
@@ -22,7 +22,7 @@ type Block @entity {
   poa: Poa
 }
 
-type Transaction @entity {
+type Transaction @entity(immutable: true) {
   id: ID!
 
   block: Block!
@@ -39,7 +39,7 @@ type Transaction @entity {
   reward: Bytes!
 }
 
-type Poa @entity {
+type Poa @entity(immutable: true) {
   id: ID!
 
   option: String!
@@ -48,7 +48,7 @@ type Poa @entity {
   chunk: Bytes!
 }
 
-type Tag @entity {
+type Tag @entity(immutable: true) {
   id: ID!
 
   name: Bytes!

examples/cosmos-block-filtering/schema.graphql

@@ -1,4 +1,4 @@
-type Block @entity {
+type Block @entity(immutable: true) {
   id: ID!
   number: BigInt
   timestamp: BigInt

examples/cosmos-osmosis-token-swaps/schema.graphql

@@ -1,10 +1,10 @@
-type Token @entity {
+type Token @entity(immutable: true) {
   id: ID!
   amount: String
   denom: String
 }
 
-type TokenSwap @entity {
+type TokenSwap @entity(immutable: true) {
   id: ID!
   sender: String
   poolId: String

examples/cosmos-validator-delegations/schema.graphql

@@ -1,11 +1,11 @@
-type Delegation @entity {
+type Delegation @entity(immutable: true) {
   id: ID!
   delegatorAddress: String
   validatorAddress: String
   amount: Coin
 }
 
-type Coin @entity {
+type Coin @entity(immutable: true) {
   id: ID!
   denom: String
   amount: String

examples/cosmos-validator-rewards/schema.graphql

@@ -1,4 +1,4 @@
-type Reward @entity {
+type Reward @entity(immutable: true) {
   id: ID!
   amount: String
   validator: String

examples/ethereum-basic-event-handlers/schema.graphql

@@ -1,11 +1,11 @@
-type NewGravatar @entity {
+type NewGravatar @entity(immutable: false) {
   id: ID!
   owner: Bytes!
   displayName: String!
   imageUrl: String!
 }
 
-type UpdatedGravatar @entity {
+type UpdatedGravatar @entity(immutable: false) {
   id: ID!
   owner: Bytes!
   displayName: String!

examples/ethereum-gravatar/schema.graphql

@@ -1,4 +1,4 @@
-type Gravatar @entity {
+type Gravatar @entity(immutable: false) {
   id: ID!
   owner: Bytes!
   displayName: String!

examples/example-subgraph/schema.graphql

@@ -1,4 +1,4 @@
-type ExampleEntity @entity {
+type ExampleEntity @entity(immutable: false) {
   id: ID!
 
   optionalBoolean: Boolean
@@ -32,6 +32,6 @@ type ExampleEntity @entity {
   requiredReferenceList: [OtherEntity!]!
 }
 
-type OtherEntity @entity {
+type OtherEntity @entity(immutable: true) {
   id: ID!
 }

examples/near-blocks/schema.graphql

@@ -1,4 +1,4 @@
-type BlockEvent @entity {
+type BlockEvent @entity(immutable: true) {
   id: ID!
   number: BigInt
   hash: Bytes

examples/near-receipts/schema.graphql

@@ -1,10 +1,10 @@
-type Greeter @entity {
+type Greeter @entity(immutable: true) {
   id: ID!
   name: String!
   greetings: [Greeting!] @derivedFrom(field: "greeter")
 }
 
-type Greeting @entity {
+type Greeting @entity(immutable: true) {
   id: ID!
   greeter: Greeter!
   timestamp: BigInt!

examples/substreams-powered-subgraph/schema.graphql

@@ -1,4 +1,4 @@
-type Contract @entity {
+type Contract @entity(immutable: true) {
   id: ID!
 
   "The timestamp when the contract was deployed"

package.json

@@ -36,8 +36,8 @@
     "@theguild/eslint-config": "0.13.2",
     "@theguild/prettier-config": "3.0.0",
     "@types/node": "^22.10.1",
-    "eslint": "9.19.0",
-    "prettier": "3.4.2"
+    "eslint": "9.21.0",
+    "prettier": "3.5.3"
   },
   "pnpm": {
     "patchedDependencies": {

packages/cli/CHANGELOG.md

@@ -1,5 +1,43 @@
 # @graphprotocol/graph-cli
 
+## 0.97.0
+
+### Minor Changes
+
+- [#1993](https://github.com/graphprotocol/graph-tooling/pull/1993) [`3e04952`](https://github.com/graphprotocol/graph-tooling/commit/3e04952766d15bc73b5d1aed6bf7fe915c37863b) Thanks [@incrypto32](https://github.com/incrypto32)! - Composed subgraphs are modified to only accept immutable entites as triggers from a source subgraph
+
+- [#1994](https://github.com/graphprotocol/graph-tooling/pull/1994) [`2946073`](https://github.com/graphprotocol/graph-tooling/commit/2946073875048e0fe41536ad982a118ef826bb6b) Thanks [@isum](https://github.com/isum)! - require immutable flag on entities
+
+### Patch Changes
+
+- [#1956](https://github.com/graphprotocol/graph-tooling/pull/1956) [`59ad5f0`](https://github.com/graphprotocol/graph-tooling/commit/59ad5f06f45cd8d9842156d58f5047040f2cc1dd) Thanks [@renovate](https://github.com/apps/renovate)! - dependencies updates:
+
+  - Updated dependency [`@oclif/core@4.2.8` ↗︎](https://www.npmjs.com/package/@oclif/core/v/4.2.8) (from `4.2.6`, in `dependencies`)
+  - Updated dependency [`docker-compose@1.1.1` ↗︎](https://www.npmjs.com/package/docker-compose/v/1.1.1) (from `1.1.0`, in `dependencies`)
+  - Updated dependency [`prettier@3.5.2` ↗︎](https://www.npmjs.com/package/prettier/v/3.5.2) (from `3.4.2`, in `dependencies`)
+
+- [#1978](https://github.com/graphprotocol/graph-tooling/pull/1978) [`d360f11`](https://github.com/graphprotocol/graph-tooling/commit/d360f11328d32d11246ce5101a168081fedb720a) Thanks [@renovate](https://github.com/apps/renovate)! - dependencies updates:
+
+  - Updated dependency [`undici@7.4.0` ↗︎](https://www.npmjs.com/package/undici/v/7.4.0) (from `7.3.0`, in `dependencies`)
+
+- [#1979](https://github.com/graphprotocol/graph-tooling/pull/1979) [`3f78ac2`](https://github.com/graphprotocol/graph-tooling/commit/3f78ac20925af23df24afec2966d26fc002e3195) Thanks [@renovate](https://github.com/apps/renovate)! - dependencies updates:
+
+  - Updated dependency [`prettier@3.5.3` ↗︎](https://www.npmjs.com/package/prettier/v/3.5.3) (from `3.5.2`, in `dependencies`)
+
+- [#1969](https://github.com/graphprotocol/graph-tooling/pull/1969) [`5ffce65`](https://github.com/graphprotocol/graph-tooling/commit/5ffce651d11a68b8eae743785311eac74c8da563) Thanks [@YaroShkvorets](https://github.com/YaroShkvorets)! - handle sized arrays in abi when changetype
+
+- [#1967](https://github.com/graphprotocol/graph-tooling/pull/1967) [`388ee5a`](https://github.com/graphprotocol/graph-tooling/commit/388ee5a52a150bcd1ce544278f85242ea0498dcf) Thanks [@YaroShkvorets](https://github.com/YaroShkvorets)! - show sourcify fetch status
+
+- [#1934](https://github.com/graphprotocol/graph-tooling/pull/1934) [`30f2aa5`](https://github.com/graphprotocol/graph-tooling/commit/30f2aa500db1b708f38ba6ee7ce7b0e7660cc40b) Thanks [@shiyasmohd](https://github.com/shiyasmohd)! - fix: generate types for mappings when int8 is used as id
+
+- [#1977](https://github.com/graphprotocol/graph-tooling/pull/1977) [`030a7f0`](https://github.com/graphprotocol/graph-tooling/commit/030a7f0d12b7fc178f1e6543e8795511e90b9bc3) Thanks [@idalithb](https://github.com/idalithb)! - Added subgraph composition examples
+
+- [#1971](https://github.com/graphprotocol/graph-tooling/pull/1971) [`4e2b689`](https://github.com/graphprotocol/graph-tooling/commit/4e2b689d90e91b40b6bb4b0af76e42973582ebf7) Thanks [@YaroShkvorets](https://github.com/YaroShkvorets)! - `graph codegen`: fix bug with id field clash in example entity
+
+- [#1966](https://github.com/graphprotocol/graph-tooling/pull/1966) [`84b0d21`](https://github.com/graphprotocol/graph-tooling/commit/84b0d21f60da67295d41f096211d31cd0cd432cb) Thanks [@YaroShkvorets](https://github.com/YaroShkvorets)! - handle invalid characters in contract name #1883
+
+- [#1974](https://github.com/graphprotocol/graph-tooling/pull/1974) [`31c25e7`](https://github.com/graphprotocol/graph-tooling/commit/31c25e74569035209e768332556ad358cb11258d) Thanks [@YaroShkvorets](https://github.com/YaroShkvorets)! - handle non-standard Etherscan API responses, i.e. kaia
+
 ## 0.96.0
 
 ### Minor Changes

packages/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@graphprotocol/graph-cli",
-  "version": "0.96.0",
+  "version": "0.97.0",
   "type": "module",
   "description": "CLI for building for and deploying to The Graph",
   "repository": {
@@ -37,7 +37,7 @@
   },
   "dependencies": {
     "@float-capital/float-subgraph-uncrashable": "0.0.0-internal-testing.5",
-    "@oclif/core": "4.2.6",
+    "@oclif/core": "4.2.8",
     "@oclif/plugin-autocomplete": "^3.2.11",
     "@oclif/plugin-not-found": "^3.2.29",
     "@oclif/plugin-warn-if-update-available": "^3.1.24",
@@ -46,7 +46,7 @@
     "assemblyscript": "0.19.23",
     "chokidar": "4.0.3",
     "debug": "4.4.0",
-    "docker-compose": "1.1.0",
+    "docker-compose": "1.1.1",
     "fs-extra": "11.3.0",
     "glob": "11.0.1",
     "gluegun": "5.2.0",
@@ -56,10 +56,10 @@
     "js-yaml": "4.1.0",
     "kubo-rpc-client": "^5.0.2",
     "open": "10.1.0",
-    "prettier": "3.4.2",
+    "prettier": "3.5.3",
     "semver": "7.7.1",
     "tmp-promise": "3.0.3",
-    "undici": "7.3.0",
+    "undici": "7.4.0",
     "web3-eth-abi": "4.4.1",
     "yaml": "2.7.0"
   },