@andrewkimjoseph/celina-sdk 0.9.7 → 0.9.9

package/build/src/analytics/consumer-package.d.ts

@@ -0,0 +1,9 @@
+/** Amplitude-safe id from npm `package.json` `name` (strip `@`, `/` and `-` → `_`). */
+export declare function sanitizePackageDeviceId(name: string): string;
+/**
+ * npm package name of the app that called `createCelinaClient()`, sanitized for Amplitude.
+ * Returns `undefined` when detection fails or the consumer is the SDK itself.
+ */
+export declare function detectConsumerPackageName(stack?: string): string | undefined;
+/** Test-only: clear cached consumer detection between cases. */
+export declare function resetConsumerPackageDetectionForTests(): void;

package/build/src/analytics/consumer-package.js

@@ -0,0 +1,143 @@
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join, resolve, sep } from "node:path";
+import { fileURLToPath } from "node:url";
+const SDK_PACKAGE_NAME = "@andrewkimjoseph/celina-sdk";
+const SDK_DEVICE_IDS = new Set(["andrewkimjoseph_celina_sdk", "celina-sdk"]);
+let detectionCached = false;
+let detectedDeviceId;
+/** Amplitude-safe id from npm `package.json` `name` (strip `@`, `/` and `-` → `_`). */
+export function sanitizePackageDeviceId(name) {
+    const stripped = name.startsWith("@") ? name.slice(1) : name;
+    return stripped.replace(/\//g, "_").replace(/-/g, "_");
+}
+function getSdkPackageRoot() {
+    let dir = dirname(fileURLToPath(import.meta.url));
+    for (let i = 0; i < 24; i++) {
+        const pkgPath = join(dir, "package.json");
+        if (existsSync(pkgPath)) {
+            try {
+                const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+                if (pkg.name === SDK_PACKAGE_NAME) {
+                    return dir;
+                }
+            }
+            catch {
+                // ignore malformed package.json
+            }
+        }
+        const parent = dirname(dir);
+        if (parent === dir) {
+            break;
+        }
+        dir = parent;
+    }
+    return undefined;
+}
+function isSdkFramePath(filePath, sdkRoot) {
+    const normalized = resolve(filePath);
+    if (sdkRoot) {
+        const root = resolve(sdkRoot);
+        if (normalized === root || normalized.startsWith(root + sep)) {
+            return true;
+        }
+    }
+    return normalized.includes(`${sep}node_modules${sep}@andrewkimjoseph${sep}celina-sdk${sep}`);
+}
+function readPackageNameFromFile(filePath) {
+    let dir = dirname(resolve(filePath));
+    for (let i = 0; i < 24; i++) {
+        const pkgPath = join(dir, "package.json");
+        if (existsSync(pkgPath)) {
+            try {
+                const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+                if (typeof pkg.name === "string" && pkg.name.length > 0) {
+                    return pkg.name;
+                }
+            }
+            catch {
+                return undefined;
+            }
+        }
+        const parent = dirname(dir);
+        if (parent === dir) {
+            break;
+        }
+        dir = parent;
+    }
+    return undefined;
+}
+function parseStackFramePaths(stack) {
+    const paths = [];
+    for (const line of stack.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed.startsWith("at ")) {
+            continue;
+        }
+        const parenMatch = /\(([^)]+)\)/.exec(trimmed);
+        let loc = parenMatch?.[1];
+        if (!loc) {
+            const bare = /^at (?:async )?(?:.+ )?(.+)$/.exec(trimmed);
+            loc = bare?.[1];
+        }
+        if (!loc) {
+            continue;
+        }
+        let filePath = loc.trim();
+        if (filePath.startsWith("file://")) {
+            try {
+                filePath = fileURLToPath(filePath);
+            }
+            catch {
+                continue;
+            }
+        }
+        filePath = filePath.replace(/:\d+:\d+$/, "").replace(/:\d+$/, "");
+        if (filePath) {
+            paths.push(filePath);
+        }
+    }
+    return paths;
+}
+/**
+ * npm package name of the app that called `createCelinaClient()`, sanitized for Amplitude.
+ * Returns `undefined` when detection fails or the consumer is the SDK itself.
+ */
+export function detectConsumerPackageName(stack) {
+    if (detectionCached) {
+        return detectedDeviceId;
+    }
+    detectionCached = true;
+    detectedDeviceId = undefined;
+    if (typeof process === "undefined") {
+        return detectedDeviceId;
+    }
+    try {
+        const stackTrace = stack ?? new Error().stack ?? "";
+        const sdkRoot = getSdkPackageRoot();
+        for (const framePath of parseStackFramePaths(stackTrace)) {
+            if (isSdkFramePath(framePath, sdkRoot)) {
+                continue;
+            }
+            const rawName = readPackageNameFromFile(framePath);
+            if (!rawName) {
+                continue;
+            }
+            const deviceId = sanitizePackageDeviceId(rawName);
+            if (SDK_DEVICE_IDS.has(deviceId)) {
+                continue;
+            }
+            detectedDeviceId = deviceId;
+            return detectedDeviceId;
+        }
+    }
+    catch {
+        detectedDeviceId = undefined;
+    }
+    return detectedDeviceId;
+}
+/** Test-only: clear cached consumer detection between cases. */
+export function resetConsumerPackageDetectionForTests() {
+    detectionCached = false;
+    detectedDeviceId = undefined;
+}
+//# sourceMappingURL=consumer-package.js.map

