@andrewkimjoseph/celina-sdk 0.9.7 → 0.9.9

package/build/src/config/chains.js

@@ -0,0 +1,319 @@
+/**
+ * Single token registry for Celo mainnet.
+ * Symbols resolve case-insensitively; Mento legacy tickers (cUSD, cKES, PUSO, …) map to XXXm.
+ */
+import { celo } from "viem/chains";
+export const CHAIN = celo;
+export const DEFAULT_RPC_URL = "https://forno.celo.org";
+/** Mento collateral address for native CELO (used by @mento-protocol/mento-sdk). */
+export const MENTO_CELO_ADDRESS = "0x471EcE3750Da237f93B8E339c536989b8978a438";
+export const KNOWN_TOKENS = [
+    {
+        symbol: "CELO",
+        address: "native",
+        aliases: ["WCELO", "cGLD"],
+        decimals: 18,
+    },
+    {
+        symbol: "USDm",
+        aliases: ["cUSD"],
+        address: "0x765de816845861e75a25fca122bb6898b8b1282a",
+        issuer: "Mento",
+        useCase: "US Dollar-pegged stablecoin (Mento Dollar)",
+        decimals: 18,
+    },
+    {
+        symbol: "EURm",
+        aliases: ["cEUR"],
+        address: "0xd8763cba276a3738e6de85b4b3bf5fded6d6ca73",
+        issuer: "Mento",
+        useCase: "Euro-pegged stablecoin (Mento Euro)",
+        decimals: 18,
+    },
+    {
+        symbol: "BRLm",
+        aliases: ["cREAL", "CREAL"],
+        address: "0xe8537a3d056da446677b9e9d6c5db704eaab4787",
+        issuer: "Mento",
+        useCase: "Brazilian Real-pegged stablecoin",
+        decimals: 18,
+    },
+    {
+        symbol: "XOFm",
+        aliases: ["eXOF"],
+        address: "0x73F93dcc49cB8A239e2032663e9475dd5ef29A08",
+        issuer: "Mento",
+        useCase: "CFA Franc-pegged stablecoin",
+        decimals: 18,
+    },
+    {
+        symbol: "KESm",
+        aliases: ["cKES"],
+        address: "0x456a3D042C0DbD3db53D5489e98dFb038553B0d0",
+        issuer: "Mento",
+        useCase: "Kenyan Shilling-pegged stablecoin",
+        decimals: 18,
+    },
+    {
+        symbol: "PHPm",
+        aliases: ["PUSO"],
+        address: "0x105d4A9306D2E55a71d2Eb95B81553AE1dC20d7B",
+        issuer: "Mento",
+        useCase: "Philippine Peso-pegged stablecoin",
+        decimals: 18,
+    },
+    {
+        symbol: "COPm",
+        aliases: ["cCOP"],
+        address: "0x8a567e2ae79ca692bd748ab832081c45de4041ea",
+        issuer: "Mento",
+        useCase: "Colombian Peso-pegged stablecoin",
+        decimals: 18,
+    },
+    {
+        symbol: "GBPm",
+        aliases: ["cGBP"],
+        address: "0xCCF663b1fF11028f0b19058d0f7B674004a40746",
+        issuer: "Mento",
+        useCase: "British Pound-pegged stablecoin",
+        decimals: 18,
+    },
+    {
+        symbol: "CADm",
+        aliases: ["cCAD"],
+        address: "0xff4Ab19391af240c311c54200a492233052B6325",
+        issuer: "Mento",
+        useCase: "Canadian Dollar-pegged stablecoin",
+        decimals: 18,
+    },
+    {
+        symbol: "AUDm",
+        aliases: ["cAUD"],
+        address: "0x7175504C455076F15c04A2F90a8e352281F492F9",
+        issuer: "Mento",
+        useCase: "Australian Dollar-pegged stablecoin",
+        decimals: 18,
+    },
+    {
+        symbol: "ZARm",
+        aliases: ["cZAR"],
+        address: "0x4c35853A3B4e647fD266f4de678dCc8fEC410BF6",
+        issuer: "Mento",
+        useCase: "South African Rand-pegged stablecoin",
+        decimals: 18,
+    },
+    {
+        symbol: "GHSm",
+        aliases: ["cGHS"],
+        address: "0xfAeA5F3404bbA20D3cc2f8C4B0A888F55a3c7313",
+        issuer: "Mento",
+        useCase: "Ghanaian Cedi-pegged stablecoin",
+        decimals: 18,
+    },
+    {
+        symbol: "NGNm",
+        aliases: ["cNGN", "CNGN"],
+        address: "0xE2702Bd97ee33c88c8f6f92DA3B733608aa76F71",
+        issuer: "Mento",
+        useCase: "Nigerian Naira-pegged stablecoin",
+        decimals: 18,
+    },
+    {
+        symbol: "JPYm",
+        aliases: ["cJPY"],
+        address: "0xc45eCF20f3CD864B32D9794d6f76814aE8892e20",
+        issuer: "Mento",
+        useCase: "Japanese Yen-pegged stablecoin",
+        decimals: 18,
+    },
+    {
+        symbol: "CHFm",
+        aliases: ["cCHF"],
+        address: "0xb55a79F398E759E43C95b979163f30eC87Ee131D",
+        issuer: "Mento",
+        useCase: "Swiss Franc-pegged stablecoin",
+        decimals: 18,
+    },
+    {
+        symbol: "USDT",
+        address: "0x48065fbBE25f71C9282ddf5e1cD6D6A887483D5e",
+        issuer: "Tether",
+        useCase: "Popular stablecoin on multiple blockchains",
+        decimals: 6,
+    },
+    {
+        symbol: "USDC",
+        address: "0xceba9300f2b948710d2653dd7b07f33a8b32118c",
+        issuer: "Circle",
+        useCase: "Widely used stablecoin with high liquidity",
+        decimals: 6,
+    },
+    {
+        symbol: "WETH",
+        address: "0xD221812de1BD094f35587EE8E174B07B6167D9Af",
+        issuer: "Wrapped Ether",
+        useCase: "Bridged ETH on Celo",
+        decimals: 18,
+    },
+    {
+        symbol: "vEUR",
+        address: "0x9346f43c1588b6df1d52bdd6bf846064f92d9cba",
+        issuer: "VNX",
+        useCase: "Euro-pegged stablecoin",
+        decimals: 18,
+    },
+    {
+        symbol: "vGBP",
+        address: "0x7ae4265ecfc1f31bc0e112dfcfe3d78e01f4bb7f",
+        issuer: "VNX",
+        useCase: "British Pound-pegged stablecoin",
+        decimals: 18,
+    },
+    {
+        symbol: "vCHF",
+        address: "0xc5ebea9984c485ec5d58ca5a2d376620d93af871",
+        issuer: "VNX",
+        useCase: "Swiss Franc-pegged stablecoin",
+        decimals: 18,
+    },
+    {
+        symbol: "USDM",
+        address: "0x59D9356E565Ab3A36dD77763Fc0d87fEaf85508C",
+        issuer: "Mountain Protocol",
+        useCase: "Yield-bearing stablecoin",
+        decimals: 18,
+    },
+    {
+        symbol: "USDA",
+        address: "0x0000206329b97DB379d5E1Bf586BbDB969C63274",
+        issuer: "Angle",
+        useCase: "Yield-bearing USD stablecoin",
+        decimals: 18,
+    },
+    {
+        symbol: "EURA",
+        address: "0xC16B81Af351BA9e64C1a069E3Ab18c244A1E3049",
+        issuer: "Angle",
+        useCase: "Yield-bearing Euro stablecoin",
+        decimals: 18,
+    },
+    {
+        symbol: "USDGLO",
+        address: "0x4f604735c1cf31399c6e711d5962b2b3e0225ad3",
+        issuer: "Glo Foundation",
+        useCase: "Impact-driven stablecoin supporting global causes",
+        decimals: 18,
+    },
+    {
+        symbol: "BRLA",
+        address: "0xfecb3f7c54e2caae9dc6ac9060a822d47e053760",
+        issuer: "BRLA Digital",
+        useCase: "Brazil-based stablecoin",
+        decimals: 18,
+    },
+    {
+        symbol: "COPM",
+        address: "0xC92E8Fc2947E32F2B574CCA9F2F12097A71d5606",
+        issuer: "Minteo",
+        useCase: "Fiat-backed Colombian Peso stablecoin",
+        decimals: 18,
+    },
+    {
+        symbol: "GoodDollar",
+        aliases: ["G$", "GD"],
+        address: "0x62B8B11039FcfE5aB0C56E502b1C372A3d2a9c7A",
+        issuer: "GoodDollar",
+        useCase: "UBI-focused token for financial inclusion",
+        decimals: 18,
+    },
+];
+/** In KNOWN_TOKENS but not fiat-pegged stablecoins — use get_token_balance / domain tools. */
+const STABLECOIN_SCAN_EXCLUDED = new Set(["GoodDollar", "WETH"]);
+export const STABLECOINS = KNOWN_TOKENS.filter((token) => token.address !== "native" &&
+    token.issuer !== undefined &&
+    token.useCase !== undefined &&
+    !STABLECOIN_SCAN_EXCLUDED.has(token.symbol));
+export const KNOWN_TOKEN_SYMBOLS = KNOWN_TOKENS.flatMap((token) => [
+    token.symbol,
+    ...(token.aliases ?? []),
+]).sort();
+function tokenMatchesInput(token, normalized, upper) {
+    if (token.symbol === normalized || token.symbol.toUpperCase() === upper) {
+        return true;
+    }
+    return (token.aliases?.some((alias) => alias === normalized || alias.toUpperCase() === upper) ?? false);
+}
+function alphanumericKey(value) {
+    return value.trim().toUpperCase().replace(/[^A-Z0-9]/g, "");
+}
+function findKnownTokenExact(token) {
+    const normalized = token.trim();
+    const upper = normalized.toUpperCase();
+    const lower = normalized.toLowerCase();
+    if (lower === MENTO_CELO_ADDRESS.toLowerCase()) {
+        return KNOWN_TOKENS.find((entry) => entry.symbol === "CELO");
+    }
+    return KNOWN_TOKENS.find((entry) => tokenMatchesInput(entry, normalized, upper) ||
+        (upper === "NATIVE" && entry.address === "native") ||
+        (entry.address !== "native" && entry.address.toLowerCase() === lower));
+}
+/** Fuzzy registry lookup for mistyped symbols (e.g. GD for G$/GoodDollar). */
+export function suggestKnownTokens(token) {
+    const normalized = token.trim();
+    const upper = normalized.toUpperCase();
+    const key = alphanumericKey(normalized);
+    if (!key) {
+        return [];
+    }
+    const matches = new Map();
+    for (const entry of KNOWN_TOKENS) {
+        if (tokenMatchesInput(entry, normalized, upper)) {
+            matches.set(entry.symbol, entry);
+            continue;
+        }
+        const symbolKey = alphanumericKey(entry.symbol);
+        if (symbolKey === key ||
+            (key.length >= 2 &&
+                (symbolKey.startsWith(key) || key.startsWith(symbolKey)))) {
+            matches.set(entry.symbol, entry);
+        }
+        for (const alias of entry.aliases ?? []) {
+            const aliasKey = alphanumericKey(alias);
+            if (aliasKey === key ||
+                (key.length >= 2 &&
+                    (aliasKey.startsWith(key) || key.startsWith(aliasKey)))) {
+                matches.set(entry.symbol, entry);
+            }
+        }
+    }
+    return [...matches.values()];
+}
+export function findKnownToken(token) {
+    const exact = findKnownTokenExact(token);
+    if (exact) {
+        return exact;
+    }
+    const suggestions = suggestKnownTokens(token);
+    return suggestions.length === 1 ? suggestions[0] : undefined;
+}
+export function toMentoTokenAddress(address) {
+    if (address === "native") {
+        return MENTO_CELO_ADDRESS;
+    }
+    return address;
+}
+export function resolveStablecoins(symbols) {
+    if (!symbols?.length) {
+        return STABLECOINS;
+    }
+    const wanted = symbols.map((symbol) => symbol.trim());
+    const matched = STABLECOINS.filter((coin) => wanted.some((input) => {
+        const upper = input.toUpperCase();
+        return tokenMatchesInput(coin, input, upper);
+    }));
+    if (matched.length === 0) {
+        throw new Error(`No matching stablecoins. Available: ${STABLECOINS.map((coin) => coin.symbol).join(", ")}`);
+    }
+    return matched;
+}
+//# sourceMappingURL=chains.js.map

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

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

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

