@andrewkimjoseph/celina-sdk 0.9.8 → 0.9.9

package/build/tests/helpers/env.d.ts

@@ -0,0 +1,11 @@
+export interface TestConfig {
+    rpcUrl: string;
+    ethRpcUrl?: string;
+}
+export declare function hasCeloWallet(): boolean;
+export declare function hasSelfAgentKey(): boolean;
+export declare function allowsTestWrites(): boolean;
+export declare function allowsDestructiveTests(): boolean;
+export declare function getSignerAddress(): `0x${string}` | undefined;
+/** RPC URLs aligned with celina-mcp `loadConfig()`. */
+export declare function loadTestConfig(): TestConfig;

package/build/tests/helpers/env.js

@@ -0,0 +1,28 @@
+import { privateKeyToAccount } from "viem/accounts";
+export function hasCeloWallet() {
+    return Boolean(process.env.CELO_PRIVATE_KEY);
+}
+export function hasSelfAgentKey() {
+    return Boolean(process.env.SELF_AGENT_PRIVATE_KEY);
+}
+export function allowsTestWrites() {
+    return process.env.CELINA_TEST_WRITES === "1";
+}
+export function allowsDestructiveTests() {
+    return process.env.CELINA_TEST_DESTRUCTIVE === "1";
+}
+export function getSignerAddress() {
+    const key = process.env.CELO_PRIVATE_KEY;
+    if (!key) {
+        return undefined;
+    }
+    return privateKeyToAccount(key).address;
+}
+/** RPC URLs aligned with celina-mcp `loadConfig()`. */
+export function loadTestConfig() {
+    return {
+        rpcUrl: process.env.CELO_RPC_URL_MAINNET ?? "https://forno.celo.org",
+        ethRpcUrl: process.env.ETH_RPC_URL_MAINNET,
+    };
+}
+//# sourceMappingURL=env.js.map

package/build/tests/helpers/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../../tests/helpers/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAOpD,MAAM,UAAU,aAAa;IAC3B,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,GAAG,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,OAAO,CAAC,GAAG,CAAC,uBAAuB,KAAK,GAAG,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IACzC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,mBAAmB,CAAC,GAAoB,CAAC,CAAC,OAAO,CAAC;AAC3D,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,cAAc;IAC5B,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,wBAAwB;QACpE,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB;KAC3C,CAAC;AACJ,CAAC"}

package/build/tests/helpers/gating.d.ts

@@ -0,0 +1,3 @@
+import type { OperationSpec } from "../catalog/types.js";
+/** Returns a skip reason when the operation should not run, otherwise undefined. */
+export declare function getOperationSkipReason(spec: OperationSpec): string | undefined;

package/build/tests/helpers/gating.js

@@ -0,0 +1,23 @@
+import { allowsDestructiveTests, allowsTestWrites, hasCeloWallet, hasSelfAgentKey, } from "./env.js";
+const ENV_CHECKS = {
+    CELO_PRIVATE_KEY: hasCeloWallet,
+    SELF_AGENT_PRIVATE_KEY: hasSelfAgentKey,
+};
+/** Returns a skip reason when the operation should not run, otherwise undefined. */
+export function getOperationSkipReason(spec) {
+    if (spec.requiresDestructive && !allowsDestructiveTests()) {
+        return "Set CELINA_TEST_DESTRUCTIVE=1 to run destructive Self lifecycle tests";
+    }
+    if (spec.requiresWrites && !allowsTestWrites()) {
+        return "Set CELINA_TEST_WRITES=1 to run on-chain write tests";
+    }
+    if (spec.requiresEnv) {
+        for (const requirement of spec.requiresEnv) {
+            if (!ENV_CHECKS[requirement]()) {
+                return `Missing ${requirement}`;
+            }
+        }
+    }
+    return spec.skip?.() ?? undefined;
+}
+//# sourceMappingURL=gating.js.map

