@clawnch/clawtomaton 0.2.2 → 0.4.0

package/dist/skills/portfolio.js

@@ -0,0 +1,189 @@
+/**
+ * Skill: portfolio — View multi-token portfolio with P&L and allocation.
+ *
+ * Shows:
+ *   - All token positions with current value and unrealized P&L
+ *   - Realized P&L from past sells
+ *   - Portfolio allocation percentages
+ *   - Concentration warnings
+ *   - Historical performance (if snapshots exist)
+ *
+ * Actions: view, history, record_trade
+ *
+ * The portfolio is populated automatically by handleSkillSideEffects
+ * when the agent executes swaps. The agent can also manually record
+ * trades via the record_trade action for OTC / external transfers.
+ */
+import { ClawnchTrader, ClawnchPrice } from '@clawnch/clawncher-sdk';
+export const portfolioSkill = {
+    name: 'portfolio',
+    description: [
+        'View your multi-token portfolio: positions, P&L, allocation, performance.',
+        'Actions: view (full summary), history (value over time), record_trade (manual entry).',
+        'Positions auto-update on swaps. No gas cost (read-only, except record_trade).',
+    ].join(' '),
+    parameters: [
+        {
+            name: 'action',
+            type: 'string',
+            description: 'One of: view, history, record_trade',
+            required: true,
+        },
+        {
+            name: 'period',
+            type: 'string',
+            description: 'For history: time period — "24h", "7d", "30d" (default "7d")',
+            required: false,
+        },
+        {
+            name: 'token',
+            type: 'address',
+            description: 'Token address (for record_trade)',
+            required: false,
+        },
+        {
+            name: 'symbol',
+            type: 'string',
+            description: 'Token symbol (for record_trade)',
+            required: false,
+        },
+        {
+            name: 'side',
+            type: 'string',
+            description: 'Trade side: buy or sell (for record_trade)',
+            required: false,
+        },
+        {
+            name: 'amount',
+            type: 'string',
+            description: 'Amount traded in token units (for record_trade)',
+            required: false,
+        },
+        {
+            name: 'priceEth',
+            type: 'string',
+            description: 'Price per token in ETH (for record_trade)',
+            required: false,
+        },
+        {
+            name: 'txHash',
+            type: 'string',
+            description: 'Transaction hash (for record_trade)',
+            required: false,
+        },
+    ],
+    execute: async (params, ctx) => {
+        try {
+            if (!ctx.stateStore) {
+                return { callId: '', success: false, result: null, error: 'No state store available.' };
+            }
+            const action = params.action;
+            switch (action) {
+                case 'view':
+                    return handleView(ctx);
+                case 'history':
+                    return handleHistory(ctx, params);
+                case 'record_trade':
+                    return handleRecordTrade(ctx, params);
+                default:
+                    return { callId: '', success: false, result: null, error: `Unknown action: ${action}. Use: view, history, record_trade` };
+            }
+        }
+        catch (err) {
+            return { callId: '', success: false, result: null, error: err instanceof Error ? err.message : String(err) };
+        }
+    },
+};
+async function handleView(ctx) {
+    const trader = new ClawnchTrader(ctx.stateStore.asTraderStorage());
+    // Build price fetcher using ClawnchPrice
+    const { buildClients } = await import('../identity/index.js');
+    const rpcUrl = process.env.BASE_RPC_URL ?? 'https://mainnet.base.org';
+    const { publicClient } = buildClients(ctx.identity, rpcUrl);
+    const price = new ClawnchPrice({ publicClient: publicClient, network: 'mainnet' });
+    const priceFetcher = async (token) => {
+        try {
+            const info = await price.getQuickPrice(token);
+            return { priceEth: info.priceInEth, priceUsd: info.priceInUsd };
+        }
+        catch {
+            return null;
+        }
+    };
+    // Get ETH balance
+    let ethBalanceEth = 0;
+    try {
+        const ethBal = await publicClient.getBalance({ address: ctx.identity.address });
+        ethBalanceEth = Number(ethBal) / 1e18;
+    }
+    catch { }
+    const summary = await trader.getSummary(priceFetcher, ethBalanceEth);
+    if (summary.positions.length === 0) {
+        return {
+            callId: '',
+            success: true,
+            result: `No token positions tracked yet.\nETH Balance: ${ethBalanceEth.toFixed(6)} ETH\n\nPositions are automatically recorded when you execute swaps. Use portfolio action=record_trade for manual entries.`,
+        };
+    }
+    return {
+        callId: '',
+        success: true,
+        result: ClawnchTrader.formatSummary(summary),
+    };
+}
+async function handleHistory(ctx, params) {
+    const trader = new ClawnchTrader(ctx.stateStore.asTraderStorage());
+    const periodStr = params.period ?? '7d';
+    const periodMs = parsePeriod(periodStr);
+    const perf = trader.getPerformance(periodMs);
+    if (!perf) {
+        return { callId: '', success: true, result: 'No portfolio snapshots yet. Snapshots are taken each heartbeat.' };
+    }
+    const snapshots = trader.getHistory(20);
+    const lines = [
+        `Portfolio performance (${perf.period}):`,
+        `  Start: ${perf.startValue.toFixed(6)} ETH`,
+        `  End: ${perf.endValue.toFixed(6)} ETH`,
+        `  Change: ${perf.changeEth >= 0 ? '+' : ''}${perf.changeEth.toFixed(6)} ETH (${perf.changePct >= 0 ? '+' : ''}${perf.changePct.toFixed(1)}%)`,
+    ];
+    if (snapshots.length > 0) {
+        lines.push(``, `Recent snapshots (${snapshots.length}):`);
+        for (const s of snapshots.slice(-10)) {
+            lines.push(`  ${new Date(s.timestamp).toISOString().slice(0, 16)} | ${s.totalValueEth.toFixed(6)} ETH | ${s.positionCount} positions`);
+        }
+    }
+    return { callId: '', success: true, result: lines.join('\n') };
+}
+async function handleRecordTrade(ctx, params) {
+    const token = params.token;
+    const side = params.side;
+    const amount = params.amount;
+    const priceEth = params.priceEth;
+    const txHash = params.txHash ?? 'manual';
+    if (!token || !side || !amount || !priceEth) {
+        return { callId: '', success: false, result: null, error: 'Missing parameters: token, side, amount, priceEth are required.' };
+    }
+    const trader = new ClawnchTrader(ctx.stateStore.asTraderStorage());
+    const trade = trader.recordTrade({
+        token,
+        symbol: params.symbol,
+        side: side,
+        amount,
+        priceEth: parseFloat(priceEth),
+        txHash,
+    });
+    return {
+        callId: '',
+        success: true,
+        result: `Trade recorded: ${trade.id}\n  ${trade.side} ${trade.amount} @ ${trade.priceEth} ETH = ${trade.valueEth.toFixed(6)} ETH\n  TX: ${trade.txHash}`,
+    };
+}
+function parsePeriod(period) {
+    const match = period.match(/^(\d+)(h|d)$/);
+    if (!match)
+        return 7 * 24 * 60 * 60 * 1000; // default 7d
+    const value = parseInt(match[1]);
+    const unit = match[2];
+    return unit === 'h' ? value * 60 * 60 * 1000 : value * 24 * 60 * 60 * 1000;
+}
+//# sourceMappingURL=portfolio.js.map