@@ -0,0 +1,16 @@
+/** GoodDollar IdentityV4 contract on Celo mainnet. */
+export declare const GOODDOLLAR_IDENTITY_ADDRESS: "0xC361A6E67822a0EDc17D899227dd9FC50BD62F42";
+/** GoodDollar UBISchemeV2 contract on Celo mainnet. */
+export declare const GOODDOLLAR_UBI_SCHEME_ADDRESS: "0x43d72Ff17701B2DA814620735C39C620Ce0ea4A1";
+/** GoodDollar G$ token on Celo mainnet (SuperGoodDollar). */
+export declare const GOODDOLLAR_TOKEN_ADDRESS: "0x62B8B11039FcfE5aB0C56E502b1C372A3d2a9c7A";
+/** MentoBroker proxy — user-facing entry for G$ reserve swaps on Celo. */
+export declare const GOODDOLLAR_MENTO_BROKER: "0x88de45906D4F5a57315c133620cfa484cB297541";
+/** GoodDollar MentoExchangeProvider on Celo mainnet. */
+export declare const GOODDOLLAR_MENTO_EXCHANGE_PROVIDER: "0x2fFBB49055d487DdBBb0C052Cd7c2a02A7971e41";
+/** Exchange pool id for G$ ↔ USDm (CUSD in GoodProtocol deployment). */
+export declare const GOODDOLLAR_CUSD_EXCHANGE_ID: "0xba77f5c7bb3317643c6d81d1ef3f9913561741d92095f88efa402faf2cbe9124";
+/** Reserve collateral token (USDm / cUSD) for the G$ pool on Celo. */
+export declare const GOODDOLLAR_RESERVE_COLLATERAL: "0x765DE816845861e75A25fCA122bb6898B8B1282a";
+/** Whether both tokens form a supported GoodDollar reserve pair (G$ ↔ USDm). */
+export declare function isGoodDollarUsdReservePair(tokenIn: string, tokenOut: string): boolean;

