@palmyr/cli 1.3.1 → 1.5.0

package/dist/wallet-live-test.js

@@ -0,0 +1,162 @@
+/** Liquid test tokens with tight spreads — minimises slippage on tiny trades. */
+const TEST_MINT_SOLANA = 'JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN';
+const TEST_MINT_BASE = '0x4200000000000000000000000000000000000006'; // WETH
+async function timed(fn) {
+    const t0 = Date.now();
+    try {
+        const value = await fn();
+        return { ok: true, value, durationMs: Date.now() - t0 };
+    }
+    catch (e) {
+        return { ok: false, message: e?.message ?? String(e), durationMs: Date.now() - t0 };
+    }
+}
+export async function runWalletLiveTest(opts) {
+    const startedAt = new Date().toISOString();
+    if (!(opts.budgetUsdc > 0)) {
+        throw new Error('--budget required, e.g. --budget 1usdc');
+    }
+    if (opts.budgetUsdc > 10) {
+        throw new Error(`--budget ${opts.budgetUsdc}usdc exceeds the live-test ceiling ($10). Trade manually for larger sizes.`);
+    }
+    const perLegUsdc = opts.budgetUsdc / 2;
+    const perLegAmountStr = `${perLegUsdc.toFixed(6)}usdc`;
+    const wantSolana = !opts.chain || opts.chain === 'solana' || opts.chain === 'all';
+    const wantBase = !opts.chain || opts.chain === 'base' || opts.chain === 'all';
+    const legs = [];
+    let totalRealizedUsdc = 0;
+    const { resolveWalletAddresses, buy, sell, buyBase, sellBase, listPositions } = await import('./wallet-trading.js');
+    const addrs = await resolveWalletAddresses(opts.walletRef, opts.passphrase);
+    // Solana round trip
+    if (wantSolana && addrs.solanaAddress) {
+        const solBuy = await timed(() => buy({
+            ca: TEST_MINT_SOLANA,
+            amount: perLegAmountStr,
+            thesis: 'live-test round trip',
+            walletRef: opts.walletRef,
+            passphrase: opts.passphrase,
+        }));
+        if (!solBuy.ok) {
+            legs.push({ name: 'solana-buy', chain: 'solana', step: 'buy', status: 'fail', message: solBuy.message, durationMs: solBuy.durationMs });
+        }
+        else {
+            legs.push({
+                name: 'solana-buy',
+                chain: 'solana',
+                step: 'buy',
+                status: 'pass',
+                txHash: solBuy.value.txSignature,
+                amountIn: solBuy.value.amountIn,
+                durationMs: solBuy.durationMs,
+            });
+            const solSell = await timed(() => sell({
+                ca: TEST_MINT_SOLANA,
+                percent: 100,
+                reason: 'live-test close',
+                walletRef: opts.walletRef,
+                passphrase: opts.passphrase,
+            }));
+            if (!solSell.ok) {
+                legs.push({ name: 'solana-sell', chain: 'solana', step: 'sell', status: 'fail', message: solSell.message, durationMs: solSell.durationMs });
+            }
+            else {
+                legs.push({
+                    name: 'solana-sell',
+                    chain: 'solana',
+                    step: 'sell',
+                    status: 'pass',
+                    txHash: solSell.value.txSignature,
+                    output: solSell.value.output,
+                    realized: solSell.value.realized,
+                    durationMs: solSell.durationMs,
+                });
+                if (solSell.value.realized.asset === 'USDC') {
+                    totalRealizedUsdc += solSell.value.realized.amount;
+                }
+            }
+        }
+    }
+    else if (wantSolana) {
+        legs.push({ name: 'solana-buy', chain: 'solana', step: 'buy', status: 'skip', message: 'no Solana address' });
+    }
+    // Base round trip
+    if (wantBase && addrs.evmAddress) {
+        const baseBuy = await timed(() => buyBase({
+            ca: TEST_MINT_BASE,
+            amount: perLegAmountStr,
+            thesis: 'live-test round trip',
+            walletRef: opts.walletRef,
+            passphrase: opts.passphrase,
+        }));
+        if (!baseBuy.ok) {
+            legs.push({ name: 'base-buy', chain: 'base', step: 'buy', status: 'fail', message: baseBuy.message, durationMs: baseBuy.durationMs });
+        }
+        else {
+            legs.push({
+                name: 'base-buy',
+                chain: 'base',
+                step: 'buy',
+                status: 'pass',
+                txHash: baseBuy.value.txHash,
+                amountIn: baseBuy.value.amountIn,
+                durationMs: baseBuy.durationMs,
+            });
+            const baseSell = await timed(() => sellBase({
+                ca: TEST_MINT_BASE,
+                percent: 100,
+                reason: 'live-test close',
+                walletRef: opts.walletRef,
+                passphrase: opts.passphrase,
+            }));
+            if (!baseSell.ok) {
+                legs.push({ name: 'base-sell', chain: 'base', step: 'sell', status: 'fail', message: baseSell.message, durationMs: baseSell.durationMs });
+            }
+            else {
+                legs.push({
+                    name: 'base-sell',
+                    chain: 'base',
+                    step: 'sell',
+                    status: 'pass',
+                    txHash: baseSell.value.txHash,
+                    output: baseSell.value.output,
+                    realized: baseSell.value.realized,
+                    durationMs: baseSell.durationMs,
+                });
+                if (baseSell.value.realized.asset === 'USDC') {
+                    totalRealizedUsdc += baseSell.value.realized.amount;
+                }
+            }
+        }
+    }
+    else if (wantBase) {
+        legs.push({ name: 'base-buy', chain: 'base', step: 'buy', status: 'skip', message: 'no EVM address' });
+    }
+    // Verify no positions left open for this wallet.
+    const walletAddrs = [addrs.solanaAddress, addrs.evmAddress].filter((x) => !!x);
+    const remaining = walletAddrs.length > 0
+        ? listPositions({ walletAddress: walletAddrs, includeClosed: false })
+        : [];
+    legs.push({
+        name: 'verify-no-open-positions',
+        chain: remaining[0]?.chain ?? 'solana',
+        step: 'verify',
+        status: remaining.length === 0 ? 'pass' : 'fail',
+        message: remaining.length === 0
+            ? undefined
+            : `${remaining.length} position(s) still open after live-test: ${remaining.map((p) => `${p.chain}:${p.mint}`).join(', ')}`,
+    });
+    const anyFail = legs.some((l) => l.status === 'fail');
+    const safeForAutonomousTrading = !anyFail && Math.abs(totalRealizedUsdc) <= opts.budgetUsdc;
+    return {
+        wallet: opts.walletRef,
+        startedAt,
+        finishedAt: new Date().toISOString(),
+        budgetUsdc: opts.budgetUsdc,
+        perLegUsdc,
+        legs,
+        totalRealizedUsdc,
+        safeForAutonomousTrading,
+        openPositionsAfter: remaining.length,
+    };
+}
+//# sourceMappingURL=wallet-live-test.js.map

