@andrewkimjoseph/celina-sdk 0.2.12 → 0.4.0

package/build/analytics/mcp-tool-events.js

@@ -0,0 +1,56 @@
+/**
+ * Generated by scripts/generate-mcp-analytics-map.mjs — do not edit by hand.
+ * Maps SDK method keys (catalog OperationSpec.id) to MCP tool event names.
+ */
+export const MCP_TOOL_EVENT_BY_SDK_METHOD = {
+    "account.getAccount": "get_account",
+    "blockchain.getBlock": "get_block",
+    "blockchain.getLatestBlocks": "get_latest_blocks",
+    "blockchain.getNetworkStatus": "get_network_status",
+    "blockchain.getTransaction": "get_transaction",
+    "carbon.explorePair": "explore_carbon_pair",
+    "carbon.findOpportunities": "find_carbon_opportunities",
+    "carbon.getActivity": "get_carbon_activity",
+    "carbon.getPriceHistory": "get_carbon_price_history",
+    "carbon.getProtocolStats": "get_carbon_protocol_stats",
+    "carbon.getStrategies": "get_carbon_strategies",
+    "carbon.getStrategy": "get_carbon_strategy",
+    "carbon.getTradeQuote": "get_carbon_trade_quote",
+    "carbon.help": "carbon_help",
+    "carbon.learn": "carbon_learn",
+    "carbon.resolveToken": "resolve_carbon_token",
+    "carbon.simulateStrategy": "simulate_carbon_strategy",
+    "contract.callFunction": "call_contract_function",
+    "contract.estimateGas": "estimate_contract_gas",
+    "ens.resolveEns": "resolve_ens",
+    "gooddollar.getUbiClaimEligibility": "get_gooddollar_ubi_entitlement",
+    "gooddollar.getWhitelistingInfo": "get_gooddollar_whitelisting_info",
+    "governance.getGovernanceProposals": "get_governance_proposals",
+    "governance.getProposalDetails": "get_proposal_details",
+    "mentoFx.estimateFx": "estimate_mento_fx",
+    "mentoFx.getFxQuote": "get_mento_fx_quote",
+    "nft.getNftBalance": "get_nft_balance",
+    "nft.getNftInfo": "get_nft_info",
+    "self.authenticatedSelfFetch": "authenticated_self_fetch",
+    "self.checkSelfRegistration": "check_self_registration",
+    "self.getSelfIdentity": "get_self_identity",
+    "self.lookupSelfAgent": "lookup_self_agent",
+    "self.signSelfRequest": "sign_self_request",
+    "self.verifySelfAgent": "verify_self_agent",
+    "self.verifySelfRequest": "verify_self_request",
+    "staking.getActivatableStakes": "get_activatable_stakes",
+    "staking.getStakingBalances": "get_staking_balances",
+    "staking.getTotalStakingInfo": "get_total_staking_info",
+    "staking.getValidatorGroupDetails": "get_validator_group_details",
+    "staking.getValidatorGroups": "get_validator_groups",
+    "token.getBalances": "get_celo_balances",
+    "token.getStablecoinBalances": "get_stablecoin_balances",
+    "token.getTokenBalance": "get_token_balance",
+    "token.getTokenInfo": "get_token_info",
+    "transaction.estimateSend": "estimate_send",
+    "transaction.estimateTransaction": "estimate_transaction",
+    "transaction.getGasFeeData": "get_gas_fee_data",
+    "uniswap.estimateSwap": "estimate_uniswap_swap",
+    "uniswap.getSwapQuote": "get_uniswap_quote",
+};
+//# sourceMappingURL=mcp-tool-events.js.map

