@andrewkimjoseph/celina-sdk 0.9.7 → 0.9.9

package/build/src/index.d.ts

@@ -0,0 +1,90 @@
+import { type SdkConfig } from "./config/sdk-config.js";
+import { AccountService } from "./services/account.service.js";
+import { AaveService } from "./services/aave.service.js";
+import { BlockchainService } from "./services/blockchain.service.js";
+import { ContractService } from "./services/contract.service.js";
+import { EnsService } from "./services/ens.service.js";
+import { GoodDollarService } from "./services/gooddollar.service.js";
+import { GovernanceService } from "./services/governance.service.js";
+import { MentoFxService } from "./services/mento-fx.service.js";
+import { UniswapService } from "./services/uniswap.service.js";
+import { NftService } from "./services/nft.service.js";
+import { StakingService } from "./services/staking.service.js";
+import { TokenService } from "./services/token.service.js";
+import { TransactionService } from "./services/transaction.service.js";
+import { SelfService } from "./services/self.service.js";
+/** Optional RPC overrides when creating a Celina client. */
+export type CelinaClientOptions = Partial<SdkConfig>;
+/** Domain services for Celo mainnet reads and unsigned transaction preparation. */
+export interface CelinaClient {
+    /** Blocks, transactions, and network status. */
+    blockchain: BlockchainService;
+    /** CELO balance and nonce for an address. */
+    account: AccountService;
+    /** Token balances, metadata, and stablecoin scans. */
+    token: TokenService;
+    /** Send estimates, gas fees, and `prepareSend` flows. */
+    transaction: TransactionService;
+    /** Mento FX quotes, estimates, and `prepareFx` flows. */
+    mentoFx: MentoFxService;
+    /** Uniswap v4 quotes, estimates, and `prepareSwap` flows. */
+    uniswap: UniswapService;
+    /** Aave V3 `getBalances`, `prepareSupply`, and `prepareWithdraw` on Celo. */
+    aave: AaveService;
+    /** GoodDollar IdentityV4 whitelist, UBI claims, and G$ ↔ USDm reserve swaps. */
+    gooddollar: GoodDollarService;
+    /** Celo and Ethereum ENS resolution. */
+    ens: EnsService;
+    /** Celo governance proposals and details. */
+    governance: GovernanceService;
+    /** Validator election staking reads. */
+    staking: StakingService;
+    /** ERC-721 / ERC-1155 NFT reads. */
+    nft: NftService;
+    /** Generic read-only contract calls and gas estimates. */
+    contract: ContractService;
+    /** Self Agent ID on Celo mainnet (ai.self.xyz + on-chain registry). */
+    self: SelfService;
+}
+/**
+ * Create a Celina client for Celo mainnet reads and unsigned tx preparation.
+ * No private keys — pass prepared `steps` to wagmi/viem for wallet signing.
+ */
+export declare function createCelinaClient(opts?: CelinaClientOptions): CelinaClient;
+export type { 
+/** In-memory prepared flow before JSON serialization. */
+PreparedFlow, 
+/** One step in a multi-step wallet signing flow. */
+PreparedTx, 
+/** Discriminator for prepared transaction step kinds. */
+PreparedTxKind, 
+/** JSON-safe prepared flow returned by prepare* methods. */
+SerializedPreparedFlow, } from "./types/prepared.js";
+export { serializePreparedFlow } from "./types/prepared.js";
+/** RPC URLs for Celo and optional Ethereum ENS reads. */
+export type { SdkConfig } from "./config/sdk-config.js";
+/** Resolved Celo mainnet registry token metadata. */
+export type { ResolvedToken } from "./services/token.service.js";
+/** Slippage, deadline, and recipient options for Mento FX swaps. */
+export type { MentoFxParams } from "./services/mento-fx.service.js";
+/** Slippage, deadline, and recipient options for Uniswap v4 swaps. */
+export type { UniswapSwapParams } from "./services/uniswap.service.js";
+/** Pagination and metadata options for governance proposal lists. */
+export type { GovernanceProposalsOptions } from "./services/governance.service.js";
+/** Parameters for generic read-only contract calls. */
+export type { ContractCallParams } from "./services/contract.service.js";
+/** Aave V3 Celo pool address and supported asset symbols. */
+export { AAVE_POOL, AAVE_SUPPORTED_SYMBOLS, resolveAaveAsset, } from "./config/aave.js";
+export { CHAIN, DEFAULT_RPC_URL } from "./config/chains.js";
+export { appendCelinaCalldataTag, CELINA_DATA_SUFFIX, } from "./config/celina-tag.js";
+export type { AaveAsset } from "./config/aave.js";
+export { GOODDOLLAR_CUSD_EXCHANGE_ID, GOODDOLLAR_IDENTITY_ADDRESS, GOODDOLLAR_MENTO_BROKER, GOODDOLLAR_MENTO_EXCHANGE_PROVIDER, GOODDOLLAR_RESERVE_COLLATERAL, GOODDOLLAR_TOKEN_ADDRESS, GOODDOLLAR_UBI_SCHEME_ADDRESS, isGoodDollarUsdReservePair, } from "./config/gooddollar.js";
+export type { GoodDollarReserveSwapParams, GoodDollarReserveQuoteOptions, GoodDollarReserveAmountSide } from "./services/gooddollar.service.js";
+export { SelfService, type VerifySelfAgentParams, type VerifySelfRequestParams, type RegisterSelfAgentParams, } from "./services/self.service.js";
+export { SelfApiError, SelfExpiredSessionError, } from "./clients/self-api.js";
+export type { SelfRegistrationMode } from "./config/self.js";
+export { selfDemoUrl, SELF_DEMO_NETWORK, SELF_HEADERS, } from "./config/self.js";
+export { resolveSelfSessionLinks, formatSelfSessionLinksDisplay, type SelfSessionLinks, } from "./utils/self-format.js";
+export { clearSelfSessionsForTests } from "./services/self-session-store.js";
+export { flushCelinaAnalytics } from "./analytics/amplitude.js";
+export { runWithAnalyticsWallet } from "./analytics/wallet-context.js";

