@jinn-network/client 0.1.0-canary.adfd078d

package/dist/earning/reconcile.js

@@ -0,0 +1,216 @@
+/**
+ * Pure reconciliation rules: persisted fleet service state vs on-chain signals.
+ * Used by FleetBootstrapper so operators need not hand-edit earning_state.json.
+ */
+import { getAddress } from 'viem';
+const ZERO = '0x0000000000000000000000000000000000000000';
+const STANDARD_POST_STAKE = new Set([
+    'staked',
+    'mech_deployed',
+    'complete',
+]);
+const SELF_BOND_STAKE_STEPS = new Set([
+    'service_staked',
+    'staked',
+    'mech_deployed',
+    'complete',
+]);
+/** Self-bond registry state → latest local step that must not be ahead of chain (bootstrap idempotency). */
+const REGISTRY_MAX_STEP = {
+    0: 'service_created',
+    1: 'service_activated',
+    2: 'agents_registered',
+    3: 'service_deployed',
+    4: 'service_staked',
+};
+const STEP_ORDER = [
+    'awaiting_stake',
+    'service_created',
+    'service_activated',
+    'agents_registered',
+    'service_deployed',
+    'service_staked',
+    'staked',
+    'mech_deployed',
+    'complete',
+];
+function stepIndex(step) {
+    const i = STEP_ORDER.indexOf(step);
+    return i === -1 ? 0 : i;
+}
+function isZeroishAddress(addr) {
+    if (!addr)
+        return true;
+    try {
+        return getAddress(addr) === getAddress(ZERO);
+    }
+    catch {
+        return true;
+    }
+}
+function clearServiceIdentity() {
+    return {
+        service_id: null,
+        safe_address: null,
+        mech_address: null,
+        staking_address: null,
+        step: 'awaiting_stake',
+        error: null,
+    };
+}
+/**
+ * Standard (distributor) mode: staking proxy is source of truth for stake/eviction.
+ */
+export function reconcileStandardService(index, svc, chain, ctx) {
+    if (svc.service_id === null)
+        return null;
+    const id = svc.service_id;
+    if (chain.stakingState === 'inconclusive' || chain.registryState === 'inconclusive') {
+        return null;
+    }
+    if (chain.stakingState === 'revert') {
+        return {
+            message: `[jinn-earning] Service ${index}: persisted id=${id} is unknown to the staking contract (RPC reverted). Clearing local service id and Safe/mech fields; next bootstrap will run a fresh distributor stake().`,
+            patch: clearServiceIdentity(),
+        };
+    }
+    if (chain.stakingState === 2) {
+        // Eviction: resumeService runs reStake; no state patch here.
+        return null;
+    }
+    // Crashed after assigning service_id but before stake confirmed — or stale id
+    if (svc.step === 'awaiting_stake' && chain.stakingState === 0) {
+        return {
+            message: `[jinn-earning] Service ${index}: local step was awaiting_stake but service_id=${id} is not staked on-chain. Clearing stale id/Safe/mech; next bootstrap will call distributor stake() cleanly.`,
+            patch: clearServiceIdentity(),
+        };
+    }
+    // State file behind chain (e.g. crash after stake mined before step save)
+    if (svc.step === 'awaiting_stake' && chain.stakingState === 1) {
+        const safe = chain.stakingMultisig && !isZeroishAddress(chain.stakingMultisig)
+            ? getAddress(chain.stakingMultisig)
+            : svc.safe_address;
+        if (!safe || isZeroishAddress(safe)) {
+            return null;
+        }
+        return {
+            message: `[jinn-earning] Service ${index}: on-chain shows id=${id} already staked; advancing local step from awaiting_stake to staked (Safe ${safe}).`,
+            patch: {
+                step: 'staked',
+                safe_address: safe,
+                staking_address: getAddress(ctx.stakingContract),
+                error: null,
+            },
+        };
+    }
+    if (STANDARD_POST_STAKE.has(svc.step) && chain.stakingState === 0) {
+        return {
+            message: `[jinn-earning] Service ${index}: on-chain staking is unstaked for id=${id} while local step was '${svc.step}' (e.g. unstakeAndWithdraw or a crashed tx). Resetting to awaiting_stake; next bootstrap will provision a new service via the distributor.`,
+            patch: clearServiceIdentity(),
+        };
+    }
+    return null;
+}
+function maxStepForRegistryState(registryState) {
+    if (registryState >= 4)
+        return 'service_staked';
+    return REGISTRY_MAX_STEP[registryState] ?? 'service_created';
+}
+/**
+ * Self-bond mode: registry + Safe bytecode + staking.
+ */
+export function reconcileSelfBondService(index, svc, chain) {
+    const step = svc.step;
+    if (chain.stakingState === 'inconclusive' || chain.registryState === 'inconclusive') {
+        return null;
+    }
+    // Safe predicted or required but not deployed while we think we passed setup
+    if (step !== 'awaiting_stake' &&
+        svc.safe_address &&
+        chain.safeDeployed === false) {
+        return {
+            message: `[jinn-earning] Service ${index}: Safe ${svc.safe_address} has no bytecode on-chain but local step was '${step}'. Rewinding to awaiting_stake to re-run Safe prediction and deployment.`,
+            patch: clearServiceIdentity(),
+        };
+    }
+    if (svc.service_id !== null) {
+        const id = svc.service_id;
+        if (chain.registryState === 'revert') {
+            return {
+                message: `[jinn-earning] Service ${index}: could not read service ${id} from the registry (RPC reverted). Clearing service id; bootstrap will recreate the service when you re-run.`,
+                patch: {
+                    service_id: null,
+                    mech_address: null,
+                    staking_address: null,
+                    step: chain.safeDeployed === true ? 'service_created' : 'awaiting_stake',
+                    error: null,
+                },
+            };
+        }
+        const reg = chain.registryState;
+        const multisigMissing = chain.registryMultisig === null || isZeroishAddress(chain.registryMultisig);
+        if (typeof reg === 'number' && reg === 0 && multisigMissing) {
+            return {
+                message: `[jinn-earning] Service ${index}: registry shows no service at id=${id} (evicted / terminated / wrong id). Clearing local service id; next bootstrap will create a new service from step '${chain.safeDeployed === true ? 'service_created' : 'awaiting_stake'}'.`,
+                patch: {
+                    service_id: null,
+                    mech_address: null,
+                    staking_address: null,
+                    step: chain.safeDeployed === true ? 'service_created' : 'awaiting_stake',
+                    error: null,
+                },
+            };
+        }
+        // Staking beats registry-order heuristics (eviction / unstaked while registry still "deployed")
+        if (chain.stakingState !== 'revert' && SELF_BOND_STAKE_STEPS.has(step)) {
+            if (chain.stakingState === 2) {
+                return {
+                    message: `[jinn-earning] Service ${index}: service ${id} is evicted on-chain (staking state 2). Rewinding to service_staked to re-stake when you re-run.`,
+                    patch: {
+                        step: 'service_staked',
+                        mech_address: null,
+                        error: null,
+                    },
+                };
+            }
+            if (chain.stakingState === 0) {
+                return {
+                    message: `[jinn-earning] Service ${index}: service ${id} is not staked on-chain while local step was '${step}' (e.g. partial stake or unstake). Rewinding to service_staked to retry staking.`,
+                    patch: {
+                        step: 'service_staked',
+                        mech_address: null,
+                        error: null,
+                    },
+                };
+            }
+        }
+        // Local step ahead of chain (e.g. tx never mined after state save)
+        if (typeof reg === 'number' && reg > 0) {
+            const maxStep = maxStepForRegistryState(reg);
+            if (stepIndex(step) > stepIndex(maxStep)) {
+                const patch = {
+                    step: maxStep,
+                    error: null,
+                };
+                if (stepIndex(maxStep) < stepIndex('staked')) {
+                    patch.mech_address = null;
+                }
+                if (stepIndex(maxStep) < stepIndex('service_staked')) {
+                    patch.staking_address = null;
+                }
+                return {
+                    message: `[jinn-earning] Service ${index}: local step '${step}' was ahead of registry state (${reg}) for id=${id}. Rewinding to '${maxStep}' so bootstrap can resubmit the correct on-chain steps.`,
+                    patch,
+                };
+            }
+        }
+    }
+    return null;
+}
+export function reconcileServiceAgainstChain(stakingMode, svc, chain, ctx) {
+    if (stakingMode === 'standard') {
+        return reconcileStandardService(svc.index, svc, chain, ctx);
+    }
+    return reconcileSelfBondService(svc.index, svc, chain);
+}
+//# sourceMappingURL=reconcile.js.map

