@andrewkimjoseph/celina-sdk 0.2.11 → 0.3.1

package/build/index.js

@@ -20,6 +20,9 @@ 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 { CarbonService } from "./services/carbon.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.
@@ -28,23 +31,34 @@ 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: new BlockchainService(clientFactory),
-        account: new AccountService(clientFactory),
-        token: new TokenService(clientFactory),
-        transaction: new TransactionService(clientFactory),
-        mentoFx: new MentoFxService(clientFactory),
-        uniswap: new UniswapService(clientFactory),
-        aave: new AaveService(clientFactory),
-        gooddollar: new GoodDollarService(clientFactory),
-        ens: new EnsService(ensClientFactory),
-        governance: new GovernanceService(clientFactory),
-        staking: new StakingService(clientFactory),
-        nft: new NftService(clientFactory),
-        contract: new ContractService(clientFactory),
+        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)),
+        carbon: wrap("carbon", new CarbonService(config, tokenService)),
+        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 { CARBON_CHAIN, CELO_CARBON_CONTRACTS, DEFAULT_CARBON_REST_BASE_URL, } from "./config/carbon.js";
+export { CarbonRestError } from "./clients/carbon-rest.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";
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAkB,MAAM,wBAAwB,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAmCvE;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAA0B;IAC3D,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,aAAa,GAAG,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACpD,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAEtD,OAAO;QACL,UAAU,EAAE,IAAI,iBAAiB,CAAC,aAAa,CAAC;QAChD,OAAO,EAAE,IAAI,cAAc,CAAC,aAAa,CAAC;QAC1C,KAAK,EAAE,IAAI,YAAY,CAAC,aAAa,CAAC;QACtC,WAAW,EAAE,IAAI,kBAAkB,CAAC,aAAa,CAAC;QAClD,OAAO,EAAE,IAAI,cAAc,CAAC,aAAa,CAAC;QAC1C,OAAO,EAAE,IAAI,cAAc,CAAC,aAAa,CAAC;QAC1C,IAAI,EAAE,IAAI,WAAW,CAAC,aAAa,CAAC;QACpC,UAAU,EAAE,IAAI,iBAAiB,CAAC,aAAa,CAAC;QAChD,GAAG,EAAE,IAAI,UAAU,CAAC,gBAAgB,CAAC;QACrC,UAAU,EAAE,IAAI,iBAAiB,CAAC,aAAa,CAAC;QAChD,OAAO,EAAE,IAAI,cAAc,CAAC,aAAa,CAAC;QAC1C,GAAG,EAAE,IAAI,UAAU,CAAC,aAAa,CAAC;QAClC,QAAQ,EAAE,IAAI,eAAe,CAAC,aAAa,CAAC;KAC7C,CAAC;AACJ,CAAC;AAYD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAa5D,6DAA6D;AAC7D,OAAO,EACL,SAAS,EACT,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,68 @@
+/**
+ * Carbon DeFi on Celo — hybrid @bancor/carbon-sdk + Carbon REST (mcp.carbondefi.xyz).
+ * REST is primary for all 25 MCP tools; SDK is fallback for quotes/trades when REST fails.
+ */
+import type { SdkConfig } from "../config/sdk-config.js";
+import type { CarbonPrepareResult, CarbonRestSuccess } from "../types/carbon.js";
+import type { TokenService } from "./token.service.js";
+export type CarbonWriteBody = Record<string, unknown> & {
+    wallet_address: `0x${string}`;
+};
+export declare class CarbonService {
+    private readonly tokenService;
+    private readonly rest;
+    private readonly sdk;
+    constructor(config: SdkConfig, tokenService: TokenService);
+    private restRead;
+    private restPrepare;
+    private withSdkFallback;
+    getStrategies(walletAddress: `0x${string}`): Promise<CarbonRestSuccess & {
+        warnings: string[];
+    }>;
+    getStrategy(strategyId: string): Promise<CarbonRestSuccess & {
+        warnings: string[];
+    }>;
+    prepareLimitOrder(body: CarbonWriteBody): Promise<CarbonPrepareResult>;
+    prepareRangeOrder(body: CarbonWriteBody): Promise<CarbonPrepareResult>;
+    prepareRecurringStrategy(body: CarbonWriteBody): Promise<CarbonPrepareResult>;
+    prepareConcentratedStrategy(body: CarbonWriteBody): Promise<CarbonPrepareResult>;
+    prepareFullRangeStrategy(body: CarbonWriteBody): Promise<CarbonPrepareResult>;
+    prepareRepriceStrategy(body: CarbonWriteBody): Promise<CarbonPrepareResult>;
+    prepareEditStrategy(body: CarbonWriteBody): Promise<CarbonPrepareResult>;
+    prepareDepositBudget(body: CarbonWriteBody): Promise<CarbonPrepareResult>;
+    prepareWithdrawBudget(body: CarbonWriteBody): Promise<CarbonPrepareResult>;
+    preparePauseStrategy(body: CarbonWriteBody): Promise<CarbonPrepareResult>;
+    prepareResumeStrategy(body: CarbonWriteBody): Promise<CarbonPrepareResult>;
+    prepareDeleteStrategy(body: CarbonWriteBody): Promise<CarbonPrepareResult>;
+    getTradeQuote(body: Record<string, unknown>): Promise<CarbonRestSuccess & {
+        warnings: string[];
+    }>;
+    prepareTrade(body: CarbonWriteBody): Promise<CarbonPrepareResult>;
+    explorePair(body: Record<string, unknown>): Promise<CarbonRestSuccess & {
+        warnings: string[];
+    }>;
+    resolveToken(symbolOrName: string): Promise<CarbonRestSuccess & {
+        warnings: string[];
+    }>;
+    getActivity(body: Record<string, unknown>): Promise<CarbonRestSuccess & {
+        warnings: string[];
+    }>;
+    findOpportunities(body: Record<string, unknown>): Promise<CarbonRestSuccess & {
+        warnings: string[];
+    }>;
+    getProtocolStats(body?: Record<string, unknown>): Promise<CarbonRestSuccess & {
+        warnings: string[];
+    }>;
+    getPriceHistory(body: Record<string, unknown>): Promise<CarbonRestSuccess & {
+        warnings: string[];
+    }>;
+    simulateStrategy(body: Record<string, unknown>): Promise<CarbonRestSuccess & {
+        warnings: string[];
+    }>;
+    help(topic?: string): Promise<CarbonRestSuccess & {
+        warnings: string[];
+    }>;
+    learn(topic?: string): Promise<CarbonRestSuccess & {
+        warnings: string[];
+    }>;
+}