package/build/analytics/mcp-tool-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tool-events.js","sourceRoot":"","sources":["../../src/analytics/mcp-tool-events.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAqC;IAC5E,oBAAoB,EAAE,aAAa;IACnC,qBAAqB,EAAE,WAAW;IAClC,4BAA4B,EAAE,mBAAmB;IACjD,6BAA6B,EAAE,oBAAoB;IACnD,2BAA2B,EAAE,iBAAiB;IAC9C,oBAAoB,EAAE,qBAAqB;IAC3C,0BAA0B,EAAE,2BAA2B;IACvD,oBAAoB,EAAE,qBAAqB;IAC3C,wBAAwB,EAAE,0BAA0B;IACpD,yBAAyB,EAAE,2BAA2B;IACtD,sBAAsB,EAAE,uBAAuB;IAC/C,oBAAoB,EAAE,qBAAqB;IAC3C,sBAAsB,EAAE,wBAAwB;IAChD,aAAa,EAAE,aAAa;IAC5B,cAAc,EAAE,cAAc;IAC9B,qBAAqB,EAAE,sBAAsB;IAC7C,yBAAyB,EAAE,0BAA0B;IACrD,uBAAuB,EAAE,wBAAwB;IACjD,sBAAsB,EAAE,uBAAuB;IAC/C,gBAAgB,EAAE,aAAa;IAC/B,mCAAmC,EAAE,gCAAgC;IACrE,gCAAgC,EAAE,kCAAkC;IACpE,mCAAmC,EAAE,0BAA0B;IAC/D,+BAA+B,EAAE,sBAAsB;IACvD,oBAAoB,EAAE,mBAAmB;IACzC,oBAAoB,EAAE,oBAAoB;IAC1C,mBAAmB,EAAE,iBAAiB;IACtC,gBAAgB,EAAE,cAAc;IAChC,6BAA6B,EAAE,0BAA0B;IACzD,4BAA4B,EAAE,yBAAyB;IACvD,sBAAsB,EAAE,mBAAmB;IAC3C,sBAAsB,EAAE,mBAAmB;IAC3C,sBAAsB,EAAE,mBAAmB;IAC3C,sBAAsB,EAAE,mBAAmB;IAC3C,wBAAwB,EAAE,qBAAqB;IAC/C,8BAA8B,EAAE,wBAAwB;IACxD,4BAA4B,EAAE,sBAAsB;IACpD,6BAA6B,EAAE,wBAAwB;IACvD,kCAAkC,EAAE,6BAA6B;IACjE,4BAA4B,EAAE,sBAAsB;IACpD,mBAAmB,EAAE,mBAAmB;IACxC,6BAA6B,EAAE,yBAAyB;IACxD,uBAAuB,EAAE,mBAAmB;IAC5C,oBAAoB,EAAE,gBAAgB;IACtC,0BAA0B,EAAE,eAAe;IAC3C,iCAAiC,EAAE,sBAAsB;IACzD,2BAA2B,EAAE,kBAAkB;IAC/C,sBAAsB,EAAE,uBAAuB;IAC/C,sBAAsB,EAAE,mBAAmB;CACnC,CAAC"}

package/build/analytics/wrap-service.d.ts

@@ -0,0 +1,5 @@
+import type { SdkConfig } from "../config/sdk-config.js";
+/**
+ * Wrap a domain service so catalog-mapped async reads emit Amplitude events (MCP tool names).
+ */
+export declare function wrapServiceForAnalytics<T extends object>(serviceKey: string, service: T, config: SdkConfig): T;

package/build/analytics/wrap-service.js

@@ -0,0 +1,36 @@
+import { trackMcpTool } from "./amplitude.js";
+import { isAnalyticsEnabled } from "./config.js";
+import { MCP_TOOL_EVENT_BY_SDK_METHOD } from "./mcp-tool-events.js";
+/**
+ * Wrap a domain service so catalog-mapped async reads emit Amplitude events (MCP tool names).
+ */
+export function wrapServiceForAnalytics(serviceKey, service, config) {
+    if (!isAnalyticsEnabled(config)) {
+        return service;
+    }
+    return new Proxy(service, {
+        get(target, prop, receiver) {
+            const value = Reflect.get(target, prop, receiver);
+            if (typeof prop !== "string" || typeof value !== "function") {
+                return value;
+            }
+            const eventName = MCP_TOOL_EVENT_BY_SDK_METHOD[`${serviceKey}.${prop}`];
+            if (!eventName) {
+                return value.bind(target);
+            }
+            const fn = value;
+            return (...args) => {
+                const result = fn.apply(target, args);
+                if (result !== null && typeof result === "object" && "then" in result) {
+                    return result.then((resolved) => {
+                        trackMcpTool(eventName, config);
+                        return resolved;
+                    });
+                }
+                trackMcpTool(eventName, config);
+                return result;
+            };
+        },
+    });
+}
+//# sourceMappingURL=wrap-service.js.map

