fourmm 0.1.0

package/dist/datastore/index.js

@@ -0,0 +1,341 @@
+/**
+ * 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 fs from 'node:fs';
+import path from 'node:path';
+import { MemoryCache } from './cache.js';
+import { balancesPath, bnbPricePath, globalDir, groupDir, holdingsPath, poolInfoPath, tokenDir, tokenInfoPath, tokensRoot, transactionsPath, } from './paths.js';
+// Re-export types so consumers only need one import path
+export * from './types.js';
+export { MemoryCache } from './cache.js';
+// ============================================================
+// Internal helpers
+// ============================================================
+function atomicWriteJson(filePath, data) {
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+    }
+    const tmpPath = `${filePath}.tmp`;
+    fs.writeFileSync(tmpPath, JSON.stringify(data, null, 2), {
+        encoding: 'utf-8',
+        mode: 0o600,
+    });
+    fs.renameSync(tmpPath, filePath);
+}
+function readJson(filePath) {
+    if (!fs.existsSync(filePath))
+        return null;
+    try {
+        const raw = fs.readFileSync(filePath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        // Corrupt file: let the caller decide whether to rewrite or error
+        return null;
+    }
+}
+function validateCa(ca) {
+    if (!ca || ca.includes('/') || ca.includes('\\') || ca.includes('..')) {
+        throw new Error(`Invalid CA: "${ca}"`);
+    }
+}
+// ============================================================
+// DataStore
+// ============================================================
+export class DataStore {
+    cache;
+    constructor(ttlMs = 30_000) {
+        this.cache = new MemoryCache(ttlMs);
+    }
+    // ----- token-info.json -----
+    getTokenInfo(ca) {
+        validateCa(ca);
+        const key = `token:${ca}`;
+        const cached = this.cache.get(key);
+        if (cached)
+            return cached;
+        const data = readJson(tokenInfoPath(ca));
+        if (data)
+            this.cache.set(key, data);
+        return data;
+    }
+    saveTokenInfo(info) {
+        validateCa(info.ca);
+        atomicWriteJson(tokenInfoPath(info.ca), info);
+        this.cache.set(`token:${info.ca}`, info);
+    }
+    // ----- pool-info.json -----
+    getPoolInfo(ca) {
+        validateCa(ca);
+        const key = `pool:${ca}`;
+        const cached = this.cache.get(key);
+        if (cached)
+            return cached;
+        const data = readJson(poolInfoPath(ca));
+        if (data)
+            this.cache.set(key, data);
+        return data;
+    }
+    savePoolInfo(info) {
+        validateCa(info.ca);
+        atomicWriteJson(poolInfoPath(info.ca), info);
+        this.cache.set(`pool:${info.ca}`, info);
+    }
+    // ----- transactions.json -----
+    getTransactions(ca, groupId) {
+        validateCa(ca);
+        return readJson(transactionsPath(ca, groupId));
+    }
+    /**
+     * 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, groupId, tx) {
+        validateCa(ca);
+        const file = transactionsPath(ca, groupId);
+        let current = readJson(file);
+        if (!current) {
+            current = {
+                ca,
+                groupId,
+                transactions: [],
+                updatedAt: Date.now(),
+            };
+        }
+        // Dedupe by txHash
+        if (current.transactions.some((t) => t.txHash === tx.txHash)) {
+            return;
+        }
+        current.transactions.push(tx);
+        current.updatedAt = Date.now();
+        atomicWriteJson(file, current);
+    }
+    // ----- holdings.json -----
+    getHoldings(ca, groupId) {
+        validateCa(ca);
+        const key = `holdings:${ca}:${groupId}`;
+        const cached = this.cache.get(key);
+        if (cached)
+            return cached;
+        const data = readJson(holdingsPath(ca, groupId));
+        if (data)
+            this.cache.set(key, data);
+        return data;
+    }
+    /**
+     * Upsert a single wallet's holding.
+     * Merges with existing (by walletAddress); creates the file if missing.
+     */
+    updateHolding(ca, groupId, wallet, patch) {
+        validateCa(ca);
+        const file = holdingsPath(ca, groupId);
+        let current = readJson(file);
+        if (!current) {
+            current = { ca, groupId, wallets: [], updatedAt: Date.now() };
+        }
+        const idx = current.wallets.findIndex((w) => w.walletAddress === wallet);
+        if (idx === -1) {
+            const blank = {
+                walletAddress: wallet,
+                tokenBalance: 0,
+                avgBuyPrice: 0,
+                totalBought: 0,
+                totalSold: 0,
+                totalCostBnb: 0,
+                totalRevenueBnb: 0,
+                realizedPnl: 0,
+                ...patch,
+            };
+            current.wallets.push(blank);
+        }
+        else {
+            current.wallets[idx] = { ...current.wallets[idx], ...patch };
+        }
+        current.updatedAt = Date.now();
+        atomicWriteJson(file, current);
+        this.cache.set(`holdings:${ca}:${groupId}`, current);
+    }
+    // ----- balances.json -----
+    getBalances(ca, groupId) {
+        validateCa(ca);
+        const key = `balances:${ca}:${groupId}`;
+        const cached = this.cache.get(key);
+        if (cached)
+            return cached;
+        const data = readJson(balancesPath(ca, groupId));
+        if (data)
+            this.cache.set(key, data);
+        return data;
+    }
+    /**
+     * 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, groupId, walletAddress, patch) {
+        validateCa(ca);
+        const file = balancesPath(ca, groupId);
+        let current = readJson(file);
+        if (!current) {
+            current = { ca, groupId, balances: [], updatedAt: Date.now() };
+        }
+        const idx = current.balances.findIndex((b) => b.walletAddress === walletAddress);
+        const now = Date.now();
+        const base = idx >= 0
+            ? current.balances[idx]
+            : {
+                walletAddress,
+                bnbBalance: 0,
+                tokenBalance: 0,
+                updatedAt: now,
+            };
+        const merged = {
+            ...base,
+            ...patch,
+            walletAddress,
+            updatedAt: now,
+        };
+        if (idx === -1)
+            current.balances.push(merged);
+        else
+            current.balances[idx] = merged;
+        current.updatedAt = now;
+        atomicWriteJson(file, current);
+        this.cache.set(`balances:${ca}:${groupId}`, current);
+    }
+    /**
+     * 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, groupId, patches) {
+        if (patches.length === 0)
+            return;
+        validateCa(ca);
+        const file = balancesPath(ca, groupId);
+        let current = readJson(file);
+        if (!current) {
+            current = { ca, groupId, balances: [], updatedAt: Date.now() };
+        }
+        const now = Date.now();
+        const byAddr = new Map(current.balances.map((b) => [b.walletAddress, b]));
+        for (const patch of patches) {
+            const base = byAddr.get(patch.walletAddress) ?? {
+                walletAddress: patch.walletAddress,
+                bnbBalance: 0,
+                tokenBalance: 0,
+                updatedAt: now,
+            };
+            byAddr.set(patch.walletAddress, {
+                ...base,
+                ...patch,
+                walletAddress: patch.walletAddress,
+                updatedAt: now,
+            });
+        }
+        current.balances = Array.from(byAddr.values());
+        current.updatedAt = now;
+        atomicWriteJson(file, current);
+        this.cache.set(`balances:${ca}:${groupId}`, current);
+    }
+    // ----- global/bnb-price.json -----
+    getBnbPrice() {
+        const cached = this.cache.get('global:bnb-price');
+        if (cached)
+            return cached;
+        const data = readJson(bnbPricePath());
+        if (data)
+            this.cache.set('global:bnb-price', data);
+        return data;
+    }
+    saveBnbPrice(priceUsd) {
+        const file = { priceUsd, updatedAt: Date.now() };
+        if (!fs.existsSync(globalDir())) {
+            fs.mkdirSync(globalDir(), { recursive: true, mode: 0o700 });
+        }
+        atomicWriteJson(bnbPricePath(), file);
+        this.cache.set('global:bnb-price', file);
+    }
+    // ----- Directory listing -----
+    /**
+     * 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() {
+        const root = tokensRoot();
+        if (!fs.existsSync(root))
+            return [];
+        const NATIVE_BNB = '0x0000000000000000000000000000000000000000';
+        return fs
+            .readdirSync(root, { withFileTypes: true })
+            .filter((d) => d.isDirectory())
+            .map((d) => d.name)
+            .filter((addr) => addr.toLowerCase() !== NATIVE_BNB);
+    }
+    /**
+     * 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() {
+        const NATIVE_BNB = '0x0000000000000000000000000000000000000000';
+        return this.listGroups(NATIVE_BNB);
+    }
+    listGroups(ca) {
+        validateCa(ca);
+        const groupsRoot = path.join(tokenDir(ca), 'groups');
+        if (!fs.existsSync(groupsRoot))
+            return [];
+        return fs
+            .readdirSync(groupsRoot, { withFileTypes: true })
+            .filter((d) => d.isDirectory())
+            .map((d) => Number.parseInt(d.name, 10))
+            .filter((n) => Number.isInteger(n))
+            .sort((a, b) => a - b);
+    }
+    /** Ensure the group directory exists (useful before running a session) */
+    ensureGroupDir(ca, groupId) {
+        validateCa(ca);
+        const dir = groupDir(ca, groupId);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+        }
+    }
+}
+// ============================================================
+// Singleton
+// ============================================================
+let _instance = null;
+/** Get the global DataStore. Tests that need isolation should use `new DataStore()`. */
+export function getDataStore() {
+    if (!_instance)
+        _instance = new DataStore();
+    return _instance;
+}
+/** Reset the singleton (test helper) */
+export function resetDataStore() {
+    _instance = null;
+}
+//# sourceMappingURL=index.js.map