package/dist/wallet-live-test.js.map

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

package/dist/wallet-readiness.d.ts

@@ -0,0 +1,51 @@
+export interface ReadinessCheck {
+    name: string;
+    status: 'pass' | 'warn' | 'fail' | 'skip';
+    value?: string | number | boolean;
+    message?: string;
+}
+export interface ReadinessReport {
+    wallet: string;
+    solanaAddress: string | null;
+    evmAddress: string | null;
+    /** Aggregate verdict — true only when every required check is `pass`. */
+    safeForAutonomousTrading: boolean;
+    checks: ReadinessCheck[];
+    /** Open position count by chain, plus total. */
+    openPositions: {
+        solana: number;
+        base: number;
+        total: number;
+    };
+    /** Native-asset balances on each chain (display + raw). */
+    balances: {
+        solana: {
+            lamports: number;
+            sol: number;
+        } | null;
+        base: {
+            wei: string;
+            eth: number;
+        } | null;
+    };
+    /** Daemon process state — running flag + pid if any. */
+    daemon: {
+        running: boolean;
+        pid: number | null;
+        lastTick: string | null;
+        autoExecute: boolean | null;
+        walletRef: string | null;
+    };
+}
+export interface ReadinessOpts {
+    walletRef: string;
+    passphrase?: string;
+    /**
+     * Minimum native balance (lamports / wei) required to count as "has gas".
+     * Defaults are intentionally low — the goal is "can sign + send", not "well
+     * funded". Callers tuning for big trades should pass explicit thresholds.
+     */
+    minSolLamports?: number;
+    minEthWei?: bigint;
+}
+export declare function runWalletReadiness(opts: ReadinessOpts): Promise<ReadinessReport>;