package/build/src/analytics/consumer-package.js.map

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

package/build/src/analytics/mcp-tool-events.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 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 declare const MCP_TOOL_EVENT_BY_SDK_METHOD: Readonly<Record<string, string>>;

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

@@ -0,0 +1,53 @@
+/**
+ * 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 = {
+    "aave.getBalances": "get_aave_balances",
+    "account.getAccount": "get_account",
+    "account.getWalletAddress": "get_wallet_address",
+    "blockchain.getBlock": "get_block",
+    "blockchain.getBlockWithTransactions": "get_block",
+    "blockchain.getLatestBlocks": "get_latest_blocks",
+    "blockchain.getNetworkStatus": "get_network_status",
+    "blockchain.getTransaction": "get_transaction",
+    "contract.callFunction": "call_contract_function",
+    "contract.estimateGas": "estimate_contract_gas",
+    "ens.resolveEns": "resolve_ens",
+    "gooddollar.estimateReserveSwap.sell": "estimate_gooddollar_reserve_swap",
+    "gooddollar.getIdentityLink": "get_gooddollar_identity_link",
+    "gooddollar.getReserveQuote.buy": "get_gooddollar_reserve_quote",
+    "gooddollar.getReserveQuote.buy.exactOut": "get_gooddollar_reserve_quote",
+    "gooddollar.getReserveQuote.sell": "get_gooddollar_reserve_quote",
+    "gooddollar.getReserveQuote.sell.exactOut": "get_gooddollar_reserve_quote",
+    "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/src/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,kBAAkB,EAAE,mBAAmB;IACvC,oBAAoB,EAAE,aAAa;IACnC,0BAA0B,EAAE,oBAAoB;IAChD,qBAAqB,EAAE,WAAW;IAClC,qCAAqC,EAAE,WAAW;IAClD,4BAA4B,EAAE,mBAAmB;IACjD,6BAA6B,EAAE,oBAAoB;IACnD,2BAA2B,EAAE,iBAAiB;IAC9C,uBAAuB,EAAE,wBAAwB;IACjD,sBAAsB,EAAE,uBAAuB;IAC/C,gBAAgB,EAAE,aAAa;IAC/B,qCAAqC,EAAE,kCAAkC;IACzE,4BAA4B,EAAE,8BAA8B;IAC5D,gCAAgC,EAAE,8BAA8B;IAChE,yCAAyC,EAAE,8BAA8B;IACzE,iCAAiC,EAAE,8BAA8B;IACjE,0CAA0C,EAAE,8BAA8B;IAC1E,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/src/analytics/wallet-context.d.ts

@@ -0,0 +1,11 @@
+import type { SdkConfig } from "../config/sdk-config.js";
+/** Validate and normalize a Celo address for telemetry `user_id`. */
+export declare function normalizeWalletAddress(value: unknown): string | undefined;
+/** Extract wallet from read args using catalog-generated rules. */
+export declare function extractWalletFromReadArgs(methodKey: string, args: readonly unknown[]): string | undefined;
+/** Run async/sync work with a request-scoped analytics wallet (singleton SDK clients). */
+export declare function runWithAnalyticsWallet<T>(address: string | undefined, fn: () => T): T;
+/** Resolve wallet for telemetry: read args → ALS → config default. */
+export declare function resolveAnalyticsWallet(methodKey: string, args: readonly unknown[], config: SdkConfig): string | undefined;
+/** Test-only: clear ALS between cases. */
+export declare function resetAnalyticsWalletStorageForTests(): void;