package/dist/datastore/index.js.map

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

package/dist/datastore/paths.d.ts

@@ -0,0 +1,17 @@
+/**
+ * DataStore path construction.
+ *
+ * All functions are lazy (read HOME on each call) so tests can redirect
+ * without resetting modules. Lives under ~/.fourmm/data/.
+ */
+export declare function tokensRoot(): string;
+export declare function tokenDir(ca: string): string;
+export declare function tokenInfoPath(ca: string): string;
+export declare function poolInfoPath(ca: string): string;
+export declare function groupDir(ca: string, groupId: number): string;
+export declare function transactionsPath(ca: string, groupId: number): string;
+export declare function holdingsPath(ca: string, groupId: number): string;
+export declare function balancesPath(ca: string, groupId: number): string;
+export declare function globalDir(): string;
+export declare function bnbPricePath(): string;
+//# sourceMappingURL=paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/datastore/paths.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,wBAAgB,YAAY,IAAI,MAAM,CAErC"}

package/dist/datastore/paths.js

@@ -0,0 +1,39 @@
+/**
+ * DataStore path construction.
+ *
+ * All functions are lazy (read HOME on each call) so tests can redirect
+ * without resetting modules. Lives under ~/.fourmm/data/.
+ */
+import path from 'node:path';
+import { dataDir } from '../lib/config.js';
+export function tokensRoot() {
+    return path.join(dataDir(), 'tokens');
+}
+export function tokenDir(ca) {
+    return path.join(tokensRoot(), ca);
+}
+export function tokenInfoPath(ca) {
+    return path.join(tokenDir(ca), 'token-info.json');
+}
+export function poolInfoPath(ca) {
+    return path.join(tokenDir(ca), 'pool-info.json');
+}
+export function groupDir(ca, groupId) {
+    return path.join(tokenDir(ca), 'groups', String(groupId));
+}
+export function transactionsPath(ca, groupId) {
+    return path.join(groupDir(ca, groupId), 'transactions.json');
+}
+export function holdingsPath(ca, groupId) {
+    return path.join(groupDir(ca, groupId), 'holdings.json');
+}
+export function balancesPath(ca, groupId) {
+    return path.join(groupDir(ca, groupId), 'balances.json');
+}
+export function globalDir() {
+    return path.join(dataDir(), 'global');
+}
+export function bnbPricePath() {
+    return path.join(globalDir(), 'bnb-price.json');
+}
+//# sourceMappingURL=paths.js.map