package/build/src/config/gooddollar.js

@@ -0,0 +1,24 @@
+/** GoodDollar IdentityV4 contract on Celo mainnet. */
+export const GOODDOLLAR_IDENTITY_ADDRESS = "0xC361A6E67822a0EDc17D899227dd9FC50BD62F42";
+/** GoodDollar UBISchemeV2 contract on Celo mainnet. */
+export const GOODDOLLAR_UBI_SCHEME_ADDRESS = "0x43d72Ff17701B2DA814620735C39C620Ce0ea4A1";
+/** GoodDollar G$ token on Celo mainnet (SuperGoodDollar). */
+export const GOODDOLLAR_TOKEN_ADDRESS = "0x62B8B11039FcfE5aB0C56E502b1C372A3d2a9c7A";
+/** MentoBroker proxy — user-facing entry for G$ reserve swaps on Celo. */
+export const GOODDOLLAR_MENTO_BROKER = "0x88de45906D4F5a57315c133620cfa484cB297541";
+/** GoodDollar MentoExchangeProvider on Celo mainnet. */
+export const GOODDOLLAR_MENTO_EXCHANGE_PROVIDER = "0x2fFBB49055d487DdBBb0C052Cd7c2a02A7971e41";
+/** Exchange pool id for G$ ↔ USDm (CUSD in GoodProtocol deployment). */
+export const GOODDOLLAR_CUSD_EXCHANGE_ID = "0xba77f5c7bb3317643c6d81d1ef3f9913561741d92095f88efa402faf2cbe9124";
+/** Reserve collateral token (USDm / cUSD) for the G$ pool on Celo. */
+export const GOODDOLLAR_RESERVE_COLLATERAL = "0x765DE816845861e75A25fCA122bb6898B8B1282a";
+const GOODDOLLAR_SYMBOLS = new Set(["gooddollar", "g$"]);
+const RESERVE_COLLATERAL_SYMBOLS = new Set(["usdm", "cusd"]);
+/** Whether both tokens form a supported GoodDollar reserve pair (G$ ↔ USDm). */
+export function isGoodDollarUsdReservePair(tokenIn, tokenOut) {
+    const a = tokenIn.trim().toLowerCase();
+    const b = tokenOut.trim().toLowerCase();
+    return ((GOODDOLLAR_SYMBOLS.has(a) && RESERVE_COLLATERAL_SYMBOLS.has(b)) ||
+        (GOODDOLLAR_SYMBOLS.has(b) && RESERVE_COLLATERAL_SYMBOLS.has(a)));
+}
+//# sourceMappingURL=gooddollar.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gooddollar.js","sourceRoot":"","sources":["../../../src/config/gooddollar.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,MAAM,CAAC,MAAM,2BAA2B,GACtC,4CAAqD,CAAC;AAExD,uDAAuD;AACvD,MAAM,CAAC,MAAM,6BAA6B,GACxC,4CAAqD,CAAC;AAExD,6DAA6D;AAC7D,MAAM,CAAC,MAAM,wBAAwB,GACnC,4CAAqD,CAAC;AAExD,0EAA0E;AAC1E,MAAM,CAAC,MAAM,uBAAuB,GAClC,4CAAqD,CAAC;AAExD,wDAAwD;AACxD,MAAM,CAAC,MAAM,kCAAkC,GAC7C,4CAAqD,CAAC;AAExD,wEAAwE;AACxE,MAAM,CAAC,MAAM,2BAA2B,GACtC,oEAA6E,CAAC;AAEhF,sEAAsE;AACtE,MAAM,CAAC,MAAM,6BAA6B,GACxC,4CAAqD,CAAC;AAExD,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,CAAC;AACzD,MAAM,0BAA0B,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAE7D,gFAAgF;AAChF,MAAM,UAAU,0BAA0B,CAAC,OAAe,EAAE,QAAgB;IAC1E,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACvC,MAAM,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACxC,OAAO,CACL,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,0BAA0B,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAChE,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,0BAA0B,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CACjE,CAAC;AACJ,CAAC"}