package/build/analytics/wrap-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrap-service.js","sourceRoot":"","sources":["../../src/analytics/wrap-service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AAEpE;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,UAAkB,EAClB,OAAU,EACV,MAAiB;IAEjB,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;QAChC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO,IAAI,KAAK,CAAC,OAAO,EAAE;QACxB,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ;YACxB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;YAClD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;gBAC5D,OAAO,KAAK,CAAC;YACf,CAAC;YAED,MAAM,SAAS,GAAG,4BAA4B,CAAC,GAAG,UAAU,IAAI,IAAI,EAAE,CAAC,CAAC;YACxE,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC5B,CAAC;YAED,MAAM,EAAE,GAAG,KAAwC,CAAC;YACpD,OAAO,CAAC,GAAG,IAAe,EAAE,EAAE;gBAC5B,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;gBACtC,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;oBACtE,OAAQ,MAA2B,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;wBACpD,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;wBAChC,OAAO,QAAQ,CAAC;oBAClB,CAAC,CAAC,CAAC;gBACL,CAAC;gBACD,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;gBAChC,OAAO,MAAM,CAAC;YAChB,CAAC,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/build/clients/carbon-rest.d.ts

@@ -0,0 +1,17 @@
+import type { CarbonRestSuccess } from "../types/carbon.js";
+export declare class CarbonRestError extends Error {
+    readonly toolName: string;
+    readonly statusCode?: number | undefined;
+    constructor(message: string, toolName: string, statusCode?: number | undefined);
+}
+export type CarbonRestBody = Record<string, unknown>;
+export declare class CarbonRestClient {
+    private readonly baseUrl;
+    private readonly timeoutMs;
+    constructor(baseUrl?: string, timeoutMs?: number);
+    private url;
+    /**
+     * POST to Carbon MCP REST. Always injects `chain: celo` unless caller overrides.
+     */
+    postTool<T extends CarbonRestSuccess = CarbonRestSuccess>(toolName: string, body?: CarbonRestBody): Promise<T>;
+}

package/build/clients/carbon-rest.js

@@ -0,0 +1,59 @@
+import { CARBON_CHAIN, DEFAULT_CARBON_REST_BASE_URL } from "../config/carbon.js";
+const DEFAULT_TIMEOUT_MS = 60_000;
+export class CarbonRestError extends Error {
+    toolName;
+    statusCode;
+    constructor(message, toolName, statusCode) {
+        super(message);
+        this.toolName = toolName;
+        this.statusCode = statusCode;
+        this.name = "CarbonRestError";
+    }
+}
+export class CarbonRestClient {
+    baseUrl;
+    timeoutMs;
+    constructor(baseUrl = DEFAULT_CARBON_REST_BASE_URL, timeoutMs = DEFAULT_TIMEOUT_MS) {
+        this.baseUrl = baseUrl;
+        this.timeoutMs = timeoutMs;
+    }
+    url(toolName) {
+        const base = this.baseUrl.replace(/\/$/, "");
+        return `${base}/tools/${toolName}`;
+    }
+    /**
+     * POST to Carbon MCP REST. Always injects `chain: celo` unless caller overrides.
+     */
+    async postTool(toolName, body = {}) {
+        const payload = {
+            chain: CARBON_CHAIN,
+            ...body,
+        };
+        const response = await fetch(this.url(toolName), {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(payload),
+            signal: AbortSignal.timeout(this.timeoutMs),
+        });
+        const text = await response.text();
+        let json;
+        try {
+            json = text ? JSON.parse(text) : {};
+        }
+        catch {
+            throw new CarbonRestError(`Carbon API returned non-JSON (${response.status})`, toolName, response.status);
+        }
+        if (json.error && typeof json.error === "string") {
+            throw new CarbonRestError(json.error, toolName, response.status);
+        }
+        if (json.status === "not_found") {
+            const msg = typeof json.message === "string" ? json.message : "Carbon API not found";
+            throw new CarbonRestError(msg, toolName, response.status);
+        }
+        if (!response.ok) {
+            throw new CarbonRestError(`Carbon API HTTP ${response.status}`, toolName, response.status);
+        }
+        return json;
+    }
+}
+//# sourceMappingURL=carbon-rest.js.map

