@clawnch/clawtomaton 0.1.0

package/dist/heartbeat/index.js

@@ -0,0 +1,127 @@
+/**
+ * Heartbeat — condition-driven wake scheduler.
+ *
+ * NOT a dumb timer that tells the agent to "maybe do something."
+ * Instead: periodically checks on-chain conditions and only wakes
+ * the agent when there's something genuinely actionable.
+ *
+ * The check itself is cheap (a few RPC reads, no txs). The agent
+ * run is expensive (inference + potential txs). So we gate the
+ * expensive part behind the cheap check.
+ *
+ * Wake conditions:
+ *   - Fees are profitable to claim (WETH fees > gas cost + threshold)
+ *   - Survival danger (ETH low, but fees exist to claim)
+ *   - Operational runway < 24h
+ *   - Scheduled: periodic self-reflection (every 24h)
+ */
+import { MarketIntelligence, formatSnapshot } from '../market/index.js';
+import { buildClients } from '../identity/index.js';
+/** Minimum time between agent runs even if conditions are met (5 min) */
+const MIN_RUN_INTERVAL_MS = 5 * 60 * 1000;
+/** How often to do a full self-reflection run regardless of conditions (24h) */
+const REFLECTION_INTERVAL_MS = 24 * 60 * 60 * 1000;
+export class Heartbeat {
+    timer = null;
+    agent;
+    config;
+    market;
+    lastRunTime = 0;
+    lastReflectionTime = 0;
+    constructor(agent, config) {
+        this.agent = agent;
+        this.config = config;
+        const identity = agent.getIdentity();
+        const { publicClient } = buildClients(identity, config.rpcUrl);
+        this.market = new MarketIntelligence(publicClient, identity.address, agent.getState());
+    }
+    /**
+     * Start the heartbeat loop.
+     */
+    start() {
+        if (this.timer)
+            throw new Error('Heartbeat already running.');
+        const intervalMs = this.config.heartbeatIntervalMs;
+        console.log(`[heartbeat] Checking conditions every ${Math.round(intervalMs / 60000)}min`);
+        // Run first check immediately
+        this.check();
+        this.timer = setInterval(() => this.check(), intervalMs);
+    }
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+            console.log('[heartbeat] Stopped.');
+        }
+    }
+    /**
+     * Check conditions. Only wake the agent if something is actionable.
+     */
+    async check() {
+        // Don't interrupt a running agent
+        if (this.agent.isRunning())
+            return;
+        // Respect minimum interval between runs
+        if (Date.now() - this.lastRunTime < MIN_RUN_INTERVAL_MS)
+            return;
+        const identity = this.agent.getIdentity();
+        const tokenAddress = identity.tokenAddress;
+        try {
+            // Cheap check: read on-chain state
+            const { wake, reason } = await this.market.shouldWake(tokenAddress);
+            // Also check if it's time for periodic self-reflection
+            const reflectionDue = Date.now() - this.lastReflectionTime > REFLECTION_INTERVAL_MS;
+            if (!wake && !reflectionDue) {
+                // Nothing to do. Silence is golden.
+                return;
+            }
+            // Build context for the agent
+            const snap = await this.market.snapshot(tokenAddress);
+            const conditions = this.market.evaluate(snap);
+            const snapshotText = formatSnapshot(snap);
+            let prompt;
+            if (wake) {
+                console.log(`[heartbeat] Waking agent: ${reason}`);
+                prompt = [
+                    `[HEARTBEAT — CONDITION TRIGGERED]`,
+                    `Trigger: ${reason}`,
+                    ``,
+                    snapshotText,
+                    ``,
+                    `Conditions:`,
+                    conditions.summary,
+                    ``,
+                    conditions.survivalClaimNeeded
+                        ? `ACTION REQUIRED: Claim fees now to survive. Use claim_fees skill.`
+                        : conditions.feesWorthClaiming
+                            ? `Fees are profitable to claim. Consider using claim_fees.`
+                            : `Review situation and decide on next action.`,
+                ].join('\n');
+            }
+            else {
+                // Reflection run
+                console.log(`[heartbeat] Periodic reflection`);
+                this.lastReflectionTime = Date.now();
+                prompt = [
+                    `[HEARTBEAT — PERIODIC REFLECTION]`,
+                    `It's been 24 hours. Review your situation, update your SOUL.md if needed.`,
+                    ``,
+                    snapshotText,
+                    ``,
+                    `Conditions:`,
+                    conditions.summary,
+                    ``,
+                    `Reflect on: What's working? What should change? Any strategic adjustments?`,
+                ].join('\n');
+            }
+            this.lastRunTime = Date.now();
+            await this.agent.run(prompt);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(`[heartbeat] Check failed: ${msg}`);
+            this.agent.getState().audit('heartbeat_error', msg);
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/heartbeat/index.js.map

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

package/dist/identity/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Identity module — wallet generation, Clawncher registration, $CLAWNCH burn activation.
+ *
+ * Each Clawtomaton has a unique Ethereum wallet. Registration on Clawncher gives
+ * it an API key. Activation requires burning 1,000,000 $CLAWNCH to the dead address.
+ */
+import { privateKeyToAccount } from 'viem/accounts';
+import { type Address, type PublicClient, type WalletClient } from 'viem';
+import type { StateStore } from '../state/index.js';
+import type { ClawtomatonIdentity, ActivationResult } from '../types.js';
+export interface GenerateIdentityParams {
+    name: string;
+    genesisPrompt: string;
+    creatorAddress: Address;
+    rpcUrl: string;
+    apiBaseUrl?: string;
+}
+/**
+ * Generate a fresh wallet and register with Clawncher to get an API key.
+ * Does NOT activate (burn $CLAWNCH) — call `activate()` separately after funding.
+ */
+export declare function generateIdentity(params: GenerateIdentityParams, state: StateStore): Promise<ClawtomatonIdentity>;
+/**
+ * Activate a Clawtomaton by burning 1,000,000 $CLAWNCH.
+ * The agent's wallet must hold >= 1M $CLAWNCH before calling this.
+ *
+ * Burns by transferring to 0x...dEaD.
+ */
+export declare function activate(identity: ClawtomatonIdentity, rpcUrl: string, state: StateStore): Promise<ActivationResult>;
+export interface ClawtomatonClients {
+    publicClient: PublicClient;
+    walletClient: WalletClient;
+    account: ReturnType<typeof privateKeyToAccount>;
+}
+/**
+ * Build viem clients from a persisted identity + config.
+ */
+export declare function buildClients(identity: ClawtomatonIdentity, rpcUrl: string): ClawtomatonClients;
+//# sourceMappingURL=index.d.ts.map

package/dist/identity/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/identity/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,mBAAmB,EACpB,MAAM,eAAe,CAAC;AACvB,OAAO,EAKL,KAAK,OAAO,EAEZ,KAAK,YAAY,EACjB,KAAK,YAAY,EAClB,MAAM,MAAM,CAAC;AAGd,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAWzE,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,OAAO,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,sBAAsB,EAC9B,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC,mBAAmB,CAAC,CAgD9B;AAQD;;;;;GAKG;AACH,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,mBAAmB,EAC7B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC,gBAAgB,CAAC,CAqD3B;AAMD,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,YAAY,CAAC;IAC3B,YAAY,EAAE,YAAY,CAAC;IAC3B,OAAO,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;CACjD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,GAAG,kBAAkB,CAmB9F"}

package/dist/identity/index.js

@@ -0,0 +1,134 @@
+/**
+ * Identity module — wallet generation, Clawncher registration, $CLAWNCH burn activation.
+ *
+ * Each Clawtomaton has a unique Ethereum wallet. Registration on Clawncher gives
+ * it an API key. Activation requires burning 1,000,000 $CLAWNCH to the dead address.
+ */
+import { generatePrivateKey, privateKeyToAccount, } from 'viem/accounts';
+import { createPublicClient, createWalletClient, http, erc20Abi, } from 'viem';
+import { base } from 'viem/chains';
+import { ClawnchApiDeployer } from '@clawnch/clawncher-sdk';
+import { CLAWTOMATON_ACTIVATION_COST, CLAWNCH_TOKEN_ADDRESS, CLAWNCH_BURN_ADDRESS, } from '../types.js';
+/**
+ * Generate a fresh wallet and register with Clawncher to get an API key.
+ * Does NOT activate (burn $CLAWNCH) — call `activate()` separately after funding.
+ */
+export async function generateIdentity(params, state) {
+    const { name, genesisPrompt, creatorAddress, rpcUrl, apiBaseUrl } = params;
+    // Generate fresh keypair
+    const privateKey = generatePrivateKey();
+    const account = privateKeyToAccount(privateKey);
+    const publicClient = createPublicClient({
+        chain: base,
+        transport: http(rpcUrl, { retryCount: 0 }),
+    });
+    const walletClient = createWalletClient({
+        account,
+        chain: base,
+        transport: http(rpcUrl, { retryCount: 0 }),
+    });
+    // Register with Clawncher API — sign challenge, get API key
+    // Cast through `any` because viem's OP Stack chain types don't match
+    // the SDK's generic PublicClient/WalletClient types.
+    const registration = await ClawnchApiDeployer.register({
+        wallet: walletClient,
+        publicClient: publicClient,
+        apiBaseUrl,
+    }, {
+        name,
+        wallet: account.address,
+        description: `Clawtomaton: ${genesisPrompt.slice(0, 100)}`,
+    });
+    const identity = {
+        name,
+        address: account.address,
+        privateKey,
+        apiKey: registration.apiKey,
+        creatorAddress,
+        genesisPrompt,
+    };
+    // Persist
+    state.saveIdentity(identity);
+    state.audit('identity_created', `Agent "${name}" created at ${account.address}`);
+    return identity;
+}
+// ============================================================================
+// Activation ($CLAWNCH Burn)
+// ============================================================================
+// Use viem's built-in erc20Abi which includes transfer, balanceOf, approve, etc.
+/**
+ * Activate a Clawtomaton by burning 1,000,000 $CLAWNCH.
+ * The agent's wallet must hold >= 1M $CLAWNCH before calling this.
+ *
+ * Burns by transferring to 0x...dEaD.
+ */
+export async function activate(identity, rpcUrl, state) {
+    const account = privateKeyToAccount(identity.privateKey);
+    const publicClient = createPublicClient({
+        chain: base,
+        transport: http(rpcUrl, { retryCount: 0 }),
+    });
+    const walletClient = createWalletClient({
+        account,
+        chain: base,
+        transport: http(rpcUrl, { retryCount: 0 }),
+    });
+    // Check $CLAWNCH balance
+    const balance = await publicClient.readContract({
+        address: CLAWNCH_TOKEN_ADDRESS,
+        abi: erc20Abi,
+        functionName: 'balanceOf',
+        args: [account.address],
+    });
+    if (balance < CLAWTOMATON_ACTIVATION_COST) {
+        const deficit = CLAWTOMATON_ACTIVATION_COST - balance;
+        throw new Error(`Insufficient $CLAWNCH for activation. Need ${formatClawnch(CLAWTOMATON_ACTIVATION_COST)}, have ${formatClawnch(balance)}. Need ${formatClawnch(deficit)} more.`);
+    }
+    // Burn by transferring to dead address — single attempt, no retry
+    const txHash = await walletClient.writeContract({
+        address: CLAWNCH_TOKEN_ADDRESS,
+        abi: erc20Abi,
+        functionName: 'transfer',
+        args: [CLAWNCH_BURN_ADDRESS, CLAWTOMATON_ACTIVATION_COST],
+    });
+    // Wait for confirmation
+    const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash });
+    if (receipt.status === 'reverted') {
+        throw new Error(`Activation burn tx reverted: ${txHash}`);
+    }
+    const result = {
+        burnTxHash: txHash,
+        amountBurned: CLAWTOMATON_ACTIVATION_COST,
+        activatedAt: Date.now(),
+    };
+    state.saveActivation(result);
+    state.audit('activation', `Burned ${formatClawnch(CLAWTOMATON_ACTIVATION_COST)} $CLAWNCH`, txHash);
+    return result;
+}
+/**
+ * Build viem clients from a persisted identity + config.
+ */
+export function buildClients(identity, rpcUrl) {
+    const account = privateKeyToAccount(identity.privateKey);
+    const publicClient = createPublicClient({
+        chain: base,
+        transport: http(rpcUrl, { retryCount: 0 }),
+    });
+    const walletClient = createWalletClient({
+        account,
+        chain: base,
+        transport: http(rpcUrl, { retryCount: 0 }),
+    });
+    return {
+        publicClient: publicClient,
+        walletClient: walletClient,
+        account,
+    };
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+function formatClawnch(amount) {
+    return (Number(amount) / 1e18).toLocaleString('en-US', { maximumFractionDigits: 0 });
+}
+//# sourceMappingURL=index.js.map

package/dist/identity/index.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @clawnch/clawtomaton — Autonomous AI agents that launch and manage crypto projects on Base.
+ *
+ * @example
+ * ```ts
+ * import { ClawtomatonAgent, generateIdentity, activate } from '@clawnch/clawtomaton';
+ *
+ * // Setup
+ * const identity = await generateIdentity({ name: 'my-agent', ... }, state);
+ * await activate(identity, rpcUrl, state);
+ *
+ * // Run
+ * const agent = new ClawtomatonAgent(config);
+ * await agent.run();
+ * ```
+ */
+export { ClawtomatonAgent } from './agent/index.js';
+export { buildSystemPrompt } from './agent/prompt.js';
+export { generateIdentity, activate, buildClients } from './identity/index.js';
+export type { GenerateIdentityParams, ClawtomatonClients } from './identity/index.js';
+export { StateStore } from './state/index.js';
+export type { AuditEntry } from './state/index.js';
+export { SurvivalMonitor, determineTier, formatSurvivalStatus } from './survival/index.js';
+export { ALL_SKILLS, getSkillsForTier } from './skills/index.js';
+export { checkBalanceSkill, checkStatsSkill, claimFeesSkill, deployTokenSkill, swapSkill, transferSkill, shellSkill, conwaySkill, editSoulSkill, } from './skills/index.js';
+export { Heartbeat } from './heartbeat/index.js';
+export { MarketIntelligence, formatSnapshot } from './market/index.js';
+export type { MarketSnapshot, MarketConditions, OwnTokenStats } from './market/index.js';
+export type { PromptContext } from './agent/prompt.js';
+export { SelfModAuditor } from './self-mod/index.js';
+export type { ClawtomatonIdentity, SurvivalTier, SurvivalState, AgentContext, ConversationTurn, ToolCall, ToolResult, SkillDefinition, SkillParameter, HeartbeatTask, ClawtomatonConfig, ActivationResult, } from './types.js';
+export { SURVIVAL_THRESHOLDS, CLAWTOMATON_ACTIVATION_COST, CLAWNCH_TOKEN_ADDRESS, CLAWNCH_BURN_ADDRESS, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGtD,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC/E,YAAY,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAGtF,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAG3F,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,UAAU,EACV,WAAW,EACX,aAAa,GACd,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGjD,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACvE,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGzF,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD,YAAY,EACV,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,QAAQ,EACR,UAAU,EACV,eAAe,EACf,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,mBAAmB,EACnB,2BAA2B,EAC3B,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,36 @@
+/**
+ * @clawnch/clawtomaton — Autonomous AI agents that launch and manage crypto projects on Base.
+ *
+ * @example
+ * ```ts
+ * import { ClawtomatonAgent, generateIdentity, activate } from '@clawnch/clawtomaton';
+ *
+ * // Setup
+ * const identity = await generateIdentity({ name: 'my-agent', ... }, state);
+ * await activate(identity, rpcUrl, state);
+ *
+ * // Run
+ * const agent = new ClawtomatonAgent(config);
+ * await agent.run();
+ * ```
+ */
+// Core agent
+export { ClawtomatonAgent } from './agent/index.js';
+export { buildSystemPrompt } from './agent/prompt.js';
+// Identity
+export { generateIdentity, activate, buildClients } from './identity/index.js';
+// State
+export { StateStore } from './state/index.js';
+// Survival
+export { SurvivalMonitor, determineTier, formatSurvivalStatus } from './survival/index.js';
+// Skills
+export { ALL_SKILLS, getSkillsForTier } from './skills/index.js';
+export { checkBalanceSkill, checkStatsSkill, claimFeesSkill, deployTokenSkill, swapSkill, transferSkill, shellSkill, conwaySkill, editSoulSkill, } from './skills/index.js';
+// Heartbeat
+export { Heartbeat } from './heartbeat/index.js';
+// Market intelligence
+export { MarketIntelligence, formatSnapshot } from './market/index.js';
+// Self-modification audit
+export { SelfModAuditor } from './self-mod/index.js';
+export { SURVIVAL_THRESHOLDS, CLAWTOMATON_ACTIVATION_COST, CLAWNCH_TOKEN_ADDRESS, CLAWNCH_BURN_ADDRESS, } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,aAAa;AACb,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,WAAW;AACX,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAG/E,QAAQ;AACR,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,WAAW;AACX,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3F,SAAS;AACT,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,UAAU,EACV,WAAW,EACX,aAAa,GACd,MAAM,mBAAmB,CAAC;AAE3B,YAAY;AACZ,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,sBAAsB;AACtB,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAMvE,0BAA0B;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAkBrD,OAAO,EACL,mBAAmB,EACnB,2BAA2B,EAC3B,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,YAAY,CAAC"}

package/dist/market/index.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Market intelligence — the agent's eyes on-chain.
+ *
+ * Reads real state: gas prices, fee balances, token stats, ETH balance.
+ * Uses the Clawncher SDK for all on-chain reads — no local ABI duplication.
+ */
+import { type Address, type PublicClient } from 'viem';
+import { type NetworkName } from '@clawnch/clawncher-sdk';
+import type { StateStore } from '../state/index.js';
+/** Everything the agent needs to know about its current financial state */
+export interface MarketSnapshot {
+    timestamp: number;
+    ethBalance: bigint;
+    ethFormatted: string;
+    gasPrice: bigint;
+    estimatedTxCostWei: bigint;
+    estimatedClaimCostWei: bigint;
+    estimatedClaimCostEth: string;
+    unclaimedFeesWeth: bigint;
+    unclaimedFeesWethFormatted: string;
+    unclaimedFeesToken: bigint;
+    unclaimedFeesTokenFormatted: string;
+    claimProfitWei: bigint;
+    claimProfitEth: string;
+    claimIsProfitable: boolean;
+    ownToken: OwnTokenStats | null;
+    txBudget: number;
+}
+export interface OwnTokenStats {
+    address: Address;
+    symbol: string;
+    balance: bigint;
+    balanceFormatted: string;
+    totalSupply: bigint;
+    holdingPct: number;
+}
+export interface MarketConditions {
+    feesWorthClaiming: boolean;
+    survivalClaimNeeded: boolean;
+    operationallyHealthy: boolean;
+    estimatedHoursRemaining: number;
+    needsToken: boolean;
+    summary: string;
+}
+export declare class MarketIntelligence {
+    private publicClient;
+    private address;
+    private state;
+    private reader;
+    constructor(publicClient: PublicClient, address: Address, state: StateStore, network?: NetworkName);
+    /**
+     * Take a full market snapshot — all data from chain, no caching.
+     */
+    snapshot(tokenAddress?: Address): Promise<MarketSnapshot>;
+    /**
+     * Evaluate conditions from a snapshot — actionable signals.
+     */
+    evaluate(snap: MarketSnapshot): MarketConditions;
+    /**
+     * Quick check: should the agent wake up?
+     */
+    shouldWake(tokenAddress?: Address): Promise<{
+        wake: boolean;
+        reason: string;
+    }>;
+    private fetchFees;
+    /**
+     * Fetch own token stats using the SDK's ClawnchReader + ERC20ABI.
+     */
+    private fetchOwnTokenStats;
+}
+export declare function formatSnapshot(snap: MarketSnapshot): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/market/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/market/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,KAAK,OAAO,EACZ,KAAK,YAAY,EAClB,MAAM,MAAM,CAAC;AACd,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAapD,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAElB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IAErB,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,qBAAqB,EAAE,MAAM,CAAC;IAE9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,0BAA0B,EAAE,MAAM,CAAC;IACnC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,2BAA2B,EAAE,MAAM,CAAC;IAEpC,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,OAAO,CAAC;IAE3B,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;IAE/B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,uBAAuB,EAAE,MAAM,CAAC;IAChC,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,MAAM,CAAgB;gBAG5B,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE,WAAuB;IAQlC;;OAEG;IACG,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC;IA8C/D;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,gBAAgB;IA0ChD;;OAEG;IACG,UAAU,CAAC,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;YAyBtE,SAAS;IAyBvB;;OAEG;YACW,kBAAkB;CA6BjC;AAUD,wBAAgB,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAmB3D"}