fourmm 0.1.0

package/dist/contracts/tokenManager2.js

@@ -0,0 +1,108 @@
+/**
+ * viem ABI binding for TokenManager2.
+ *
+ * Only the methods fourMM trade commands need: buyTokenAMAP, sellToken, createToken.
+ * Address is resolved at runtime via Helper3.getTokenInfo().tokenManager.
+ */
+export const tokenManager2Abi = [
+    // ---- Buy ----
+    {
+        type: 'function',
+        name: 'buyTokenAMAP',
+        stateMutability: 'payable',
+        inputs: [
+            { name: 'token', type: 'address' },
+            { name: 'funds', type: 'uint256' },
+            { name: 'minAmount', type: 'uint256' },
+        ],
+        outputs: [],
+    },
+    {
+        type: 'function',
+        name: 'buyTokenAMAP',
+        stateMutability: 'payable',
+        inputs: [
+            { name: 'token', type: 'address' },
+            { name: 'to', type: 'address' },
+            { name: 'funds', type: 'uint256' },
+            { name: 'minAmount', type: 'uint256' },
+        ],
+        outputs: [],
+    },
+    // ---- Sell ----
+    {
+        type: 'function',
+        name: 'sellToken',
+        stateMutability: 'nonpayable',
+        inputs: [
+            { name: 'token', type: 'address' },
+            { name: 'amount', type: 'uint256' },
+        ],
+        outputs: [],
+    },
+    // ---- Create ----
+    {
+        type: 'function',
+        name: 'createToken',
+        stateMutability: 'payable',
+        inputs: [
+            { name: 'createArg', type: 'bytes' },
+            { name: 'signature', type: 'bytes' },
+        ],
+        outputs: [],
+    },
+    // ---- Events (for TxTracker / receipt parsing) ----
+    {
+        type: 'event',
+        name: 'TokenCreate',
+        inputs: [
+            { name: 'creator', type: 'address', indexed: false },
+            { name: 'token', type: 'address', indexed: false },
+            { name: 'requestId', type: 'uint256', indexed: false },
+            { name: 'name', type: 'string', indexed: false },
+            { name: 'symbol', type: 'string', indexed: false },
+            { name: 'totalSupply', type: 'uint256', indexed: false },
+            { name: 'launchTime', type: 'uint256', indexed: false },
+            { name: 'launchFee', type: 'uint256', indexed: false },
+        ],
+    },
+    {
+        type: 'event',
+        name: 'TokenPurchase',
+        inputs: [
+            { name: 'token', type: 'address', indexed: false },
+            { name: 'account', type: 'address', indexed: false },
+            { name: 'price', type: 'uint256', indexed: false },
+            { name: 'amount', type: 'uint256', indexed: false },
+            { name: 'cost', type: 'uint256', indexed: false },
+            { name: 'fee', type: 'uint256', indexed: false },
+            { name: 'offers', type: 'uint256', indexed: false },
+            { name: 'funds', type: 'uint256', indexed: false },
+        ],
+    },
+    {
+        type: 'event',
+        name: 'TokenSale',
+        inputs: [
+            { name: 'token', type: 'address', indexed: false },
+            { name: 'account', type: 'address', indexed: false },
+            { name: 'price', type: 'uint256', indexed: false },
+            { name: 'amount', type: 'uint256', indexed: false },
+            { name: 'cost', type: 'uint256', indexed: false },
+            { name: 'fee', type: 'uint256', indexed: false },
+            { name: 'offers', type: 'uint256', indexed: false },
+            { name: 'funds', type: 'uint256', indexed: false },
+        ],
+    },
+    {
+        type: 'event',
+        name: 'LiquidityAdded',
+        inputs: [
+            { name: 'base', type: 'address', indexed: false },
+            { name: 'offers', type: 'uint256', indexed: false },
+            { name: 'quote', type: 'address', indexed: false },
+            { name: 'funds', type: 'uint256', indexed: false },
+        ],
+    },
+];
+//# sourceMappingURL=tokenManager2.js.map

package/dist/contracts/tokenManager2.js.map

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

package/dist/contracts/tokenManagerHelper3.d.ts