package/build/src/config/sdk-config.d.ts

@@ -0,0 +1,33 @@
+/** RPC configuration for `createCelinaClient()`. */
+export interface SdkConfig {
+    /** Celo mainnet JSON-RPC URL (default Forno). */
+    rpcUrl: string;
+    /** Ethereum mainnet RPC for ENS resolution (optional). */
+    ethRpcUrl?: string;
+    /** Self Agent ID signing key (Node only; also reads `SELF_AGENT_PRIVATE_KEY`). */
+    selfAgentPrivateKey?: `0x${string}`;
+    /** Self Agent ID REST API base (default https://app.ai.self.xyz). */
+    selfApiBase?: string;
+    /** Amplitude read telemetry (default on; opt out with `false` or `CELINA_ANALYTICS_DISABLED=1`). */
+    analyticsEnabled?: boolean;
+    /** Override bundled Amplitude project API key. */
+    amplitudeApiKey?: string;
+    /**
+     * Amplitude `device_id`. When omitted, auto-detected from the consuming package
+     * `package.json` name (sanitized, e.g. `celeste_ai`, `andrewkimjoseph_celina_mcp`),
+     * then `CELINA_ANALYTICS_DEVICE_ID`, then `celina-sdk`.
+     */
+    analyticsDeviceId?: string;
+    /**
+     * Default wallet for read telemetry `user_id` when args omit an address
+     * (e.g. MCP session signer with `CELO_PRIVATE_KEY`).
+     */
+    analyticsWalletAddress?: string;
+}
+/** Default Celo RPC when `rpcUrl` is omitted. */
+export declare const DEFAULT_RPC_URL = "https://forno.celo.org";
+/**
+ * Merge partial options with SDK defaults.
+ * @param opts - Optional RPC overrides from `createCelinaClient(opts)`
+ */
+export declare function resolveSdkConfig(opts?: Partial<SdkConfig>): SdkConfig;

