feat(api): tips and tricks with stream contracts

docs/api/lockup/01-overview.mdx

@@ -27,3 +27,41 @@ Lockup-native functionality is powered by:
 
 As per our endpoint [naming convention](/api/overview#endpoints--slugs), subgraph deployments of Sablier Lockup will
 follow the `sablier-v2-*` structure (e.g. `sablier-v2` for Mainnet, `sablier-v2-base` for Base).
+
+#### Tips and tricks
+
+:::tip
+
+To avoid writing the same entity definitions over and over again, check out
+[Fragments](https://graphql.org/learn/queries/#fragments).
+
+```graphql
+
+fragment StreamFragment on Stream {
+  id
+  sender
+  recipient
+  contract {
+    id
+    address
+  }
+}
+
+query getStreams(...){
+  streams(...){
+    ...StreamFragment
+  }
+}
+
+```
+
+:::
+
+:::note
+
+Since Sablier uses multiple immutable contract versions and deployments (e.g.
+[lockup's variants](/guides/lockup/deployments#previous-versions)), if you're going to perform onchain actions on
+queried streams (e.g. getting the `streamedAmountOf`) make sure you call those methods on the right contract. For
+subgraphs/indexers, we store the source contract under `stream.contract.address`.
+
+:::

docs/api/lockup/the-graph/04-queries.md

@@ -160,14 +160,19 @@ query getStreams_ByCampaignId($campaignId: String!) {
 
 :::tip
 
-To avoid writing the same entity definitions over and over again, check out Fragments.
+To avoid writing the same entity definitions over and over again, check out
+[Fragments](https://graphql.org/learn/queries/#fragments).
 
 ```graphql
 
 fragment StreamFragment on Stream {
   id
   sender
   recipient
+  contract {
+    id
+    address
+  }
 }
 
 query getStreams(...){
@@ -180,6 +185,15 @@ query getStreams(...){
 
 :::
 
+:::note
+
+Since Sablier uses multiple immutable contract versions and deployments (e.g.
+[lockup's variants](/guides/lockup/deployments#previous-versions)), if you're going to perform onchain actions on these
+streams (e.g. getting the `streamedAmountOf` for each one) make sure you call those methods on the right contract. For
+subgraphs/indexers, we store the source contract under `stream.contract.address`.
+
+:::
+
 ## Actions
 
 ### Actions by stream