@andrewkimjoseph/celina-sdk 0.15.7 → 0.16.0

package/build/services/governance.service.js

@@ -1,8 +1,16 @@
 /**
- * Celo governance: on-chain proposals with optional CGP markdown metadata from GitHub.
+ * Celo governance: on-chain proposals with optional CGP markdown metadata from GitHub,
+ * LockedGold locking/unlocking, and governance voting.
  */
+import { encodeFunctionData, isAddress, parseEther } from "viem";
 import { CELO_CORE_CONTRACTS } from "../config/celo-core-contracts.js";
-import { governanceAbi, proposalStageName, } from "../abis/governance.js";
+import { lockedGoldAbi } from "../abis/locked-gold.js";
+import { governanceAbi, proposalStageName, voteValueToInt, } from "../abis/governance.js";
+import { appendCelinaCalldataTag } from "../config/celina-tag.js";
+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";
 const STAGE_EXPIRY_MS = {
     Queued: 4 * 24 * 60 * 60 * 1000,
     Approval: 24 * 60 * 60 * 1000,
@@ -51,11 +59,13 @@ function getExpiryTimestamp(stage, timestampMs) {
     const expiry = STAGE_EXPIRY_MS[stage];
     return expiry ? timestampMs + expiry : null;
 }
-/** Celo on-chain governance proposal reads and CGP enrichment. */
+/** Celo on-chain governance proposal reads, CGP enrichment, and LockedGold writes. */
 export class GovernanceService {
     clientFactory;
+    attributionTags;
     constructor(clientFactory) {
         this.clientFactory = clientFactory;
+        this.attributionTags = clientFactory.getConfig().attributionTags;
     }
     getClient() {
         return this.clientFactory.getClients().public;
@@ -251,5 +261,245 @@ export class GovernanceService {
             error: null,
         };
     }
+    /** Raw getDequeue with positional indices preserved for Governance.vote(). */
+    async getDequeueWithIndices() {
+        const client = this.getClient();
+        const dequeued = (await client.readContract({
+            address: CELO_CORE_CONTRACTS.governance,
+            abi: governanceAbi,
+            functionName: "getDequeue",
+        }));
+        return dequeued.map((id, index) => ({
+            index,
+            proposalId: Number(id),
+        }));
+    }
+    /** 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({
+                    proposalId: entry.proposalId,
+                    index: entry.index,
+                    stage: stageName,
+                    url: proposal.url,
+                });
+            }
+        }
+        return {
+            network: "mainnet",
+            proposals: votable,
+            message: votable.length > 0
+                ? `${votable.length} proposal(s) in Referendum`
+                : "No proposals currently in Referendum",
+        };
+    }
+    /** Locked CELO balances and governance voting power for an address. */
+    async getLockedCeloBalance(address) {
+        if (!isAddress(address)) {
+            throw new Error(`Invalid address: ${address}`);
+        }
+        const client = this.getClient();
+        const lockedGold = CELO_CORE_CONTRACTS.lockedGold;
+        const [totalLocked, nonvotingLocked, votingPower, delegatedFraction] = await Promise.all([
+            client.readContract({
+                address: lockedGold,
+                abi: lockedGoldAbi,
+                functionName: "getAccountTotalLockedGold",
+                args: [address],
+            }),
+            client.readContract({
+                address: lockedGold,
+                abi: lockedGoldAbi,
+                functionName: "getAccountNonvotingLockedGold",
+                args: [address],
+            }),
+            client.readContract({
+                address: lockedGold,
+                abi: lockedGoldAbi,
+                functionName: "getAccountTotalGovernanceVotingPower",
+                args: [address],
+            }),
+            client.readContract({
+                address: lockedGold,
+                abi: lockedGoldAbi,
+                functionName: "getAccountTotalDelegatedFraction",
+                args: [address],
+            }),
+        ]);
+        return {
+            network: "mainnet",
+            address,
+            totalLocked: totalLocked.toString(),
+            totalLockedFormatted: formatCeloAmount(totalLocked),
+            nonvotingLocked: nonvotingLocked.toString(),
+            nonvotingLockedFormatted: formatCeloAmount(nonvotingLocked),
+            governanceVotingPower: votingPower.toString(),
+            governanceVotingPowerFormatted: formatCeloAmount(votingPower),
+            delegatedFraction: delegatedFraction.toString(),
+        };
+    }
+    /** Pending LockedGold withdrawals with maturity timestamps. */
+    async getPendingWithdrawals(address) {
+        if (!isAddress(address)) {
+            throw new Error(`Invalid address: ${address}`);
+        }
+        const client = this.getClient();
+        const lockedGold = CELO_CORE_CONTRACTS.lockedGold;
+        const [pending, unlockingPeriod] = await Promise.all([
+            client.readContract({
+                address: lockedGold,
+                abi: lockedGoldAbi,
+                functionName: "getPendingWithdrawals",
+                args: [address],
+            }),
+            client.readContract({
+                address: lockedGold,
+                abi: lockedGoldAbi,
+                functionName: "unlockingPeriod",
+            }),
+        ]);
+        const [values, timestamps] = pending;
+        const nowSec = Math.floor(Date.now() / 1000);
+        const withdrawals = values.map((value, index) => {
+            const timestampSec = Number(timestamps[index] ?? 0n);
+            return {
+                index,
+                value: value.toString(),
+                valueFormatted: formatCeloAmount(value),
+                availableAt: timestampSec,
+                availableAtIso: new Date(timestampSec * 1000).toISOString(),
+                isMature: nowSec >= timestampSec,
+            };
+        });
+        return {
+            network: "mainnet",
+            address,
+            unlockingPeriodSeconds: Number(unlockingPeriod),
+            withdrawals,
+            matureCount: withdrawals.filter((w) => w.isMature).length,
+        };
+    }
+    buildStep(to, data, description, value) {
+        return {
+            kind: value && value > 0n ? "native" : "contract",
+            to,
+            data,
+            value: value && value > 0n ? value.toString() : undefined,
+            description,
+        };
+    }
+    toPreparedFlow(from, steps, summary) {
+        const flow = {
+            steps,
+            summary,
+            chainId: CHAIN.id,
+            from,
+        };
+        return serializePreparedFlow(flow);
+    }
+    /** Lock CELO, relocking matured pending withdrawals first (reverse index order). */
+    async prepareLockCelo(from, amount) {
+        await assertCeloAccountRegistered(this.clientFactory, from);
+        const amountWei = parseEther(amount);
+        const pending = await this.getPendingWithdrawals(from);
+        const steps = [];
+        let amountRemaining = amountWei;
+        const sorted = [...pending.withdrawals]
+            .filter((w) => w.isMature)
+            .sort((a, b) => b.index - a.index);
+        for (const withdrawal of sorted) {
+            if (amountRemaining <= 0n)
+                break;
+            const txAmount = BigInt(withdrawal.value) <= amountRemaining
+                ? BigInt(withdrawal.value)
+                : amountRemaining;
+            const data = appendCelinaCalldataTag(encodeFunctionData({
+                abi: lockedGoldAbi,
+                functionName: "relock",
+                args: [BigInt(withdrawal.index), txAmount],
+            }), this.attributionTags);
+            steps.push(this.buildStep(CELO_CORE_CONTRACTS.lockedGold, data, `Relock ${formatCeloAmount(txAmount)} from pending withdrawal #${withdrawal.index}`));
+            amountRemaining -= txAmount;
+        }
+        if (amountRemaining > 0n) {
+            const data = appendCelinaCalldataTag(encodeFunctionData({
+                abi: lockedGoldAbi,
+                functionName: "lock",
+            }), this.attributionTags);
+            steps.push(this.buildStep(CELO_CORE_CONTRACTS.lockedGold, data, `Lock ${formatCeloAmount(amountRemaining)} CELO`, amountRemaining));
+        }
+        return this.toPreparedFlow(from, steps, `Lock ${amount} CELO for ${from}`);
+    }
+    async prepareUnlockCelo(from, amount) {
+        await assertCeloAccountRegistered(this.clientFactory, from);
+        const amountWei = parseEther(amount);
+        const data = appendCelinaCalldataTag(encodeFunctionData({
+            abi: lockedGoldAbi,
+            functionName: "unlock",
+            args: [amountWei],
+        }), this.attributionTags);
+        return this.toPreparedFlow(from, [
+            this.buildStep(CELO_CORE_CONTRACTS.lockedGold, data, `Unlock ${amount} CELO (starts ${formatCeloAmount(amountWei)} timelock)`),
+        ], `Unlock ${amount} CELO from ${from}`);
+    }
+    async prepareRelockCelo(from, index, amount) {
+        await assertCeloAccountRegistered(this.clientFactory, from);
+        const amountWei = parseEther(amount);
+        const data = appendCelinaCalldataTag(encodeFunctionData({
+            abi: lockedGoldAbi,
+            functionName: "relock",
+            args: [BigInt(index), amountWei],
+        }), this.attributionTags);
+        return this.toPreparedFlow(from, [
+            this.buildStep(CELO_CORE_CONTRACTS.lockedGold, data, `Relock ${amount} CELO from pending withdrawal #${index}`),
+        ], `Relock ${amount} CELO for ${from}`);
+    }
+    /** Withdraw all matured pending withdrawals. */
+    async prepareWithdrawCelo(from) {
+        await assertCeloAccountRegistered(this.clientFactory, from);
+        const pending = await this.getPendingWithdrawals(from);
+        const mature = pending.withdrawals.filter((w) => w.isMature);
+        if (mature.length === 0) {
+            throw new Error("No matured pending withdrawals available. Unlock CELO and wait for the timelock.");
+        }
+        const steps = mature.map((withdrawal) => {
+            const data = appendCelinaCalldataTag(encodeFunctionData({
+                abi: lockedGoldAbi,
+                functionName: "withdraw",
+                args: [BigInt(withdrawal.index)],
+            }), this.attributionTags);
+            return this.buildStep(CELO_CORE_CONTRACTS.lockedGold, data, `Withdraw ${withdrawal.valueFormatted} from pending #${withdrawal.index}`);
+        });
+        return this.toPreparedFlow(from, steps, `Withdraw ${mature.length} matured pending withdrawal(s) for ${from}`);
+    }
+    async prepareVote(from, proposalId, vote) {
+        const entries = await this.getDequeueWithIndices();
+        const match = entries.find((e) => e.proposalId === proposalId);
+        if (!match) {
+            throw new Error(`Proposal ${proposalId} is not in the dequeue. Use get_votable_proposals to find Referendum proposals.`);
+        }
+        const details = await this.fetchProposal(proposalId, 0, false);
+        if (!details || proposalStageName(details.stage) !== "Referendum") {
+            throw new Error(`Proposal ${proposalId} is not in Referendum stage.`);
+        }
+        const voteInt = voteValueToInt(vote);
+        const data = appendCelinaCalldataTag(encodeFunctionData({
+            abi: governanceAbi,
+            functionName: "vote",
+            args: [BigInt(proposalId), BigInt(match.index), voteInt],
+        }), this.attributionTags);
+        return this.toPreparedFlow(from, [
+            this.buildStep(CELO_CORE_CONTRACTS.governance, data, `Vote ${vote} on proposal #${proposalId} (index ${match.index})`),
+        ], `Vote ${vote} on governance proposal #${proposalId}`);
+    }
 }
 //# sourceMappingURL=governance.service.js.map

package/build/services/governance.service.js.map

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

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

@@ -0,0 +1,30 @@
+import type { CeloClientFactory } from "../clients/celo-client.js";
+import { SelfService } from "./self.service.js";
+export interface HumannessRailResult {
+    checked: boolean;
+    isHuman: boolean;
+    agentId?: number;
+    whitelistedRoot?: `0x${string}`;
+    reason?: string;
+}
+export interface HumannessCheckResult {
+    signerAddress: `0x${string}`;
+    selfAgent: HumannessRailResult;
+    goodDollar: HumannessRailResult;
+    isHumanOverall: boolean;
+}
+/** Address-bound humanness gate across Self and GoodDollar rails. */
+export declare class HumannessService {
+    private readonly clientFactory;
+    private readonly selfService;
+    constructor(clientFactory: CeloClientFactory, selfService: SelfService);
+    /**
+     * Check whether an address passes humanness on either Self or GoodDollar.
+     * @param signerAddress - The address that will sign on-chain actions
+     */
+    checkHumanness(signerAddress: `0x${string}`): Promise<HumannessCheckResult>;
+    private checkSelfRail;
+    private checkGoodDollarRail;
+}
+/** Throw when humanness check fails, with remediation pointers. */
+export declare function assertHumanness(result: HumannessCheckResult): void;

package/build/services/humanness.service.js

@@ -0,0 +1,123 @@
+/**
+ * Dual-rail humanness verification: Self Agent ID or GoodDollar IdentityV4.
+ */
+import { isAddress } from "viem";
+import { GOODDOLLAR_IDENTITY_ADDRESS } from "../config/gooddollar.js";
+import { goodDollarIdentityAbi } from "../abis/gooddollar-identity.js";
+const ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
+/** Address-bound humanness gate across Self and GoodDollar rails. */
+export class HumannessService {
+    clientFactory;
+    selfService;
+    constructor(clientFactory, selfService) {
+        this.clientFactory = clientFactory;
+        this.selfService = selfService;
+    }
+    /**
+     * Check whether an address passes humanness on either Self or GoodDollar.
+     * @param signerAddress - The address that will sign on-chain actions
+     */
+    async checkHumanness(signerAddress) {
+        if (!isAddress(signerAddress)) {
+            throw new Error(`Invalid address: ${signerAddress}`);
+        }
+        const [selfAgent, goodDollar] = await Promise.all([
+            this.checkSelfRail(signerAddress),
+            this.checkGoodDollarRail(signerAddress),
+        ]);
+        return {
+            signerAddress,
+            selfAgent,
+            goodDollar,
+            isHumanOverall: selfAgent.isHuman || goodDollar.isHuman,
+        };
+    }
+    async checkSelfRail(signerAddress) {
+        try {
+            const result = await this.selfService.verifyAgent({
+                agentAddress: signerAddress,
+            });
+            if (result.verified) {
+                return {
+                    checked: true,
+                    isHuman: true,
+                    agentId: "agent_id" in result && typeof result.agent_id === "number"
+                        ? result.agent_id
+                        : undefined,
+                };
+            }
+            return {
+                checked: true,
+                isHuman: false,
+                reason: "reason" in result && typeof result.reason === "string"
+                    ? result.reason
+                    : "Self agent not verified",
+            };
+        }
+        catch (error) {
+            return {
+                checked: true,
+                isHuman: false,
+                reason: error instanceof Error ? error.message : "Self verification failed",
+            };
+        }
+    }
+    async checkGoodDollarRail(signerAddress) {
+        const client = this.clientFactory.getClients().public;
+        try {
+            const root = (await client.readContract({
+                address: GOODDOLLAR_IDENTITY_ADDRESS,
+                abi: goodDollarIdentityAbi,
+                functionName: "getWhitelistedRoot",
+                args: [signerAddress],
+            }));
+            const identityAddress = root !== ZERO_ADDRESS ? root : signerAddress;
+            const isWhitelisted = await client.readContract({
+                address: GOODDOLLAR_IDENTITY_ADDRESS,
+                abi: goodDollarIdentityAbi,
+                functionName: "isWhitelisted",
+                args: [identityAddress],
+            });
+            if (isWhitelisted) {
+                return {
+                    checked: true,
+                    isHuman: true,
+                    whitelistedRoot: root !== ZERO_ADDRESS ? root : signerAddress,
+                };
+            }
+            return {
+                checked: true,
+                isHuman: false,
+                whitelistedRoot: root !== ZERO_ADDRESS ? root : undefined,
+                reason: "GoodDollar identity not whitelisted",
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            if (message.includes("revert") &&
+                (message.includes("reverify") || message.includes("out of bounds"))) {
+                return {
+                    checked: true,
+                    isHuman: false,
+                    reason: "reverify-index-out-of-bounds",
+                };
+            }
+            return {
+                checked: true,
+                isHuman: false,
+                reason: message,
+            };
+        }
+    }
+}
+/** Throw when humanness check fails, with remediation pointers. */
+export function assertHumanness(result) {
+    if (result.isHumanOverall)
+        return;
+    throw new Error(`Humanness verification failed for ${result.signerAddress}. ` +
+        `Self: ${result.selfAgent.reason ?? "not verified"}. ` +
+        `GoodDollar: ${result.goodDollar.reason ?? "not whitelisted"}. ` +
+        "Register a Self agent (register_self_agent) or verify with GoodDollar " +
+        "(get_gooddollar_face_verification_link).");
+}
+//# sourceMappingURL=humanness.service.js.map

package/build/services/humanness.service.js.map

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

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

@@ -1,7 +1,9 @@
 import type { CeloClientFactory } from "../clients/celo-client.js";
-/** Validator election staking reads via Celo core contracts. */
+import { type SerializedPreparedFlow } from "../types/prepared.js";
+/** Validator election staking reads and writes via Celo core contracts. */
 export declare class StakingService {
     private readonly clientFactory;
+    private readonly attributionTags?;
     constructor(clientFactory: CeloClientFactory);
     private getClient;
     /**
@@ -137,4 +139,28 @@ export declare class StakingService {
             message: string;
         };
     }>;
+    /** Governance vote delegation info from LockedGold for an address. */
+    getDelegationInfo(address: `0x${string}`): Promise<{
+        network: "mainnet";
+        address: `0x${string}`;
+        totalDelegatedFraction: string;
+        totalDelegatedPercent: string;
+        governanceVotingPower: string;
+        governanceVotingPowerFormatted: string;
+        delegatees: {
+            delegatee: `0x${string}`;
+            fraction: string;
+            fractionPercent: string;
+            currentAmount: string;
+            currentAmountFormatted: string;
+        }[];
+    }>;
+    private buildStep;
+    private toPreparedFlow;
+    private fetchEligibleGroupsWithVotes;
+    prepareStake(from: `0x${string}`, groupAddress: `0x${string}`, amount: string): Promise<SerializedPreparedFlow>;
+    prepareActivateStake(from: `0x${string}`, groupAddress: `0x${string}`): Promise<SerializedPreparedFlow>;
+    prepareUnstake(from: `0x${string}`, groupAddress: `0x${string}`, amount: string): Promise<SerializedPreparedFlow>;
+    prepareDelegatePower(from: `0x${string}`, delegatee: `0x${string}`, percent: number): Promise<SerializedPreparedFlow>;
+    prepareUndelegatePower(from: `0x${string}`, delegatee: `0x${string}`, percent: number): Promise<SerializedPreparedFlow>;
 }