agentex-creator-sdk 1.0.0

package/dist/packages/contracts/src/indexed-activity.d.ts

@@ -0,0 +1,684 @@
+import { z } from 'zod';
+/**
+ * Shared output shapes of the indexed activity tools (packages/tools `evm.contract-origin`, `evm.address-funding`, `evm.deployer-launches`,
+ * `evm.wallet-activity`) and of the reports that embed them (P02 Deployer Investigator, P03 Wallet Analyst). They live here so report
+ * contracts validate without tool implementations and the two can never drift.
+ */
+export declare const ACTIVITY_TOOL_REFS: Readonly<{
+    readonly origin: "evm.contract-origin@0.1.0";
+    readonly funding: "evm.address-funding@0.1.0";
+    readonly launches: "evm.deployer-launches@0.1.0";
+    readonly wallet: "evm.wallet-activity@0.1.0";
+}>;
+export declare const ACTIVITY_READ_METHODS: readonly ["eth_chainId", "eth_getBlockByNumber", "eth_getCode", "eth_getBalance", "eth_getTransactionReceipt", "alchemy_getAssetTransfers", "alchemy_getTokenBalances", "alchemy_getTokenMetadata", "debug_traceTransaction"];
+export declare const ActivityEvidenceIdSchema: z.ZodString;
+/** Same vocabulary as the tools' `FactSchema`: unknown, unavailable (no source), not-detected (probed and empty) and error are never collapsed. */
+export declare const ActivityFactSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    status: z.ZodLiteral<"observed">;
+    value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+    evidenceIds: z.ZodArray<z.ZodString>;
+    note: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    status: z.ZodEnum<{
+        error: "error";
+        unknown: "unknown";
+        "not-detected": "not-detected";
+        "not-applicable": "not-applicable";
+        unavailable: "unavailable";
+    }>;
+    reason: z.ZodString;
+    evidenceIds: z.ZodArray<z.ZodString>;
+}, z.core.$strict>], "status">;
+export declare const ActivityToolErrorSchema: z.ZodObject<{
+    category: z.ZodString;
+    step: z.ZodString;
+    evidenceId: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+/** `direct-transaction-evidence`: a receipt, archive state or transaction field states it. `heuristic-association`: an inference such as an event naming an address. */
+export declare const ActivityFindingSchema: z.ZodObject<{
+    code: z.ZodString;
+    message: z.ZodString;
+    basis: z.ZodEnum<{
+        "direct-transaction-evidence": "direct-transaction-evidence";
+        "heuristic-association": "heuristic-association";
+        "provider-index-assertion": "provider-index-assertion";
+    }>;
+    evidenceIds: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export declare const ACTIVITY_CATEGORIES: readonly ["external", "internal", "erc20", "erc721", "erc1155"];
+export declare const ActivityCategorySchema: z.ZodEnum<{
+    external: "external";
+    internal: "internal";
+    erc20: "erc20";
+    erc721: "erc721";
+    erc1155: "erc1155";
+}>;
+export declare const ActivityTransferSchema: z.ZodObject<{
+    direction: z.ZodEnum<{
+        out: "out";
+        in: "in";
+    }>;
+    category: z.ZodEnum<{
+        external: "external";
+        internal: "internal";
+        erc20: "erc20";
+        erc721: "erc721";
+        erc1155: "erc1155";
+    }>;
+    blockNumber: z.ZodString;
+    blockTimestamp: z.ZodNullable<z.ZodString>;
+    transactionHash: z.ZodString;
+    uniqueId: z.ZodString;
+    from: z.ZodString;
+    to: z.ZodNullable<z.ZodString>;
+    asset: z.ZodNullable<z.ZodString>;
+    contract: z.ZodNullable<z.ZodString>;
+    tokenId: z.ZodNullable<z.ZodString>;
+    valueAtomic: z.ZodNullable<z.ZodString>;
+    decimals: z.ZodNullable<z.ZodNumber>;
+    valueFormatted: z.ZodNullable<z.ZodString>;
+    decimalsSource: z.ZodEnum<{
+        "not-applicable": "not-applicable";
+        "native-18": "native-18";
+        "provider-raw-contract": "provider-raw-contract";
+        "not-reported": "not-reported";
+    }>;
+    selfTransfer: z.ZodBoolean;
+    evidenceId: z.ZodString;
+}, z.core.$strict>;
+export declare const TransferPageStatusSchema: z.ZodEnum<{
+    unavailable: "unavailable";
+    "provider-exhausted": "provider-exhausted";
+    "truncated-with-cursor": "truncated-with-cursor";
+    "not-read-call-bound": "not-read-call-bound";
+}>;
+export declare const TransferPageSchema: z.ZodObject<{
+    direction: z.ZodEnum<{
+        out: "out";
+        in: "in";
+    }>;
+    index: z.ZodNumber;
+    returned: z.ZodNumber;
+    nextPageKey: z.ZodNullable<z.ZodString>;
+    status: z.ZodEnum<{
+        unavailable: "unavailable";
+        "provider-exhausted": "provider-exhausted";
+        "truncated-with-cursor": "truncated-with-cursor";
+        "not-read-call-bound": "not-read-call-bound";
+    }>;
+    evidenceId: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export declare const ContractOriginBodySchema: z.ZodObject<{
+    contract: z.ZodString;
+    chain: z.ZodString;
+    codeAtSnapshot: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        status: z.ZodLiteral<"observed">;
+        value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+        evidenceIds: z.ZodArray<z.ZodString>;
+        note: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        status: z.ZodEnum<{
+            error: "error";
+            unknown: "unknown";
+            "not-detected": "not-detected";
+            "not-applicable": "not-applicable";
+            unavailable: "unavailable";
+        }>;
+        reason: z.ZodString;
+        evidenceIds: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>], "status">;
+    creation: z.ZodObject<{
+        status: z.ZodEnum<{
+            unavailable: "unavailable";
+            "confirmed-by-receipt": "confirmed-by-receipt";
+            "block-located": "block-located";
+            "bounded-range": "bounded-range";
+            "not-located": "not-located";
+            "no-code-at-snapshot": "no-code-at-snapshot";
+        }>;
+        blockNumber: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            status: z.ZodLiteral<"observed">;
+            value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+            evidenceIds: z.ZodArray<z.ZodString>;
+            note: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            status: z.ZodEnum<{
+                error: "error";
+                unknown: "unknown";
+                "not-detected": "not-detected";
+                "not-applicable": "not-applicable";
+                unavailable: "unavailable";
+            }>;
+            reason: z.ZodString;
+            evidenceIds: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>], "status">;
+        transactionHash: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            status: z.ZodLiteral<"observed">;
+            value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+            evidenceIds: z.ZodArray<z.ZodString>;
+            note: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            status: z.ZodEnum<{
+                error: "error";
+                unknown: "unknown";
+                "not-detected": "not-detected";
+                "not-applicable": "not-applicable";
+                unavailable: "unavailable";
+            }>;
+            reason: z.ZodString;
+            evidenceIds: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>], "status">;
+        transactionBasis: z.ZodEnum<{
+            "receipt-contract-address": "receipt-contract-address";
+            "trace-verified-creation": "trace-verified-creation";
+            "first-indexed-activity-in-creation-block": "first-indexed-activity-in-creation-block";
+            "not-established": "not-established";
+        }>;
+        createdBy: z.ZodEnum<{
+            "not-established": "not-established";
+            "top-level-transaction": "top-level-transaction";
+            "contract-call-in-transaction": "contract-call-in-transaction";
+        }>;
+        anchor: z.ZodObject<{
+            source: z.ZodEnum<{
+                none: "none";
+                "supplied-transaction": "supplied-transaction";
+                "first-indexed-token-transfer": "first-indexed-token-transfer";
+                "first-indexed-inbound-call": "first-indexed-inbound-call";
+            }>;
+            transactionHash: z.ZodNullable<z.ZodString>;
+            blockNumber: z.ZodNullable<z.ZodString>;
+            evidenceIds: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>;
+        range: z.ZodNullable<z.ZodObject<{
+            from: z.ZodString;
+            to: z.ZodString;
+        }, z.core.$strict>>;
+        probes: z.ZodNumber;
+        codeBeforeCreation: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            status: z.ZodLiteral<"observed">;
+            value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+            evidenceIds: z.ZodArray<z.ZodString>;
+            note: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            status: z.ZodEnum<{
+                error: "error";
+                unknown: "unknown";
+                "not-detected": "not-detected";
+                "not-applicable": "not-applicable";
+                unavailable: "unavailable";
+            }>;
+            reason: z.ZodString;
+            evidenceIds: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>], "status">;
+        codeAtCreationBlock: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            status: z.ZodLiteral<"observed">;
+            value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+            evidenceIds: z.ZodArray<z.ZodString>;
+            note: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            status: z.ZodEnum<{
+                error: "error";
+                unknown: "unknown";
+                "not-detected": "not-detected";
+                "not-applicable": "not-applicable";
+                unavailable: "unavailable";
+            }>;
+            reason: z.ZodString;
+            evidenceIds: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>], "status">;
+    }, z.core.$strict>;
+    initiator: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        status: z.ZodLiteral<"observed">;
+        value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+        evidenceIds: z.ZodArray<z.ZodString>;
+        note: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        status: z.ZodEnum<{
+            error: "error";
+            unknown: "unknown";
+            "not-detected": "not-detected";
+            "not-applicable": "not-applicable";
+            unavailable: "unavailable";
+        }>;
+        reason: z.ZodString;
+        evidenceIds: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>], "status">;
+    entryTarget: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        status: z.ZodLiteral<"observed">;
+        value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+        evidenceIds: z.ZodArray<z.ZodString>;
+        note: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        status: z.ZodEnum<{
+            error: "error";
+            unknown: "unknown";
+            "not-detected": "not-detected";
+            "not-applicable": "not-applicable";
+            unavailable: "unavailable";
+        }>;
+        reason: z.ZodString;
+        evidenceIds: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>], "status">;
+    factoryEventEmitters: z.ZodArray<z.ZodObject<{
+        address: z.ZodString;
+        label: z.ZodNullable<z.ZodString>;
+        evidenceIds: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    roles: z.ZodArray<z.ZodObject<{
+        address: z.ZodString;
+        role: z.ZodEnum<{
+            "deployment-transaction-sender": "deployment-transaction-sender";
+            "creation-entry-target": "creation-entry-target";
+            "factory-event-emitter": "factory-event-emitter";
+            "erc4337-entrypoint": "erc4337-entrypoint";
+            "trace-verified-creator": "trace-verified-creator";
+            "creation-candidate": "creation-candidate";
+        }>;
+        isPerson: z.ZodLiteral<false>;
+        label: z.ZodNullable<z.ZodString>;
+        basis: z.ZodString;
+        evidenceIds: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    findings: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        basis: z.ZodEnum<{
+            "direct-transaction-evidence": "direct-transaction-evidence";
+            "heuristic-association": "heuristic-association";
+            "provider-index-assertion": "provider-index-assertion";
+        }>;
+        evidenceIds: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    errors: z.ZodArray<z.ZodObject<{
+        category: z.ZodString;
+        step: z.ZodString;
+        evidenceId: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const AddressFundingBodySchema: z.ZodObject<{
+    address: z.ZodString;
+    chain: z.ZodString;
+    transfers: z.ZodArray<z.ZodObject<{
+        direction: z.ZodEnum<{
+            out: "out";
+            in: "in";
+        }>;
+        category: z.ZodEnum<{
+            external: "external";
+            internal: "internal";
+            erc20: "erc20";
+            erc721: "erc721";
+            erc1155: "erc1155";
+        }>;
+        blockNumber: z.ZodString;
+        blockTimestamp: z.ZodNullable<z.ZodString>;
+        transactionHash: z.ZodString;
+        uniqueId: z.ZodString;
+        from: z.ZodString;
+        to: z.ZodNullable<z.ZodString>;
+        asset: z.ZodNullable<z.ZodString>;
+        contract: z.ZodNullable<z.ZodString>;
+        tokenId: z.ZodNullable<z.ZodString>;
+        valueAtomic: z.ZodNullable<z.ZodString>;
+        decimals: z.ZodNullable<z.ZodNumber>;
+        valueFormatted: z.ZodNullable<z.ZodString>;
+        decimalsSource: z.ZodEnum<{
+            "not-applicable": "not-applicable";
+            "native-18": "native-18";
+            "provider-raw-contract": "provider-raw-contract";
+            "not-reported": "not-reported";
+        }>;
+        selfTransfer: z.ZodBoolean;
+        evidenceId: z.ZodString;
+    }, z.core.$strict>>;
+    funders: z.ZodArray<z.ZodObject<{
+        funder: z.ZodString;
+        label: z.ZodNullable<z.ZodString>;
+        isPerson: z.ZodLiteral<false>;
+        transfers: z.ZodNumber;
+        nativeAtomic: z.ZodString;
+        nativeFormatted: z.ZodString;
+        tokenTransfers: z.ZodNumber;
+        firstBlock: z.ZodString;
+        firstTransactionHash: z.ZodString;
+        evidenceIds: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    pages: z.ZodArray<z.ZodObject<{
+        direction: z.ZodEnum<{
+            out: "out";
+            in: "in";
+        }>;
+        index: z.ZodNumber;
+        returned: z.ZodNumber;
+        nextPageKey: z.ZodNullable<z.ZodString>;
+        status: z.ZodEnum<{
+            unavailable: "unavailable";
+            "provider-exhausted": "provider-exhausted";
+            "truncated-with-cursor": "truncated-with-cursor";
+            "not-read-call-bound": "not-read-call-bound";
+        }>;
+        evidenceId: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+    coverage: z.ZodObject<{
+        order: z.ZodLiteral<"oldest-first">;
+        categories: z.ZodArray<z.ZodEnum<{
+            external: "external";
+            internal: "internal";
+            erc20: "erc20";
+            erc721: "erc721";
+            erc1155: "erc1155";
+        }>>;
+        exhausted: z.ZodBoolean;
+        nextPageKey: z.ZodNullable<z.ZodString>;
+        completeness: z.ZodLiteral<"provider-index-claim">;
+    }, z.core.$strict>;
+    interpretation: z.ZodLiteral<"observed-transfer-not-ownership">;
+    findings: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        basis: z.ZodEnum<{
+            "direct-transaction-evidence": "direct-transaction-evidence";
+            "heuristic-association": "heuristic-association";
+            "provider-index-assertion": "provider-index-assertion";
+        }>;
+        evidenceIds: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    errors: z.ZodArray<z.ZodObject<{
+        category: z.ZodString;
+        step: z.ZodString;
+        evidenceId: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const DeployerLaunchesBodySchema: z.ZodObject<{
+    deployer: z.ZodString;
+    chain: z.ZodString;
+    window: z.ZodObject<{
+        fromBlock: z.ZodString;
+        toBlock: z.ZodString;
+    }, z.core.$strict>;
+    deployments: z.ZodArray<z.ZodObject<{
+        transactionHash: z.ZodString;
+        blockNumber: z.ZodString;
+        blockTimestamp: z.ZodNullable<z.ZodString>;
+        contractAddress: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            status: z.ZodLiteral<"observed">;
+            value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+            evidenceIds: z.ZodArray<z.ZodString>;
+            note: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            status: z.ZodEnum<{
+                error: "error";
+                unknown: "unknown";
+                "not-detected": "not-detected";
+                "not-applicable": "not-applicable";
+                unavailable: "unavailable";
+            }>;
+            reason: z.ZodString;
+            evidenceIds: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>], "status">;
+        succeeded: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            status: z.ZodLiteral<"observed">;
+            value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+            evidenceIds: z.ZodArray<z.ZodString>;
+            note: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            status: z.ZodEnum<{
+                error: "error";
+                unknown: "unknown";
+                "not-detected": "not-detected";
+                "not-applicable": "not-applicable";
+                unavailable: "unavailable";
+            }>;
+            reason: z.ZodString;
+            evidenceIds: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>], "status">;
+        isSubject: z.ZodBoolean;
+        evidenceIds: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    pages: z.ZodArray<z.ZodObject<{
+        direction: z.ZodEnum<{
+            out: "out";
+            in: "in";
+        }>;
+        index: z.ZodNumber;
+        returned: z.ZodNumber;
+        nextPageKey: z.ZodNullable<z.ZodString>;
+        status: z.ZodEnum<{
+            unavailable: "unavailable";
+            "provider-exhausted": "provider-exhausted";
+            "truncated-with-cursor": "truncated-with-cursor";
+            "not-read-call-bound": "not-read-call-bound";
+        }>;
+        evidenceId: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+    coverage: z.ZodObject<{
+        transactionsExamined: z.ZodNumber;
+        creationTransactions: z.ZodNumber;
+        receiptsRead: z.ZodNumber;
+        exhausted: z.ZodBoolean;
+        nextPageKey: z.ZodNullable<z.ZodString>;
+        completeness: z.ZodLiteral<"provider-index-claim">;
+    }, z.core.$strict>;
+    interpretation: z.ZodLiteral<"same-sender-deployments-not-common-control">;
+    findings: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        basis: z.ZodEnum<{
+            "direct-transaction-evidence": "direct-transaction-evidence";
+            "heuristic-association": "heuristic-association";
+            "provider-index-assertion": "provider-index-assertion";
+        }>;
+        evidenceIds: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    errors: z.ZodArray<z.ZodObject<{
+        category: z.ZodString;
+        step: z.ZodString;
+        evidenceId: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const WalletActivityBodySchema: z.ZodObject<{
+    wallet: z.ZodString;
+    chain: z.ZodString;
+    window: z.ZodObject<{
+        fromBlock: z.ZodString;
+        toBlock: z.ZodString;
+    }, z.core.$strict>;
+    nativeBalance: z.ZodObject<{
+        balanceAtomic: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            status: z.ZodLiteral<"observed">;
+            value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+            evidenceIds: z.ZodArray<z.ZodString>;
+            note: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            status: z.ZodEnum<{
+                error: "error";
+                unknown: "unknown";
+                "not-detected": "not-detected";
+                "not-applicable": "not-applicable";
+                unavailable: "unavailable";
+            }>;
+            reason: z.ZodString;
+            evidenceIds: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>], "status">;
+        balanceFormatted: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+    transfers: z.ZodArray<z.ZodObject<{
+        direction: z.ZodEnum<{
+            out: "out";
+            in: "in";
+        }>;
+        category: z.ZodEnum<{
+            external: "external";
+            internal: "internal";
+            erc20: "erc20";
+            erc721: "erc721";
+            erc1155: "erc1155";
+        }>;
+        blockNumber: z.ZodString;
+        blockTimestamp: z.ZodNullable<z.ZodString>;
+        transactionHash: z.ZodString;
+        uniqueId: z.ZodString;
+        from: z.ZodString;
+        to: z.ZodNullable<z.ZodString>;
+        asset: z.ZodNullable<z.ZodString>;
+        contract: z.ZodNullable<z.ZodString>;
+        tokenId: z.ZodNullable<z.ZodString>;
+        valueAtomic: z.ZodNullable<z.ZodString>;
+        decimals: z.ZodNullable<z.ZodNumber>;
+        valueFormatted: z.ZodNullable<z.ZodString>;
+        decimalsSource: z.ZodEnum<{
+            "not-applicable": "not-applicable";
+            "native-18": "native-18";
+            "provider-raw-contract": "provider-raw-contract";
+            "not-reported": "not-reported";
+        }>;
+        selfTransfer: z.ZodBoolean;
+        evidenceId: z.ZodString;
+    }, z.core.$strict>>;
+    pages: z.ZodArray<z.ZodObject<{
+        direction: z.ZodEnum<{
+            out: "out";
+            in: "in";
+        }>;
+        index: z.ZodNumber;
+        returned: z.ZodNumber;
+        nextPageKey: z.ZodNullable<z.ZodString>;
+        status: z.ZodEnum<{
+            unavailable: "unavailable";
+            "provider-exhausted": "provider-exhausted";
+            "truncated-with-cursor": "truncated-with-cursor";
+            "not-read-call-bound": "not-read-call-bound";
+        }>;
+        evidenceId: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+    flows: z.ZodArray<z.ZodObject<{
+        asset: z.ZodString;
+        contract: z.ZodNullable<z.ZodString>;
+        category: z.ZodEnum<{
+            external: "external";
+            internal: "internal";
+            erc20: "erc20";
+            erc721: "erc721";
+            erc1155: "erc1155";
+        }>;
+        symbol: z.ZodNullable<z.ZodString>;
+        decimals: z.ZodNullable<z.ZodNumber>;
+        inboundAtomic: z.ZodString;
+        outboundAtomic: z.ZodString;
+        inboundFormatted: z.ZodNullable<z.ZodString>;
+        outboundFormatted: z.ZodNullable<z.ZodString>;
+        transfersIn: z.ZodNumber;
+        transfersOut: z.ZodNumber;
+        selfTransfers: z.ZodNumber;
+        unquantifiedTransfers: z.ZodNumber;
+    }, z.core.$strict>>;
+    transactions: z.ZodArray<z.ZodObject<{
+        transactionHash: z.ZodString;
+        blockNumber: z.ZodString;
+        blockTimestamp: z.ZodNullable<z.ZodString>;
+        legsIn: z.ZodNumber;
+        legsOut: z.ZodNumber;
+        classification: z.ZodEnum<{
+            "inbound-only": "inbound-only";
+            "outbound-only": "outbound-only";
+            "self-transfer": "self-transfer";
+            "in-and-out-same-transaction": "in-and-out-same-transaction";
+        }>;
+        note: z.ZodString;
+    }, z.core.$strict>>;
+    tokenBalances: z.ZodObject<{
+        status: z.ZodEnum<{
+            observed: "observed";
+            unavailable: "unavailable";
+            "not-read": "not-read";
+        }>;
+        finality: z.ZodLiteral<"provider-latest-not-pinned">;
+        balances: z.ZodArray<z.ZodObject<{
+            contract: z.ZodString;
+            balanceAtomic: z.ZodNullable<z.ZodString>;
+            symbol: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                status: z.ZodLiteral<"observed">;
+                value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+                evidenceIds: z.ZodArray<z.ZodString>;
+                note: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                status: z.ZodEnum<{
+                    error: "error";
+                    unknown: "unknown";
+                    "not-detected": "not-detected";
+                    "not-applicable": "not-applicable";
+                    unavailable: "unavailable";
+                }>;
+                reason: z.ZodString;
+                evidenceIds: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>], "status">;
+            decimals: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                status: z.ZodLiteral<"observed">;
+                value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+                evidenceIds: z.ZodArray<z.ZodString>;
+                note: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                status: z.ZodEnum<{
+                    error: "error";
+                    unknown: "unknown";
+                    "not-detected": "not-detected";
+                    "not-applicable": "not-applicable";
+                    unavailable: "unavailable";
+                }>;
+                reason: z.ZodString;
+                evidenceIds: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>], "status">;
+            balanceFormatted: z.ZodNullable<z.ZodString>;
+            evidenceIds: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>>;
+        nextPageKey: z.ZodNullable<z.ZodString>;
+        evidenceIds: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+    coverage: z.ZodObject<{
+        order: z.ZodEnum<{
+            "oldest-first": "oldest-first";
+            "newest-first": "newest-first";
+        }>;
+        categories: z.ZodArray<z.ZodEnum<{
+            external: "external";
+            internal: "internal";
+            erc20: "erc20";
+            erc721: "erc721";
+            erc1155: "erc1155";
+        }>>;
+        inbound: z.ZodEnum<{
+            unavailable: "unavailable";
+            "provider-exhausted": "provider-exhausted";
+            "truncated-with-cursor": "truncated-with-cursor";
+            "not-read-call-bound": "not-read-call-bound";
+        }>;
+        outbound: z.ZodEnum<{
+            unavailable: "unavailable";
+            "provider-exhausted": "provider-exhausted";
+            "truncated-with-cursor": "truncated-with-cursor";
+            "not-read-call-bound": "not-read-call-bound";
+        }>;
+        completeness: z.ZodLiteral<"provider-index-claim">;
+    }, z.core.$strict>;
+    findings: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        basis: z.ZodEnum<{
+            "direct-transaction-evidence": "direct-transaction-evidence";
+            "heuristic-association": "heuristic-association";
+            "provider-index-assertion": "provider-index-assertion";
+        }>;
+        evidenceIds: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    labelChecks: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        evidenceIds: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    errors: z.ZodArray<z.ZodObject<{
+        category: z.ZodString;
+        step: z.ZodString;
+        evidenceId: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;