package/build/services/carbon.service.js

@@ -0,0 +1,189 @@
+import { CarbonRestClient } from "../clients/carbon-rest.js";
+import { CarbonSdkClient } from "../clients/carbon-sdk.js";
+import { extractWarnings, normalizeCarbonPrepareResult, } from "../utils/carbon-rest-adapter.js";
+function walletAddress(value) {
+    return value;
+}
+export class CarbonService {
+    tokenService;
+    rest;
+    sdk;
+    constructor(config, tokenService) {
+        this.tokenService = tokenService;
+        this.rest = new CarbonRestClient(config.carbonRestBaseUrl);
+        this.sdk =
+            config.carbonSdkFallback !== false
+                ? new CarbonSdkClient(config.rpcUrl)
+                : null;
+    }
+    async restRead(tool, body = {}) {
+        const result = await this.rest.postTool(tool, body);
+        return { ...result, warnings: extractWarnings(result) };
+    }
+    async restPrepare(tool, body, summary) {
+        const from = walletAddress(body.wallet_address);
+        const result = await this.rest.postTool(tool, body);
+        return normalizeCarbonPrepareResult(from, result, summary);
+    }
+    async withSdkFallback(restFn, fallbackFn) {
+        try {
+            return await restFn();
+        }
+        catch (primary) {
+            if (!this.sdk)
+                throw primary;
+            return fallbackFn();
+        }
+    }
+    // --- Read (2) ---
+    async getStrategies(walletAddress) {
+        return this.restRead("get_strategies", { wallet_address: walletAddress });
+    }
+    async getStrategy(strategyId) {
+        return this.restRead("get_strategy", { strategy_id: strategyId });
+    }
+    // --- Create (5) ---
+    async prepareLimitOrder(body) {
+        return this.restPrepare("create_limit_order", body, "Carbon limit order");
+    }
+    async prepareRangeOrder(body) {
+        return this.restPrepare("create_range_order", body, "Carbon range order");
+    }
+    async prepareRecurringStrategy(body) {
+        return this.restPrepare("create_recurring_strategy", body, "Carbon recurring strategy");
+    }
+    async prepareConcentratedStrategy(body) {
+        return this.restPrepare("create_concentrated_strategy", body, "Carbon concentrated strategy");
+    }
+    async prepareFullRangeStrategy(body) {
+        return this.restPrepare("create_full_range_strategy", body, "Carbon full-range strategy");
+    }
+    // --- Manage (7) ---
+    async prepareRepriceStrategy(body) {
+        return this.restPrepare("reprice_strategy", body, "Carbon reprice strategy");
+    }
+    async prepareEditStrategy(body) {
+        return this.restPrepare("edit_strategy", body, "Carbon edit strategy");
+    }
+    async prepareDepositBudget(body) {
+        return this.restPrepare("deposit_budget", body, "Carbon deposit budget");
+    }
+    async prepareWithdrawBudget(body) {
+        return this.restPrepare("withdraw_budget", body, "Carbon withdraw budget");
+    }
+    async preparePauseStrategy(body) {
+        return this.restPrepare("pause_strategy", body, "Carbon pause strategy");
+    }
+    async prepareResumeStrategy(body) {
+        return this.restPrepare("resume_strategy", body, "Carbon resume strategy");
+    }
+    async prepareDeleteStrategy(body) {
+        return this.restPrepare("delete_strategy", body, "Carbon delete strategy");
+    }
+    // --- Trade (2) ---
+    async getTradeQuote(body) {
+        const amount = typeof body.amount === "string" ? Number(body.amount) : body.amount;
+        const normalized = {
+            ...body,
+            amount,
+            ...(body.is_trade_by_target !== undefined
+                ? { by_target: body.is_trade_by_target }
+                : {}),
+        };
+        return this.withSdkFallback(() => this.restRead("get_trade_quote", normalized), async () => {
+            if (!this.sdk)
+                throw new Error("Carbon SDK fallback unavailable");
+            const sourceToken = String(body.source_token ?? body.token_in);
+            const targetToken = String(body.target_token ?? body.token_out);
+            const amountStr = String(amount);
+            const isTradeByTarget = Boolean(body.is_trade_by_target ?? body.by_target);
+            const { tradeData } = await this.sdk.getTradeQuoteFallback(sourceToken, targetToken, amountStr, isTradeByTarget);
+            return {
+                status: "ok",
+                warnings: [],
+                source: "sdk_fallback",
+                ...tradeData,
+            };
+        });
+    }
+    async prepareTrade(body) {
+        try {
+            return await this.restPrepare("execute_trade", body, "Carbon taker swap");
+        }
+        catch (primary) {
+            if (!this.sdk)
+                throw primary;
+            const sourceToken = String(body.source_token ?? body.token_in);
+            const targetToken = String(body.target_token ?? body.token_out);
+            const amount = String(body.amount);
+            const minReturn = String(body.min_return ?? "0");
+            const preparedFlow = await this.sdk.prepareTradeFallback(walletAddress(body.wallet_address), sourceToken, targetToken, amount, false, minReturn);
+            return {
+                status: "ok",
+                warnings: [],
+                preparedFlow,
+                source: "sdk_fallback",
+            };
+        }
+    }
+    // --- Explore (8) ---
+    async explorePair(body) {
+        return this.restRead("explore_pair", body);
+    }
+    async resolveToken(symbolOrName) {
+        try {
+            return await this.restRead("resolve_token", {
+                token: symbolOrName,
+            });
+        }
+        catch {
+            const resolved = this.tokenService.resolveToken(symbolOrName);
+            return {
+                status: "ok",
+                warnings: [],
+                symbol: resolved.symbol,
+                address: resolved.address,
+                decimals: resolved.decimals,
+                source: "celina_registry",
+            };
+        }
+    }
+    async getActivity(body) {
+        return this.restRead("get_activity", body);
+    }
+    async findOpportunities(body) {
+        return this.restRead("find_opportunities", body);
+    }
+    async getProtocolStats(body = {}) {
+        const { period_days, ...rest } = body;
+        return this.restRead("get_protocol_stats", {
+            ...rest,
+            ...(period_days !== undefined ? { days: period_days } : {}),
+        });
+    }
+    async getPriceHistory(body) {
+        const { period_days, days, ...rest } = body;
+        const lookback = days ?? period_days;
+        return this.restRead("get_price_history", {
+            ...rest,
+            ...(lookback !== undefined ? { days: lookback } : {}),
+        });
+    }
+    async simulateStrategy(body) {
+        const { days, ...rest } = body;
+        if (rest.start === undefined && rest.end === undefined && days !== undefined) {
+            const end = Math.floor(Date.now() / 1000);
+            const start = end - Number(days) * 86_400;
+            return this.restRead("simulate_strategy", { ...rest, start, end });
+        }
+        return this.restRead("simulate_strategy", body);
+    }
+    // --- Help (2) ---
+    async help(topic) {
+        return this.restRead("help", topic ? { topic } : {});
+    }
+    async learn(topic) {
+        return this.restRead("learn", topic ? { topic } : {});
+    }
+}
+//# sourceMappingURL=carbon.service.js.map

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

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