package/build/src/config/sdk-config.js

@@ -0,0 +1,31 @@
+import { detectConsumerPackageName } from "../analytics/consumer-package.js";
+/** Default Celo RPC when `rpcUrl` is omitted. */
+export const DEFAULT_RPC_URL = "https://forno.celo.org";
+/**
+ * Merge partial options with SDK defaults.
+ * @param opts - Optional RPC overrides from `createCelinaClient(opts)`
+ */
+export function resolveSdkConfig(opts) {
+    const selfAgentPrivateKey = opts?.selfAgentPrivateKey ??
+        (typeof process !== "undefined"
+            ? process.env.SELF_AGENT_PRIVATE_KEY
+            : undefined);
+    return {
+        rpcUrl: opts?.rpcUrl ?? DEFAULT_RPC_URL,
+        ethRpcUrl: opts?.ethRpcUrl,
+        selfAgentPrivateKey,
+        selfApiBase: opts?.selfApiBase ??
+            (typeof process !== "undefined"
+                ? process.env.SELF_AGENT_API_BASE
+                : undefined),
+        analyticsEnabled: opts?.analyticsEnabled,
+        amplitudeApiKey: opts?.amplitudeApiKey,
+        analyticsDeviceId: opts?.analyticsDeviceId ??
+            (typeof process !== "undefined"
+                ? process.env.CELINA_ANALYTICS_DEVICE_ID
+                : undefined) ??
+            detectConsumerPackageName(),
+        analyticsWalletAddress: opts?.analyticsWalletAddress,
+    };
+}
+//# sourceMappingURL=sdk-config.js.map

package/build/src/config/sdk-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-config.js","sourceRoot":"","sources":["../../../src/config/sdk-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AA6B7E,iDAAiD;AACjD,MAAM,CAAC,MAAM,eAAe,GAAG,wBAAwB,CAAC;AAExD;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAyB;IACxD,MAAM,mBAAmB,GACvB,IAAI,EAAE,mBAAmB;QACzB,CAAC,OAAO,OAAO,KAAK,WAAW;YAC7B,CAAC,CAAE,OAAO,CAAC,GAAG,CAAC,sBAAoD;YACnE,CAAC,CAAC,SAAS,CAAC,CAAC;IAEjB,OAAO;QACL,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,eAAe;QACvC,SAAS,EAAE,IAAI,EAAE,SAAS;QAC1B,mBAAmB;QACnB,WAAW,EACT,IAAI,EAAE,WAAW;YACjB,CAAC,OAAO,OAAO,KAAK,WAAW;gBAC7B,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB;gBACjC,CAAC,CAAC,SAAS,CAAC;QAChB,gBAAgB,EAAE,IAAI,EAAE,gBAAgB;QACxC,eAAe,EAAE,IAAI,EAAE,eAAe;QACtC,iBAAiB,EACf,IAAI,EAAE,iBAAiB;YACvB,CAAC,OAAO,OAAO,KAAK,WAAW;gBAC7B,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,0BAA0B;gBACxC,CAAC,CAAC,SAAS,CAAC;YACd,yBAAyB,EAAE;QAC7B,sBAAsB,EAAE,IAAI,EAAE,sBAAsB;KACrD,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,22 @@
+export declare const SELF_REGISTRY_ADDRESS: "0xaC3DF9ABf80d0F5c020C06B04Cced27763355944";
+export declare const SELF_API_BASE = "https://app.ai.self.xyz";
+/** Network value for Self lifecycle REST APIs (register, refresh, deregister). */
+export declare const SELF_API_NETWORK = "mainnet";
+/** Query param for Self demo/gated HTTP endpoints on Celo mainnet. */
+export declare const SELF_DEMO_NETWORK = "celo-mainnet";
+export declare const SELF_CHAIN_ID = 42220;
+export declare function selfDemoUrl(path: string, network?: string): string;
+export declare const SELF_SESSION_TTL_MS: number;
+export declare const SELF_MAX_SESSIONS = 50;
+export declare const SELF_DEFAULT_MAX_AGE_MS: number;
+export declare const SELF_FETCH_MAX_BYTES: number;
+/** Warning threshold for upcoming proof expiry (matches Self SDK isProofExpiringSoon). */
+export declare const SELF_PROOF_EXPIRING_SOON_DAYS = 30;
+export declare const SELF_HEADERS: {
+    readonly ADDRESS: "x-self-agent-address";
+    readonly SIGNATURE: "x-self-agent-signature";
+    readonly TIMESTAMP: "x-self-agent-timestamp";
+    readonly KEYTYPE: "x-self-agent-keytype";
+    readonly KEY: "x-self-agent-key";
+};
+export type SelfRegistrationMode = "linked" | "wallet-free" | "smartwallet" | "self-custody" | "ed25519" | "ed25519-linked";

