@jinn-network/client 0.1.0-canary.adfd078d

package/dist/earning/evidence-simhash.js

@@ -0,0 +1,87 @@
+/**
+ * evidence-simhash.ts — Compute SimHash of evidence checkpoints for anti-farming.
+ *
+ * SimHash produces a 256-bit fingerprint where similar inputs produce similar hashes
+ * (low Hamming distance). The on-chain activity checker (RestorationActivityCheckerV2)
+ * compares these hashes to detect farming — repeated submission of similar evidence.
+ *
+ * The algorithm:
+ *   1. Extract string features from the evidence checkpoint
+ *   2. Hash each feature to 256 bits via keccak256
+ *   3. For each bit position, tally +1 (bit set) or -1 (bit unset) across all features
+ *   4. The SimHash bit is 1 if the tally is non-negative, 0 otherwise
+ */
+import { keccak256, toHex } from 'viem';
+/**
+ * Extract string features from an evidence checkpoint.
+ * Each feature becomes one "vote" in the SimHash computation.
+ */
+export function extractFeatures(checkpoint) {
+    const features = [];
+    features.push(`desired:${checkpoint.desiredStateHash}`);
+    for (const tc of checkpoint.toolCalls) {
+        features.push(`tool:${tc.name.toLowerCase().trim()}:${tc.argsHash}`);
+    }
+    for (const ei of checkpoint.externalInteractions) {
+        features.push(`ext:${ei.endpoint.toLowerCase().trim()}:${ei.method.toLowerCase().trim()}`);
+    }
+    features.push(`outcome:${checkpoint.outcome}`);
+    return features;
+}
+/**
+ * Compute a 256-bit SimHash from an array of string features.
+ *
+ * Each feature is hashed to 256 bits via keccak256. For each bit position,
+ * we tally +1 if the bit is set, -1 if not. The output bit is 1 if the
+ * tally is non-negative.
+ */
+export function simhashFromFeatures(features) {
+    if (features.length === 0) {
+        return '0x0000000000000000000000000000000000000000000000000000000000000000';
+    }
+    // Hash each feature to 256 bits
+    const featureHashes = features.map((f) => BigInt(keccak256(toHex(f))));
+    // Vote on each bit position
+    const votes = new Int32Array(256);
+    for (const hash of featureHashes) {
+        for (let i = 0; i < 256; i++) {
+            if ((hash >> BigInt(i)) & 1n) {
+                votes[i] += 1;
+            }
+            else {
+                votes[i] -= 1;
+            }
+        }
+    }
+    // Construct SimHash from vote signs
+    let simhash = 0n;
+    for (let i = 0; i < 256; i++) {
+        if (votes[i] >= 0) {
+            simhash |= 1n << BigInt(i);
+        }
+    }
+    return ('0x' + simhash.toString(16).padStart(64, '0'));
+}
+/**
+ * Compute the SimHash of an evidence checkpoint.
+ * Returns a bytes32 hex string suitable for submission to the on-chain activity checker.
+ */
+export function computeEvidenceSimHash(checkpoint) {
+    const features = extractFeatures(checkpoint);
+    return simhashFromFeatures(features);
+}
+/**
+ * Compute the Hamming distance between two bytes32 hex strings.
+ * Useful for client-side similarity checking before submitting on-chain.
+ */
+export function hammingDistance(a, b) {
+    const xor = BigInt(a) ^ BigInt(b);
+    let count = 0;
+    let bits = xor;
+    while (bits > 0n) {
+        count += Number(bits & 1n);
+        bits >>= 1n;
+    }
+    return count;
+}
+//# sourceMappingURL=evidence-simhash.js.map

package/dist/earning/evidence-simhash.js.map

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

package/dist/earning/fleet-display-index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Display index for operator-facing JSON (jinn fleet / balance / rewards).
+ * Persisted {@link ServiceState.index} is the HD derivation slot (typically 1-based).
+ */
+import type { ServiceState } from './types.js';
+/** Same value as `services[].index` in GET fleet v1 and related surfaces. */
+export declare function displayFleetServiceIndex(svc: ServiceState): number;
+export declare function findServiceByDisplayIndex(services: ServiceState[], displayIndex: number): ServiceState | undefined;