package/build/src/analytics/wallet-context.js

@@ -0,0 +1,81 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+import { WALLET_EXTRACT_BY_SDK_METHOD } from "./wallet-extract.js";
+const WALLET_RE = /^0x[a-fA-F0-9]{40}$/;
+const analyticsWalletStorage = new AsyncLocalStorage();
+/** Validate and normalize a Celo address for telemetry `user_id`. */
+export function normalizeWalletAddress(value) {
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    if (!WALLET_RE.test(trimmed)) {
+        return undefined;
+    }
+    return trimmed.toLowerCase();
+}
+function walletFromArgValue(value) {
+    const direct = normalizeWalletAddress(value);
+    if (direct) {
+        return direct;
+    }
+    if (value && typeof value === "object" && !Array.isArray(value)) {
+        for (const key of [
+            "address",
+            "wallet_address",
+            "from",
+            "owner",
+            "accountAddress",
+            "fromAddress",
+        ]) {
+            const nested = normalizeWalletAddress(value[key]);
+            if (nested) {
+                return nested;
+            }
+        }
+    }
+    return undefined;
+}
+/** Extract wallet from read args using catalog-generated rules. */
+export function extractWalletFromReadArgs(methodKey, args) {
+    const rule = WALLET_EXTRACT_BY_SDK_METHOD[methodKey];
+    if (!rule) {
+        return undefined;
+    }
+    if (rule.positional !== undefined) {
+        const fromPos = walletFromArgValue(args[rule.positional]);
+        if (fromPos) {
+            return fromPos;
+        }
+    }
+    if (rule.objectKeys) {
+        for (const arg of args) {
+            if (!arg || typeof arg !== "object" || Array.isArray(arg)) {
+                continue;
+            }
+            const obj = arg;
+            for (const key of rule.objectKeys) {
+                const found = normalizeWalletAddress(obj[key]);
+                if (found) {
+                    return found;
+                }
+            }
+        }
+    }
+    return undefined;
+}
+/** Run async/sync work with a request-scoped analytics wallet (singleton SDK clients). */
+export function runWithAnalyticsWallet(address, fn) {
+    const normalized = normalizeWalletAddress(address);
+    return analyticsWalletStorage.run(normalized, fn);
+}
+/** Resolve wallet for telemetry: read args → ALS → config default. */
+export function resolveAnalyticsWallet(methodKey, args, config) {
+    return (extractWalletFromReadArgs(methodKey, args) ??
+        analyticsWalletStorage.getStore() ??
+        normalizeWalletAddress(config.analyticsWalletAddress));
+}
+/** Test-only: clear ALS between cases. */
+export function resetAnalyticsWalletStorageForTests() {
+    analyticsWalletStorage.disable();
+}
+//# sourceMappingURL=wallet-context.js.map

package/build/src/analytics/wallet-context.js.map

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

package/build/src/analytics/wallet-extract.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Generated by scripts/generate-mcp-analytics-map.mjs — do not edit by hand.
+ * Catalog-derived rules for extracting wallet addresses from SDK read call args.
+ */
+export type WalletExtractRule = {
+    positional?: number;
+    objectKeys?: readonly string[];
+};
+export declare const WALLET_EXTRACT_BY_SDK_METHOD: Readonly<Record<string, WalletExtractRule>>;

package/build/src/analytics/wallet-extract.js