package/dist/skills/portfolio.js.map

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

package/dist/skills/watch-activity.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Skill: watch_activity — Check recent on-chain activity for a token.
+ *
+ * Fetches recent ERC-20 transfers and Uniswap V4 swaps for the agent's token.
+ * Reports: swap count, transfer count, unique addresses, largest transfer,
+ * total volume, and whale alerts (transfers > 1% of supply).
+ *
+ * No gas cost — pure read operation.
+ */
+import type { SkillDefinition } from '../types.js';
+export declare const watchActivitySkill: SkillDefinition;
+//# sourceMappingURL=watch-activity.d.ts.map

package/dist/skills/watch-activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-activity.d.ts","sourceRoot":"","sources":["../../src/skills/watch-activity.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH,OAAO,KAAK,EAAE,eAAe,EAA4B,MAAM,aAAa,CAAC;AAQ7E,eAAO,MAAM,kBAAkB,EAAE,eAgIhC,CAAC"}

package/dist/skills/watch-activity.js

@@ -0,0 +1,130 @@
+/**
+ * Skill: watch_activity — Check recent on-chain activity for a token.
+ *
+ * Fetches recent ERC-20 transfers and Uniswap V4 swaps for the agent's token.
+ * Reports: swap count, transfer count, unique addresses, largest transfer,
+ * total volume, and whale alerts (transfers > 1% of supply).
+ *
+ * No gas cost — pure read operation.
+ */
+import { ClawnchWatcher, ClawnchReader, } from '@clawnch/clawncher-sdk';
+import { formatEther } from 'viem';
+/** Transfers above this % of supply are flagged as whale moves */
+const WHALE_THRESHOLD_PCT = 1;
+/** Default lookback: 5,000 blocks (~2.8 hours on Base) */
+const DEFAULT_LOOKBACK_BLOCKS = 5000n;
+export const watchActivitySkill = {
+    name: 'watch_activity',
+    description: [
+        'Check recent on-chain activity for a token: swaps, transfers, whale alerts.',
+        'Scans the last ~3 hours of blocks. Reports volume, unique traders,',
+        'and flags large transfers (>1% of supply). No gas cost (read-only).',
+    ].join(' '),
+    parameters: [
+        {
+            name: 'token',
+            type: 'address',
+            description: 'Token address to monitor. Defaults to own token.',
+            required: false,
+        },
+        {
+            name: 'blocks',
+            type: 'number',
+            description: 'Number of blocks to look back. Default: 5000 (~3 hours).',
+            required: false,
+            default: 5000,
+        },
+    ],
+    execute: async (params, ctx) => {
+        try {
+            const tokenAddress = params.token ?? ctx.identity.tokenAddress;
+            if (!tokenAddress) {
+                return { callId: '', success: false, result: null, error: 'No token address. Deploy a token first or specify one.' };
+            }
+            const { buildClients } = await import('../identity/index.js');
+            const rpcUrl = process.env.BASE_RPC_URL ?? 'https://mainnet.base.org';
+            const { publicClient } = buildClients(ctx.identity, rpcUrl);
+            const watcher = new ClawnchWatcher({ publicClient: publicClient, network: 'mainnet' });
+            const reader = new ClawnchReader({ publicClient: publicClient, network: 'mainnet' });
+            // Get pool ID from token rewards
+            const rewards = await reader.getTokenRewards(tokenAddress);
+            if (!rewards) {
+                return { callId: '', success: false, result: null, error: 'No pool found for this token. Is it a Clawncher token?' };
+            }
+            // Compute pool ID
+            const { keccak256, encodeAbiParameters } = await import('viem');
+            const poolId = keccak256(encodeAbiParameters([
+                { type: 'address' },
+                { type: 'address' },
+                { type: 'uint24' },
+                { type: 'int24' },
+                { type: 'address' },
+            ], [
+                rewards.poolKey.currency0,
+                rewards.poolKey.currency1,
+                rewards.poolKey.fee,
+                rewards.poolKey.tickSpacing,
+                rewards.poolKey.hooks,
+            ]));
+            // Determine block range
+            const lookback = BigInt(params.blocks ?? 5000);
+            const currentBlock = await publicClient.getBlockNumber();
+            const fromBlock = currentBlock > lookback ? currentBlock - lookback : 0n;
+            // Fetch activity
+            const activity = await watcher.getTokenActivity(tokenAddress, poolId, {
+                fromBlock,
+                toBlock: currentBlock,
+                transferLimit: 100,
+                swapLimit: 100,
+            });
+            // Get total supply for whale detection
+            const tokenInfo = await reader.getTokenInfo(tokenAddress);
+            const whaleThreshold = tokenInfo.totalSupply / 100n; // 1%
+            // Build report
+            const lines = [
+                `Activity for ${tokenAddress} (last ${lookback} blocks, ~${Math.round(Number(lookback) * 2 / 3600)}h):`,
+                `  Swaps: ${activity.stats.swapCount}`,
+                `  Transfers: ${activity.stats.transferCount}`,
+                `  Unique addresses: ${activity.stats.uniqueAddresses}`,
+            ];
+            if (activity.stats.totalVolume0 > 0n || activity.stats.totalVolume1 > 0n) {
+                lines.push(`  Volume (currency0): ${formatEther(activity.stats.totalVolume0)}`);
+                lines.push(`  Volume (currency1): ${formatEther(activity.stats.totalVolume1)}`);
+            }
+            if (activity.stats.largestTransfer > 0n) {
+                lines.push(`  Largest transfer: ${formatEther(activity.stats.largestTransfer)} tokens`);
+            }
+            // Whale alerts
+            const whaleTransfers = activity.transfers.filter(t => t.amount >= whaleThreshold);
+            if (whaleTransfers.length > 0) {
+                lines.push('');
+                lines.push(`WHALE ALERTS (>${WHALE_THRESHOLD_PCT}% of supply):`);
+                for (const w of whaleTransfers.slice(0, 10)) {
+                    const pct = Number((w.amount * 10000n) / tokenInfo.totalSupply) / 100;
+                    lines.push(`  ${shortenAddr(w.from)} → ${shortenAddr(w.to)}: ${formatEther(w.amount)} (${pct.toFixed(2)}%) [block ${w.blockNumber}]`);
+                }
+            }
+            // Recent swaps summary (last 5)
+            if (activity.swaps.length > 0) {
+                lines.push('');
+                lines.push('Recent swaps:');
+                for (const s of activity.swaps.slice(0, 5)) {
+                    const side = s.amount0 < 0n ? 'sell' : 'buy';
+                    const amt = s.amount0 < 0n ? -s.amount0 : s.amount0;
+                    lines.push(`  ${side} ${formatEther(amt)} [${shortenAddr(s.sender)}, block ${s.blockNumber}]`);
+                }
+            }
+            if (activity.stats.swapCount === 0 && activity.stats.transferCount === 0) {
+                lines.push('  No activity in this period.');
+            }
+            return { callId: '', success: true, result: lines.join('\n') };
+        }
+        catch (err) {
+            return { callId: '', success: false, result: null, error: err instanceof Error ? err.message : String(err) };
+        }
+    },
+};
+function shortenAddr(addr) {
+    return `${addr.slice(0, 6)}...${addr.slice(-4)}`;
+}
+//# sourceMappingURL=watch-activity.js.map