package/build/clients/carbon-rest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"carbon-rest.js","sourceRoot":"","sources":["../../src/clients/carbon-rest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AAGjF,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAElC,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAG7B;IACA;IAHX,YACE,OAAe,EACN,QAAgB,EAChB,UAAmB;QAE5B,KAAK,CAAC,OAAO,CAAC,CAAC;QAHN,aAAQ,GAAR,QAAQ,CAAQ;QAChB,eAAU,GAAV,UAAU,CAAS;QAG5B,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAID,MAAM,OAAO,gBAAgB;IAER;IACA;IAFnB,YACmB,UAAkB,4BAA4B,EAC9C,YAAoB,kBAAkB;QADtC,YAAO,GAAP,OAAO,CAAuC;QAC9C,cAAS,GAAT,SAAS,CAA6B;IACtD,CAAC;IAEI,GAAG,CAAC,QAAgB;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC7C,OAAO,GAAG,IAAI,UAAU,QAAQ,EAAE,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CACZ,QAAgB,EAChB,OAAuB,EAAE;QAEzB,MAAM,OAAO,GAAG;YACd,KAAK,EAAE,YAAY;YACnB,GAAG,IAAI;SACR,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE;YAC/C,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;YAC7B,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;SAC5C,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,IAA6B,CAAC;QAClC,IAAI,CAAC;YACH,IAAI,GAAG,IAAI,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAA6B,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,eAAe,CACvB,iCAAiC,QAAQ,CAAC,MAAM,GAAG,EACnD,QAAQ,EACR,QAAQ,CAAC,MAAM,CAChB,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,KAAK,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACjD,MAAM,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QACnE,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAChC,MAAM,GAAG,GACP,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,sBAAsB,CAAC;YAC3E,MAAM,IAAI,eAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC5D,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,eAAe,CACvB,mBAAmB,QAAQ,CAAC,MAAM,EAAE,EACpC,QAAQ,EACR,QAAQ,CAAC,MAAM,CAChB,CAAC;QACJ,CAAC;QAED,OAAO,IAAS,CAAC;IACnB,CAAC;CACF"}

package/build/clients/carbon-sdk.d.ts

@@ -0,0 +1,31 @@
+import type { SerializedPreparedFlow } from "../types/prepared.js";
+/** Minimal Toolkit surface used for trade fallback. */
+type CarbonToolkit = {
+    getTradeData: (sourceToken: string, targetToken: string, amount: string, isTradeByTarget: boolean) => Promise<{
+        tradeActions: unknown[];
+        totalSourceAmount: string;
+        totalTargetAmount: string;
+    }>;
+    composeTradeBySourceTransaction: (sourceToken: string, targetToken: string, tradeActions: unknown[], deadline: string, minReturn: string) => Promise<{
+        to?: string | null;
+        data?: string | null;
+        value?: bigint | null;
+    }>;
+};
+export declare class CarbonSdkClient {
+    private readonly rpcUrl;
+    private toolkit;
+    private initPromise;
+    constructor(rpcUrl: string);
+    getToolkit(): Promise<CarbonToolkit>;
+    private initialize;
+    getTradeQuoteFallback(sourceToken: string, targetToken: string, amount: string, isTradeByTarget: boolean): Promise<{
+        tradeData: {
+            tradeActions: unknown[];
+            totalSourceAmount: string;
+            totalTargetAmount: string;
+        };
+    }>;
+    prepareTradeFallback(from: `0x${string}`, sourceToken: string, targetToken: string, amount: string, isTradeByTarget: boolean, minReturnOrMaxInput: string, deadlineMinutes?: number): Promise<SerializedPreparedFlow>;
+}
+export {};

package/build/clients/carbon-sdk.js

