@clawnch/clawncher-sdk 0.3.2 → 0.3.4

package/dist/herd-types.d.ts

@@ -0,0 +1,479 @@
+/**
+ * Herd Integration Types
+ *
+ * Rich TypeScript interfaces for composed results that combine
+ * Herd's on-chain intelligence with Clawncher's domain-specific data.
+ *
+ * These are NOT 1:1 mirrors of Herd's raw responses. Each type is
+ * designed to answer specific questions agents and developers have
+ * when building on-chain.
+ */
+import type { Address } from 'viem';
+export type HerdBlockchain = 'ethereum' | 'base';
+export interface HerdConfig {
+    /** Herd MCP server URL (default: https://mcp.herd.eco/v1) */
+    mcpUrl?: string;
+    /** Access token for Herd API */
+    accessToken?: string;
+    /** Default blockchain (default: 'base') */
+    blockchain?: HerdBlockchain;
+    /** Cache TTL overrides in seconds */
+    cacheTtl?: Partial<HerdCacheTtl>;
+    /** Timeout for MCP calls in ms (default: 30000) */
+    timeout?: number;
+}
+export interface HerdCacheTtl {
+    contractMetadata: number;
+    transactionData: number;
+    walletOverview: number;
+    tokenActivity: number;
+    bookmarks: number;
+}
+export declare const DEFAULT_CACHE_TTL: HerdCacheTtl;
+export interface ContractProfile {
+    /** The contract address */
+    address: Address;
+    /** Which chain */
+    blockchain: HerdBlockchain;
+    /** Contract name (from verified source or Herd label) */
+    name: string | null;
+    /** Whether source code is verified */
+    verified: boolean;
+    /** Compiler version */
+    compiler: string | null;
+    /** Protocol label if known (e.g. "Uniswap", "Circle") */
+    protocol: string | null;
+    /** ABI summary — functions grouped by type */
+    functions: ContractFunction[];
+    /** Events defined in the contract */
+    events: ContractEvent[];
+    /** Proxy info (null if not a proxy) */
+    proxy: ProxyInfo | null;
+    /** Token data (null if not a token) */
+    token: TokenData | null;
+    /** Clawncher-specific data (null if not a Clawncher token) */
+    clawncher: ClawncherTokenOverlay | null;
+    /** Security flags from code analysis */
+    securityFlags: SecurityFlag[];
+    /** Raw Herd response (for debugging / advanced use) */
+    _raw?: unknown;
+}
+export interface ContractFunction {
+    name: string;
+    type: 'read' | 'write';
+    /** Herd's LLM-generated description */
+    description: string | null;
+    /** 4-byte selector */
+    selector: string;
+    inputs: AbiParam[];
+    outputs: AbiParam[];
+}
+export interface ContractEvent {
+    name: string;
+    description: string | null;
+    signature: string;
+    inputs: AbiParam[];
+}
+export interface AbiParam {
+    name: string;
+    type: string;
+    indexed?: boolean;
+}
+export interface ProxyInfo {
+    proxyType: string;
+    currentImplementation: Address;
+    previousImplementations: ImplementationVersion[];
+}
+export interface ImplementationVersion {
+    address: Address;
+    /** Block number at which this became the active implementation */
+    upgradedAtBlock?: number;
+}
+export interface TokenData {
+    symbol: string;
+    decimals: number;
+    /** Price in USD (from CoinGecko via Herd) */
+    priceUsd: number | null;
+    /** 24h volume in USD */
+    volume24h: number | null;
+    /** Market cap in USD */
+    marketCap: number | null;
+    /** Number of holders */
+    holders: number | null;
+}
+/** Overlay data when the contract is a Clawncher-deployed token */
+export interface ClawncherTokenOverlay {
+    /** Fee locker claimable amounts */
+    feesWeth: string;
+    feesToken: string;
+    /** Vault allocation (if exists) */
+    vaultStatus: 'locked' | 'vesting' | 'unlocked' | 'none';
+    vaultPercentVested: number | null;
+    /** MEV protection settings */
+    mevProtection: boolean;
+    mevMaxBps: number | null;
+    /** Launch metadata */
+    launchedAt: string | null;
+    agent: string | null;
+}
+export type SecuritySeverity = 'critical' | 'high' | 'medium' | 'low' | 'info';
+export interface SecurityFlag {
+    severity: SecuritySeverity;
+    category: string;
+    description: string;
+    /** Source code location (if available) */
+    location: string | null;
+}
+export interface TokenAuditReport {
+    /** Overall risk score 0-100 (0 = safest, 100 = most risky) */
+    riskScore: number;
+    /** Human-readable risk level */
+    riskLevel: 'safe' | 'low' | 'medium' | 'high' | 'critical';
+    /** The token contract profile */
+    contract: ContractProfile;
+    /** All findings from code analysis */
+    findings: SecurityFlag[];
+    /** Summary of what was checked */
+    checksPerformed: string[];
+    /** Whether the contract is upgradeable */
+    isUpgradeable: boolean;
+    /** Whether the contract has owner/admin controls */
+    hasOwnerControls: boolean;
+    /** Whether tokens can be minted after deployment */
+    hasMintFunction: boolean;
+    /** Whether transfers can be paused/blocked */
+    hasPauseOrBlacklist: boolean;
+    /** Timestamp of the audit */
+    auditedAt: string;
+}
+export interface TransactionProfile {
+    /** Transaction hash */
+    hash: string;
+    /** Which chain */
+    blockchain: HerdBlockchain;
+    /** Block number */
+    blockNumber: number;
+    /** Timestamp */
+    timestamp: string;
+    /** Whether the transaction succeeded */
+    success: boolean;
+    /** Revert reason (if failed) */
+    revertReason: string | null;
+    /** The top-level function called */
+    functionCalled: string | null;
+    /** Decoded function arguments */
+    decodedArgs: Record<string, unknown> | null;
+    /** All balance changes (token movements) */
+    balanceChanges: BalanceChange[];
+    /** Internal call trace tree */
+    traces: TransactionTrace[];
+    /** Decoded event logs */
+    events: TransactionEvent[];
+    /** Gas used and cost */
+    gas: GasInfo;
+    /** Clawncher-specific annotations */
+    clawncher: ClawncherTxAnnotation | null;
+    /** Raw Herd response */
+    _raw?: unknown;
+}
+export interface BalanceChange {
+    token: string;
+    tokenAddress: Address;
+    from: Address;
+    to: Address;
+    amount: string;
+    /** USD value at time of transaction (if available) */
+    usdValue: string | null;
+}
+export interface TransactionTrace {
+    depth: number;
+    from: Address;
+    to: Address;
+    functionName: string | null;
+    /** Human-readable summary */
+    summary: string | null;
+    value: string;
+    gasUsed: number;
+    children: TransactionTrace[];
+}
+export interface TransactionEvent {
+    contract: Address;
+    contractName: string | null;
+    eventName: string;
+    args: Record<string, unknown>;
+}
+export interface GasInfo {
+    gasUsed: number;
+    gasPrice: string;
+    /** Total cost in ETH */
+    costEth: string;
+    /** Total cost in USD (if ETH price available) */
+    costUsd: string | null;
+}
+/** Annotations when the tx interacts with Clawncher contracts */
+export interface ClawncherTxAnnotation {
+    /** What type of Clawncher operation this is */
+    operationType: 'token_deploy' | 'fee_claim' | 'vault_claim' | 'swap' | 'liquidity_add' | 'liquidity_remove' | 'agent_register' | 'permit2_approve' | 'other';
+    /** Human-readable description */
+    description: string;
+    /** The Clawncher token involved (if applicable) */
+    tokenAddress: Address | null;
+}
+export type WalletType = 'eoa' | 'erc4337' | 'erc7702' | 'multisig' | 'contract';
+export interface WalletProfile {
+    /** Wallet address */
+    address: Address;
+    /** Which chain */
+    blockchain: HerdBlockchain;
+    /** Detected wallet type */
+    walletType: WalletType;
+    /** Token holdings with USD values */
+    holdings: WalletHolding[];
+    /** Total portfolio value in USD */
+    totalValueUsd: number | null;
+    /** Activity summary */
+    activity: WalletActivity;
+    /** Multisig details (null if not a multisig) */
+    multisig: MultisigInfo | null;
+    /** Clawncher-specific data */
+    clawncher: ClawncherWalletOverlay | null;
+    /** Raw Herd response */
+    _raw?: unknown;
+}
+export interface WalletHolding {
+    token: string;
+    tokenAddress: Address;
+    balance: string;
+    usdValue: number | null;
+}
+export interface WalletActivity {
+    transactionCount: number;
+    contractsDeployed: number;
+    firstTransaction: string | null;
+    /** Top contracts this wallet interacts with */
+    topContracts: Array<{
+        address: Address;
+        name: string | null;
+        callCount: number;
+    }>;
+}
+export interface MultisigInfo {
+    threshold: number;
+    signers: Address[];
+    pendingTransactions: number;
+}
+/** Overlay data for wallets that hold Clawncher tokens */
+export interface ClawncherWalletOverlay {
+    /** Clawncher tokens held */
+    tokenPositions: Array<{
+        tokenAddress: Address;
+        symbol: string;
+        balance: string;
+        /** Claimable fees for this wallet on this token */
+        claimableFees: {
+            weth: string;
+            token: string;
+        } | null;
+    }>;
+    /** Whether this wallet is a registered Clawncher agent */
+    isRegisteredAgent: boolean;
+}
+export interface ContractRelationship {
+    /** The contract being analyzed */
+    contract: Address;
+    contractName: string | null;
+    blockchain: HerdBlockchain;
+    /** Contracts that call this contract */
+    callers: RelatedContract[];
+    /** Contracts that this contract calls */
+    callees: RelatedContract[];
+    /** Contracts deployed by this address */
+    deployed: RelatedContract[];
+    /** Which of these are known Clawncher contracts */
+    clawncherContracts: Address[];
+}
+export interface RelatedContract {
+    address: Address;
+    name: string | null;
+    protocol: string | null;
+    /** Functions called between the two contracts */
+    functions: string[];
+    /** Call count (approximate) */
+    callCount: number;
+    /** Whether this is a known Clawncher contract */
+    isClawncher: boolean;
+}
+export interface TokenFlowReport {
+    holder: Address;
+    token: Address;
+    tokenSymbol: string;
+    blockchain: HerdBlockchain;
+    /** Current balance */
+    currentBalance: string;
+    /** Transfer history */
+    transfers: TokenTransfer[];
+    /** Annotated with known contract labels */
+    annotations: TokenFlowAnnotation[];
+}
+export interface TokenTransfer {
+    txHash: string;
+    timestamp: string;
+    direction: 'in' | 'out';
+    amount: string;
+    counterparty: Address;
+    counterpartyName: string | null;
+    /** USD value at time of transfer */
+    usdValue: string | null;
+}
+export interface TokenFlowAnnotation {
+    /** Which transfer(s) this annotation applies to */
+    transferIndices: number[];
+    /** What we know about this flow */
+    label: string;
+}
+export interface VersionDiff {
+    contract: Address;
+    blockchain: HerdBlockchain;
+    /** Previous implementation */
+    previousVersion: Address;
+    /** Current implementation */
+    currentVersion: Address;
+    /** Structured diff summary */
+    changes: VersionChange[];
+    /** Raw diff text */
+    rawDiff: string | null;
+}
+export interface VersionChange {
+    type: 'added' | 'removed' | 'modified';
+    /** Function or variable name */
+    name: string;
+    description: string;
+}
+export interface SwapValidation {
+    tokenIn: Address;
+    tokenOut: Address;
+    amountIn: string;
+    blockchain: HerdBlockchain;
+    /** Our quote from UniswapQuoter */
+    ourQuote: {
+        amountOut: string;
+        priceImpact: string;
+    } | null;
+    /** Historical data from recent swaps (via Herd) */
+    historicalSwaps: Array<{
+        txHash: string;
+        timestamp: string;
+        amountIn: string;
+        amountOut: string;
+        effectiveRate: string;
+        gasUsed: number;
+    }>;
+    /** Comparison */
+    analysis: {
+        /** Whether our quote is within expected range */
+        quoteReasonable: boolean;
+        /** Deviation from median historical rate */
+        deviationPercent: number | null;
+        /** Warnings */
+        warnings: string[];
+        /** Whether we recommend proceeding */
+        recommendation: 'proceed' | 'caution' | 'abort';
+    };
+}
+export interface FeeClaimValidation {
+    tokenAddress: Address;
+    blockchain: HerdBlockchain;
+    /** Our estimate from ClawnchReader */
+    ourEstimate: {
+        wethAvailable: string;
+        tokenAvailable: string;
+    } | null;
+    /** Historical claim data from Herd */
+    historicalClaims: Array<{
+        txHash: string;
+        timestamp: string;
+        claimer: Address;
+        wethReceived: string;
+        tokenReceived: string;
+        gasCostEth: string;
+    }>;
+    /** Analysis */
+    analysis: {
+        /** Whether our estimate matches historical outcomes */
+        estimateReliable: boolean;
+        /** Average gas cost of recent claims */
+        avgGasCostEth: string | null;
+        /** Net profit after gas for our estimated fees */
+        estimatedNetProfitEth: string | null;
+        /** Warnings */
+        warnings: string[];
+    };
+}
+export interface CounterpartyProfile {
+    /** The wallet being profiled */
+    wallet: WalletProfile;
+    /** Age of the wallet */
+    walletAge: string | null;
+    /** Contracts deployed by this wallet */
+    deployedContracts: Array<{
+        address: Address;
+        name: string | null;
+        verified: boolean;
+    }>;
+    /** Risk assessment */
+    riskAssessment: {
+        /** Overall trust level */
+        trustLevel: 'established' | 'moderate' | 'new' | 'suspicious';
+        /** Factors that inform the assessment */
+        factors: string[];
+    };
+}
+export type BookmarkType = 'contract' | 'wallet' | 'transaction';
+export interface Bookmark {
+    objectType: BookmarkType;
+    objectId: string;
+    blockchain: HerdBlockchain | null;
+    label: string | null;
+}
+/** A HAL expression is a JSON array representing the DSL */
+export type HalExpression = unknown[];
+export interface HalSimulationResult {
+    /** Whether the simulation completed successfully */
+    success: boolean;
+    /** The final result of the expression evaluation */
+    finalResult: unknown;
+    /** Operation log — trace of every function call */
+    oplog: HalOplogEntry[];
+    /** Error message if failed */
+    error: string | null;
+}
+export interface HalOplogEntry {
+    operationId: string;
+    functionName: string;
+    status: 'success' | 'error';
+    timestamp: string;
+    args: unknown;
+    result: unknown;
+}
+export interface HalAdapterMeta {
+    description: string;
+    originContract?: {
+        address: Address;
+        blockchain: HerdBlockchain;
+        contractName: string;
+        functionName: string;
+    };
+    originTransaction?: {
+        txHash: string;
+        blockchain: HerdBlockchain;
+    };
+}
+/** @internal */
+export interface McpToolResult {
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError?: boolean;
+}
+//# sourceMappingURL=herd-types.d.ts.map