package/build/src/index.js

@@ -0,0 +1,65 @@
+/**
+ * Celina SDK public entry point.
+ *
+ * createCelinaClient() composes read-only viem clients and domain services.
+ * No private keys or signing — use prepare* methods for unsigned tx payloads.
+ */
+import { CeloClientFactory } from "./clients/celo-client.js";
+import { EnsClientFactory } from "./clients/ens-client.js";
+import { resolveSdkConfig } from "./config/sdk-config.js";
+import { AccountService } from "./services/account.service.js";
+import { AaveService } from "./services/aave.service.js";
+import { BlockchainService } from "./services/blockchain.service.js";
+import { ContractService } from "./services/contract.service.js";
+import { EnsService } from "./services/ens.service.js";
+import { GoodDollarService } from "./services/gooddollar.service.js";
+import { GovernanceService } from "./services/governance.service.js";
+import { MentoFxService } from "./services/mento-fx.service.js";
+import { UniswapService } from "./services/uniswap.service.js";
+import { NftService } from "./services/nft.service.js";
+import { StakingService } from "./services/staking.service.js";
+import { TokenService } from "./services/token.service.js";
+import { TransactionService } from "./services/transaction.service.js";
+import { SelfService } from "./services/self.service.js";
+import { wrapServiceForAnalytics } from "./analytics/wrap-service.js";
+/**
+ * Create a Celina client for Celo mainnet reads and unsigned tx preparation.
+ * No private keys — pass prepared `steps` to wagmi/viem for wallet signing.
+ */
+export function createCelinaClient(opts) {
+    const config = resolveSdkConfig(opts);
+    const clientFactory = new CeloClientFactory(config);
+    const ensClientFactory = new EnsClientFactory(config);
+    const tokenService = new TokenService(clientFactory);
+    const wrap = (key, service) => wrapServiceForAnalytics(key, service, config);
+    return {
+        blockchain: wrap("blockchain", new BlockchainService(clientFactory)),
+        account: wrap("account", new AccountService(clientFactory)),
+        token: wrap("token", tokenService),
+        transaction: wrap("transaction", new TransactionService(clientFactory)),
+        mentoFx: wrap("mentoFx", new MentoFxService(clientFactory)),
+        uniswap: wrap("uniswap", new UniswapService(clientFactory)),
+        aave: wrap("aave", new AaveService(clientFactory)),
+        gooddollar: wrap("gooddollar", new GoodDollarService(clientFactory)),
+        ens: wrap("ens", new EnsService(ensClientFactory)),
+        governance: wrap("governance", new GovernanceService(clientFactory)),
+        staking: wrap("staking", new StakingService(clientFactory)),
+        nft: wrap("nft", new NftService(clientFactory)),
+        contract: wrap("contract", new ContractService(clientFactory)),
+        self: wrap("self", new SelfService(clientFactory, config)),
+    };
+}
+export { serializePreparedFlow } from "./types/prepared.js";
+/** Aave V3 Celo pool address and supported asset symbols. */
+export { AAVE_POOL, AAVE_SUPPORTED_SYMBOLS, resolveAaveAsset, } from "./config/aave.js";
+export { CHAIN, DEFAULT_RPC_URL } from "./config/chains.js";
+export { appendCelinaCalldataTag, CELINA_DATA_SUFFIX, } from "./config/celina-tag.js";
+export { GOODDOLLAR_CUSD_EXCHANGE_ID, GOODDOLLAR_IDENTITY_ADDRESS, GOODDOLLAR_MENTO_BROKER, GOODDOLLAR_MENTO_EXCHANGE_PROVIDER, GOODDOLLAR_RESERVE_COLLATERAL, GOODDOLLAR_TOKEN_ADDRESS, GOODDOLLAR_UBI_SCHEME_ADDRESS, isGoodDollarUsdReservePair, } from "./config/gooddollar.js";
+export { SelfService, } from "./services/self.service.js";
+export { SelfApiError, SelfExpiredSessionError, } from "./clients/self-api.js";
+export { selfDemoUrl, SELF_DEMO_NETWORK, SELF_HEADERS, } from "./config/self.js";
+export { resolveSelfSessionLinks, formatSelfSessionLinksDisplay, } from "./utils/self-format.js";
+export { clearSelfSessionsForTests } from "./services/self-session-store.js";
+export { flushCelinaAnalytics } from "./analytics/amplitude.js";
+export { runWithAnalyticsWallet } from "./analytics/wallet-context.js";
+//# sourceMappingURL=index.js.map