@@ -0,0 +1,48 @@
+import { JsonRpcProvider } from "ethers";
+import { ContractsApi } from "@bancor/carbon-sdk/contracts-api";
+import { initSyncedCache } from "@bancor/carbon-sdk/chain-cache";
+import { CELO_CARBON_CONTRACTS, CELO_CHAIN_ID, } from "../config/carbon.js";
+import { populatedTransactionToPreparedFlow } from "../utils/carbon-prepared-flow.js";
+const MAX_BLOCK_AGE = 2000;
+export class CarbonSdkClient {
+    rpcUrl;
+    toolkit = null;
+    initPromise = null;
+    constructor(rpcUrl) {
+        this.rpcUrl = rpcUrl;
+    }
+    async getToolkit() {
+        if (this.toolkit)
+            return this.toolkit;
+        if (!this.initPromise) {
+            this.initPromise = this.initialize();
+        }
+        this.toolkit = await this.initPromise;
+        return this.toolkit;
+    }
+    async initialize() {
+        const strategyMod = (await import("@bancor/carbon-sdk/strategy-management"));
+        const { Toolkit } = strategyMod;
+        const provider = new JsonRpcProvider(this.rpcUrl, CELO_CHAIN_ID, {
+            staticNetwork: true,
+        });
+        const api = new ContractsApi(provider, CELO_CARBON_CONTRACTS);
+        const { cache, startDataSync } = initSyncedCache(api.reader, undefined, MAX_BLOCK_AGE);
+        const toolkit = new Toolkit(api, cache);
+        await startDataSync();
+        return toolkit;
+    }
+    async getTradeQuoteFallback(sourceToken, targetToken, amount, isTradeByTarget) {
+        const toolkit = await this.getToolkit();
+        const tradeData = await toolkit.getTradeData(sourceToken, targetToken, amount, isTradeByTarget);
+        return { tradeData };
+    }
+    async prepareTradeFallback(from, sourceToken, targetToken, amount, isTradeByTarget, minReturnOrMaxInput, deadlineMinutes = 5) {
+        const toolkit = await this.getToolkit();
+        const tradeData = await toolkit.getTradeData(sourceToken, targetToken, amount, isTradeByTarget);
+        const deadline = String(Math.floor(Date.now() / 1000) + deadlineMinutes * 60);
+        const tx = await toolkit.composeTradeBySourceTransaction(sourceToken, targetToken, tradeData.tradeActions, deadline, minReturnOrMaxInput);
+        return populatedTransactionToPreparedFlow(from, tx, `Carbon swap ${sourceToken} → ${targetToken}`);
+    }
+}
+//# sourceMappingURL=carbon-sdk.js.map

package/build/clients/carbon-sdk.js.map

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

package/build/clients/self-api.d.ts

@@ -0,0 +1,82 @@
+import { type SelfRegistrationMode } from "../config/self.js";
+export declare class SelfApiError extends Error {
+    constructor(message: string);
+}
+export declare class SelfExpiredSessionError extends Error {
+    constructor(message?: string);
+}
+export interface SelfRegistrationDisclosures {
+    minimumAge?: number;
+    ofac?: boolean;
+}
+export interface SelfRegistrationResult {
+    agentId: number;
+    agentAddress: string;
+    credentials?: unknown;
+    txHash?: string;
+}
+export interface SelfRefreshResult {
+    proofExpiresAt: Date;
+}
+export interface SelfRegistrationSession {
+    sessionToken: string;
+    stage: string;
+    deepLink: string;
+    scanUrl?: string;
+    agentAddress: string;
+    expiresAt: string;
+    timeRemainingMs?: number;
+    humanInstructions: string[];
+    waitForCompletion(opts?: {
+        timeoutMs?: number;
+        pollIntervalMs?: number;
+    }): Promise<SelfRegistrationResult>;
+    exportKey(): Promise<string>;
+}
+export interface SelfRefreshSession {
+    sessionToken: string;
+    stage: string;
+    deepLink: string;
+    scanUrl?: string;
+    expiresAt: string;
+    timeRemainingMs?: number;
+    humanInstructions: string[];
+    waitForCompletion(opts?: {
+        timeoutMs?: number;
+        pollIntervalMs?: number;
+    }): Promise<SelfRefreshResult>;
+}
+export interface SelfDeregistrationSession {
+    sessionToken: string;
+    stage: string;
+    deepLink: string;
+    scanUrl?: string;
+    expiresAt: string;
+    timeRemainingMs?: number;
+    humanInstructions: string[];
+    waitForCompletion(opts?: {
+        timeoutMs?: number;
+        pollIntervalMs?: number;
+    }): Promise<void>;
+}
+export declare function requestRegistration(opts: {
+    mode?: SelfRegistrationMode;
+    disclosures?: SelfRegistrationDisclosures;
+    humanAddress?: string;
+    agentName?: string;
+    agentDescription?: string;
+    apiBase?: string;
+}): Promise<SelfRegistrationSession>;
+export declare function requestDeregistration(opts: {
+    agentAddress: string;
+    disclosures?: SelfRegistrationDisclosures;
+    apiBase?: string;
+}): Promise<SelfDeregistrationSession>;
+export declare function requestProofRefresh(opts: {
+    agentId: number;
+    disclosures?: SelfRegistrationDisclosures;
+    apiBase?: string;
+}): Promise<SelfRefreshSession>;
+export declare function getAgentInfo(agentId: number, apiBase?: string): Promise<Record<string, unknown>>;
+export declare function getAgentsForHuman(address: string, apiBase?: string): Promise<Record<string, unknown>>;
+export declare function selfQrUrl(sessionToken: string, apiBase?: string): string;

