@andrewkimjoseph/celina-sdk 0.9.8 → 0.9.9

package/build/src/abis/uniswap-v4-quoter.js

@@ -0,0 +1,64 @@
+export const v4QuoterAbi = [
+    {
+        name: "quoteExactInputSingle",
+        type: "function",
+        stateMutability: "nonpayable",
+        inputs: [
+            {
+                name: "params",
+                type: "tuple",
+                components: [
+                    {
+                        name: "poolKey",
+                        type: "tuple",
+                        components: [
+                            { name: "currency0", type: "address" },
+                            { name: "currency1", type: "address" },
+                            { name: "fee", type: "uint24" },
+                            { name: "tickSpacing", type: "int24" },
+                            { name: "hooks", type: "address" },
+                        ],
+                    },
+                    { name: "zeroForOne", type: "bool" },
+                    { name: "exactAmount", type: "uint128" },
+                    { name: "hookData", type: "bytes" },
+                ],
+            },
+        ],
+        outputs: [
+            { name: "amountOut", type: "uint256" },
+            { name: "gasEstimate", type: "uint256" },
+        ],
+    },
+    {
+        name: "quoteExactInput",
+        type: "function",
+        stateMutability: "nonpayable",
+        inputs: [
+            {
+                name: "params",
+                type: "tuple",
+                components: [
+                    { name: "exactCurrency", type: "address" },
+                    {
+                        name: "path",
+                        type: "tuple[]",
+                        components: [
+                            { name: "intermediateCurrency", type: "address" },
+                            { name: "fee", type: "uint24" },
+                            { name: "tickSpacing", type: "int24" },
+                            { name: "hooks", type: "address" },
+                            { name: "hookData", type: "bytes" },
+                        ],
+                    },
+                    { name: "exactAmount", type: "uint128" },
+                ],
+            },
+        ],
+        outputs: [
+            { name: "amountOut", type: "uint256" },
+            { name: "gasEstimate", type: "uint256" },
+        ],
+    },
+];
+//# sourceMappingURL=uniswap-v4-quoter.js.map

package/build/src/abis/uniswap-v4-quoter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniswap-v4-quoter.js","sourceRoot":"","sources":["../../../src/abis/uniswap-v4-quoter.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB;QACE,IAAI,EAAE,uBAAuB;QAC7B,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,YAAY;QAC7B,MAAM,EAAE;YACN;gBACE,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,OAAO;gBACb,UAAU,EAAE;oBACV;wBACE,IAAI,EAAE,SAAS;wBACf,IAAI,EAAE,OAAO;wBACb,UAAU,EAAE;4BACV,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;4BACtC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;4BACtC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE;4BAC/B,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,EAAE;4BACtC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;yBACnC;qBACF;oBACD,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE;oBACpC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE;oBACxC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE;iBACpC;aACF;SACF;QACD,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;YACtC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE;SACzC;KACF;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,YAAY;QAC7B,MAAM,EAAE;YACN;gBACE,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,OAAO;gBACb,UAAU,EAAE;oBACV,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,SAAS,EAAE;oBAC1C;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,SAAS;wBACf,UAAU,EAAE;4BACV,EAAE,IAAI,EAAE,sBAAsB,EAAE,IAAI,EAAE,SAAS,EAAE;4BACjD,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE;4BAC/B,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,EAAE;4BACtC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;4BAClC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE;yBACpC;qBACF;oBACD,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE;iBACzC;aACF;SACF;QACD,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;YACtC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE;SACzC;KACF;CACO,CAAC"}

package/build/src/abis/universal-router.d.ts