package/dist/earning/reconcile.js.map

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

package/dist/earning/safe-adapter.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Thin wrapper around @safe-global/protocol-kit isolating import/init quirks.
+ *
+ * NodeNext treats protocol-kit's .d.ts as CJS (the package lacks "type":"module"),
+ * so `import Safe from '...'` resolves to the module namespace rather than the class.
+ * This adapter defines a minimal SafeInstance interface for what we actually use,
+ * decoupling the earning bootstrap from SDK type-level instability.
+ */
+import type { MetaTransactionData, TransactionResult } from '@safe-global/types-kit';
+import { type Hex } from 'viem';
+export type { MetaTransactionData, TransactionResult };
+/** Minimal interface covering the Safe SDK methods we actually call. */
+export interface SafeInstance {
+    getAddress(): Promise<string>;
+    isSafeDeployed(): Promise<boolean>;
+    createSafeDeploymentTransaction(): Promise<{
+        to: string;
+        value: string;
+        data: string;
+    }>;
+    createTransaction(props: {
+        transactions: MetaTransactionData[];
+    }): Promise<SafeTransaction>;
+    signTransaction(tx: SafeTransaction): Promise<SafeTransaction>;
+    executeTransaction(tx: SafeTransaction, options?: Record<string, unknown>): Promise<TransactionResult>;
+}
+/** Opaque handle -- we never inspect SafeTransaction internals. */
+export interface SafeTransaction {
+}
+export interface PredictedSafeResult {
+    safe: SafeInstance;
+    address: string;
+}
+/**
+ * Initialise a Safe SDK instance for a not-yet-deployed Safe (CREATE2 prediction).
+ */
+export declare function initPredictedSafe(opts: {
+    rpcUrl: string;
+    signerKey: string;
+    owners: string[];
+    threshold: number;
+}): Promise<PredictedSafeResult>;
+/**
+ * Initialise a Safe SDK instance for an already-deployed Safe.
+ */
+export declare function initDeployedSafe(opts: {
+    rpcUrl: string;
+    signerKey: string;
+    safeAddress: string;
+}): Promise<SafeInstance>;
+/**
+ * Build + sign + execute a batch of calls through a deployed Safe.
+ * For 1-of-1 Safes the signer is the sole owner, so sign + execute in one shot.
+ */
+export declare function executeSafeTxBatch(safe: SafeInstance, transactions: MetaTransactionData[]): Promise<TransactionResult>;
+/**
+ * Execute a single Safe transaction directly via the Safe contract, bypassing
+ * Safe SDK gas estimation for calls that are known to misbehave under viem.
+ */
+export declare function executeSafeTxDirect(opts: {
+    rpcUrl: string;
+    signerKey: Hex;
+    safeAddress: string;
+    to: string;
+    value?: bigint;
+    data: Hex;
+    gasLimit?: bigint;
+}): Promise<{
+    hash: string;
+}>;