package/build/clients/self-api.js

@@ -0,0 +1,242 @@
+import { SELF_API_BASE, SELF_API_NETWORK, SELF_CHAIN_ID, } from "../config/self.js";
+const DEFAULT_POLL_INTERVAL_MS = 5000;
+const DEFAULT_TIMEOUT_MS = 30 * 60 * 1000;
+export class SelfApiError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "SelfApiError";
+    }
+}
+export class SelfExpiredSessionError extends Error {
+    constructor(message = "Session expired. Start a new registration flow.") {
+        super(message);
+        this.name = "SelfExpiredSessionError";
+    }
+}
+function resolveApiBase(apiBase) {
+    return (apiBase ?? process.env.SELF_AGENT_API_BASE ?? SELF_API_BASE).replace(/\/+$/, "");
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function apiFetch(url, init) {
+    const res = await fetch(url, init);
+    const body = (await res.json());
+    if (!res.ok) {
+        const errorMsg = typeof body.error === "string" ? body.error : `HTTP ${res.status}`;
+        throw new SelfApiError(errorMsg);
+    }
+    return body;
+}
+function sessionAuthHeaders(sessionToken) {
+    return { Authorization: `Bearer ${sessionToken}` };
+}
+async function fetchSessionStatus(apiBase, path, sessionToken) {
+    return apiFetch(`${apiBase}${path}?token=${encodeURIComponent(sessionToken)}`, { headers: sessionAuthHeaders(sessionToken) });
+}
+function handleSessionStatusError(error, expiredMessage) {
+    if (error instanceof SelfApiError &&
+        error.message.toLowerCase().includes("expired")) {
+        throw new SelfExpiredSessionError(expiredMessage);
+    }
+    throw error;
+}
+function optionalScanUrl(data) {
+    return typeof data.scanUrl === "string" ? data.scanUrl : undefined;
+}
+function buildRegistrationSession(data, apiBase) {
+    let currentToken = String(data.sessionToken);
+    return {
+        sessionToken: currentToken,
+        stage: String(data.stage),
+        deepLink: String(data.deepLink),
+        scanUrl: optionalScanUrl(data),
+        agentAddress: String(data.agentAddress),
+        expiresAt: String(data.expiresAt),
+        timeRemainingMs: typeof data.timeRemainingMs === "number" ? data.timeRemainingMs : undefined,
+        humanInstructions: Array.isArray(data.humanInstructions)
+            ? data.humanInstructions.map(String)
+            : [],
+        async waitForCompletion(opts) {
+            const timeout = opts?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+            const interval = opts?.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+            const deadline = Date.now() + timeout;
+            while (Date.now() < deadline) {
+                await sleep(interval);
+                let status;
+                try {
+                    status = await fetchSessionStatus(apiBase, "/api/agent/register/status", currentToken);
+                }
+                catch (error) {
+                    handleSessionStatusError(error, "Session expired. Start a new registration flow.");
+                }
+                currentToken = String(status.sessionToken);
+                if (status.stage === "completed") {
+                    return {
+                        agentId: Number(status.agentId),
+                        agentAddress: String(status.agentAddress ?? data.agentAddress),
+                        credentials: status.credentials,
+                        txHash: typeof status.txHash === "string" ? status.txHash : undefined,
+                    };
+                }
+                if (status.stage === "failed") {
+                    throw new SelfApiError("Registration failed on-chain.");
+                }
+                if (status.stage === "expired") {
+                    throw new SelfExpiredSessionError();
+                }
+            }
+            throw new SelfApiError(`Registration did not complete within ${timeout}ms. Call check_self_registration again to resume polling.`);
+        },
+        async exportKey() {
+            const result = await apiFetch(`${apiBase}/api/agent/register/export`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    ...sessionAuthHeaders(currentToken),
+                },
+                body: JSON.stringify({ token: currentToken }),
+            });
+            return result.privateKey;
+        },
+    };
+}
+function buildRefreshSession(data, apiBase) {
+    let currentToken = String(data.sessionToken);
+    return {
+        sessionToken: currentToken,
+        stage: String(data.stage),
+        deepLink: String(data.deepLink),
+        scanUrl: optionalScanUrl(data),
+        expiresAt: String(data.expiresAt),
+        timeRemainingMs: typeof data.timeRemainingMs === "number" ? data.timeRemainingMs : undefined,
+        humanInstructions: Array.isArray(data.humanInstructions)
+            ? data.humanInstructions.map(String)
+            : [],
+        async waitForCompletion(opts) {
+            const timeout = opts?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+            const interval = opts?.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+            const deadline = Date.now() + timeout;
+            while (Date.now() < deadline) {
+                await sleep(interval);
+                let status;
+                try {
+                    status = await fetchSessionStatus(apiBase, "/api/agent/refresh/status", currentToken);
+                }
+                catch (error) {
+                    handleSessionStatusError(error, "Proof refresh session expired. Call refresh_self_proof to start a new session.");
+                }
+                currentToken = String(status.sessionToken);
+                if (status.stage === "completed") {
+                    const expiresAtRaw = status.proofExpiresAt;
+                    const proofExpiresAt = typeof expiresAtRaw === "string" || typeof expiresAtRaw === "number"
+                        ? new Date(expiresAtRaw)
+                        : new Date(Date.now() + 365 * 24 * 60 * 60 * 1000);
+                    return { proofExpiresAt };
+                }
+                if (status.stage === "failed") {
+                    throw new SelfApiError("Proof refresh failed on-chain.");
+                }
+                if (status.stage === "expired") {
+                    throw new SelfExpiredSessionError("Proof refresh session expired. Call refresh_self_proof to start a new session.");
+                }
+            }
+            throw new SelfApiError(`Proof refresh did not complete within ${timeout}ms. Call check_self_registration again to resume polling.`);
+        },
+    };
+}
+function buildDeregistrationSession(data, apiBase) {
+    let currentToken = String(data.sessionToken);
+    return {
+        sessionToken: currentToken,
+        stage: String(data.stage),
+        deepLink: String(data.deepLink),
+        scanUrl: optionalScanUrl(data),
+        expiresAt: String(data.expiresAt),
+        timeRemainingMs: typeof data.timeRemainingMs === "number" ? data.timeRemainingMs : undefined,
+        humanInstructions: Array.isArray(data.humanInstructions)
+            ? data.humanInstructions.map(String)
+            : [],
+        async waitForCompletion(opts) {
+            const timeout = opts?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+            const interval = opts?.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+            const deadline = Date.now() + timeout;
+            while (Date.now() < deadline) {
+                await sleep(interval);
+                let status;
+                try {
+                    status = await fetchSessionStatus(apiBase, "/api/agent/deregister/status", currentToken);
+                }
+                catch (error) {
+                    handleSessionStatusError(error, "Deregistration session expired. Call deregister_self_agent to start a new session.");
+                }
+                currentToken = String(status.sessionToken);
+                if (status.stage === "completed") {
+                    return;
+                }
+                if (status.stage === "failed") {
+                    throw new SelfApiError("Deregistration failed on-chain.");
+                }
+                if (status.stage === "expired") {
+                    throw new SelfExpiredSessionError("Deregistration session expired. Call deregister_self_agent to start a new session.");
+                }
+            }
+            throw new SelfApiError(`Deregistration did not complete within ${timeout}ms. Call check_self_registration again to resume polling.`);
+        },
+    };
+}
+export async function requestRegistration(opts) {
+    const base = resolveApiBase(opts.apiBase);
+    const payload = {
+        mode: opts.mode ?? "wallet-free",
+        network: SELF_API_NETWORK,
+        disclosures: opts.disclosures,
+        humanAddress: opts.humanAddress,
+        agentName: opts.agentName,
+        agentDescription: opts.agentDescription,
+    };
+    const data = await apiFetch(`${base}/api/agent/register`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(payload),
+    });
+    return buildRegistrationSession(data, base);
+}
+export async function requestDeregistration(opts) {
+    const base = resolveApiBase(opts.apiBase);
+    const data = await apiFetch(`${base}/api/agent/deregister`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+            network: SELF_API_NETWORK,
+            agentAddress: opts.agentAddress,
+            disclosures: opts.disclosures,
+        }),
+    });
+    return buildDeregistrationSession(data, base);
+}
+export async function requestProofRefresh(opts) {
+    const base = resolveApiBase(opts.apiBase);
+    const data = await apiFetch(`${base}/api/agent/refresh`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+            agentId: opts.agentId,
+            network: SELF_API_NETWORK,
+            disclosures: opts.disclosures,
+        }),
+    });
+    return buildRefreshSession(data, base);
+}
+export async function getAgentInfo(agentId, apiBase) {
+    const base = resolveApiBase(apiBase);
+    return apiFetch(`${base}/api/agent/info/${SELF_CHAIN_ID}/${agentId}`);
+}
+export async function getAgentsForHuman(address, apiBase) {
+    const base = resolveApiBase(apiBase);
+    return apiFetch(`${base}/api/agent/agents/${SELF_CHAIN_ID}/${address}`);
+}
+export function selfQrUrl(sessionToken, apiBase) {
+    return `${resolveApiBase(apiBase)}/scan/${sessionToken}`;
+}
+//# sourceMappingURL=self-api.js.map