package/dist/wallet-readiness.js

@@ -0,0 +1,183 @@
+const DEFAULT_MIN_SOL_LAMPORTS = 1_000_000; // 0.001 SOL — covers fees + a few tx
+const DEFAULT_MIN_ETH_WEI = 100000000000000n; // 0.0001 ETH
+export async function runWalletReadiness(opts) {
+    const checks = [];
+    const minSol = opts.minSolLamports ?? DEFAULT_MIN_SOL_LAMPORTS;
+    const minEth = opts.minEthWei ?? DEFAULT_MIN_ETH_WEI;
+    // Resolve addresses for both chains.
+    let solanaAddress = null;
+    let evmAddress = null;
+    try {
+        const { resolveWalletAddresses } = await import('./wallet-trading.js');
+        const addrs = await resolveWalletAddresses(opts.walletRef, opts.passphrase);
+        solanaAddress = addrs.solanaAddress;
+        evmAddress = addrs.evmAddress;
+    }
+    catch (e) {
+        checks.push({ name: 'walletResolution', status: 'fail', message: e?.message ?? 'failed' });
+    }
+    checks.push({ name: 'canSignSolana', status: solanaAddress ? 'pass' : 'fail', value: solanaAddress ?? false });
+    checks.push({ name: 'canSignBase', status: evmAddress ? 'pass' : 'fail', value: evmAddress ?? false });
+    // Native balance checks — done in parallel with quote checks below.
+    const balanceTasks = [];
+    let solBalance = null;
+    let baseBalance = null;
+    if (solanaAddress) {
+        balanceTasks.push((async () => {
+            try {
+                const { PublicKey } = await import('@solana/web3.js');
+                const { makeConnection } = await import('./solana/index.js');
+                const conn = makeConnection();
+                const lamports = await conn.getBalance(new PublicKey(solanaAddress));
+                solBalance = { lamports, sol: lamports / 1e9 };
+                const hasGas = lamports >= minSol;
+                checks.push({
+                    name: 'solanaHasGas',
+                    status: hasGas ? 'pass' : 'fail',
+                    value: `${(lamports / 1e9).toFixed(6)} SOL`,
+                    message: hasGas ? undefined : `< ${(minSol / 1e9).toFixed(6)} SOL min for tx fees`,
+                });
+            }
+            catch (e) {
+                checks.push({ name: 'solanaHasGas', status: 'fail', message: e?.message ?? 'balance check failed' });
+            }
+        })());
+    }
+    else {
+        checks.push({ name: 'solanaHasGas', status: 'skip', message: 'no Solana address' });
+    }
+    if (evmAddress) {
+        balanceTasks.push((async () => {
+            try {
+                const { getErc20Balance, makeEvmProvider, NATIVE_ETH } = await import('./evm-trading.js');
+                const wei = await getErc20Balance(makeEvmProvider(), NATIVE_ETH, evmAddress);
+                const ethValue = Number(wei) / 1e18;
+                baseBalance = { wei: wei.toString(), eth: ethValue };
+                const hasGas = wei >= minEth;
+                checks.push({
+                    name: 'baseHasGas',
+                    status: hasGas ? 'pass' : 'fail',
+                    value: `${ethValue.toFixed(8)} ETH`,
+                    message: hasGas ? undefined : `< ${(Number(minEth) / 1e18).toFixed(8)} ETH min for gas`,
+                });
+            }
+            catch (e) {
+                checks.push({ name: 'baseHasGas', status: 'fail', message: e?.message ?? 'balance check failed' });
+            }
+        })());
+    }
+    else {
+        checks.push({ name: 'baseHasGas', status: 'skip', message: 'no EVM address' });
+    }
+    // Quote checks in parallel — trivial amounts, no signing.
+    const quoteTasks = [];
+    quoteTasks.push((async () => {
+        if (!solanaAddress) {
+            checks.push({ name: 'canQuoteSolana', status: 'skip', message: 'no Solana address' });
+            return;
+        }
+        try {
+            const { fetchQuote, SOL_MINT } = await import('./solana/index.js');
+            const { USDC_MINT_SOLANA } = await import('./wallet-trading.js');
+            await fetchQuote({
+                inputMint: SOL_MINT.toBase58(),
+                outputMint: USDC_MINT_SOLANA,
+                amount: 1_000_000,
+                slippageBps: 50,
+            });
+            checks.push({ name: 'canQuoteSolana', status: 'pass' });
+        }
+        catch (e) {
+            checks.push({ name: 'canQuoteSolana', status: 'fail', message: e?.message ?? 'quote failed' });
+        }
+    })());
+    quoteTasks.push((async () => {
+        if (!evmAddress) {
+            checks.push({ name: 'canQuoteBase', status: 'skip', message: 'no EVM address' });
+            return;
+        }
+        try {
+            const { fetchParaswapPrice, NATIVE_ETH, BASE_USDC, BASE_CHAIN_ID } = await import('./evm-trading.js');
+            await fetchParaswapPrice({
+                srcToken: NATIVE_ETH,
+                destToken: BASE_USDC,
+                amount: '100000000000000',
+                srcDecimals: 18,
+                destDecimals: 6,
+                network: BASE_CHAIN_ID,
+            });
+            checks.push({ name: 'canQuoteBase', status: 'pass' });
+        }
+        catch (e) {
+            checks.push({ name: 'canQuoteBase', status: 'fail', message: e?.message ?? 'quote failed' });
+        }
+    })());
+    await Promise.all([...balanceTasks, ...quoteTasks]);
+    // Daemon status.
+    let daemonRunning = false;
+    let daemonPid = null;
+    let daemonLastTick = null;
+    let daemonAuto = null;
+    let daemonWalletRef = null;
+    try {
+        const { getDaemonStatus } = await import('./wallet-daemon.js');
+        const status = getDaemonStatus();
+        daemonRunning = status.running;
+        daemonPid = status.pid;
+        daemonLastTick = status.lastTick;
+        daemonAuto = status.opts?.autoExecute ?? null;
+        daemonWalletRef = status.opts?.walletRef ?? null;
+    }
+    catch { }
+    checks.push({
+        name: 'daemonRunning',
+        status: daemonRunning ? 'pass' : 'warn',
+        value: daemonRunning,
+        message: daemonRunning ? undefined : 'daemon not running — run `palmyr wallet daemon start --auto --wallet <ref>` for autonomous monitoring',
+    });
+    // Open position counts. Cross-chain by default.
+    let openSolana = 0;
+    let openBase = 0;
+    try {
+        const { listPositions } = await import('./wallet-trading.js');
+        const addrs = [solanaAddress, evmAddress].filter((x) => !!x);
+        if (addrs.length > 0) {
+            const positions = listPositions({ walletAddress: addrs, includeClosed: false });
+            openSolana = positions.filter((p) => p.chain === 'solana').length;
+            openBase = positions.filter((p) => p.chain === 'base').length;
+        }
+    }
+    catch { }
+    checks.push({
+        name: 'openPositions',
+        status: 'pass',
+        value: openSolana + openBase,
+        message: `solana=${openSolana} base=${openBase}`,
+    });
+    const requiredChecks = ['canSignSolana', 'canSignBase', 'solanaHasGas', 'baseHasGas', 'canQuoteSolana', 'canQuoteBase'];
+    const safeForAutonomousTrading = !checks.some((c) => requiredChecks.includes(c.name) && c.status === 'fail');
+    return {
+        wallet: opts.walletRef,
+        solanaAddress,
+        evmAddress,
+        safeForAutonomousTrading,
+        checks,
+        openPositions: {
+            solana: openSolana,
+            base: openBase,
+            total: openSolana + openBase,
+        },
+        balances: {
+            solana: solBalance,
+            base: baseBalance,
+        },
+        daemon: {
+            running: daemonRunning,
+            pid: daemonPid,
+            lastTick: daemonLastTick,
+            autoExecute: daemonAuto,
+            walletRef: daemonWalletRef,
+        },
+    };
+}
+//# sourceMappingURL=wallet-readiness.js.map