package/dist/earning/safe-adapter.js

@@ -0,0 +1,228 @@
+/**
+ * Thin wrapper around @safe-global/protocol-kit isolating import/init quirks.
+ *
+ * NodeNext treats protocol-kit's .d.ts as CJS (the package lacks "type":"module"),
+ * so `import Safe from '...'` resolves to the module namespace rather than the class.
+ * This adapter defines a minimal SafeInstance interface for what we actually use,
+ * decoupling the earning bootstrap from SDK type-level instability.
+ */
+import { bytesToHex, concat, createPublicClient, createWalletClient, encodeFunctionData, hexToBytes, http, toHex, zeroAddress, } from 'viem';
+import { base, baseSepolia } from 'viem/chains';
+import { privateKeyToAccount } from 'viem/accounts';
+import { viemFeeOverridesForAttempt, withRecoverableRetry } from '../tx-retry.js';
+const SAFE_EXECUTION_FALLBACK_GAS_LIMIT = 2_000_000;
+const SAFE_ABI = [
+    {
+        type: 'function',
+        name: 'execTransaction',
+        stateMutability: 'nonpayable',
+        inputs: [
+            { name: 'to', type: 'address' },
+            { name: 'value', type: 'uint256' },
+            { name: 'data', type: 'bytes' },
+            { name: 'operation', type: 'uint8' },
+            { name: 'safeTxGas', type: 'uint256' },
+            { name: 'baseGas', type: 'uint256' },
+            { name: 'gasPrice', type: 'uint256' },
+            { name: 'gasToken', type: 'address' },
+            { name: 'refundReceiver', type: 'address' },
+            { name: 'signatures', type: 'bytes' },
+        ],
+        outputs: [{ name: '', type: 'bool' }],
+    },
+    {
+        type: 'function',
+        name: 'nonce',
+        stateMutability: 'view',
+        inputs: [],
+        outputs: [{ name: '', type: 'uint256' }],
+    },
+    {
+        type: 'function',
+        name: 'getTransactionHash',
+        stateMutability: 'view',
+        inputs: [
+            { name: 'to', type: 'address' },
+            { name: 'value', type: 'uint256' },
+            { name: 'data', type: 'bytes' },
+            { name: 'operation', type: 'uint8' },
+            { name: 'safeTxGas', type: 'uint256' },
+            { name: 'baseGas', type: 'uint256' },
+            { name: 'gasPrice', type: 'uint256' },
+            { name: 'gasToken', type: 'address' },
+            { name: 'refundReceiver', type: 'address' },
+            { name: '_nonce', type: 'uint256' },
+        ],
+        outputs: [{ name: '', type: 'bytes32' }],
+    },
+];
+/**
+ * Resolve the `Safe.init` function regardless of CJS/ESM interop shape.
+ */
+async function resolveSafeInit() {
+    // Dynamic import avoids NodeNext static-analysis issues.
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const mod = await import('@safe-global/protocol-kit');
+    const SafeClass = mod.default?.default ?? mod.default ?? mod;
+    if (typeof SafeClass?.init !== 'function') {
+        throw new Error('Failed to resolve Safe.init from @safe-global/protocol-kit. ' +
+            `Got: ${typeof SafeClass} (keys: ${Object.keys(SafeClass ?? {}).join(', ')})`);
+    }
+    return SafeClass.init.bind(SafeClass);
+}
+async function resolveExecutionRpcUrl(rpcUrl) {
+    if (!rpcUrl.includes('tenderly.co')) {
+        return rpcUrl;
+    }
+    try {
+        const id = await createPublicClient({ transport: http(rpcUrl) }).getChainId();
+        if (id === 8453)
+            return 'https://base.publicnode.com';
+        if (id === 84532)
+            return 'https://sepolia.base.org';
+    }
+    catch {
+        /* fall through */
+    }
+    return rpcUrl;
+}
+function chainForId(chainId, rpcUrl) {
+    if (chainId === 8453)
+        return base;
+    if (chainId === 84532)
+        return baseSepolia;
+    return {
+        id: chainId,
+        name: 'Custom',
+        nativeCurrency: { name: 'Ether', symbol: 'ETH', decimals: 18 },
+        rpcUrls: { default: { http: [rpcUrl] } },
+    };
+}
+/**
+ * Initialise a Safe SDK instance for a not-yet-deployed Safe (CREATE2 prediction).
+ */
+export async function initPredictedSafe(opts) {
+    const init = await resolveSafeInit();
+    const safe = await init({
+        provider: opts.rpcUrl,
+        signer: opts.signerKey,
+        predictedSafe: {
+            safeAccountConfig: {
+                owners: opts.owners,
+                threshold: opts.threshold,
+            },
+        },
+    });
+    const address = await safe.getAddress();
+    return { safe, address };
+}
+/**
+ * Initialise a Safe SDK instance for an already-deployed Safe.
+ */
+export async function initDeployedSafe(opts) {
+    const init = await resolveSafeInit();
+    return init({
+        provider: opts.rpcUrl,
+        signer: opts.signerKey,
+        safeAddress: opts.safeAddress,
+    });
+}
+/**
+ * Build + sign + execute a batch of calls through a deployed Safe.
+ * For 1-of-1 Safes the signer is the sole owner, so sign + execute in one shot.
+ */
+export async function executeSafeTxBatch(safe, transactions) {
+    return withRecoverableRetry(async () => {
+        const safeTx = await safe.createTransaction({ transactions });
+        const signedTx = await safe.signTransaction(safeTx);
+        try {
+            return await safe.executeTransaction(signedTx);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            if (!message.includes('GS013')) {
+                throw err;
+            }
+            // Safe SDK gas estimation intermittently fails on certain inner calls
+            // (notably staking approve+stake batches) even when the transaction itself succeeds.
+            return safe.executeTransaction(signedTx, {
+                gasLimit: SAFE_EXECUTION_FALLBACK_GAS_LIMIT,
+            });
+        }
+    }, {
+        onRetry: ({ attempt, message }) => {
+            console.error(`[safe-adapter] executeSafeTxBatch retry ${attempt}: ${message}`);
+        },
+    });
+}
+/**
+ * Execute a single Safe transaction directly via the Safe contract, bypassing
+ * Safe SDK gas estimation for calls that are known to misbehave under viem.
+ */
+export async function executeSafeTxDirect(opts) {
+    const executionRpcUrl = await resolveExecutionRpcUrl(opts.rpcUrl);
+    const chainId = await createPublicClient({ transport: http(executionRpcUrl) }).getChainId();
+    const chain = chainForId(chainId, executionRpcUrl);
+    const publicClient = createPublicClient({
+        chain,
+        transport: http(executionRpcUrl),
+    });
+    const account = privateKeyToAccount(opts.signerKey);
+    const walletClient = createWalletClient({
+        account,
+        chain,
+        transport: http(executionRpcUrl),
+    });
+    const safeAddress = opts.safeAddress;
+    const to = opts.to;
+    const value = opts.value ?? 0n;
+    const baseGas = opts.gasLimit ?? BigInt(SAFE_EXECUTION_FALLBACK_GAS_LIMIT);
+    const hash = await withRecoverableRetry(async (attemptIndex) => {
+        const nonce = await publicClient.readContract({
+            address: safeAddress,
+            abi: SAFE_ABI,
+            functionName: 'nonce',
+        });
+        const safeTxHash = await publicClient.readContract({
+            address: safeAddress,
+            abi: SAFE_ABI,
+            functionName: 'getTransactionHash',
+            args: [to, value, opts.data, 0, 0n, 0n, 0n, zeroAddress, zeroAddress, nonce],
+        });
+        const sigHex = await walletClient.signMessage({
+            account,
+            message: { raw: hexToBytes(safeTxHash) },
+        });
+        const sigBytes = hexToBytes(sigHex);
+        const r = bytesToHex(sigBytes.slice(0, 32));
+        const s = bytesToHex(sigBytes.slice(32, 64));
+        const v = sigBytes[64] + 4;
+        const adjustedSig = concat([r, s, toHex(v, { size: 1 })]);
+        const data = encodeFunctionData({
+            abi: SAFE_ABI,
+            functionName: 'execTransaction',
+            args: [to, value, opts.data, 0, 0n, 0n, 0n, zeroAddress, zeroAddress, adjustedSig],
+        });
+        const feeOverrides = await viemFeeOverridesForAttempt(publicClient, attemptIndex);
+        const txParams = {
+            account,
+            to: safeAddress,
+            data,
+            gas: baseGas + BigInt(attemptIndex) * 50000n,
+            ...feeOverrides,
+        };
+        if ('maxFeePerGas' in txParams &&
+            txParams.maxFeePerGas !== undefined &&
+            'maxPriorityFeePerGas' in txParams &&
+            txParams.maxPriorityFeePerGas !== undefined) {
+            delete txParams.gasPrice;
+        }
+        return walletClient.sendTransaction(txParams);
+    }, {
+        onRetry: ({ attempt, message }) => {
+            console.error(`[safe-adapter] executeSafeTxDirect retry ${attempt}: ${message}`);
+        },
+    });
+    return { hash };
+}
+//# sourceMappingURL=safe-adapter.js.map