package/build/src/index.js.map

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

package/build/src/oasf/index.d.ts

@@ -0,0 +1,2 @@
+export { buildCelinaOasfRecord, buildCelinaOasfService, type CelinaOasfRecord, type CelinaOasfRecordLocator, type CelinaOasfRecordOptions, type CelinaOasfService, } from "./record.js";
+export { CELINA_OASF_DOMAINS, CELINA_OASF_SCHEMA_VERSION, CELINA_OASF_SKILLS, CELINA_OASF_VERSION, OASF_REPO_ENDPOINT, celinaOasfDomainsCsv, celinaOasfDomainSlugs, celinaOasfSkillSlugs, celinaOasfSkillsCsv, type OasfTaxonomyEntry, } from "./taxonomy.js";

package/build/src/oasf/index.js

@@ -0,0 +1,3 @@
+export { buildCelinaOasfRecord, buildCelinaOasfService, } from "./record.js";
+export { CELINA_OASF_DOMAINS, CELINA_OASF_SCHEMA_VERSION, CELINA_OASF_SKILLS, CELINA_OASF_VERSION, OASF_REPO_ENDPOINT, celinaOasfDomainsCsv, celinaOasfDomainSlugs, celinaOasfSkillSlugs, celinaOasfSkillsCsv, } from "./taxonomy.js";
+//# sourceMappingURL=index.js.map

package/build/src/oasf/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/oasf/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GAKvB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,GAEpB,MAAM,eAAe,CAAC"}

package/build/src/oasf/record.d.ts

@@ -0,0 +1,39 @@
+export interface CelinaOasfService {
+    name: "OASF";
+    endpoint: string;
+    version: string;
+    skills: string[];
+    domains: string[];
+}
+export interface CelinaOasfRecordLocator {
+    type: string;
+    urls: string[];
+}
+export interface CelinaOasfRecord {
+    name: string;
+    description: string;
+    version: string;
+    schema_version: string;
+    authors: string[];
+    created_at: string;
+    skills: Array<{
+        name: string;
+        id: number;
+    }>;
+    domains: Array<{
+        name: string;
+        id: number;
+    }>;
+    modules: unknown[];
+    locators: CelinaOasfRecordLocator[];
+}
+export interface CelinaOasfRecordOptions {
+    /** Package or release version shown on the record */
+    version?: string;
+    /** Public site base URL, e.g. https://usecelina.xyz */
+    siteBaseUrl?: string;
+    /** MCP host base URL for execution endpoints */
+    mcpBaseUrl?: string;
+}
+export declare function buildCelinaOasfService(): CelinaOasfService;
+export declare function buildCelinaOasfRecord(options?: CelinaOasfRecordOptions): CelinaOasfRecord;

package/build/src/oasf/record.js

@@ -0,0 +1,35 @@
+import { CELINA_OASF_SCHEMA_VERSION, CELINA_OASF_SKILLS, CELINA_OASF_DOMAINS, CELINA_OASF_VERSION, OASF_REPO_ENDPOINT, celinaOasfDomainSlugs, celinaOasfSkillSlugs, } from "./taxonomy.js";
+const DEFAULT_DESCRIPTION = "Celo mainnet specialist agent — hosted read-only access to balances, DeFi quotes, governance, staking, NFTs, and Self Agent ID verification via structured tool calls.";
+export function buildCelinaOasfService() {
+    return {
+        name: "OASF",
+        endpoint: OASF_REPO_ENDPOINT,
+        version: CELINA_OASF_VERSION,
+        skills: celinaOasfSkillSlugs(),
+        domains: celinaOasfDomainSlugs(),
+    };
+}
+export function buildCelinaOasfRecord(options = {}) {
+    const site = (options.siteBaseUrl ?? "https://usecelina.xyz").replace(/\/$/, "");
+    const mcp = (options.mcpBaseUrl ?? "https://mcp.usecelina.xyz").replace(/\/$/, "");
+    return {
+        name: "Celina",
+        description: DEFAULT_DESCRIPTION,
+        version: options.version ?? "0.9.2",
+        schema_version: CELINA_OASF_SCHEMA_VERSION,
+        authors: ["Celina <https://usecelina.xyz>"],
+        created_at: "2025-06-01T00:00:00Z",
+        skills: CELINA_OASF_SKILLS.map(({ name, id }) => ({ name, id })),
+        domains: CELINA_OASF_DOMAINS.map(({ name, id }) => ({ name, id })),
+        modules: [],
+        locators: [
+            { type: "source_code", urls: ["https://github.com/andrewkimjoseph/celina-sdk"] },
+            { type: "web", urls: [site] },
+            { type: "mcp", urls: [`${mcp}/api/mcp`] },
+            { type: "a2a", urls: [`${mcp}/api/a2a`] },
+            { type: "agent_card", urls: [`${site}/.well-known/agent-card.json`] },
+            { type: "registration", urls: [`${site}/agent.json`] },
+        ],
+    };
+}
+//# sourceMappingURL=record.js.map

