@andrewkimjoseph/celina-sdk 0.9.8 → 0.10.0

package/build/src/services/aave.service.js.map

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

package/build/src/services/account.service.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Account reads: native CELO balance, transaction nonce, and contract detection.
+ */
+import type { CeloClientFactory } from "../clients/celo-client.js";
+/** CELO mainnet account snapshot for a wallet or contract address. */
+export declare class AccountService {
+    private readonly clientFactory;
+    constructor(clientFactory: CeloClientFactory);
+    /**
+     * Fetch CELO balance, nonce, and whether the address has contract bytecode.
+     * @param address - Wallet or contract address on Celo mainnet
+     * @returns Balance in wei and CELO, current nonce, and `isContract` flag
+     */
+    getAccount(address: `0x${string}`): Promise<{
+        address: `0x${string}`;
+        network: string;
+        balanceWei: string;
+        balanceCelo: number;
+        nonce: number;
+        isContract: boolean;
+    }>;
+}

package/build/src/services/account.service.js

@@ -0,0 +1,29 @@
+/** CELO mainnet account snapshot for a wallet or contract address. */
+export class AccountService {
+    clientFactory;
+    constructor(clientFactory) {
+        this.clientFactory = clientFactory;
+    }
+    /**
+     * Fetch CELO balance, nonce, and whether the address has contract bytecode.
+     * @param address - Wallet or contract address on Celo mainnet
+     * @returns Balance in wei and CELO, current nonce, and `isContract` flag
+     */
+    async getAccount(address) {
+        const { public: client } = this.clientFactory.getClients();
+        const [balance, nonce, bytecode] = await Promise.all([
+            client.getBalance({ address }),
+            client.getTransactionCount({ address }),
+            client.getCode({ address }),
+        ]);
+        return {
+            address,
+            network: "mainnet",
+            balanceWei: balance.toString(),
+            balanceCelo: Number(balance) / 1e18,
+            nonce,
+            isContract: bytecode !== undefined && bytecode !== "0x",
+        };
+    }
+}
+//# sourceMappingURL=account.service.js.map

package/build/src/services/account.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.service.js","sourceRoot":"","sources":["../../../src/services/account.service.ts"],"names":[],"mappings":"AAKA,sEAAsE;AACtE,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,aAAgC;QAAhC,kBAAa,GAAb,aAAa,CAAmB;IAAG,CAAC;IAEjE;;;;OAIG;IACH,KAAK,CAAC,UAAU,CAAC,OAAsB;QACrC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,CAAC;QAC3D,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACnD,MAAM,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC;YAC9B,MAAM,CAAC,mBAAmB,CAAC,EAAE,OAAO,EAAE,CAAC;YACvC,MAAM,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;SAC5B,CAAC,CAAC;QAEH,OAAO;YACL,OAAO;YACP,OAAO,EAAE,SAAS;YAClB,UAAU,EAAE,OAAO,CAAC,QAAQ,EAAE;YAC9B,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI;YACnC,KAAK;YACL,UAAU,EAAE,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,IAAI;SACxD,CAAC;IACJ,CAAC;CACF"}

package/build/src/services/agentkarma.service.d.ts