package/dist/datastore/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/datastore/paths.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAE1C,MAAM,UAAU,UAAU;IACxB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAA;AACvC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,EAAU;IACjC,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,EAAE,CAAC,CAAA;AACpC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,EAAU;IACtC,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,iBAAiB,CAAC,CAAA;AACnD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,EAAU;IACrC,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,gBAAgB,CAAC,CAAA;AAClD,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,EAAU,EAAE,OAAe;IAClD,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAA;AAC3D,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,EAAU,EAAE,OAAe;IAC1D,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,mBAAmB,CAAC,CAAA;AAC9D,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,EAAU,EAAE,OAAe;IACtD,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,eAAe,CAAC,CAAA;AAC1D,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,EAAU,EAAE,OAAe;IACtD,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,eAAe,CAAC,CAAA;AAC1D,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAA;AACvC,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,gBAAgB,CAAC,CAAA;AACjD,CAAC"}

package/dist/datastore/types.d.ts

@@ -0,0 +1,105 @@
+/**
+ * DataStore type definitions.
+ *
+ * File formats for ~/.fourmm/data/. Each type corresponds to a JSON file on
+ * disk. All timestamps are Unix milliseconds unless otherwise noted.
+ */
+import type { Address, Hash, Hex } from 'viem';
+export type TokenVariant = 'standard' | 'anti-sniper-fee' | 'tax-token' | 'x-mode';
+export type TokenInfoFile = {
+    ca: Address;
+    symbol: string;
+    name: string;
+    decimals: number;
+    creatorAddress: Address | '';
+    /** Four.meme internal version (1 or 2) */
+    version: 1 | 2;
+    /** Variant detected from template / feeSetting */
+    variant: TokenVariant;
+    /** Address of the TokenManager that owns this token (V1 or V2) */
+    tokenManager: Address;
+    /** Quote token — 0x0000... for BNB, else BEP20 address */
+    quote: Address;
+    /** Bonding curve top-pair or PancakeSwap LP after graduation */
+    pairAddress: Address | '';
+    /** Set once the bonding curve has graduated */
+    liquidityAdded: boolean;
+    /** Last update (Unix ms) */
+    updatedAt: number;
+};
+/** Trading path a token is currently on */
+export type TradingPathKind = 'bonding-curve' | 'pancake';
+export type PoolInfoFile = {
+    ca: Address;
+    pairAddress: Address | '';
+    /** Which trading path this data describes */
+    path: TradingPathKind;
+    /** BNB-denominated price (float) */
+    priceBnb: number;
+    /** USD price (may be 0 when BNB→USD oracle unavailable) */
+    priceUsd: number;
+    /** Bonding curve progress 0..1 (null after graduation) */
+    graduationProgress: number | null;
+    updatedAt: number;
+};
+export type TxType = 'buy' | 'sell' | 'transfer_in' | 'transfer_out' | 'turnover' | 'volume';
+export type TransactionRecord = {
+    txHash: Hash;
+    txType: TxType;
+    /** Wallet that signed / was the primary subject */
+    walletAddress: Address;
+    tokenCA: Address;
+    /** Signed BNB delta: positive for buy, negative for sell */
+    amountBnb: number;
+    /** Signed token delta */
+    amountToken: number;
+    /** Derived execution price (BNB per token) */
+    pricePerToken: number;
+    /** Gas fee (BNB) */
+    fee: number;
+    blockNumber: number;
+    /** Block timestamp (Unix seconds) */
+    blockTime: number;
+    status: 'confirmed' | 'failed' | 'pending';
+};
+export type TransactionsFile = {
+    ca: Address;
+    groupId: number;
+    transactions: TransactionRecord[];
+    updatedAt: number;
+};
+export type WalletHolding = {
+    walletAddress: Address;
+    tokenBalance: number;
+    avgBuyPrice: number;
+    totalBought: number;
+    totalSold: number;
+    totalCostBnb: number;
+    totalRevenueBnb: number;
+    realizedPnl: number;
+};
+export type HoldingsFile = {
+    ca: Address;
+    groupId: number;
+    wallets: WalletHolding[];
+    updatedAt: number;
+};
+export type WalletBalance = {
+    walletAddress: Address;
+    bnbBalance: number;
+    tokenBalance: number;
+    updatedAt: number;
+};
+export type BalancesFile = {
+    ca: Address;
+    groupId: number;
+    balances: WalletBalance[];
+    updatedAt: number;
+};
+export type BnbPriceFile = {
+    priceUsd: number;
+    updatedAt: number;
+};
+/** Hex-encoded raw transaction input data (kept for audit / replay) */
+export type RawTxData = Hex;
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/datastore/types.js

