@secondlayer/subgraphs 3.1.0 → 3.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Ryan Waits
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the “Software”), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/dist/src/index.d.ts

@@ -1,3 +1,4 @@
+import { AbiContract } from "@secondlayer/stacks/clarity";
 /** Supported column types for subgraph schemas */
 type ColumnType = "text" | "uint" | "int" | "principal" | "boolean" | "timestamp" | "jsonb";
 /** Column definition in a subgraph table */
@@ -125,8 +126,13 @@ interface ContractCallFilter {
 	contractId?: string;
 	functionName?: string;
 	caller?: string;
-	/** ABI for typed event.args. If omitted, auto-fetched at deploy time. */
-	abi?: Record<string, unknown>;
+	/**
+	* Contract ABI (pass it `as const`) used to type `event.input` — the named,
+	* decoded function arguments. Dev-provided; serialized into the deployed
+	* definition and used at runtime to decode args by name. Omit to keep
+	* `event.args` as a positional `unknown[]`.
+	*/
+	abi?: AbiContract;
 }
 interface ContractDeployFilter {
 	type: "contract_deploy";
@@ -254,6 +260,7 @@ declare function backfillSubgraph(def: SubgraphDefinition, opts: {
 }): Promise<{
 	processed: number
 }>;
+import { AbiContract as AbiContract2, ExtractFunctionArgs, ExtractFunctionNames } from "@secondlayer/stacks/clarity";
 /** Maps a ColumnType string literal to its TypeScript equivalent */
 type ColumnToTS<T extends string> = T extends "uint" | "int" ? bigint : T extends "text" | "principal" | "timestamp" ? string : T extends "boolean" ? boolean : T extends "jsonb" ? Record<string, unknown> : unknown;
 /** Infer TS type for a single column definition, respecting nullable */
@@ -440,6 +447,18 @@ interface ContractDeployPayload {
 	tx: TxMeta;
 }
 /**
+* Contract-call payload. When the source carries a `const` `abi` and a known
+* `functionName`, `event.input` is the named, typed, decoded arguments
+* (camelCased, via the contract ABI). The positional `event.args` is always
+* present for back-compat. Without an `abi`, the payload is {@link ContractCallEvent}.
+*/
+type ContractCallPayload<F> = F extends {
+	abi: infer A extends AbiContract2
+	functionName: infer N extends string
+} ? N extends ExtractFunctionNames<A> ? ContractCallEvent & {
+	input: ExtractFunctionArgs<A, N>
+} : ContractCallEvent : ContractCallEvent;
+/**
 * Print event typed per topic. When a `print_event` source declares a `prints`
 * map, the payload is a discriminated union keyed by `topic` with `data` typed
 * per topic; otherwise it falls back to the untyped {@link PrintEventPayload}.
@@ -477,7 +496,7 @@ type EventForFilter<F extends SubgraphFilter> = F extends {
 	type: "stx_lock"
 } ? StxLockPayload : F extends {
 	type: "contract_call"
-} ? ContractCallEvent : F extends {
+} ? ContractCallPayload<F> : F extends {
 	type: "contract_deploy"
 } ? ContractDeployPayload : never;
 /** Union of every event payload — the `"*"` catch-all handler receives this. */
@@ -588,4 +607,4 @@ declare function deploySchema(db: AnyDb, def: SubgraphDefinition, handlerPath: s
 	version: string
 	diff?: DeployDiff
 }>;
-export { validateSubgraphDefinition, resumeReindex, reindexSubgraph, pgSchemaName, generateSubgraphSQL, diffSchema, deploySchema, defineSubgraph, backfillSubgraph, WriteRow, WhereInput, TypedSubgraphDefinition, TypedSubgraphContext, TypedHandlers, TxMeta, TableDiff, SystemRow, SubgraphTableClient, SubgraphTable, SubgraphSchema, SubgraphHandler, SubgraphFilter, SubgraphDefinition, SubgraphContext, SubgraphColumn, StxTransferPayload, StxTransferFilter, StxMintPayload, StxMintFilter, StxLockPayload, StxLockFilter, StxBurnPayload, StxBurnFilter, RowValue, ReindexOptions, PrintEventPayload, PrintEventFor, PrintEventFilter, NftTransferPayload, NftTransferFilter, NftMintPayload, NftMintFilter, NftBurnPayload, NftBurnFilter, InferTableRow, InferSubgraphClient, InferColumnType, GeneratedSQL, FtTransferPayload, FtTransferFilter, FtMintPayload, FtMintFilter, FtBurnPayload, FtBurnFilter, FindManyOptions, EventForFilter, ContractDeployPayload, ContractDeployFilter, ContractCallFilter, ContractCallEvent, ComputedValue, ComparisonFilter, ColumnType, ColumnToTS, ColumnDiff, AnyEvent };
+export { validateSubgraphDefinition, resumeReindex, reindexSubgraph, pgSchemaName, generateSubgraphSQL, diffSchema, deploySchema, defineSubgraph, backfillSubgraph, WriteRow, WhereInput, TypedSubgraphDefinition, TypedSubgraphContext, TypedHandlers, TxMeta, TableDiff, SystemRow, SubgraphTableClient, SubgraphTable, SubgraphSchema, SubgraphHandler, SubgraphFilter, SubgraphDefinition, SubgraphContext, SubgraphColumn, StxTransferPayload, StxTransferFilter, StxMintPayload, StxMintFilter, StxLockPayload, StxLockFilter, StxBurnPayload, StxBurnFilter, RowValue, ReindexOptions, PrintEventPayload, PrintEventFor, PrintEventFilter, NftTransferPayload, NftTransferFilter, NftMintPayload, NftMintFilter, NftBurnPayload, NftBurnFilter, InferTableRow, InferSubgraphClient, InferColumnType, GeneratedSQL, FtTransferPayload, FtTransferFilter, FtMintPayload, FtMintFilter, FtBurnPayload, FtBurnFilter, FindManyOptions, EventForFilter, ContractDeployPayload, ContractDeployFilter, ContractCallPayload, ContractCallFilter, ContractCallEvent, ComputedValue, ComparisonFilter, ColumnType, ColumnToTS, ColumnDiff, AnyEvent };

package/dist/src/index.js

@@ -421,6 +421,11 @@ function decodeFunctionArgs(args) {
 // src/runtime/runner.ts
 import { getErrorMessage } from "@secondlayer/shared";
 import { logger as logger2 } from "@secondlayer/shared/logger";
+import {
+  clarityValueToJS,
+  deserializeCV as deserializeCV2,
+  toCamelCase
+} from "@secondlayer/stacks/clarity";
 var DEFAULT_ERROR_THRESHOLD = 50;
 function camelCase(str) {
   return str.replace(/-([a-z0-9])/g, (_, c) => c.toUpperCase());
@@ -475,6 +480,37 @@ function safeBigInt(val) {
   }
   return 0n;
 }
+function buildContractCallInput(filter, tx) {
+  const abi = filter.abi;
+  const fnName = tx.function_name;
+  if (!abi || !fnName)
+    return;
+  const fn = abi.functions?.find((f) => f.name === fnName);
+  if (!fn || !Array.isArray(fn.args))
+    return;
+  let rawArgs = tx.function_args;
+  if (typeof rawArgs === "string") {
+    try {
+      rawArgs = JSON.parse(rawArgs);
+    } catch {
+      return;
+    }
+  }
+  if (!Array.isArray(rawArgs))
+    return;
+  const decodeArg = clarityValueToJS;
+  const input = {};
+  fn.args.forEach((arg, i) => {
+    const hex = rawArgs[i];
+    if (typeof hex !== "string")
+      return;
+    try {
+      const clean = hex.startsWith("0x") ? hex.slice(2) : hex;
+      input[toCamelCase(arg.name)] = decodeArg(arg.type, deserializeCV2(clean));
+    } catch {}
+  });
+  return input;
+}
 function buildEventPayload(filter, tx, event) {
   const txMeta = {
     txId: tx.tx_id,
@@ -488,17 +524,20 @@ function buildEventPayload(filter, tx, event) {
   const decodedResult = decodeRawResult(tx.raw_result);
   if (!event) {
     switch (filter.type) {
-      case "contract_call":
+      case "contract_call": {
+        const input = buildContractCallInput(filter, tx);
         return {
           type: "contract_call",
           contractId: tx.contract_id ?? "",
           functionName: tx.function_name ?? "",
           sender: tx.sender,
           args: decodedArgs,
+          ...input !== undefined ? { input } : {},
           result: decodedResult,
           resultHex: tx.raw_result ?? null,
           tx: txMeta
         };
+      }
       case "contract_deploy":
         return {
           contractId: tx.contract_id ?? "",
@@ -596,7 +635,8 @@ function buildEventPayload(filter, tx, event) {
         tx: txMeta
       };
     }
-    case "contract_call":
+    case "contract_call": {
+      const input = buildContractCallInput(filter, tx);
       return {
         ...decoded,
         type: "contract_call",
@@ -605,10 +645,12 @@ function buildEventPayload(filter, tx, event) {
         functionName: tx.function_name ?? "",
         sender: tx.sender,
         args: decodedArgs,
+        ...input !== undefined ? { input } : {},
         result: decodedResult,
         resultHex: tx.raw_result ?? null,
         tx: txMeta
       };
+    }
     case "contract_deploy":
       return {
         contractId: tx.contract_id ?? "",
@@ -2176,5 +2218,5 @@ export {
   backfillSubgraph
 };
 
-//# debugId=E831E58EC98F118E64756E2164756E21
+//# debugId=E652DFA8BE73568E64756E2164756E21
 //# sourceMappingURL=index.js.map