@@ -0,0 +1,21 @@
+export const WALLET_EXTRACT_BY_SDK_METHOD = {
+    "aave.getBalances": { positional: 0, objectKeys: ["address"] },
+    "account.getAccount": { positional: 0, objectKeys: ["address"] },
+    "contract.callFunction": { objectKeys: ["address"] },
+    "contract.estimateGas": { objectKeys: ["address"] },
+    "gooddollar.getIdentityLink": { positional: 0, objectKeys: ["address"] },
+    "gooddollar.getUbiClaimEligibility": { positional: 0, objectKeys: ["address"] },
+    "gooddollar.getWhitelistingInfo": { positional: 0, objectKeys: ["address"] },
+    "nft.getNftBalance": { objectKeys: ["address"] },
+    "nft.getNftInfo": { objectKeys: ["address"] },
+    "self.verifySelfAgent": { objectKeys: ["address", "agent_address"] },
+    "staking.getActivatableStakes": { positional: 0, objectKeys: ["address"] },
+    "staking.getStakingBalances": { positional: 0, objectKeys: ["address"] },
+    "staking.getValidatorGroupDetails": { objectKeys: ["address"] },
+    "token.getBalances": { objectKeys: ["address"] },
+    "token.getStablecoinBalances": { positional: 0, objectKeys: ["address"] },
+    "token.getTokenBalance": { positional: 1, objectKeys: ["address"] },
+    "transaction.estimateSend": { positional: 1 },
+    "transaction.estimateTransaction": { objectKeys: ["from"] },
+};
+//# sourceMappingURL=wallet-extract.js.map

package/build/src/analytics/wallet-extract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-extract.js","sourceRoot":"","sources":["../../../src/analytics/wallet-extract.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,4BAA4B,GAErC;IACF,kBAAkB,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,SAAS,CAAC,EAAE;IAC9D,oBAAoB,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,SAAS,CAAC,EAAE;IAChE,uBAAuB,EAAE,EAAE,UAAU,EAAE,CAAC,SAAS,CAAC,EAAE;IACpD,sBAAsB,EAAE,EAAE,UAAU,EAAE,CAAC,SAAS,CAAC,EAAE;IACnD,4BAA4B,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,SAAS,CAAC,EAAE;IACxE,mCAAmC,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,SAAS,CAAC,EAAE;IAC/E,gCAAgC,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,SAAS,CAAC,EAAE;IAC5E,mBAAmB,EAAE,EAAE,UAAU,EAAE,CAAC,SAAS,CAAC,EAAE;IAChD,gBAAgB,EAAE,EAAE,UAAU,EAAE,CAAC,SAAS,CAAC,EAAE;IAC7C,sBAAsB,EAAE,EAAE,UAAU,EAAE,CAAC,SAAS,EAAC,eAAe,CAAC,EAAE;IACnE,8BAA8B,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,SAAS,CAAC,EAAE;IAC1E,4BAA4B,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,SAAS,CAAC,EAAE;IACxE,kCAAkC,EAAE,EAAE,UAAU,EAAE,CAAC,SAAS,CAAC,EAAE;IAC/D,mBAAmB,EAAE,EAAE,UAAU,EAAE,CAAC,SAAS,CAAC,EAAE;IAChD,6BAA6B,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,SAAS,CAAC,EAAE;IACzE,uBAAuB,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,SAAS,CAAC,EAAE;IACnE,0BAA0B,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE;IAC7C,iCAAiC,EAAE,EAAE,UAAU,EAAE,CAAC,MAAM,CAAC,EAAE;CACnD,CAAC"}

package/build/src/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/src/analytics/wrap-service.js

@@ -0,0 +1,38 @@
+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 methodKey = `${serviceKey}.${prop}`;
+            const eventName = MCP_TOOL_EVENT_BY_SDK_METHOD[methodKey];
+            if (!eventName) {
+                return value.bind(target);
+            }
+            const fn = value;
+            return (...args) => {
+                const result = fn.apply(target, args);
+                const context = { methodKey, args };
+                if (result !== null && typeof result === "object" && "then" in result) {
+                    return result.then((resolved) => {
+                        trackMcpTool(eventName, config, context);
+                        return resolved;
+                    });
+                }
+                trackMcpTool(eventName, config, context);
+                return result;
+            };
+        },
+    });
+}
+//# sourceMappingURL=wrap-service.js.map