@@ -0,0 +1,8 @@
+/**
+ * DataStore type definitions.
+ *
+ * File formats for ~/.fourmm/data/. Each type corresponds to a JSON file on
+ * disk. All timestamps are Unix milliseconds unless otherwise noted.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/datastore/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/datastore/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/fourmeme/auth.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Four.meme REST API authentication.
+ *
+ * Flow:
+ *   1. POST /v1/private/user/nonce/generate  → get nonce
+ *   2. Sign message "You are sign in Meme {nonce}" with wallet private key
+ *   3. POST /v1/private/user/login/dex       → get access_token
+ *
+ * The access_token is used for subsequent API calls (upload, create).
+ */
+import type { Hex } from 'viem';
+export type AuthResult = {
+    accessToken: string;
+    walletAddress: string;
+};
+/**
+ * Authenticate with Four.meme and return an access token.
+ */
+export declare function authenticateFourmeme(privateKey: Hex, options?: {
+    fetchImpl?: typeof fetch | undefined;
+}): Promise<AuthResult>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/fourmeme/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/fourmeme/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAA;AAI/B,MAAM,MAAM,UAAU,GAAG;IACvB,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;CACtB,CAAA;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,GAAG,EACf,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,KAAK,GAAG,SAAS,CAAA;CAAO,GACrD,OAAO,CAAC,UAAU,CAAC,CAuErB"}