package/build/tests/helpers/gating.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gating.js","sourceRoot":"","sources":["../../../tests/helpers/gating.ts"],"names":[],"mappings":"AACA,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,aAAa,EACb,eAAe,GAChB,MAAM,UAAU,CAAC;AAElB,MAAM,UAAU,GAGZ;IACF,gBAAgB,EAAE,aAAa;IAC/B,sBAAsB,EAAE,eAAe;CACxC,CAAC;AAEF,oFAAoF;AACpF,MAAM,UAAU,sBAAsB,CAAC,IAAmB;IACxD,IAAI,IAAI,CAAC,mBAAmB,IAAI,CAAC,sBAAsB,EAAE,EAAE,CAAC;QAC1D,OAAO,uEAAuE,CAAC;IACjF,CAAC;IAED,IAAI,IAAI,CAAC,cAAc,IAAI,CAAC,gBAAgB,EAAE,EAAE,CAAC;QAC/C,OAAO,sDAAsD,CAAC;IAChE,CAAC;IAED,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAC3C,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,EAAE,CAAC;gBAC/B,OAAO,WAAW,WAAW,EAAE,CAAC;YAClC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC,IAAI,EAAE,EAAE,IAAI,SAAS,CAAC;AACpC,CAAC"}

package/build/tests/testing-entry.d.ts

@@ -0,0 +1,6 @@
+export type { EnvRequirement, OperationLayer, OperationSpec, } from "./catalog/types.js";
+export { MCP_OPERATIONS, MCP_TOOL_NAMES, OPERATIONS, SDK_OPERATIONS, } from "./catalog/operations.js";
+export { ALL_TOOL_DEFINITIONS, getMcpToolNames, getBrowserToolNames, } from "../src/tools/catalog.js";
+export { getMainnetFixtures, type MainnetFixtures } from "./fixtures/mainnet.js";
+export { allowsDestructiveTests, allowsTestWrites, getSignerAddress, hasCeloWallet, hasSelfAgentKey, loadTestConfig, type TestConfig, } from "./helpers/env.js";
+export { getOperationSkipReason } from "./helpers/gating.js";

package/build/tests/testing-entry.js

@@ -0,0 +1,6 @@
+export { MCP_OPERATIONS, MCP_TOOL_NAMES, OPERATIONS, SDK_OPERATIONS, } from "./catalog/operations.js";
+export { ALL_TOOL_DEFINITIONS, getMcpToolNames, getBrowserToolNames, } from "../src/tools/catalog.js";
+export { getMainnetFixtures } from "./fixtures/mainnet.js";
+export { allowsDestructiveTests, allowsTestWrites, getSignerAddress, hasCeloWallet, hasSelfAgentKey, loadTestConfig, } from "./helpers/env.js";
+export { getOperationSkipReason } from "./helpers/gating.js";
+//# sourceMappingURL=testing-entry.js.map

package/build/tests/testing-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing-entry.js","sourceRoot":"","sources":["../../tests/testing-entry.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,cAAc,EACd,cAAc,EACd,UAAU,EACV,cAAc,GACf,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAwB,MAAM,uBAAuB,CAAC;AACjF,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,cAAc,GAEf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andrewkimjoseph/celina-sdk",
-    "version": "0.9.8",
+  "version": "0.9.9",
   "description": "Celina SDK — Celo mainnet reads and unsigned transaction preparation for frontend apps.",
   "type": "module",
   "sideEffects": false,
