@gzeoneth/gov-tracker 0.2.1 → 0.3.0-beta.3e02aff

package/dist/election/params.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildExecuteTransaction = buildExecuteTransaction;
+exports.getElectionProposalParams = getElectionProposalParams;
+exports.getMemberElectionProposalParams = getMemberElectionProposalParams;
+const constants_1 = require("../constants");
+const rpc_utils_1 = require("../utils/rpc-utils");
+const abis_1 = require("../abis");
+const salt_computation_1 = require("../utils/salt-computation");
+const logger_1 = require("../utils/logger");
+const contracts_1 = require("./contracts");
+const proposal_ids_1 = require("./proposal-ids");
+const log = logger_1.loggers.election;
+async function findProposalCreatedParams(proposalId, governorAddress, governor, provider) {
+    const topic = abis_1.proposalCreatedInterface.getEventTopic("ProposalCreated");
+    let startBlock;
+    try {
+        const snapshot = await (0, rpc_utils_1.queryWithRetry)(() => governor.proposalSnapshot(proposalId));
+        startBlock = Math.max(0, snapshot.toNumber() - 1000);
+    }
+    catch {
+        const currentBlock = await (0, rpc_utils_1.queryWithRetry)(() => provider.getBlockNumber());
+        startBlock = Math.max(0, currentBlock - 10000);
+    }
+    const currentBlock = await (0, rpc_utils_1.queryWithRetry)(() => provider.getBlockNumber());
+    const logs = await (0, rpc_utils_1.queryWithRetry)(() => provider.getLogs({
+        address: governorAddress,
+        topics: [topic],
+        fromBlock: startBlock,
+        toBlock: currentBlock,
+    }));
+    for (const eventLog of logs) {
+        try {
+            const parsed = abis_1.proposalCreatedInterface.parseLog(eventLog);
+            const args = parsed.args;
+            if (args.proposalId.toString() === proposalId) {
+                log("Found ProposalCreated event for proposal %s", proposalId);
+                return {
+                    targets: args.targets,
+                    values: args.values,
+                    calldatas: args.calldatas,
+                    description: args.description,
+                    descriptionHash: (0, salt_computation_1.saltFromDescription)(args.description),
+                };
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    log("ProposalCreated event not found for proposal %s", proposalId);
+    return null;
+}
+function buildExecuteTransaction(params, governorAddress, description) {
+    const calldata = abis_1.governorInterface.encodeFunctionData("execute", [
+        params.targets,
+        params.values,
+        params.calldatas,
+        params.descriptionHash,
+    ]);
+    return {
+        to: governorAddress,
+        data: calldata,
+        value: "0",
+        chain: "arb1",
+        chainId: 42161,
+        description,
+    };
+}
+async function getElectionProposalParams(electionIndex, provider, nomineeGovernorAddress = constants_1.ADDRESSES.ELECTION_NOMINEE_GOVERNOR) {
+    log("getElectionProposalParams for index %d", electionIndex);
+    const proposalId = await (0, proposal_ids_1.getElectionProposalId)(electionIndex, provider, nomineeGovernorAddress);
+    if (!proposalId) {
+        log("No proposal ID found for election %d", electionIndex);
+        return null;
+    }
+    const governor = (0, contracts_1.getNomineeGovernor)(nomineeGovernorAddress, provider);
+    return findProposalCreatedParams(proposalId, nomineeGovernorAddress, governor, provider);
+}
+async function getMemberElectionProposalParams(electionIndex, provider, memberGovernorAddress = constants_1.ADDRESSES.ELECTION_MEMBER_GOVERNOR) {
+    log("getMemberElectionProposalParams for index %d", electionIndex);
+    const memberGovernor = (0, contracts_1.getMemberGovernor)(memberGovernorAddress, provider);
+    const memberProposalId = await (0, proposal_ids_1.computeElectionProposalId)(electionIndex, memberGovernor);
+    try {
+        await (0, rpc_utils_1.queryWithRetry)(() => memberGovernor.state(memberProposalId));
+    }
+    catch {
+        log("No member proposal found for election %d", electionIndex);
+        return null;
+    }
+    return findProposalCreatedParams(memberProposalId, memberGovernorAddress, memberGovernor, provider);
+}
+//# sourceMappingURL=params.js.map

package/dist/election/params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.js","sourceRoot":"","sources":["../../src/election/params.ts"],"names":[],"mappings":";;AAuEA,0DAoBC;AAED,8DAeC;AAED,0EAuBC;AApID,4CAAyC;AACzC,kDAAoD;AACpD,kCAAsE;AACtE,gEAAgE;AAChE,4CAA0C;AAE1C,2CAAoE;AACpE,iDAAkF;AAElF,MAAM,GAAG,GAAG,gBAAO,CAAC,QAAQ,CAAC;AAU7B,KAAK,UAAU,yBAAyB,CACtC,UAAkB,EAClB,eAAuB,EACvB,QAAyB,EACzB,QAAmC;IAEnC,MAAM,KAAK,GAAG,+BAAwB,CAAC,aAAa,CAAC,iBAAiB,CAAC,CAAC;IAExE,IAAI,UAAkB,CAAC;IACvB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,IAAA,0BAAc,EAAY,GAAG,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAAC;QAC9F,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,YAAY,GAAG,MAAM,IAAA,0BAAc,EAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC,CAAC;QAC3E,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,GAAG,KAAK,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,YAAY,GAAG,MAAM,IAAA,0BAAc,EAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC,CAAC;IAE3E,MAAM,IAAI,GAAG,MAAM,IAAA,0BAAc,EAAC,GAAG,EAAE,CACrC,QAAQ,CAAC,OAAO,CAAC;QACf,OAAO,EAAE,eAAe;QACxB,MAAM,EAAE,CAAC,KAAK,CAAC;QACf,SAAS,EAAE,UAAU;QACrB,OAAO,EAAE,YAAY;KACtB,CAAC,CACH,CAAC;IAEF,KAAK,MAAM,QAAQ,IAAI,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,+BAAwB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAC3D,MAAM,IAAI,GAAG,MAAM,CAAC,IAA2C,CAAC;YAChE,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,KAAK,UAAU,EAAE,CAAC;gBAC9C,GAAG,CAAC,6CAA6C,EAAE,UAAU,CAAC,CAAC;gBAC/D,OAAO;oBACL,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,SAAS,EAAE,IAAI,CAAC,SAAS;oBACzB,WAAW,EAAE,IAAI,CAAC,WAAW;oBAC7B,eAAe,EAAE,IAAA,sCAAmB,EAAC,IAAI,CAAC,WAAW,CAAC;iBACvD,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;IAED,GAAG,CAAC,iDAAiD,EAAE,UAAU,CAAC,CAAC;IACnE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAgB,uBAAuB,CACrC,MAA8B,EAC9B,eAAuB,EACvB,WAAmB;IAEnB,MAAM,QAAQ,GAAG,wBAAiB,CAAC,kBAAkB,CAAC,SAAS,EAAE;QAC/D,MAAM,CAAC,OAAO;QACd,MAAM,CAAC,MAAM;QACb,MAAM,CAAC,SAAS;QAChB,MAAM,CAAC,eAAe;KACvB,CAAC,CAAC;IAEH,OAAO;QACL,EAAE,EAAE,eAAe;QACnB,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,GAAG;QACV,KAAK,EAAE,MAAM;QACb,OAAO,EAAE,KAAK;QACd,WAAW;KACZ,CAAC;AACJ,CAAC;AAEM,KAAK,UAAU,yBAAyB,CAC7C,aAAqB,EACrB,QAAmC,EACnC,yBAAiC,qBAAS,CAAC,yBAAyB;IAEpE,GAAG,CAAC,wCAAwC,EAAE,aAAa,CAAC,CAAC;IAE7D,MAAM,UAAU,GAAG,MAAM,IAAA,oCAAqB,EAAC,aAAa,EAAE,QAAQ,EAAE,sBAAsB,CAAC,CAAC;IAChG,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,GAAG,CAAC,sCAAsC,EAAE,aAAa,CAAC,CAAC;QAC3D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,IAAA,8BAAkB,EAAC,sBAAsB,EAAE,QAAQ,CAAC,CAAC;IACtE,OAAO,yBAAyB,CAAC,UAAU,EAAE,sBAAsB,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAC3F,CAAC;AAEM,KAAK,UAAU,+BAA+B,CACnD,aAAqB,EACrB,QAAmC,EACnC,wBAAgC,qBAAS,CAAC,wBAAwB;IAElE,GAAG,CAAC,8CAA8C,EAAE,aAAa,CAAC,CAAC;IAEnE,MAAM,cAAc,GAAG,IAAA,6BAAiB,EAAC,qBAAqB,EAAE,QAAQ,CAAC,CAAC;IAC1E,MAAM,gBAAgB,GAAG,MAAM,IAAA,wCAAyB,EAAC,aAAa,EAAE,cAAc,CAAC,CAAC;IAExF,IAAI,CAAC;QACH,MAAM,IAAA,0BAAc,EAAS,GAAG,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAC7E,CAAC;IAAC,MAAM,CAAC;QACP,GAAG,CAAC,0CAA0C,EAAE,aAAa,CAAC,CAAC;QAC/D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,yBAAyB,CAC9B,gBAAgB,EAChB,qBAAqB,EACrB,cAAc,EACd,QAAQ,CACT,CAAC;AACJ,CAAC"}

package/dist/election/participants.d.ts

@@ -0,0 +1,6 @@
+import { ethers } from "ethers";
+import { ElectionContender, ElectionNominee } from "../types";
+export declare function getContenders(proposalId: string, provider: ethers.providers.Provider, nomineeGovernorAddress?: string): Promise<ElectionContender[]>;
+export declare function getNomineesWithVotes(proposalId: string, provider: ethers.providers.Provider, nomineeGovernorAddress?: string): Promise<ElectionNominee[]>;
+export declare function getExcludedNominees(proposalId: string, provider: ethers.providers.Provider, nomineeGovernorAddress?: string): Promise<ElectionNominee[]>;
+//# sourceMappingURL=participants.d.ts.map

package/dist/election/participants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"participants.d.ts","sourceRoot":"","sources":["../../src/election/participants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAa,MAAM,QAAQ,CAAC;AAK3C,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAM9D,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,EACnC,sBAAsB,GAAE,MAA4C,GACnE,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAoC9B;AAED,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,EACnC,sBAAsB,GAAE,MAA4C,GACnE,OAAO,CAAC,eAAe,EAAE,CAAC,CAmC5B;AAED,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,EACnC,sBAAsB,GAAE,MAA4C,GACnE,OAAO,CAAC,eAAe,EAAE,CAAC,CAqD5B"}

package/dist/election/participants.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getContenders = getContenders;
+exports.getNomineesWithVotes = getNomineesWithVotes;
+exports.getExcludedNominees = getExcludedNominees;
+const ethers_1 = require("ethers");
+const constants_1 = require("../constants");
+const rpc_utils_1 = require("../utils/rpc-utils");
+const abis_1 = require("../abis");
+const logger_1 = require("../utils/logger");
+const multicall_1 = require("../utils/multicall");
+const contracts_1 = require("./contracts");
+const log = logger_1.loggers.election;
+async function getContenders(proposalId, provider, nomineeGovernorAddress = constants_1.ADDRESSES.ELECTION_NOMINEE_GOVERNOR) {
+    log("getContenders for proposal %s", proposalId);
+    const governor = (0, contracts_1.getNomineeGovernor)(nomineeGovernorAddress, provider);
+    const iface = abis_1.nomineeElectionGovernorInterface;
+    const { fromBlock, toBlock } = await (0, contracts_1.getLogQueryBlockRange)(governor, proposalId, provider);
+    const logs = await (0, rpc_utils_1.queryWithRetry)(() => provider.getLogs({
+        address: nomineeGovernorAddress,
+        topics: [
+            iface.getEventTopic("ContenderAdded"),
+            ethers_1.ethers.utils.hexZeroPad(ethers_1.BigNumber.from(proposalId).toHexString(), 32),
+        ],
+        fromBlock,
+        toBlock,
+    }));
+    const contenders = logs.flatMap((eventLog) => {
+        try {
+            const parsed = iface.parseLog(eventLog);
+            return [
+                {
+                    address: parsed.args.contender.toLowerCase(),
+                    registeredAtBlock: eventLog.blockNumber,
+                    registrationTxHash: eventLog.transactionHash,
+                },
+            ];
+        }
+        catch {
+            return [];
+        }
+    });
+    log("Found %d contenders for proposal %s", contenders.length, proposalId);
+    return contenders;
+}
+async function getNomineesWithVotes(proposalId, provider, nomineeGovernorAddress = constants_1.ADDRESSES.ELECTION_NOMINEE_GOVERNOR) {
+    log("getNomineesWithVotes for proposal %s", proposalId);
+    const governor = (0, contracts_1.getNomineeGovernor)(nomineeGovernorAddress, provider);
+    const nomineeAddresses = await (0, rpc_utils_1.queryWithRetry)(() => governor.nominees(proposalId));
+    if (nomineeAddresses.length === 0) {
+        return [];
+    }
+    const calls = nomineeAddresses.flatMap((addr) => [
+        (0, multicall_1.buildCallInput)(nomineeGovernorAddress, abis_1.nomineeElectionGovernorInterface, "votesReceived", [proposalId, addr]),
+        (0, multicall_1.buildCallInput)(nomineeGovernorAddress, abis_1.nomineeElectionGovernorInterface, "isExcluded", [proposalId, addr]),
+    ]);
+    const results = await (0, multicall_1.multicall)(provider, calls);
+    const nominees = nomineeAddresses.map((addr, i) => ({
+        address: addr.toLowerCase(),
+        votesReceived: results[i * 2] ?? ethers_1.BigNumber.from(0),
+        isExcluded: results[i * 2 + 1] ?? false,
+    }));
+    log("Found %d nominees for proposal %s", nominees.length, proposalId);
+    return nominees;
+}
+async function getExcludedNominees(proposalId, provider, nomineeGovernorAddress = constants_1.ADDRESSES.ELECTION_NOMINEE_GOVERNOR) {
+    log("getExcludedNominees for proposal %s", proposalId);
+    const governor = (0, contracts_1.getNomineeGovernor)(nomineeGovernorAddress, provider);
+    const iface = abis_1.nomineeElectionGovernorInterface;
+    const { fromBlock, toBlock } = await (0, contracts_1.getLogQueryBlockRange)(governor, proposalId, provider, 0);
+    const logs = await (0, rpc_utils_1.queryWithRetry)(() => provider.getLogs({
+        address: nomineeGovernorAddress,
+        topics: [
+            iface.getEventTopic("NomineeExcluded"),
+            ethers_1.ethers.utils.hexZeroPad(ethers_1.BigNumber.from(proposalId).toHexString(), 32),
+        ],
+        fromBlock,
+        toBlock,
+    }));
+    const parsedLogs = logs.flatMap((eventLog) => {
+        try {
+            const parsed = iface.parseLog(eventLog);
+            return [{ eventLog, nominee: parsed.args.nominee }];
+        }
+        catch {
+            return [];
+        }
+    });
+    if (parsedLogs.length === 0) {
+        return [];
+    }
+    const calls = parsedLogs.map(({ nominee }) => (0, multicall_1.buildCallInput)(nomineeGovernorAddress, abis_1.nomineeElectionGovernorInterface, "votesReceived", [proposalId, nominee]));
+    const results = await (0, multicall_1.multicall)(provider, calls);
+    const excluded = parsedLogs.map(({ eventLog, nominee }, i) => ({
+        address: nominee.toLowerCase(),
+        votesReceived: results[i] ?? ethers_1.BigNumber.from(0),
+        isExcluded: true,
+        excludedAtBlock: eventLog.blockNumber,
+        exclusionTxHash: eventLog.transactionHash,
+    }));
+    log("Found %d excluded nominees for proposal %s", excluded.length, proposalId);
+    return excluded;
+}
+//# sourceMappingURL=participants.js.map

package/dist/election/participants.js.map

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

package/dist/election/prepare.d.ts

@@ -0,0 +1,10 @@
+import { ethers } from "ethers";
+import { ElectionProposalStatus, ElectionStatus, PreparedTransaction } from "../types";
+export interface PreparedElectionCreation {
+    transaction: PreparedTransaction;
+    electionIndex: number;
+}
+export declare function prepareElectionCreation(electionStatus: Pick<ElectionStatus, "electionCount">, nomineeGovernorAddress?: string): PreparedElectionCreation;
+export declare function prepareMemberElectionTrigger(electionStatus: Pick<ElectionProposalStatus, "electionIndex" | "canProceedToMemberPhase">, provider: ethers.providers.Provider, nomineeGovernorAddress?: string): Promise<PreparedTransaction | null>;
+export declare function prepareMemberElectionExecution(electionStatus: Pick<ElectionProposalStatus, "electionIndex" | "canExecuteMember">, provider: ethers.providers.Provider, memberGovernorAddress?: string): Promise<PreparedTransaction | null>;
+//# sourceMappingURL=prepare.d.ts.map

package/dist/election/prepare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare.d.ts","sourceRoot":"","sources":["../../src/election/prepare.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAWvF,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,mBAAmB,CAAC;IACjC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,uBAAuB,CACrC,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,eAAe,CAAC,EACrD,sBAAsB,GAAE,MAA4C,GACnE,wBAAwB,CAe1B;AAED,wBAAsB,4BAA4B,CAChD,cAAc,EAAE,IAAI,CAAC,sBAAsB,EAAE,eAAe,GAAG,yBAAyB,CAAC,EACzF,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,EACnC,sBAAsB,GAAE,MAA4C,GACnE,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAwBrC;AAED,wBAAsB,8BAA8B,CAClD,cAAc,EAAE,IAAI,CAAC,sBAAsB,EAAE,eAAe,GAAG,kBAAkB,CAAC,EAClF,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,EACnC,qBAAqB,GAAE,MAA2C,GACjE,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAwBrC"}

package/dist/election/prepare.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prepareElectionCreation = prepareElectionCreation;
+exports.prepareMemberElectionTrigger = prepareMemberElectionTrigger;
+exports.prepareMemberElectionExecution = prepareMemberElectionExecution;
+const constants_1 = require("../constants");
+const logger_1 = require("../utils/logger");
+const contracts_1 = require("./contracts");
+const params_1 = require("./params");
+const log = logger_1.loggers.election;
+function prepareElectionCreation(electionStatus, nomineeGovernorAddress = constants_1.ADDRESSES.ELECTION_NOMINEE_GOVERNOR) {
+    const governor = (0, contracts_1.getNomineeGovernor)(nomineeGovernorAddress);
+    const calldata = governor.interface.encodeFunctionData("createElection", []);
+    return {
+        transaction: {
+            to: nomineeGovernorAddress,
+            data: calldata,
+            value: "0",
+            chain: "arb1",
+            chainId: 42161,
+            description: `createElection() on SecurityCouncilNomineeElectionGovernor for election #${electionStatus.electionCount}`,
+        },
+        electionIndex: electionStatus.electionCount,
+    };
+}
+async function prepareMemberElectionTrigger(electionStatus, provider, nomineeGovernorAddress = constants_1.ADDRESSES.ELECTION_NOMINEE_GOVERNOR) {
+    log("prepareMemberElectionTrigger for election %d", electionStatus.electionIndex);
+    if (!electionStatus.canProceedToMemberPhase) {
+        log("Cannot proceed to member phase - not ready");
+        return null;
+    }
+    const params = await (0, params_1.getElectionProposalParams)(electionStatus.electionIndex, provider, nomineeGovernorAddress);
+    if (!params) {
+        log("Could not find proposal params for election %d", electionStatus.electionIndex);
+        return null;
+    }
+    return (0, params_1.buildExecuteTransaction)(params, nomineeGovernorAddress, `execute() on NomineeElectionGovernor to trigger member election #${electionStatus.electionIndex}`);
+}
+async function prepareMemberElectionExecution(electionStatus, provider, memberGovernorAddress = constants_1.ADDRESSES.ELECTION_MEMBER_GOVERNOR) {
+    log("prepareMemberElectionExecution for election %d", electionStatus.electionIndex);
+    if (!electionStatus.canExecuteMember) {
+        log("Cannot execute member election - not ready");
+        return null;
+    }
+    const params = await (0, params_1.getMemberElectionProposalParams)(electionStatus.electionIndex, provider, memberGovernorAddress);
+    if (!params) {
+        log("Could not find proposal params for member election %d", electionStatus.electionIndex);
+        return null;
+    }
+    return (0, params_1.buildExecuteTransaction)(params, memberGovernorAddress, `execute() on MemberElectionGovernor to install new Security Council members for election #${electionStatus.electionIndex}`);
+}
+//# sourceMappingURL=prepare.js.map

package/dist/election/prepare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare.js","sourceRoot":"","sources":["../../src/election/prepare.ts"],"names":[],"mappings":";;AAkBA,0DAkBC;AAED,oEA4BC;AAED,wEA4BC;AA/FD,4CAAyC;AAEzC,4CAA0C;AAC1C,2CAAiD;AACjD,qCAIkB;AAElB,MAAM,GAAG,GAAG,gBAAO,CAAC,QAAQ,CAAC;AAO7B,SAAgB,uBAAuB,CACrC,cAAqD,EACrD,yBAAiC,qBAAS,CAAC,yBAAyB;IAEpE,MAAM,QAAQ,GAAG,IAAA,8BAAkB,EAAC,sBAAsB,CAAC,CAAC;IAC5D,MAAM,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAC,kBAAkB,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;IAE7E,OAAO;QACL,WAAW,EAAE;YACX,EAAE,EAAE,sBAAsB;YAC1B,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,GAAG;YACV,KAAK,EAAE,MAAM;YACb,OAAO,EAAE,KAAK;YACd,WAAW,EAAE,4EAA4E,cAAc,CAAC,aAAa,EAAE;SACxH;QACD,aAAa,EAAE,cAAc,CAAC,aAAa;KAC5C,CAAC;AACJ,CAAC;AAEM,KAAK,UAAU,4BAA4B,CAChD,cAAyF,EACzF,QAAmC,EACnC,yBAAiC,qBAAS,CAAC,yBAAyB;IAEpE,GAAG,CAAC,8CAA8C,EAAE,cAAc,CAAC,aAAa,CAAC,CAAC;IAElF,IAAI,CAAC,cAAc,CAAC,uBAAuB,EAAE,CAAC;QAC5C,GAAG,CAAC,4CAA4C,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,IAAA,kCAAyB,EAC5C,cAAc,CAAC,aAAa,EAC5B,QAAQ,EACR,sBAAsB,CACvB,CAAC;IAEF,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,GAAG,CAAC,gDAAgD,EAAE,cAAc,CAAC,aAAa,CAAC,CAAC;QACpF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,IAAA,gCAAuB,EAC5B,MAAM,EACN,sBAAsB,EACtB,oEAAoE,cAAc,CAAC,aAAa,EAAE,CACnG,CAAC;AACJ,CAAC;AAEM,KAAK,UAAU,8BAA8B,CAClD,cAAkF,EAClF,QAAmC,EACnC,wBAAgC,qBAAS,CAAC,wBAAwB;IAElE,GAAG,CAAC,gDAAgD,EAAE,cAAc,CAAC,aAAa,CAAC,CAAC;IAEpF,IAAI,CAAC,cAAc,CAAC,gBAAgB,EAAE,CAAC;QACrC,GAAG,CAAC,4CAA4C,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,IAAA,wCAA+B,EAClD,cAAc,CAAC,aAAa,EAC5B,QAAQ,EACR,qBAAqB,CACtB,CAAC;IAEF,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,GAAG,CAAC,uDAAuD,EAAE,cAAc,CAAC,aAAa,CAAC,CAAC;QAC3F,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,IAAA,gCAAuB,EAC5B,MAAM,EACN,qBAAqB,EACrB,6FAA6F,cAAc,CAAC,aAAa,EAAE,CAC5H,CAAC;AACJ,CAAC"}

package/dist/election/proposal-ids.d.ts

@@ -0,0 +1,18 @@
+import { ethers } from "ethers";
+export interface ElectionProposalIds {
+    nomineeProposalId: string | null;
+    memberProposalId: string | null;
+}
+export interface GetElectionProposalIdsOptions {
+    nomineeGovernorAddress?: string;
+    memberGovernorAddress?: string;
+    blockNumber?: number;
+    skipCache?: boolean;
+}
+export declare function clearElectionProposalIdsCache(): void;
+export declare function clearElectionCache(): void;
+export declare function computeElectionProposalId(electionIndex: number, governor: ethers.Contract): Promise<string>;
+export declare function getElectionProposalId(electionIndex: number, provider: ethers.providers.Provider, nomineeGovernorAddress?: string): Promise<string | null>;
+export declare function getMemberElectionProposalId(electionIndex: number, provider: ethers.providers.Provider, memberGovernorAddress?: string): Promise<string>;
+export declare function getElectionProposalIds(electionIndex: number, provider: ethers.providers.Provider, options?: GetElectionProposalIdsOptions): Promise<ElectionProposalIds>;
+//# sourceMappingURL=proposal-ids.d.ts.map

package/dist/election/proposal-ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proposal-ids.d.ts","sourceRoot":"","sources":["../../src/election/proposal-ids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAa,MAAM,QAAQ,CAAC;AAS3C,MAAM,WAAW,mBAAmB;IAClC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,6BAA6B;IAC5C,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAQD,wBAAgB,6BAA6B,IAAI,IAAI,CAEpD;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED,wBAAsB,yBAAyB,CAC7C,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ,GACxB,OAAO,CAAC,MAAM,CAAC,CAgBjB;AAED,wBAAsB,qBAAqB,CACzC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,EACnC,sBAAsB,GAAE,MAA4C,GACnE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAUxB;AAED,wBAAsB,2BAA2B,CAC/C,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,EACnC,qBAAqB,GAAE,MAA2C,GACjE,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED,wBAAsB,sBAAsB,CAC1C,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,EACnC,OAAO,GAAE,6BAAkC,GAC1C,OAAO,CAAC,mBAAmB,CAAC,CAuC9B"}

package/dist/election/proposal-ids.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearElectionProposalIdsCache = clearElectionProposalIdsCache;
+exports.clearElectionCache = clearElectionCache;
+exports.computeElectionProposalId = computeElectionProposalId;
+exports.getElectionProposalId = getElectionProposalId;
+exports.getMemberElectionProposalId = getMemberElectionProposalId;
+exports.getElectionProposalIds = getElectionProposalIds;
+const ethers_1 = require("ethers");
+const constants_1 = require("../constants");
+const rpc_utils_1 = require("../utils/rpc-utils");
+const abis_1 = require("../abis");
+const multicall_1 = require("../utils/multicall");
+const salt_computation_1 = require("../utils/salt-computation");
+const block_cache_1 = require("../utils/block-cache");
+const contracts_1 = require("./contracts");
+const electionProposalIdsCache = new block_cache_1.BlockScopedCache({
+    isImmutable: (result) => {
+        return result.nomineeProposalId === null || result.memberProposalId !== null;
+    },
+});
+function clearElectionProposalIdsCache() {
+    electionProposalIdsCache.clear();
+}
+function clearElectionCache() {
+    clearElectionProposalIdsCache();
+}
+async function computeElectionProposalId(electionIndex, governor) {
+    const proposeArgs = (await (0, rpc_utils_1.queryWithRetry)(() => governor.getProposeArgs(electionIndex)));
+    const [targets, values, calldatas, description] = proposeArgs;
+    const descriptionHash = (0, salt_computation_1.saltFromDescription)(description);
+    const proposalId = await (0, rpc_utils_1.queryWithRetry)(() => governor.hashProposal(targets, values, calldatas, descriptionHash));
+    return ethers_1.BigNumber.from(proposalId).toString();
+}
+async function getElectionProposalId(electionIndex, provider, nomineeGovernorAddress = constants_1.ADDRESSES.ELECTION_NOMINEE_GOVERNOR) {
+    const governor = (0, contracts_1.getNomineeGovernor)(nomineeGovernorAddress, provider);
+    const proposalId = await computeElectionProposalId(electionIndex, governor);
+    try {
+        await (0, rpc_utils_1.queryWithRetry)(() => governor.state(proposalId));
+        return proposalId;
+    }
+    catch {
+        return null;
+    }
+}
+async function getMemberElectionProposalId(electionIndex, provider, memberGovernorAddress = constants_1.ADDRESSES.ELECTION_MEMBER_GOVERNOR) {
+    const governor = (0, contracts_1.getMemberGovernor)(memberGovernorAddress, provider);
+    return computeElectionProposalId(electionIndex, governor);
+}
+async function getElectionProposalIds(electionIndex, provider, options = {}) {
+    const { nomineeGovernorAddress = constants_1.ADDRESSES.ELECTION_NOMINEE_GOVERNOR, memberGovernorAddress = constants_1.ADDRESSES.ELECTION_MEMBER_GOVERNOR, blockNumber, skipCache, } = options;
+    const cached = electionProposalIdsCache.get(electionIndex, blockNumber, { skipCache });
+    if (cached) {
+        return cached;
+    }
+    const nomineeGovernor = (0, contracts_1.getNomineeGovernor)(nomineeGovernorAddress, provider);
+    const memberGovernor = (0, contracts_1.getMemberGovernor)(memberGovernorAddress, provider);
+    const [nomineeProposalId, computedMemberProposalId] = await Promise.all([
+        computeElectionProposalId(electionIndex, nomineeGovernor),
+        computeElectionProposalId(electionIndex, memberGovernor),
+    ]);
+    const stateResults = await (0, multicall_1.multicall)(provider, [
+        (0, multicall_1.buildCallInput)(nomineeGovernorAddress, abis_1.governorInterface, "state", [nomineeProposalId]),
+        (0, multicall_1.buildCallInput)(memberGovernorAddress, abis_1.governorInterface, "state", [
+            computedMemberProposalId,
+        ]),
+    ]);
+    const nomineeStateResult = stateResults[0];
+    const memberStateResult = stateResults[1];
+    const result = {
+        nomineeProposalId: nomineeStateResult !== null ? nomineeProposalId : null,
+        memberProposalId: memberStateResult !== null ? computedMemberProposalId : null,
+    };
+    electionProposalIdsCache.set(electionIndex, result, blockNumber);
+    return result;
+}
+//# sourceMappingURL=proposal-ids.js.map

package/dist/election/proposal-ids.js.map

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

package/dist/election/status.d.ts

@@ -0,0 +1,15 @@
+import { ethers } from "ethers";
+import { ElectionPhase, ElectionStatus, ProposalState } from "../types";
+/**
+ * Get the current election count without fetching full status.
+ * This is a lightweight call that only fetches the count (single multicall).
+ *
+ * @param l2Provider - Arbitrum One provider
+ * @param nomineeGovernorAddress - Optional custom nominee governor address
+ * @returns The number of elections that have been created
+ */
+export declare function getElectionCount(l2Provider: ethers.providers.Provider, nomineeGovernorAddress?: string): Promise<number>;
+export declare function determineElectionPhase(nomineeProposalState: ProposalState | null, memberProposalId: string | null, memberProposalState: ProposalState | null, isInVettingPeriod: boolean): ElectionPhase;
+export declare function checkElectionStatus(l2Provider: ethers.providers.Provider, l1Provider: ethers.providers.Provider, nomineeGovernorAddress?: string): Promise<ElectionStatus>;
+export declare function hasVettingPeriod(governorAddress: string, provider: ethers.providers.Provider): Promise<boolean>;
+//# sourceMappingURL=status.d.ts.map

package/dist/election/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/election/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAa,MAAM,QAAQ,CAAC;AAI3C,OAAO,EAAc,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AASpF;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,EACrC,sBAAsB,GAAE,MAA4C,GACnE,OAAO,CAAC,MAAM,CAAC,CAajB;AAED,wBAAgB,sBAAsB,CACpC,oBAAoB,EAAE,aAAa,GAAG,IAAI,EAC1C,gBAAgB,EAAE,MAAM,GAAG,IAAI,EAC/B,mBAAmB,EAAE,aAAa,GAAG,IAAI,EACzC,iBAAiB,EAAE,OAAO,GACzB,aAAa,CA0Bf;AAED,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,EACrC,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,EACrC,sBAAsB,GAAE,MAA4C,GACnE,OAAO,CAAC,cAAc,CAAC,CAkEzB;AAED,wBAAsB,gBAAgB,CACpC,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,GAClC,OAAO,CAAC,OAAO,CAAC,CASlB"}

package/dist/election/status.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getElectionCount = getElectionCount;
+exports.determineElectionPhase = determineElectionPhase;
+exports.checkElectionStatus = checkElectionStatus;
+exports.hasVettingPeriod = hasVettingPeriod;
+const constants_1 = require("../constants");
+const formatters_1 = require("../utils/formatters");
+const rpc_utils_1 = require("../utils/rpc-utils");
+const timing_1 = require("../utils/timing");
+const logger_1 = require("../utils/logger");
+const abis_1 = require("../abis");
+const contracts_1 = require("./contracts");
+const multicall_1 = require("../utils/multicall");
+const log = logger_1.loggers.election;
+/**
+ * Get the current election count without fetching full status.
+ * This is a lightweight call that only fetches the count (single multicall).
+ *
+ * @param l2Provider - Arbitrum One provider
+ * @param nomineeGovernorAddress - Optional custom nominee governor address
+ * @returns The number of elections that have been created
+ */
+async function getElectionCount(l2Provider, nomineeGovernorAddress = constants_1.ADDRESSES.ELECTION_NOMINEE_GOVERNOR) {
+    log("getElectionCount for %s", nomineeGovernorAddress);
+    const [electionCount] = await (0, multicall_1.multicall)(l2Provider, [
+        (0, multicall_1.buildCallInput)(nomineeGovernorAddress, abis_1.nomineeElectionGovernorInterface, "electionCount", []),
+    ]);
+    return electionCount.toNumber();
+}
+function determineElectionPhase(nomineeProposalState, memberProposalId, memberProposalState, isInVettingPeriod) {
+    if (memberProposalState === "Executed") {
+        return "COMPLETED";
+    }
+    if (memberProposalId) {
+        if (memberProposalState === "Succeeded" || memberProposalState === "Queued") {
+            return "PENDING_EXECUTION";
+        }
+        return "MEMBER_ELECTION";
+    }
+    if (nomineeProposalState === "Executed") {
+        return "PENDING_EXECUTION";
+    }
+    if (isInVettingPeriod) {
+        return "VETTING_PERIOD";
+    }
+    if (nomineeProposalState === "Pending") {
+        return "CONTENDER_SUBMISSION";
+    }
+    if (nomineeProposalState === "Active") {
+        return "NOMINEE_SELECTION";
+    }
+    if (nomineeProposalState === "Succeeded") {
+        return "PENDING_EXECUTION";
+    }
+    return "NOT_STARTED";
+}
+async function checkElectionStatus(l2Provider, l1Provider, nomineeGovernorAddress = constants_1.ADDRESSES.ELECTION_NOMINEE_GOVERNOR) {
+    log("checkElectionStatus for %s", nomineeGovernorAddress);
+    const [l1BlockNumber, electionCountResult] = await Promise.all([
+        (0, timing_1.getL1BlockNumberFromL2)(l2Provider),
+        (0, multicall_1.multicall)(l2Provider, [
+            (0, multicall_1.buildCallInput)(nomineeGovernorAddress, abis_1.nomineeElectionGovernorInterface, "electionCount", []),
+        ]),
+    ]);
+    const electionCount = electionCountResult[0];
+    log("L1 block number from L2: %s", l1BlockNumber.toString());
+    const l1Block = await (0, rpc_utils_1.queryWithRetry)(() => l1Provider.getBlock(l1BlockNumber.toNumber()));
+    if (!l1Block) {
+        throw new Error(`L1 block ${l1BlockNumber.toString()} not found. ` +
+            `If using a fork, ensure L1 is forked at a block >= ${l1BlockNumber.toString()}`);
+    }
+    const currentL1Timestamp = l1Block.timestamp;
+    log("L1 timestamp: %d", currentL1Timestamp);
+    const electionResults = await (0, multicall_1.multicall)(l2Provider, [
+        (0, multicall_1.buildCallInput)(nomineeGovernorAddress, abis_1.nomineeElectionGovernorInterface, "electionToTimestamp", [electionCount]),
+        (0, multicall_1.buildCallInput)(nomineeGovernorAddress, abis_1.nomineeElectionGovernorInterface, "electionIndexToCohort", [electionCount]),
+    ]);
+    const nextElectionTimestamp = electionResults[0];
+    const cohort = electionResults[1];
+    log("electionCount=%s nextTimestamp=%s cohort=%d", electionCount.toString(), nextElectionTimestamp.toString(), cohort);
+    const secondsUntilElection = Math.max(0, nextElectionTimestamp.toNumber() - currentL1Timestamp);
+    const canCreateElection = secondsUntilElection === 0;
+    const result = {
+        electionCount: electionCount.toNumber(),
+        cohort: cohort,
+        nextElectionTimestamp: nextElectionTimestamp.toNumber(),
+        currentL1Timestamp,
+        canCreateElection,
+        secondsUntilElection,
+        timeUntilElection: (0, formatters_1.formatDuration)(secondsUntilElection),
+    };
+    return result;
+}
+async function hasVettingPeriod(governorAddress, provider) {
+    const governor = (0, contracts_1.getNomineeGovernor)(governorAddress, provider);
+    try {
+        await (0, rpc_utils_1.queryWithRetry)(() => governor.nomineeVetter());
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=status.js.map

package/dist/election/status.js.map

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

package/dist/election/tracking.d.ts

@@ -0,0 +1,28 @@
+import { ethers } from "ethers";
+import { ElectionProposalStatus } from "../types";
+export declare function trackElectionProposal(electionIndex: number, l2Provider: ethers.providers.Provider, l1Provider: ethers.providers.Provider, options?: {
+    nomineeGovernorAddress?: string;
+    memberGovernorAddress?: string;
+    novaProvider?: ethers.providers.Provider;
+    l2BlockNumber?: number;
+    timestamp?: number;
+    skipCache?: boolean;
+}): Promise<ElectionProposalStatus>;
+export declare function trackAllElections(l2Provider: ethers.providers.Provider, l1Provider: ethers.providers.Provider, options?: {
+    includeNext?: boolean;
+    novaProvider?: ethers.providers.Provider;
+    l2BlockNumber?: number;
+    timestamp?: number;
+    skipCache?: boolean;
+}): Promise<ElectionProposalStatus[]>;
+export declare function trackIncompleteElections(l2Provider: ethers.providers.Provider, l1Provider: ethers.providers.Provider, options?: {
+    novaProvider?: ethers.providers.Provider;
+    l2BlockNumber?: number;
+    timestamp?: number;
+    skipCache?: boolean;
+}): Promise<ElectionProposalStatus[]>;
+export declare function getElectionIndexForProposalId(proposalId: string, l2Provider: ethers.providers.Provider, l1Provider: ethers.providers.Provider, options?: {
+    novaProvider?: ethers.providers.Provider;
+    blockNumber?: number;
+}): Promise<number | null>;
+//# sourceMappingURL=tracking.d.ts.map

package/dist/election/tracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracking.d.ts","sourceRoot":"","sources":["../../src/election/tracking.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAa,MAAM,QAAQ,CAAC;AAG3C,OAAO,EAEL,sBAAsB,EAIvB,MAAM,UAAU,CAAC;AA0MlB,wBAAsB,qBAAqB,CACzC,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,EACrC,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,EACrC,OAAO,GAAE;IACP,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;CAChB,GACL,OAAO,CAAC,sBAAsB,CAAC,CA4QjC;AAED,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,EACrC,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,EACrC,OAAO,GAAE;IACP,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;CAChB,GACL,OAAO,CAAC,sBAAsB,EAAE,CAAC,CA+CnC;AAED,wBAAsB,wBAAwB,CAC5C,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,EACrC,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,EACrC,OAAO,GAAE;IACP,YAAY,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;CAChB,GACL,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAQnC;AAED,wBAAsB,6BAA6B,CACjD,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,EACrC,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,EACrC,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/E,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAoCxB"}