@fased/fased 0.1.61 → 0.1.64

package/extensions/sat-mining/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fased/sat-mining",
-  "version": "0.1.61",
+  "version": "0.1.64",
   "private": true,
   "description": "SAT mining plugin scaffold for FasedAgent",
   "type": "module",

package/extensions/sat-mining/signer-codec-schema.v1.json

@@ -0,0 +1,374 @@
+{
+  "version": 1,
+  "codecs": [
+    {
+      "action": "initializeCycle",
+      "family": "main",
+      "contractKey": "initializeCycle",
+      "discriminator": 38,
+      "dataLength": 105,
+      "accountShape": "SW,-W,-W,--",
+      "variable": ""
+    },
+    {
+      "action": "validatorAttestation",
+      "family": "main",
+      "contractKey": "submitValidatorAttestation",
+      "discriminator": 45,
+      "dataLength": 161,
+      "accountShape": "SW,-W,-W,-W,--",
+      "variable": ""
+    },
+    {
+      "action": "openDispute",
+      "family": "main",
+      "contractKey": "openDispute",
+      "discriminator": 46,
+      "dataLength": 89,
+      "accountShape": "SW,-W,-W,-W,--",
+      "variable": ""
+    },
+    {
+      "action": "resolveDispute",
+      "family": "main",
+      "contractKey": "resolveDispute",
+      "discriminator": 48,
+      "dataLength": 57,
+      "accountShape": "SW,--,-W,-W",
+      "variable": ""
+    },
+    {
+      "action": "republishEpochRoots",
+      "family": "main",
+      "contractKey": "republishEpochRoots",
+      "discriminator": 49,
+      "dataLength": 105,
+      "accountShape": "SW,--,-W",
+      "variable": ""
+    },
+    {
+      "action": "topUpRegistryReserve",
+      "family": "main",
+      "contractKey": "topUpRegistryReserve",
+      "discriminator": 84,
+      "dataLength": 9,
+      "accountShape": "SW,-W,--",
+      "variable": ""
+    },
+    {
+      "action": "openCycle",
+      "family": "main",
+      "contractKey": "openCycle",
+      "discriminator": 56,
+      "dataLength": 9,
+      "accountShape": "SW,-W,-W,-W,-W,-W,--,-W",
+      "variable": ""
+    },
+    {
+      "action": "initMinerCapital",
+      "family": "main",
+      "contractKey": "initMinerCapital",
+      "discriminator": 36,
+      "dataLength": 33,
+      "accountShape": "SW,-W,--",
+      "variable": ""
+    },
+    {
+      "action": "depositMinerCapital",
+      "family": "main",
+      "contractKey": "depositMinerCapital",
+      "discriminator": 37,
+      "dataLength": 9,
+      "accountShape": "SW,-W,--",
+      "variable": ""
+    },
+    {
+      "action": "withdrawMinerCapital",
+      "family": "main",
+      "contractKey": "withdrawMinerCapital",
+      "discriminator": 67,
+      "dataLength": 9,
+      "accountShape": "SW,-W,--",
+      "variable": ""
+    },
+    {
+      "action": "setActiveCommit",
+      "family": "main",
+      "contractKey": "setActiveCommit",
+      "discriminator": 68,
+      "dataLength": 9,
+      "accountShape": "SW,-W",
+      "variable": ""
+    },
+    {
+      "action": "commitCycle",
+      "family": "main",
+      "contractKey": "commitCycle",
+      "discriminator": 89,
+      "dataLength": 41,
+      "accountShape": "SW,-W,-W,-W,--",
+      "variable": ""
+    },
+    {
+      "action": "closeCommitPhase",
+      "family": "main",
+      "contractKey": "closeCommitPhase",
+      "discriminator": 90,
+      "dataLength": 9,
+      "accountShape": "S-,-W",
+      "variable": ""
+    },
+    {
+      "action": "sealCycleEntropy",
+      "family": "main",
+      "contractKey": "sealCycleEntropy",
+      "discriminator": 91,
+      "dataLength": 9,
+      "accountShape": "S-,-W,-W,--",
+      "variable": ""
+    },
+    {
+      "action": "releaseUnrevealedCommit",
+      "family": "main",
+      "contractKey": "releaseUnrevealedCommit",
+      "discriminator": 93,
+      "dataLength": 41,
+      "accountShape": "S-,-W,-W,-W,-W,-W",
+      "variable": ""
+    },
+    {
+      "action": "abortEmptyCycle",
+      "family": "main",
+      "contractKey": "abortEmptyCycle",
+      "discriminator": 94,
+      "dataLength": 9,
+      "accountShape": "S-,-W,-W",
+      "variable": ""
+    },
+    {
+      "action": "revealCycle",
+      "family": "main",
+      "contractKey": "revealCycle",
+      "discriminator": 92,
+      "dataLength": 145,
+      "accountShape": "SW,-W,-W,-W,-W,-W,-W,-W,-W,--",
+      "variable": ""
+    },
+    {
+      "action": "settleCyclePage",
+      "family": "main",
+      "contractKey": "settleCyclePage",
+      "discriminator": 63,
+      "dataLength": 25,
+      "accountShape": "SW,--,-W,--,--,-W,-W,-W,--,--,-W,-W",
+      "variable": "minerCycles"
+    },
+    {
+      "action": "finalizeCycleSettlement",
+      "family": "main",
+      "contractKey": "finalizeCycleSettlement",
+      "discriminator": 64,
+      "dataLength": 9,
+      "accountShape": "SW,-W,-W,-W,-W,-W,--,-W,-W",
+      "variable": "registryPages"
+    },
+    {
+      "action": "scoreCyclePage",
+      "family": "main",
+      "contractKey": "scoreCyclePage",
+      "discriminator": 65,
+      "dataLength": 25,
+      "accountShape": "SW,--,--,--,-W,-W,--,-W,-W",
+      "variable": "minerCycles"
+    },
+    {
+      "action": "distributeCyclePage",
+      "family": "main",
+      "contractKey": "distributeCyclePage",
+      "discriminator": 66,
+      "dataLength": 25,
+      "accountShape": "SW,-W,--,-W,--,-W,--,-W,-W,-W",
+      "variable": "minerCyclePairs"
+    },
+    {
+      "action": "claimCycleRewards",
+      "family": "main",
+      "contractKey": "claimCycleRewards",
+      "discriminator": 59,
+      "dataLength": 9,
+      "accountShape": "SW,-W,-W,-W,-W,-W,-W,-W,-W,-W,--,--,--,--,-W",
+      "variable": ""
+    },
+    {
+      "action": "claimCycleRewardsBatch",
+      "family": "main",
+      "contractKey": "claimCycleRewardsBatch",
+      "discriminator": 62,
+      "dataLength": -1,
+      "accountShape": "SW,--,-W,-W,-W,-W,-W,-W",
+      "variable": "claimBatch"
+    },
+    {
+      "action": "claimProtocolTreasury",
+      "family": "main",
+      "contractKey": "claimProtocolTreasury",
+      "discriminator": 77,
+      "dataLength": 1,
+      "accountShape": "SW,--,-W,-W,-W,-W,-W,-W,-W,-W,--,--,--,--",
+      "variable": ""
+    },
+    {
+      "action": "refillRegistryReserveFromTreasury",
+      "family": "main",
+      "contractKey": "refillRegistryReserveFromTreasury",
+      "discriminator": 88,
+      "dataLength": 9,
+      "accountShape": "SW,-W,-W,-W,--",
+      "variable": ""
+    },
+    {
+      "action": "claimProtocolDistributorSat",
+      "family": "main",
+      "contractKey": "claimProtocolDistributorSat",
+      "discriminator": 85,
+      "dataLength": 1,
+      "accountShape": "SW,--,-W,-W,-W,-W,-W,-W,--,--,--,--,--",
+      "variable": ""
+    },
+    {
+      "action": "retargetUnlock",
+      "family": "main",
+      "contractKey": "retargetUnlock",
+      "discriminator": 60,
+      "dataLength": 9,
+      "accountShape": "SW,-W,--,-W",
+      "variable": ""
+    },
+    {
+      "action": "closeResolvedMinerCycleState",
+      "family": "main",
+      "contractKey": "closeResolvedMinerCycleState",
+      "discriminator": 69,
+      "dataLength": 9,
+      "accountShape": "SW,--,-W,-W,-W,-W",
+      "variable": ""
+    },
+    {
+      "action": "closeResolvedCycleRegistryPage",
+      "family": "main",
+      "contractKey": "closeResolvedCycleRegistryPage",
+      "discriminator": 70,
+      "dataLength": 17,
+      "accountShape": "SW,--,-W,-W,-W",
+      "variable": ""
+    },
+    {
+      "action": "closeResolvedCycleArtifacts",
+      "family": "main",
+      "contractKey": "closeResolvedCycleArtifacts",
+      "discriminator": 71,
+      "dataLength": 9,
+      "accountShape": "SW,-W,-W,-W,-W",
+      "variable": ""
+    },
+    {
+      "action": "compactPendingCycleRange",
+      "family": "main",
+      "contractKey": "compactPendingCycleRange",
+      "discriminator": 75,
+      "dataLength": 25,
+      "accountShape": "SW,-W",
+      "variable": "compactCycles"
+    },
+    {
+      "action": "updateBondTierPolicy",
+      "family": "bond",
+      "contractKey": "updateTierPolicy",
+      "discriminator": 1,
+      "dataLength": 65,
+      "accountShape": "SW,-W",
+      "variable": ""
+    },
+    {
+      "action": "openBondPosition",
+      "family": "bond",
+      "contractKey": "openBondPosition",
+      "discriminator": 2,
+      "dataLength": 9,
+      "accountShape": "SW,--,-W,-W,-W,-W,--,--,--",
+      "variable": ""
+    },
+    {
+      "action": "increaseBondPosition",
+      "family": "bond",
+      "contractKey": "increaseBondPosition",
+      "discriminator": 3,
+      "dataLength": 9,
+      "accountShape": "SW,--,-W,-W,-W,-W,--,--,--",
+      "variable": ""
+    },
+    {
+      "action": "requestBondUnlock",
+      "family": "bond",
+      "contractKey": "requestBondUnlock",
+      "discriminator": 4,
+      "dataLength": 1,
+      "accountShape": "SW,--,-W,-W,-W",
+      "variable": ""
+    },
+    {
+      "action": "cancelBondUnlock",
+      "family": "bond",
+      "contractKey": "cancelBondUnlock",
+      "discriminator": 5,
+      "dataLength": 1,
+      "accountShape": "SW,--,-W,-W,-W",
+      "variable": ""
+    },
+    {
+      "action": "finalizeBondUnlock",
+      "family": "bond",
+      "contractKey": "finalizeBondUnlock",
+      "discriminator": 6,
+      "dataLength": 1,
+      "accountShape": "SW,--,-W,-W,-W,-W,-W,-W,--,--,--",
+      "variable": ""
+    },
+    {
+      "action": "syncBondStakingRewards",
+      "family": "bond",
+      "contractKey": "syncStakingRewards",
+      "discriminator": 8,
+      "dataLength": 1,
+      "accountShape": "-W,--,--",
+      "variable": ""
+    },
+    {
+      "action": "syncBondStakingPosition",
+      "family": "bond",
+      "contractKey": "syncStakingPosition",
+      "discriminator": 9,
+      "dataLength": 1,
+      "accountShape": "SW,--,-W,-W,--,--",
+      "variable": ""
+    },
+    {
+      "action": "claimBondStakingRewards",
+      "family": "bond",
+      "contractKey": "claimStakingRewards",
+      "discriminator": 10,
+      "dataLength": 1,
+      "accountShape": "SW,--,-W,-W,--,-W,-W,-W,--,--,--",
+      "variable": ""
+    },
+    {
+      "action": "claimUnallocatedStakingRewards",
+      "family": "bond",
+      "contractKey": "claimUnallocatedStakingRewards",
+      "discriminator": 11,
+      "dataLength": 1,
+      "accountShape": "SW,-W,-W,-W,--,-W,--,--,--",
+      "variable": ""
+    }
+  ]
+}