package/dist/earning/fleet-display-index.js

@@ -0,0 +1,12 @@
+/**
+ * Display index for operator-facing JSON (jinn fleet / balance / rewards).
+ * Persisted {@link ServiceState.index} is the HD derivation slot (typically 1-based).
+ */
+/** Same value as `services[].index` in GET fleet v1 and related surfaces. */
+export function displayFleetServiceIndex(svc) {
+    return Math.max(0, svc.index - 1);
+}
+export function findServiceByDisplayIndex(services, displayIndex) {
+    return services.find(s => displayFleetServiceIndex(s) === displayIndex);
+}
+//# sourceMappingURL=fleet-display-index.js.map

package/dist/earning/fleet-display-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-display-index.js","sourceRoot":"","sources":["../../src/earning/fleet-display-index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,6EAA6E;AAC7E,MAAM,UAAU,wBAAwB,CAAC,GAAiB;IACxD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,QAAwB,EACxB,YAAoB;IAEpB,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,wBAAwB,CAAC,CAAC,CAAC,KAAK,YAAY,CAAC,CAAC;AAC1E,CAAC"}

package/dist/earning/fleet-retire.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Retire one standard (distributor-managed) fleet service: distributor.unstakeAndWithdraw,
+ * then drop the row from local fleet JSON.
+ */
+import type { PublicClient } from 'viem';
+import type { WalletClient } from 'viem';
+import type { FleetStateStore } from './store.js';
+import type { FleetState, ServiceState } from './types.js';
+export interface RetireFleetServiceParams {
+    publicClient: PublicClient;
+    masterWallet: WalletClient;
+    distributorAddress: string | undefined;
+    fleetStore: FleetStateStore;
+    chain: 'base' | 'base-sepolia';
+    serviceIndex: number;
+}
+export interface RetireFleetServiceResult {
+    ok: boolean;
+    txHash?: string;
+    message: string;
+}
+/**
+ * Unstake + terminate + unbond via ExternalStakingDistributor, then remove the service from disk.
+ * Self-bond mode is not supported here (return ok: false).
+ */
+export declare function retireFleetServiceOnChain(params: RetireFleetServiceParams): Promise<RetireFleetServiceResult>;
+/** Read-only: whether the service row exists in fleet JSON. */
+export declare function findFleetService(state: FleetState, serviceIndex: number): ServiceState | undefined;

package/dist/earning/fleet-retire.js

@@ -0,0 +1,75 @@
+/**
+ * Retire one standard (distributor-managed) fleet service: distributor.unstakeAndWithdraw,
+ * then drop the row from local fleet JSON.
+ */
+import { encodeFunctionData, getAddress, pad } from 'viem';
+import { STOLAS_DISTRIBUTOR_ABI } from './contracts.js';
+import { viemSendTransactionWithRetry, waitForTransactionReceiptWithRetry, } from '../tx-retry.js';
+/**
+ * Unstake + terminate + unbond via ExternalStakingDistributor, then remove the service from disk.
+ * Self-bond mode is not supported here (return ok: false).
+ */
+export async function retireFleetServiceOnChain(params) {
+    const { publicClient, masterWallet, distributorAddress, fleetStore, chain, serviceIndex } = params;
+    const state = await fleetStore.load(chain);
+    const stakingMode = state.staking_mode;
+    if (stakingMode !== 'standard') {
+        return {
+            ok: false,
+            message: `fleet retire is only implemented for staking_mode=standard (got ${stakingMode}).`,
+        };
+    }
+    if (!distributorAddress) {
+        return {
+            ok: false,
+            message: 'No distributor address in chain config; cannot call unstakeAndWithdraw.',
+        };
+    }
+    const svc = state.services.find(s => s.index === serviceIndex);
+    if (!svc) {
+        return { ok: true, message: `Service index ${serviceIndex} not in fleet state (already removed).` };
+    }
+    if (svc.service_id === null || !svc.staking_address) {
+        return {
+            ok: false,
+            message: `Service ${serviceIndex} is missing service_id or staking_address; cannot retire on-chain.`,
+        };
+    }
+    const stakingProxy = getAddress(svc.staking_address);
+    const operation = pad(stakingProxy, { size: 32 });
+    const data = encodeFunctionData({
+        abi: STOLAS_DISTRIBUTOR_ABI,
+        functionName: 'unstakeAndWithdraw',
+        args: [stakingProxy, BigInt(svc.service_id), operation],
+    });
+    try {
+        const txHash = await viemSendTransactionWithRetry(masterWallet, publicClient, {
+            account: masterWallet.account,
+            to: getAddress(distributorAddress),
+            data,
+            gas: 2500000n,
+        });
+        const receipt = await waitForTransactionReceiptWithRetry(publicClient, txHash);
+        if (receipt.status !== 'success') {
+            return {
+                ok: false,
+                message: `unstakeAndWithdraw tx failed or timed out (hash=${txHash}).`,
+            };
+        }
+        await fleetStore.removeService(serviceIndex);
+        return {
+            ok: true,
+            txHash,
+            message: `Retired service ${serviceIndex} (service_id=${svc.service_id}).`,
+        };
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        return { ok: false, message: msg };
+    }
+}
+/** Read-only: whether the service row exists in fleet JSON. */
+export function findFleetService(state, serviceIndex) {
+    return state.services.find(s => s.index === serviceIndex);
+}
+//# sourceMappingURL=fleet-retire.js.map