package/build/src/oasf/record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.js","sourceRoot":"","sources":["../../../src/oasf/record.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,eAAe,CAAC;AAqCvB,MAAM,mBAAmB,GACvB,wKAAwK,CAAC;AAE3K,MAAM,UAAU,sBAAsB;IACpC,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,kBAAkB;QAC5B,OAAO,EAAE,mBAAmB;QAC5B,MAAM,EAAE,oBAAoB,EAAE;QAC9B,OAAO,EAAE,qBAAqB,EAAE;KACjC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,UAAmC,EAAE;IAErC,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,WAAW,IAAI,uBAAuB,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACjF,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,UAAU,IAAI,2BAA2B,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAEnF,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,mBAAmB;QAChC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,OAAO;QACnC,cAAc,EAAE,0BAA0B;QAC1C,OAAO,EAAE,CAAC,gCAAgC,CAAC;QAC3C,UAAU,EAAE,sBAAsB;QAClC,MAAM,EAAE,kBAAkB,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAChE,OAAO,EAAE,mBAAmB,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAClE,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE;YACR,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,+CAA+C,CAAC,EAAE;YAChF,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE;YAC7B,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,GAAG,GAAG,UAAU,CAAC,EAAE;YACzC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,GAAG,GAAG,UAAU,CAAC,EAAE;YACzC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,8BAA8B,CAAC,EAAE;YACrE,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,aAAa,CAAC,EAAE;SACvD;KACF,CAAC;AACJ,CAAC"}

package/build/src/oasf/taxonomy.d.ts

@@ -0,0 +1,19 @@
+/**
+ * OASF v0.8.0 taxonomy slugs for Celina (hosted read-only Celo agent).
+ * IDs verified against https://schema.oasf.outshift.com/0.8.0/api/skill_categories
+ * and https://schema.oasf.outshift.com/0.8.0/api/domain_categories
+ */
+export declare const CELINA_OASF_VERSION = "0.8.0";
+export declare const OASF_REPO_ENDPOINT = "https://github.com/agntcy/oasf/";
+export declare const CELINA_OASF_SCHEMA_VERSION = "1.0.0";
+export interface OasfTaxonomyEntry {
+    name: string;
+    id: number;
+}
+/** EIP-8004 OASF service + hosted manifest skills */
+export declare const CELINA_OASF_SKILLS: readonly OasfTaxonomyEntry[];
+export declare const CELINA_OASF_DOMAINS: readonly OasfTaxonomyEntry[];
+export declare function celinaOasfSkillSlugs(): string[];
+export declare function celinaOasfDomainSlugs(): string[];
+export declare function celinaOasfSkillsCsv(): string;
+export declare function celinaOasfDomainsCsv(): string;

package/build/src/oasf/taxonomy.js

@@ -0,0 +1,46 @@
+/**
+ * OASF v0.8.0 taxonomy slugs for Celina (hosted read-only Celo agent).
+ * IDs verified against https://schema.oasf.outshift.com/0.8.0/api/skill_categories
+ * and https://schema.oasf.outshift.com/0.8.0/api/domain_categories
+ */
+export const CELINA_OASF_VERSION = "0.8.0";
+export const OASF_REPO_ENDPOINT = "https://github.com/agntcy/oasf/";
+export const CELINA_OASF_SCHEMA_VERSION = "1.0.0";
+/** EIP-8004 OASF service + hosted manifest skills */
+export const CELINA_OASF_SKILLS = [
+    {
+        name: "natural_language_processing/information_retrieval_synthesis/information_retrieval_synthesis_search",
+        id: 10306,
+    },
+    {
+        name: "natural_language_processing/information_retrieval_synthesis/fact_extraction",
+        id: 10301,
+    },
+    {
+        name: "natural_language_processing/analytical_reasoning/fact_verification",
+        id: 10703,
+    },
+    { name: "tool_interaction/api_schema_understanding", id: 1401 },
+    { name: "tool_interaction/tool_use_planning", id: 1403 },
+    { name: "governance_compliance/compliance_assessment", id: 1302 },
+];
+export const CELINA_OASF_DOMAINS = [
+    { name: "technology/blockchain", id: 109 },
+    { name: "technology/blockchain/cryptocurrency", id: 10901 },
+    { name: "technology/blockchain/defi", id: 10902 },
+    { name: "technology/blockchain/smart_contracts", id: 10903 },
+    { name: "finance_and_business/investment_services", id: 203 },
+];
+export function celinaOasfSkillSlugs() {
+    return CELINA_OASF_SKILLS.map((entry) => entry.name);
+}
+export function celinaOasfDomainSlugs() {
+    return CELINA_OASF_DOMAINS.map((entry) => entry.name);
+}
+export function celinaOasfSkillsCsv() {
+    return celinaOasfSkillSlugs().join(", ");
+}
+export function celinaOasfDomainsCsv() {
+    return celinaOasfDomainSlugs().join(", ");
+}
+//# sourceMappingURL=taxonomy.js.map

