@jinn-network/client 0.1.0

package/dist/tx-retry.js

@@ -0,0 +1,214 @@
+/**
+ * Shared retry policy for transient RPC / transaction submission failures.
+ */
+export const TX_RETRY_DEFAULTS = {
+    maxAttempts: 6,
+    baseDelayMs: 400,
+    maxDelayMs: 12_000,
+    /** Extra fee bump per retry attempt after the first (basis points, 1500 = +15%) */
+    feeBumpBpsPerAttempt: 1500,
+};
+export function flattenErrorMessage(error) {
+    if (error === null || error === undefined)
+        return String(error);
+    if (typeof error === 'string')
+        return error;
+    if (error instanceof Error) {
+        let s = error.message;
+        const withCause = error;
+        if (withCause.cause !== undefined && withCause.cause !== null) {
+            s += ' | ' + flattenErrorMessage(withCause.cause);
+        }
+        return s;
+    }
+    if (typeof error === 'object') {
+        const o = error;
+        const parts = [];
+        if (typeof o.shortMessage === 'string')
+            parts.push(o.shortMessage);
+        if (typeof o.details === 'string')
+            parts.push(o.details);
+        if (typeof o.message === 'string' && !parts.includes(o.message))
+            parts.push(o.message);
+        if (parts.length > 0)
+            return parts.join(' | ');
+        try {
+            return JSON.stringify(error);
+        }
+        catch {
+            return String(error);
+        }
+    }
+    return String(error);
+}
+/**
+ * True when the failure is often fixed by waiting, refreshing nonce/fees, or switching RPC timing.
+ * Intentionally conservative: do not treat insufficient balance or user rejections as recoverable.
+ */
+export function isRecoverableTransactionError(error) {
+    const msg = flattenErrorMessage(error);
+    const lower = msg.toLowerCase();
+    if (lower.includes('insufficient funds'))
+        return false;
+    if (lower.includes('user rejected') || lower.includes('user denied'))
+        return false;
+    if (lower.includes('rejected the request'))
+        return false;
+    if (msg.includes('GS013'))
+        return false;
+    if (msg.includes('GS026'))
+        return true;
+    if (lower.includes('replacement transaction underpriced') ||
+        lower.includes('replacement fee too low') ||
+        lower.includes('fee cap less than block base fee') ||
+        lower.includes('max fee per gas less than block base fee') ||
+        lower.includes('transaction underpriced')) {
+        return true;
+    }
+    if (lower.includes('nonce too low') ||
+        lower.includes('already known') ||
+        lower.includes('could not coalesce')) {
+        return true;
+    }
+    if (lower.includes('econnreset') ||
+        lower.includes('etimedout') ||
+        lower.includes('socket hang up') ||
+        lower.includes('fetch failed') ||
+        lower.includes('network error') ||
+        lower.includes('connection refused') ||
+        lower.includes('connect timeout')) {
+        return true;
+    }
+    if (lower.includes('429') ||
+        lower.includes('rate limit') ||
+        lower.includes('too many requests') ||
+        lower.includes('-32603') ||
+        lower.includes('internal json-rpc error') ||
+        lower.includes('-32005') ||
+        lower.includes('request timed out') ||
+        lower.includes('timeout') ||
+        lower.includes('bad gateway') ||
+        lower.includes('service unavailable') ||
+        lower.includes('502') ||
+        lower.includes('503')) {
+        return true;
+    }
+    return false;
+}
+export function sleep(ms) {
+    return new Promise(r => setTimeout(r, ms));
+}
+export async function backoffDelay(attemptIndex, baseMs, maxMs) {
+    const exp = Math.min(maxMs, baseMs * 2 ** attemptIndex);
+    const jitter = Math.floor(Math.random() * Math.min(250, baseMs));
+    await sleep(exp + jitter);
+}
+export async function withRecoverableRetry(fn, options = {}) {
+    const maxAttempts = options.maxAttempts ?? TX_RETRY_DEFAULTS.maxAttempts;
+    const baseDelayMs = options.baseDelayMs ?? TX_RETRY_DEFAULTS.baseDelayMs;
+    const maxDelayMs = options.maxDelayMs ?? TX_RETRY_DEFAULTS.maxDelayMs;
+    let lastError;
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+        try {
+            return await fn(attempt);
+        }
+        catch (err) {
+            lastError = err;
+            if (!isRecoverableTransactionError(err) || attempt >= maxAttempts - 1) {
+                throw err;
+            }
+            const message = flattenErrorMessage(err);
+            options.onRetry?.({ attempt: attempt + 1, error: err, message });
+            await backoffDelay(attempt, baseDelayMs, maxDelayMs);
+        }
+    }
+    throw lastError instanceof Error ? lastError : new Error(String(lastError));
+}
+/** EIP-1559 or legacy gas overrides for viem, increasingly aggressive on later attempts. */
+export async function viemFeeOverridesForAttempt(publicClient, attemptIndex) {
+    if (attemptIndex <= 0)
+        return {};
+    const bps = BigInt(TX_RETRY_DEFAULTS.feeBumpBpsPerAttempt) * BigInt(attemptIndex);
+    const mult = 10000n + bps;
+    const apply = (v) => (v * mult) / 10000n;
+    try {
+        const fees = await publicClient.estimateFeesPerGas();
+        if (fees.maxFeePerGas !== undefined && fees.maxPriorityFeePerGas !== undefined) {
+            return {
+                maxFeePerGas: apply(fees.maxFeePerGas),
+                maxPriorityFeePerGas: apply(fees.maxPriorityFeePerGas),
+            };
+        }
+    }
+    catch {
+        // fall through to gasPrice
+    }
+    try {
+        const gasPrice = await publicClient.getGasPrice();
+        return { gasPrice: apply(gasPrice) };
+    }
+    catch {
+        return {};
+    }
+}
+export async function waitForTransactionReceiptWithRetry(publicClient, hash, options = {}) {
+    const maxAttempts = options.maxAttempts ?? TX_RETRY_DEFAULTS.maxAttempts;
+    const baseDelayMs = options.baseDelayMs ?? TX_RETRY_DEFAULTS.baseDelayMs;
+    const maxDelayMs = options.maxDelayMs ?? TX_RETRY_DEFAULTS.maxDelayMs;
+    const pollingInterval = options.pollingInterval ?? 4_000;
+    const confirmations = options.confirmations ?? 1;
+    let lastError;
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+        try {
+            return await publicClient.waitForTransactionReceipt({
+                hash,
+                pollingInterval,
+                confirmations,
+            });
+        }
+        catch (err) {
+            lastError = err;
+            if (!isRecoverableTransactionError(err) || attempt >= maxAttempts - 1) {
+                throw err;
+            }
+            options.onRetry?.({
+                attempt: attempt + 1,
+                error: err,
+                message: flattenErrorMessage(err),
+            });
+            await backoffDelay(attempt, baseDelayMs, maxDelayMs);
+        }
+    }
+    throw lastError instanceof Error ? lastError : new Error(String(lastError));
+}
+export async function viemSendTransactionWithRetry(walletClient, publicClient, txRequest, options = {}) {
+    const maxAttempts = options.maxAttempts ?? TX_RETRY_DEFAULTS.maxAttempts;
+    const baseDelayMs = options.baseDelayMs ?? TX_RETRY_DEFAULTS.baseDelayMs;
+    const maxDelayMs = options.maxDelayMs ?? TX_RETRY_DEFAULTS.maxDelayMs;
+    let lastError;
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+        try {
+            const overrides = await viemFeeOverridesForAttempt(publicClient, attempt);
+            const req = { ...txRequest, ...overrides };
+            // If we provided maxFeePerGas, ensure gasPrice is not somehow inherited
+            if ('maxFeePerGas' in req && 'maxPriorityFeePerGas' in req) {
+                delete req.gasPrice;
+            }
+            return await walletClient.sendTransaction(req);
+        }
+        catch (err) {
+            lastError = err;
+            if (!isRecoverableTransactionError(err) || attempt >= maxAttempts - 1) {
+                throw err;
+            }
+            options.onRetry?.({
+                attempt: attempt + 1,
+                error: err,
+                message: flattenErrorMessage(err),
+            });
+            await backoffDelay(attempt, baseDelayMs, maxDelayMs);
+        }
+    }
+    throw lastError instanceof Error ? lastError : new Error(String(lastError));
+}
+//# sourceMappingURL=tx-retry.js.map

