@fased/fased 0.1.62 → 0.1.65

package/extensions/sat-mining/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fased/sat-mining",
-  "version": "0.1.62",
+  "version": "0.1.65",
   "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;
 };
@@ -293,6 +294,11 @@ export type SatPersistedSettlementPageParticipants = {
   participants: string[];
 };
 
+export type SatPersistedSettlementPageLookupTable = {
+  cacheKey: string;
+  lookupTableAddress: string;
+};
+
 export type SatPersistedLastKnownStatus = {
   walletId: string | null;
   currentSolBalanceLamports: string | null;
@@ -316,7 +322,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 | 12;
   recentActions: SatMiningRecentAction[];
   archivedFailures?: SatMiningRecentAction[];
   plannerHistory?: SatPlannerOutcomeMemory[];
@@ -325,6 +331,7 @@ type SatRuntimeStoreFile = {
   roundExecution?: SatPersistedRoundExecution[];
   claimBacklog?: SatClaimBacklogEntry[];
   settlementPageParticipants?: SatPersistedSettlementPageParticipants[];
+  settlementPageLookupTables?: SatPersistedSettlementPageLookupTable[];
   workers?: Partial<Record<SatMiningWorkerName, SatMiningWorkerState>>;
   lastKnownStatus?: SatPersistedLastKnownStatus | null;
   chainTime?: SatPersistedChainTime | null;
@@ -346,6 +353,7 @@ type SatRuntimeSummary = {
   roundExecution: SatPersistedRoundExecution[];
   claimBacklog: SatClaimBacklogEntry[];
   settlementPageParticipants: SatPersistedSettlementPageParticipants[];
+  settlementPageLookupTables: SatPersistedSettlementPageLookupTable[];
   workers: Partial<Record<SatMiningWorkerName, SatMiningWorkerState>>;
   lastKnownStatus: SatPersistedLastKnownStatus | null;
   chainTime: SatPersistedChainTime | null;
@@ -617,6 +625,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 +736,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 +799,10 @@ function trimSatRoundExecution(
     if (!parsedRoundKey || !execution) {
       continue;
     }
-    if (!execution.participationSubmitted || execution.claimSubmitted) {
+    if (
+      (!execution.commitSubmitted && !execution.participationSubmitted) ||
+      execution.claimSubmitted
+    ) {
       continue;
     }
     deduped.set(entry.roundKey, {
@@ -870,6 +920,25 @@ function trimSettlementPageParticipants(
   return [...deduped.values()].slice(0, SAT_SETTLEMENT_PAGE_PARTICIPANT_CACHE_LIMIT);
 }
 
+function trimSettlementPageLookupTables(
+  entries: readonly SatPersistedSettlementPageLookupTable[] | null | undefined,
+): SatPersistedSettlementPageLookupTable[] {
+  if (!Array.isArray(entries) || SAT_SETTLEMENT_PAGE_PARTICIPANT_CACHE_LIMIT <= 0) {
+    return [];
+  }
+  const deduped = new Map<string, SatPersistedSettlementPageLookupTable>();
+  for (const entry of entries) {
+    const cacheKey = typeof entry?.cacheKey === "string" ? entry.cacheKey.trim() : "";
+    const lookupTableAddress =
+      typeof entry?.lookupTableAddress === "string" ? entry.lookupTableAddress.trim() : "";
+    if (!cacheKey || !lookupTableAddress) {
+      continue;
+    }
+    deduped.set(cacheKey, { cacheKey, lookupTableAddress });
+  }
+  return [...deduped.values()].slice(0, SAT_SETTLEMENT_PAGE_PARTICIPANT_CACHE_LIMIT);
+}
+
 function emptySatRuntimeSummary(): SatRuntimeSummary {
   return {
     recentActions: [],
@@ -880,6 +949,7 @@ function emptySatRuntimeSummary(): SatRuntimeSummary {
     roundExecution: [],
     claimBacklog: [],
     settlementPageParticipants: [],
+    settlementPageLookupTables: [],
     workers: normalizeSatWorkers(undefined),
     lastKnownStatus: null,
     chainTime: null,
@@ -907,6 +977,7 @@ function normalizeSatRuntimeSummary(parsed: Partial<SatRuntimeStoreFile>): SatRu
     roundExecution: trimSatRoundExecution(parsed.roundExecution),
     claimBacklog: trimSatClaimBacklog(parsed.claimBacklog),
     settlementPageParticipants: trimSettlementPageParticipants(parsed.settlementPageParticipants),
+    settlementPageLookupTables: trimSettlementPageLookupTables(parsed.settlementPageLookupTables),
     workers: normalizeSatWorkers(parsed.workers),
     lastKnownStatus: normalizeSatLastKnownStatus(parsed.lastKnownStatus),
     chainTime: normalizeSatChainTime(parsed.chainTime),
@@ -930,7 +1001,7 @@ async function persistSatRuntimeSummary(
   summary: SatRuntimeSummary,
 ): Promise<void> {
   const payload: SatRuntimeStoreFile = {
-    version: 10,
+    version: 12,
     recentActions: summary.recentActions,
     archivedFailures: [],
     plannerHistory: summary.plannerHistory,
@@ -939,6 +1010,7 @@ async function persistSatRuntimeSummary(
     roundExecution: summary.roundExecution,
     claimBacklog: summary.claimBacklog,
     settlementPageParticipants: summary.settlementPageParticipants,
+    settlementPageLookupTables: summary.settlementPageLookupTables,
     workers: normalizeSatWorkers(summary.workers),
     lastKnownStatus: normalizeSatLastKnownStatus(summary.lastKnownStatus),
     chainTime: normalizeSatChainTime(summary.chainTime),
@@ -1051,7 +1123,9 @@ 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 &&
+        parsed.version !== 12) ||
       !Array.isArray(parsed.recentActions)
     ) {
       return [];
@@ -1076,7 +1150,9 @@ 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 &&
+        parsed.version !== 12) ||
       !Array.isArray(parsed.recentActions)
     ) {
       return emptySatRuntimeSummary();
@@ -1111,6 +1187,12 @@ export async function readSatRuntimeSummary(filePath: string): Promise<SatRuntim
       (Array.isArray(parsed.settlementPageParticipants)
         ? parsed.settlementPageParticipants.length
         : 0);
+    const hadSettlementPageLookupTables = Array.isArray(parsed.settlementPageLookupTables);
+    const hadStaleSettlementPageLookupTables =
+      normalized.settlementPageLookupTables.length !==
+      (Array.isArray(parsed.settlementPageLookupTables)
+        ? parsed.settlementPageLookupTables.length
+        : 0);
     const hadWorkers =
       parsed.workers != null &&
       typeof parsed.workers === "object" &&
@@ -1132,6 +1214,8 @@ export async function readSatRuntimeSummary(filePath: string): Promise<SatRuntim
       hadStaleClaimBacklog ||
       !hadSettlementPageParticipants ||
       hadStaleSettlementPageParticipants ||
+      !hadSettlementPageLookupTables ||
+      hadStaleSettlementPageLookupTables ||
       !hadWorkers ||
       !hadLastKnownStatus ||
       !hadChainTime
@@ -1427,6 +1511,7 @@ export async function writeSatRecentActions(
     roundExecution?: readonly SatPersistedRoundExecution[];
     claimBacklog?: readonly SatClaimBacklogEntry[];
     settlementPageParticipants?: readonly SatPersistedSettlementPageParticipants[];
+    settlementPageLookupTables?: readonly SatPersistedSettlementPageLookupTable[];
     workers?: Partial<Record<SatMiningWorkerName, SatMiningWorkerState>>;
     lastKnownStatus?: SatPersistedLastKnownStatus | null;
     chainTime?: SatPersistedChainTime | null;
@@ -1452,6 +1537,7 @@ export async function writeSatRecentActions(
     roundExecution: trimSatRoundExecution(summary?.roundExecution),
     claimBacklog: trimSatClaimBacklog(summary?.claimBacklog),
     settlementPageParticipants: trimSettlementPageParticipants(summary?.settlementPageParticipants),
+    settlementPageLookupTables: trimSettlementPageLookupTables(summary?.settlementPageLookupTables),
     workers: normalizeSatWorkers(summary?.workers),
     lastKnownStatus: normalizeSatLastKnownStatus(summary?.lastKnownStatus),
     chainTime: normalizeSatChainTime(summary?.chainTime),