@jinn-network/client 0.1.0-canary.adfd078d

package/dist/earning/stolas-claim.js

@@ -0,0 +1,115 @@
+/**
+ * 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 { encodeFunctionData, getAddress } from 'viem';
+import { STOLAS_DISTRIBUTOR_ABI } from './contracts.js';
+import { JINN_STAKING_ABI } from './jinn-rewards.js';
+import { isRecoverableTransactionError, viemSendTransactionWithRetry, waitForTransactionReceiptWithRetry, } from '../tx-retry.js';
+import { TransientError } from '../types/errors.js';
+/** Steps where the service is staked and may accrue staking rewards. */
+const STEPS_WITH_STAKING_REWARDS = new Set([
+    'staked',
+    'mech_deployed',
+    'complete',
+]);
+/**
+ * Services that may need distributor.claim (pure filter for tests and tick).
+ */
+export function listStolasClaimTargets(services) {
+    const out = [];
+    for (const s of services) {
+        if (!STEPS_WITH_STAKING_REWARDS.has(s.step))
+            continue;
+        if (s.service_id === null || s.staking_address === null)
+            continue;
+        out.push({ stakingProxy: s.staking_address, serviceId: s.service_id });
+    }
+    return out;
+}
+/**
+ * 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 async function tickStolasDistributorClaims(publicClient, masterWallet, options) {
+    const result = {
+        attempted: 0,
+        submitted: 0,
+        skippedNoPending: 0,
+        skippedNoDistributor: false,
+        skippedWrongMode: false,
+        claimAttempted: 0,
+        failedRecoverable: 0,
+        failedPermanent: 0,
+    };
+    if (options.stakingMode !== 'standard') {
+        result.skippedWrongMode = true;
+        return result;
+    }
+    const distributor = options.distributorAddress;
+    if (!distributor) {
+        result.skippedNoDistributor = true;
+        return result;
+    }
+    for (const { stakingProxy, serviceId } of options.targets) {
+        result.attempted += 1;
+        try {
+            const pending = await publicClient.readContract({
+                address: getAddress(stakingProxy),
+                abi: JINN_STAKING_ABI,
+                functionName: 'calculateStakingReward',
+                args: [BigInt(serviceId)],
+            });
+            if (pending === 0n) {
+                result.skippedNoPending += 1;
+                continue;
+            }
+            result.claimAttempted += 1;
+            const data = encodeFunctionData({
+                abi: STOLAS_DISTRIBUTOR_ABI,
+                functionName: 'claim',
+                args: [[getAddress(stakingProxy)], [BigInt(serviceId)]],
+            });
+            const txHash = await viemSendTransactionWithRetry(masterWallet, publicClient, {
+                account: masterWallet.account,
+                to: getAddress(distributor),
+                data,
+                gas: 1200000n,
+            });
+            const receipt = await waitForTransactionReceiptWithRetry(publicClient, txHash);
+            if (receipt.status !== 'success') {
+                result.failedPermanent += 1;
+                console.error(`[reward-claim] claim tx failed for service ${serviceId} (hash=${txHash})`);
+                continue;
+            }
+            result.submitted += 1;
+            console.log(`[reward-claim] Submitted distributor.claim for service ${serviceId} (~${pending.toString()} wei pending before tx)`);
+        }
+        catch (err) {
+            if (isRecoverableTransactionError(err)) {
+                result.failedRecoverable += 1;
+            }
+            else {
+                result.failedPermanent += 1;
+            }
+            console.error(`[reward-claim] Skipped service ${serviceId}:`, err instanceof Error ? err.message : err);
+        }
+    }
+    if (options.strict) {
+        const totalFailed = result.failedRecoverable + result.failedPermanent;
+        if (result.submitted === 0 && totalFailed > 0 && result.failedPermanent === 0) {
+            throw new TransientError(`Distributor claim: all ${totalFailed} failed service check(s) / claim attempt(s) hit recoverable errors.`);
+        }
+        if (result.submitted === 0 && result.failedPermanent > 0) {
+            throw new Error(`Distributor claim: all ${totalFailed} failed service check(s) / claim attempt(s) were non-recoverable or had bad receipts.`);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=stolas-claim.js.map

package/dist/earning/stolas-claim.js.map

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

package/dist/earning/store.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Fleet state persistence.
+ *
+ * State lives at ~/.jinn-client/earning/earning_state.json.
+ * Mnemonic keystore lives at ~/.jinn-client/earning/master_keystore.json.
+ * Legacy keystore (if present) at ~/.jinn-client/earning/agent_keystore.json.
+ */
+import { type FleetState, type ServiceState } from './types.js';
+export declare const DEFAULT_EARNING_DIR: string;
+/** Parse fleet JSON without side effects (for status / read-only tools). */
+export declare function parseFleetStateJson(raw: string): FleetState | null;
+export declare class FleetStateStore {
+    private readonly statePath;
+    private readonly mnemonicKeystorePath;
+    private readonly legacyKeystorePath;
+    private readonly earningDir;
+    constructor(earningDir?: string);
+    get dir(): string;
+    hasMnemonicKeystore(): boolean;
+    loadMnemonicKeystore(): Promise<string>;
+    saveMnemonicKeystore(encryptedJson: string): Promise<void>;
+    hasLegacyKeystore(): boolean;
+    migrateLegacyFiles(): Promise<void>;
+    /**
+     * Read persisted fleet state if the file exists and validates.
+     * Does not create a default file (unlike load()).
+     */
+    tryLoadExisting(): Promise<FleetState | null>;
+    load(chain?: 'base' | 'base-sepolia'): Promise<FleetState>;
+    save(state: FleetState): Promise<FleetState>;
+    patchFleet(patch: Partial<Omit<FleetState, 'services'>>): Promise<FleetState>;
+    updateService(index: number, patch: Partial<ServiceState>): Promise<FleetState>;
+    addService(service: ServiceState): Promise<FleetState>;
+    /** Remove one service row by its persisted `index` (not array offset). */
+    removeService(index: number): Promise<FleetState>;
+}

