@secondlayer/subgraphs 0.8.1 → 0.9.1

package/dist/src/templates.js

@@ -12,9 +12,9 @@ var templates = [
 
 export default defineSubgraph({
   name: 'dex-swaps',
-  sources: [
-    { contract: 'SP102V8P0F7JX67ARQ77WEA3D3CFB5XW39REDT0AM.amm-pool-v2-01', event: 'swap' },
-  ],
+  sources: {
+    swap: { type: 'print_event', contractId: 'SP102V8P0F7JX67ARQ77WEA3D3CFB5XW39REDT0AM.amm-pool-v2-01', topic: 'swap' },
+  },
   schema: {
     swaps: {
       columns: {
@@ -28,13 +28,13 @@ export default defineSubgraph({
     },
   },
   handlers: {
-    'SP102V8P0F7JX67ARQ77WEA3D3CFB5XW39REDT0AM.amm-pool-v2-01::swap': (event, ctx) => {
+    swap: (event, ctx) => {
       ctx.insert('swaps', {
         sender: ctx.tx.sender,
-        token_x: event.tokenX,
-        token_y: event.tokenY,
-        amount_x: event.dx,
-        amount_y: event.dy,
+        token_x: event.data.tokenX,
+        token_y: event.data.tokenY,
+        amount_x: event.data.dx,
+        amount_y: event.data.dy,
       });
     },
   },
@@ -51,11 +51,11 @@ export default defineSubgraph({
 
 export default defineSubgraph({
   name: 'nft-marketplace',
-  sources: [
-    { contract: 'SP...marketplace', event: 'list-item' },
-    { contract: 'SP...marketplace', event: 'unlist-item' },
-    { contract: 'SP...marketplace', event: 'purchase' },
-  ],
+  sources: {
+    listItem: { type: 'print_event', contractId: 'SP...marketplace', topic: 'list-item' },
+    unlistItem: { type: 'print_event', contractId: 'SP...marketplace', topic: 'unlist-item' },
+    purchase: { type: 'print_event', contractId: 'SP...marketplace', topic: 'purchase' },
+  },
   schema: {
     listings: {
       columns: {
@@ -76,24 +76,24 @@ export default defineSubgraph({
     },
   },
   handlers: {
-    'SP...marketplace::list-item': (event, ctx) => {
-      ctx.upsert('listings', { nft_id: event.nftId }, {
-        nft_id: event.nftId,
+    listItem: (event, ctx) => {
+      ctx.upsert('listings', { nft_id: event.data.nftId }, {
+        nft_id: event.data.nftId,
         seller: ctx.tx.sender,
-        price: event.price,
+        price: event.data.price,
         status: 'active',
       });
     },
-    'SP...marketplace::unlist-item': (event, ctx) => {
-      ctx.update('listings', { nft_id: event.nftId }, { status: 'cancelled' });
+    unlistItem: (event, ctx) => {
+      ctx.update('listings', { nft_id: event.data.nftId }, { status: 'cancelled' });
     },
-    'SP...marketplace::purchase': (event, ctx) => {
-      ctx.update('listings', { nft_id: event.nftId }, { status: 'sold' });
+    purchase: (event, ctx) => {
+      ctx.update('listings', { nft_id: event.data.nftId }, { status: 'sold' });
       ctx.insert('sales', {
-        nft_id: event.nftId,
-        seller: event.seller,
+        nft_id: event.data.nftId,
+        seller: event.data.seller,
         buyer: ctx.tx.sender,
-        price: event.price,
+        price: event.data.price,
       });
     },
   },
@@ -110,9 +110,9 @@ export default defineSubgraph({
 
 export default defineSubgraph({
   name: 'token-transfers',
-  sources: [
-    { contract: 'SP...token', event: 'transfer' },
-  ],
+  sources: {
+    transfer: { type: 'ft_transfer', assetIdentifier: 'SP...token' },
+  },
   schema: {
     transfers: {
       columns: {
@@ -130,7 +130,7 @@ export default defineSubgraph({
     },
   },
   handlers: {
-    'SP...token::transfer': async (event, ctx) => {
+    transfer: async (event, ctx) => {
       ctx.insert('transfers', {
         from_addr: event.sender,
         to_addr: event.recipient,
@@ -142,7 +142,7 @@ export default defineSubgraph({
       const senderPrev = senderBal ? BigInt(senderBal.balance as string) : 0n;
       ctx.upsert('balances', { address: event.sender }, {
         address: event.sender,
-        balance: senderPrev - BigInt(event.amount as string),
+        balance: senderPrev - event.amount,
       });
 
       // Update recipient balance
@@ -150,7 +150,7 @@ export default defineSubgraph({
       const recipPrev = recipBal ? BigInt(recipBal.balance as string) : 0n;
       ctx.upsert('balances', { address: event.recipient }, {
         address: event.recipient,
-        balance: recipPrev + BigInt(event.amount as string),
+        balance: recipPrev + event.amount,
       });
     },
   },
@@ -167,10 +167,10 @@ export default defineSubgraph({
 
 export default defineSubgraph({
   name: 'bns-names',
-  sources: [
-    { contract: 'SP000000000000000000002Q6VF78.bns', function: 'name-register' },
-    { contract: 'SP000000000000000000002Q6VF78.bns', function: 'name-transfer' },
-  ],
+  sources: {
+    nameRegister: { type: 'contract_call', contractId: 'SP000000000000000000002Q6VF78.bns', functionName: 'name-register' },
+    nameTransfer: { type: 'contract_call', contractId: 'SP000000000000000000002Q6VF78.bns', functionName: 'name-transfer' },
+  },
   schema: {
     names: {
       columns: {
@@ -190,22 +190,22 @@ export default defineSubgraph({
     },
   },
   handlers: {
-    'SP000000000000000000002Q6VF78.bns::name-register': (event, ctx) => {
-      ctx.upsert('names', { name: event.name, namespace: event.namespace }, {
-        name: event.name,
-        namespace: event.namespace,
+    nameRegister: (event, ctx) => {
+      ctx.upsert('names', { name: event.args.name, namespace: event.args.namespace }, {
+        name: event.args.name,
+        namespace: event.args.namespace,
         owner: ctx.tx.sender,
       });
     },
-    'SP000000000000000000002Q6VF78.bns::name-transfer': (event, ctx) => {
-      ctx.update('names', { name: event.name, namespace: event.namespace }, {
-        owner: event.newOwner,
+    nameTransfer: (event, ctx) => {
+      ctx.update('names', { name: event.args.name, namespace: event.args.namespace }, {
+        owner: event.args.newOwner,
       });
       ctx.insert('transfers', {
-        name: event.name,
-        namespace: event.namespace,
-        from_addr: event.sender,
-        to_addr: event.newOwner,
+        name: event.args.name,
+        namespace: event.args.namespace,
+        from_addr: event.args.sender,
+        to_addr: event.args.newOwner,
       });
     },
   },
@@ -220,11 +220,13 @@ export default defineSubgraph({
     category: "token",
     code: `import { defineSubgraph } from '@secondlayer/subgraphs';
 
-const WHALE_THRESHOLD = 100_000_000_000; // 100k STX in microSTX
+const WHALE_THRESHOLD = 100_000_000_000n; // 100k STX in microSTX
 
 export default defineSubgraph({
   name: 'stx-whales',
-  sources: [{ type: 'stx_transfer' }],
+  sources: {
+    stxTransfer: { type: 'stx_transfer' },
+  },
   schema: {
     whale_transfers: {
       columns: {
@@ -235,9 +237,8 @@ export default defineSubgraph({
     },
   },
   handlers: {
-    stx_transfer: (event, ctx) => {
-      const amount = BigInt(event.amount as string);
-      if (amount >= BigInt(WHALE_THRESHOLD)) {
+    stxTransfer: (event, ctx) => {
+      if (event.amount >= WHALE_THRESHOLD) {
         ctx.insert('whale_transfers', {
           sender: event.sender,
           receiver: event.recipient,
@@ -263,5 +264,5 @@ export {
   getTemplateById
 };
 
-//# debugId=C475457B59EBDAC964756E2164756E21
+//# debugId=F4B252C88EAA2F7964756E2164756E21
 //# sourceMappingURL=templates.js.map

package/dist/src/templates.js.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../src/templates.ts"],
   "sourcesContent": [
-    "export interface SubgraphTemplate {\n\tid: string;\n\tname: string;\n\tdescription: string;\n\tcategory: \"defi\" | \"nft\" | \"token\" | \"infrastructure\";\n\tcode: string;\n\tprompt: string;\n}\n\nexport const templates: SubgraphTemplate[] = [\n\t{\n\t\tid: \"dex-swaps\",\n\t\tname: \"DEX Swap Tracking\",\n\t\tdescription:\n\t\t\t\"Track swap events from ALEX or any AMM pool. Indexes token pairs, amounts, and traders.\",\n\t\tcategory: \"defi\",\n\t\tcode: `import { defineSubgraph } from '@secondlayer/subgraphs';\n\nexport default defineSubgraph({\n  name: 'dex-swaps',\n  sources: [\n    { contract: 'SP102V8P0F7JX67ARQ77WEA3D3CFB5XW39REDT0AM.amm-pool-v2-01', event: 'swap' },\n  ],\n  schema: {\n    swaps: {\n      columns: {\n        sender:   { type: 'principal', indexed: true },\n        token_x:  { type: 'text' },\n        token_y:  { type: 'text' },\n        amount_x: { type: 'uint' },\n        amount_y: { type: 'uint' },\n      },\n      indexes: [['sender', 'token_x']],\n    },\n  },\n  handlers: {\n    'SP102V8P0F7JX67ARQ77WEA3D3CFB5XW39REDT0AM.amm-pool-v2-01::swap': (event, ctx) => {\n      ctx.insert('swaps', {\n        sender: ctx.tx.sender,\n        token_x: event.tokenX,\n        token_y: event.tokenY,\n        amount_x: event.dx,\n        amount_y: event.dy,\n      });\n    },\n  },\n});\n`,\n\t\tprompt:\n\t\t\t\"Create a Secondlayer subgraph that tracks DEX swap events from ALEX AMM pool. Index sender, token pairs, and amounts.\",\n\t},\n\t{\n\t\tid: \"nft-marketplace\",\n\t\tname: \"NFT Marketplace\",\n\t\tdescription:\n\t\t\t\"Index NFT listings, sales, and cancellations. Track prices and ownership changes.\",\n\t\tcategory: \"nft\",\n\t\tcode: `import { defineSubgraph } from '@secondlayer/subgraphs';\n\nexport default defineSubgraph({\n  name: 'nft-marketplace',\n  sources: [\n    { contract: 'SP...marketplace', event: 'list-item' },\n    { contract: 'SP...marketplace', event: 'unlist-item' },\n    { contract: 'SP...marketplace', event: 'purchase' },\n  ],\n  schema: {\n    listings: {\n      columns: {\n        nft_id:  { type: 'uint', indexed: true },\n        seller:  { type: 'principal', indexed: true },\n        price:   { type: 'uint' },\n        status:  { type: 'text' },\n      },\n      uniqueKeys: [['nft_id']],\n    },\n    sales: {\n      columns: {\n        nft_id:  { type: 'uint', indexed: true },\n        seller:  { type: 'principal' },\n        buyer:   { type: 'principal', indexed: true },\n        price:   { type: 'uint' },\n      },\n    },\n  },\n  handlers: {\n    'SP...marketplace::list-item': (event, ctx) => {\n      ctx.upsert('listings', { nft_id: event.nftId }, {\n        nft_id: event.nftId,\n        seller: ctx.tx.sender,\n        price: event.price,\n        status: 'active',\n      });\n    },\n    'SP...marketplace::unlist-item': (event, ctx) => {\n      ctx.update('listings', { nft_id: event.nftId }, { status: 'cancelled' });\n    },\n    'SP...marketplace::purchase': (event, ctx) => {\n      ctx.update('listings', { nft_id: event.nftId }, { status: 'sold' });\n      ctx.insert('sales', {\n        nft_id: event.nftId,\n        seller: event.seller,\n        buyer: ctx.tx.sender,\n        price: event.price,\n      });\n    },\n  },\n});\n`,\n\t\tprompt:\n\t\t\t\"Create a Secondlayer subgraph for an NFT marketplace. Track listings, cancellations, and sales with prices.\",\n\t},\n\t{\n\t\tid: \"token-transfers\",\n\t\tname: \"Token Transfers\",\n\t\tdescription:\n\t\t\t\"Track fungible token transfers with running balance computation per address.\",\n\t\tcategory: \"token\",\n\t\tcode: `import { defineSubgraph } from '@secondlayer/subgraphs';\n\nexport default defineSubgraph({\n  name: 'token-transfers',\n  sources: [\n    { contract: 'SP...token', event: 'transfer' },\n  ],\n  schema: {\n    transfers: {\n      columns: {\n        from_addr: { type: 'principal', indexed: true },\n        to_addr:   { type: 'principal', indexed: true },\n        amount:    { type: 'uint' },\n      },\n    },\n    balances: {\n      columns: {\n        address: { type: 'principal', indexed: true },\n        balance: { type: 'uint' },\n      },\n      uniqueKeys: [['address']],\n    },\n  },\n  handlers: {\n    'SP...token::transfer': async (event, ctx) => {\n      ctx.insert('transfers', {\n        from_addr: event.sender,\n        to_addr: event.recipient,\n        amount: event.amount,\n      });\n\n      // Update sender balance\n      const senderBal = await ctx.findOne('balances', { address: event.sender });\n      const senderPrev = senderBal ? BigInt(senderBal.balance as string) : 0n;\n      ctx.upsert('balances', { address: event.sender }, {\n        address: event.sender,\n        balance: senderPrev - BigInt(event.amount as string),\n      });\n\n      // Update recipient balance\n      const recipBal = await ctx.findOne('balances', { address: event.recipient });\n      const recipPrev = recipBal ? BigInt(recipBal.balance as string) : 0n;\n      ctx.upsert('balances', { address: event.recipient }, {\n        address: event.recipient,\n        balance: recipPrev + BigInt(event.amount as string),\n      });\n    },\n  },\n});\n`,\n\t\tprompt:\n\t\t\t\"Create a Secondlayer subgraph that tracks token transfers and computes running balances per address.\",\n\t},\n\t{\n\t\tid: \"bns-names\",\n\t\tname: \"BNS Names\",\n\t\tdescription:\n\t\t\t\"Index BNS name registrations and transfers. Search names by owner or namespace.\",\n\t\tcategory: \"infrastructure\",\n\t\tcode: `import { defineSubgraph } from '@secondlayer/subgraphs';\n\nexport default defineSubgraph({\n  name: 'bns-names',\n  sources: [\n    { contract: 'SP000000000000000000002Q6VF78.bns', function: 'name-register' },\n    { contract: 'SP000000000000000000002Q6VF78.bns', function: 'name-transfer' },\n  ],\n  schema: {\n    names: {\n      columns: {\n        name:      { type: 'text', indexed: true, search: true },\n        namespace: { type: 'text', indexed: true },\n        owner:     { type: 'principal', indexed: true },\n      },\n      uniqueKeys: [['name', 'namespace']],\n    },\n    transfers: {\n      columns: {\n        name:      { type: 'text' },\n        namespace: { type: 'text' },\n        from_addr: { type: 'principal' },\n        to_addr:   { type: 'principal' },\n      },\n    },\n  },\n  handlers: {\n    'SP000000000000000000002Q6VF78.bns::name-register': (event, ctx) => {\n      ctx.upsert('names', { name: event.name, namespace: event.namespace }, {\n        name: event.name,\n        namespace: event.namespace,\n        owner: ctx.tx.sender,\n      });\n    },\n    'SP000000000000000000002Q6VF78.bns::name-transfer': (event, ctx) => {\n      ctx.update('names', { name: event.name, namespace: event.namespace }, {\n        owner: event.newOwner,\n      });\n      ctx.insert('transfers', {\n        name: event.name,\n        namespace: event.namespace,\n        from_addr: event.sender,\n        to_addr: event.newOwner,\n      });\n    },\n  },\n});\n`,\n\t\tprompt:\n\t\t\t\"Create a Secondlayer subgraph for BNS name registrations and transfers on Stacks.\",\n\t},\n\t{\n\t\tid: \"stx-whales\",\n\t\tname: \"STX Whale Alerts\",\n\t\tdescription:\n\t\t\t\"Track large STX transfers above a configurable threshold. Great for monitoring whale activity.\",\n\t\tcategory: \"token\",\n\t\tcode: `import { defineSubgraph } from '@secondlayer/subgraphs';\n\nconst WHALE_THRESHOLD = 100_000_000_000; // 100k STX in microSTX\n\nexport default defineSubgraph({\n  name: 'stx-whales',\n  sources: [{ type: 'stx_transfer' }],\n  schema: {\n    whale_transfers: {\n      columns: {\n        sender:   { type: 'principal', indexed: true },\n        receiver: { type: 'principal', indexed: true },\n        amount:   { type: 'uint' },\n      },\n    },\n  },\n  handlers: {\n    stx_transfer: (event, ctx) => {\n      const amount = BigInt(event.amount as string);\n      if (amount >= BigInt(WHALE_THRESHOLD)) {\n        ctx.insert('whale_transfers', {\n          sender: event.sender,\n          receiver: event.recipient,\n          amount: event.amount,\n        });\n      }\n    },\n  },\n});\n`,\n\t\tprompt:\n\t\t\t\"Create a Secondlayer subgraph that tracks STX transfers above 100k STX as whale alerts.\",\n\t},\n];\n\nexport function getTemplateById(id: string): SubgraphTemplate | undefined {\n\treturn templates.find((t) => t.id === id);\n}\n\nexport function getTemplatesByCategory(category: string): SubgraphTemplate[] {\n\treturn templates.filter((t) => t.category === category);\n}\n"
+    "export interface SubgraphTemplate {\n\tid: string;\n\tname: string;\n\tdescription: string;\n\tcategory: \"defi\" | \"nft\" | \"token\" | \"infrastructure\";\n\tcode: string;\n\tprompt: string;\n}\n\nexport const templates: SubgraphTemplate[] = [\n\t{\n\t\tid: \"dex-swaps\",\n\t\tname: \"DEX Swap Tracking\",\n\t\tdescription:\n\t\t\t\"Track swap events from ALEX or any AMM pool. Indexes token pairs, amounts, and traders.\",\n\t\tcategory: \"defi\",\n\t\tcode: `import { defineSubgraph } from '@secondlayer/subgraphs';\n\nexport default defineSubgraph({\n  name: 'dex-swaps',\n  sources: {\n    swap: { type: 'print_event', contractId: 'SP102V8P0F7JX67ARQ77WEA3D3CFB5XW39REDT0AM.amm-pool-v2-01', topic: 'swap' },\n  },\n  schema: {\n    swaps: {\n      columns: {\n        sender:   { type: 'principal', indexed: true },\n        token_x:  { type: 'text' },\n        token_y:  { type: 'text' },\n        amount_x: { type: 'uint' },\n        amount_y: { type: 'uint' },\n      },\n      indexes: [['sender', 'token_x']],\n    },\n  },\n  handlers: {\n    swap: (event, ctx) => {\n      ctx.insert('swaps', {\n        sender: ctx.tx.sender,\n        token_x: event.data.tokenX,\n        token_y: event.data.tokenY,\n        amount_x: event.data.dx,\n        amount_y: event.data.dy,\n      });\n    },\n  },\n});\n`,\n\t\tprompt:\n\t\t\t\"Create a Secondlayer subgraph that tracks DEX swap events from ALEX AMM pool. Index sender, token pairs, and amounts.\",\n\t},\n\t{\n\t\tid: \"nft-marketplace\",\n\t\tname: \"NFT Marketplace\",\n\t\tdescription:\n\t\t\t\"Index NFT listings, sales, and cancellations. Track prices and ownership changes.\",\n\t\tcategory: \"nft\",\n\t\tcode: `import { defineSubgraph } from '@secondlayer/subgraphs';\n\nexport default defineSubgraph({\n  name: 'nft-marketplace',\n  sources: {\n    listItem: { type: 'print_event', contractId: 'SP...marketplace', topic: 'list-item' },\n    unlistItem: { type: 'print_event', contractId: 'SP...marketplace', topic: 'unlist-item' },\n    purchase: { type: 'print_event', contractId: 'SP...marketplace', topic: 'purchase' },\n  },\n  schema: {\n    listings: {\n      columns: {\n        nft_id:  { type: 'uint', indexed: true },\n        seller:  { type: 'principal', indexed: true },\n        price:   { type: 'uint' },\n        status:  { type: 'text' },\n      },\n      uniqueKeys: [['nft_id']],\n    },\n    sales: {\n      columns: {\n        nft_id:  { type: 'uint', indexed: true },\n        seller:  { type: 'principal' },\n        buyer:   { type: 'principal', indexed: true },\n        price:   { type: 'uint' },\n      },\n    },\n  },\n  handlers: {\n    listItem: (event, ctx) => {\n      ctx.upsert('listings', { nft_id: event.data.nftId }, {\n        nft_id: event.data.nftId,\n        seller: ctx.tx.sender,\n        price: event.data.price,\n        status: 'active',\n      });\n    },\n    unlistItem: (event, ctx) => {\n      ctx.update('listings', { nft_id: event.data.nftId }, { status: 'cancelled' });\n    },\n    purchase: (event, ctx) => {\n      ctx.update('listings', { nft_id: event.data.nftId }, { status: 'sold' });\n      ctx.insert('sales', {\n        nft_id: event.data.nftId,\n        seller: event.data.seller,\n        buyer: ctx.tx.sender,\n        price: event.data.price,\n      });\n    },\n  },\n});\n`,\n\t\tprompt:\n\t\t\t\"Create a Secondlayer subgraph for an NFT marketplace. Track listings, cancellations, and sales with prices.\",\n\t},\n\t{\n\t\tid: \"token-transfers\",\n\t\tname: \"Token Transfers\",\n\t\tdescription:\n\t\t\t\"Track fungible token transfers with running balance computation per address.\",\n\t\tcategory: \"token\",\n\t\tcode: `import { defineSubgraph } from '@secondlayer/subgraphs';\n\nexport default defineSubgraph({\n  name: 'token-transfers',\n  sources: {\n    transfer: { type: 'ft_transfer', assetIdentifier: 'SP...token' },\n  },\n  schema: {\n    transfers: {\n      columns: {\n        from_addr: { type: 'principal', indexed: true },\n        to_addr:   { type: 'principal', indexed: true },\n        amount:    { type: 'uint' },\n      },\n    },\n    balances: {\n      columns: {\n        address: { type: 'principal', indexed: true },\n        balance: { type: 'uint' },\n      },\n      uniqueKeys: [['address']],\n    },\n  },\n  handlers: {\n    transfer: async (event, ctx) => {\n      ctx.insert('transfers', {\n        from_addr: event.sender,\n        to_addr: event.recipient,\n        amount: event.amount,\n      });\n\n      // Update sender balance\n      const senderBal = await ctx.findOne('balances', { address: event.sender });\n      const senderPrev = senderBal ? BigInt(senderBal.balance as string) : 0n;\n      ctx.upsert('balances', { address: event.sender }, {\n        address: event.sender,\n        balance: senderPrev - event.amount,\n      });\n\n      // Update recipient balance\n      const recipBal = await ctx.findOne('balances', { address: event.recipient });\n      const recipPrev = recipBal ? BigInt(recipBal.balance as string) : 0n;\n      ctx.upsert('balances', { address: event.recipient }, {\n        address: event.recipient,\n        balance: recipPrev + event.amount,\n      });\n    },\n  },\n});\n`,\n\t\tprompt:\n\t\t\t\"Create a Secondlayer subgraph that tracks token transfers and computes running balances per address.\",\n\t},\n\t{\n\t\tid: \"bns-names\",\n\t\tname: \"BNS Names\",\n\t\tdescription:\n\t\t\t\"Index BNS name registrations and transfers. Search names by owner or namespace.\",\n\t\tcategory: \"infrastructure\",\n\t\tcode: `import { defineSubgraph } from '@secondlayer/subgraphs';\n\nexport default defineSubgraph({\n  name: 'bns-names',\n  sources: {\n    nameRegister: { type: 'contract_call', contractId: 'SP000000000000000000002Q6VF78.bns', functionName: 'name-register' },\n    nameTransfer: { type: 'contract_call', contractId: 'SP000000000000000000002Q6VF78.bns', functionName: 'name-transfer' },\n  },\n  schema: {\n    names: {\n      columns: {\n        name:      { type: 'text', indexed: true, search: true },\n        namespace: { type: 'text', indexed: true },\n        owner:     { type: 'principal', indexed: true },\n      },\n      uniqueKeys: [['name', 'namespace']],\n    },\n    transfers: {\n      columns: {\n        name:      { type: 'text' },\n        namespace: { type: 'text' },\n        from_addr: { type: 'principal' },\n        to_addr:   { type: 'principal' },\n      },\n    },\n  },\n  handlers: {\n    nameRegister: (event, ctx) => {\n      ctx.upsert('names', { name: event.args.name, namespace: event.args.namespace }, {\n        name: event.args.name,\n        namespace: event.args.namespace,\n        owner: ctx.tx.sender,\n      });\n    },\n    nameTransfer: (event, ctx) => {\n      ctx.update('names', { name: event.args.name, namespace: event.args.namespace }, {\n        owner: event.args.newOwner,\n      });\n      ctx.insert('transfers', {\n        name: event.args.name,\n        namespace: event.args.namespace,\n        from_addr: event.args.sender,\n        to_addr: event.args.newOwner,\n      });\n    },\n  },\n});\n`,\n\t\tprompt:\n\t\t\t\"Create a Secondlayer subgraph for BNS name registrations and transfers on Stacks.\",\n\t},\n\t{\n\t\tid: \"stx-whales\",\n\t\tname: \"STX Whale Alerts\",\n\t\tdescription:\n\t\t\t\"Track large STX transfers above a configurable threshold. Great for monitoring whale activity.\",\n\t\tcategory: \"token\",\n\t\tcode: `import { defineSubgraph } from '@secondlayer/subgraphs';\n\nconst WHALE_THRESHOLD = 100_000_000_000n; // 100k STX in microSTX\n\nexport default defineSubgraph({\n  name: 'stx-whales',\n  sources: {\n    stxTransfer: { type: 'stx_transfer' },\n  },\n  schema: {\n    whale_transfers: {\n      columns: {\n        sender:   { type: 'principal', indexed: true },\n        receiver: { type: 'principal', indexed: true },\n        amount:   { type: 'uint' },\n      },\n    },\n  },\n  handlers: {\n    stxTransfer: (event, ctx) => {\n      if (event.amount >= WHALE_THRESHOLD) {\n        ctx.insert('whale_transfers', {\n          sender: event.sender,\n          receiver: event.recipient,\n          amount: event.amount,\n        });\n      }\n    },\n  },\n});\n`,\n\t\tprompt:\n\t\t\t\"Create a Secondlayer subgraph that tracks STX transfers above 100k STX as whale alerts.\",\n\t},\n];\n\nexport function getTemplateById(id: string): SubgraphTemplate | undefined {\n\treturn templates.find((t) => t.id === id);\n}\n\nexport function getTemplatesByCategory(category: string): SubgraphTemplate[] {\n\treturn templates.filter((t) => t.category === category);\n}\n"
   ],
-  "mappings": ";;;;AASO,IAAM,YAAgC;AAAA,EAC5C;AAAA,IACC,IAAI;AAAA,IACJ,MAAM;AAAA,IACN,aACC;AAAA,IACD,UAAU;AAAA,IACV,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAgCN,QACC;AAAA,EACF;AAAA,EACA;AAAA,IACC,IAAI;AAAA,IACJ,MAAM;AAAA,IACN,aACC;AAAA,IACD,UAAU;AAAA,IACV,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAoDN,QACC;AAAA,EACF;AAAA,EACA;AAAA,IACC,IAAI;AAAA,IACJ,MAAM;AAAA,IACN,aACC;AAAA,IACD,UAAU;AAAA,IACV,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAkDN,QACC;AAAA,EACF;AAAA,EACA;AAAA,IACC,IAAI;AAAA,IACJ,MAAM;AAAA,IACN,aACC;AAAA,IACD,UAAU;AAAA,IACV,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAgDN,QACC;AAAA,EACF;AAAA,EACA;AAAA,IACC,IAAI;AAAA,IACJ,MAAM;AAAA,IACN,aACC;AAAA,IACD,UAAU;AAAA,IACV,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IA8BN,QACC;AAAA,EACF;AACD;AAEO,SAAS,eAAe,CAAC,IAA0C;AAAA,EACzE,OAAO,UAAU,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE;AAAA;AAGlC,SAAS,sBAAsB,CAAC,UAAsC;AAAA,EAC5E,OAAO,UAAU,OAAO,CAAC,MAAM,EAAE,aAAa,QAAQ;AAAA;",
-  "debugId": "C475457B59EBDAC964756E2164756E21",
+  "mappings": ";;;;AASO,IAAM,YAAgC;AAAA,EAC5C;AAAA,IACC,IAAI;AAAA,IACJ,MAAM;AAAA,IACN,aACC;AAAA,IACD,UAAU;AAAA,IACV,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAgCN,QACC;AAAA,EACF;AAAA,EACA;AAAA,IACC,IAAI;AAAA,IACJ,MAAM;AAAA,IACN,aACC;AAAA,IACD,UAAU;AAAA,IACV,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAoDN,QACC;AAAA,EACF;AAAA,EACA;AAAA,IACC,IAAI;AAAA,IACJ,MAAM;AAAA,IACN,aACC;AAAA,IACD,UAAU;AAAA,IACV,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAkDN,QACC;AAAA,EACF;AAAA,EACA;AAAA,IACC,IAAI;AAAA,IACJ,MAAM;AAAA,IACN,aACC;AAAA,IACD,UAAU;AAAA,IACV,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAgDN,QACC;AAAA,EACF;AAAA,EACA;AAAA,IACC,IAAI;AAAA,IACJ,MAAM;AAAA,IACN,aACC;AAAA,IACD,UAAU;AAAA,IACV,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IA+BN,QACC;AAAA,EACF;AACD;AAEO,SAAS,eAAe,CAAC,IAA0C;AAAA,EACzE,OAAO,UAAU,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE;AAAA;AAGlC,SAAS,sBAAsB,CAAC,UAAsC;AAAA,EAC5E,OAAO,UAAU,OAAO,CAAC,MAAM,EAAE,aAAa,QAAQ;AAAA;",
+  "debugId": "F4B252C88EAA2F7964756E2164756E21",
   "names": []
 }

package/dist/src/types.d.ts

@@ -18,19 +18,98 @@ interface SubgraphTable {
 }
 /** Subgraph schema — maps table names to table definitions */
 type SubgraphSchema = Record<string, SubgraphTable>;
-/** Source filter for what blockchain data this subgraph processes */
-interface SubgraphSource {
-	/** Contract principal (e.g., SP000...::contract-name). Supports * wildcards. */
-	contract?: string;
-	/** Event name/topic to filter on */
-	event?: string;
-	/** Function name to filter on */
-	function?: string;
-	/** Transaction type filter (e.g., "stx_transfer", "contract_call") */
-	type?: string;
-	/** Minimum amount filter (for stx_transfer sources) */
+/** STX event filters */
+interface StxTransferFilter {
+	type: "stx_transfer";
+	sender?: string;
+	recipient?: string;
 	minAmount?: bigint;
+	maxAmount?: bigint;
 }
+interface StxMintFilter {
+	type: "stx_mint";
+	recipient?: string;
+	minAmount?: bigint;
+}
+interface StxBurnFilter {
+	type: "stx_burn";
+	sender?: string;
+	minAmount?: bigint;
+}
+interface StxLockFilter {
+	type: "stx_lock";
+	lockedAddress?: string;
+	minAmount?: bigint;
+}
+/** FT event filters */
+interface FtTransferFilter {
+	type: "ft_transfer";
+	assetIdentifier?: string;
+	sender?: string;
+	recipient?: string;
+	minAmount?: bigint;
+}
+interface FtMintFilter {
+	type: "ft_mint";
+	assetIdentifier?: string;
+	recipient?: string;
+	minAmount?: bigint;
+}
+interface FtBurnFilter {
+	type: "ft_burn";
+	assetIdentifier?: string;
+	sender?: string;
+	minAmount?: bigint;
+}
+/** NFT event filters */
+interface NftTransferFilter {
+	type: "nft_transfer";
+	assetIdentifier?: string;
+	sender?: string;
+	recipient?: string;
+}
+interface NftMintFilter {
+	type: "nft_mint";
+	assetIdentifier?: string;
+	recipient?: string;
+}
+interface NftBurnFilter {
+	type: "nft_burn";
+	assetIdentifier?: string;
+	sender?: string;
+}
+/** Contract event filters */
+interface ContractCallFilter {
+	type: "contract_call";
+	contractId?: string;
+	functionName?: string;
+	caller?: string;
+	/** ABI for typed event.args. If omitted, auto-fetched at deploy time. */
+	abi?: Record<string, unknown>;
+}
+interface ContractDeployFilter {
+	type: "contract_deploy";
+	deployer?: string;
+	contractName?: string;
+}
+interface PrintEventFilter {
+	type: "print_event";
+	contractId?: string;
+	topic?: string;
+}
+/** All subgraph filter types — discriminated on `type` */
+type SubgraphFilter = StxTransferFilter | StxMintFilter | StxBurnFilter | StxLockFilter | FtTransferFilter | FtMintFilter | FtBurnFilter | NftTransferFilter | NftMintFilter | NftBurnFilter | ContractCallFilter | ContractDeployFilter | PrintEventFilter;
+/** Transaction metadata available in handlers */
+interface TxMeta {
+	txId: string;
+	sender: string;
+	type: string;
+	status: string;
+	contractId?: string | null;
+	functionName?: string | null;
+}
+/** Value or computed function that receives existing row */
+type ComputedValue<T = unknown> = T | ((existing: Record<string, unknown> | null) => T);
 /** Context passed to subgraph handlers during event processing */
 interface SubgraphContext {
 	block: {
@@ -39,29 +118,32 @@ interface SubgraphContext {
 		timestamp: number
 		burnBlockHeight: number
 	};
-	tx: {
-		txId: string
-		sender: string
-		type: string
-		status: string
-	};
+	tx: TxMeta;
 	insert(table: string, row: Record<string, unknown>): void;
 	update(table: string, where: Record<string, unknown>, set: Record<string, unknown>): void;
 	upsert(table: string, key: Record<string, unknown>, row: Record<string, unknown>): void;
 	delete(table: string, where: Record<string, unknown>): void;
+	/** Partial update — sets only specified fields, preserves others */
+	patch(table: string, where: Record<string, unknown>, set: Record<string, unknown>): void;
+	/** Find-then-merge-or-insert. Values can be functions: (existing) => newValue */
+	patchOrInsert(table: string, key: Record<string, unknown>, row: Record<string, ComputedValue>): Promise<void>;
 	findOne(table: string, where: Record<string, unknown>): Promise<Record<string, unknown> | null>;
 	findMany(table: string, where: Record<string, unknown>): Promise<Record<string, unknown>[]>;
+	/** Format a bigint amount with decimal places */
+	formatUnits(value: bigint, decimals: number): string;
+	/** Count rows matching filter */
+	count(table: string, where?: Record<string, unknown>): Promise<number>;
+	/** Sum a numeric column */
+	sum(table: string, column: string, where?: Record<string, unknown>): Promise<bigint>;
+	/** Min of a numeric column */
+	min(table: string, column: string, where?: Record<string, unknown>): Promise<bigint | null>;
+	/** Max of a numeric column */
+	max(table: string, column: string, where?: Record<string, unknown>): Promise<bigint | null>;
+	/** Count distinct values in a column */
+	countDistinct(table: string, column: string, where?: Record<string, unknown>): Promise<number>;
 }
 /** Handler function that processes events and writes to the subgraph */
 type SubgraphHandler = (event: Record<string, unknown>, ctx: SubgraphContext) => Promise<void> | void;
-/**
-* Derive the source key used to look up handlers.
-* - { contract: "SP123.market", function: "list" } → "SP123.market::list"
-* - { contract: "SP123.market", event: "sale" } → "SP123.market::sale"
-* - { contract: "SP123.market" } → "SP123.market"
-* - { type: "stx_transfer" } → "stx_transfer"
-*/
-declare function sourceKey(source: SubgraphSource): string;
 /** Complete subgraph definition */
 interface SubgraphDefinition {
 	/** Unique subgraph name (lowercase, alphanumeric + hyphens) */
@@ -72,11 +154,11 @@ interface SubgraphDefinition {
 	description?: string;
 	/** Block height to start indexing from (default: 1) */
 	startBlock?: number;
-	/** What blockchain data to process — one or more source filters */
-	sources: SubgraphSource[];
+	/** Named source filters — keys become handler keys */
+	sources: Record<string, SubgraphFilter>;
 	/** Tables in this subgraph */
 	schema: SubgraphSchema;
-	/** Keyed handler functions — keys match sourceKey() output, "*" is catch-all */
+	/** Handler functions — keys must match source names (or "*" for catch-all) */
 	handlers: Record<string, SubgraphHandler>;
 }
-export { sourceKey, SubgraphTable, SubgraphSource, SubgraphSchema, SubgraphHandler, SubgraphDefinition, SubgraphContext, SubgraphColumn, ColumnType };
+export { TxMeta, SubgraphTable, SubgraphSchema, SubgraphHandler, SubgraphFilter, SubgraphDefinition, SubgraphContext, SubgraphColumn, StxTransferFilter, StxMintFilter, StxLockFilter, StxBurnFilter, PrintEventFilter, NftTransferFilter, NftMintFilter, NftBurnFilter, FtTransferFilter, FtMintFilter, FtBurnFilter, ContractDeployFilter, ContractCallFilter, ComputedValue, ColumnType };

package/dist/src/types.js

@@ -1,22 +1,3 @@
-import { createRequire } from "node:module";
-var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
-// src/types.ts
-function sourceKey(source) {
-  if (source.contract) {
-    if (source.function)
-      return `${source.contract}::${source.function}`;
-    if (source.event)
-      return `${source.contract}::${source.event}`;
-    return source.contract;
-  }
-  if (source.type)
-    return source.type;
-  return "*";
-}
-export {
-  sourceKey
-};
-
-//# debugId=8321D6D438D2419C64756E2164756E21
+//# debugId=F2B76011AEAE140064756E2164756E21
 //# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -1,10 +1,9 @@
 {
   "version": 3,
-  "sources": ["../src/types.ts"],
+  "sources": [],
   "sourcesContent": [
-    "/** Supported column types for subgraph schemas */\nexport type ColumnType =\n\t| \"text\"\n\t| \"uint\"\n\t| \"int\"\n\t| \"principal\"\n\t| \"boolean\"\n\t| \"timestamp\"\n\t| \"jsonb\";\n\n/** Column definition in a subgraph table */\nexport interface SubgraphColumn {\n\ttype: ColumnType;\n\tnullable?: boolean;\n\tindexed?: boolean;\n\tsearch?: boolean;\n\tdefault?: string | number | boolean;\n}\n\n/** Table definition within a subgraph schema */\nexport interface SubgraphTable {\n\tcolumns: Record<string, SubgraphColumn>;\n\t/** Composite indexes (each entry is an array of column names) */\n\tindexes?: string[][];\n\t/** Unique key constraints (each entry is an array of column names). Required for upsert. */\n\tuniqueKeys?: string[][];\n}\n\n/** Subgraph schema — maps table names to table definitions */\nexport type SubgraphSchema = Record<string, SubgraphTable>;\n\n/** Source filter for what blockchain data this subgraph processes */\nexport interface SubgraphSource {\n\t/** Contract principal (e.g., SP000...::contract-name). Supports * wildcards. */\n\tcontract?: string;\n\t/** Event name/topic to filter on */\n\tevent?: string;\n\t/** Function name to filter on */\n\tfunction?: string;\n\t/** Transaction type filter (e.g., \"stx_transfer\", \"contract_call\") */\n\ttype?: string;\n\t/** Minimum amount filter (for stx_transfer sources) */\n\tminAmount?: bigint;\n}\n\n/** Context passed to subgraph handlers during event processing */\nexport interface SubgraphContext {\n\tblock: {\n\t\theight: number;\n\t\thash: string;\n\t\ttimestamp: number;\n\t\tburnBlockHeight: number;\n\t};\n\ttx: { txId: string; sender: string; type: string; status: string };\n\tinsert(table: string, row: Record<string, unknown>): void;\n\tupdate(\n\t\ttable: string,\n\t\twhere: Record<string, unknown>,\n\t\tset: Record<string, unknown>,\n\t): void;\n\tupsert(\n\t\ttable: string,\n\t\tkey: Record<string, unknown>,\n\t\trow: Record<string, unknown>,\n\t): void;\n\tdelete(table: string, where: Record<string, unknown>): void;\n\tfindOne(\n\t\ttable: string,\n\t\twhere: Record<string, unknown>,\n\t): Promise<Record<string, unknown> | null>;\n\tfindMany(\n\t\ttable: string,\n\t\twhere: Record<string, unknown>,\n\t): Promise<Record<string, unknown>[]>;\n}\n\n/** Handler function that processes events and writes to the subgraph */\nexport type SubgraphHandler = (\n\tevent: Record<string, unknown>,\n\tctx: SubgraphContext,\n) => Promise<void> | void;\n\n/**\n * Derive the source key used to look up handlers.\n * - { contract: \"SP123.market\", function: \"list\" } → \"SP123.market::list\"\n * - { contract: \"SP123.market\", event: \"sale\" } → \"SP123.market::sale\"\n * - { contract: \"SP123.market\" } → \"SP123.market\"\n * - { type: \"stx_transfer\" } → \"stx_transfer\"\n */\nexport function sourceKey(source: SubgraphSource): string {\n\tif (source.contract) {\n\t\tif (source.function) return `${source.contract}::${source.function}`;\n\t\tif (source.event) return `${source.contract}::${source.event}`;\n\t\treturn source.contract;\n\t}\n\tif (source.type) return source.type;\n\treturn \"*\";\n}\n\n/** Complete subgraph definition */\nexport interface SubgraphDefinition {\n\t/** Unique subgraph name (lowercase, alphanumeric + hyphens) */\n\tname: string;\n\t/** Semantic version */\n\tversion?: string;\n\t/** Human description */\n\tdescription?: string;\n\t/** Block height to start indexing from (default: 1) */\n\tstartBlock?: number;\n\t/** What blockchain data to process — one or more source filters */\n\tsources: SubgraphSource[];\n\t/** Tables in this subgraph */\n\tschema: SubgraphSchema;\n\t/** Keyed handler functions — keys match sourceKey() output, \"*\" is catch-all */\n\thandlers: Record<string, SubgraphHandler>;\n}\n"
   ],
-  "mappings": ";;;;AAyFO,SAAS,SAAS,CAAC,QAAgC;AAAA,EACzD,IAAI,OAAO,UAAU;AAAA,IACpB,IAAI,OAAO;AAAA,MAAU,OAAO,GAAG,OAAO,aAAa,OAAO;AAAA,IAC1D,IAAI,OAAO;AAAA,MAAO,OAAO,GAAG,OAAO,aAAa,OAAO;AAAA,IACvD,OAAO,OAAO;AAAA,EACf;AAAA,EACA,IAAI,OAAO;AAAA,IAAM,OAAO,OAAO;AAAA,EAC/B,OAAO;AAAA;",
-  "debugId": "8321D6D438D2419C64756E2164756E21",
+  "mappings": "",
+  "debugId": "F2B76011AEAE140064756E2164756E21",
   "names": []
 }

package/dist/src/validate.d.ts

@@ -18,19 +18,98 @@ interface SubgraphTable {
 }
 /** Subgraph schema — maps table names to table definitions */
 type SubgraphSchema = Record<string, SubgraphTable>;
-/** Source filter for what blockchain data this subgraph processes */
-interface SubgraphSource {
-	/** Contract principal (e.g., SP000...::contract-name). Supports * wildcards. */
-	contract?: string;
-	/** Event name/topic to filter on */
-	event?: string;
-	/** Function name to filter on */
-	function?: string;
-	/** Transaction type filter (e.g., "stx_transfer", "contract_call") */
-	type?: string;
-	/** Minimum amount filter (for stx_transfer sources) */
+/** STX event filters */
+interface StxTransferFilter {
+	type: "stx_transfer";
+	sender?: string;
+	recipient?: string;
 	minAmount?: bigint;
+	maxAmount?: bigint;
 }
+interface StxMintFilter {
+	type: "stx_mint";
+	recipient?: string;
+	minAmount?: bigint;
+}
+interface StxBurnFilter {
+	type: "stx_burn";
+	sender?: string;
+	minAmount?: bigint;
+}
+interface StxLockFilter {
+	type: "stx_lock";
+	lockedAddress?: string;
+	minAmount?: bigint;
+}
+/** FT event filters */
+interface FtTransferFilter {
+	type: "ft_transfer";
+	assetIdentifier?: string;
+	sender?: string;
+	recipient?: string;
+	minAmount?: bigint;
+}
+interface FtMintFilter {
+	type: "ft_mint";
+	assetIdentifier?: string;
+	recipient?: string;
+	minAmount?: bigint;
+}
+interface FtBurnFilter {
+	type: "ft_burn";
+	assetIdentifier?: string;
+	sender?: string;
+	minAmount?: bigint;
+}
+/** NFT event filters */
+interface NftTransferFilter {
+	type: "nft_transfer";
+	assetIdentifier?: string;
+	sender?: string;
+	recipient?: string;
+}
+interface NftMintFilter {
+	type: "nft_mint";
+	assetIdentifier?: string;
+	recipient?: string;
+}
+interface NftBurnFilter {
+	type: "nft_burn";
+	assetIdentifier?: string;
+	sender?: string;
+}
+/** Contract event filters */
+interface ContractCallFilter {
+	type: "contract_call";
+	contractId?: string;
+	functionName?: string;
+	caller?: string;
+	/** ABI for typed event.args. If omitted, auto-fetched at deploy time. */
+	abi?: Record<string, unknown>;
+}
+interface ContractDeployFilter {
+	type: "contract_deploy";
+	deployer?: string;
+	contractName?: string;
+}
+interface PrintEventFilter {
+	type: "print_event";
+	contractId?: string;
+	topic?: string;
+}
+/** All subgraph filter types — discriminated on `type` */
+type SubgraphFilter = StxTransferFilter | StxMintFilter | StxBurnFilter | StxLockFilter | FtTransferFilter | FtMintFilter | FtBurnFilter | NftTransferFilter | NftMintFilter | NftBurnFilter | ContractCallFilter | ContractDeployFilter | PrintEventFilter;
+/** Transaction metadata available in handlers */
+interface TxMeta {
+	txId: string;
+	sender: string;
+	type: string;
+	status: string;
+	contractId?: string | null;
+	functionName?: string | null;
+}
+/** Value or computed function that receives existing row */
+type ComputedValue<T = unknown> = T | ((existing: Record<string, unknown> | null) => T);
 /** Context passed to subgraph handlers during event processing */
 interface SubgraphContext {
 	block: {
@@ -39,18 +118,29 @@ interface SubgraphContext {
 		timestamp: number
 		burnBlockHeight: number
 	};
-	tx: {
-		txId: string
-		sender: string
-		type: string
-		status: string
-	};
+	tx: TxMeta;
 	insert(table: string, row: Record<string, unknown>): void;
 	update(table: string, where: Record<string, unknown>, set: Record<string, unknown>): void;
 	upsert(table: string, key: Record<string, unknown>, row: Record<string, unknown>): void;
 	delete(table: string, where: Record<string, unknown>): void;
+	/** Partial update — sets only specified fields, preserves others */
+	patch(table: string, where: Record<string, unknown>, set: Record<string, unknown>): void;
+	/** Find-then-merge-or-insert. Values can be functions: (existing) => newValue */
+	patchOrInsert(table: string, key: Record<string, unknown>, row: Record<string, ComputedValue>): Promise<void>;
 	findOne(table: string, where: Record<string, unknown>): Promise<Record<string, unknown> | null>;
 	findMany(table: string, where: Record<string, unknown>): Promise<Record<string, unknown>[]>;
+	/** Format a bigint amount with decimal places */
+	formatUnits(value: bigint, decimals: number): string;
+	/** Count rows matching filter */
+	count(table: string, where?: Record<string, unknown>): Promise<number>;
+	/** Sum a numeric column */
+	sum(table: string, column: string, where?: Record<string, unknown>): Promise<bigint>;
+	/** Min of a numeric column */
+	min(table: string, column: string, where?: Record<string, unknown>): Promise<bigint | null>;
+	/** Max of a numeric column */
+	max(table: string, column: string, where?: Record<string, unknown>): Promise<bigint | null>;
+	/** Count distinct values in a column */
+	countDistinct(table: string, column: string, where?: Record<string, unknown>): Promise<number>;
 }
 /** Handler function that processes events and writes to the subgraph */
 type SubgraphHandler = (event: Record<string, unknown>, ctx: SubgraphContext) => Promise<void> | void;
@@ -64,11 +154,11 @@ interface SubgraphDefinition {
 	description?: string;
 	/** Block height to start indexing from (default: 1) */
 	startBlock?: number;
-	/** What blockchain data to process — one or more source filters */
-	sources: SubgraphSource[];
+	/** Named source filters — keys become handler keys */
+	sources: Record<string, SubgraphFilter>;
 	/** Tables in this subgraph */
 	schema: SubgraphSchema;
-	/** Keyed handler functions — keys match sourceKey() output, "*" is catch-all */
+	/** Handler functions — keys must match source names (or "*" for catch-all) */
 	handlers: Record<string, SubgraphHandler>;
 }
 import { z } from "zod/v4";
@@ -77,10 +167,10 @@ declare const ColumnTypeSchema: z.ZodType<ColumnType>;
 declare const SubgraphColumnSchema: z.ZodType<SubgraphColumn>;
 declare const SubgraphTableSchema: z.ZodType<SubgraphTable>;
 declare const SubgraphSchemaSchema: z.ZodType<Record<string, SubgraphTable>>;
-declare const SubgraphSourceSchema: z.ZodType<SubgraphSource>;
+declare const SubgraphFilterSchema: z.ZodType<SubgraphFilter>;
 declare const SubgraphDefinitionSchema: z.ZodType<SubgraphDefinition>;
 /**
 * Validates a subgraph definition, returning the parsed result or throwing on failure.
 */
 declare function validateSubgraphDefinition(def: unknown): SubgraphDefinition;
-export { validateSubgraphDefinition, SubgraphTableSchema, SubgraphSourceSchema, SubgraphSchemaSchema, SubgraphNameSchema, SubgraphDefinitionSchema, SubgraphColumnSchema, ColumnTypeSchema };
+export { validateSubgraphDefinition, SubgraphTableSchema, SubgraphSchemaSchema, SubgraphNameSchema, SubgraphFilterSchema, SubgraphDefinitionSchema, SubgraphColumnSchema, ColumnTypeSchema };