package/dist/tx-retry.js.map

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

package/dist/types/desired-state.d.ts

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+export type RequestId = string;
+export declare const DesiredStateSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    description: z.ZodString;
+    context: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    id?: string | undefined;
+    context?: Record<string, unknown> | undefined;
+}, {
+    description: string;
+    id?: string | undefined;
+    context?: Record<string, unknown> | undefined;
+}>;
+export interface DesiredState {
+    id: string;
+    description: string;
+    context?: Record<string, unknown>;
+    type?: 'restoration' | 'evaluation';
+    attemptId?: string;
+    attemptNumber?: number;
+    restorationRequestId?: string;
+}
+export declare function parseDesiredState(input: unknown): DesiredState;
+export interface RestorationRequest {
+    requestId: RequestId;
+    desiredState: DesiredState;
+    payment?: string;
+    timeout?: number;
+}
+export interface RestorationResult {
+    data: string;
+    artifacts?: string[];
+}
+export interface DeliveredResult {
+    requestId: RequestId;
+    desiredState: DesiredState;
+    result: RestorationResult;
+    deliveryMechAddress: string;
+}

package/dist/types/desired-state.js

@@ -0,0 +1,16 @@
+import { randomUUID } from 'node:crypto';
+import { z } from 'zod';
+export const DesiredStateSchema = z.object({
+    id: z.string().optional(),
+    description: z.string().min(1),
+    context: z.record(z.unknown()).optional(),
+});
+export function parseDesiredState(input) {
+    const parsed = DesiredStateSchema.parse(input);
+    return {
+        id: parsed.id ?? randomUUID(),
+        description: parsed.description,
+        context: parsed.context,
+    };
+}
+//# sourceMappingURL=desired-state.js.map