@@ -0,0 +1,118 @@
+/**
+ * viem ABI binding for TokenManagerHelper3.
+ *
+ * Only the methods fourMM uses are declared here — we don't need the full ABI.
+ *
+ * Source: docs/API-Documents.03-03-2026.md §TokenManagerHelper3 (V3)
+ * Address: 0xF251F83e40a78868FcfA3FA4599Dad6494E46034 (BSC mainnet)
+ */
+export declare const tokenManagerHelper3Abi: readonly [{
+    readonly type: "function";
+    readonly name: "getTokenInfo";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "version";
+        readonly type: "uint256";
+    }, {
+        readonly name: "tokenManager";
+        readonly type: "address";
+    }, {
+        readonly name: "quote";
+        readonly type: "address";
+    }, {
+        readonly name: "lastPrice";
+        readonly type: "uint256";
+    }, {
+        readonly name: "tradingFeeRate";
+        readonly type: "uint256";
+    }, {
+        readonly name: "minTradingFee";
+        readonly type: "uint256";
+    }, {
+        readonly name: "launchTime";
+        readonly type: "uint256";
+    }, {
+        readonly name: "offers";
+        readonly type: "uint256";
+    }, {
+        readonly name: "maxOffers";
+        readonly type: "uint256";
+    }, {
+        readonly name: "funds";
+        readonly type: "uint256";
+    }, {
+        readonly name: "maxFunds";
+        readonly type: "uint256";
+    }, {
+        readonly name: "liquidityAdded";
+        readonly type: "bool";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "tryBuy";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "funds";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "tokenManager";
+        readonly type: "address";
+    }, {
+        readonly name: "quote";
+        readonly type: "address";
+    }, {
+        readonly name: "estimatedAmount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "estimatedCost";
+        readonly type: "uint256";
+    }, {
+        readonly name: "estimatedFee";
+        readonly type: "uint256";
+    }, {
+        readonly name: "amountMsgValue";
+        readonly type: "uint256";
+    }, {
+        readonly name: "amountApproval";
+        readonly type: "uint256";
+    }, {
+        readonly name: "amountFunds";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "trySell";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "tokenManager";
+        readonly type: "address";
+    }, {
+        readonly name: "quote";
+        readonly type: "address";
+    }, {
+        readonly name: "funds";
+        readonly type: "uint256";
+    }, {
+        readonly name: "fee";
+        readonly type: "uint256";
+    }];
+}];
+//# sourceMappingURL=tokenManagerHelper3.d.ts.map

package/dist/contracts/tokenManagerHelper3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenManagerHelper3.d.ts","sourceRoot":"","sources":["../../src/contracts/tokenManagerHelper3.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwDzB,CAAA"}

package/dist/contracts/tokenManagerHelper3.js

@@ -0,0 +1,66 @@
+/**
+ * viem ABI binding for TokenManagerHelper3.
+ *
+ * Only the methods fourMM uses are declared here — we don't need the full ABI.
+ *
+ * Source: docs/API-Documents.03-03-2026.md §TokenManagerHelper3 (V3)
+ * Address: 0xF251F83e40a78868FcfA3FA4599Dad6494E46034 (BSC mainnet)
+ */
+export const tokenManagerHelper3Abi = [
+    {
+        type: 'function',
+        name: 'getTokenInfo',
+        stateMutability: 'view',
+        inputs: [{ name: 'token', type: 'address' }],
+        outputs: [
+            { name: 'version', type: 'uint256' },
+            { name: 'tokenManager', type: 'address' },
+            { name: 'quote', type: 'address' },
+            { name: 'lastPrice', type: 'uint256' },
+            { name: 'tradingFeeRate', type: 'uint256' },
+            { name: 'minTradingFee', type: 'uint256' },
+            { name: 'launchTime', type: 'uint256' },
+            { name: 'offers', type: 'uint256' },
+            { name: 'maxOffers', type: 'uint256' },
+            { name: 'funds', type: 'uint256' },
+            { name: 'maxFunds', type: 'uint256' },
+            { name: 'liquidityAdded', type: 'bool' },
+        ],
+    },
+    {
+        type: 'function',
+        name: 'tryBuy',
+        stateMutability: 'view',
+        inputs: [
+            { name: 'token', type: 'address' },
+            { name: 'amount', type: 'uint256' },
+            { name: 'funds', type: 'uint256' },
+        ],
+        outputs: [
+            { name: 'tokenManager', type: 'address' },
+            { name: 'quote', type: 'address' },
+            { name: 'estimatedAmount', type: 'uint256' },
+            { name: 'estimatedCost', type: 'uint256' },
+            { name: 'estimatedFee', type: 'uint256' },
+            { name: 'amountMsgValue', type: 'uint256' },
+            { name: 'amountApproval', type: 'uint256' },
+            { name: 'amountFunds', type: 'uint256' },
+        ],
+    },
+    {
+        type: 'function',
+        name: 'trySell',
+        stateMutability: 'view',
+        inputs: [
+            { name: 'token', type: 'address' },
+            { name: 'amount', type: 'uint256' },
+        ],
+        outputs: [
+            { name: 'tokenManager', type: 'address' },
+            { name: 'quote', type: 'address' },
+            { name: 'funds', type: 'uint256' },
+            { name: 'fee', type: 'uint256' },
+        ],
+    },
+];
+//# sourceMappingURL=tokenManagerHelper3.js.map