package/build/src/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,GAAG,UAAU,IAAI,IAAI,EAAE,CAAC;YAC1C,MAAM,SAAS,GAAG,4BAA4B,CAAC,SAAS,CAAC,CAAC;YAC1D,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,MAAM,OAAO,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;gBACpC,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,EAAE,OAAO,CAAC,CAAC;wBACzC,OAAO,QAAQ,CAAC;oBAClB,CAAC,CAAC,CAAC;gBACL,CAAC;gBACD,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;gBACzC,OAAO,MAAM,CAAC;YAChB,CAAC,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/build/src/clients/celo-client.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Cached viem public client for Celo mainnet RPC reads.
+ */
+import { type PublicClient } from "viem";
+import type { SdkConfig } from "../config/sdk-config.js";
+/** viem public client bundle for Celo mainnet. */
+export interface CeloClients {
+    public: PublicClient;
+}
+/** Lazily constructs and caches a Celo mainnet public client from `SdkConfig`. */
+export declare class CeloClientFactory {
+    private readonly config;
+    private clients;
+    constructor(config: SdkConfig);
+    /** Return a shared public client (created on first call). */
+    getClients(): CeloClients;
+}

package/build/src/clients/celo-client.js

@@ -0,0 +1,28 @@
+/**
+ * Cached viem public client for Celo mainnet RPC reads.
+ */
+import { createPublicClient, http, } from "viem";
+import { CHAIN, DEFAULT_RPC_URL } from "../config/chains.js";
+/** Lazily constructs and caches a Celo mainnet public client from `SdkConfig`. */
+export class CeloClientFactory {
+    config;
+    clients = null;
+    constructor(config) {
+        this.config = config;
+    }
+    /** Return a shared public client (created on first call). */
+    getClients() {
+        if (this.clients) {
+            return this.clients;
+        }
+        const rpcUrl = this.config.rpcUrl ?? DEFAULT_RPC_URL;
+        const transport = http(rpcUrl);
+        const publicClient = createPublicClient({
+            chain: CHAIN,
+            transport,
+        });
+        this.clients = { public: publicClient };
+        return this.clients;
+    }
+}
+//# sourceMappingURL=celo-client.js.map

package/build/src/clients/celo-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"celo-client.js","sourceRoot":"","sources":["../../../src/clients/celo-client.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,kBAAkB,EAClB,IAAI,GAEL,MAAM,MAAM,CAAC;AAEd,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAO7D,kFAAkF;AAClF,MAAM,OAAO,iBAAiB;IAGC;IAFrB,OAAO,GAAuB,IAAI,CAAC;IAE3C,YAA6B,MAAiB;QAAjB,WAAM,GAAN,MAAM,CAAW;IAAG,CAAC;IAElD,6DAA6D;IAC7D,UAAU;QACR,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC,OAAO,CAAC;QACtB,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,eAAe,CAAC;QACrD,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/B,MAAM,YAAY,GAAG,kBAAkB,CAAC;YACtC,KAAK,EAAE,KAAK;YACZ,SAAS;SACV,CAAiB,CAAC;QAEnB,IAAI,CAAC,OAAO,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;QACxC,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;CACF"}

package/build/src/clients/ens-client.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Ethereum mainnet public client for ENS resolution (CCIP-read gateway).
+ */
+import { type PublicClient } from "viem";
+import type { SdkConfig } from "../config/sdk-config.js";
+/** Default Ethereum RPC when `ethRpcUrl` is not set in `SdkConfig`. */
+export declare const DEFAULT_ETH_RPC_URL = "https://ethereum.publicnode.com";
+/** CCIP-read gateway used by viem ENS helpers. */
+export declare const ENS_CCIP_GATEWAY = "https://ccip.ens.xyz";
+/** Lazily constructs and caches an Ethereum mainnet client for ENS lookups. */
+export declare class EnsClientFactory {
+    private readonly config;
+    private client;
+    constructor(config: SdkConfig);
+    /** Return a shared Ethereum public client (created on first call). */
+    getClient(): PublicClient;
+}