package/dist/earning/safe-adapter.js.map

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

package/dist/earning/stolas-claim.d.ts

@@ -0,0 +1,47 @@
+/**
+ * stOLAS ExternalStakingDistributor reward claims for fleet services.
+ *
+ * The distributor's claim() calls checkpointAndClaim on each staking proxy; the OLAS-style
+ * staking implementation reverts on zero reward, so we read calculateStakingReward first and
+ * skip sends when pending is zero (no revert loop).
+ *
+ * TODO(self-bond): rewards are owned by the service Safe; wire Safe-batched staking.claim /
+ * checkpointAndClaim when staking_mode is self-bond (not distributor-mediated).
+ */
+import type { PublicClient } from 'viem';
+import type { WalletClient } from 'viem';
+import type { ServiceState, StakingMode } from './types.js';
+export interface StolasClaimTarget {
+    stakingProxy: string;
+    serviceId: number;
+}
+/**
+ * Services that may need distributor.claim (pure filter for tests and tick).
+ */
+export declare function listStolasClaimTargets(services: ServiceState[]): StolasClaimTarget[];
+export interface StolasClaimTickResult {
+    attempted: number;
+    submitted: number;
+    skippedNoPending: number;
+    skippedNoDistributor: boolean;
+    skippedWrongMode: boolean;
+    /** Services where pending reward was non-zero and a claim tx was attempted (send path). */
+    claimAttempted: number;
+    failedRecoverable: number;
+    /** Non-recoverable send errors, bad/missing receipts, etc. */
+    failedPermanent: number;
+}
+/**
+ * For each fleet service with pending staking rewards, submit distributor.claim([proxy],[id]).
+ * Errors on individual services are logged and swallowed so the daemon loop stays healthy.
+ */
+export declare function tickStolasDistributorClaims(publicClient: PublicClient, masterWallet: WalletClient, options: {
+    distributorAddress: string | undefined;
+    stakingMode: StakingMode;
+    targets: StolasClaimTarget[];
+    /**
+     * When true (CLI), all claim sends failing recoverably surfaces {@link TransientError};
+     * any permanent/receipt failure surfaces a normal Error. Daemon callers omit this.
+     */
+    strict?: boolean;
+}): Promise<StolasClaimTickResult>;