package/build/clients/self-api.js.map

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

package/build/config/carbon.d.ts

@@ -0,0 +1,12 @@
+/** Carbon DeFi on Celo mainnet — contract addresses and API defaults. */
+export declare const CARBON_CHAIN: "celo";
+export declare const DEFAULT_CARBON_REST_BASE_URL = "https://mcp.carbondefi.xyz";
+/** Matches @bancor/carbon-sdk `ContractsConfig` for Celo (carbon-contracts deployments). */
+export declare const CELO_CARBON_CONTRACTS: {
+    readonly carbonControllerAddress: "0x6619871118D144c1c28eC3b23036FC1f0829ed3a";
+    readonly voucherAddress: "0x5E994Ac7d65d81f51a76e0bB5a236C6fDA8dBF9A";
+    /** Multicall3 on Celo mainnet. */
+    readonly multiCallAddress: "0xcA11bde05977b3631167028862bE2a173976CA11";
+    readonly carbonBatcherAddress: "0xa977879684EecE2015AE879DC120c8a1C00718f7";
+};
+export declare const CELO_CHAIN_ID = 42220;

package/build/config/carbon.js

@@ -0,0 +1,13 @@
+/** Carbon DeFi on Celo mainnet — contract addresses and API defaults. */
+export const CARBON_CHAIN = "celo";
+export const DEFAULT_CARBON_REST_BASE_URL = "https://mcp.carbondefi.xyz";
+/** Matches @bancor/carbon-sdk `ContractsConfig` for Celo (carbon-contracts deployments). */
+export const CELO_CARBON_CONTRACTS = {
+    carbonControllerAddress: "0x6619871118D144c1c28eC3b23036FC1f0829ed3a",
+    voucherAddress: "0x5E994Ac7d65d81f51a76e0bB5a236C6fDA8dBF9A",
+    /** Multicall3 on Celo mainnet. */
+    multiCallAddress: "0xcA11bde05977b3631167028862bE2a173976CA11",
+    carbonBatcherAddress: "0xa977879684EecE2015AE879DC120c8a1C00718f7",
+};
+export const CELO_CHAIN_ID = 42220;
+//# sourceMappingURL=carbon.js.map