package/dist/skills/watch-activity.js.map

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

package/dist/skills/xmtp.d.ts

@@ -0,0 +1,18 @@
+/**
+ * XMTP skill — encrypted messaging via the XMTP protocol.
+ *
+ * Actions:
+ *   - send_message:    Send a text message to a conversation by ID
+ *   - send_dm:         Send a DM to an Ethereum address (creates convo if needed)
+ *   - read_messages:   Read recent messages from a conversation
+ *   - list_convos:     List recent conversations with previews
+ *   - check_inbox:     Check for unread messages in the queue
+ *   - reply:           Reply to the most recent message in a conversation
+ *
+ * The XMTP client is managed by the agent runtime (started at boot,
+ * available via `ctx.xmtpClient`). This skill is the agent's interface
+ * to send/read messages.
+ */
+import type { SkillDefinition } from '../types.js';
+export declare const xmtpSkill: SkillDefinition;
+//# sourceMappingURL=xmtp.d.ts.map

package/dist/skills/xmtp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xmtp.d.ts","sourceRoot":"","sources":["../../src/skills/xmtp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,eAAe,EAA4B,MAAM,aAAa,CAAC;AAO7E,eAAO,MAAM,SAAS,EAAE,eA+KvB,CAAC"}

package/dist/skills/xmtp.js

