@andrewkimjoseph/celina-sdk 0.15.7 → 0.16.0

package/build/src/tools/domains/staking.js

@@ -1,10 +1,17 @@
 import { z } from "zod";
-import { addressSchema, optionalBoundedPositiveInt, optionalWalletAddressSchema, paginationFields, } from "../schemas/common.js";
+import { addressSchema, executeEnvRequirements, optionalBoundedPositiveInt, optionalSignerSchema, optionalWalletAddressSchema, paginationFields, } from "../schemas/common.js";
 import { resolveWalletFromRuntime } from "../utils/wallet.js";
 const readOnly = {
     readOnlyHint: true,
     idempotentHint: true,
 };
+const destructive = {
+    destructiveHint: true,
+    openWorldHint: true,
+};
+function resolveSigner(input) {
+    return input.signer;
+}
 export const stakingToolDefinitions = [
     {
         name: "get_staking_balances",
@@ -70,5 +77,196 @@ export const stakingToolDefinitions = [
         mcp: { title: "Get Total Staking Info", annotations: readOnly },
         handler: async (runtime) => runtime.celina.staking.getTotalStakingInfo(),
     },
+    {
+        name: "get_delegation_info",
+        description: "Governance vote delegation info from LockedGold for an address.",
+        inputSchema: z.object({ address: optionalWalletAddressSchema }),
+        families: ["read"],
+        mcp: { title: "Get Delegation Info", annotations: readOnly },
+        handler: async (runtime, input) => {
+            const target = resolveWalletFromRuntime(runtime, {
+                address: input.address,
+            });
+            return runtime.celina.staking.getDelegationInfo(target);
+        },
+    },
+    {
+        name: "execute_stake",
+        description: "Stake locked CELO with a validator group. Requires humanness verification and registered Celo account.",
+        inputSchema: z.object({
+            group_address: addressSchema,
+            amount: z.string(),
+            signer: optionalSignerSchema,
+        }),
+        families: ["execute"],
+        surfaces: ["mcp"],
+        requiresEnv: [...executeEnvRequirements],
+        mcp: { title: "Stake CELO", annotations: destructive },
+        handler: async (runtime, input) => {
+            const write = runtime.executors?.stakingWrite;
+            if (!write)
+                throw new Error("Staking write executor not configured.");
+            return write.stake(input.group_address, input.amount, resolveSigner(input));
+        },
+    },
+    {
+        name: "execute_activate_stake",
+        description: "Activate pending stake for a validator group after epoch boundary.",
+        inputSchema: z.object({
+            group_address: addressSchema,
+            signer: optionalSignerSchema,
+        }),
+        families: ["execute"],
+        surfaces: ["mcp"],
+        requiresEnv: [...executeEnvRequirements],
+        mcp: { title: "Activate Stake", annotations: destructive },
+        handler: async (runtime, input) => {
+            const write = runtime.executors?.stakingWrite;
+            if (!write)
+                throw new Error("Staking write executor not configured.");
+            return write.activateStake(input.group_address, resolveSigner(input));
+        },
+    },
+    {
+        name: "execute_unstake",
+        description: "Unstake CELO from a validator group. Requires humanness verification.",
+        inputSchema: z.object({
+            group_address: addressSchema,
+            amount: z.string(),
+            signer: optionalSignerSchema,
+        }),
+        families: ["execute"],
+        surfaces: ["mcp"],
+        requiresEnv: [...executeEnvRequirements],
+        mcp: { title: "Unstake CELO", annotations: destructive },
+        handler: async (runtime, input) => {
+            const write = runtime.executors?.stakingWrite;
+            if (!write)
+                throw new Error("Staking write executor not configured.");
+            return write.unstake(input.group_address, input.amount, resolveSigner(input));
+        },
+    },
+    {
+        name: "execute_delegate_power",
+        description: "Delegate governance voting power to another address. Requires humanness verification.",
+        inputSchema: z.object({
+            delegatee: addressSchema,
+            percent: z.number().min(0).max(100),
+            signer: optionalSignerSchema,
+        }),
+        families: ["execute"],
+        surfaces: ["mcp"],
+        requiresEnv: [...executeEnvRequirements],
+        mcp: { title: "Delegate Power", annotations: destructive },
+        handler: async (runtime, input) => {
+            const write = runtime.executors?.stakingWrite;
+            if (!write)
+                throw new Error("Staking write executor not configured.");
+            return write.delegatePower(input.delegatee, input.percent, resolveSigner(input));
+        },
+    },
+    {
+        name: "execute_undelegate_power",
+        description: "Revoke delegated governance voting power. Requires humanness verification.",
+        inputSchema: z.object({
+            delegatee: addressSchema,
+            percent: z.number().min(0).max(100),
+            signer: optionalSignerSchema,
+        }),
+        families: ["execute"],
+        surfaces: ["mcp"],
+        requiresEnv: [...executeEnvRequirements],
+        mcp: { title: "Undelegate Power", annotations: destructive },
+        handler: async (runtime, input) => {
+            const write = runtime.executors?.stakingWrite;
+            if (!write)
+                throw new Error("Staking write executor not configured.");
+            return write.undelegatePower(input.delegatee, input.percent, resolveSigner(input));
+        },
+    },
+    {
+        name: "prepare_stake",
+        description: "Prepare unsigned stake CELO flow for wallet signing.",
+        inputSchema: z.object({
+            from: optionalWalletAddressSchema,
+            group_address: addressSchema,
+            amount: z.string(),
+        }),
+        families: ["prepare"],
+        surfaces: ["browser"],
+        handler: async (runtime, input) => {
+            const from = resolveWalletFromRuntime(runtime, {
+                from: input.from,
+            });
+            return runtime.celina.staking.prepareStake(from, input.group_address, input.amount);
+        },
+    },
+    {
+        name: "prepare_activate_stake",
+        description: "Prepare unsigned activate stake flow for wallet signing.",
+        inputSchema: z.object({
+            from: optionalWalletAddressSchema,
+            group_address: addressSchema,
+        }),
+        families: ["prepare"],
+        surfaces: ["browser"],
+        handler: async (runtime, input) => {
+            const from = resolveWalletFromRuntime(runtime, {
+                from: input.from,
+            });
+            return runtime.celina.staking.prepareActivateStake(from, input.group_address);
+        },
+    },
+    {
+        name: "prepare_unstake",
+        description: "Prepare unsigned unstake flow for wallet signing.",
+        inputSchema: z.object({
+            from: optionalWalletAddressSchema,
+            group_address: addressSchema,
+            amount: z.string(),
+        }),
+        families: ["prepare"],
+        surfaces: ["browser"],
+        handler: async (runtime, input) => {
+            const from = resolveWalletFromRuntime(runtime, {
+                from: input.from,
+            });
+            return runtime.celina.staking.prepareUnstake(from, input.group_address, input.amount);
+        },
+    },
+    {
+        name: "prepare_delegate_power",
+        description: "Prepare unsigned delegate governance power flow for wallet signing.",
+        inputSchema: z.object({
+            from: optionalWalletAddressSchema,
+            delegatee: addressSchema,
+            percent: z.number().min(0).max(100),
+        }),
+        families: ["prepare"],
+        surfaces: ["browser"],
+        handler: async (runtime, input) => {
+            const from = resolveWalletFromRuntime(runtime, {
+                from: input.from,
+            });
+            return runtime.celina.staking.prepareDelegatePower(from, input.delegatee, input.percent);
+        },
+    },
+    {
+        name: "prepare_undelegate_power",
+        description: "Prepare unsigned undelegate governance power flow for wallet signing.",
+        inputSchema: z.object({
+            from: optionalWalletAddressSchema,
+            delegatee: addressSchema,
+            percent: z.number().min(0).max(100),
+        }),
+        families: ["prepare"],
+        surfaces: ["browser"],
+        handler: async (runtime, input) => {
+            const from = resolveWalletFromRuntime(runtime, {
+                from: input.from,
+            });
+            return runtime.celina.staking.prepareUndelegatePower(from, input.delegatee, input.percent);
+        },
+    },
 ];
 //# sourceMappingURL=staking.js.map

package/build/src/tools/domains/staking.js.map

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

package/build/src/tools/schemas/common.d.ts

@@ -1,6 +1,9 @@
 import { z } from "zod";
 export declare const addressSchema: z.ZodString;
 export declare const optionalWalletAddressSchema: z.ZodOptional<z.ZodString>;
+/** Optional MCP server signer selection for humanness-gated execute tools. */
+export declare const optionalSignerSchema: z.ZodOptional<z.ZodEnum<["celo", "self_agent"]>>;
+export declare const executeEnvRequirements: readonly ["CELO_PRIVATE_KEY", "SELF_AGENT_PRIVATE_KEY"];
 export declare const requiredWalletAddressSchema: z.ZodString;
 /** Input keys that default to the MCP signer when omitted on local stdio. */
 export declare const WALLET_PARAM_KEYS: readonly ["address", "wallet_address", "from", "from_address"];

package/build/src/tools/schemas/common.js

@@ -6,6 +6,15 @@ export const addressSchema = z
 export const optionalWalletAddressSchema = addressSchema
     .optional()
     .describe("Wallet on Celo mainnet. Omit to use the connected wallet or MCP CELO_PRIVATE_KEY signer.");
+/** Optional MCP server signer selection for humanness-gated execute tools. */
+export const optionalSignerSchema = z
+    .enum(["celo", "self_agent"])
+    .optional()
+    .describe("MCP server signer: celo (CELO_PRIVATE_KEY) or self_agent (SELF_AGENT_PRIVATE_KEY). Defaults to CELO when both are set.");
+export const executeEnvRequirements = [
+    "CELO_PRIVATE_KEY",
+    "SELF_AGENT_PRIVATE_KEY",
+];
 export const requiredWalletAddressSchema = addressSchema.describe("Wallet on Celo mainnet (0x address).");
 /** Input keys that default to the MCP signer when omitted on local stdio. */
 export const WALLET_PARAM_KEYS = [

package/build/src/tools/schemas/common.js.map

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

package/build/src/tools/types.d.ts

@@ -79,6 +79,30 @@ export type GoodDollarWriteExecutors = {
         slippageTolerance?: number;
     }) => Promise<unknown>;
 };