package/dist/types/desired-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"desired-state.js","sourceRoot":"","sources":["../../src/types/desired-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC;AAYH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC/C,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE,IAAI,UAAU,EAAE;QAC7B,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC;AACJ,CAAC"}

package/dist/types/errors.d.ts

@@ -0,0 +1,8 @@
+export declare class TransientError extends Error {
+    readonly cause?: unknown | undefined;
+    constructor(message: string, cause?: unknown | undefined);
+}
+export declare class PermanentError extends Error {
+    readonly cause?: unknown | undefined;
+    constructor(message: string, cause?: unknown | undefined);
+}

package/dist/types/errors.js

@@ -0,0 +1,17 @@
+export class TransientError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'TransientError';
+    }
+}
+export class PermanentError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'PermanentError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/types/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,cAAe,SAAQ,KAAK;IACM;IAA7C,YAAY,OAAe,EAAkB,KAAe;QAC1D,KAAK,CAAC,OAAO,CAAC,CAAC;QAD4B,UAAK,GAAL,KAAK,CAAU;QAE1D,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,KAAK;IACM;IAA7C,YAAY,OAAe,EAAkB,KAAe;QAC1D,KAAK,CAAC,OAAO,CAAC,CAAC;QAD4B,UAAK,GAAL,KAAK,CAAU;QAE1D,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF"}

package/dist/types/index.d.ts