package/build/services/self-session-store.d.ts

@@ -0,0 +1,19 @@
+import type { SelfDeregistrationSession, SelfRefreshSession, SelfRegistrationSession } from "../clients/self-api.js";
+export type SelfSessionKind = "registration" | "refresh" | "deregistration";
+export type StoredSelfSession = {
+    kind: "registration";
+    session: SelfRegistrationSession;
+    createdAt: number;
+} | {
+    kind: "refresh";
+    session: SelfRefreshSession;
+    createdAt: number;
+} | {
+    kind: "deregistration";
+    session: SelfDeregistrationSession;
+    createdAt: number;
+};
+export declare function storeSelfSession(sessionToken: string, entry: StoredSelfSession): void;
+export declare function getSelfSession(sessionToken: string): StoredSelfSession | undefined;
+export declare function deleteSelfSession(sessionToken: string): void;
+export declare function clearSelfSessionsForTests(): void;

package/build/services/self-session-store.js

@@ -0,0 +1,28 @@
+import { SELF_MAX_SESSIONS, SELF_SESSION_TTL_MS } from "../config/self.js";
+const sessions = new Map();
+function pruneExpiredSessions() {
+    const now = Date.now();
+    for (const [key, entry] of sessions) {
+        if (now - entry.createdAt > SELF_SESSION_TTL_MS) {
+            sessions.delete(key);
+        }
+    }
+}
+export function storeSelfSession(sessionToken, entry) {
+    pruneExpiredSessions();
+    if (sessions.size >= SELF_MAX_SESSIONS) {
+        throw new Error("Too many active Self sessions. Wait for existing sessions to expire (10 minutes) or restart the server.");
+    }
+    sessions.set(sessionToken, entry);
+}
+export function getSelfSession(sessionToken) {
+    pruneExpiredSessions();
+    return sessions.get(sessionToken);
+}
+export function deleteSelfSession(sessionToken) {
+    sessions.delete(sessionToken);
+}
+export function clearSelfSessionsForTests() {
+    sessions.clear();
+}
+//# sourceMappingURL=self-session-store.js.map