+export type GoodDollarIdentityExecutors = {
+    getFaceVerificationLink: (callbackUrl: string) => Promise<unknown>;
+};
+export type GoodDollarIdentityWriteExecutors = {
+    connectIdentity: (connectedAccount: `0x${string}`, signer?: "celo" | "self_agent") => Promise<unknown>;
+    disconnectIdentity: (connectedAccount: `0x${string}`, signer?: "celo" | "self_agent") => Promise<unknown>;
+};
+export type GovernanceWriteExecutors = {
+    lockCelo: (amount: string, signer?: "celo" | "self_agent") => Promise<unknown>;
+    unlockCelo: (amount: string, signer?: "celo" | "self_agent") => Promise<unknown>;
+    relockCelo: (index: number, amount: string, signer?: "celo" | "self_agent") => Promise<unknown>;
+    withdrawCelo: (signer?: "celo" | "self_agent") => Promise<unknown>;
+    vote: (proposalId: number, vote: "Abstain" | "No" | "Yes", signer?: "celo" | "self_agent") => Promise<unknown>;
+};
+export type StakingWriteExecutors = {
+    stake: (groupAddress: `0x${string}`, amount: string, signer?: "celo" | "self_agent") => Promise<unknown>;
+    activateStake: (groupAddress: `0x${string}`, signer?: "celo" | "self_agent") => Promise<unknown>;
+    unstake: (groupAddress: `0x${string}`, amount: string, signer?: "celo" | "self_agent") => Promise<unknown>;
+    delegatePower: (delegatee: `0x${string}`, percent: number, signer?: "celo" | "self_agent") => Promise<unknown>;
+    undelegatePower: (delegatee: `0x${string}`, percent: number, signer?: "celo" | "self_agent") => Promise<unknown>;
+};
+export type AccountWriteExecutors = {
+    registerAccount: (signer?: "celo" | "self_agent") => Promise<unknown>;
+};
 export type SelfExecutors = {
     verifyAgent: (args: Record<string, unknown>) => Promise<unknown>;
     lookupAgent: (agentId: number) => Promise<unknown>;
@@ -98,6 +122,11 @@ export type ToolRuntimeExecutors = {
     aave?: AaveExecutors;
     contract?: ContractExecutors;
     gooddollarWrite?: GoodDollarWriteExecutors;
+    gooddollarIdentity?: GoodDollarIdentityExecutors;
+    gooddollarIdentityWrite?: GoodDollarIdentityWriteExecutors;
+    governanceWrite?: GovernanceWriteExecutors;
+    stakingWrite?: StakingWriteExecutors;
+    accountWrite?: AccountWriteExecutors;
     self?: SelfExecutors;
 };
 export interface ToolRuntime {

package/build/src/utils/celo-account.d.ts

@@ -0,0 +1,3 @@
+import type { CeloClientFactory } from "../clients/celo-client.js";
+export declare function isCeloAccountRegistered(clientFactory: CeloClientFactory, address: `0x${string}`): Promise<boolean>;
+export declare function assertCeloAccountRegistered(clientFactory: CeloClientFactory, address: `0x${string}`): Promise<void>;

package/build/src/utils/celo-account.js

@@ -0,0 +1,22 @@
+/**
+ * Celo Accounts registry precondition helpers.
+ */
+import { accountsAbi } from "../abis/accounts.js";
+import { CELO_CORE_CONTRACTS } from "../config/celo-core-contracts.js";
+export async function isCeloAccountRegistered(clientFactory, address) {
+    const client = clientFactory.getClients().public;
+    return client.readContract({
+        address: CELO_CORE_CONTRACTS.accounts,
+        abi: accountsAbi,
+        functionName: "isAccount",
+        args: [address],
+    });
+}
+export async function assertCeloAccountRegistered(clientFactory, address) {
+    const registered = await isCeloAccountRegistered(clientFactory, address);
+    if (!registered) {
+        throw new Error(`Address ${address} is not a registered Celo account. ` +
+            "Call prepare_register_celo_account or execute_register_celo_account first.");
+    }
+}
+//# sourceMappingURL=celo-account.js.map

package/build/src/utils/celo-account.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"celo-account.js","sourceRoot":"","sources":["../../../src/utils/celo-account.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAGvE,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,aAAgC,EAChC,OAAsB;IAEtB,MAAM,MAAM,GAAG,aAAa,CAAC,UAAU,EAAE,CAAC,MAAM,CAAC;IACjD,OAAO,MAAM,CAAC,YAAY,CAAC;QACzB,OAAO,EAAE,mBAAmB,CAAC,QAAQ;QACrC,GAAG,EAAE,WAAW;QAChB,YAAY,EAAE,WAAW;QACzB,IAAI,EAAE,CAAC,OAAO,CAAC;KAChB,CAAqB,CAAC;AACzB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,aAAgC,EAChC,OAAsB;IAEtB,MAAM,UAAU,GAAG,MAAM,uBAAuB,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACzE,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CACb,WAAW,OAAO,qCAAqC;YACrD,4EAA4E,CAC/E,CAAC;IACJ,CAAC;AACH,CAAC"}

package/build/src/utils/election-vote-neighbors.d.ts

@@ -0,0 +1,12 @@
+export interface ValidatorGroupVotes {
+    address: `0x${string}`;
+    votes: bigint;
+}
+/**
+ * Find lesser/greater neighbour validator groups after a vote weight change.
+ * Mirrors Celo Mondo's findLesserAndGreaterAfterVote (groups sorted descending).
+ */
+export declare function findLesserAndGreaterAfterVote(groups: ValidatorGroupVotes[], targetGroup: `0x${string}`, voteWeight: bigint): {
+    lesser: `0x${string}`;
+    greater: `0x${string}`;
+};

package/build/src/utils/election-vote-neighbors.js

@@ -0,0 +1,27 @@
+const ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
+/**
+ * Find lesser/greater neighbour validator groups after a vote weight change.
+ * Mirrors Celo Mondo's findLesserAndGreaterAfterVote (groups sorted descending).
+ */
+export function findLesserAndGreaterAfterVote(groups, targetGroup, voteWeight) {
+    const sortedGroups = [...groups].sort((a, b) => {
+        if (a.votes === b.votes)
+            return 0;
+        return a.votes > b.votes ? -1 : 1;
+    });
+    const selectedGroup = sortedGroups.find((g) => g.address.toLowerCase() === targetGroup.toLowerCase());
+    const voteTotal = (selectedGroup?.votes ?? 0n) + voteWeight;
+    let greater = ZERO_ADDRESS;
+    let lesser = ZERO_ADDRESS;
+    for (const group of sortedGroups) {
+        if (group.address.toLowerCase() === targetGroup.toLowerCase())
+            continue;
+        if (group.votes < voteTotal) {
+            lesser = group.address;
+            break;
+        }
+        greater = group.address;
+    }
+    return { lesser, greater };
+}
+//# sourceMappingURL=election-vote-neighbors.js.map

package/build/src/utils/election-vote-neighbors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"election-vote-neighbors.js","sourceRoot":"","sources":["../../../src/utils/election-vote-neighbors.ts"],"names":[],"mappings":"AAAA,MAAM,YAAY,GAAG,4CAAqD,CAAC;AAO3E;;;GAGG;AACH,MAAM,UAAU,6BAA6B,CAC3C,MAA6B,EAC7B,WAA0B,EAC1B,UAAkB;IAElB,MAAM,YAAY,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC7C,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK;YAAE,OAAO,CAAC,CAAC;QAClC,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,YAAY,CAAC,IAAI,CACrC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,WAAW,CAAC,WAAW,EAAE,CAC7D,CAAC;IACF,MAAM,SAAS,GAAG,CAAC,aAAa,EAAE,KAAK,IAAI,EAAE,CAAC,GAAG,UAAU,CAAC;IAE5D,IAAI,OAAO,GAAkB,YAAY,CAAC;IAC1C,IAAI,MAAM,GAAkB,YAAY,CAAC;IAEzC,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,CAAC;QACjC,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,WAAW,CAAC,WAAW,EAAE;YAAE,SAAS;QACxE,IAAI,KAAK,CAAC,KAAK,GAAG,SAAS,EAAE,CAAC;YAC5B,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC;YACvB,MAAM;QACR,CAAC;QACD,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC1B,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC"}

package/build/src/utils/fixidity.d.ts

@@ -0,0 +1,11 @@
+/** Celo Fixidity fractions use 1e24 precision. */
+export declare const FIXIDITY_ONE: bigint;
+/** Convert a percent (0–100) to Fixidity at 1e24 precision. */
+export declare function percentToFixidity(percent: number): bigint;
+/**
+ * Convert a unit fraction (0–1) to a Fixidity uint256 at 1e24 precision.
+ * @param fraction - Unit fraction, e.g. 0.5 for 50%
+ */
+export declare function toFixidity(fraction: number): bigint;
+/** Convert Fixidity bigint back to a unit fraction. */
+export declare function fromFixidity(value: bigint): number;

package/build/src/utils/fixidity.js

@@ -0,0 +1,24 @@
+/** Celo Fixidity fractions use 1e24 precision. */
+export const FIXIDITY_ONE = 10n ** 24n;
+/** Convert a percent (0–100) to Fixidity at 1e24 precision. */
+export function percentToFixidity(percent) {
+    if (!Number.isFinite(percent) || percent < 0 || percent > 100) {
+        throw new Error(`Fixidity percent must be between 0 and 100, got ${percent}`);
+    }
+    return (FIXIDITY_ONE * BigInt(Math.floor(percent * 1_000_000))) / 100000000n;
+}
+/**
+ * Convert a unit fraction (0–1) to a Fixidity uint256 at 1e24 precision.
+ * @param fraction - Unit fraction, e.g. 0.5 for 50%
+ */
+export function toFixidity(fraction) {
+    if (!Number.isFinite(fraction) || fraction < 0 || fraction > 1) {
+        throw new Error(`Fixidity fraction must be between 0 and 1, got ${fraction}`);
+    }
+    return percentToFixidity(fraction * 100);
+}
+/** Convert Fixidity bigint back to a unit fraction. */
+export function fromFixidity(value) {
+    return Number(value) / Number(FIXIDITY_ONE);
+}
+//# sourceMappingURL=fixidity.js.map

package/build/src/utils/fixidity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixidity.js","sourceRoot":"","sources":["../../../src/utils/fixidity.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,IAAI,GAAG,CAAC;AAEvC,+DAA+D;AAC/D,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC,IAAI,OAAO,GAAG,GAAG,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CAAC,mDAAmD,OAAO,EAAE,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,CAAC,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,UAAY,CAAC;AACjF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CAAC,kDAAkD,QAAQ,EAAE,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,iBAAiB,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC;AAC3C,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;AAC9C,CAAC"}

package/build/tests/catalog/domains/chain-ext.js

@@ -32,6 +32,123 @@ export const governanceOperations = [
             assertHasKeys(result, ["proposal"]);
         },
     },
