@jinn-network/client 0.1.2 → 0.1.3-canary.24b69ea4

package/dist/earning/testnet-setup-migration.js

@@ -0,0 +1,214 @@
+import { encodeFunctionData, getAddress, pad, } from 'viem';
+import { STAKING_ABI, STOLAS_DISTRIBUTOR_ABI } from './contracts.js';
+import { viemSendTransactionWithRetry, waitForTransactionReceiptWithRetry, } from '../tx-retry.js';
+export const DEPRECATED_BASE_SEPOLIA_STAKING_PROXY = '0xf358b5c1ac4ddc4e807b5baf008826bf193eab3b';
+const MIGRATION_KIND = 'base-sepolia-standard-setup';
+function sameAddress(a, b) {
+    if (!a || !b)
+        return false;
+    try {
+        return getAddress(a) === getAddress(b);
+    }
+    catch {
+        return false;
+    }
+}
+function isDeprecatedService(svc, currentStakingContract) {
+    return (svc.service_id !== null &&
+        sameAddress(svc.staking_address, DEPRECATED_BASE_SEPOLIA_STAKING_PROXY) &&
+        !sameAddress(currentStakingContract, DEPRECATED_BASE_SEPOLIA_STAKING_PROXY));
+}
+export function detectDeprecatedTestnetSetup(params) {
+    if (params.chain !== 'base-sepolia' || params.stakingMode !== 'standard') {
+        return { services: [] };
+    }
+    return {
+        services: params.state.services.filter(svc => isDeprecatedService(svc, params.currentStakingContract)),
+    };
+}
+function migrationId(svc) {
+    const serviceId = svc.service_id ?? 'none';
+    const staking = svc.staking_address
+        ? getAddress(svc.staking_address).toLowerCase()
+        : 'none';
+    return `${MIGRATION_KIND}:${svc.index}:${serviceId}:${staking}`;
+}
+function archiveEntryForService(params) {
+    return {
+        migration_id: migrationId(params.svc),
+        kind: MIGRATION_KIND,
+        chain: 'base-sepolia',
+        service_index: params.svc.index,
+        backup_state_path: params.existing?.backup_state_path || params.backupStatePath,
+        from: {
+            service_id: params.svc.service_id,
+            safe_address: params.svc.safe_address,
+            mech_address: params.svc.mech_address,
+            staking_address: params.svc.staking_address,
+            step: params.svc.step,
+            agent_id: params.svc.agent_id ?? null,
+        },
+        to: {
+            staking_address: getAddress(params.currentStakingContract),
+        },
+        retire_status: params.existing?.retire_status ?? 'pending',
+        retire_tx_hash: params.existing?.retire_tx_hash ?? null,
+        retire_error: params.existing?.retire_error ?? null,
+        state_reset_at: params.existing?.state_reset_at ?? null,
+    };
+}
+function isTerminalRetireStatus(status) {
+    return status === 'retired' || status === 'already_inactive';
+}
+async function readOldSetupState(publicClient, stakingProxy, serviceId) {
+    try {
+        return Number(await publicClient.readContract({
+            address: getAddress(stakingProxy),
+            abi: STAKING_ABI,
+            functionName: 'getStakingState',
+            args: [BigInt(serviceId)],
+        }));
+    }
+    catch {
+        return null;
+    }
+}
+async function retireOldSetup(params) {
+    if (params.svc.service_id === null || !params.svc.staking_address) {
+        return {
+            retire_status: 'already_inactive',
+            retire_tx_hash: null,
+            retire_error: null,
+        };
+    }
+    const oldState = await readOldSetupState(params.publicClient, params.svc.staking_address, params.svc.service_id);
+    if (oldState === 0) {
+        return {
+            retire_status: 'already_inactive',
+            retire_tx_hash: null,
+            retire_error: null,
+        };
+    }
+    if (!params.distributorAddress) {
+        return {
+            retire_status: 'failed',
+            retire_tx_hash: null,
+            retire_error: 'No distributor configured for automatic setup retirement.',
+        };
+    }
+    let txHash = null;
+    try {
+        const stakingProxy = getAddress(params.svc.staking_address);
+        const operation = pad(stakingProxy, { size: 32 });
+        const data = encodeFunctionData({
+            abi: STOLAS_DISTRIBUTOR_ABI,
+            functionName: 'unstakeAndWithdraw',
+            args: [stakingProxy, BigInt(params.svc.service_id), operation],
+        });
+        txHash = await params.sendTransaction(params.masterWallet, params.publicClient, {
+            account: params.masterWallet.account,
+            to: getAddress(params.distributorAddress),
+            data,
+            gas: 2500000n,
+        });
+        const receipt = await params.waitForReceipt(params.publicClient, txHash);
+        if (receipt.status !== 'success') {
+            return {
+                retire_status: 'failed',
+                retire_tx_hash: txHash,
+                retire_error: `Previous setup retirement transaction failed (${txHash}).`,
+            };
+        }
+        return {
+            retire_status: 'retired',
+            retire_tx_hash: txHash,
+            retire_error: null,
+        };
+    }
+    catch (error) {
+        return {
+            retire_status: 'failed',
+            retire_tx_hash: txHash,
+            retire_error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+export async function migrateDeprecatedTestnetSetup(params) {
+    const plan = detectDeprecatedTestnetSetup({
+        state: params.state,
+        chain: params.chain,
+        stakingMode: params.stakingMode,
+        currentStakingContract: params.currentStakingContract,
+    });
+    if (plan.services.length === 0) {
+        return { state: params.state, migratedCount: 0, archivePaths: [] };
+    }
+    console.error('Upgrading your Jinn earning setup...');
+    const sendTransaction = params.sendTransaction ?? viemSendTransactionWithRetry;
+    const waitForReceipt = params.waitForReceipt ?? waitForTransactionReceiptWithRetry;
+    let archive = await params.stateStore.loadMigrationArchive();
+    let backupPathForNewEntries = null;
+    let nextState = params.state;
+    const archivePaths = new Set();
+    let migratedCount = 0;
+    for (const svc of plan.services) {
+        const id = migrationId(svc);
+        const existing = archive.entries.find(e => e.migration_id === id);
+        let backupStatePath = existing?.backup_state_path;
+        if (!backupStatePath) {
+            backupPathForNewEntries ??= await params.stateStore.backupStateFile('testnet-setup-migration');
+            backupStatePath = backupPathForNewEntries ?? '';
+        }
+        let entry = await params.stateStore.upsertMigrationArchiveEntry(archiveEntryForService({
+            svc,
+            currentStakingContract: params.currentStakingContract,
+            backupStatePath,
+            existing,
+        }));
+        if (entry.backup_state_path) {
+            archivePaths.add(entry.backup_state_path);
+        }
+        if (!isTerminalRetireStatus(entry.retire_status)) {
+            const retire = await retireOldSetup({
+                svc,
+                distributorAddress: params.distributorAddress,
+                publicClient: params.publicClient,
+                masterWallet: params.masterWallet,
+                sendTransaction,
+                waitForReceipt,
+            });
+            entry = await params.stateStore.upsertMigrationArchiveEntry({
+                ...entry,
+                ...retire,
+            });
+            if (retire.retire_status === 'failed') {
+                console.error('Previous Jinn setup could not be fully retired automatically; it was archived for recovery. Continuing upgrade...');
+            }
+        }
+        nextState = await params.stateStore.updateService(svc.index, {
+            service_id: null,
+            safe_address: null,
+            mech_address: null,
+            staking_address: null,
+            step: 'awaiting_stake',
+            error: null,
+            safe_bound_to_agent: false,
+        });
+        await params.stateStore.upsertMigrationArchiveEntry({
+            ...entry,
+            state_reset_at: new Date().toISOString(),
+        });
+        archive = await params.stateStore.loadMigrationArchive();
+        migratedCount += 1;
+    }
+    if (archivePaths.size > 0) {
+        console.error(`Previous setup archived for recovery at: ${[...archivePaths].join(', ')}`);
+    }
+    console.error('Jinn earning setup upgraded.');
+    return {
+        state: nextState,
+        migratedCount,
+        archivePaths: [...archivePaths],
+    };
+}
+//# sourceMappingURL=testnet-setup-migration.js.map

package/dist/earning/testnet-setup-migration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testnet-setup-migration.js","sourceRoot":"","sources":["../../src/earning/testnet-setup-migration.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,UAAU,EACV,GAAG,GAKJ,MAAM,MAAM,CAAC;AACd,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAOrE,OAAO,EACL,4BAA4B,EAC5B,kCAAkC,GACnC,MAAM,gBAAgB,CAAC;AAExB,MAAM,CAAC,MAAM,qCAAqC,GAChD,4CAA4C,CAAC;AAE/C,MAAM,cAAc,GAAG,6BAAsC,CAAC;AAyB9D,SAAS,WAAW,CAAC,CAA4B,EAAE,CAA4B;IAC7E,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3B,IAAI,CAAC;QACH,OAAO,UAAU,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB,CAC1B,GAAiB,EACjB,sBAA8B;IAE9B,OAAO,CACL,GAAG,CAAC,UAAU,KAAK,IAAI;QACvB,WAAW,CAAC,GAAG,CAAC,eAAe,EAAE,qCAAqC,CAAC;QACvE,CAAC,WAAW,CAAC,sBAAsB,EAAE,qCAAqC,CAAC,CAC5E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,MAK5C;IACC,IAAI,MAAM,CAAC,KAAK,KAAK,cAAc,IAAI,MAAM,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;QACzE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAC1B,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC3C,mBAAmB,CAAC,GAAG,EAAE,MAAM,CAAC,sBAAsB,CAAC,CACxD;KACF,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,GAAiB;IACpC,MAAM,SAAS,GAAG,GAAG,CAAC,UAAU,IAAI,MAAM,CAAC;IAC3C,MAAM,OAAO,GAAG,GAAG,CAAC,eAAe;QACjC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,WAAW,EAAE;QAC/C,CAAC,CAAC,MAAM,CAAC;IACX,OAAO,GAAG,cAAc,IAAI,GAAG,CAAC,KAAK,IAAI,SAAS,IAAI,OAAO,EAAE,CAAC;AAClE,CAAC;AAED,SAAS,sBAAsB,CAAC,MAK/B;IACC,OAAO;QACL,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC;QACrC,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,cAAc;QACrB,aAAa,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK;QAC/B,iBAAiB,EAAE,MAAM,CAAC,QAAQ,EAAE,iBAAiB,IAAI,MAAM,CAAC,eAAe;QAC/E,IAAI,EAAE;YACJ,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,UAAU;YACjC,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,YAAY;YACrC,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,YAAY;YACrC,eAAe,EAAE,MAAM,CAAC,GAAG,CAAC,eAAe;YAC3C,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI;YACrB,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,IAAI,IAAI;SACtC;QACD,EAAE,EAAE;YACF,eAAe,EAAE,UAAU,CAAC,MAAM,CAAC,sBAAsB,CAAC;SAC3D;QACD,aAAa,EAAE,MAAM,CAAC,QAAQ,EAAE,aAAa,IAAI,SAAS;QAC1D,cAAc,EAAE,MAAM,CAAC,QAAQ,EAAE,cAAc,IAAI,IAAI;QACvD,YAAY,EAAE,MAAM,CAAC,QAAQ,EAAE,YAAY,IAAI,IAAI;QACnD,cAAc,EAAE,MAAM,CAAC,QAAQ,EAAE,cAAc,IAAI,IAAI;KACxD,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAAC,MAAoC;IAClE,OAAO,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,kBAAkB,CAAC;AAC/D,CAAC;AAED,KAAK,UAAU,iBAAiB,CAC9B,YAA0B,EAC1B,YAAoB,EACpB,SAAiB;IAEjB,IAAI,CAAC;QACH,OAAO,MAAM,CACX,MAAM,YAAY,CAAC,YAAY,CAAC;YAC9B,OAAO,EAAE,UAAU,CAAC,YAAY,CAAY;YAC5C,GAAG,EAAE,WAAW;YAChB,YAAY,EAAE,iBAAiB;YAC/B,IAAI,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;SAC1B,CAAC,CACH,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,cAAc,CAC3B,MAOC;IAMD,IAAI,MAAM,CAAC,GAAG,CAAC,UAAU,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;QAClE,OAAO;YACL,aAAa,EAAE,kBAAkB;YACjC,cAAc,EAAE,IAAI;YACpB,YAAY,EAAE,IAAI;SACnB,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CACtC,MAAM,CAAC,YAAY,EACnB,MAAM,CAAC,GAAG,CAAC,eAAe,EAC1B,MAAM,CAAC,GAAG,CAAC,UAAU,CACtB,CAAC;IACF,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QACnB,OAAO;YACL,aAAa,EAAE,kBAAkB;YACjC,cAAc,EAAE,IAAI;YACpB,YAAY,EAAE,IAAI;SACnB,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC;QAC/B,OAAO;YACL,aAAa,EAAE,QAAQ;YACvB,cAAc,EAAE,IAAI;YACpB,YAAY,EAAE,2DAA2D;SAC1E,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,GAAe,IAAI,CAAC;IAC9B,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QAC5D,MAAM,SAAS,GAAG,GAAG,CAAC,YAAmB,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QACzD,MAAM,IAAI,GAAG,kBAAkB,CAAC;YAC9B,GAAG,EAAE,sBAAsB;YAC3B,YAAY,EAAE,oBAAoB;YAClC,IAAI,EAAE,CAAC,YAAuB,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,SAAS,CAAC;SAC1E,CAAQ,CAAC;QAEV,MAAM,GAAG,MAAM,MAAM,CAAC,eAAe,CACnC,MAAM,CAAC,YAAY,EACnB,MAAM,CAAC,YAAY,EACnB;YACE,OAAO,EAAE,MAAM,CAAC,YAAY,CAAC,OAAQ;YACrC,EAAE,EAAE,UAAU,CAAC,MAAM,CAAC,kBAAkB,CAAY;YACpD,IAAI;YACJ,GAAG,EAAE,QAAU;SAChB,CACF,CAAC;QACF,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QACzE,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACjC,OAAO;gBACL,aAAa,EAAE,QAAQ;gBACvB,cAAc,EAAE,MAAM;gBACtB,YAAY,EAAE,iDAAiD,MAAM,IAAI;aAC1E,CAAC;QACJ,CAAC;QACD,OAAO;YACL,aAAa,EAAE,SAAS;YACxB,cAAc,EAAE,MAAM;YACtB,YAAY,EAAE,IAAI;SACnB,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,aAAa,EAAE,QAAQ;YACvB,cAAc,EAAE,MAAM;YACtB,YAAY,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SACrE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,MAAmC;IAEnC,MAAM,IAAI,GAAG,4BAA4B,CAAC;QACxC,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,sBAAsB,EAAE,MAAM,CAAC,sBAAsB;KACtD,CAAC,CAAC;IACH,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,aAAa,EAAE,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;IACrE,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAEtD,MAAM,eAAe,GAAG,MAAM,CAAC,eAAe,IAAI,4BAA4B,CAAC;IAC/E,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,kCAAkC,CAAC;IACnF,IAAI,OAAO,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC;IAC7D,IAAI,uBAAuB,GAAkB,IAAI,CAAC;IAClD,IAAI,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC;IAC7B,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IACvC,IAAI,aAAa,GAAG,CAAC,CAAC;IAEtB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChC,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAC5B,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,EAAE,CAAC,CAAC;QAClE,IAAI,eAAe,GAAG,QAAQ,EAAE,iBAAiB,CAAC;QAClD,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,uBAAuB,KAAK,MAAM,MAAM,CAAC,UAAU,CAAC,eAAe,CAAC,yBAAyB,CAAC,CAAC;YAC/F,eAAe,GAAG,uBAAuB,IAAI,EAAE,CAAC;QAClD,CAAC;QAED,IAAI,KAAK,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,2BAA2B,CAC7D,sBAAsB,CAAC;YACrB,GAAG;YACH,sBAAsB,EAAE,MAAM,CAAC,sBAAsB;YACrD,eAAe;YACf,QAAQ;SACT,CAAC,CACH,CAAC;QACF,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAC5C,CAAC;QAED,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC;YACjD,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC;gBAClC,GAAG;gBACH,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;gBAC7C,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,eAAe;gBACf,cAAc;aACf,CAAC,CAAC;YACH,KAAK,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,2BAA2B,CAAC;gBAC1D,GAAG,KAAK;gBACR,GAAG,MAAM;aACV,CAAC,CAAC;YACH,IAAI,MAAM,CAAC,aAAa,KAAK,QAAQ,EAAE,CAAC;gBACtC,OAAO,CAAC,KAAK,CACX,mHAAmH,CACpH,CAAC;YACJ,CAAC;QACH,CAAC;QAED,SAAS,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE;YAC3D,UAAU,EAAE,IAAI;YAChB,YAAY,EAAE,IAAI;YAClB,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,IAAI;YACrB,IAAI,EAAE,gBAAgB;YACtB,KAAK,EAAE,IAAI;YACX,mBAAmB,EAAE,KAAK;SAC3B,CAAC,CAAC;QACH,MAAM,MAAM,CAAC,UAAU,CAAC,2BAA2B,CAAC;YAClD,GAAG,KAAK;YACR,cAAc,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACzC,CAAC,CAAC;QACH,OAAO,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC;QACzD,aAAa,IAAI,CAAC,CAAC;IACrB,CAAC;IAED,IAAI,YAAY,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,KAAK,CAAC,4CAA4C,CAAC,GAAG,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5F,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAE9C,OAAO;QACL,KAAK,EAAE,SAAS;QAChB,aAAa;QACb,YAAY,EAAE,CAAC,GAAG,YAAY,CAAC;KAChC,CAAC;AACJ,CAAC"}

package/dist/earning/types.d.ts

@@ -1,8 +1,12 @@
 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 declare const ServiceStepSchema: z.ZodEnum<["awaiting_stake", "service_created", "service_activated", "agents_registered", "service_deployed", "service_staked", "staked", "mech_deployed", "agent_registered", "safe_binding_pending", "complete"]>;
 export type ServiceStep = z.infer<typeof ServiceStepSchema>;
+export declare const OPERATIONAL_SERVICE_STEPS: Set<"awaiting_stake" | "service_created" | "service_activated" | "agents_registered" | "service_deployed" | "service_staked" | "staked" | "mech_deployed" | "agent_registered" | "safe_binding_pending" | "complete">;
+export declare const STAKED_LIKE_SERVICE_STEPS: Set<"awaiting_stake" | "service_created" | "service_activated" | "agents_registered" | "service_deployed" | "service_staked" | "staked" | "mech_deployed" | "agent_registered" | "safe_binding_pending" | "complete">;
+export declare function isOperationalServiceStep(step: ServiceStep | string): boolean;
+export declare function isStakedLikeServiceStep(step: ServiceStep | string): boolean;
 export declare const ServiceStateSchema: z.ZodObject<{
     index: z.ZodNumber;
     agent_address: z.ZodString;
@@ -10,8 +14,13 @@ export declare const ServiceStateSchema: z.ZodObject<{
     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"]>;
+    step: z.ZodEnum<["awaiting_stake", "service_created", "service_activated", "agents_registered", "service_deployed", "service_staked", "staked", "mech_deployed", "agent_registered", "safe_binding_pending", "complete"]>;
     error: z.ZodNullable<z.ZodString>;
+    agent_id: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    agent_uri: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    identity_registry_address: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    agent_registered_tx: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    safe_bound_to_agent: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodBoolean>>>;
 }, "strip", z.ZodTypeAny, {
     error: string | null;
     index: number;
@@ -20,7 +29,12 @@ export declare const ServiceStateSchema: z.ZodObject<{
     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";
+    step: "awaiting_stake" | "service_created" | "service_activated" | "agents_registered" | "service_deployed" | "service_staked" | "staked" | "mech_deployed" | "agent_registered" | "safe_binding_pending" | "complete";
+    agent_id: string | null;
+    agent_uri: string | null;
+    identity_registry_address: string | null;
+    agent_registered_tx: string | null;
+    safe_bound_to_agent: boolean | null;
 }, {
     error: string | null;
     index: number;
@@ -29,7 +43,12 @@ export declare const ServiceStateSchema: z.ZodObject<{
     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";
+    step: "awaiting_stake" | "service_created" | "service_activated" | "agents_registered" | "service_deployed" | "service_staked" | "staked" | "mech_deployed" | "agent_registered" | "safe_binding_pending" | "complete";
+    agent_id?: string | null | undefined;
+    agent_uri?: string | null | undefined;
+    identity_registry_address?: string | null | undefined;
+    agent_registered_tx?: string | null | undefined;
+    safe_bound_to_agent?: boolean | null | undefined;
 }>;
 export type ServiceState = z.infer<typeof ServiceStateSchema>;
 export declare const FleetStateSchema: z.ZodObject<{
@@ -43,8 +62,13 @@ export declare const FleetStateSchema: z.ZodObject<{
         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"]>;
+        step: z.ZodEnum<["awaiting_stake", "service_created", "service_activated", "agents_registered", "service_deployed", "service_staked", "staked", "mech_deployed", "agent_registered", "safe_binding_pending", "complete"]>;
         error: z.ZodNullable<z.ZodString>;
+        agent_id: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        agent_uri: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        identity_registry_address: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        agent_registered_tx: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        safe_bound_to_agent: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodBoolean>>>;
     }, "strip", z.ZodTypeAny, {
         error: string | null;
         index: number;
@@ -53,7 +77,12 @@ export declare const FleetStateSchema: z.ZodObject<{
         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";
+        step: "awaiting_stake" | "service_created" | "service_activated" | "agents_registered" | "service_deployed" | "service_staked" | "staked" | "mech_deployed" | "agent_registered" | "safe_binding_pending" | "complete";
+        agent_id: string | null;
+        agent_uri: string | null;
+        identity_registry_address: string | null;
+        agent_registered_tx: string | null;
+        safe_bound_to_agent: boolean | null;
     }, {
         error: string | null;
         index: number;
@@ -62,7 +91,12 @@ export declare const FleetStateSchema: z.ZodObject<{
         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";
+        step: "awaiting_stake" | "service_created" | "service_activated" | "agents_registered" | "service_deployed" | "service_staked" | "staked" | "mech_deployed" | "agent_registered" | "safe_binding_pending" | "complete";
+        agent_id?: string | null | undefined;
+        agent_uri?: string | null | undefined;
+        identity_registry_address?: string | null | undefined;
+        agent_registered_tx?: string | null | undefined;
+        safe_bound_to_agent?: boolean | null | undefined;
     }>, "many">;
     updated_at: z.ZodString;
 }, "strip", z.ZodTypeAny, {
@@ -77,7 +111,12 @@ export declare const FleetStateSchema: z.ZodObject<{
         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";
+        step: "awaiting_stake" | "service_created" | "service_activated" | "agents_registered" | "service_deployed" | "service_staked" | "staked" | "mech_deployed" | "agent_registered" | "safe_binding_pending" | "complete";
+        agent_id: string | null;
+        agent_uri: string | null;
+        identity_registry_address: string | null;
+        agent_registered_tx: string | null;
+        safe_bound_to_agent: boolean | null;
     }[];
     updated_at: string;
 }, {
@@ -91,7 +130,12 @@ export declare const FleetStateSchema: z.ZodObject<{
         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";
+        step: "awaiting_stake" | "service_created" | "service_activated" | "agents_registered" | "service_deployed" | "service_staked" | "staked" | "mech_deployed" | "agent_registered" | "safe_binding_pending" | "complete";
+        agent_id?: string | null | undefined;
+        agent_uri?: string | null | undefined;
+        identity_registry_address?: string | null | undefined;
+        agent_registered_tx?: string | null | undefined;
+        safe_bound_to_agent?: boolean | null | undefined;
     }[];
     updated_at: string;
     staking_mode?: "standard" | "self-bond" | undefined;
@@ -118,6 +162,10 @@ export interface FleetBootstrapResult {
     ok: boolean;
     fleet_state: FleetState;
     message: string;
+    /** Raw underlying error message, preserved when `ok` is false so the
+     *  envelope-side error formatter has not yet collapsed the diagnostic.
+     *  See `operator-errors.ts` and jinn-mono-jz9f. */
+    rawErrorMessage?: string;
     funding?: FundingRequirement;
     self_bond_funding?: SelfBondFundingRequirement;
 }

package/dist/earning/types.js

@@ -4,11 +4,17 @@ export const StakingModeSchema = z.enum(['standard', 'self-bond']);
 // ── Service step progression ─────────────────────────────────────────────────
 //
 // Standard (stOLAS) mode:
-//   awaiting_stake -> staked -> mech_deployed -> complete
+//   awaiting_stake -> staked -> mech_deployed -> agent_registered ->
+//   safe_binding_pending -> complete
 //
 // Self-bond mode (legacy):
 //   awaiting_stake -> service_created -> service_activated -> agents_registered ->
-//   service_deployed -> service_staked -> mech_deployed -> complete
+//   service_deployed -> service_staked -> mech_deployed -> agent_registered ->
+//   safe_binding_pending -> complete
+//
+// `agent_registered` is the ERC-8004 IdentityRegistry mint
+// (one agent NFT per operator Safe; see
+// docs/superpowers/specs/2026-04-27-erc-8004-entity-model-design.md §4.1).
 export const ServiceStepSchema = z.enum([
     'awaiting_stake',
     'service_created',
@@ -18,8 +24,28 @@ export const ServiceStepSchema = z.enum([
     'service_staked',
     'staked',
     'mech_deployed',
+    'agent_registered',
+    'safe_binding_pending',
+    'complete',
+]);
+export const OPERATIONAL_SERVICE_STEPS = new Set([
+    'safe_binding_pending',
+    'complete',
+]);
+export const STAKED_LIKE_SERVICE_STEPS = new Set([
+    'staked',
+    'mech_deployed',
+    'agent_registered',
+    'safe_binding_pending',
     'complete',
+    'service_staked',
 ]);
+export function isOperationalServiceStep(step) {
+    return step === 'complete' || step === 'safe_binding_pending';
+}
+export function isStakedLikeServiceStep(step) {
+    return STAKED_LIKE_SERVICE_STEPS.has(step);
+}
 // ── Per-service state ────────────────────────────────────────────────────────
 export const ServiceStateSchema = z.object({
     index: z.number().int().min(1),
@@ -30,6 +56,24 @@ export const ServiceStateSchema = z.object({
     staking_address: z.string().nullable(),
     step: ServiceStepSchema,
     error: z.string().nullable(),
+    // ERC-8004 IdentityRegistry mint state.
+    //
+    // Populated by the operator-NFT mint step at bootstrap (jinn-mono-j07,
+    // see bootstrap.ts `stepRegisterAgent`). Read in main.ts (jinn-mono-3zk)
+    // to construct an `IdentityPublisher` for the engine when bootstrap has
+    // produced an agentId.
+    //
+    // All optional — missing on legacy state files written before the mint
+    // step landed; the daemon defensively skips publishing when `agent_id`
+    // is null. Decimal string because the on-chain `agentId` is `uint256`.
+    agent_id: z.string().nullable().optional().default(null),
+    agent_uri: z.string().nullable().optional().default(null),
+    identity_registry_address: z.string().nullable().optional().default(null),
+    agent_registered_tx: z.string().nullable().optional().default(null),
+    // True once `IdentityRegistry.setAgentWallet` succeeds for this Safe.
+    // Currently always `false` — wallet binding is deferred to jinn-mono-aev
+    // (Safe ERC-1271 wrapping).
+    safe_bound_to_agent: z.boolean().nullable().optional().default(false),
 });
 // ── Fleet state (top-level) ──────────────────────────────────────────────────
 export const FleetStateSchema = z.object({
@@ -59,6 +103,11 @@ export function createDefaultServiceState(index, agentAddress) {
         staking_address: null,
         step: 'awaiting_stake',
         error: null,
+        agent_id: null,
+        agent_uri: null,
+        identity_registry_address: null,
+        agent_registered_tx: null,
+        safe_bound_to_agent: false,
     };
 }
 //# sourceMappingURL=types.js.map

package/dist/earning/types.js.map

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

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

@@ -1,9 +1,29 @@
 /**
  * Shared viem PublicClient / WalletClient wiring for fleet earning + CLI.
+ *
+ * Two chain families: the L2 measurement chain (Base / Base Sepolia) and the
+ * L1 governance chain (Ethereum mainnet / Sepolia). The cross-chain JINN
+ * claim loop (jinn-mono-7x5) needs both — it emits ClaimTicket on L2 and
+ * submits proofs on L1.
  */
 import { type Chain, type PublicClient, type Transport, type WalletClient } from 'viem';
 import type { PrivateKeyAccount } from 'viem/accounts';
 export type JinnOnchainNetwork = 'base' | 'base-sepolia';
+/** L1 governance chain network — JINN token + Distributor + Messenger live here. */
+export type JinnL1Network = 'sepolia' | 'ethereum';
 export declare function jinnChain(network: JinnOnchainNetwork): Chain;
+export declare function jinnL1Chain(network: JinnL1Network): 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>;
+/**
+ * PublicClient for the L1 governance chain. Used by the cross-chain claim
+ * loop to read distributor state, build OP-Stack proofs (canonical mode) and
+ * submit `JinnDistributor.claim`.
+ */
+export declare function createJinnL1PublicClient(rpcUrl: string, network: JinnL1Network): PublicClient<Transport, Chain>;
+/**
+ * WalletClient for the L1 governance chain. The daemon's master wallet is
+ * the default signer — same key that pays for L2 stOLAS reward claims and
+ * bootstrap.
+ */
+export declare function createJinnL1WalletClient(rpcUrl: string, network: JinnL1Network, account: PrivateKeyAccount): WalletClient<Transport, Chain, PrivateKeyAccount>;

package/dist/earning/viem-clients.js

@@ -1,11 +1,19 @@
 /**
  * Shared viem PublicClient / WalletClient wiring for fleet earning + CLI.
+ *
+ * Two chain families: the L2 measurement chain (Base / Base Sepolia) and the
+ * L1 governance chain (Ethereum mainnet / Sepolia). The cross-chain JINN
+ * claim loop (jinn-mono-7x5) needs both — it emits ClaimTicket on L2 and
+ * submits proofs on L1.
  */
 import { createPublicClient, createWalletClient, http, } from 'viem';
-import { base, baseSepolia } from 'viem/chains';
+import { base, baseSepolia, mainnet, sepolia } from 'viem/chains';
 export function jinnChain(network) {
     return network === 'base-sepolia' ? baseSepolia : base;
 }
+export function jinnL1Chain(network) {
+    return network === 'sepolia' ? sepolia : mainnet;
+}
 export function createJinnPublicClient(rpcUrl, network) {
     return createPublicClient({
         chain: jinnChain(network),
@@ -19,4 +27,27 @@ export function createJinnWalletClient(rpcUrl, network, account) {
         transport: http(rpcUrl),
     });
 }
+/**
+ * PublicClient for the L1 governance chain. Used by the cross-chain claim
+ * loop to read distributor state, build OP-Stack proofs (canonical mode) and
+ * submit `JinnDistributor.claim`.
+ */
+export function createJinnL1PublicClient(rpcUrl, network) {
+    return createPublicClient({
+        chain: jinnL1Chain(network),
+        transport: http(rpcUrl),
+    });
+}
+/**
+ * WalletClient for the L1 governance chain. The daemon's master wallet is
+ * the default signer — same key that pays for L2 stOLAS reward claims and
+ * bootstrap.
+ */
+export function createJinnL1WalletClient(rpcUrl, network, account) {
+    return createWalletClient({
+        account,
+        chain: jinnL1Chain(network),
+        transport: http(rpcUrl),
+    });
+}
 //# sourceMappingURL=viem-clients.js.map

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

@@ -1 +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"}
+{"version":3,"file":"viem-clients.js","sourceRoot":"","sources":["../../src/earning/viem-clients.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,IAAI,GAKL,MAAM,MAAM,CAAC;AACd,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAQlE,MAAM,UAAU,SAAS,CAAC,OAA2B;IACnD,OAAO,OAAO,KAAK,cAAc,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAsB;IAChD,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;AACnD,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;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CACtC,MAAc,EACd,OAAsB;IAEtB,OAAO,kBAAkB,CAAC;QACxB,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC;QAC3B,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC;KACxB,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CACtC,MAAc,EACd,OAAsB,EACtB,OAA0B;IAE1B,OAAO,kBAAkB,CAAC;QACxB,OAAO;QACP,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC;QAC3B,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC;KACxB,CAAC,CAAC;AACL,CAAC"}