@@ -0,0 +1,2 @@
+export { type DesiredState, type RequestId, type RestorationRequest, type RestorationResult, type DeliveredResult, parseDesiredState, } from './desired-state.js';
+export { TransientError, PermanentError } from './errors.js';

package/dist/types/index.js

@@ -0,0 +1,3 @@
+export { parseDesiredState, } from './desired-state.js';
+export { TransientError, PermanentError } from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/withdraw/args.d.ts

@@ -0,0 +1,29 @@
+/**
+ * CLI argument and amount parsing for operator withdraw script.
+ */
+export type WithdrawParsedArgs = {
+    help: boolean;
+    dryRun: boolean;
+    yes: boolean;
+    json: boolean;
+    human: boolean;
+    to: `0x${string}` | null;
+    jinnWei: bigint | null;
+    drainJinn: boolean;
+    ethWei: bigint | null;
+    drainEth: boolean;
+    sweepAgents: boolean;
+    minSweepWei: bigint;
+    masterGasReserveWei: bigint;
+};
+export declare function parseEtherToWei(input: string): bigint;
+/** Parse a decimal token amount into wei given token decimals (default 18). */
+export declare function parseTokenDecimalToWei(input: string, decimals: number): bigint;
+export declare function parsePositiveWeiString(input: string, label: string): bigint;
+/**
+ * Parse withdraw CLI argv (typically process.argv.slice(2)).
+ * Mutates a copy of argv only — pass a slice if you need to preserve process.argv.
+ */
+export declare function parseWithdrawArgv(argv: string[]): WithdrawParsedArgs;
+export declare function withdrawArgsNeedMasterTransfer(p: WithdrawParsedArgs): boolean;
+export declare function validateWithdrawArgs(p: WithdrawParsedArgs): void;

package/dist/withdraw/args.js