@@ -0,0 +1,89 @@
+/**
+ * AgentKarma reputation adapter (read-only).
+ *
+ * AgentKarma (https://agentkarma.io) is the reputation layer for autonomous
+ * on-chain agents. This service is a thin, optional ecosystem adapter over
+ * `@agentkarma/sdk`: it reads Provider/Consumer karma and ERC-8004 Celo agent
+ * data, and evaluates a local trust policy. It is pinned to Celo — the chain
+ * Celina operates on.
+ *
+ * Boundaries (mirrors the AgentKarma SDK's own contract):
+ *  - read-only: never signs, never executes a transaction, never holds custody.
+ *  - non-routing: never proxies an agent call; it only reads reputation.
+ *  - no private keys / no env requirement.
+ *
+ * It is intentionally NOT wrapped in Celina's Amplitude analytics proxy: this
+ * is an external reputation service, not a Celo on-chain read Celina tracks.
+ */
+import { type CeloAgentSnapshot, type ClientConfig, type KarmaFaceData, type KarmaSnapshot, type TrustDecision, type TrustPolicy } from "@agentkarma/sdk";
+import { type AgentKarmaToolDescriptor } from "@agentkarma/sdk/tools";
+/** Config for the AgentKarma adapter. Defaults to https://agentkarma.io. */
+export type AgentKarmaServiceConfig = ClientConfig;
+/** Which karma face(s) to read. A wallet always carries both. */
+export type AgentKarmaFace = "provider" | "consumer" | "both";
+/** Options for a karma read. */
+export interface GetKarmaOptions {
+    /** Face to read. Defaults to `"both"`. */
+    face?: AgentKarmaFace;
+}
+/** Result of a local counterparty trust evaluation. */
+export interface CounterpartyDecision {
+    /** Always `"celo"` — this adapter is Celo-pinned. */
+    chain: "celo";
+    /** The wallet that was evaluated. */
+    wallet: string;
+    /** Explainable allow/deny from the local policy (no network, pure function). */
+    decision: TrustDecision;
+    /** The karma snapshot the decision was computed from. */
+    snapshot: KarmaSnapshot;
+}
+/**
+ * Read-only AgentKarma reputation insight for Celo agents.
+ *
+ * Exposed from `createCelinaClient()` as `client.agentKarma`.
+ */
+export declare class AgentKarmaService {
+    private readonly client;
+    /** This adapter only ever talks to AgentKarma on the Celo chain. */
+    readonly chain: "celo";
+    constructor(config?: AgentKarmaServiceConfig);
+    /** AgentKarma API base URL the adapter reads from. */
+    get baseUrl(): string;
+    /** The canonical `@agentkarma/sdk/tools` descriptors this adapter draws from. */
+    get catalog(): readonly AgentKarmaToolDescriptor[];
+    /**
+     * Execute a tool from the canonical `@agentkarma/sdk/tools` catalog,
+     * Celo-pinned. This is how Celina consumes the SHARED tool catalog instead of
+     * re-implementing each AgentKarma call: the names, schemas, arg-coercion, and
+     * handler logic all live in `@agentkarma/sdk`. `chain` is forced to `'celo'`.
+     * @param name - A catalog tool name (e.g. `get_karma`, `get_celo_agent`).
+     * @param input - Tool arguments; `chain` is overridden to `'celo'`.
+     */
+    runCatalogTool(name: string, input?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Provider + Consumer karma for a Celo agent wallet. Always queries Celo.
+     * Routed through the shared catalog's `get_karma` tool.
+     * @param wallet - Celo `0x` agent/wallet address to look up.
+     * @param options - Optional face selector (defaults to `"both"`).
+     */
+    getKarma(wallet: string, options?: GetKarmaOptions): Promise<KarmaSnapshot>;
+    /**
+     * Resolve a Celo ERC-8004 agent (IdentityRegistry + ReputationRegistry)
+     * and its AgentKarma reputation by numeric agent ID. Routed through the
+     * shared catalog's `get_celo_agent` tool.
+     * @param agentId - Positive integer ERC-8004 agent ID on Celo.
+     */
+    getCeloAgent(agentId: number): Promise<CeloAgentSnapshot>;
+    /**
+     * Fetch Celo karma and run a local, explainable trust policy against it.
+     * Pure evaluation — no routing, no signing, no side effects.
+     *
+     * Always fetches BOTH faces so whichever face `policy.face` scores on
+     * (`provider` by default) is guaranteed present — there is intentionally no
+     * separate fetch-face knob to drift out of sync with the scored face.
+     * @param wallet - Celo `0x` counterparty address.
+     * @param policy - Local trust policy (face, minScore, requireReceiptBacked, …).
+     */
+    evaluateCounterparty(wallet: string, policy?: TrustPolicy): Promise<CounterpartyDecision>;
+}
+export type { CeloAgentSnapshot, KarmaFaceData, KarmaSnapshot, TrustDecision, TrustPolicy, };

package/build/src/services/agentkarma.service.js

@@ -0,0 +1,102 @@
+/**
+ * AgentKarma reputation adapter (read-only).
+ *
+ * AgentKarma (https://agentkarma.io) is the reputation layer for autonomous
+ * on-chain agents. This service is a thin, optional ecosystem adapter over
+ * `@agentkarma/sdk`: it reads Provider/Consumer karma and ERC-8004 Celo agent
+ * data, and evaluates a local trust policy. It is pinned to Celo — the chain
+ * Celina operates on.
+ *
+ * Boundaries (mirrors the AgentKarma SDK's own contract):
+ *  - read-only: never signs, never executes a transaction, never holds custody.
+ *  - non-routing: never proxies an agent call; it only reads reputation.
+ *  - no private keys / no env requirement.
+ *
+ * It is intentionally NOT wrapped in Celina's Amplitude analytics proxy: this
+ * is an external reputation service, not a Celo on-chain read Celina tracks.
+ */
+import { createAgentKarmaClient, evaluateTrust, } from "@agentkarma/sdk";
+import { agentKarmaTools, runAgentKarmaTool, } from "@agentkarma/sdk/tools";
+const CELINA_USER_AGENT = "@andrewkimjoseph/celina-sdk (+@agentkarma/sdk adapter)";
+/** Celo (EVM) address shape. AgentKarma keys Celo agents by 0x address. */
+const CELO_ADDRESS_RE = /^0x[a-fA-F0-9]{40}$/;
+function assertCeloAddress(wallet) {
+    if (typeof wallet !== "string" || !CELO_ADDRESS_RE.test(wallet)) {
+        throw new Error(`AgentKarma: wallet must be a Celo 0x address (40 hex chars), got "${wallet}"`);
+    }
+}
+/**
+ * Read-only AgentKarma reputation insight for Celo agents.
+ *
+ * Exposed from `createCelinaClient()` as `client.agentKarma`.
+ */
+export class AgentKarmaService {
+    client;
+    /** This adapter only ever talks to AgentKarma on the Celo chain. */
+    chain = "celo";
+    constructor(config = {}) {
+        this.client = createAgentKarmaClient({
+            ...config,
+            userAgent: config.userAgent ?? CELINA_USER_AGENT,
+        });
+    }
+    /** AgentKarma API base URL the adapter reads from. */
+    get baseUrl() {
+        return this.client.baseUrl;
+    }
+    /** The canonical `@agentkarma/sdk/tools` descriptors this adapter draws from. */
+    get catalog() {
+        return agentKarmaTools;
+    }
+    /**
+     * Execute a tool from the canonical `@agentkarma/sdk/tools` catalog,
+     * Celo-pinned. This is how Celina consumes the SHARED tool catalog instead of
+     * re-implementing each AgentKarma call: the names, schemas, arg-coercion, and
+     * handler logic all live in `@agentkarma/sdk`. `chain` is forced to `'celo'`.
+     * @param name - A catalog tool name (e.g. `get_karma`, `get_celo_agent`).
+     * @param input - Tool arguments; `chain` is overridden to `'celo'`.
+     */
+    runCatalogTool(name, input = {}) {
+        return runAgentKarmaTool(this.client, name, { ...input, chain: "celo" });
+    }
+    /**
+     * Provider + Consumer karma for a Celo agent wallet. Always queries Celo.
+     * Routed through the shared catalog's `get_karma` tool.
+     * @param wallet - Celo `0x` agent/wallet address to look up.
+     * @param options - Optional face selector (defaults to `"both"`).
+     */
+    async getKarma(wallet, options = {}) {
+        assertCeloAddress(wallet);
+        return this.runCatalogTool("get_karma", {
+            wallet,
+            face: options.face ?? "both",
+        });
+    }
+    /**
+     * Resolve a Celo ERC-8004 agent (IdentityRegistry + ReputationRegistry)
+     * and its AgentKarma reputation by numeric agent ID. Routed through the
+     * shared catalog's `get_celo_agent` tool.
+     * @param agentId - Positive integer ERC-8004 agent ID on Celo.
+     */
+    async getCeloAgent(agentId) {
+        return this.runCatalogTool("get_celo_agent", {
+            agent_id: agentId,
+        });
+    }
+    /**
+     * Fetch Celo karma and run a local, explainable trust policy against it.
+     * Pure evaluation — no routing, no signing, no side effects.
+     *
+     * Always fetches BOTH faces so whichever face `policy.face` scores on
+     * (`provider` by default) is guaranteed present — there is intentionally no
+     * separate fetch-face knob to drift out of sync with the scored face.
+     * @param wallet - Celo `0x` counterparty address.
+     * @param policy - Local trust policy (face, minScore, requireReceiptBacked, …).
+     */
+    async evaluateCounterparty(wallet, policy = {}) {
+        const snapshot = await this.getKarma(wallet, { face: "both" });
+        const decision = evaluateTrust(snapshot, policy);
+        return { chain: "celo", wallet, decision, snapshot };
+    }
+}
+//# sourceMappingURL=agentkarma.service.js.map

package/build/src/services/agentkarma.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentkarma.service.js","sourceRoot":"","sources":["../../../src/services/agentkarma.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EACL,sBAAsB,EACtB,aAAa,GAQd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,eAAe,EACf,iBAAiB,GAElB,MAAM,uBAAuB,CAAC;AA0B/B,MAAM,iBAAiB,GAAG,wDAAwD,CAAC;AAEnF,2EAA2E;AAC3E,MAAM,eAAe,GAAG,qBAAqB,CAAC;AAE9C,SAAS,iBAAiB,CAAC,MAAc;IACvC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,KAAK,CACb,qEAAqE,MAAM,GAAG,CAC/E,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAO,iBAAiB;IACX,MAAM,CAAmB;IAE1C,oEAAoE;IAC3D,KAAK,GAAG,MAAe,CAAC;IAEjC,YAAY,SAAkC,EAAE;QAC9C,IAAI,CAAC,MAAM,GAAG,sBAAsB,CAAC;YACnC,GAAG,MAAM;YACT,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,iBAAiB;SACjD,CAAC,CAAC;IACL,CAAC;IAED,sDAAsD;IACtD,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;IAC7B,CAAC;IAED,iFAAiF;IACjF,IAAI,OAAO;QACT,OAAO,eAAe,CAAC;IACzB,CAAC;IAED;;;;;;;OAOG;IACH,cAAc,CACZ,IAAY,EACZ,QAAiC,EAAE;QAEnC,OAAO,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CACZ,MAAc,EACd,UAA2B,EAAE;QAE7B,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE;YACtC,MAAM;YACN,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,MAAM;SAC7B,CAA2B,CAAC;IAC/B,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,YAAY,CAAC,OAAe;QAChC,OAAO,IAAI,CAAC,cAAc,CAAC,gBAAgB,EAAE;YAC3C,QAAQ,EAAE,OAAO;SAClB,CAA+B,CAAC;IACnC,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,oBAAoB,CACxB,MAAc,EACd,SAAsB,EAAE;QAExB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAC/D,MAAM,QAAQ,GAAG,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACjD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACvD,CAAC;CACF"}

package/build/src/services/blockchain.service.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Chain reads: network status, blocks, and transaction lookups on Celo mainnet.
+ */
+import type { CeloClientFactory } from "../clients/celo-client.js";
+/** Celo mainnet block and transaction queries. */
+export declare class BlockchainService {
+    private readonly clientFactory;
+    constructor(clientFactory: CeloClientFactory);
+    /**
+     * Celo mainnet chain id, latest block number, and current gas price.
+     * @returns Network metadata including `chainId`, `blockNumber`, and `gasPriceWei`
+     */
+    getNetworkStatus(): Promise<{
+        network: string;
+        chainId: number;
+        blockNumber: string;
+        gasPriceWei: string;
+    }>;
+    /**
+     * Fetch a block by number, hash, or tag.
+     * @param blockId - Block number, hash, `latest`, or `pending`
+     * @param options.includeTransactions - When true, include full transaction objects
+     * @returns Block header fields and optional transaction list
+     * @throws When the block is not found
+     */
+    getBlock(blockId: number | string | "latest" | "pending", options?: {
+        includeTransactions?: boolean;
+    }): Promise<{
+        number: string | undefined;
+        hash: `0x${string}` | null;
+        timestamp: string;
+        parentHash: `0x${string}`;
+        gasUsed: string;
+        gasLimit: string;
+        gasUtilization: number;
+        miner: `0x${string}`;
+        transactionCount: number;
+        transactions: (`0x${string}` | {
+            hash: `0x${string}`;
+            from: `0x${string}`;
+            to: `0x${string}` | null;
+            value: string;
+            valueCelo: number;
+            nonce: number;
+            gas: string;
+            gasPrice: string | undefined;
+            gasPriceGwei: number | undefined;
+            input: `0x${string}`;
+            blockNumber: string | undefined;
+            transactionIndex: number | null | undefined;
+            type: string | undefined;
+        })[] | undefined;
+    }>;
+    /**
+     * List recent blocks ending at the chain tip (newest last in the array).
+     * @param count - Number of blocks to return (1–100, default 5)
+     * @param offset - Skip this many blocks from the tip before collecting
+     * @returns Summary fields per block (no full transaction payloads)
+     */
+    getLatestBlocks(count?: number, offset?: number): Promise<{
+        number: string;
+        hash: `0x${string}`;
+        timestamp: string;
+        transactionCount: number;
+        gasUsed: string;
+        gasLimit: string;
+        gasUtilization: number;
+    }[]>;
+    /**
+     * Fetch a transaction and its receipt by hash.
+     * @param hash - Transaction hash
+     * @returns Transaction fields, gas efficiency, and receipt status when mined
+     * @throws When the transaction is not found
+     */
+    getTransaction(hash: `0x${string}`): Promise<{
+        hash: `0x${string}`;
+        from: `0x${string}`;
+        to: `0x${string}` | null;
+        value: string;
+        valueCelo: number;
+        nonce: number;
+        gas: string;
+        gasPrice: string | undefined;
+        gasPriceGwei: number | undefined;
+        input: `0x${string}`;
+        blockNumber: string | undefined;
+        transactionIndex: number | null | undefined;
+        type: string | undefined;
+    } | {
+        status?: string | undefined;
+        gasUsed: string;
+        gasEfficiency: number;
+        hash: `0x${string}`;
+        from: `0x${string}`;
+        to: `0x${string}` | null;
+        value: string;
+        valueCelo: number;
+        nonce: number;
+        gas: string;
+        gasPrice: string | undefined;
+        gasPriceGwei: number | undefined;
+        input: `0x${string}`;
+        blockNumber: string | undefined;
+        transactionIndex: number | null | undefined;
+        type: string | undefined;
+    }>;
+}

package/build/src/services/blockchain.service.js

@@ -0,0 +1,151 @@
+function serializeTransactionSummary(tx, extras) {
+    const base = {
+        hash: tx.hash,
+        from: tx.from,
+        to: tx.to,
+        value: tx.value.toString(),
+        valueCelo: Number(tx.value) / 1e18,
+        nonce: tx.nonce,
+        gas: tx.gas.toString(),
+        gasPrice: tx.gasPrice?.toString(),
+        gasPriceGwei: tx.gasPrice ? Number(tx.gasPrice) / 1e9 : undefined,
+        input: tx.input,
+        blockNumber: tx.blockNumber?.toString(),
+        transactionIndex: tx.transactionIndex,
+        type: tx.type,
+    };
+    if (!extras) {
+        return base;
+    }
+    const gasEfficiency = tx.gas > 0n
+        ? Number((extras.gasUsed * 10000n) / tx.gas) / 100
+        : 0;
+    return {
+        ...base,
+        gasUsed: extras.gasUsed.toString(),
+        gasEfficiency,
+        ...(extras.status !== undefined ? { status: extras.status } : {}),
+    };
+}
+/** Celo mainnet block and transaction queries. */
+export class BlockchainService {
+    clientFactory;
+    constructor(clientFactory) {
+        this.clientFactory = clientFactory;
+    }
+    /**
+     * Celo mainnet chain id, latest block number, and current gas price.
+     * @returns Network metadata including `chainId`, `blockNumber`, and `gasPriceWei`
+     */
+    async getNetworkStatus() {
+        const { public: client } = this.clientFactory.getClients();
+        const [chainId, blockNumber, gasPrice] = await Promise.all([
+            client.getChainId(),
+            client.getBlockNumber(),
+            client.getGasPrice(),
+        ]);
+        return {
+            network: "mainnet",
+            chainId,
+            blockNumber: blockNumber.toString(),
+            gasPriceWei: gasPrice.toString(),
+        };
+    }
+    /**
+     * Fetch a block by number, hash, or tag.
+     * @param blockId - Block number, hash, `latest`, or `pending`
+     * @param options.includeTransactions - When true, include full transaction objects
+     * @returns Block header fields and optional transaction list
+     * @throws When the block is not found
+     */
+    async getBlock(blockId, options) {
+        const { public: client } = this.clientFactory.getClients();
+        const includeTransactions = options?.includeTransactions ?? false;
+        const blockParams = typeof blockId === "number"
+            ? {
+                blockNumber: BigInt(blockId),
+                includeTransactions,
+            }
+            : blockId === "latest" || blockId === "pending"
+                ? {
+                    blockTag: blockId,
+                    includeTransactions,
+                }
+                : {
+                    blockHash: blockId,
+                    includeTransactions,
+                };
+        const block = await client.getBlock(blockParams);
+        if (!block) {
+            throw new Error(`Block not found: ${blockId}`);
+        }
+        const gasUtilization = block.gasLimit > 0n
+            ? Number((block.gasUsed * 10000n) / block.gasLimit) / 100
+            : 0;
+        return {
+            number: block.number?.toString(),
+            hash: block.hash,
+            timestamp: block.timestamp.toString(),
+            parentHash: block.parentHash,
+            gasUsed: block.gasUsed.toString(),
+            gasLimit: block.gasLimit.toString(),
+            gasUtilization,
+            miner: block.miner,
+            transactionCount: block.transactions.length,
+            transactions: includeTransactions
+                ? block.transactions.map((tx) => typeof tx === "string"
+                    ? tx
+                    : serializeTransactionSummary(tx))
+                : undefined,
+        };
+    }
+    /**
+     * List recent blocks ending at the chain tip (newest last in the array).
+     * @param count - Number of blocks to return (1–100, default 5)
+     * @param offset - Skip this many blocks from the tip before collecting
+     * @returns Summary fields per block (no full transaction payloads)
+     */
+    async getLatestBlocks(count = 5, offset = 0) {
+        const { public: client } = this.clientFactory.getClients();
+        const latest = await client.getBlockNumber();
+        const safeCount = Math.min(Math.max(count, 1), 100);
+        const safeOffset = Math.max(offset, 0);
+        const start = latest - BigInt(safeOffset + safeCount - 1);
+        const blocks = await Promise.all(Array.from({ length: safeCount }, (_, index) => client.getBlock({ blockNumber: start + BigInt(index) })));
+        return blocks.filter(Boolean).map((block) => {
+            const gasUtilization = block.gasLimit > 0n
+                ? Number((block.gasUsed * 10000n) / block.gasLimit) / 100
+                : 0;
+            return {
+                number: block.number?.toString(),
+                hash: block.hash,
+                timestamp: block.timestamp.toString(),
+                transactionCount: block.transactions.length,
+                gasUsed: block.gasUsed.toString(),
+                gasLimit: block.gasLimit.toString(),
+                gasUtilization,
+            };
+        });
+    }
+    /**
+     * Fetch a transaction and its receipt by hash.
+     * @param hash - Transaction hash
+     * @returns Transaction fields, gas efficiency, and receipt status when mined
+     * @throws When the transaction is not found
+     */
+    async getTransaction(hash) {
+        const { public: client } = this.clientFactory.getClients();
+        const [tx, receipt] = await Promise.all([
+            client.getTransaction({ hash }),
+            client.getTransactionReceipt({ hash }),
+        ]);
+        if (!tx) {
+            throw new Error(`Transaction not found: ${hash}`);
+        }
+        return serializeTransactionSummary(tx, {
+            gasUsed: receipt?.gasUsed ?? 0n,
+            status: receipt?.status,
+        });
+    }
+}
+//# sourceMappingURL=blockchain.service.js.map

package/build/src/services/blockchain.service.js.map

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

package/build/src/services/contract.service.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Generic contract reads and gas estimates — caller supplies the ABI.
+ */
+import { type Abi } from "viem";
+import type { CeloClientFactory } from "../clients/celo-client.js";
+/** Parameters for a read-only or gas-estimated contract call on Celo mainnet. */
+export interface ContractCallParams {
+    /** Target contract address. */
+    contractAddress: `0x${string}`;
+    /** ABI function name to invoke. */
+    functionName: string;
+    /** Contract ABI JSON (must include `functionName`). */
+    abi: Abi;
+    /** Positional arguments for the function (default `[]`). */
+    functionArgs?: unknown[];
+    /** Optional `msg.sender` for state-dependent view calls. */
+    fromAddress?: `0x${string}`;
+    /** Wei value as decimal string for payable calls (default `"0"`). */
+    value?: string;
+}
+/** Read-only and gas-estimation helpers for arbitrary contracts. */
+export declare class ContractService {
+    private readonly clientFactory;
+    constructor(clientFactory: CeloClientFactory);
+    /**
+     * Simulate a read-only contract call (`eth_call`).
+     * @param params - Contract address, ABI, function name, and optional args
+     * @returns Decoded result on success; `{ success: false, error }` on revert
+     */
+    callFunction(params: ContractCallParams): Promise<{
+        network: "mainnet";
+        contractAddress: `0x${string}`;
+        functionName: string;
+        result: unknown;
+        success: boolean;
+        error?: undefined;
+    } | {
+        network: "mainnet";
+        contractAddress: `0x${string}`;
+        functionName: string;
+        result: null;
+        success: boolean;
+        error: string;
+    }>;
+    /**
+     * Estimate gas for a contract call from `fromAddress`.
+     * @param params - Same as `callFunction` plus required `fromAddress`
+     * @returns Gas estimate, current gas price, and total cost in wei
+     */
+    estimateGas(params: ContractCallParams & {
+        fromAddress: `0x${string}`;
+    }): Promise<{
+        network: "mainnet";
+        contractAddress: `0x${string}`;
+        functionName: string;
+        gasEstimate: string;
+        gasPrice: string;
+        totalCost: string;
+        success: boolean;
+        error?: undefined;
+    } | {
+        network: "mainnet";
+        contractAddress: `0x${string}`;
+        functionName: string;
+        gasEstimate: string;
+        gasPrice: string;
+        totalCost: string;
+        success: boolean;
+        error: string;
+    }>;
+}
+/**
+ * Decode raw calldata result bytes using a single ABI function entry.
+ * @param abi - Contract ABI containing `functionName`
+ * @param functionName - Function whose return types define decoding
+ * @param data - Hex return data from `eth_call`
+ */
+export declare function decodeContractResult(abi: Abi, functionName: string, data: `0x${string}`): readonly unknown[];