@andrewkimjoseph/celina-sdk 0.25.7 → 0.25.9

package/build/abis/governance.d.ts

@@ -151,6 +151,39 @@ export declare const governanceAbi: readonly [{
         readonly type: "bool";
     }];
     readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "lastDequeue";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "dequeueFrequency";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "concurrentProposals";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "dequeueProposalsIfReady";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
 }, {
     readonly type: "function";
     readonly name: "upvote";

package/build/abis/governance.js

@@ -93,6 +93,34 @@ export const governanceAbi = [
         outputs: [{ name: "", type: "bool" }],
         stateMutability: "view",
     },
+    {
+        type: "function",
+        name: "lastDequeue",
+        inputs: [],
+        outputs: [{ name: "", type: "uint256" }],
+        stateMutability: "view",
+    },
+    {
+        type: "function",
+        name: "dequeueFrequency",
+        inputs: [],
+        outputs: [{ name: "", type: "uint256" }],
+        stateMutability: "view",
+    },
+    {
+        type: "function",
+        name: "concurrentProposals",
+        inputs: [],
+        outputs: [{ name: "", type: "uint256" }],
+        stateMutability: "view",
+    },
+    {
+        type: "function",
+        name: "dequeueProposalsIfReady",
+        inputs: [],
+        outputs: [],
+        stateMutability: "nonpayable",
+    },
     {
         type: "function",
         name: "upvote",

package/build/abis/governance.js.map

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

package/build/services/governance.service.d.ts

@@ -37,6 +37,11 @@ export declare class GovernanceService {
     private fetchProposal;
     private listProposalIds;
     private getGovernanceQueue;
+    private getDequeueSchedule;
+    private formatDequeueSchedule;
+    private assertUpvoteNotBlockedByPendingDequeue;
+    private getProposalSnapshots;
+    private discoverActionableProposals;
     /**
      * List governance proposals with pagination and optional CGP metadata.
      * @param options - Pagination (`page`/`pageSize` or `offset`/`limit`) and filters
@@ -115,7 +120,9 @@ export declare class GovernanceService {
         proposalId: number;
     }[]>;
     /** Proposals currently in Referendum stage with their dequeue index. */
-    getVotableProposals(): Promise<{
+    getVotableProposals(options?: {
+        limit?: number;
+    }): Promise<{
         network: "mainnet";
         proposals: {
             proposalId: number;
@@ -126,27 +133,47 @@ export declare class GovernanceService {
         message: string;
     }>;
     /** Proposals currently in Queue stage with upvote weight. */
-    getQueuedProposals(): Promise<{
+    getQueuedProposals(options?: {
+        limit?: number;
+    }): Promise<{
+        nextDequeueProposalIds: number[];
+        message: string;
+        lastDequeue: number;
+        lastDequeueISO: string;
+        dequeueFrequencySeconds: number;
+        concurrentProposals: number;
+        dequeueReady: boolean;
+        secondsUntilDequeueReady: number;
         network: "mainnet";
         proposals: {
             proposalId: number;
             upvotes: string;
             stage: "Queued";
             url: string;
+            upvoteable: boolean;
         }[];
-        message: string;
     }>;
     /** Queued and Referendum proposals you can upvote or vote on now. */
     getActionableGovernanceProposals(): Promise<{
+        nextDequeueProposalIds: number[];
+        message: string;
+        lastDequeue: number;
+        lastDequeueISO: string;
+        dequeueFrequencySeconds: number;
+        concurrentProposals: number;
+        dequeueReady: boolean;
+        secondsUntilDequeueReady: number;
         network: "mainnet";
         hasAny: boolean;
         hasQueued: boolean;
+        hasUpvoteableQueued: boolean;
         hasReferendum: boolean;
         queued: {
             proposalId: number;
             upvotes: string;
             stage: "Queued";
             url: string;
+            upvoteable: boolean;
         }[];
         referendum: {
             proposalId: number;
@@ -154,7 +181,6 @@ export declare class GovernanceService {
             stage: "Referendum";
             url: string;
         }[];
-        message: string;
     }>;
     /** Referendum votes and queue upvotes cast by an address on Celo governance. */
     getGovernanceVotes(address: `0x${string}`, options?: GovernanceVotesOptions): Promise<{
@@ -220,6 +246,11 @@ export declare class GovernanceService {
     prepareVote(from: `0x${string}`, proposalId: number, vote: VoteValueName): Promise<SerializedPreparedFlow>;
     /** Upvote a Queued governance proposal (one active queue upvote per account). */
     prepareUpvote(from: `0x${string}`, proposalId: number): Promise<SerializedPreparedFlow>;
+    /**
+     * Call Governance.dequeueProposalsIfReady (public; anyone can pay gas).
+     * When overdue, moves up to concurrentProposals from the queue into Approval.
+     */
+    prepareDequeueProposalsIfReady(from: `0x${string}`): Promise<SerializedPreparedFlow>;
     /** Revoke all active referendum votes for an account (bulk on-chain). */
     prepareRevokeGovernanceVotes(from: `0x${string}`): Promise<SerializedPreparedFlow>;
     /** Revoke the account's active queue upvote. */

package/build/services/governance.service.js

@@ -12,7 +12,7 @@ import { CHAIN } from "../config/chains.js";
 import { serializePreparedFlow, } from "../types/prepared.js";
 import { assertCeloAccountRegistered } from "../utils/celo-account.js";
 import { formatCeloAmount } from "../utils/celo-format.js";
-import { lesserAndGreaterAfterRevokeUpvote, lesserAndGreaterAfterUpvote, } from "../utils/governance-queue.js";
+import { isGovernanceDequeueReady, lesserAndGreaterAfterRevokeUpvote, lesserAndGreaterAfterUpvote, proposalIdsNextToDequeue, } from "../utils/governance-queue.js";
 const STAGE_EXPIRY_MS = {
     Queued: 4 * 24 * 60 * 60 * 1000,
     Approval: 24 * 60 * 60 * 1000,
@@ -61,6 +61,7 @@ function getExpiryTimestamp(stage, timestampMs) {
     const expiry = STAGE_EXPIRY_MS[stage];
     return expiry ? timestampMs + expiry : null;
 }
+const ACTIONABLE_PROPOSAL_SCAN_LIMIT = 120;
 /** Celo on-chain governance proposal reads, CGP enrichment, and LockedGold writes. */
 export class GovernanceService {
     clientFactory;
@@ -205,6 +206,138 @@ export class GovernanceService {
         }))
             .filter((entry) => entry.proposalId !== 0);
     }
+    async getDequeueSchedule() {
+        const client = this.getClient();
+        const governance = CELO_CORE_CONTRACTS.governance;
+        const [lastDequeue, dequeueFrequency, concurrentProposals] = await Promise.all([
+            client.readContract({
+                address: governance,
+                abi: governanceAbi,
+                functionName: "lastDequeue",
+            }),
+            client.readContract({
+                address: governance,
+                abi: governanceAbi,
+                functionName: "dequeueFrequency",
+            }),
+            client.readContract({
+                address: governance,
+                abi: governanceAbi,
+                functionName: "concurrentProposals",
+            }),
+        ]);
+        return {
+            lastDequeue: Number(lastDequeue),
+            dequeueFrequency: Number(dequeueFrequency),
+            concurrentProposals: Number(concurrentProposals),
+            now: Math.floor(Date.now() / 1000),
+        };
+    }
+    formatDequeueSchedule(schedule, dequeueReady) {
+        return {
+            lastDequeue: schedule.lastDequeue,
+            lastDequeueISO: new Date(schedule.lastDequeue * 1000).toISOString(),
+            dequeueFrequencySeconds: schedule.dequeueFrequency,
+            concurrentProposals: schedule.concurrentProposals,
+            dequeueReady,
+            secondsUntilDequeueReady: dequeueReady
+                ? 0
+                : Math.max(0, schedule.lastDequeue + schedule.dequeueFrequency - schedule.now),
+        };
+    }
+    assertUpvoteNotBlockedByPendingDequeue(proposalId, queue, schedule) {
+        if (!isGovernanceDequeueReady(schedule))
+            return;
+        const nextIds = proposalIdsNextToDequeue(queue, schedule.concurrentProposals);
+        if (!nextIds.includes(proposalId))
+            return;
+        throw new Error(`Cannot upvote proposal ${proposalId}: governance dequeue is overdue. ` +
+            `The next write (including upvote) runs dequeueProposalsIfReady first and would remove ` +
+            `proposal(s) [${nextIds.join(", ")}] from the queue, then upvote reverts with ` +
+            `"cannot upvote a proposal not in the queue". Call execute_dequeue_proposals_if_ready ` +
+            `(or prepare_dequeue_proposals_if_ready) first; those proposals move to Approval, then vote in Referendum.`);
+    }
+    async getProposalSnapshots(proposalIds) {
+        const uniqueIds = Array.from(new Set(proposalIds)).filter((id) => id > 0);
+        if (uniqueIds.length === 0)
+            return new Map();
+        const client = this.getClient();
+        const governance = CELO_CORE_CONTRACTS.governance;
+        const proposalCalls = uniqueIds.map((id) => ({
+            address: governance,
+            abi: governanceAbi,
+            functionName: "getProposal",
+            args: [BigInt(id)],
+        }));
+        const stageCalls = uniqueIds.map((id) => ({
+            address: governance,
+            abi: governanceAbi,
+            functionName: "getProposalStage",
+            args: [BigInt(id)],
+        }));
+        const [proposalResults, stageResults] = await Promise.all([
+            client.multicall({ contracts: proposalCalls, allowFailure: true }),
+            client.multicall({ contracts: stageCalls, allowFailure: true }),
+        ]);
+        const snapshots = new Map();
+        for (let i = 0; i < uniqueIds.length; i++) {
+            const id = uniqueIds[i];
+            const proposalResult = proposalResults[i];
+            const stageResult = stageResults[i];
+            if (!proposalResult ||
+                proposalResult.status !== "success" ||
+                !stageResult ||
+                stageResult.status !== "success") {
+                continue;
+            }
+            const [proposer, deposit, timestampSec, , url] = proposalResult.result;
+            if (proposer === "0x0000000000000000000000000000000000000000" &&
+                deposit === 0n &&
+                timestampSec === 0n) {
+                continue;
+            }
+            snapshots.set(id, {
+                stageName: proposalStageName(Number(stageResult.result)),
+                url,
+            });
+        }
+        return snapshots;
+    }
+    async discoverActionableProposals(limit = ACTIONABLE_PROPOSAL_SCAN_LIMIT) {
+        const [queueEntriesRaw, dequeueEntriesRaw, dequeueSchedule] = await Promise.all([
+            this.getGovernanceQueue(),
+            this.getDequeueWithIndices(),
+            this.getDequeueSchedule(),
+        ]);
+        const queueEntries = queueEntriesRaw.filter((entry) => entry.proposalId !== 0);
+        const dequeueEntries = dequeueEntriesRaw.filter((entry) => entry.proposalId !== 0);
+        const dequeueReady = isGovernanceDequeueReady(dequeueSchedule);
+        const nextDequeueProposalIds = dequeueReady
+            ? proposalIdsNextToDequeue(queueEntries, dequeueSchedule.concurrentProposals)
+            : [];
+        const selectedIds = Array.from(new Set([
+            ...queueEntries.map((entry) => entry.proposalId),
+            ...dequeueEntries.map((entry) => entry.proposalId),
+        ]))
+            .sort((a, b) => b - a)
+            .slice(0, Math.max(limit, 1));
+        const selected = new Set(selectedIds);
+        const queueLimited = queueEntries
+            .filter((entry) => selected.has(entry.proposalId))
+            .sort((a, b) => b.proposalId - a.proposalId);
+        const dequeueLimited = dequeueEntries
+            .filter((entry) => selected.has(entry.proposalId))
+            .sort((a, b) => b.proposalId - a.proposalId);
+        const snapshots = await this.getProposalSnapshots(selectedIds);
+        return {
+            queueEntries: queueLimited,
+            dequeueEntries: dequeueLimited,
+            snapshots,
+            dequeueSchedule,
+            dequeueReady,
+            nextDequeueProposalIds,
+        };
+    }
     /**
      * List governance proposals with pagination and optional CGP metadata.
      * @param options - Pagination (`page`/`pageSize` or `offset`/`limit`) and filters
@@ -320,25 +453,21 @@ export class GovernanceService {
         }));
     }
     /** Proposals currently in Referendum stage with their dequeue index. */
-    async getVotableProposals() {
-        const entries = await this.getDequeueWithIndices();
-        const votable = [];
-        for (const entry of entries) {
-            if (entry.proposalId === 0)
-                continue;
-            const proposal = await this.fetchProposal(entry.proposalId, 0, false);
-            if (!proposal)
-                continue;
-            const stageName = proposalStageName(proposal.stage);
-            if (stageName === "Referendum") {
-                votable.push({
+    async getVotableProposals(options = {}) {
+        const { dequeueEntries, snapshots } = await this.discoverActionableProposals(options.limit ?? ACTIONABLE_PROPOSAL_SCAN_LIMIT);
+        const votable = dequeueEntries.flatMap((entry) => {
+            const snapshot = snapshots.get(entry.proposalId);
+            if (!snapshot || snapshot.stageName !== "Referendum")
+                return [];
+            return [
+                {
                     proposalId: entry.proposalId,
                     index: entry.index,
-                    stage: stageName,
-                    url: proposal.url,
-                });
-            }
-        }
+                    stage: snapshot.stageName,
+                    url: snapshot.url,
+                },
+            ];
+        });
         return {
             network: "mainnet",
             proposals: votable,
@@ -348,55 +477,98 @@ export class GovernanceService {
         };
     }
     /** Proposals currently in Queue stage with upvote weight. */
-    async getQueuedProposals() {
-        const queue = await this.getGovernanceQueue();
-        const queued = [];
-        for (const entry of queue) {
-            const proposal = await this.fetchProposal(entry.proposalId, 0, false);
-            if (!proposal)
-                continue;
-            const stageName = proposalStageName(proposal.stage);
-            if (stageName === "Queued") {
-                queued.push({
+    async getQueuedProposals(options = {}) {
+        const { queueEntries, snapshots, dequeueSchedule, dequeueReady, nextDequeueProposalIds, } = await this.discoverActionableProposals(options.limit ?? ACTIONABLE_PROPOSAL_SCAN_LIMIT);
+        const nextDequeueSet = new Set(nextDequeueProposalIds);
+        const queued = queueEntries.flatMap((entry) => {
+            const snapshot = snapshots.get(entry.proposalId);
+            if (!snapshot || snapshot.stageName !== "Queued")
+                return [];
+            const upvoteable = !dequeueReady || !nextDequeueSet.has(entry.proposalId);
+            return [
+                {
                     proposalId: entry.proposalId,
                     upvotes: formatCeloAmount(entry.upvotes),
-                    stage: stageName,
-                    url: proposal.url,
-                });
-            }
+                    stage: snapshot.stageName,
+                    url: snapshot.url,
+                    upvoteable,
+                },
+            ];
+        });
+        const schedule = this.formatDequeueSchedule(dequeueSchedule, dequeueReady);
+        let message = queued.length > 0
+            ? `${queued.length} proposal(s) in Queue`
+            : "No proposals currently in Queue";
+        if (dequeueReady && nextDequeueProposalIds.length > 0) {
+            message += `. Dequeue overdue — next write will dequeue [${nextDequeueProposalIds.join(", ")}]; those are not upvoteable. Use execute_dequeue_proposals_if_ready.`;
         }
         return {
             network: "mainnet",
             proposals: queued,
-            message: queued.length > 0
-                ? `${queued.length} proposal(s) in Queue`
-                : "No proposals currently in Queue",
+            ...schedule,
+            nextDequeueProposalIds,
+            message,
         };
     }
     /** Queued and Referendum proposals you can upvote or vote on now. */
     async getActionableGovernanceProposals() {
-        const [queuedResult, referendumResult] = await Promise.all([
-            this.getQueuedProposals(),
-            this.getVotableProposals(),
-        ]);
-        const hasQueued = queuedResult.proposals.length > 0;
-        const hasReferendum = referendumResult.proposals.length > 0;
-        const hasAny = hasQueued || hasReferendum;
+        const { queueEntries, dequeueEntries, snapshots, dequeueSchedule, dequeueReady, nextDequeueProposalIds, } = await this.discoverActionableProposals();
+        const nextDequeueSet = new Set(nextDequeueProposalIds);
+        const queued = queueEntries.flatMap((entry) => {
+            const snapshot = snapshots.get(entry.proposalId);
+            if (!snapshot || snapshot.stageName !== "Queued")
+                return [];
+            const upvoteable = !dequeueReady || !nextDequeueSet.has(entry.proposalId);
+            return [
+                {
+                    proposalId: entry.proposalId,
+                    upvotes: formatCeloAmount(entry.upvotes),
+                    stage: snapshot.stageName,
+                    url: snapshot.url,
+                    upvoteable,
+                },
+            ];
+        });
+        const referendum = dequeueEntries.flatMap((entry) => {
+            const snapshot = snapshots.get(entry.proposalId);
+            if (!snapshot || snapshot.stageName !== "Referendum")
+                return [];
+            return [
+                {
+                    proposalId: entry.proposalId,
+                    index: entry.index,
+                    stage: snapshot.stageName,
+                    url: snapshot.url,
+                },
+            ];
+        });
+        const upvoteableQueued = queued.filter((p) => p.upvoteable);
+        const hasQueued = queued.length > 0;
+        const hasUpvoteableQueued = upvoteableQueued.length > 0;
+        const hasReferendum = referendum.length > 0;
+        const hasAny = hasUpvoteableQueued || hasReferendum;
         const parts = [];
         if (hasQueued) {
-            parts.push(`${queuedResult.proposals.length} Queued`);
+            parts.push(`${queued.length} Queued (${upvoteableQueued.length} upvoteable)`);
         }
         if (hasReferendum) {
-            parts.push(`${referendumResult.proposals.length} Referendum`);
+            parts.push(`${referendum.length} Referendum`);
+        }
+        if (dequeueReady && nextDequeueProposalIds.length > 0) {
+            parts.push(`dequeue overdue → [${nextDequeueProposalIds.join(", ")}] (use execute_dequeue_proposals_if_ready)`);
         }
+        const schedule = this.formatDequeueSchedule(dequeueSchedule, dequeueReady);
         return {
             network: "mainnet",
             hasAny,
             hasQueued,
+            hasUpvoteableQueued,
             hasReferendum,
-            queued: queuedResult.proposals,
-            referendum: referendumResult.proposals,
-            message: hasAny ? parts.join(", ") : "No actionable proposals",
+            queued,
+            referendum,
+            ...schedule,
+            nextDequeueProposalIds,
+            message: parts.length > 0 ? parts.join(", ") : "No actionable proposals",
         };
     }
     /** Referendum votes and queue upvotes cast by an address on Celo governance. */
@@ -702,10 +874,14 @@ export class GovernanceService {
         const governanceAccount = await this.resolveGovernanceAccount(from);
         const client = this.getClient();
         const governance = CELO_CORE_CONTRACTS.governance;
-        const queue = await this.getGovernanceQueue();
+        const [queue, dequeueSchedule] = await Promise.all([
+            this.getGovernanceQueue(),
+            this.getDequeueSchedule(),
+        ]);
         if (!queue.some((entry) => entry.proposalId === proposalId)) {
             throw new Error(`Proposal ${proposalId} is not in the governance queue. Use get_queued_proposals to find Queued proposals.`);
         }
+        this.assertUpvoteNotBlockedByPendingDequeue(proposalId, queue, dequeueSchedule);
         const [existingUpvoteProposalId] = (await client.readContract({
             address: governance,
             abi: governanceAbi,
@@ -735,6 +911,32 @@ export class GovernanceService {
             this.buildStep(governance, data, `Upvote proposal #${proposalId} with ${formatCeloAmount(lockedGold)} locked CELO`),
         ], `Upvote governance proposal #${proposalId}`);
     }
+    /**
+     * Call Governance.dequeueProposalsIfReady (public; anyone can pay gas).
+     * When overdue, moves up to concurrentProposals from the queue into Approval.
+     */
+    async prepareDequeueProposalsIfReady(from) {
+        const [queue, dequeueSchedule] = await Promise.all([
+            this.getGovernanceQueue(),
+            this.getDequeueSchedule(),
+        ]);
+        const dequeueReady = isGovernanceDequeueReady(dequeueSchedule);
+        const nextIds = dequeueReady
+            ? proposalIdsNextToDequeue(queue, dequeueSchedule.concurrentProposals)
+            : [];
+        const data = appendCelinaCalldataTag(encodeFunctionData({
+            abi: governanceAbi,
+            functionName: "dequeueProposalsIfReady",
+        }), this.attributionTags);
+        const summary = dequeueReady
+            ? nextIds.length > 0
+                ? `Dequeue overdue proposals [${nextIds.join(", ")}] into Approval`
+                : "Call dequeueProposalsIfReady (queue empty)"
+            : `Call dequeueProposalsIfReady (no-op until ${new Date((dequeueSchedule.lastDequeue + dequeueSchedule.dequeueFrequency) * 1000).toISOString()})`;
+        return this.toPreparedFlow(from, [
+            this.buildStep(CELO_CORE_CONTRACTS.governance, data, summary),
+        ], summary);
+    }
     /** Revoke all active referendum votes for an account (bulk on-chain). */
     async prepareRevokeGovernanceVotes(from) {
         const governanceAccount = await this.resolveGovernanceAccount(from);