@@ -0,0 +1,180 @@
+/**
+ * XMTP skill — encrypted messaging via the XMTP protocol.
+ *
+ * Actions:
+ *   - send_message:    Send a text message to a conversation by ID
+ *   - send_dm:         Send a DM to an Ethereum address (creates convo if needed)
+ *   - read_messages:   Read recent messages from a conversation
+ *   - list_convos:     List recent conversations with previews
+ *   - check_inbox:     Check for unread messages in the queue
+ *   - reply:           Reply to the most recent message in a conversation
+ *
+ * The XMTP client is managed by the agent runtime (started at boot,
+ * available via `ctx.xmtpClient`). This skill is the agent's interface
+ * to send/read messages.
+ */
+// ============================================================================
+// Skill Definition
+// ============================================================================
+export const xmtpSkill = {
+    name: 'xmtp',
+    description: 'Send and receive encrypted messages via XMTP. Discoverable on Base App, World App, and xmtp.chat. Actions: send_message, send_dm, read_messages, list_convos, check_inbox, reply.',
+    parameters: [
+        {
+            name: 'action',
+            type: 'string',
+            description: 'Action: send_message | send_dm | read_messages | list_convos | check_inbox | reply',
+            required: true,
+        },
+        {
+            name: 'conversationId',
+            type: 'string',
+            description: 'Conversation ID (for send_message, read_messages, reply)',
+            required: false,
+        },
+        {
+            name: 'address',
+            type: 'address',
+            description: 'Ethereum address to DM (for send_dm)',
+            required: false,
+        },
+        {
+            name: 'message',
+            type: 'string',
+            description: 'Text message to send (for send_message, send_dm, reply)',
+            required: false,
+        },
+        {
+            name: 'limit',
+            type: 'number',
+            description: 'Number of items to return (default: 20)',
+            required: false,
+            default: 20,
+        },
+    ],
+    execute: async (params, ctx) => {
+        const action = params.action;
+        const callId = `xmtp_${Date.now()}`;
+        // Get the XMTP client from the agent context
+        const xmtpClient = ctx.xmtpClient;
+        if (!xmtpClient || !xmtpClient.isStarted()) {
+            return {
+                callId,
+                success: false,
+                result: null,
+                error: 'XMTP client is not running. XMTP may not be configured for this agent.',
+            };
+        }
+        try {
+            switch (action) {
+                case 'send_message': {
+                    const conversationId = params.conversationId;
+                    const message = params.message;
+                    if (!conversationId || !message) {
+                        return { callId, success: false, result: null, error: 'send_message requires conversationId and message' };
+                    }
+                    await xmtpClient.sendMessage(conversationId, message);
+                    return {
+                        callId,
+                        success: true,
+                        result: `Message sent to conversation ${conversationId}`,
+                    };
+                }
+                case 'send_dm': {
+                    const address = params.address;
+                    const message = params.message;
+                    if (!address || !message) {
+                        return { callId, success: false, result: null, error: 'send_dm requires address and message' };
+                    }
+                    const conversationId = await xmtpClient.sendToAddress(address, message);
+                    return {
+                        callId,
+                        success: true,
+                        result: `DM sent to ${address} (conversation: ${conversationId})`,
+                        metadata: { conversationId, address },
+                    };
+                }
+                case 'read_messages': {
+                    const conversationId = params.conversationId;
+                    if (!conversationId) {
+                        return { callId, success: false, result: null, error: 'read_messages requires conversationId' };
+                    }
+                    const limit = params.limit ?? 20;
+                    const messages = await xmtpClient.getConversationHistory(conversationId, limit);
+                    if (messages.length === 0) {
+                        return { callId, success: true, result: 'No messages in this conversation.' };
+                    }
+                    const formatted = messages.map(m => {
+                        const time = new Date(m.sentAt).toISOString();
+                        return `[${time}] ${m.senderAddress}: ${m.content}`;
+                    }).join('\n');
+                    return {
+                        callId,
+                        success: true,
+                        result: `${messages.length} messages:\n${formatted}`,
+                    };
+                }
+                case 'list_convos': {
+                    const limit = params.limit ?? 20;
+                    const convos = await xmtpClient.listConversations(limit);
+                    if (convos.length === 0) {
+                        return { callId, success: true, result: 'No conversations yet.' };
+                    }
+                    const formatted = convos.map(c => {
+                        const type = c.isDm ? 'DM' : `Group(${c.memberCount})`;
+                        const time = c.lastMessageAt > 0 ? new Date(c.lastMessageAt).toISOString() : 'no messages';
+                        const preview = c.lastMessagePreview ? `: "${c.lastMessagePreview}"` : '';
+                        return `  ${c.id} [${type}] last: ${time}${preview}`;
+                    }).join('\n');
+                    return {
+                        callId,
+                        success: true,
+                        result: `${convos.length} conversations:\n${formatted}`,
+                    };
+                }
+                case 'check_inbox': {
+                    const messages = xmtpClient.peekMessages();
+                    if (messages.length === 0) {
+                        return { callId, success: true, result: 'Inbox empty. No unread messages.' };
+                    }
+                    const formatted = messages.map(m => {
+                        const time = new Date(m.sentAt).toISOString();
+                        const type = m.isDm ? 'DM' : 'Group';
+                        return `[${time}] [${type}] ${m.senderAddress}: ${m.content}`;
+                    }).join('\n');
+                    return {
+                        callId,
+                        success: true,
+                        result: `${messages.length} unread messages:\n${formatted}`,
+                        metadata: { count: messages.length },
+                    };
+                }
+                case 'reply': {
+                    const conversationId = params.conversationId;
+                    const message = params.message;
+                    if (!conversationId || !message) {
+                        return { callId, success: false, result: null, error: 'reply requires conversationId and message' };
+                    }
+                    await xmtpClient.sendMessage(conversationId, message);
+                    return {
+                        callId,
+                        success: true,
+                        result: `Reply sent to conversation ${conversationId}`,
+                    };
+                }
+                default:
+                    return {
+                        callId,
+                        success: false,
+                        result: null,
+                        error: `Unknown action: ${action}. Available: send_message, send_dm, read_messages, list_convos, check_inbox, reply`,
+                    };
+            }
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return { callId, success: false, result: null, error: `XMTP error: ${msg}` };
+        }
+    },
+};
+//# sourceMappingURL=xmtp.js.map