+    {
+        id: "governance.getLockedCeloBalance",
+        domain: "governance",
+        layer: "read",
+        sdk: {
+            invoke: (client, fx) => client.governance.getLockedCeloBalance(fx.wallet),
+        },
+        mcp: { tool: "get_locked_celo_balance", arguments: (fx) => ({ address: fx.wallet }) },
+        assert: (result) => assertHasKeys(result, ["totalLocked"]),
+    },
+    {
+        id: "governance.getPendingWithdrawals",
+        domain: "governance",
+        layer: "read",
+        sdk: {
+            invoke: (client, fx) => client.governance.getPendingWithdrawals(fx.wallet),
+        },
+        mcp: { tool: "get_pending_withdrawals", arguments: (fx) => ({ address: fx.wallet }) },
+        assert: (result) => assertHasKeys(result, ["withdrawals"]),
+    },
+    {
+        id: "governance.getVotableProposals",
+        domain: "governance",
+        layer: "read",
+        sdk: { invoke: (client) => client.governance.getVotableProposals() },
+        mcp: { tool: "get_votable_proposals", arguments: () => ({}) },
+        assert: (result) => assertHasKeys(result, ["proposals"]),
+    },
+    {
+        id: "governance.prepareLockCelo",
+        domain: "governance",
+        layer: "prepare",
+        sdk: {
+            invoke: (client, fx) => client.governance.prepareLockCelo(fx.wallet, "0.01"),
+        },
+        assert: (result) => assertHasKeys(result, ["steps"]),
+    },
+    {
+        id: "governance.executeLockCelo",
+        domain: "governance",
+        layer: "write",
+        requiresWrites: true,
+        requiresEnv: ["CELO_PRIVATE_KEY"],
+        skip: () => undefined,
+        sdk: {
+            invoke: async (client, fx) => {
+                const humanness = await client.humanness.checkHumanness(fx.wallet);
+                if (!humanness.isHumanOverall) {
+                    return { skipped: true, reason: "signer not humanness-verified" };
+                }
+                return client.governance.prepareLockCelo(fx.wallet, "0.1");
+            },
+        },
+        mcp: {
+            tool: "execute_lock_celo",
+            arguments: () => ({ amount: "0.1" }),
+        },
+        assert: (result) => {
+            if (typeof result === "object" && result && "skipped" in result)
+                return;
+            assertHasKeys(result, ["steps"]);
+        },
+    },
+    {
+        id: "governance.executeVote",
+        domain: "governance",
+        layer: "write",
+        requiresWrites: true,
+        requiresEnv: ["CELO_PRIVATE_KEY"],
+        skip: () => {
+            return "No deterministic Referendum proposal — check get_votable_proposals manually";
+        },
+        sdk: {
+            invoke: (client, fx) => client.governance.prepareVote(fx.wallet, 1, "Abstain"),
+        },
+        mcp: {
+            tool: "execute_vote",
+            arguments: () => ({ proposal_id: 1, vote: "Abstain" }),
+        },
+        assert: (result) => assertHasKeys(result, ["steps"]),
+    },
+    {
+        id: "governance.executeWithdrawCelo",
+        domain: "governance",
+        layer: "write",
+        requiresWrites: true,
+        requiresEnv: ["CELO_PRIVATE_KEY"],
+        skip: () => "Re-run after a pending withdrawal matures (3-day timelock)",
+        sdk: {
+            invoke: (client, fx) => client.governance.prepareWithdrawCelo(fx.wallet),
+        },
+        mcp: { tool: "execute_withdraw_celo", arguments: () => ({}) },
+        assert: (result) => assertHasKeys(result, ["steps"]),
+    },
+    {
+        id: "humanness.checkHumanness",
+        domain: "humanness",
+        layer: "read",
+        sdk: {
+            invoke: (client, fx) => client.humanness.checkHumanness(fx.wallet),
+        },
+        mcp: { tool: "check_humanness", arguments: (fx) => ({ address: fx.wallet }) },
+        assert: (result) => assertHasKeys(result, ["isHumanOverall"]),
+    },
+    {
+        id: "account.getAccountRegistration",
+        domain: "account",
+        layer: "read",
+        sdk: {
+            invoke: (client, fx) => client.account.getAccountRegistration(fx.wallet),
+        },
+        mcp: {
+            tool: "get_celo_account_registration",
+            arguments: (fx) => ({ address: fx.wallet }),
+        },
+        assert: (result) => assertHasKeys(result, ["isRegistered"]),
+    },
 ];
 export const stakingOperations = [
     {
@@ -110,6 +227,41 @@ export const stakingOperations = [
             assertHasKeys(result, ["totalVotes"]);
         },
     },
+    {
+        id: "staking.getDelegationInfo",
+        domain: "staking",
+        layer: "read",
+        sdk: {
+            invoke: (client, fx) => client.staking.getDelegationInfo(fx.wallet),
+        },
+        mcp: { tool: "get_delegation_info", arguments: (fx) => ({ address: fx.wallet }) },
+        assert: (result) => assertHasKeys(result, ["delegatees"]),
+    },
+    {
+        id: "staking.prepareStake",
+        domain: "staking",
+        layer: "prepare",
+        sdk: {
+            invoke: (client, fx) => client.staking.prepareStake(fx.wallet, fx.validatorGroup, "0.01"),
+        },
+        assert: (result) => assertHasKeys(result, ["steps"]),
+    },
+    {
+        id: "staking.executeActivateStake",
+        domain: "staking",
+        layer: "write",
+        requiresWrites: true,
+        requiresEnv: ["CELO_PRIVATE_KEY"],
+        skip: () => "Skip until an epoch boundary passes and pending stake is activatable",
+        sdk: {
+            invoke: (client, fx) => client.staking.prepareActivateStake(fx.wallet, fx.validatorGroup),
+        },
+        mcp: {
+            tool: "execute_activate_stake",
+            arguments: (fx) => ({ group_address: fx.validatorGroup }),
+        },
+        assert: (result) => assertHasKeys(result, ["steps"]),
+    },
 ];
 export const nftOperations = [
     {