package/dist/herd-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"herd-types.d.ts","sourceRoot":"","sources":["../src/herd-types.ts"],"names":[],"mappings":"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"}

package/dist/herd-types.js

@@ -0,0 +1,18 @@
+/**
+ * Herd Integration Types
+ *
+ * Rich TypeScript interfaces for composed results that combine
+ * Herd's on-chain intelligence with Clawncher's domain-specific data.
+ *
+ * These are NOT 1:1 mirrors of Herd's raw responses. Each type is
+ * designed to answer specific questions agents and developers have
+ * when building on-chain.
+ */
+export const DEFAULT_CACHE_TTL = {
+    contractMetadata: 3600, // 1 hour
+    transactionData: 86400000, // indefinite (immutable)
+    walletOverview: 300, // 5 minutes
+    tokenActivity: 120, // 2 minutes
+    bookmarks: 300, // 5 minutes
+};
+//# sourceMappingURL=herd-types.js.map

package/dist/herd-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"herd-types.js","sourceRoot":"","sources":["../src/herd-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA+BH,MAAM,CAAC,MAAM,iBAAiB,GAAiB;IAC7C,gBAAgB,EAAE,IAAI,EAAK,SAAS;IACpC,eAAe,EAAE,QAAQ,EAAE,yBAAyB;IACpD,cAAc,EAAE,GAAG,EAAQ,YAAY;IACvC,aAAa,EAAE,GAAG,EAAS,YAAY;IACvC,SAAS,EAAE,GAAG,EAAa,YAAY;CACxC,CAAC"}