package/dist/skills/xmtp.js.map

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

package/dist/state/index.d.ts

@@ -5,6 +5,8 @@
  * and SOUL.md content. All data is local — the agent owns its own state.
  */
 import type { ClawtomatonIdentity, SurvivalState, ConversationTurn, ActivationResult } from '../types.js';
+import type { BunkerState, ThreatLevel } from '../bunker/types.js';
+import type { TraderPosition, TraderTrade, TraderSnapshot, TraderStorage, RiskConfig, RiskStorage } from '@clawnch/clawncher-sdk';
 export declare class StateStore {
     private db;
     constructor(stateDir: string);
@@ -32,6 +34,29 @@ export declare class StateStore {
     delete(key: string): void;
     getSoul(): string;
     setSoul(content: string): void;
+    saveBunkerState(state: BunkerState): void;
+    getBunkerState(): BunkerState | null;
+    updateBunkerThreat(level: ThreatLevel): void;
+    addBunkerClone(cloneId: string): void;
+    removeBunkerClone(cloneId: string): void;
+    getOrders(): import('@clawnch/clawncher-sdk').Order[];
+    saveOrders(orders: import('@clawnch/clawncher-sdk').Order[]): void;
+    getRiskConfig(): RiskConfig | null;
+    saveRiskConfig(config: RiskConfig): void;
+    getTraderPositions(): TraderPosition[];
+    saveTraderPositions(positions: TraderPosition[]): void;
+    getTraderTrades(): TraderTrade[];
+    saveTraderTrades(trades: TraderTrade[]): void;
+    getTraderSnapshots(): TraderSnapshot[];
+    saveTraderSnapshots(snapshots: TraderSnapshot[]): void;
+    /**
+     * Get a TraderStorage adapter for use with ClawnchTrader.
+     */
+    asTraderStorage(): TraderStorage;
+    /**
+     * Get a RiskStorage adapter for use with ClawnchOrders.
+     */
+    asRiskStorage(): RiskStorage;
     close(): void;
 }
 export interface AuditEntry {

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EACb,gBAAgB,EAGhB,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAMrB,qBAAa,UAAU;IACrB,OAAO,CAAC,EAAE,CAAoB;gBAElB,QAAQ,EAAE,MAAM;IAa5B,OAAO,CAAC,OAAO;IAkEf,YAAY,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAiBjD,WAAW,IAAI,mBAAmB,GAAG,IAAI;IAgBzC,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAU1F,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAO9C,aAAa,IAAI,gBAAgB,GAAG,IAAI;IAUxC,WAAW,IAAI,OAAO;IAQtB,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAcxC,WAAW,IAAI,aAAa;IA0B5B,OAAO,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAarC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAc7C,YAAY,IAAI,MAAM;IAKtB,YAAY,IAAI,IAAI;IAQpB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAK7C,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAO9D,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAK7C,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAW7D,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAM7D,WAAW,CAAC,KAAK,GAAE,MAAY,GAAG,UAAU,EAAE;IAU9C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAOrC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAK/B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQzB,OAAO,IAAI,MAAM;IAIjB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAS9B,KAAK,IAAI,IAAI;CAGd;AAMD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"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"}