package/dist/fourmeme/auth.js

@@ -0,0 +1,78 @@
+/**
+ * Four.meme REST API authentication.
+ *
+ * Flow:
+ *   1. POST /v1/private/user/nonce/generate  → get nonce
+ *   2. Sign message "You are sign in Meme {nonce}" with wallet private key
+ *   3. POST /v1/private/user/login/dex       → get access_token
+ *
+ * The access_token is used for subsequent API calls (upload, create).
+ */
+import { privateKeyToAccount } from 'viem/accounts';
+import { loadConfig } from '../lib/config.js';
+/**
+ * Authenticate with Four.meme and return an access token.
+ */
+export async function authenticateFourmeme(privateKey, options = {}) {
+    const fetchFn = options.fetchImpl ?? globalThis.fetch;
+    const config = loadConfig();
+    const apiBase = config.fourmemeApiUrl;
+    const account = privateKeyToAccount(privateKey);
+    const walletAddress = account.address;
+    // Step 1: Get nonce
+    const nonceRes = await fetchFn(`${apiBase}/v1/private/user/nonce/generate`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+            accountAddress: walletAddress,
+            verifyType: 'LOGIN',
+            networkCode: 'BSC',
+        }),
+    });
+    if (!nonceRes.ok) {
+        throw new Error(`Four.meme nonce/generate failed: HTTP ${nonceRes.status}`);
+    }
+    const nonceJson = (await nonceRes.json());
+    if (nonceJson.code !== 0 || !nonceJson.data) {
+        throw new Error(`Four.meme nonce/generate error: ${JSON.stringify(nonceJson)}`);
+    }
+    const nonce = nonceJson.data;
+    // Step 2: Sign the nonce message
+    const message = `You are sign in Meme ${nonce}`;
+    const signature = await account.signMessage({ message });
+    // Step 3: Login (nested verifyInfo format per API docs 02-02-2026)
+    const loginRes = await fetchFn(`${apiBase}/v1/private/user/login/dex`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+            region: 'WEB',
+            langType: 'EN',
+            loginIp: '',
+            inviteCode: '',
+            verifyInfo: {
+                address: walletAddress,
+                networkCode: 'BSC',
+                signature,
+                verifyType: 'LOGIN',
+            },
+            walletName: 'MetaMask',
+        }),
+    });
+    if (!loginRes.ok) {
+        const body = await loginRes.text().catch(() => '');
+        throw new Error(`Four.meme login/dex failed: HTTP ${loginRes.status} ${body}`);
+    }
+    const loginJson = (await loginRes.json());
+    if (loginJson.code !== 0) {
+        throw new Error(`Four.meme login error: ${JSON.stringify(loginJson)}`);
+    }
+    // API may return token as a plain string or as an object with access_token
+    const accessToken = typeof loginJson.data === 'string'
+        ? loginJson.data
+        : (loginJson.data.access_token ?? loginJson.data.accessToken ?? '');
+    if (!accessToken) {
+        throw new Error('Four.meme login succeeded but no access_token returned');
+    }
+    return { accessToken, walletAddress };
+}
+//# sourceMappingURL=auth.js.map

package/dist/fourmeme/auth.js.map

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