@@ -0,0 +1,198 @@
+/**
+ * CLI argument and amount parsing for operator withdraw script.
+ */
+import { getAddress, isAddress } from 'viem';
+const ZERO = 0n;
+export function parseEtherToWei(input) {
+    const s = input.trim();
+    if (!s)
+        throw new Error('Empty ETH amount');
+    if (!/^\d*\.?\d+$/.test(s)) {
+        throw new Error(`Invalid ETH amount: ${input}`);
+    }
+    const [whole, frac = ''] = s.split('.');
+    const wholePart = whole === '' ? '0' : whole;
+    if (!/^\d+$/.test(wholePart))
+        throw new Error(`Invalid ETH amount: ${input}`);
+    if (frac.length > 18) {
+        throw new Error('ETH amount must have at most 18 decimal places');
+    }
+    const fracPadded = (frac + '0'.repeat(18)).slice(0, 18);
+    const wei = BigInt(wholePart) * 10n ** 18n + BigInt(fracPadded || '0');
+    return wei;
+}
+/** Parse a decimal token amount into wei given token decimals (default 18). */
+export function parseTokenDecimalToWei(input, decimals) {
+    if (decimals < 0 || decimals > 36) {
+        throw new Error(`Unsupported token decimals: ${decimals}`);
+    }
+    const s = input.trim();
+    if (!s)
+        throw new Error('Empty token amount');
+    if (!/^\d*\.?\d+$/.test(s)) {
+        throw new Error(`Invalid token amount: ${input}`);
+    }
+    const [whole, frac = ''] = s.split('.');
+    const wholePart = whole === '' ? '0' : whole;
+    if (!/^\d+$/.test(wholePart))
+        throw new Error(`Invalid token amount: ${input}`);
+    if (frac.length > decimals) {
+        throw new Error(`Token amount must have at most ${decimals} decimal places`);
+    }
+    const fracPadded = (frac + '0'.repeat(decimals)).slice(0, decimals);
+    const scale = 10n ** BigInt(decimals);
+    const wei = BigInt(wholePart) * scale + BigInt(fracPadded || '0');
+    return wei;
+}
+export function parsePositiveWeiString(input, label) {
+    const s = input.trim();
+    if (!/^\d+$/.test(s)) {
+        throw new Error(`${label} must be a non-negative integer string (wei), got: ${input}`);
+    }
+    const v = BigInt(s);
+    if (v <= ZERO) {
+        throw new Error(`${label} must be positive`);
+    }
+    return v;
+}
+function takeFlag(argv, name) {
+    const idx = argv.indexOf(name);
+    if (idx === -1)
+        return false;
+    argv.splice(idx, 1);
+    return true;
+}
+function takeValue(argv, name) {
+    const idx = argv.indexOf(name);
+    if (idx === -1)
+        return null;
+    const v = argv[idx + 1];
+    if (v === undefined || v.startsWith('--')) {
+        throw new Error(`Missing value for ${name}`);
+    }
+    argv.splice(idx, 2);
+    return v;
+}
+/**
+ * Parse withdraw CLI argv (typically process.argv.slice(2)).
+ * Mutates a copy of argv only — pass a slice if you need to preserve process.argv.
+ */
+export function parseWithdrawArgv(argv) {
+    const args = [...argv];
+    const help = takeFlag(args, '--help') || takeFlag(args, '-h');
+    const dryRun = takeFlag(args, '--dry-run');
+    const yes = takeFlag(args, '--yes');
+    const json = takeFlag(args, '--json');
+    const human = takeFlag(args, '--human');
+    const drainJinn = takeFlag(args, '--drain-jinn');
+    const drainEth = takeFlag(args, '--drain-eth');
+    const sweepAgents = takeFlag(args, '--sweep-agents');
+    const toRaw = takeValue(args, '--to');
+    let to = null;
+    if (toRaw !== null) {
+        if (!isAddress(toRaw)) {
+            throw new Error(`Invalid --to address: ${toRaw}`);
+        }
+        to = getAddress(toRaw);
+    }
+    let jinnWei = null;
+    const jinnWeiStr = takeValue(args, '--jinn-wei');
+    const jinnAmount = takeValue(args, '--jinn-amount');
+    const amountAlias = takeValue(args, '--amount');
+    if ([jinnAmount, amountAlias].filter(Boolean).length > 1) {
+        throw new Error('Use only one of --jinn-amount or --amount');
+    }
+    const jinnDecimal = jinnAmount ?? amountAlias;
+    if (jinnWeiStr !== null && jinnDecimal !== null) {
+        throw new Error('Use only one of --jinn-wei or --jinn-amount/--amount');
+    }
+    if (jinnWeiStr !== null) {
+        jinnWei = parsePositiveWeiString(jinnWeiStr, '--jinn-wei');
+    }
+    if (jinnDecimal !== null) {
+        jinnWei = parseTokenDecimalToWei(jinnDecimal, 18);
+        if (jinnWei <= ZERO)
+            throw new Error('--jinn-amount/--amount must be positive');
+    }
+    if (drainJinn && jinnWei !== null) {
+        throw new Error('Cannot combine --drain-jinn with --jinn-amount/--amount/--jinn-wei');
+    }
+    let ethWei = null;
+    const ethWeiStr = takeValue(args, '--eth-wei');
+    const ethAmount = takeValue(args, '--eth-amount');
+    if (ethWeiStr !== null && ethAmount !== null) {
+        throw new Error('Use only one of --eth-wei or --eth-amount');
+    }
+    if (ethWeiStr !== null) {
+        ethWei = parsePositiveWeiString(ethWeiStr, '--eth-wei');
+    }
+    if (ethAmount !== null) {
+        ethWei = parseEtherToWei(ethAmount);
+        if (ethWei <= ZERO)
+            throw new Error('--eth-amount must be positive');
+    }
+    if (drainEth && ethWei !== null) {
+        throw new Error('Cannot combine --drain-eth with --eth-amount/--eth-wei');
+    }
+    const minSweepRaw = takeValue(args, '--min-sweep-wei');
+    let minSweepWei = 1000000000000000n; // 0.001 ETH default dust floor
+    if (minSweepRaw !== null) {
+        minSweepWei = parsePositiveWeiString(minSweepRaw, '--min-sweep-wei');
+    }
+    const reserveRaw = takeValue(args, '--master-gas-reserve-wei');
+    let masterGasReserveWei = 2500000000000000n; // 0.0025 ETH default
+    if (reserveRaw !== null) {
+        const s = reserveRaw.trim();
+        if (!/^\d+$/.test(s)) {
+            throw new Error('--master-gas-reserve-wei must be a non-negative integer wei string');
+        }
+        masterGasReserveWei = BigInt(s);
+    }
+    const configIdx = args.indexOf('--config');
+    if (configIdx !== -1) {
+        const configPath = args[configIdx + 1];
+        if (configPath === undefined || configPath.startsWith('--')) {
+            throw new Error('Missing value for --config');
+        }
+        args.splice(configIdx, 2);
+    }
+    const passwordFdIdx = args.indexOf('--password-fd');
+    if (passwordFdIdx !== -1) {
+        const fdVal = args[passwordFdIdx + 1];
+        if (fdVal === undefined || fdVal.startsWith('--')) {
+            throw new Error('Missing value for --password-fd');
+        }
+        args.splice(passwordFdIdx, 2);
+    }
+    if (args.length > 0) {
+        throw new Error(`Unexpected arguments: ${args.join(' ')}`);
+    }
+    return {
+        help,
+        dryRun,
+        yes,
+        json,
+        human,
+        to,
+        jinnWei,
+        drainJinn,
+        ethWei,
+        drainEth,
+        sweepAgents,
+        minSweepWei,
+        masterGasReserveWei,
+    };
+}
+export function withdrawArgsNeedMasterTransfer(p) {
+    return p.jinnWei !== null || p.drainJinn || p.ethWei !== null || p.drainEth;
+}
+export function validateWithdrawArgs(p) {
+    const needsTo = withdrawArgsNeedMasterTransfer(p) || p.sweepAgents;
+    if (needsTo && !p.to) {
+        throw new Error('--to <address> is required for transfers or --sweep-agents');
+    }
+    if (!needsTo && !p.help) {
+        throw new Error('Nothing to do: specify --jinn-amount/--amount/--jinn-wei/--drain-jinn, --eth-amount/--eth-wei/--drain-eth, and/or --sweep-agents');
+    }
+}
+//# sourceMappingURL=args.js.map