package/extensions/sat-mining/src/audit-store.ts

@@ -77,6 +77,7 @@ export type SatMiningRecentAction = {
   cycleId?: number | null;
   txHash: string | null;
   status: "success" | "failure";
+  complete?: boolean;
   message?: string | null;
   at: string;
 };
@@ -316,7 +317,7 @@ export type SatPersistedLastKnownStatus = {
 export type SatPersistedChainTime = SatChainTimeState;
 
 type SatRuntimeStoreFile = {
-  version: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10;
+  version: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11;
   recentActions: SatMiningRecentAction[];
   archivedFailures?: SatMiningRecentAction[];
   plannerHistory?: SatPlannerOutcomeMemory[];
@@ -617,6 +618,7 @@ function isValidSatRecentAction(entry: unknown): entry is SatMiningRecentAction
       (typeof candidate.cycleId === "number" && Number.isFinite(candidate.cycleId))) &&
     (candidate.txHash == null || typeof candidate.txHash === "string") &&
     (candidate.status === "success" || candidate.status === "failure") &&
+    (candidate.complete == null || typeof candidate.complete === "boolean") &&
     Number.isFinite(atMs)
   );
 }
@@ -727,8 +729,46 @@ function normalizeSatRoundExecutionState(
   if (!execution || typeof execution !== "object") {
     return null;
   }
+  const commitmentHex =
+    typeof execution.commitmentHex === "string" && /^[0-9a-f]{64}$/i.test(execution.commitmentHex)
+      ? execution.commitmentHex.toLowerCase()
+      : null;
+  const revealNonceBase64 = (() => {
+    if (typeof execution.revealNonceBase64 !== "string") {
+      return null;
+    }
+    try {
+      return Buffer.from(execution.revealNonceBase64, "base64").length === 32
+        ? execution.revealNonceBase64
+        : null;
+    } catch {
+      return null;
+    }
+  })();
+  const allocationFp =
+    Array.isArray(execution.allocationFp) &&
+    execution.allocationFp.length === 25 &&
+    execution.allocationFp.every(
+      (value) => Number.isSafeInteger(value) && value >= 0 && value <= 0xffff_ffff,
+    ) &&
+    execution.allocationFp.reduce((sum, value) => sum + value, 0) === 1_000_000
+      ? [...execution.allocationFp]
+      : null;
+  const commitLamports =
+    typeof execution.commitLamports === "number" &&
+    Number.isSafeInteger(execution.commitLamports) &&
+    execution.commitLamports > 0
+      ? execution.commitLamports
+      : null;
   return {
     openRoundSubmitted: execution.openRoundSubmitted === true,
+    commitSubmitted: execution.commitSubmitted === true,
+    commitmentHex,
+    revealNonceBase64,
+    allocationFp,
+    commitLamports,
+    entropyTargetPinned: execution.entropyTargetPinned === true,
+    entropySealed: execution.entropySealed === true,
     participationSubmitted: execution.participationSubmitted === true,
     epochFinalized: execution.epochFinalized === true,
     crankSubmitted: execution.crankSubmitted === true,
@@ -752,7 +792,10 @@ function trimSatRoundExecution(
     if (!parsedRoundKey || !execution) {
       continue;
     }
-    if (!execution.participationSubmitted || execution.claimSubmitted) {
+    if (
+      (!execution.commitSubmitted && !execution.participationSubmitted) ||
+      execution.claimSubmitted
+    ) {
       continue;
     }
     deduped.set(entry.roundKey, {
@@ -930,7 +973,7 @@ async function persistSatRuntimeSummary(
   summary: SatRuntimeSummary,
 ): Promise<void> {
   const payload: SatRuntimeStoreFile = {
-    version: 10,
+    version: 11,
     recentActions: summary.recentActions,
     archivedFailures: [],
     plannerHistory: summary.plannerHistory,
@@ -1051,7 +1094,8 @@ export async function readSatRecentActions(filePath: string): Promise<SatMiningR
         parsed.version !== 7 &&
         parsed.version !== 8 &&
         parsed.version !== 9 &&
-        parsed.version !== 10) ||
+        parsed.version !== 10 &&
+        parsed.version !== 11) ||
       !Array.isArray(parsed.recentActions)
     ) {
       return [];
@@ -1076,7 +1120,8 @@ export async function readSatRuntimeSummary(filePath: string): Promise<SatRuntim
         parsed.version !== 7 &&
         parsed.version !== 8 &&
         parsed.version !== 9 &&
-        parsed.version !== 10) ||
+        parsed.version !== 10 &&
+        parsed.version !== 11) ||
       !Array.isArray(parsed.recentActions)
     ) {
       return emptySatRuntimeSummary();

package/extensions/sat-mining/src/claim-service.ts

@@ -51,6 +51,41 @@ const SAT_CLAIM_IDLE_INTERVAL_MS = 60_000;
 const SAT_CLAIM_ACTIVE_INTERVAL_MS = 15_000;
 const SAT_CLAIM_PENDING_WAIT_INTERVAL_MS = 45_000;
 const SAT_TOKEN_DECIMALS = 11;
+
+type SatClaimGatewayResult = {
+  ok?: boolean;
+  payload?: {
+    resolvedCycleIds?: number[];
+    pendingCycleIds?: number[];
+  };
+};
+
+function resolveClaimGatewayCompletion(
+  result: SatClaimGatewayResult,
+  requestedCycleIds: readonly number[],
+): { resolvedCycleIds: number[]; pendingCycleIds: number[] } {
+  const requested = new Set(requestedCycleIds);
+  const hasExplicitCompletion =
+    Array.isArray(result.payload?.resolvedCycleIds) ||
+    Array.isArray(result.payload?.pendingCycleIds);
+  if (!hasExplicitCompletion) {
+    return { resolvedCycleIds: [...requested], pendingCycleIds: [] };
+  }
+  const resolvedCycleIds = [
+    ...new Set(
+      (result.payload?.resolvedCycleIds ?? []).filter((cycleId) => requested.has(cycleId)),
+    ),
+  ];
+  const resolved = new Set(resolvedCycleIds);
+  const explicitPending = new Set(
+    (result.payload?.pendingCycleIds ?? []).filter((cycleId) => requested.has(cycleId)),
+  );
+  const pendingCycleIds = [...requested].filter(
+    (cycleId) => !resolved.has(cycleId) || explicitPending.has(cycleId),
+  );
+  return { resolvedCycleIds, pendingCycleIds };
+}
+
 function resolveClaimNextDelayMs(hasPendingWork: boolean): number {
   return hasPendingWork ? SAT_CLAIM_PENDING_WAIT_INTERVAL_MS : SAT_CLAIM_IDLE_INTERVAL_MS;
 }
@@ -99,9 +134,7 @@ function resolveWalletEnvValue(
 function resolveAutoSweepRpcUrl(walletId: string, env: NodeJS.ProcessEnv): string | undefined {
   return (
     resolveWalletEnvValue(env, "FASED_WALLET_SOLANA_READ_RPC_URL", walletId) ||
-    resolveWalletEnvValue(env, "FASED_WALLET_SOLANA_RPC_URL", walletId) ||
-    resolveWalletEnvValue(env, "FASED_WALLET_EMBEDDED_KEYSTORE_READ_RPC_URL", walletId) ||
-    resolveWalletEnvValue(env, "FASED_WALLET_EMBEDDED_KEYSTORE_RPC_URL", walletId)
+    resolveWalletEnvValue(env, "FASED_WALLET_SOLANA_RPC_URL", walletId)
   );
 }
 
@@ -238,6 +271,7 @@ function resolveAutoSweepDestination(params: {
 async function maybeAutoSweepClaimedSat(params: {
   api: FasedAgentPluginApi;
   state: SatMiningRuntimeState;
+  occurrenceId: string;
 }): Promise<void> {
   const sweep = params.state.activeConfig.automation?.satSweep;
   if (!sweep?.enabled) {
@@ -325,7 +359,24 @@ async function maybeAutoSweepClaimedSat(params: {
       walletId,
       walletName: resolveAutoSweepSourceWalletName(walletId, process.env),
     },
-    requestedBy: "sat-mining",
+    requestedBy: "sat-mining:auto-sweep",
+    executionIntentId: `sat-auto-sweep:${walletId}:${params.occurrenceId}`,
+    satSweepAuthorization: {
+      kind: "sat-auto-sweep-v1",
+      occurrenceId: params.occurrenceId,
+      walletId,
+      destination: destination.to,
+      mint: satMintAddress,
+      sourceBalanceRaw: recipientBalanceRaw.toString(),
+      amountRaw: sweepRaw.toString(),
+      keepRaw: keepRaw.toString(),
+      minRaw: minRaw.toString(),
+      mode: sweep.mode === "percentage" ? "percentage" : "all",
+      percentage:
+        typeof sweep.percentage === "number" && Number.isFinite(sweep.percentage)
+          ? Math.max(0, Math.min(100, sweep.percentage))
+          : 100,
+    },
     config: effectiveWalletConfig,
     runtimeConfig: cfg,
     sendPath: "automation",
@@ -520,11 +571,11 @@ async function collectResolvedInvalidOwnerClaimCycles(params: {
       resolved.push(cycleId);
       continue;
     }
-    const claimedSat = BigInt(minerCycle.claimedSatRaw ?? "0");
-    const claimedRebate =
-      BigInt(minerCycle.claimedDetRebateLamports ?? "0") +
-      BigInt(minerCycle.claimedPerfRebateLamports ?? "0");
-    if (minerCycle.capitalLockReleased && (claimedSat > 0n || claimedRebate > 0n)) {
+    const claimableSat = BigInt(minerCycle.claimableSatRaw ?? "0");
+    const claimableRebate =
+      BigInt(minerCycle.claimableDetRebateLamports ?? "0") +
+      BigInt(minerCycle.claimablePerfRebateLamports ?? "0");
+    if (minerCycle.capitalLockReleased && claimableSat === 0n && claimableRebate === 0n) {
       resolved.push(cycleId);
     }
   }
@@ -766,18 +817,38 @@ export function createSatClaimService(params: {
         return;
       }
       markSatClaimBacklogClaiming(state, readyCycleIds);
-      await runSatGatewayMethod({
+      const result = await runSatGatewayMethod<SatClaimGatewayResult>({
         api,
         method: "sat.claimCycleRewardsBatch",
         payload: { cycleIds: readyCycleIds },
       });
-      for (const cycleId of readyCycleIds) {
+      const completion = resolveClaimGatewayCompletion(result, readyCycleIds);
+      for (const cycleId of completion.resolvedCycleIds) {
         const execution = getOrCreateRoundExecutionState(state, cycleId, 0);
         execution.claimSubmitted = true;
       }
-      markSatClaimBacklogClaimed(state, readyCycleIds);
-      await maybeAutoSweepClaimedSat({ api, state });
-      markWorkerSuccess(state, "claim", `cycles ${readyCycleIds.join(",")} claimed`);
+      for (const cycleId of completion.pendingCycleIds) {
+        const execution = getOrCreateRoundExecutionState(state, cycleId, 0);
+        execution.claimSubmitted = false;
+      }
+      markSatClaimBacklogClaimed(state, completion.resolvedCycleIds);
+      markSatClaimBacklogReady(
+        state,
+        completion.pendingCycleIds,
+        "bounded SAT claim chunk submitted; rewards remain claimable",
+      );
+      await maybeAutoSweepClaimedSat({
+        api,
+        state,
+        occurrenceId: [...readyCycleIds].toSorted((left, right) => left - right).join(","),
+      });
+      markWorkerSuccess(
+        state,
+        "claim",
+        completion.pendingCycleIds.length > 0
+          ? `claim chunk confirmed; cycles ${completion.pendingCycleIds.join(",")} still have rewards`
+          : `cycles ${completion.resolvedCycleIds.join(",")} claimed`,
+      );
       scheduleWorkerNextRun(state, "claim", SAT_CLAIM_ACTIVE_INTERVAL_MS);
     } catch (error) {
       if (isSatServiceReadTimeoutError(error)) {

package/extensions/sat-mining/src/config.ts

@@ -25,6 +25,7 @@ export type SatMiningConfig = {
     | "safe_fallback";
   strategyExecution?: "deterministic" | "auto";
   strategyMode?: "base" | "skill";
+  cycleCadence?: 1 | 2 | 6 | 12;
   commitLamports?: number;
   minSolBalanceLamports?: number;
   walletId?: string;
@@ -103,6 +104,9 @@ export const satMiningConfigJsonSchema = Type.Object(
       Type.Union([Type.Literal("deterministic"), Type.Literal("auto")]),
     ),
     strategyMode: Type.Optional(Type.Union([Type.Literal("base"), Type.Literal("skill")])),
+    cycleCadence: Type.Optional(
+      Type.Union([Type.Literal(1), Type.Literal(2), Type.Literal(6), Type.Literal(12)]),
+    ),
     commitLamports: Type.Optional(Type.Number()),
     minSolBalanceLamports: Type.Optional(Type.Number()),
     walletId: Type.Optional(Type.String()),
@@ -326,6 +330,10 @@ export function parseSatMiningConfig(value: unknown): SatMiningConfig {
       : raw.strategyMode === "skill"
         ? "skill"
         : "base";
+  const cycleCadence =
+    raw.cycleCadence === 2 || raw.cycleCadence === 6 || raw.cycleCadence === 12
+      ? raw.cycleCadence
+      : 1;
   const commitLamports =
     typeof raw.commitLamports === "number" &&
     Number.isFinite(raw.commitLamports) &&
@@ -486,6 +494,7 @@ export function parseSatMiningConfig(value: unknown): SatMiningConfig {
     strategyPreset: strategyPreset ?? riskModeToStrategyPreset(riskMode),
     strategyExecution: strategyExecution ?? strategyModeToExecution(strategyMode),
     strategyMode,
+    cycleCadence,
     commitLamports,
     minSolBalanceLamports,
     walletId,