package/dist/contracts/tokenManagerHelper3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenManagerHelper3.js","sourceRoot":"","sources":["../../src/contracts/tokenManagerHelper3.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,cAAc;QACpB,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC5C,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;YACpC,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,SAAS,EAAE;YACzC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;YAClC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;YACtC,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,SAAS,EAAE;YAC3C,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,SAAS,EAAE;YAC1C,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE;YACvC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;YACnC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;YACtC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;YAClC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE;YACrC,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE;SACzC;KACF;IACD;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,QAAQ;QACd,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;YAClC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;YACnC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;SACnC;QACD,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,SAAS,EAAE;YACzC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;YAClC,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,SAAS,EAAE;YAC5C,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,SAAS,EAAE;YAC1C,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,SAAS,EAAE;YACzC,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,SAAS,EAAE;YAC3C,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,SAAS,EAAE;YAC3C,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE;SACzC;KACF;IACD;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,SAAS;QACf,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;YAClC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;SACpC;QACD,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,SAAS,EAAE;YACzC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;YAClC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;YAClC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE;SACjC;KACF;CACO,CAAA"}

package/dist/datastore/cache.d.ts

@@ -0,0 +1,20 @@
+/**
+ * In-process memory cache with TTL.
+ *
+ * Used by DataStore to avoid re-reading JSON from disk on every call.
+ * Entry is invalidated on write and expires after `ttlMs`.
+ */
+export declare class MemoryCache {
+    private readonly ttlMs;
+    private store;
+    constructor(ttlMs?: number);
+    get<T>(key: string): T | undefined;
+    set<T>(key: string, value: T, ttlMs?: number): void;
+    invalidate(key: string): void;
+    /** Drop all entries whose key starts with prefix (e.g. "token:<ca>:") */
+    invalidatePrefix(prefix: string): void;
+    clear(): void;
+    /** Test helper: number of live (not yet expired) entries */
+    size(): number;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/datastore/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/datastore/cache.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,qBAAa,WAAW;IAEV,OAAO,CAAC,QAAQ,CAAC,KAAK;IADlC,OAAO,CAAC,KAAK,CAAoC;gBACpB,KAAK,GAAE,MAAe;IAEnD,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAUlC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAKnD,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI7B,yEAAyE;IACzE,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAMtC,KAAK,IAAI,IAAI;IAIb,4DAA4D;IAC5D,IAAI,IAAI,MAAM;CAGf"}

package/dist/datastore/cache.js

@@ -0,0 +1,45 @@
+/**
+ * In-process memory cache with TTL.
+ *
+ * Used by DataStore to avoid re-reading JSON from disk on every call.
+ * Entry is invalidated on write and expires after `ttlMs`.
+ */
+export class MemoryCache {
+    ttlMs;
+    store = new Map();
+    constructor(ttlMs = 30_000) {
+        this.ttlMs = ttlMs;
+    }
+    get(key) {
+        const e = this.store.get(key);
+        if (!e)
+            return undefined;
+        if (Date.now() >= e.expiresAt) {
+            this.store.delete(key);
+            return undefined;
+        }
+        return e.value;
+    }
+    set(key, value, ttlMs) {
+        const ttl = ttlMs ?? this.ttlMs;
+        this.store.set(key, { value, expiresAt: Date.now() + ttl });
+    }
+    invalidate(key) {
+        this.store.delete(key);
+    }
+    /** Drop all entries whose key starts with prefix (e.g. "token:<ca>:") */
+    invalidatePrefix(prefix) {
+        for (const k of this.store.keys()) {
+            if (k.startsWith(prefix))
+                this.store.delete(k);
+        }
+    }
+    clear() {
+        this.store.clear();
+    }
+    /** Test helper: number of live (not yet expired) entries */
+    size() {
+        return this.store.size;
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/datastore/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/datastore/cache.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,MAAM,OAAO,WAAW;IAEO;IADrB,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAA;IACjD,YAA6B,QAAgB,MAAM;QAAtB,UAAK,GAAL,KAAK,CAAiB;IAAG,CAAC;IAEvD,GAAG,CAAI,GAAW;QAChB,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAC7B,IAAI,CAAC,CAAC;YAAE,OAAO,SAAS,CAAA;QACxB,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;YAC9B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YACtB,OAAO,SAAS,CAAA;QAClB,CAAC;QACD,OAAO,CAAC,CAAC,KAAU,CAAA;IACrB,CAAC;IAED,GAAG,CAAI,GAAW,EAAE,KAAQ,EAAE,KAAc;QAC1C,MAAM,GAAG,GAAG,KAAK,IAAI,IAAI,CAAC,KAAK,CAAA;QAC/B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC,CAAA;IAC7D,CAAC;IAED,UAAU,CAAC,GAAW;QACpB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IACxB,CAAC;IAED,yEAAyE;IACzE,gBAAgB,CAAC,MAAc;QAC7B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YAClC,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC;gBAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;QAChD,CAAC;IACH,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;IACpB,CAAC;IAED,4DAA4D;IAC5D,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAA;IACxB,CAAC;CACF"}

package/dist/datastore/index.d.ts

@@ -0,0 +1,85 @@
+/**
+ * DataStore — local JSON store at ~/.fourmm/data/.
+ *
+ * Responsibilities:
+ *   - Persist token metadata, pool info, transaction history, holdings, balances
+ *   - Atomic writes (write .tmp, rename) to avoid half-written files
+ *   - Memory cache per key with TTL (default 30s)
+ *
+ * What it does NOT do:
+ *   - Cross-process locking. CLI is single-process; parallel invocations
+ *     can race on writes. If Week 3 Router daemons need parallel writes we
+ *     add a lockfile then.
+ *   - Pretty printing control / schema migration (we'll version if needed).
+ *
+ * Public surface is a class with a singleton accessor so tests can inject
+ * a fresh instance. Paths come from datastore/paths.ts which reads HOME
+ * lazily, so redirecting HOME per test works.
+ */
+import { MemoryCache } from './cache.js';
+import type { BalancesFile, BnbPriceFile, HoldingsFile, PoolInfoFile, TokenInfoFile, TransactionRecord, TransactionsFile, WalletBalance, WalletHolding } from './types.js';
+import type { Address } from 'viem';
+export * from './types.js';
+export { MemoryCache } from './cache.js';
+export declare class DataStore {
+    readonly cache: MemoryCache;
+    constructor(ttlMs?: number);
+    getTokenInfo(ca: Address): TokenInfoFile | null;
+    saveTokenInfo(info: TokenInfoFile): void;
+    getPoolInfo(ca: Address): PoolInfoFile | null;
+    savePoolInfo(info: PoolInfoFile): void;
+    getTransactions(ca: Address, groupId: number): TransactionsFile | null;
+    /**
+     * Append a transaction to the group's history, deduped by txHash.
+     * Always reads fresh from disk (no cache) to avoid losing a concurrent append.
+     */
+    appendTransaction(ca: Address, groupId: number, tx: TransactionRecord): void;
+    getHoldings(ca: Address, groupId: number): HoldingsFile | null;
+    /**
+     * Upsert a single wallet's holding.
+     * Merges with existing (by walletAddress); creates the file if missing.
+     */
+    updateHolding(ca: Address, groupId: number, wallet: Address, patch: Partial<WalletHolding>): void;
+    getBalances(ca: Address, groupId: number): BalancesFile | null;
+    /**
+     * Partial upsert of a single wallet's balance.
+     *
+     * IMPORTANT: patch semantics — any field you DON'T pass keeps its previous
+     * value. This avoids the bug where a BNB-only refresh would clobber a
+     * stored tokenBalance. `updatedAt` is always bumped to now.
+     *
+     * If the wallet has no existing row, missing fields default to 0.
+     */
+    updateBalance(ca: Address, groupId: number, walletAddress: Address, patch: Partial<Omit<WalletBalance, 'walletAddress' | 'updatedAt'>>): void;
+    /**
+     * Batch variant: apply a list of patches in one file write.
+     * Each patch must include `walletAddress` so we know which row to merge.
+     */
+    updateBalancesBatch(ca: Address, groupId: number, patches: Array<{
+        walletAddress: Address;
+    } & Partial<Omit<WalletBalance, 'walletAddress' | 'updatedAt'>>>): void;
+    getBnbPrice(): BnbPriceFile | null;
+    saveBnbPrice(priceUsd: number): void;
+    /**
+     * List all token CA directories we have data for.
+     *
+     * Excludes `NATIVE_BNB` (the sentinel CA used for BNB transfer history) so
+     * callers iterating "for each known token" don't hit version=0 reverts on
+     * the zero address.
+     */
+    listTokens(): Address[];
+    /**
+     * List the groups that have native BNB transfer history.
+     * Separate from `listTokens` so downstream monitor/PnL code can treat
+     * BNB history distinctly from token holdings.
+     */
+    listNativeBnbGroups(): number[];
+    listGroups(ca: Address): number[];
+    /** Ensure the group directory exists (useful before running a session) */
+    ensureGroupDir(ca: Address, groupId: number): void;
+}
+/** Get the global DataStore. Tests that need isolation should use `new DataStore()`. */
+export declare function getDataStore(): DataStore;
+/** Reset the singleton (test helper) */
+export declare function resetDataStore(): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/datastore/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAaxC,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,aAAa,EACd,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAGnC,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAwCxC,qBAAa,SAAS;IACpB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;gBAEf,KAAK,SAAS;IAM1B,YAAY,CAAC,EAAE,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI;IAU/C,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI;IAQxC,WAAW,CAAC,EAAE,EAAE,OAAO,GAAG,YAAY,GAAG,IAAI;IAU7C,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAQtC,eAAe,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAKtE;;;OAGG;IACH,iBAAiB,CACf,EAAE,EAAE,OAAO,EACX,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,iBAAiB,GACpB,IAAI;IAuBP,WAAW,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAU9D;;;OAGG;IACH,aAAa,CACX,EAAE,EAAE,OAAO,EACX,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,GAC5B,IAAI;IAgCP,WAAW,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAU9D;;;;;;;;OAQG;IACH,aAAa,CACX,EAAE,EAAE,OAAO,EACX,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,OAAO,EACtB,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,eAAe,GAAG,WAAW,CAAC,CAAC,GACjE,IAAI;IAiCP;;;OAGG;IACH,mBAAmB,CACjB,EAAE,EAAE,OAAO,EACX,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,KAAK,CAAC;QAAE,aAAa,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,eAAe,GAAG,WAAW,CAAC,CAAC,CAAC,GACvG,IAAI;IAgCP,WAAW,IAAI,YAAY,GAAG,IAAI;IAQlC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAWpC;;;;;;OAMG;IACH,UAAU,IAAI,OAAO,EAAE;IAWvB;;;;OAIG;IACH,mBAAmB,IAAI,MAAM,EAAE;IAK/B,UAAU,CAAC,EAAE,EAAE,OAAO,GAAG,MAAM,EAAE;IAYjC,0EAA0E;IAC1E,cAAc,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;CAOnD;AAQD,wFAAwF;AACxF,wBAAgB,YAAY,IAAI,SAAS,CAGxC;AAED,wCAAwC;AACxC,wBAAgB,cAAc,IAAI,IAAI,CAErC"}