package/dist/withdraw/args.js.map

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

package/dist/withdraw/run-withdraw-plan.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Shared withdraw execution (master + optional agent sweeps). Used by `jinn withdraw` and `npm run withdraw`.
+ */
+import { type PublicClient } from 'viem';
+import type { JinnConfig } from '../config.js';
+import { FleetStateStore } from '../earning/store.js';
+import { type WithdrawParsedArgs } from './args.js';
+export declare function withdrawNeedsInteractiveConfirm(p: WithdrawParsedArgs, opts: {
+    sweepWouldSend: boolean;
+}): boolean;
+export declare function resolveWithdrawTokenAddress(chain: 'base' | 'base-sepolia', config: JinnConfig): string;
+export declare function estimateNativeTransferCostWei(publicClient: PublicClient): Promise<bigint>;
+export declare function computeSweepWouldSend(publicClient: PublicClient, mnemonic: string, fleet: Awaited<ReturnType<FleetStateStore['tryLoadExisting']>>, to: string, minSweepWei: bigint): Promise<boolean>;
+export interface RunWithdrawPlanOptions {
+    password: string;
+    config: JinnConfig;
+    parsed: WithdrawParsedArgs;
+    log?: (s: string) => void;
+    warn?: (s: string) => void;
+}
+export declare function runWithdrawPlan(options: RunWithdrawPlanOptions): Promise<void>;