package/build/services/self-session-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-session-store.js","sourceRoot":"","sources":["../../src/services/self-session-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AA0B3E,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA6B,CAAC;AAEtD,SAAS,oBAAoB;IAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEvB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,QAAQ,EAAE,CAAC;QACpC,IAAI,GAAG,GAAG,KAAK,CAAC,SAAS,GAAG,mBAAmB,EAAE,CAAC;YAChD,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,YAAoB,EACpB,KAAwB;IAExB,oBAAoB,EAAE,CAAC;IAEvB,IAAI,QAAQ,CAAC,IAAI,IAAI,iBAAiB,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CACb,yGAAyG,CAC1G,CAAC;IACJ,CAAC;IAED,QAAQ,CAAC,GAAG,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,YAAoB;IACjD,oBAAoB,EAAE,CAAC;IACvB,OAAO,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,YAAoB;IACpD,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,yBAAyB;IACvC,QAAQ,CAAC,KAAK,EAAE,CAAC;AACnB,CAAC"}

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

@@ -0,0 +1,241 @@
+import { type Hex } from "viem";
+import type { SelfRegistrationMode } from "../config/self.js";
+import type { SdkConfig } from "../config/sdk-config.js";
+import type { CeloClientFactory } from "../clients/celo-client.js";
+export interface VerifySelfAgentParams {
+    agentAddress: `0x${string}`;
+    requireAge?: 0 | 18 | 21;
+    requireOfac?: boolean;
+    requireSelfProvider?: boolean;
+}
+export interface VerifySelfRequestParams {
+    agentSignature: Hex;
+    agentTimestamp: string;
+    method: string;
+    path: string;
+    body?: string;
+    keytype?: string;
+    agentKey?: Hex;
+}
+export interface RegisterSelfAgentParams {
+    mode?: SelfRegistrationMode;
+    minimumAge?: 0 | 18 | 21;
+    ofac?: boolean;
+    humanAddress?: `0x${string}`;
+    agentName?: string;
+    agentDescription?: string;
+}
+export declare class SelfService {
+    private readonly clientFactory;
+    private readonly config;
+    constructor(clientFactory: CeloClientFactory, config: Pick<SdkConfig, "selfAgentPrivateKey" | "selfApiBase">);
+    private get apiBase();
+    private resolveAgentPrivateKey;
+    private registryClient;
+    private assertProofRefreshEligible;
+    verifyAgent(params: VerifySelfAgentParams): Promise<{
+        verified: boolean;
+        agent_address: `0x${string}`;
+        reason: string;
+        network: "mainnet";
+    } | {
+        verification_strength: string;
+        network: "mainnet";
+        sibling_agent_ids: number[];
+        proof_expires_at: string | null;
+        days_until_expiry: number;
+        is_expiring_soon: boolean;
+        verified: boolean;
+        agent_address: `0x${string}`;
+        agent_id: number;
+        reason: string;
+        credentials: {
+            nationality: string | undefined;
+            older_than: number;
+            ofac_clear: boolean;
+        };
+    } | {
+        verification_strength: string;
+        registered_at: number;
+        agent_count: number;
+        is_proof_fresh: boolean;
+        network: "mainnet";
+        sibling_agent_ids: number[];
+        proof_expires_at: string | null;
+        days_until_expiry: number;
+        is_expiring_soon: boolean;
+        verified: boolean;
+        agent_address: `0x${string}`;
+        agent_id: number;
+        credentials: {
+            nationality: string | undefined;
+            older_than: number;
+            ofac_clear: boolean;
+        };
+        reason?: undefined;
+    }>;
+    lookupAgent(agentId: number): Promise<{
+        is_expired: boolean;
+        network: "mainnet";
+        proof_expires_at: string | null;
+        days_until_expiry: number;
+        is_expiring_soon: boolean;
+        credentialsSummary: string;
+    }>;
+    verifyRequest(params: VerifySelfRequestParams): Promise<{
+        valid: boolean;
+        reason: string;
+        agent_address?: undefined;
+        agent_id?: undefined;
+        agent_count?: undefined;
+        nullifier?: undefined;
+        credentials?: undefined;
+        note?: undefined;
+    } | {
+        valid: boolean;
+        agent_address: `0x${string}`;
+        reason: string;
+        agent_id?: undefined;
+        agent_count?: undefined;
+        nullifier?: undefined;
+        credentials?: undefined;
+        note?: undefined;
+    } | {
+        valid: boolean;
+        agent_address: `0x${string}`;
+        agent_id: number;
+        reason: string;
+        agent_count?: undefined;
+        nullifier?: undefined;
+        credentials?: undefined;
+        note?: undefined;
+    } | {
+        valid: boolean;
+        agent_address: `0x${string}`;
+        agent_id: number;
+        agent_count: number;
+        nullifier: number;
+        credentials: {
+            nationality: string | undefined;
+            older_than: number;
+            ofac_clear: boolean;
+        };
+        note: string;
+        reason?: undefined;
+    }>;
+    private getAgentInfoFromKey;
+    getIdentity(): Promise<{
+        expiry_warning?: string | undefined;
+        is_expired: boolean;
+        sibling_agent_ids: number[];
+        network: "mainnet";
+        proof_expires_at: string | null;
+        days_until_expiry: number;
+        is_expiring_soon: boolean;
+        registered: true;
+        address: `0x${string}`;
+        agentKey: `0x${string}`;
+        agentId: number;
+        isVerified: boolean;
+        nullifier: number;
+        agentCount: number;
+        verificationStrength: string;
+        credentials_summary: string;
+    } | {
+        message: string;
+        registered: false;
+        address: `0x${string}`;
+        network: "mainnet";
+    }>;
+    registerAgent(params?: RegisterSelfAgentParams): Promise<{
+        session_id: string;
+        qr_code_url: string;
+        qr_url: string;
+        deep_link: string;
+        expires_at: string;
+        instructions: string;
+    }>;
+    checkRegistration(sessionId: string): Promise<{
+        status: "deregistered";
+        message: string;
+        proof_expires_at?: undefined;
+        agent_id?: undefined;
+        agent_address?: undefined;
+        private_key_hex?: undefined;
+        tx_hash?: undefined;
+    } | {
+        status: "refreshed";
+        proof_expires_at: string;
+        message: string;
+        agent_id?: undefined;
+        agent_address?: undefined;
+        private_key_hex?: undefined;
+        tx_hash?: undefined;
+    } | {
+        status: "verified";
+        agent_id: number;
+        agent_address: string;
+        private_key_hex: string;
+        tx_hash: string | undefined;
+        message: string;
+        proof_expires_at?: undefined;
+    } | {
+        status: "pending";
+        message: string;
+        proof_expires_at?: undefined;
+        agent_id?: undefined;
+        agent_address?: undefined;
+        private_key_hex?: undefined;
+        tx_hash?: undefined;
+    } | {
+        status: "expired";
+        message: string;
+        proof_expires_at?: undefined;
+        agent_id?: undefined;
+        agent_address?: undefined;
+        private_key_hex?: undefined;
+        tx_hash?: undefined;
+    }>;
+    refreshProof(params?: {
+        agentId?: number;
+    }): Promise<{
+        session_id: string;
+        qr_code_url: string;
+        qr_url: string;
+        deep_link: string;
+        expires_at: string;
+        instructions: string;
+    }>;
+    deregisterAgent(): Promise<{
+        session_id: string;
+        qr_code_url: string;
+        qr_url: string;
+        deep_link: string;
+        expires_at: string;
+        instructions: string;
+    }>;
+    signRequest(params: {
+        method: string;
+        url: string;
+        body?: string;
+    }): Promise<{
+        headers: {
+            "x-self-agent-address": `0x${string}`;
+            "x-self-agent-signature": `0x${string}`;
+            "x-self-agent-timestamp": string;
+        };
+        instructions: string;
+    }>;
+    authenticatedFetch(params: {
+        method: string;
+        url: string;
+        body?: string;
+        contentType?: string;
+    }): Promise<{
+        status: number;
+        body: string;
+        truncated: boolean;
+    }>;
+    /** Reserved for future on-chain Self writes (e.g. metadata updates). */
+    protected taggedCalldata(data: Hex): Hex;
+}