package/dist/earning/store.js

@@ -0,0 +1,156 @@
+/**
+ * Fleet state persistence.
+ *
+ * State lives at ~/.jinn-client/earning/earning_state.json.
+ * Mnemonic keystore lives at ~/.jinn-client/earning/master_keystore.json.
+ * Legacy keystore (if present) at ~/.jinn-client/earning/agent_keystore.json.
+ */
+import { existsSync } from 'fs';
+import { mkdir, readFile, rename, writeFile } from 'fs/promises';
+import os from 'os';
+import path from 'path';
+import { FleetStateSchema, createDefaultFleetState, } from './types.js';
+export const DEFAULT_EARNING_DIR = path.join(os.homedir(), '.jinn-client', 'earning');
+const STATE_FILE = 'earning_state.json';
+const MNEMONIC_KEYSTORE_FILE = 'master_keystore.json';
+const LEGACY_KEYSTORE_FILE = 'agent_keystore.json';
+async function writeJsonAtomic(filePath, data) {
+    const dir = path.dirname(filePath);
+    await mkdir(dir, { recursive: true });
+    const tmpPath = `${filePath}.tmp-${Date.now()}-${Math.random().toString(16).slice(2)}`;
+    await writeFile(tmpPath, `${JSON.stringify(data, null, 2)}\n`, 'utf8');
+    await rename(tmpPath, filePath);
+}
+/** Parse fleet JSON without side effects (for status / read-only tools). */
+export function parseFleetStateJson(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        const result = FleetStateSchema.safeParse(parsed);
+        if (result.success) {
+            return result.data;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+function parseFleetStateOrNull(raw) {
+    const data = parseFleetStateJson(raw);
+    if (data)
+        return data;
+    try {
+        JSON.parse(raw);
+        console.error('[earning-store] Invalid state schema; resetting.');
+    }
+    catch (error) {
+        console.error('[earning-store] Failed to parse state; resetting:', error);
+    }
+    return null;
+}
+export class FleetStateStore {
+    statePath;
+    mnemonicKeystorePath;
+    legacyKeystorePath;
+    earningDir;
+    constructor(earningDir = DEFAULT_EARNING_DIR) {
+        this.earningDir = earningDir;
+        this.statePath = path.join(earningDir, STATE_FILE);
+        this.mnemonicKeystorePath = path.join(earningDir, MNEMONIC_KEYSTORE_FILE);
+        this.legacyKeystorePath = path.join(earningDir, LEGACY_KEYSTORE_FILE);
+    }
+    get dir() {
+        return this.earningDir;
+    }
+    // ── Mnemonic keystore ──────────────────────────────────────────────────
+    hasMnemonicKeystore() {
+        return existsSync(this.mnemonicKeystorePath);
+    }
+    async loadMnemonicKeystore() {
+        return readFile(this.mnemonicKeystorePath, 'utf8');
+    }
+    async saveMnemonicKeystore(encryptedJson) {
+        await writeJsonAtomic(this.mnemonicKeystorePath, JSON.parse(encryptedJson));
+    }
+    // ── Legacy detection ───────────────────────────────────────────────────
+    hasLegacyKeystore() {
+        return existsSync(this.legacyKeystorePath);
+    }
+    async migrateLegacyFiles() {
+        if (existsSync(this.legacyKeystorePath)) {
+            await rename(this.legacyKeystorePath, `${this.legacyKeystorePath}.legacy`);
+        }
+        if (existsSync(this.statePath)) {
+            await rename(this.statePath, `${this.statePath}.legacy`);
+        }
+        console.error('[earning-store] Legacy keystore detected. Old files renamed with .legacy suffix. ' +
+            'A new mnemonic wallet will be generated.');
+    }
+    // ── Fleet state ────────────────────────────────────────────────────────
+    /**
+     * Read persisted fleet state if the file exists and validates.
+     * Does not create a default file (unlike load()).
+     */
+    async tryLoadExisting() {
+        if (!existsSync(this.statePath)) {
+            return null;
+        }
+        const raw = await readFile(this.statePath, 'utf8');
+        return parseFleetStateJson(raw);
+    }
+    async load(chain = 'base') {
+        if (!existsSync(this.statePath)) {
+            const state = createDefaultFleetState(chain);
+            await writeJsonAtomic(this.statePath, state);
+            return state;
+        }
+        const raw = await readFile(this.statePath, 'utf8');
+        const parsed = parseFleetStateOrNull(raw);
+        if (parsed) {
+            return parsed;
+        }
+        const backupPath = `${this.statePath}.invalid-${Date.now()}`;
+        await rename(this.statePath, backupPath);
+        const state = createDefaultFleetState(chain);
+        await writeJsonAtomic(this.statePath, state);
+        console.error(`[earning-store] Backed up invalid state to ${backupPath}`);
+        return state;
+    }
+    async save(state) {
+        const next = {
+            ...state,
+            updated_at: new Date().toISOString(),
+        };
+        const validated = FleetStateSchema.parse(next);
+        await writeJsonAtomic(this.statePath, validated);
+        return validated;
+    }
+    async patchFleet(patch) {
+        const current = await this.load();
+        return this.save({ ...current, ...patch });
+    }
+    async updateService(index, patch) {
+        const current = await this.load();
+        const svcIdx = current.services.findIndex(s => s.index === index);
+        if (svcIdx === -1) {
+            throw new Error(`Service at index ${index} not found in state`);
+        }
+        current.services[svcIdx] = { ...current.services[svcIdx], ...patch };
+        return this.save(current);
+    }
+    async addService(service) {
+        const current = await this.load();
+        current.services.push(service);
+        return this.save(current);
+    }
+    /** Remove one service row by its persisted `index` (not array offset). */
+    async removeService(index) {
+        const current = await this.load();
+        const next = current.services.filter(s => s.index !== index);
+        if (next.length === current.services.length) {
+            throw new Error(`Service at index ${index} not found in state`);
+        }
+        return this.save({ ...current, services: next });
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/earning/store.js.map

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

package/dist/earning/types.d.ts

@@ -0,0 +1,123 @@
+import { z } from 'zod';
+export declare const StakingModeSchema: z.ZodEnum<["standard", "self-bond"]>;
+export type StakingMode = z.infer<typeof StakingModeSchema>;
+export declare const ServiceStepSchema: z.ZodEnum<["awaiting_stake", "service_created", "service_activated", "agents_registered", "service_deployed", "service_staked", "staked", "mech_deployed", "complete"]>;
+export type ServiceStep = z.infer<typeof ServiceStepSchema>;
+export declare const ServiceStateSchema: z.ZodObject<{
+    index: z.ZodNumber;
+    agent_address: z.ZodString;
+    safe_address: z.ZodNullable<z.ZodString>;
+    service_id: z.ZodNullable<z.ZodNumber>;
+    mech_address: z.ZodNullable<z.ZodString>;
+    staking_address: z.ZodNullable<z.ZodString>;
+    step: z.ZodEnum<["awaiting_stake", "service_created", "service_activated", "agents_registered", "service_deployed", "service_staked", "staked", "mech_deployed", "complete"]>;
+    error: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    error: string | null;
+    index: number;
+    agent_address: string;
+    safe_address: string | null;
+    service_id: number | null;
+    mech_address: string | null;
+    staking_address: string | null;
+    step: "awaiting_stake" | "service_created" | "service_activated" | "agents_registered" | "service_deployed" | "service_staked" | "staked" | "mech_deployed" | "complete";
+}, {
+    error: string | null;
+    index: number;
+    agent_address: string;
+    safe_address: string | null;
+    service_id: number | null;
+    mech_address: string | null;
+    staking_address: string | null;
+    step: "awaiting_stake" | "service_created" | "service_activated" | "agents_registered" | "service_deployed" | "service_staked" | "staked" | "mech_deployed" | "complete";
+}>;
+export type ServiceState = z.infer<typeof ServiceStateSchema>;
+export declare const FleetStateSchema: z.ZodObject<{
+    master_address: z.ZodNullable<z.ZodString>;
+    chain: z.ZodEnum<["base", "base-sepolia"]>;
+    staking_mode: z.ZodDefault<z.ZodEnum<["standard", "self-bond"]>>;
+    services: z.ZodArray<z.ZodObject<{
+        index: z.ZodNumber;
+        agent_address: z.ZodString;
+        safe_address: z.ZodNullable<z.ZodString>;
+        service_id: z.ZodNullable<z.ZodNumber>;
+        mech_address: z.ZodNullable<z.ZodString>;
+        staking_address: z.ZodNullable<z.ZodString>;
+        step: z.ZodEnum<["awaiting_stake", "service_created", "service_activated", "agents_registered", "service_deployed", "service_staked", "staked", "mech_deployed", "complete"]>;
+        error: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        error: string | null;
+        index: number;
+        agent_address: string;
+        safe_address: string | null;
+        service_id: number | null;
+        mech_address: string | null;
+        staking_address: string | null;
+        step: "awaiting_stake" | "service_created" | "service_activated" | "agents_registered" | "service_deployed" | "service_staked" | "staked" | "mech_deployed" | "complete";
+    }, {
+        error: string | null;
+        index: number;
+        agent_address: string;
+        safe_address: string | null;
+        service_id: number | null;
+        mech_address: string | null;
+        staking_address: string | null;
+        step: "awaiting_stake" | "service_created" | "service_activated" | "agents_registered" | "service_deployed" | "service_staked" | "staked" | "mech_deployed" | "complete";
+    }>, "many">;
+    updated_at: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    chain: "base" | "base-sepolia";
+    master_address: string | null;
+    staking_mode: "standard" | "self-bond";
+    services: {
+        error: string | null;
+        index: number;
+        agent_address: string;
+        safe_address: string | null;
+        service_id: number | null;
+        mech_address: string | null;
+        staking_address: string | null;
+        step: "awaiting_stake" | "service_created" | "service_activated" | "agents_registered" | "service_deployed" | "service_staked" | "staked" | "mech_deployed" | "complete";
+    }[];
+    updated_at: string;
+}, {
+    chain: "base" | "base-sepolia";
+    master_address: string | null;
+    services: {
+        error: string | null;
+        index: number;
+        agent_address: string;
+        safe_address: string | null;
+        service_id: number | null;
+        mech_address: string | null;
+        staking_address: string | null;
+        step: "awaiting_stake" | "service_created" | "service_activated" | "agents_registered" | "service_deployed" | "service_staked" | "staked" | "mech_deployed" | "complete";
+    }[];
+    updated_at: string;
+    staking_mode?: "standard" | "self-bond" | undefined;
+}>;
+export type FleetState = z.infer<typeof FleetStateSchema>;
+export declare function createDefaultFleetState(chain?: 'base' | 'base-sepolia'): FleetState;
+export declare function createDefaultServiceState(index: number, agentAddress: string): ServiceState;
+export interface FundingRequirement {
+    master_address: string;
+    eth_required: string;
+    eth_balance: string;
+}
+export interface SelfBondFundingRequirement {
+    agent_address: string;
+    agent_eth_required: string;
+    agent_eth_balance: string;
+    safe_address: string;
+    safe_eth_required: string;
+    safe_eth_balance: string;
+    safe_olas_required: string;
+    safe_olas_balance: string;
+}
+export interface FleetBootstrapResult {
+    ok: boolean;
+    fleet_state: FleetState;
+    message: string;
+    funding?: FundingRequirement;
+    self_bond_funding?: SelfBondFundingRequirement;
+}

package/dist/earning/types.js

@@ -0,0 +1,64 @@
+import { z } from 'zod';
+// ── Staking mode ─────────────────────────────────────────────────────────────
+export const StakingModeSchema = z.enum(['standard', 'self-bond']);
+// ── Service step progression ─────────────────────────────────────────────────
+//
+// Standard (stOLAS) mode:
+//   awaiting_stake -> staked -> mech_deployed -> complete
+//
+// Self-bond mode (legacy):
+//   awaiting_stake -> service_created -> service_activated -> agents_registered ->
+//   service_deployed -> service_staked -> mech_deployed -> complete
+export const ServiceStepSchema = z.enum([
+    'awaiting_stake',
+    'service_created',
+    'service_activated',
+    'agents_registered',
+    'service_deployed',
+    'service_staked',
+    'staked',
+    'mech_deployed',
+    'complete',
+]);
+// ── Per-service state ────────────────────────────────────────────────────────
+export const ServiceStateSchema = z.object({
+    index: z.number().int().min(1),
+    agent_address: z.string(),
+    safe_address: z.string().nullable(),
+    service_id: z.number().nullable(),
+    mech_address: z.string().nullable(),
+    staking_address: z.string().nullable(),
+    step: ServiceStepSchema,
+    error: z.string().nullable(),
+});
+// ── Fleet state (top-level) ──────────────────────────────────────────────────
+export const FleetStateSchema = z.object({
+    master_address: z.string().nullable(),
+    chain: z.enum(['base', 'base-sepolia']),
+    staking_mode: StakingModeSchema.default('standard'),
+    services: z.array(ServiceStateSchema),
+    updated_at: z.string(),
+});
+// ── Factories ────────────────────────────────────────────────────────────────
+export function createDefaultFleetState(chain = 'base') {
+    return {
+        master_address: null,
+        chain,
+        staking_mode: 'standard',
+        services: [],
+        updated_at: new Date().toISOString(),
+    };
+}
+export function createDefaultServiceState(index, agentAddress) {
+    return {
+        index,
+        agent_address: agentAddress,
+        safe_address: null,
+        service_id: null,
+        mech_address: null,
+        staking_address: null,
+        step: 'awaiting_stake',
+        error: null,
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/earning/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/earning/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,gFAAgF;AAEhF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;AAGnE,gFAAgF;AAChF,EAAE;AACF,0BAA0B;AAC1B,0DAA0D;AAC1D,EAAE;AACF,2BAA2B;AAC3B,mFAAmF;AACnF,oEAAoE;AAEpE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,IAAI,CAAC;IACtC,gBAAgB;IAChB,iBAAiB;IACjB,mBAAmB;IACnB,mBAAmB;IACnB,kBAAkB;IAClB,gBAAgB;IAChB,QAAQ;IACR,eAAe;IACf,UAAU;CACX,CAAC,CAAC;AAIH,gFAAgF;AAEhF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;IACzB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACtC,IAAI,EAAE,iBAAiB;IACvB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC;AAIH,gFAAgF;AAEhF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACvC,YAAY,EAAE,iBAAiB,CAAC,OAAO,CAAC,UAAU,CAAC;IACnD,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC;IACrC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;CACvB,CAAC,CAAC;AAIH,gFAAgF;AAEhF,MAAM,UAAU,uBAAuB,CAAC,QAAiC,MAAM;IAC7E,OAAO;QACL,cAAc,EAAE,IAAI;QACpB,KAAK;QACL,YAAY,EAAE,UAAU;QACxB,QAAQ,EAAE,EAAE;QACZ,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACrC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,KAAa,EAAE,YAAoB;IAC3E,OAAO;QACL,KAAK;QACL,aAAa,EAAE,YAAY;QAC3B,YAAY,EAAE,IAAI;QAClB,UAAU,EAAE,IAAI;QAChB,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,IAAI;QACrB,IAAI,EAAE,gBAAgB;QACtB,KAAK,EAAE,IAAI;KACZ,CAAC;AACJ,CAAC"}

package/dist/earning/viem-clients.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Shared viem PublicClient / WalletClient wiring for fleet earning + CLI.
+ */
+import { type Chain, type PublicClient, type Transport, type WalletClient } from 'viem';
+import type { PrivateKeyAccount } from 'viem/accounts';
+export type JinnOnchainNetwork = 'base' | 'base-sepolia';
+export declare function jinnChain(network: JinnOnchainNetwork): Chain;
+export declare function createJinnPublicClient(rpcUrl: string, network: JinnOnchainNetwork): PublicClient<Transport, Chain>;
+export declare function createJinnWalletClient(rpcUrl: string, network: JinnOnchainNetwork, account: PrivateKeyAccount): WalletClient<Transport, Chain, PrivateKeyAccount>;

package/dist/earning/viem-clients.js

@@ -0,0 +1,22 @@
+/**
+ * Shared viem PublicClient / WalletClient wiring for fleet earning + CLI.
+ */
+import { createPublicClient, createWalletClient, http, } from 'viem';
+import { base, baseSepolia } from 'viem/chains';
+export function jinnChain(network) {
+    return network === 'base-sepolia' ? baseSepolia : base;
+}
+export function createJinnPublicClient(rpcUrl, network) {
+    return createPublicClient({
+        chain: jinnChain(network),
+        transport: http(rpcUrl),
+    });
+}
+export function createJinnWalletClient(rpcUrl, network, account) {
+    return createWalletClient({
+        account,
+        chain: jinnChain(network),
+        transport: http(rpcUrl),
+    });
+}
+//# sourceMappingURL=viem-clients.js.map

package/dist/earning/viem-clients.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viem-clients.js","sourceRoot":"","sources":["../../src/earning/viem-clients.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,IAAI,GAKL,MAAM,MAAM,CAAC;AACd,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAKhD,MAAM,UAAU,SAAS,CAAC,OAA2B;IACnD,OAAO,OAAO,KAAK,cAAc,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,MAAc,EACd,OAA2B;IAE3B,OAAO,kBAAkB,CAAC;QACxB,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC;QACzB,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC;KACxB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,MAAc,EACd,OAA2B,EAC3B,OAA0B;IAE1B,OAAO,kBAAkB,CAAC;QACxB,OAAO;QACP,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC;QACzB,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC;KACxB,CAAC,CAAC;AACL,CAAC"}

package/dist/earning/wallet.d.ts

@@ -0,0 +1,20 @@
+/**
+ * HD wallet derivation for fleet management.
+ *
+ * Mnemonic -> derive master (index 0) and agent (index 1+) wallets.
+ * Master is the funder, agents are service instances.
+ *
+ * Derivation path: m/44'/60'/0'/0/{index}
+ *   Index 0: master wallet (funder)
+ *   Index 1+: agent wallets (one per service)
+ */
+import { type Hex } from 'viem';
+import { type PrivateKeyAccount } from 'viem/accounts';
+export declare function walletPrivateKeyAtIndex(mnemonic: string, index: number): Hex;
+export declare function generateMnemonic(): string;
+export declare function encryptMnemonic(mnemonic: string, password: string): Promise<string>;
+export declare function decryptMnemonic(encrypted: string, password: string): Promise<string>;
+export declare function deriveMasterAddress(mnemonic: string): string;
+export declare function deriveAgentAddress(mnemonic: string, index: number): string;
+export declare function deriveMasterSigner(mnemonic: string): PrivateKeyAccount;
+export declare function deriveAgentSigner(mnemonic: string, index: number): PrivateKeyAccount;