package/build/src/config/self.js

@@ -0,0 +1,27 @@
+export const SELF_REGISTRY_ADDRESS = "0xaC3DF9ABf80d0F5c020C06B04Cced27763355944";
+export const SELF_API_BASE = "https://app.ai.self.xyz";
+/** Network value for Self lifecycle REST APIs (register, refresh, deregister). */
+export const SELF_API_NETWORK = "mainnet";
+/** Query param for Self demo/gated HTTP endpoints on Celo mainnet. */
+export const SELF_DEMO_NETWORK = "celo-mainnet";
+export const SELF_CHAIN_ID = 42220;
+export function selfDemoUrl(path, network = SELF_DEMO_NETWORK) {
+    const base = SELF_API_BASE.replace(/\/+$/, "");
+    const normalizedPath = path.startsWith("/") ? path : `/${path}`;
+    const separator = normalizedPath.includes("?") ? "&" : "?";
+    return `${base}${normalizedPath}${separator}network=${network}`;
+}
+export const SELF_SESSION_TTL_MS = 10 * 60 * 1000;
+export const SELF_MAX_SESSIONS = 50;
+export const SELF_DEFAULT_MAX_AGE_MS = 5 * 60 * 1000;
+export const SELF_FETCH_MAX_BYTES = 10 * 1024;
+/** Warning threshold for upcoming proof expiry (matches Self SDK isProofExpiringSoon). */
+export const SELF_PROOF_EXPIRING_SOON_DAYS = 30;
+export const SELF_HEADERS = {
+    ADDRESS: "x-self-agent-address",
+    SIGNATURE: "x-self-agent-signature",
+    TIMESTAMP: "x-self-agent-timestamp",
+    KEYTYPE: "x-self-agent-keytype",
+    KEY: "x-self-agent-key",
+};
+//# sourceMappingURL=self.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"self.js","sourceRoot":"","sources":["../../../src/config/self.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAChC,4CAAqD,CAAC;AAExD,MAAM,CAAC,MAAM,aAAa,GAAG,yBAAyB,CAAC;AAEvD,kFAAkF;AAClF,MAAM,CAAC,MAAM,gBAAgB,GAAG,SAAS,CAAC;AAE1C,sEAAsE;AACtE,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAEhD,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAC;AAEnC,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,OAAO,GAAG,iBAAiB;IACnE,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC/C,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;IAChE,MAAM,SAAS,GAAG,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IAC3D,OAAO,GAAG,IAAI,GAAG,cAAc,GAAG,SAAS,WAAW,OAAO,EAAE,CAAC;AAClE,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAElD,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAEpC,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAErD,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,GAAG,IAAI,CAAC;AAE9C,0FAA0F;AAC1F,MAAM,CAAC,MAAM,6BAA6B,GAAG,EAAE,CAAC;AAEhD,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,OAAO,EAAE,sBAAsB;IAC/B,SAAS,EAAE,wBAAwB;IACnC,SAAS,EAAE,wBAAwB;IACnC,OAAO,EAAE,sBAAsB;IAC/B,GAAG,EAAE,kBAAkB;CACf,CAAC"}

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