@@ -13,9 +13,9 @@
       "default": "./build/index.js"
     },
     "./testing": {
-      "types": "./tests/testing-entry.ts",
-      "import": "./tests/testing-entry.ts",
-      "default": "./tests/testing-entry.ts"
+      "types": "./build/tests/testing-entry.d.ts",
+      "import": "./build/tests/testing-entry.js",
+      "default": "./build/tests/testing-entry.js"
     },
     "./tools": {
       "types": "./build/tools/index.d.ts",
@@ -40,16 +40,12 @@
   },
   "files": [
     "build/",
-    "tests/catalog/",
-    "tests/fixtures/",
-    "tests/helpers/",
-    "tests/testing-entry.ts",
     "README.md",
     "LICENSE"
   ],
   "scripts": {
     "prebuild": "node scripts/generate-mcp-analytics-map.mjs",
-    "build": "npm run prebuild && rm -rf build && tsc",
+    "build": "npm run prebuild && rm -rf build && tsc && tsc -p tsconfig.testing.json",
     "dev": "tsc --watch",
     "test": "vitest run",
     "test:unit": "vitest run --config vitest.unit.config.ts",

package/tests/README.md

@@ -1,78 +0,0 @@
-<p align="center">
-  <img src="../assets/celina-banner.png" alt="Celina — Give your LLM a wallet on Celo">
-</p>
-
-# Celina operations test framework
-
-Live Celo mainnet smoke tests driven by a single operation catalog in `tests/catalog/operations.ts`. Add one `OperationSpec` when you ship a new SDK method or MCP tool.
-
-## Commands
-
-```bash
-# celina-sdk
-npm test          # live mainnet SDK smoke (catalog)
-npm run test:unit # pure helpers (no RPC)
-
-# celina-mcp
-npm test          # build + live MCP smoke + registry parity
-npm run test:unit # MCP helper unit tests
-```
-
-## Environment matrix
-
-| Variable | Effect |
-|----------|--------|
-| *(none)* | Read-only mainnet smoke tests |
-| `CELO_RPC_URL_MAINNET` | Optional RPC override (default: `https://forno.celo.org`) |
-| `ETH_RPC_URL_MAINNET` | ENS resolution on Ethereum |
-| `CELO_PRIVATE_KEY` | Enables estimates and prepare flows that need a signer address |
-| `CELINA_TEST_WRITES=1` | **Plus** `CELO_PRIVATE_KEY`: runs on-chain writes (`send_token`, `execute_mento_fx`, Aave supply/withdraw) |
-| `SELF_AGENT_PRIVATE_KEY` | Self auth tools (`sign_self_request`, `authenticated_self_fetch`, `get_self_identity`) |
-| `CELINA_TEST_SELF_VERIFY=1` | **Plus** `SELF_AGENT_PRIVATE_KEY`: builds signed fixture for `verify_self_request` |
-| `CELINA_TEST_SELF_SESSION` | Poll a pending Self session via `check_self_registration` |
-| `CELINA_TEST_DESTRUCTIVE=1` | Self lifecycle mutations (`register_self_agent`, `refresh_self_proof`, `deregister_self_agent`) |
-
-Writes and destructive Self flows are **off by default** so `npm test` does not spend funds or mutate agent state accidentally.
-
-## Adding a new operation
-
-1. Implement the SDK service method in `src/services/` (if applicable).
-2. Add the MCP wrapper in `celina-mcp/src/tools/` (if exposed).
-3. Append one `OperationSpec` to `tests/catalog/domains/*.ts` (aggregated in `operations.ts`).
-4. Run `npm test` in `celina-sdk`, then `celina-mcp`.
-5. `registry-parity.test.ts` fails if an MCP tool lacks a catalog entry.
-
-`celina-mcp` imports the shared catalog via `@andrewkimjoseph/celina-sdk/testing` (published with the SDK package).
-
-### OperationSpec shape
-
-```ts
-{
-  id: "domain.methodName",
-  domain: "token",
-  layer: "read" | "write" | "prepare",
-  requiresEnv?: ["CELO_PRIVATE_KEY" | "SELF_AGENT_PRIVATE_KEY"],
-  requiresWrites?: true,       // needs CELINA_TEST_WRITES=1
-  requiresDestructive?: true,  // needs CELINA_TEST_DESTRUCTIVE=1
-  sdk?: { invoke(client, fixtures) { ... } },
-  mcp?: { tool: "snake_case_tool", arguments(fixtures) { ... } },
-  assert(result, fixtures) { ... },
-  skip?: () => string | undefined,
-}
-```
-
-At least one of `sdk` or `mcp` must be set. SDK-only prepare methods (no MCP tool yet) still belong in the catalog for SDK regression.
-
-**Naming:** `sdk.invoke` uses the **camelCase** TypeScript client API (`pageSize`, `tokenIn`, …). `mcp.arguments` must use **snake_case tool input keys only** (`page_size`, `token_in`, …) — never copy SDK option names into MCP arguments. Unit tests enforce this for every `MCP_OPERATIONS` entry.
-
-## Fixtures
-
-Stable mainnet constants live in `tests/fixtures/mainnet.ts`. A recent transaction hash is resolved once per process from the latest block.
-
-## Architecture
-
-```
-fixtures/mainnet.ts ──► catalog/operations.ts ──► sdk-operations.test.ts
-                                              └──► celina-mcp/mcp-tools.test.ts
-                                              └──► registry-parity.test.ts
-```

package/tests/catalog/domains/blockchain.ts

@@ -1,133 +0,0 @@
-import { expect } from "vitest";
-import type { OperationSpec } from "../types.js";
-import { assertArray, assertHasKeys } from "../../helpers/assert.js";
-
-function expectNumberLike(value: unknown): void {
-  expect(value).toBeDefined();
-  expect(Number(value)).not.toBeNaN();
-}
-
-export const blockchainOperations: OperationSpec[] = [
-  {
-    id: "blockchain.getNetworkStatus",
-    domain: "blockchain",
-    layer: "read",
-    sdk: {
-      invoke: (client) => client.blockchain.getNetworkStatus(),
-    },
-    mcp: {
-      tool: "get_network_status",
-      arguments: () => ({}),
-    },
-    assert: (result) => {
-      const obj = assertHasKeys(result, ["network", "chainId", "blockNumber"]);
-      expectNumberLike(obj.blockNumber);
-    },
-  },
-  {
-    id: "blockchain.getBlock",
-    domain: "blockchain",
-    layer: "read",
-    sdk: {
-      invoke: (client, fx) =>
-        client.blockchain.getBlock(Number(fx.latestBlockNumber)),
-    },
-    mcp: {
-      tool: "get_block",
-      arguments: (fx) => ({
-        block_id: Number(fx.latestBlockNumber),
-      }),
-    },
-    assert: (result) => {
-      assertHasKeys(result, ["number", "hash"]);
-    },
-  },
-  {
-    id: "blockchain.getBlockWithTransactions",
-    domain: "blockchain",
-    layer: "read",
-    sdk: {
-      invoke: (client, fx) =>
-        client.blockchain.getBlock(Number(fx.latestBlockNumber), {
-          includeTransactions: true,
-        }),
-    },
-    mcp: {
-      tool: "get_block",
-      arguments: (fx) => ({
-        block_id: Number(fx.latestBlockNumber),
-        include_transactions: true,
-      }),
-    },
-    assert: (result) => {
-      const obj = assertHasKeys(result, ["number", "hash", "transactions"]);
-      expect(() => JSON.stringify(result)).not.toThrow();
-      const txs = assertArray(obj.transactions);
-      expect(txs.length).toBeGreaterThan(0);
-    },
-  },
-  {
-    id: "blockchain.getLatestBlocks",
-    domain: "blockchain",
-    layer: "read",
-    sdk: {
-      invoke: (client) => client.blockchain.getLatestBlocks(3, 0),
-    },
-    mcp: {
-      tool: "get_latest_blocks",
-      arguments: () => ({ count: 3, offset: 0 }),
-    },
-    assert: (result) => {
-      const blocks = assertArray(result);
-      expect(blocks.length).toBeGreaterThan(0);
-    },
-  },
-  {
-    id: "blockchain.getTransaction",
-    domain: "blockchain",
-    layer: "read",
-    sdk: {
-      invoke: (client, fx) => client.blockchain.getTransaction(fx.knownTxHash),
-    },
-    mcp: {
-      tool: "get_transaction",
-      arguments: (fx) => ({ hash: fx.knownTxHash }),
-    },
-    assert: (result) => {
-      assertHasKeys(result, ["hash", "from"]);
-    },
-  },
-  {
-    id: "account.getAccount",
-    domain: "blockchain",
-    layer: "read",
-    sdk: {
-      invoke: (client, fx) => client.account.getAccount(fx.wallet),
-    },
-    mcp: {
-      tool: "get_account",
-      arguments: (fx) => ({ address: fx.wallet }),
-    },
-    assert: (result) => {
-      assertHasKeys(result, ["address", "balanceWei"]);
-    },
-  },
-  {
-    id: "account.getWalletAddress",
-    domain: "blockchain",
-    layer: "read",
-    requiresEnv: ["CELO_PRIVATE_KEY"],
-    mcp: {
-      tool: "get_wallet_address",
-      arguments: () => ({}),
-    },
-    assert: (result, fx) => {
-      const obj = assertHasKeys(result, ["wallet_address", "has_wallet", "source"]);
-      expect(obj.has_wallet).toBe(true);
-      expect(String(obj.wallet_address).toLowerCase()).toBe(
-        fx.wallet.toLowerCase(),
-      );
-      expect(obj.source).toBe("CELO_PRIVATE_KEY");
-    },
-  },
-];

package/tests/catalog/domains/chain-ext.ts

@@ -1,219 +0,0 @@
-import { expect } from "vitest";
-import type { OperationSpec } from "../types.js";
-import { assertArray, assertHasKeys } from "../../helpers/assert.js";
-
-export const governanceOperations: OperationSpec[] = [
-  {
-    id: "governance.getGovernanceProposals",
-    domain: "governance",
-    layer: "read",
-    sdk: {
-      invoke: (client) =>
-        client.governance.getGovernanceProposals({ page: 1, pageSize: 5 }),
-    },
-    mcp: {
-      tool: "get_governance_proposals",
-      arguments: () => ({ page: 1, page_size: 5 }),
-    },
-    assert: (result) => {
-      const obj = assertHasKeys(result, ["proposals", "pagination"]);
-      expect(Array.isArray(obj.proposals)).toBe(true);
-    },
-  },
-  {
-    id: "governance.getProposalDetails",
-    domain: "governance",
-    layer: "read",
-    sdk: {
-      invoke: (client, fx) =>
-        client.governance.getProposalDetails(fx.proposalId),
-    },
-    mcp: {
-      tool: "get_proposal_details",
-      arguments: (fx) => ({ proposal_id: fx.proposalId }),
-    },
-    assert: (result) => {
-      assertHasKeys(result, ["proposal"]);
-    },
-  },
-];
-
-export const stakingOperations: OperationSpec[] = [
-  {
-    id: "staking.getStakingBalances",
-    domain: "staking",
-    layer: "read",
-    sdk: {
-      invoke: (client, fx) => client.staking.getStakingBalances(fx.wallet),
-    },
-    mcp: {
-      tool: "get_staking_balances",
-      arguments: (fx) => ({ address: fx.wallet }),
-    },
-    assert: (result) => {
-      assertHasKeys(result, ["address", "groups"]);
-    },
-  },
-  {
-    id: "staking.getActivatableStakes",
-    domain: "staking",
-    layer: "read",
-    sdk: {
-      invoke: (client, fx) => client.staking.getActivatableStakes(fx.wallet),
-    },
-    mcp: {
-      tool: "get_activatable_stakes",
-      arguments: (fx) => ({ address: fx.wallet }),
-    },
-    assert: (result) => {
-      assertHasKeys(result, ["activatableGroups"]);
-    },
-  },
-  {
-    id: "staking.getValidatorGroups",
-    domain: "staking",
-    layer: "read",
-    sdk: {
-      invoke: (client) =>
-        client.staking.getValidatorGroups({ page: 1, pageSize: 5 }),
-    },
-    mcp: {
-      tool: "get_validator_groups",
-      arguments: () => ({ page: 1, page_size: 5 }),
-    },
-    assert: (result) => {
-      const obj = assertHasKeys(result, ["groups"]);
-      assertArray(obj.groups);
-    },
-  },
-  {
-    id: "staking.getValidatorGroupDetails",
-    domain: "staking",
-    layer: "read",
-    sdk: {
-      invoke: (client, fx) =>
-        client.staking.getValidatorGroupDetails(fx.validatorGroup),
-    },
-    mcp: {
-      tool: "get_validator_group_details",
-      arguments: (fx) => ({ group_address: fx.validatorGroup }),
-    },
-    assert: (result) => {
-      assertHasKeys(result, ["address", "name"]);
-    },
-  },
-  {
-    id: "staking.getTotalStakingInfo",
-    domain: "staking",
-    layer: "read",
-    sdk: {
-      invoke: (client) => client.staking.getTotalStakingInfo(),
-    },
-    mcp: {
-      tool: "get_total_staking_info",
-      arguments: () => ({}),
-    },
-    assert: (result) => {
-      assertHasKeys(result, ["totalVotes"]);
-    },
-  },
-];
-
-export const nftOperations: OperationSpec[] = [
-  {
-    id: "nft.getNftInfo",
-    domain: "nft",
-    layer: "read",
-    sdk: {
-      invoke: (client, fx) =>
-        client.nft.getNftInfo(fx.saidContract, fx.saidTokenId),
-    },
-    mcp: {
-      tool: "get_nft_info",
-      arguments: (fx) => ({
-        contract_address: fx.saidContract,
-        token_id: fx.saidTokenId,
-      }),
-    },
-    assert: (result) => {
-      assertHasKeys(result, ["contractAddress", "tokenId"]);
-    },
-  },
-  {
-    id: "nft.getNftBalance",
-    domain: "nft",
-    layer: "read",
-    sdk: {
-      invoke: (client, fx) =>
-        client.nft.getNftBalance(fx.saidContract, fx.saidOwner),
-    },
-    mcp: {
-      tool: "get_nft_balance",
-      arguments: (fx) => ({
-        contract_address: fx.saidContract,
-        address: fx.saidOwner,
-      }),
-    },
-    assert: (result) => {
-      assertHasKeys(result, ["balance"]);
-    },
-  },
-];
-
-export const contractOperations: OperationSpec[] = [
-  {
-    id: "contract.callFunction",
-    domain: "contract",
-    layer: "read",
-    sdk: {
-      invoke: (client, fx) =>
-        client.contract.callFunction({
-          contractAddress: fx.usdm,
-          abi: fx.erc20SymbolAbi,
-          functionName: "symbol",
-          functionArgs: [],
-        }),
-    },
-    mcp: {
-      tool: "call_contract_function",
-      arguments: (fx) => ({
-        contract_address: fx.usdm,
-        abi: fx.erc20SymbolAbi,
-        function_name: "symbol",
-        function_args: [],
-      }),
-    },
-    assert: (result) => {
-      assertHasKeys(result, ["result"]);
-    },
-  },
-  {
-    id: "contract.estimateGas",
-    domain: "contract",
-    layer: "read",
-    requiresEnv: ["CELO_PRIVATE_KEY"],
-    sdk: {
-      invoke: (client, fx) =>
-        client.contract.estimateGas({
-          contractAddress: fx.usdm,
-          abi: fx.erc20SymbolAbi,
-          functionName: "symbol",
-          functionArgs: [],
-          fromAddress: fx.signerAddress ?? fx.wallet,
-        }),
-    },
-    mcp: {
-      tool: "estimate_contract_gas",
-      arguments: (fx) => ({
-        contract_address: fx.usdm,
-        abi: fx.erc20SymbolAbi,
-        function_name: "symbol",
-        function_args: [],
-        from_address: fx.signerAddress ?? fx.wallet,
-      }),
-    },
-    assert: (result) => {
-      assertHasKeys(result, ["gasEstimate"]);
-    },
-  },
-];