@gzeoneth/gov-tracker 0.1.1-1 → 0.1.1

package/dist/utils/salt-resolver.js

@@ -1,144 +0,0 @@
-"use strict";
-/**
- * Salt Resolution for Timelock Execution
- *
- * Salt resolution hierarchy:
- * 1. options.salt (explicit override)
- * 2. stage.data.salt (cached from tracking)
- * 3. Security Council: generateSalt(members, nonce)
- * 4. Governor: keccak256(description)
- * 5. HashZero (0x00...00) - last resort for operations that use default salt
- * 6. FAIL - throw error if no salt matches the operation ID
- *
- * Each resolved salt is validated against the expected operation ID before use.
- * If validation fails, the next option in the hierarchy is tried.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SaltResolutionError = exports.saltForSecurityCouncil = exports.saltFromDescription = void 0;
-exports.getSaltCandidates = getSaltCandidates;
-exports.resolveExecuteOptionsForStage = resolveExecuteOptionsForStage;
-const ethers_1 = require("ethers");
-const types_1 = require("../types");
-const operation_id_1 = require("../utils/operation-id");
-Object.defineProperty(exports, "saltFromDescription", { enumerable: true, get: function () { return operation_id_1.saltFromDescription; } });
-Object.defineProperty(exports, "saltForSecurityCouncil", { enumerable: true, get: function () { return operation_id_1.saltForSecurityCouncil; } });
-const security_council_1 = require("../discovery/security-council");
-/**
- * Get all candidate salts from a TrackedStage in priority order.
- *
- * Returns an array of salt candidates to try, in order of priority.
- * The caller is responsible for validating each salt against the operation ID.
- *
- * @param stage - The stage being prepared (L2_TIMELOCK or L1_TIMELOCK)
- * @param options - Preparation options (can include explicit salt override)
- * @param provider - Provider for on-chain salt generation
- * @param allStages - All tracked stages (used to extract context from other stages)
- */
-async function getSaltCandidates(stage, options = {}, provider, allStages) {
-    const candidates = [];
-    // 1. Explicit user override (highest priority)
-    if (options.salt) {
-        candidates.push({ salt: options.salt, source: "explicit" });
-    }
-    // Try to get typed stage data from any timelock stage type
-    const stageData = (0, types_1.getStageData)(stage, "L2_TIMELOCK") ?? (0, types_1.getStageData)(stage, "L1_TIMELOCK");
-    // 2. Cached salt from tracking
-    if (stageData?.salt) {
-        candidates.push({ salt: stageData.salt, source: "cached" });
-    }
-    // 3. Decoded salt from L2→L1 message (L1 timelock scheduling call)
-    // This is the actual salt that was sent to L1 - 100% accurate!
-    // This was decoded during L2_TO_L1_MESSAGE tracking and stored in stage data
-    if (allStages && stage.type === "L1_TIMELOCK") {
-        const l2ToL1Stage = allStages.find((s) => s.type === "L2_TO_L1_MESSAGE");
-        if (l2ToL1Stage) {
-            const l2ToL1Data = (0, types_1.getStageData)(l2ToL1Stage, "L2_TO_L1_MESSAGE");
-            if (l2ToL1Data?.l1TimelockSalt) {
-                candidates.push({ salt: l2ToL1Data.l1TimelockSalt, source: "cached" });
-                // Also use the decoded predecessor if available and not overridden
-                if (!options.predecessor && l2ToL1Data.l1TimelockPredecessor) {
-                    options.predecessor = l2ToL1Data.l1TimelockPredecessor;
-                }
-            }
-        }
-    }
-    // 4. Security Council: use on-chain generation
-    // Security Council data is enriched in L2_TIMELOCK stage during tracking
-    const members = stageData?.securityCouncilMembers;
-    const nonce = stageData?.securityCouncilNonce;
-    if (members?.length && nonce !== undefined) {
-        const nonceValue = ethers_1.BigNumber.isBigNumber(nonce) ? nonce : ethers_1.BigNumber.from(nonce);
-        try {
-            const scSalt = provider
-                ? await (0, security_council_1.generateSecurityCouncilSalt)(members, nonceValue, provider)
-                : (0, operation_id_1.saltForSecurityCouncil)(members, nonceValue);
-            candidates.push({ salt: scSalt, source: "security-council" });
-        }
-        catch {
-            // Skip if security council salt generation fails
-        }
-    }
-    // 5. Derive from proposal description
-    // Description is stored in PROPOSAL_CREATED stage, extract it if allStages provided
-    let description;
-    if (allStages) {
-        const proposalStage = allStages.find((s) => s.type === "PROPOSAL_CREATED");
-        if (proposalStage) {
-            const proposalData = (0, types_1.getStageData)(proposalStage, "PROPOSAL_CREATED");
-            description = proposalData?.description;
-        }
-    }
-    // Fallback to options or stage data (for backward compatibility)
-    description = description ?? options.description ?? stageData?.description;
-    if (description) {
-        candidates.push({ salt: (0, operation_id_1.saltFromDescription)(description), source: "description" });
-    }
-    // 6. HashZero as last resort
-    candidates.push({ salt: ethers_1.ethers.constants.HashZero, source: "hash-zero" });
-    return candidates;
-}
-/**
- * Error thrown when salt cannot be resolved from available sources.
- * This prevents silent failures that would cause mysterious on-chain errors.
- */
-class SaltResolutionError extends Error {
-    constructor(message, attemptedSources, stageType) {
-        super(message);
-        this.attemptedSources = attemptedSources;
-        this.stageType = stageType;
-        this.name = "SaltResolutionError";
-    }
-}
-exports.SaltResolutionError = SaltResolutionError;
-/**
- * Get prepare options with resolved salt for a stage.
- *
- * IMPORTANT: Throws SaltResolutionError if salt cannot be resolved from any source.
- *
- * @param stage - The stage being prepared
- * @param options - Preparation options
- * @param provider - Provider for on-chain operations
- * @param allStages - All tracked stages (used to extract context)
- * @throws {SaltResolutionError} if no salt can be resolved
- */
-async function resolveExecuteOptionsForStage(stage, options = {}, provider, allStages) {
-    const candidates = await getSaltCandidates(stage, options, provider, allStages);
-    // If only HashZero is available, it means no actual salt source was found
-    // This should be an error because we don't know the correct salt
-    const hasActualSaltSource = candidates.some((c) => c.source !== "hash-zero");
-    if (!hasActualSaltSource) {
-        const attemptedSources = candidates.map((c) => c.source);
-        throw new SaltResolutionError(`Cannot resolve salt for stage ${stage.type}. ` +
-            `Attempted sources: ${attemptedSources.length > 0 ? attemptedSources.join(", ") : "none available"}. ` +
-            `Provide an explicit salt via options.salt or ensure stage.data contains the required salt source ` +
-            `(description for governor proposals, securityCouncilMembers+nonce for SC updates).`, attemptedSources, stage.type);
-    }
-    const resolvedSalt = candidates[0]?.salt ?? ethers_1.ethers.constants.HashZero;
-    return {
-        ...options,
-        salt: resolvedSalt,
-        predecessor: options.predecessor ?? ethers_1.ethers.constants.HashZero,
-        skipSaltValidation: options.skipSaltValidation ?? false,
-    };
-}
-//# sourceMappingURL=salt-resolver.js.map

package/dist/utils/salt-resolver.js.map

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