package/build/src/oasf/taxonomy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"taxonomy.js","sourceRoot":"","sources":["../../../src/oasf/taxonomy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,OAAO,CAAC;AAC3C,MAAM,CAAC,MAAM,kBAAkB,GAAG,iCAAiC,CAAC;AACpE,MAAM,CAAC,MAAM,0BAA0B,GAAG,OAAO,CAAC;AAOlD,qDAAqD;AACrD,MAAM,CAAC,MAAM,kBAAkB,GAAiC;IAC9D;QACE,IAAI,EAAE,oGAAoG;QAC1G,EAAE,EAAE,KAAK;KACV;IACD;QACE,IAAI,EAAE,6EAA6E;QACnF,EAAE,EAAE,KAAK;KACV;IACD;QACE,IAAI,EAAE,oEAAoE;QAC1E,EAAE,EAAE,KAAK;KACV;IACD,EAAE,IAAI,EAAE,2CAA2C,EAAE,EAAE,EAAE,IAAI,EAAE;IAC/D,EAAE,IAAI,EAAE,oCAAoC,EAAE,EAAE,EAAE,IAAI,EAAE;IACxD,EAAE,IAAI,EAAE,6CAA6C,EAAE,EAAE,EAAE,IAAI,EAAE;CAClE,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAiC;IAC/D,EAAE,IAAI,EAAE,uBAAuB,EAAE,EAAE,EAAE,GAAG,EAAE;IAC1C,EAAE,IAAI,EAAE,sCAAsC,EAAE,EAAE,EAAE,KAAK,EAAE;IAC3D,EAAE,IAAI,EAAE,4BAA4B,EAAE,EAAE,EAAE,KAAK,EAAE;IACjD,EAAE,IAAI,EAAE,uCAAuC,EAAE,EAAE,EAAE,KAAK,EAAE;IAC5D,EAAE,IAAI,EAAE,0CAA0C,EAAE,EAAE,EAAE,GAAG,EAAE;CAC9D,CAAC;AAEF,MAAM,UAAU,oBAAoB;IAClC,OAAO,kBAAkB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,mBAAmB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO,oBAAoB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,qBAAqB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5C,CAAC"}

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

@@ -0,0 +1,58 @@
+import type { CeloClientFactory } from "../clients/celo-client.js";
+import { type SerializedPreparedFlow } from "../types/prepared.js";
+/** Aave V3 supplied balance reads and supply/withdraw prepared flows on Celo mainnet. */
+export declare class AaveService {
+    private readonly clientFactory;
+    private readonly tokenService;
+    constructor(clientFactory: CeloClientFactory);
+    private getPublicClient;
+    private assertUnderlyingBalance;
+    private readATokenBalance;
+    private assertATokenBalance;
+    /**
+     * Supplied Aave V3 positions (aToken balances) for an address on Celo mainnet.
+     * Amounts are in underlying token units including accrued interest.
+     */
+    getBalances(address: `0x${string}`, options?: {
+        tokens?: string[];
+        includeZero?: boolean;
+    }): Promise<{
+        network: "mainnet";
+        address: `0x${string}`;
+        market: "0x3E59A31363E2ad014dcbc521c4a0d5757d9f3402";
+        totalChecked: number;
+        balances: ({
+            symbol: string;
+            underlying: `0x${string}`;
+            aToken: `0x${string}`;
+            raw: string;
+            formatted: string;
+            readError: true;
+        } | {
+            symbol: string;
+            underlying: `0x${string}`;
+            aToken: `0x${string}`;
+            raw: string;
+            formatted: string;
+            readError?: undefined;
+        })[];
+    }>;
+    private needsApproval;
+    /**
+     * Build unsigned Aave V3 supply steps (approve + supply when needed).
+     * @param from - Supplier wallet address
+     * @param token - Aave asset symbol (e.g. `USDm`, `USDC`); `CELO` uses wrapped CELO (WCELO)
+     * @param amount - Human-readable supply amount
+     * @returns 1–2 step `SerializedPreparedFlow`; CELO must be wrapped ERC-20, not native
+     */
+    prepareSupply(from: `0x${string}`, token: string, amount: string): Promise<SerializedPreparedFlow>;
+    /**
+     * Build unsigned Aave V3 withdraw step on Celo.
+     * @param from - Withdrawer wallet address
+     * @param token - Aave asset symbol
+     * @param amount - Human-readable withdraw amount (omit when using `withdrawMax`)
+     * @param withdrawMax - When true, withdraws full supplied aToken balance
+     * @returns Single-step `SerializedPreparedFlow`
+     */
+    prepareWithdraw(from: `0x${string}`, token: string, amount: string | undefined, withdrawMax?: boolean): Promise<SerializedPreparedFlow>;
+}

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