@@ -0,0 +1,16 @@
+export declare const universalRouterAbi: readonly [{
+    readonly name: "execute";
+    readonly type: "function";
+    readonly stateMutability: "payable";
+    readonly inputs: readonly [{
+        readonly name: "commands";
+        readonly type: "bytes";
+    }, {
+        readonly name: "inputs";
+        readonly type: "bytes[]";
+    }, {
+        readonly name: "deadline";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [];
+}];

package/build/src/abis/universal-router.js

@@ -0,0 +1,14 @@
+export const universalRouterAbi = [
+    {
+        name: "execute",
+        type: "function",
+        stateMutability: "payable",
+        inputs: [
+            { name: "commands", type: "bytes" },
+            { name: "inputs", type: "bytes[]" },
+            { name: "deadline", type: "uint256" },
+        ],
+        outputs: [],
+    },
+];
+//# sourceMappingURL=universal-router.js.map

package/build/src/abis/universal-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"universal-router.js","sourceRoot":"","sources":["../../../src/abis/universal-router.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC;QACE,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,SAAS;QAC1B,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE;YACnC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;YACnC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE;SACtC;QACD,OAAO,EAAE,EAAE;KACZ;CACO,CAAC"}

package/build/src/abis/validators-minimal.d.ts

@@ -0,0 +1,65 @@
+/** Minimal Validators ABI for group and member reads (full ABI in validators.json). */
+export declare const validatorsMinimalAbi: readonly [{
+    readonly type: "function";
+    readonly name: "getRegisteredValidators";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address[]";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getValidator";
+    readonly inputs: readonly [{
+        readonly name: "validator";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "ecdsaPublicKey";
+        readonly type: "bytes";
+    }, {
+        readonly name: "blsPublicKey";
+        readonly type: "bytes";
+    }, {
+        readonly name: "affiliation";
+        readonly type: "address";
+    }, {
+        readonly name: "score";
+        readonly type: "uint256";
+    }, {
+        readonly name: "signer";
+        readonly type: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getValidatorGroup";
+    readonly inputs: readonly [{
+        readonly name: "group";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "members";
+        readonly type: "address[]";
+    }, {
+        readonly name: "commission";
+        readonly type: "uint256";
+    }, {
+        readonly name: "lastSlashed";
+        readonly type: "uint256";
+    }, {
+        readonly name: "name";
+        readonly type: "string";
+    }, {
+        readonly name: "membersHistory";
+        readonly type: "uint256[]";
+    }, {
+        readonly name: "membersHistoryLength";
+        readonly type: "uint256";
+    }, {
+        readonly name: "slashingMultiplier";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}];

package/build/src/abis/validators-minimal.js

@@ -0,0 +1,39 @@
+/** Minimal Validators ABI for group and member reads (full ABI in validators.json). */
+export const validatorsMinimalAbi = [
+    {
+        type: "function",
+        name: "getRegisteredValidators",
+        inputs: [],
+        outputs: [{ name: "", type: "address[]" }],
+        stateMutability: "view",
+    },
+    {
+        type: "function",
+        name: "getValidator",
+        inputs: [{ name: "validator", type: "address" }],
+        outputs: [
+            { name: "ecdsaPublicKey", type: "bytes" },
+            { name: "blsPublicKey", type: "bytes" },
+            { name: "affiliation", type: "address" },
+            { name: "score", type: "uint256" },
+            { name: "signer", type: "address" },
+        ],
+        stateMutability: "view",
+    },
+    {
+        type: "function",
+        name: "getValidatorGroup",
+        inputs: [{ name: "group", type: "address" }],
+        outputs: [
+            { name: "members", type: "address[]" },
+            { name: "commission", type: "uint256" },
+            { name: "lastSlashed", type: "uint256" },
+            { name: "name", type: "string" },
+            { name: "membersHistory", type: "uint256[]" },
+            { name: "membersHistoryLength", type: "uint256" },
+            { name: "slashingMultiplier", type: "uint256" },
+        ],
+        stateMutability: "view",
+    },
+];
+//# sourceMappingURL=validators-minimal.js.map

package/build/src/abis/validators-minimal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators-minimal.js","sourceRoot":"","sources":["../../../src/abis/validators-minimal.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,yBAAyB;QAC/B,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;QAC1C,eAAe,EAAE,MAAM;KACxB;IACD;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,cAAc;QACpB,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAChD,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,OAAO,EAAE;YACzC,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,OAAO,EAAE;YACvC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE;YACxC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;YAClC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;SACpC;QACD,eAAe,EAAE,MAAM;KACxB;IACD;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,mBAAmB;QACzB,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC5C,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE;YACtC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE;YACvC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE;YACxC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE;YAChC,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,EAAE;YAC7C,EAAE,IAAI,EAAE,sBAAsB,EAAE,IAAI,EAAE,SAAS,EAAE;YACjD,EAAE,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,SAAS,EAAE;SAChD;QACD,eAAe,EAAE,MAAM;KACxB;CACO,CAAC"}

package/build/src/analytics/amplitude.d.ts

@@ -0,0 +1,11 @@
+import type { SdkConfig } from "../config/sdk-config.js";
+export type TrackMcpToolContext = {
+    methodKey: string;
+    args: readonly unknown[];
+};
+/** Test-only hook to assert telemetry without calling Amplitude. */
+export declare function setTrackFnForTests(fn: ((eventName: string, config: SdkConfig, context: TrackMcpToolContext, userId: string | undefined) => void) | null): void;
+/** Fire-and-forget MCP tool name event; never throws to callers. */
+export declare function trackMcpTool(eventName: string, config: SdkConfig, context?: TrackMcpToolContext): void;
+/** Await any queued Amplitude events (e.g. end of a Next.js route via `after()`). */
+export declare function flushCelinaAnalytics(): Promise<void>;

package/build/src/analytics/amplitude.js

@@ -0,0 +1,76 @@
+import { isAnalyticsEnabled, resolveAmplitudeApiKey, resolveDeviceId, } from "./config.js";
+import { resolveAnalyticsWallet } from "./wallet-context.js";
+let initialized = false;
+let testTrackFn = null;
+/** Test-only hook to assert telemetry without calling Amplitude. */
+export function setTrackFnForTests(fn) {
+    testTrackFn = fn;
+    initialized = false;
+}
+async function ensureInit(config) {
+    const apiKey = resolveAmplitudeApiKey(config);
+    if (!apiKey) {
+        return false;
+    }
+    if (initialized) {
+        return true;
+    }
+    try {
+        const amplitude = await import("@amplitude/analytics-node");
+        amplitude.init(apiKey);
+        initialized = true;
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Fire-and-forget MCP tool name event; never throws to callers. */
+export function trackMcpTool(eventName, config, context) {
+    if (!isAnalyticsEnabled(config)) {
+        return;
+    }
+    const userId = context
+        ? resolveAnalyticsWallet(context.methodKey, context.args, config)
+        : undefined;
+    if (testTrackFn) {
+        try {
+            testTrackFn(eventName, config, context ?? { methodKey: "", args: [] }, userId);
+        }
+        catch {
+            // ignore test hook failures
+        }
+        return;
+    }
+    void (async () => {
+        try {
+            if (!(await ensureInit(config))) {
+                return;
+            }
+            const amplitude = await import("@amplitude/analytics-node");
+            await amplitude.track(eventName, undefined, {
+                device_id: resolveDeviceId(config),
+                ...(userId ? { user_id: userId } : {}),
+            }).promise;
+            // Serverless (Vercel, Lambda) freezes when the handler returns unless we flush.
+            await amplitude.flush().promise;
+        }
+        catch {
+            // telemetry must not break SDK reads
+        }
+    })();
+}
+/** Await any queued Amplitude events (e.g. end of a Next.js route via `after()`). */
+export async function flushCelinaAnalytics() {
+    if (!initialized) {
+        return;
+    }
+    try {
+        const amplitude = await import("@amplitude/analytics-node");
+        await amplitude.flush().promise;
+    }
+    catch {
+        // ignore flush failures
+    }
+}
+//# sourceMappingURL=amplitude.js.map

package/build/src/analytics/amplitude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"amplitude.js","sourceRoot":"","sources":["../../../src/analytics/amplitude.ts"],"names":[],"mappings":"AACA,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAO7D,IAAI,WAAW,GAAG,KAAK,CAAC;AACxB,IAAI,WAAW,GAOJ,IAAI,CAAC;AAEhB,oEAAoE;AACpE,MAAM,UAAU,kBAAkB,CAChC,EAOQ;IAER,WAAW,GAAG,EAAE,CAAC;IACjB,WAAW,GAAG,KAAK,CAAC;AACtB,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,MAAiB;IACzC,MAAM,MAAM,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC9C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;QAC5D,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvB,WAAW,GAAG,IAAI,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,YAAY,CAC1B,SAAiB,EACjB,MAAiB,EACjB,OAA6B;IAE7B,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;QAChC,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,OAAO;QACpB,CAAC,CAAC,sBAAsB,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;QACjE,CAAC,CAAC,SAAS,CAAC;IAEd,IAAI,WAAW,EAAE,CAAC;QAChB,IAAI,CAAC;YACH,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;QACjF,CAAC;QAAC,MAAM,CAAC;YACP,4BAA4B;QAC9B,CAAC;QACD,OAAO;IACT,CAAC;IAED,KAAK,CAAC,KAAK,IAAI,EAAE;QACf,IAAI,CAAC;YACH,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;gBAChC,OAAO;YACT,CAAC;YACD,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;YAC5D,MAAM,SAAS,CAAC,KAAK,CAAC,SAAS,EAAE,SAAS,EAAE;gBAC1C,SAAS,EAAE,eAAe,CAAC,MAAM,CAAC;gBAClC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACvC,CAAC,CAAC,OAAO,CAAC;YACX,gFAAgF;YAChF,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC;QAClC,CAAC;QAAC,MAAM,CAAC;YACP,qCAAqC;QACvC,CAAC;IACH,CAAC,CAAC,EAAE,CAAC;AACP,CAAC;AAED,qFAAqF;AACrF,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACxC,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO;IACT,CAAC;IACD,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;QAC5D,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,wBAAwB;IAC1B,CAAC;AACH,CAAC"}

package/build/src/analytics/config.d.ts

@@ -0,0 +1,7 @@
+import type { SdkConfig } from "../config/sdk-config.js";
+/** Public Amplitude project ingestion key (bundled for default telemetry on Node installs). */
+export declare const DEFAULT_AMPLITUDE_API_KEY = "f36f9a7fdc253ed864072edc627b2a55";
+/** Whether Amplitude read telemetry is active for this process. */
+export declare function isAnalyticsEnabled(config: SdkConfig): boolean;
+export declare function resolveAmplitudeApiKey(config: SdkConfig): string | undefined;
+export declare function resolveDeviceId(config: SdkConfig): string;

package/build/src/analytics/config.js

@@ -0,0 +1,28 @@
+/** Public Amplitude project ingestion key (bundled for default telemetry on Node installs). */
+export const DEFAULT_AMPLITUDE_API_KEY = "f36f9a7fdc253ed864072edc627b2a55";
+const DEFAULT_DEVICE_ID = "celina-sdk";
+/** Whether Amplitude read telemetry is active for this process. */
+export function isAnalyticsEnabled(config) {
+    if (typeof process === "undefined") {
+        return false;
+    }
+    if (process.env.CELINA_ANALYTICS_DISABLED === "1") {
+        return false;
+    }
+    if (config.analyticsEnabled === false) {
+        return false;
+    }
+    return true;
+}
+export function resolveAmplitudeApiKey(config) {
+    if (!isAnalyticsEnabled(config)) {
+        return undefined;
+    }
+    return (config.amplitudeApiKey ??
+        process.env.AMPLITUDE_API_KEY ??
+        DEFAULT_AMPLITUDE_API_KEY);
+}
+export function resolveDeviceId(config) {
+    return config.analyticsDeviceId ?? DEFAULT_DEVICE_ID;
+}
+//# sourceMappingURL=config.js.map

package/build/src/analytics/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/analytics/config.ts"],"names":[],"mappings":"AAEA,+FAA+F;AAC/F,MAAM,CAAC,MAAM,yBAAyB,GAAG,kCAAkC,CAAC;AAE5E,MAAM,iBAAiB,GAAG,YAAY,CAAC;AAEvC,mEAAmE;AACnE,MAAM,UAAU,kBAAkB,CAAC,MAAiB;IAClD,IAAI,OAAO,OAAO,KAAK,WAAW,EAAE,CAAC;QACnC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,yBAAyB,KAAK,GAAG,EAAE,CAAC;QAClD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,MAAM,CAAC,gBAAgB,KAAK,KAAK,EAAE,CAAC;QACtC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;QAChC,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,CACL,MAAM,CAAC,eAAe;QACtB,OAAO,CAAC,GAAG,CAAC,iBAAiB;QAC7B,yBAAyB,CAC1B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,OAAO,MAAM,CAAC,iBAAiB,IAAI,iBAAiB,CAAC;AACvD,CAAC"}

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;