package/dist/earning/fleet-retire.js.map

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

package/dist/earning/jinn-rewards.d.ts

@@ -0,0 +1,62 @@
+/**
+ * JINN reward claiming helper for the Phase 1a staking contract.
+ *
+ * The OLAS-style staking proxy exposes `calculateStakingReward()` plus
+ * owner-authorized `claim()` / `checkpointAndClaim()` entrypoints.
+ */
+import type { PublicClient, WalletClient } from 'viem';
+export declare const JINN_STAKING_ABI: readonly [{
+    readonly inputs: readonly [{
+        readonly name: "serviceId";
+        readonly type: "uint256";
+    }];
+    readonly name: "calculateStakingReward";
+    readonly outputs: readonly [{
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly name: "serviceId";
+        readonly type: "uint256";
+    }];
+    readonly name: "claim";
+    readonly outputs: readonly [{
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly name: "serviceId";
+        readonly type: "uint256";
+    }];
+    readonly name: "checkpointAndClaim";
+    readonly outputs: readonly [{
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}];
+/**
+ * Claim JINN rewards from the Phase 1a staking contract.
+ *
+ * Returns { claimed: false, amount: 0n } until the Phase 1a contract is
+ * deployed and the ABI is finalised. Wiring up is a matter of uncommenting
+ * the contract call below.
+ *
+ * @param publicClient  — viem PublicClient for read calls
+ * @param walletClient  — viem WalletClient for write calls
+ * @param stakingContractAddress — Phase 1a JINN staking contract address
+ * @param serviceId     — OLAS service ID registered in the staking contract
+ */
+export declare function claimJinnRewards(publicClient: PublicClient, walletClient: WalletClient, stakingContractAddress: `0x${string}`, serviceId: number, options?: {
+    checkpoint?: boolean;
+}): Promise<{
+    claimed: boolean;
+    amount: bigint;
+}>;

package/dist/earning/jinn-rewards.js

@@ -0,0 +1,81 @@
+/**
+ * JINN reward claiming helper for the Phase 1a staking contract.
+ *
+ * The OLAS-style staking proxy exposes `calculateStakingReward()` plus
+ * owner-authorized `claim()` / `checkpointAndClaim()` entrypoints.
+ */
+// ---------------------------------------------------------------------------
+// ABI fragment — only the functions we call
+// ---------------------------------------------------------------------------
+export const JINN_STAKING_ABI = [
+    {
+        inputs: [
+            { name: 'serviceId', type: 'uint256' },
+        ],
+        name: 'calculateStakingReward',
+        outputs: [{ name: 'amount', type: 'uint256' }],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [
+            { name: 'serviceId', type: 'uint256' },
+        ],
+        name: 'claim',
+        outputs: [{ name: 'amount', type: 'uint256' }],
+        stateMutability: 'nonpayable',
+        type: 'function',
+    },
+    {
+        inputs: [
+            { name: 'serviceId', type: 'uint256' },
+        ],
+        name: 'checkpointAndClaim',
+        outputs: [{ name: 'amount', type: 'uint256' }],
+        stateMutability: 'nonpayable',
+        type: 'function',
+    },
+];
+// ---------------------------------------------------------------------------
+// Claim function
+// ---------------------------------------------------------------------------
+/**
+ * Claim JINN rewards from the Phase 1a staking contract.
+ *
+ * Returns { claimed: false, amount: 0n } until the Phase 1a contract is
+ * deployed and the ABI is finalised. Wiring up is a matter of uncommenting
+ * the contract call below.
+ *
+ * @param publicClient  — viem PublicClient for read calls
+ * @param walletClient  — viem WalletClient for write calls
+ * @param stakingContractAddress — Phase 1a JINN staking contract address
+ * @param serviceId     — OLAS service ID registered in the staking contract
+ */
+export async function claimJinnRewards(publicClient, walletClient, stakingContractAddress, serviceId, options = {}) {
+    const pending = await publicClient.readContract({
+        address: stakingContractAddress,
+        abi: JINN_STAKING_ABI,
+        functionName: 'calculateStakingReward',
+        args: [BigInt(serviceId)],
+    });
+    if (pending === 0n) {
+        return { claimed: false, amount: 0n };
+    }
+    // Submit claim transaction
+    const [account] = await walletClient.getAddresses();
+    const hash = await walletClient.writeContract({
+        address: stakingContractAddress,
+        abi: JINN_STAKING_ABI,
+        functionName: options.checkpoint ? 'checkpointAndClaim' : 'claim',
+        args: [BigInt(serviceId)],
+        account,
+        chain: walletClient.chain ?? null,
+    });
+    // Wait for confirmation
+    const receipt = await publicClient.waitForTransactionReceipt({ hash });
+    if (receipt.status !== 'success') {
+        throw new Error(`JINN reward claim tx reverted: ${hash}`);
+    }
+    return { claimed: true, amount: pending };
+}
+//# sourceMappingURL=jinn-rewards.js.map

package/dist/earning/jinn-rewards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jinn-rewards.js","sourceRoot":"","sources":["../../src/earning/jinn-rewards.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,8EAA8E;AAC9E,4CAA4C;AAC5C,8EAA8E;AAE9E,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B;QACE,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;SACvC;QACD,IAAI,EAAE,wBAAwB;QAC9B,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC9C,eAAe,EAAE,MAAM;QACvB,IAAI,EAAE,UAAU;KACjB;IACD;QACE,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;SACvC;QACD,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC9C,eAAe,EAAE,YAAY;QAC7B,IAAI,EAAE,UAAU;KACjB;IACD;QACE,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;SACvC;QACD,IAAI,EAAE,oBAAoB;QAC1B,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC9C,eAAe,EAAE,YAAY;QAC7B,IAAI,EAAE,UAAU;KACjB;CACO,CAAC;AAEX,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,YAA0B,EAC1B,YAA0B,EAC1B,sBAAqC,EACrC,SAAiB,EACjB,UAAoC,EAAE;IAEtC,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC;QAC9C,OAAO,EAAE,sBAAsB;QAC/B,GAAG,EAAE,gBAAgB;QACrB,YAAY,EAAE,wBAAwB;QACtC,IAAI,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;KAC1B,CAAC,CAAC;IAEH,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;QACnB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACxC,CAAC;IAED,2BAA2B;IAC3B,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,YAAY,CAAC,YAAY,EAAE,CAAC;IACpD,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,aAAa,CAAC;QAC5C,OAAO,EAAE,sBAAsB;QAC/B,GAAG,EAAE,gBAAgB;QACrB,YAAY,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,OAAO;QACjE,IAAI,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACzB,OAAO;QACP,KAAK,EAAE,YAAY,CAAC,KAAK,IAAI,IAAI;KAClC,CAAC,CAAC;IAEH,wBAAwB;IACxB,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,yBAAyB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IACvE,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,kCAAkC,IAAI,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC5C,CAAC"}

package/dist/earning/next-service-index.d.ts

@@ -0,0 +1,4 @@
+/** Next HD service slot after existing rows (avoids reusing an index after a middle-row delete). */
+export declare function nextFleetServiceIndex(services: Array<{
+    index: number;
+}>): number;

package/dist/earning/next-service-index.js

@@ -0,0 +1,7 @@
+/** Next HD service slot after existing rows (avoids reusing an index after a middle-row delete). */
+export function nextFleetServiceIndex(services) {
+    if (services.length === 0)
+        return 1;
+    return Math.max(...services.map(s => s.index)) + 1;
+}
+//# sourceMappingURL=next-service-index.js.map

package/dist/earning/next-service-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-service-index.js","sourceRoot":"","sources":["../../src/earning/next-service-index.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,MAAM,UAAU,qBAAqB,CAAC,QAAkC;IACtE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACpC,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC;AACrD,CAAC"}

package/dist/earning/orphan-sweep.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Best-effort recovery of ETH from a service Safe / agent EOA when bootstrap abandons
+ * a persisted Safe (reconcile clear or stale standard-mode state).
+ *
+ * ERC-20 balances on the old Safe are not swept yet — see TODO below.
+ */
+import { type Hex } from 'viem';
+import type { ServiceState } from './types.js';
+import { type JinnOnchainNetwork } from './viem-clients.js';
+import { type PrivateKeyAccount } from 'viem/accounts';
+import type { PublicClient } from 'viem';
+/**
+ * If reconcile (or similar) will drop or replace `safe_address`, return the on-chain
+ * address that will no longer be tracked so we can sweep it first.
+ */
+export declare function previousSafeBeingAbandoned(svc: ServiceState, patch: Partial<ServiceState>): string | null;
+export interface SweepOrphanedServiceFundsParams {
+    rpcUrl: string;
+    network: JinnOnchainNetwork;
+    publicClient: PublicClient;
+    masterAddress: string;
+    masterAccount: PrivateKeyAccount;
+    serviceIndex: number;
+    agentPrivateKey: Hex;
+    agentAddress: string;
+    abandonedSafeAddress: string;
+    minAgentReserveWei: bigint;
+}
+/**
+ * Sweep ETH from an abandoned deployed Safe (via Safe.execTransaction) and excess
+ * agent EOA ETH to the master. Never throws; logs actionable errors on failure.
+ */
+export declare function sweepOrphanedServiceFunds(params: SweepOrphanedServiceFundsParams): Promise<void>;

package/dist/earning/orphan-sweep.js

@@ -0,0 +1,157 @@
+/**
+ * Best-effort recovery of ETH from a service Safe / agent EOA when bootstrap abandons
+ * a persisted Safe (reconcile clear or stale standard-mode state).
+ *
+ * ERC-20 balances on the old Safe are not swept yet — see TODO below.
+ */
+import { formatEther, getAddress, zeroAddress } from 'viem';
+import { executeSafeTxDirect } from './safe-adapter.js';
+import { createJinnWalletClient } from './viem-clients.js';
+import { privateKeyToAccount } from 'viem/accounts';
+import { viemSendTransactionWithRetry, waitForTransactionReceiptWithRetry, } from '../tx-retry.js';
+function isZeroishAddress(addr) {
+    if (!addr)
+        return true;
+    try {
+        return getAddress(addr) === getAddress(zeroAddress);
+    }
+    catch {
+        return true;
+    }
+}
+/**
+ * If reconcile (or similar) will drop or replace `safe_address`, return the on-chain
+ * address that will no longer be tracked so we can sweep it first.
+ */
+export function previousSafeBeingAbandoned(svc, patch) {
+    const prev = svc.safe_address;
+    if (!prev || isZeroishAddress(prev))
+        return null;
+    let prevNorm;
+    try {
+        prevNorm = getAddress(prev);
+    }
+    catch {
+        return null;
+    }
+    if (patch.safe_address === null)
+        return prevNorm;
+    if (patch.safe_address !== undefined && patch.safe_address !== null) {
+        try {
+            const nextNorm = getAddress(patch.safe_address);
+            if (nextNorm !== prevNorm)
+                return prevNorm;
+        }
+        catch {
+            return prevNorm;
+        }
+    }
+    return null;
+}
+/**
+ * Sweep ETH from an abandoned deployed Safe (via Safe.execTransaction) and excess
+ * agent EOA ETH to the master. Never throws; logs actionable errors on failure.
+ */
+export async function sweepOrphanedServiceFunds(params) {
+    const { serviceIndex, masterAddress } = params;
+    let masterNorm;
+    try {
+        masterNorm = getAddress(masterAddress);
+    }
+    catch {
+        console.error(`[jinn-earning] Service ${serviceIndex}: orphan sweep skipped — invalid master_address.`);
+        return;
+    }
+    try {
+        await runOrphanSweepBody({
+            ...params,
+            masterNorm,
+        });
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        console.error(`[jinn-earning] Service ${serviceIndex}: orphan sweep aborted (${msg}). Fix RPC connectivity or retry bootstrap later.`);
+    }
+}
+async function runOrphanSweepBody(params) {
+    const { rpcUrl, network, publicClient, masterNorm, masterAccount, serviceIndex, agentPrivateKey, agentAddress, abandonedSafeAddress, minAgentReserveWei, } = params;
+    const code = await publicClient.getCode({ address: getAddress(abandonedSafeAddress) });
+    const safeBal = await publicClient.getBalance({ address: getAddress(abandonedSafeAddress) });
+    if (code !== undefined && code !== '0x' && safeBal > 0n) {
+        let agentBal = await publicClient.getBalance({ address: getAddress(agentAddress) });
+        if (agentBal < minAgentReserveWei) {
+            const need = minAgentReserveWei - agentBal;
+            const masterBal = await publicClient.getBalance({ address: masterNorm });
+            if (masterBal > need) {
+                try {
+                    console.error(`[jinn-earning] Service ${serviceIndex}: funding agent ${agentAddress} with ${need} wei so the Safe owner can exec orphan sweep from ${abandonedSafeAddress}.`);
+                    const masterWallet = createJinnWalletClient(rpcUrl, network, masterAccount);
+                    const fundHash = await viemSendTransactionWithRetry(masterWallet, publicClient, {
+                        account: masterAccount,
+                        to: getAddress(agentAddress),
+                        value: need,
+                    });
+                    await waitForTransactionReceiptWithRetry(publicClient, fundHash);
+                    agentBal = await publicClient.getBalance({ address: getAddress(agentAddress) });
+                }
+                catch (e) {
+                    const msg = e instanceof Error ? e.message : String(e);
+                    console.error(`[jinn-earning] Service ${serviceIndex}: could not fund agent for orphan Safe sweep (${abandonedSafeAddress} holds ${safeBal} wei). ${msg} — send at least ${formatEther(need)} ETH to the agent EOA, then re-run bootstrap.`);
+                }
+            }
+            else {
+                console.error(`[jinn-earning] Service ${serviceIndex}: orphan Safe ${abandonedSafeAddress} holds ${safeBal} wei but master and agent lack gas to sweep. Fund master or agent, then re-run bootstrap.`);
+            }
+        }
+        agentBal = await publicClient.getBalance({ address: getAddress(agentAddress) });
+        if (agentBal >= minAgentReserveWei) {
+            try {
+                const { hash } = await executeSafeTxDirect({
+                    rpcUrl,
+                    signerKey: agentPrivateKey,
+                    safeAddress: abandonedSafeAddress,
+                    to: getAddress(masterNorm),
+                    value: safeBal,
+                    data: '0x',
+                });
+                const receipt = await waitForTransactionReceiptWithRetry(publicClient, hash);
+                if (receipt.status !== 'success') {
+                    console.error(`[jinn-earning] Service ${serviceIndex}: orphan Safe sweep tx failed or timed out (safe=${abandonedSafeAddress}, tx=${hash}). Re-run bootstrap to retry.`);
+                }
+                else {
+                    console.error(`[jinn-earning] Service ${serviceIndex}: swept ${safeBal} wei from orphan Safe ${abandonedSafeAddress} to master (tx: ${hash}).`);
+                }
+            }
+            catch (e) {
+                const msg = e instanceof Error ? e.message : String(e);
+                console.error(`[jinn-earning] Service ${serviceIndex}: orphan Safe sweep failed for ${abandonedSafeAddress} (${msg}). Ensure the agent EOA is still a Safe owner and re-run bootstrap, or move funds manually to master ${masterNorm}.`);
+            }
+        }
+    }
+    // TODO: sweep ERC-20 (e.g. OLAS) from abandoned Safe via Safe.execTransaction(transfer).
+    const agentAccount = privateKeyToAccount(agentPrivateKey);
+    const agentWallet = createJinnWalletClient(rpcUrl, network, agentAccount);
+    const finalAgentBal = await publicClient.getBalance({ address: getAddress(agentAddress) });
+    const transferable = finalAgentBal > minAgentReserveWei ? finalAgentBal - minAgentReserveWei : 0n;
+    if (transferable > 0n) {
+        try {
+            const txHash = await viemSendTransactionWithRetry(agentWallet, publicClient, {
+                account: agentAccount,
+                to: getAddress(masterNorm),
+                value: transferable,
+            });
+            const receipt = await waitForTransactionReceiptWithRetry(publicClient, txHash);
+            if (receipt.status !== 'success') {
+                console.error(`[jinn-earning] Service ${serviceIndex}: agent EOA sweep tx failed (tx=${txHash}). Re-run bootstrap to retry.`);
+            }
+            else {
+                console.error(`[jinn-earning] Service ${serviceIndex}: swept ${transferable} wei from agent ${agentAddress} to master (tx: ${txHash}).`);
+            }
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            console.error(`[jinn-earning] Service ${serviceIndex}: agent EOA sweep failed (${msg}). Re-run bootstrap to retry or send manually to master ${masterNorm}.`);
+        }
+    }
+}
+//# sourceMappingURL=orphan-sweep.js.map

package/dist/earning/orphan-sweep.js.map

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

package/dist/earning/reconcile.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Pure reconciliation rules: persisted fleet service state vs on-chain signals.
+ * Used by FleetBootstrapper so operators need not hand-edit earning_state.json.
+ */
+import type { ServiceState } from './types.js';
+/** `revert` = call reverted (authoritative). `inconclusive` = RPC/transport — do not clear state. */
+export type ChainReadFailure = 'revert' | 'missing' | 'inconclusive';
+/** On-chain view gathered before applying rules (all reads best-effort). */
+export interface ServiceChainSignals {
+    stakingState: number | ChainReadFailure;
+    /** Staking.getServiceInfo().multisig when readable */
+    stakingMultisig: string | null;
+    /** ServiceRegistry.getService().state when readable */
+    registryState: number | ChainReadFailure;
+    /** ServiceRegistry.getService().multisig when readable */
+    registryMultisig: string | null;
+    /** Whether bytecode exists at persisted safe_address */
+    safeDeployed: boolean | null;
+}
+export interface ReconcilePatch {
+    /** Operator-facing line (logged by bootstrap) */
+    message: string;
+    patch: Partial<ServiceState>;
+}
+/**
+ * Standard (distributor) mode: staking proxy is source of truth for stake/eviction.
+ */
+export declare function reconcileStandardService(index: number, svc: ServiceState, chain: ServiceChainSignals, ctx: {
+    stakingContract: string;
+}): ReconcilePatch | null;
+/**
+ * Self-bond mode: registry + Safe bytecode + staking.
+ */
+export declare function reconcileSelfBondService(index: number, svc: ServiceState, chain: ServiceChainSignals): ReconcilePatch | null;
+export declare function reconcileServiceAgainstChain(stakingMode: 'standard' | 'self-bond', svc: ServiceState, chain: ServiceChainSignals, ctx: {
+    stakingContract: string;
+}): ReconcilePatch | null;