@@ -0,0 +1,210 @@
+/** Aave V3 on Celo: prepareSupply and prepareWithdraw return multi-step flows (approve + pool call). */
+import { concat, encodeFunctionData, erc20Abi, formatUnits } from "viem";
+import { aavePoolAbi } from "../abis/aave-pool.js";
+import { AAVE_ASSETS, AAVE_POOL, resolveAaveAsset, } from "../config/aave.js";
+import { CELINA_DATA_SUFFIX } from "../config/celina-tag.js";
+import { serializePreparedFlow, } from "../types/prepared.js";
+import { TokenService } from "./token.service.js";
+function taggedCalldata(data) {
+    return concat([data, CELINA_DATA_SUFFIX]);
+}
+/** Aave V3 supplied balance reads and supply/withdraw prepared flows on Celo mainnet. */
+export class AaveService {
+    clientFactory;
+    tokenService;
+    constructor(clientFactory) {
+        this.clientFactory = clientFactory;
+        this.tokenService = new TokenService(clientFactory);
+    }
+    getPublicClient() {
+        return this.clientFactory.getClients().public;
+    }
+    async assertUnderlyingBalance(asset, publicClient, owner, amount) {
+        const token = this.tokenService.resolveToken(asset.symbol);
+        const required = this.tokenService.parseAmount(amount, token.decimals);
+        const balance = await publicClient.readContract({
+            address: asset.underlying,
+            abi: erc20Abi,
+            functionName: "balanceOf",
+            args: [owner],
+        });
+        if (balance < required) {
+            const celoHint = asset.symbol === "CELO"
+                ? " Aave requires wrapped CELO (ERC-20), not native CELO."
+                : "";
+            throw new Error(`Insufficient ${asset.symbol} balance. Required ${amount} ${asset.symbol}, available ${balance.toString()} raw units.${celoHint}`);
+        }
+    }
+    async readATokenBalance(asset, publicClient, owner) {
+        return publicClient.readContract({
+            address: asset.aToken,
+            abi: erc20Abi,
+            functionName: "balanceOf",
+            args: [owner],
+        });
+    }
+    async assertATokenBalance(asset, publicClient, owner, amount) {
+        const token = this.tokenService.resolveToken(asset.symbol);
+        const required = this.tokenService.parseAmount(amount, token.decimals);
+        const balance = await this.readATokenBalance(asset, publicClient, owner);
+        if (balance < required) {
+            throw new Error(`Insufficient Aave ${asset.symbol} supply balance. Required ${amount} ${asset.symbol}, available ${formatUnits(balance, token.decimals)} ${asset.symbol}.`);
+        }
+    }
+    /**
+     * Supplied Aave V3 positions (aToken balances) for an address on Celo mainnet.
+     * Amounts are in underlying token units including accrued interest.
+     */
+    async getBalances(address, options) {
+        const assets = options?.tokens
+            ? options.tokens.map((token) => resolveAaveAsset(token))
+            : Object.values(AAVE_ASSETS);
+        const { public: client } = this.clientFactory.getClients();
+        const results = await client.multicall({
+            contracts: assets.map((asset) => ({
+                address: asset.aToken,
+                abi: erc20Abi,
+                functionName: "balanceOf",
+                args: [address],
+            })),
+            allowFailure: true,
+        });
+        const balances = assets.map((asset, index) => {
+            const result = results[index];
+            const token = this.tokenService.resolveToken(asset.symbol);
+            if (result.status === "failure") {
+                return {
+                    symbol: asset.symbol,
+                    underlying: asset.underlying,
+                    aToken: asset.aToken,
+                    raw: "0",
+                    formatted: "0",
+                    readError: true,
+                };
+            }
+            const raw = result.result;
+            return {
+                symbol: asset.symbol,
+                underlying: asset.underlying,
+                aToken: asset.aToken,
+                raw: raw.toString(),
+                formatted: formatUnits(raw, token.decimals),
+            };
+        });
+        const filtered = options?.includeZero
+            ? balances
+            : balances.filter((balance) => balance.raw !== "0");
+        return {
+            network: "mainnet",
+            address,
+            market: AAVE_POOL,
+            totalChecked: assets.length,
+            balances: filtered,
+        };
+    }
+    async needsApproval(underlying, from, amountWei) {
+        const publicClient = this.getPublicClient();
+        const allowance = await publicClient.readContract({
+            address: underlying,
+            abi: erc20Abi,
+            functionName: "allowance",
+            args: [from, AAVE_POOL],
+        });
+        return allowance < amountWei;
+    }
+    /**
+     * Build unsigned Aave V3 supply steps (approve + supply when needed).
+     * @param from - Supplier wallet address
+     * @param token - Aave asset symbol (e.g. `USDm`, `USDC`); `CELO` uses wrapped CELO (WCELO)
+     * @param amount - Human-readable supply amount
+     * @returns 1–2 step `SerializedPreparedFlow`; CELO must be wrapped ERC-20, not native
+     */
+    async prepareSupply(from, token, amount) {
+        const asset = resolveAaveAsset(token);
+        const publicClient = this.getPublicClient();
+        await this.assertUnderlyingBalance(asset, publicClient, from, amount);
+        const resolved = this.tokenService.resolveToken(asset.symbol);
+        const amountWei = this.tokenService.parseAmount(amount, resolved.decimals);
+        const steps = [];
+        if (await this.needsApproval(asset.underlying, from, amountWei)) {
+            const approveData = taggedCalldata(encodeFunctionData({
+                abi: erc20Abi,
+                functionName: "approve",
+                args: [AAVE_POOL, amountWei],
+            }));
+            steps.push({
+                kind: "erc20",
+                to: asset.underlying,
+                data: approveData,
+                value: "0",
+                description: `Approve ${amount} ${asset.symbol} for Aave`,
+            });
+        }
+        const supplyData = taggedCalldata(encodeFunctionData({
+            abi: aavePoolAbi,
+            functionName: "supply",
+            args: [asset.underlying, amountWei, from, 0],
+        }));
+        steps.push({
+            kind: "contract",
+            to: AAVE_POOL,
+            data: supplyData,
+            value: "0",
+            description: `Supply ${amount} ${asset.symbol} to Aave V3`,
+        });
+        const flow = {
+            network: "mainnet",
+            from,
+            summary: `Supply ${amount} ${asset.symbol} to Aave V3 on Celo`,
+            steps,
+        };
+        return serializePreparedFlow(flow);
+    }
+    /**
+     * Build unsigned Aave V3 withdraw step on Celo.
+     * @param from - Withdrawer wallet address
+     * @param token - Aave asset symbol
+     * @param amount - Human-readable withdraw amount (omit when using `withdrawMax`)
+     * @param withdrawMax - When true, withdraws full supplied aToken balance
+     * @returns Single-step `SerializedPreparedFlow`
+     */
+    async prepareWithdraw(from, token, amount, withdrawMax) {
+        const asset = resolveAaveAsset(token);
+        const publicClient = this.getPublicClient();
+        if (!withdrawMax && !amount) {
+            throw new Error("Provide amount or set withdrawMax to true.");
+        }
+        if (!withdrawMax && amount) {
+            await this.assertATokenBalance(asset, publicClient, from, amount);
+        }
+        const resolved = this.tokenService.resolveToken(asset.symbol);
+        const amountWei = withdrawMax
+            ? await this.readATokenBalance(asset, publicClient, from)
+            : this.tokenService.parseAmount(amount, resolved.decimals);
+        if (amountWei === 0n) {
+            throw new Error(`No supplied ${asset.symbol} balance to withdraw.`);
+        }
+        const withdrawData = taggedCalldata(encodeFunctionData({
+            abi: aavePoolAbi,
+            functionName: "withdraw",
+            args: [asset.underlying, amountWei, from],
+        }));
+        const amountLabel = withdrawMax ? "max" : amount;
+        const flow = {
+            network: "mainnet",
+            from,
+            summary: `Withdraw ${amountLabel} ${asset.symbol} from Aave V3 on Celo`,
+            steps: [
+                {
+                    kind: "contract",
+                    to: AAVE_POOL,
+                    data: withdrawData,
+                    value: "0",
+                    description: `Withdraw ${amountLabel} ${asset.symbol} from Aave`,
+                },
+            ],
+        };
+        return serializePreparedFlow(flow);
+    }
+}
+//# sourceMappingURL=aave.service.js.map

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":"AAAA,wGAAwG;AACxG,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,EACL,WAAW,EACX,SAAS,EACT,gBAAgB,GAEjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAGL,qBAAqB,GAEtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,SAAS,cAAc,CAAC,IAAmB;IACzC,OAAO,MAAM,CAAC,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,yFAAyF;AACzF,MAAM,OAAO,WAAW;IAGO;IAFZ,YAAY,CAAe;IAE5C,YAA6B,aAAgC;QAAhC,kBAAa,GAAb,aAAa,CAAmB;QAC3D,IAAI,CAAC,YAAY,GAAG,IAAI,YAAY,CAAC,aAAa,CAAC,CAAC;IACtD,CAAC;IAEO,eAAe;QACrB,OAAO,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,CAAC,MAAM,CAAC;IAChD,CAAC;IAEO,KAAK,CAAC,uBAAuB,CACnC,KAAgB,EAChB,YAAmC,EACnC,KAAoB,EACpB,MAAc;QAEd,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;QAEvE,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC;YAC9C,OAAO,EAAE,KAAK,CAAC,UAAU;YACzB,GAAG,EAAE,QAAQ;YACb,YAAY,EAAE,WAAW;YACzB,IAAI,EAAE,CAAC,KAAK,CAAC;SACd,CAAC,CAAC;QAEH,IAAI,OAAO,GAAG,QAAQ,EAAE,CAAC;YACvB,MAAM,QAAQ,GACZ,KAAK,CAAC,MAAM,KAAK,MAAM;gBACrB,CAAC,CAAC,wDAAwD;gBAC1D,CAAC,CAAC,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CACb,gBAAgB,KAAK,CAAC,MAAM,sBAAsB,MAAM,IAAI,KAAK,CAAC,MAAM,eAAe,OAAO,CAAC,QAAQ,EAAE,cAAc,QAAQ,EAAE,CAClI,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAC7B,KAAgB,EAChB,YAAmC,EACnC,KAAoB;QAEpB,OAAO,YAAY,CAAC,YAAY,CAAC;YAC/B,OAAO,EAAE,KAAK,CAAC,MAAM;YACrB,GAAG,EAAE,QAAQ;YACb,YAAY,EAAE,WAAW;YACzB,IAAI,EAAE,CAAC,KAAK,CAAC;SACd,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,mBAAmB,CAC/B,KAAgB,EAChB,YAAmC,EACnC,KAAoB,EACpB,MAAc;QAEd,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;QAEvE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC;QAEzE,IAAI,OAAO,GAAG,QAAQ,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CACb,qBAAqB,KAAK,CAAC,MAAM,6BAA6B,MAAM,IAAI,KAAK,CAAC,MAAM,eAAe,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAC3J,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,WAAW,CACf,OAAsB,EACtB,OAGC;QAED,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM;YAC5B,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;YACxD,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAE/B,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,CAAC;QAE3D,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC;YACrC,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBAChC,OAAO,EAAE,KAAK,CAAC,MAAM;gBACrB,GAAG,EAAE,QAAQ;gBACb,YAAY,EAAE,WAAoB;gBAClC,IAAI,EAAE,CAAC,OAAO,CAAU;aACzB,CAAC,CAAC;YACH,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;YAC3C,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;YAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAE3D,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAChC,OAAO;oBACL,MAAM,EAAE,KAAK,CAAC,MAAM;oBACpB,UAAU,EAAE,KAAK,CAAC,UAAU;oBAC5B,MAAM,EAAE,KAAK,CAAC,MAAM;oBACpB,GAAG,EAAE,GAAG;oBACR,SAAS,EAAE,GAAG;oBACd,SAAS,EAAE,IAAa;iBACzB,CAAC;YACJ,CAAC;YAED,MAAM,GAAG,GAAG,MAAM,CAAC,MAAgB,CAAC;YACpC,OAAO;gBACL,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE;gBACnB,SAAS,EAAE,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,QAAQ,CAAC;aAC5C,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,OAAO,EAAE,WAAW;YACnC,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;QAEtD,OAAO;YACL,OAAO,EAAE,SAAkB;YAC3B,OAAO;YACP,MAAM,EAAE,SAAS;YACjB,YAAY,EAAE,MAAM,CAAC,MAAM;YAC3B,QAAQ,EAAE,QAAQ;SACnB,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,aAAa,CACzB,UAAyB,EACzB,IAAmB,EACnB,SAAiB;QAEjB,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QAC5C,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC;YAChD,OAAO,EAAE,UAAU;YACnB,GAAG,EAAE,QAAQ;YACb,YAAY,EAAE,WAAW;YACzB,IAAI,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC;SACxB,CAAC,CAAC;QACH,OAAO,SAAS,GAAG,SAAS,CAAC;IAC/B,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,aAAa,CACjB,IAAmB,EACnB,KAAa,EACb,MAAc;QAEd,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QAE5C,MAAM,IAAI,CAAC,uBAAuB,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAEtE,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC9D,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC3E,MAAM,KAAK,GAAiB,EAAE,CAAC;QAE/B,IAAI,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,UAAU,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;YAChE,MAAM,WAAW,GAAG,cAAc,CAChC,kBAAkB,CAAC;gBACjB,GAAG,EAAE,QAAQ;gBACb,YAAY,EAAE,SAAS;gBACvB,IAAI,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC;aAC7B,CAAC,CACH,CAAC;YACF,KAAK,CAAC,IAAI,CAAC;gBACT,IAAI,EAAE,OAAO;gBACb,EAAE,EAAE,KAAK,CAAC,UAAU;gBACpB,IAAI,EAAE,WAAW;gBACjB,KAAK,EAAE,GAAG;gBACV,WAAW,EAAE,WAAW,MAAM,IAAI,KAAK,CAAC,MAAM,WAAW;aAC1D,CAAC,CAAC;QACL,CAAC;QAED,MAAM,UAAU,GAAG,cAAc,CAC/B,kBAAkB,CAAC;YACjB,GAAG,EAAE,WAAW;YAChB,YAAY,EAAE,QAAQ;YACtB,IAAI,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;SAC7C,CAAC,CACH,CAAC;QAEF,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,UAAU;YAChB,EAAE,EAAE,SAAS;YACb,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,GAAG;YACV,WAAW,EAAE,UAAU,MAAM,IAAI,KAAK,CAAC,MAAM,aAAa;SAC3D,CAAC,CAAC;QAEH,MAAM,IAAI,GAAiB;YACzB,OAAO,EAAE,SAAS;YAClB,IAAI;YACJ,OAAO,EAAE,UAAU,MAAM,IAAI,KAAK,CAAC,MAAM,qBAAqB;YAC9D,KAAK;SACN,CAAC;QAEF,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,eAAe,CACnB,IAAmB,EACnB,KAAa,EACb,MAA0B,EAC1B,WAAqB;QAErB,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QAE5C,IAAI,CAAC,WAAW,IAAI,CAAC,MAAM,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QAED,IAAI,CAAC,WAAW,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QACpE,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC9D,MAAM,SAAS,GAAG,WAAW;YAC3B,CAAC,CAAC,MAAM,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,CAAC;YACzD,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,MAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAE9D,IAAI,SAAS,KAAK,EAAE,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,eAAe,KAAK,CAAC,MAAM,uBAAuB,CAAC,CAAC;QACtE,CAAC;QAED,MAAM,YAAY,GAAG,cAAc,CACjC,kBAAkB,CAAC;YACjB,GAAG,EAAE,WAAW;YAChB,YAAY,EAAE,UAAU;YACxB,IAAI,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE,SAAS,EAAE,IAAI,CAAC;SAC1C,CAAC,CACH,CAAC;QAEF,MAAM,WAAW,GAAG,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAO,CAAC;QAClD,MAAM,IAAI,GAAiB;YACzB,OAAO,EAAE,SAAS;YAClB,IAAI;YACJ,OAAO,EAAE,YAAY,WAAW,IAAI,KAAK,CAAC,MAAM,uBAAuB;YACvE,KAAK,EAAE;gBACL;oBACE,IAAI,EAAE,UAAU;oBAChB,EAAE,EAAE,SAAS;oBACb,IAAI,EAAE,YAAY;oBAClB,KAAK,EAAE,GAAG;oBACV,WAAW,EAAE,YAAY,WAAW,IAAI,KAAK,CAAC,MAAM,YAAY;iBACjE;aACF;SACF,CAAC;QAEF,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;CACF"}

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;
+    }>;
+}