@@ -0,0 +1,42 @@
+/** Uniswap v4 on Celo mainnet — https://docs.celo.org/tooling/contracts/uniswap-contracts */
+export declare const UNISWAP_V4: {
+    readonly poolManager: "0x288dc841A52FCA2707c6947B3A777c5E56cd87BC";
+    readonly v4Quoter: "0x28566da1093609182dff2cb2a91cfd72e61d66cd";
+    readonly stateView: "0xbc21f8720babf4b20d195ee5c6e99c52b76f2bfb";
+    readonly universalRouter: "0xcb695bc5d3aa22cad1e6df07801b061a05a0233a";
+    readonly permit2: "0x000000000022D473030F116dDEE9F6B43aC78BA3";
+    readonly zeroHooks: "0x0000000000000000000000000000000000000000";
+    readonly nativeCurrency: "0x0000000000000000000000000000000000000000";
+};
+export declare const UNISWAP_SUBGRAPH_URL = "https://api.studio.thegraph.com/query/111767/uniswap-v-4-celo/version/latest";
+/** Pool index cache TTL in milliseconds (default 5 minutes). */
+export declare const UNISWAP_POOL_CACHE_TTL_MS: number;
+/** Common v4 fee tiers and default tick spacings (probed on-chain when building index). */
+export declare const UNISWAP_FEE_TIERS: readonly [100, 500, 3000, 10000, 30000];
+/** Default tick spacing per fee tier when probing pools on-chain. */
+export declare const UNISWAP_DEFAULT_TICK_SPACING: Record<number, number>;
+/** Hub tokens for on-chain pool index fallback (Uniswap routing graph). */
+export declare const UNISWAP_HUB_CURRENCIES: readonly `0x${string}`[];
+/** Uniswap v4 pool key (sorted currencies, fee tier, tick spacing, hooks). */
+export type UniswapPoolKey = {
+    currency0: `0x${string}`;
+    currency1: `0x${string}`;
+    fee: number;
+    tickSpacing: number;
+    hooks: `0x${string}`;
+};
+/** Sort two currency addresses for canonical pool key ordering. */
+export declare function sortUniswapCurrencies(a: `0x${string}`, b: `0x${string}`): [`0x${string}`, `0x${string}`];
+/** Normalize a pool key so `currency0` sorts before `currency1`. */
+export declare function normalizeUniswapPoolKey(poolKey: UniswapPoolKey): UniswapPoolKey;
+/** Map registry token to Uniswap v4 currency address (native CELO → address(0)). */
+export declare function toUniswapCurrency(address: `0x${string}` | "native"): `0x${string}`;
+/**
+ * Map registry token to the currency used for pool discovery / quoting.
+ * Celo v4 liquidity is on WCELO pairs, not native address(0).
+ */
+export declare function toUniswapRoutingCurrency(address: `0x${string}` | "native"): `0x${string}`;
+/** ERC-20 used as swap input when registry token is native CELO. */
+export declare function uniswapInputTokenAddress(address: `0x${string}` | "native"): `0x${string}` | "native";
+/** Whether a v4 currency address is native CELO (`address(0)`). */
+export declare function isNativeUniswapCurrency(currency: `0x${string}`): boolean;

package/build/src/config/uniswap.js