package/dist/wallet-readiness.js.map

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

package/dist/wallet-trading.d.ts

@@ -275,6 +275,7 @@ export type TradeLogLine = {
     currentPct: number;
     thresholdPct?: number;
     peakPct?: number;
+    drawdownPct?: number;
     thresholdDurationMs?: number;
     elapsedMs?: number;
     llmVerdict?: 'yes' | 'no' | 'unclear';
@@ -488,6 +489,8 @@ export interface BuyBaseResult {
     protectedExec: boolean;
     rpcUrl: string;
     inputAsset: BaseInputAsset;
+    /** One-line human-readable summary; safe to print directly. */
+    summary: string;
 }
 export declare function buyBase(opts: BuyBaseOpts): Promise<BuyBaseResult>;
 export interface SellBaseOpts {
@@ -530,6 +533,8 @@ export interface SellBaseResult {
     output: AssetAmount;
     /** Canonical, asset-tagged realized PnL for this sell. */
     realized: AssetPnl;
+    /** One-line human-readable summary; safe to print directly. */
+    summary: string;
 }
 export declare function sellBase(opts: SellBaseOpts): Promise<SellBaseResult>;
 export interface SyncBaseOpts {
@@ -594,6 +599,8 @@ export interface BuyResult {
     protectedExec: boolean;
     forensics?: FillForensics;
     inputAsset: SolanaInputAsset;
+    /** One-line human-readable summary; safe to print directly. */
+    summary: string;
 }
 export declare function buy(opts: BuyOpts): Promise<BuyResult>;
 export interface SellOpts {
@@ -630,6 +637,8 @@ export interface SellResult {
     output: AssetAmount;
     /** Canonical, asset-tagged realized PnL for this sell. */
     realized: AssetPnl;
+    /** One-line human-readable summary; safe to print directly. */
+    summary: string;
 }
 export declare function sell(opts: SellOpts): Promise<SellResult>;
 export interface SyncOpts {

package/dist/wallet-trading.js

@@ -884,6 +884,7 @@ export async function buyBase(opts) {
     // Dry-run must be strictly read-only: simulated trades never touch live state.
     if (!opts.dryRun)
         writePosition(position);
+    const summary = `${opts.dryRun ? '[dry-run] ' : ''}Bought ${tokensOut} ${opts.ca} for ${position.entry.amountIn} on Base.`;
     return {
         positionPath: opts.dryRun
             ? `simulated:${opts.ca}`
@@ -903,6 +904,7 @@ export async function buyBase(opts) {
         protectedExec: !!opts.protectedExec,
         rpcUrl,
         inputAsset,
+        summary,
     };
 }
 export async function sellBase(opts) {
@@ -1065,6 +1067,9 @@ export async function sellBase(opts) {
     // position file (otherwise a simulation can "close" a real position).
     if (!opts.dryRun)
         writePosition(position);
+    const realizedSign = realizedAmount >= 0 ? '+' : '';
+    const realizedDigits = outputAsset === 'USDC' ? 6 : 8;
+    const summary = `${opts.dryRun ? '[dry-run] ' : ''}Sold ${tokensInDisplay} ${opts.ca} for ${outDisplay}; realized ${realizedSign}${realizedAmount.toFixed(realizedDigits)} ${outputAsset}; position ${position.status}.`;
     return {
         positionPath: opts.dryRun
             ? `simulated:${opts.ca}`
@@ -1085,6 +1090,7 @@ export async function sellBase(opts) {
         reconcileDriftRaw: reconcileDriftRaw === 0n ? undefined : reconcileDriftRaw.toString(),
         output: { asset: outputAsset, raw: outRaw, display: outDisplay },
         realized: { asset: outputAsset, amount: realizedAmount },
+        summary,
     };
 }
 export async function syncBase(opts = {}) {
@@ -1358,6 +1364,7 @@ export async function buy(opts) {
         protectedExec: !!opts.protectedExec,
         forensics,
         inputAsset,
+        summary: `${opts.dryRun ? '[dry-run] ' : ''}Bought ${tokensOut} ${opts.ca} for ${position.entry.amountIn} on Solana.`,
     };
 }
 export async function sell(opts) {
@@ -1511,6 +1518,9 @@ export async function sell(opts) {
             forensics,
         });
     }
+    const sign = realizedSol >= 0 ? '+' : '';
+    const digits = outputAsset === 'USDC' ? 6 : 8;
+    const summary = `${opts.dryRun ? '[dry-run] ' : ''}Sold ${tokensInDisplay} ${opts.ca} for ${solOutDisplay}; realized ${sign}${realizedSol.toFixed(digits)} ${outputAsset}; position ${position.status}.`;
     return {
         positionPath: opts.dryRun
             ? `simulated:${opts.ca}`
@@ -1531,6 +1541,7 @@ export async function sell(opts) {
         outputAsset,
         output: { asset: outputAsset, raw: String(solOutRaw), display: solOutDisplay },
         realized: { asset: outputAsset, amount: realizedSol },
+        summary,
     };
 }
 export async function sync(opts = {}) {