package/build/src/clients/ens-client.js

@@ -0,0 +1,30 @@
+/**
+ * Ethereum mainnet public client for ENS resolution (CCIP-read gateway).
+ */
+import { createPublicClient, http } from "viem";
+import { mainnet } from "viem/chains";
+/** Default Ethereum RPC when `ethRpcUrl` is not set in `SdkConfig`. */
+export const DEFAULT_ETH_RPC_URL = "https://ethereum.publicnode.com";
+/** CCIP-read gateway used by viem ENS helpers. */
+export const ENS_CCIP_GATEWAY = "https://ccip.ens.xyz";
+/** Lazily constructs and caches an Ethereum mainnet client for ENS lookups. */
+export class EnsClientFactory {
+    config;
+    client = null;
+    constructor(config) {
+        this.config = config;
+    }
+    /** Return a shared Ethereum public client (created on first call). */
+    getClient() {
+        if (this.client) {
+            return this.client;
+        }
+        const rpcUrl = this.config.ethRpcUrl ?? DEFAULT_ETH_RPC_URL;
+        this.client = createPublicClient({
+            chain: mainnet,
+            transport: http(rpcUrl, { timeout: 15_000 }),
+        });
+        return this.client;
+    }
+}
+//# sourceMappingURL=ens-client.js.map

package/build/src/clients/ens-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ens-client.js","sourceRoot":"","sources":["../../../src/clients/ens-client.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,kBAAkB,EAAE,IAAI,EAAqB,MAAM,MAAM,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGtC,uEAAuE;AACvE,MAAM,CAAC,MAAM,mBAAmB,GAAG,iCAAiC,CAAC;AAErE,kDAAkD;AAClD,MAAM,CAAC,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AAEvD,+EAA+E;AAC/E,MAAM,OAAO,gBAAgB;IAGE;IAFrB,MAAM,GAAwB,IAAI,CAAC;IAE3C,YAA6B,MAAiB;QAAjB,WAAM,GAAN,MAAM,CAAW;IAAG,CAAC;IAElD,sEAAsE;IACtE,SAAS;QACP,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,mBAAmB,CAAC;QAC5D,IAAI,CAAC,MAAM,GAAG,kBAAkB,CAAC;YAC/B,KAAK,EAAE,OAAO;YACd,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;SAC7C,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF"}

package/build/src/clients/mento-sdk.d.ts

@@ -0,0 +1,2 @@
+export declare const Mento: typeof import("@mento-protocol/mento-sdk").Mento, ChainId: typeof import("@mento-protocol/mento-sdk").ChainId, deadlineFromMinutes: typeof import("@mento-protocol/mento-sdk").deadlineFromMinutes, RouteNotFoundError: typeof import("@mento-protocol/mento-sdk").RouteNotFoundError, FXMarketClosedError: typeof import("@mento-protocol/mento-sdk").FXMarketClosedError;
+export type { CallParams } from "@mento-protocol/mento-sdk";

package/build/src/clients/mento-sdk.js

@@ -0,0 +1,9 @@
+import { createRequire } from "node:module";
+/**
+ * @mento-protocol/mento-sdk's ESM build omits .js extensions on internal imports.
+ * Load the CJS entry via createRequire until upstream fixes exports.
+ */
+const require = createRequire(import.meta.url);
+const mentoSdk = require("@mento-protocol/mento-sdk");
+export const { Mento, ChainId, deadlineFromMinutes, RouteNotFoundError, FXMarketClosedError, } = mentoSdk;
+//# sourceMappingURL=mento-sdk.js.map

package/build/src/clients/mento-sdk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mento-sdk.js","sourceRoot":"","sources":["../../../src/clients/mento-sdk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C;;;GAGG;AACH,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/C,MAAM,QAAQ,GAAG,OAAO,CAAC,2BAA2B,CAA+C,CAAC;AAEpG,MAAM,CAAC,MAAM,EACX,KAAK,EACL,OAAO,EACP,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,GACpB,GAAG,QAAQ,CAAC"}

package/build/src/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;