@@ -0,0 +1,76 @@
+/**
+ * Uniswap v4 contract addresses and routing helpers for Celo mainnet.
+ * @see https://docs.celo.org/tooling/contracts/uniswap-contracts
+ */
+import { MENTO_CELO_ADDRESS } from "./chains.js";
+/** Uniswap v4 on Celo mainnet — https://docs.celo.org/tooling/contracts/uniswap-contracts */
+export const UNISWAP_V4 = {
+    poolManager: "0x288dc841A52FCA2707c6947B3A777c5E56cd87BC",
+    v4Quoter: "0x28566da1093609182dff2cb2a91cfd72e61d66cd",
+    stateView: "0xbc21f8720babf4b20d195ee5c6e99c52b76f2bfb",
+    universalRouter: "0xcb695bc5d3aa22cad1e6df07801b061a05a0233a",
+    permit2: "0x000000000022D473030F116dDEE9F6B43aC78BA3",
+    zeroHooks: "0x0000000000000000000000000000000000000000",
+    nativeCurrency: "0x0000000000000000000000000000000000000000",
+};
+export const UNISWAP_SUBGRAPH_URL = "https://api.studio.thegraph.com/query/111767/uniswap-v-4-celo/version/latest";
+/** Pool index cache TTL in milliseconds (default 5 minutes). */
+export const UNISWAP_POOL_CACHE_TTL_MS = 5 * 60 * 1000;
+/** Common v4 fee tiers and default tick spacings (probed on-chain when building index). */
+export const UNISWAP_FEE_TIERS = [100, 500, 3000, 10000, 30000];
+/** Default tick spacing per fee tier when probing pools on-chain. */
+export const UNISWAP_DEFAULT_TICK_SPACING = {
+    100: 1,
+    500: 10,
+    3000: 60,
+    10000: 200,
+    30000: 600,
+};
+/** Hub tokens for on-chain pool index fallback (Uniswap routing graph). */
+export const UNISWAP_HUB_CURRENCIES = [
+    UNISWAP_V4.nativeCurrency,
+    MENTO_CELO_ADDRESS,
+    "0xceba9300f2b948710d2653dd7b07f33a8b32118c", // USDC
+    "0x48065fbBE25f71C9282ddf5e1cD6D6A887483D5e", // USDT
+    "0xD221812de1BD094f35587EE8E174B07B6167D9Af", // WETH
+    "0x765de816845861e75a25fca122bb6898b8b1282a", // USDm
+    "0x62B8B11039FcfE5aB0C56E502b1C372A3d2a9c7A", // GoodDollar (G$)
+];
+/** Sort two currency addresses for canonical pool key ordering. */
+export function sortUniswapCurrencies(a, b) {
+    return a.toLowerCase() < b.toLowerCase() ? [a, b] : [b, a];
+}
+/** Normalize a pool key so `currency0` sorts before `currency1`. */
+export function normalizeUniswapPoolKey(poolKey) {
+    const [currency0, currency1] = sortUniswapCurrencies(poolKey.currency0, poolKey.currency1);
+    return { ...poolKey, currency0, currency1 };
+}
+/** Map registry token to Uniswap v4 currency address (native CELO → address(0)). */
+export function toUniswapCurrency(address) {
+    if (address === "native") {
+        return UNISWAP_V4.nativeCurrency;
+    }
+    return address;
+}
+/**
+ * Map registry token to the currency used for pool discovery / quoting.
+ * Celo v4 liquidity is on WCELO pairs, not native address(0).
+ */
+export function toUniswapRoutingCurrency(address) {
+    if (address === "native") {
+        return MENTO_CELO_ADDRESS;
+    }
+    return address;
+}
+/** ERC-20 used as swap input when registry token is native CELO. */
+export function uniswapInputTokenAddress(address) {
+    if (address === "native") {
+        return MENTO_CELO_ADDRESS;
+    }
+    return address;
+}
+/** Whether a v4 currency address is native CELO (`address(0)`). */
+export function isNativeUniswapCurrency(currency) {
+    return currency.toLowerCase() === UNISWAP_V4.nativeCurrency;
+}
+//# sourceMappingURL=uniswap.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"uniswap.js","sourceRoot":"","sources":["../../../src/config/uniswap.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,6FAA6F;AAC7F,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,WAAW,EAAE,4CAAqD;IAClE,QAAQ,EAAE,4CAAqD;IAC/D,SAAS,EAAE,4CAAqD;IAChE,eAAe,EAAE,4CAAqD;IACtE,OAAO,EAAE,4CAAqD;IAC9D,SAAS,EAAE,4CAAqD;IAChE,cAAc,EAAE,4CAAqD;CAC7D,CAAC;AAEX,MAAM,CAAC,MAAM,oBAAoB,GAC/B,8EAA8E,CAAC;AAEjF,gEAAgE;AAChE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAEvD,2FAA2F;AAC3F,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAU,CAAC;AAEzE,qEAAqE;AACrE,MAAM,CAAC,MAAM,4BAA4B,GAA2B;IAClE,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,EAAE;IACP,IAAI,EAAE,EAAE;IACR,KAAK,EAAE,GAAG;IACV,KAAK,EAAE,GAAG;CACX,CAAC;AAEF,2EAA2E;AAC3E,MAAM,CAAC,MAAM,sBAAsB,GAA6B;IAC9D,UAAU,CAAC,cAAc;IACzB,kBAAkB;IAClB,4CAA4C,EAAE,OAAO;IACrD,4CAA4C,EAAE,OAAO;IACrD,4CAA4C,EAAE,OAAO;IACrD,4CAA4C,EAAE,OAAO;IACrD,4CAA4C,EAAE,kBAAkB;CACjE,CAAC;AAWF,mEAAmE;AACnE,MAAM,UAAU,qBAAqB,CACnC,CAAgB,EAChB,CAAgB;IAEhB,OAAO,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,uBAAuB,CAAC,OAAuB;IAC7D,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,qBAAqB,CAClD,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,SAAS,CAClB,CAAC;IACF,OAAO,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;AAC9C,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,iBAAiB,CAC/B,OAAiC;IAEjC,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,OAAO,UAAU,CAAC,cAAc,CAAC;IACnC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAAiC;IAEjC,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,wBAAwB,CACtC,OAAiC;IAEjC,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,uBAAuB,CAAC,QAAuB;IAC7D,OAAO,QAAQ,CAAC,WAAW,EAAE,KAAK,UAAU,CAAC,cAAc,CAAC;AAC9D,CAAC"}