@andrewkimjoseph/celina 0.2.0

package/build/config/chains.js

@@ -0,0 +1,236 @@
+import { celo } from "viem/chains";
+export const CHAIN = celo;
+export const DEFAULT_RPC_URL = "https://forno.celo.org";
+export const KNOWN_TOKENS = [
+    {
+        symbol: "CELO",
+        address: "native",
+        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",
+        address: "0xe8537a3d056da446677b9e9d6c5db704eaab4787",
+        issuer: "Mento",
+        useCase: "Brazilian Real-pegged stablecoin",
+        decimals: 18,
+    },
+    {
+        symbol: "XOFm",
+        address: "0x73F93dcc49cB8A239e2032663e9475dd5ef29A08",
+        issuer: "Mento",
+        useCase: "CFA Franc-pegged stablecoin",
+        decimals: 18,
+    },
+    {
+        symbol: "KESm",
+        address: "0x456a3D042C0DbD3db53D5489e98dFb038553B0d0",
+        issuer: "Mento",
+        useCase: "Kenyan Shilling-pegged stablecoin",
+        decimals: 18,
+    },
+    {
+        symbol: "PHPm",
+        address: "0x105d4A9306D2E55a71d2Eb95B81553AE1dC20d7B",
+        issuer: "Mento",
+        useCase: "Philippine Peso-pegged stablecoin",
+        decimals: 18,
+    },
+    {
+        symbol: "COPm",
+        address: "0x8a567e2ae79ca692bd748ab832081c45de4041ea",
+        issuer: "Mento",
+        useCase: "Colombian Peso-pegged stablecoin",
+        decimals: 18,
+    },
+    {
+        symbol: "GBPm",
+        address: "0xCCF663b1fF11028f0b19058d0f7B674004a40746",
+        issuer: "Mento",
+        useCase: "British Pound-pegged stablecoin",
+        decimals: 18,
+    },
+    {
+        symbol: "CADm",
+        address: "0xff4Ab19391af240c311c54200a492233052B6325",
+        issuer: "Mento",
+        useCase: "Canadian Dollar-pegged stablecoin",
+        decimals: 18,
+    },
+    {
+        symbol: "AUDm",
+        address: "0x7175504C455076F15c04A2F90a8e352281F492F9",
+        issuer: "Mento",
+        useCase: "Australian Dollar-pegged stablecoin",
+        decimals: 18,
+    },
+    {
+        symbol: "ZARm",
+        address: "0x4c35853A3B4e647fD266f4de678dCc8fEC410BF6",
+        issuer: "Mento",
+        useCase: "South African Rand-pegged stablecoin",
+        decimals: 18,
+    },
+    {
+        symbol: "GHSm",
+        address: "0xfAeA5F3404bbA20D3cc2f8C4B0A888F55a3c7313",
+        issuer: "Mento",
+        useCase: "Ghanaian Cedi-pegged stablecoin",
+        decimals: 18,
+    },
+    {
+        symbol: "NGNm",
+        address: "0xE2702Bd97ee33c88c8f6f92DA3B733608aa76F71",
+        issuer: "Mento",
+        useCase: "Nigerian Naira-pegged stablecoin",
+        decimals: 18,
+    },
+    {
+        symbol: "JPYm",
+        address: "0xc45eCF20f3CD864B32D9794d6f76814aE8892e20",
+        issuer: "Mento",
+        useCase: "Japanese Yen-pegged stablecoin",
+        decimals: 18,
+    },
+    {
+        symbol: "CHFm",
+        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: "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$"],
+        address: "0x62B8B11039FcfE5aB0C56E502b1C372A3d2a9c7A",
+        issuer: "GoodDollar",
+        useCase: "UBI-focused stablecoin for financial inclusion",
+        decimals: 18,
+    },
+];
+export const STABLECOINS = KNOWN_TOKENS.filter((token) => token.address !== "native" &&
+    token.issuer !== undefined &&
+    token.useCase !== undefined);
+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);
+}
+export function findKnownToken(token) {
+    const normalized = token.trim();
+    const upper = normalized.toUpperCase();
+    return KNOWN_TOKENS.find((entry) => tokenMatchesInput(entry, normalized, upper) ||
+        (upper === "NATIVE" && entry.address === "native"));
+}
+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/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/config/env.d.ts

@@ -0,0 +1,5 @@
+export interface AppConfig {
+    rpcUrl: string;
+    privateKey?: `0x${string}`;
+}
+export declare function loadConfig(): AppConfig;

package/build/config/env.js

@@ -0,0 +1,7 @@
+export function loadConfig() {
+    return {
+        rpcUrl: process.env.CELO_RPC_URL_MAINNET ?? "https://forno.celo.org",
+        privateKey: process.env.CELO_PRIVATE_KEY,
+    };
+}
+//# sourceMappingURL=env.js.map

package/build/config/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/config/env.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,UAAU;IACxB,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,wBAAwB;QACpE,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,gBAA6C;KACtE,CAAC;AACJ,CAAC"}

package/build/context/app-context.d.ts

@@ -0,0 +1,16 @@
+import type { CeloClientFactory } from "../clients/celo-client.js";
+import { BlockchainService } from "../services/blockchain.service.js";
+import { AccountService } from "../services/account.service.js";
+import { TokenService } from "../services/token.service.js";
+import { TransactionService } from "../services/transaction.service.js";
+export interface AppContext {
+    config: {
+        hasWallet: boolean;
+        walletAddress?: `0x${string}`;
+    };
+    blockchain: BlockchainService;
+    account: AccountService;
+    token: TokenService;
+    transaction: TransactionService;
+}
+export declare function createAppContext(clientFactory: CeloClientFactory, walletAddress?: `0x${string}`): AppContext;

package/build/context/app-context.js

@@ -0,0 +1,17 @@
+import { BlockchainService } from "../services/blockchain.service.js";
+import { AccountService } from "../services/account.service.js";
+import { TokenService } from "../services/token.service.js";
+import { TransactionService } from "../services/transaction.service.js";
+export function createAppContext(clientFactory, walletAddress) {
+    return {
+        config: {
+            hasWallet: Boolean(walletAddress),
+            walletAddress,
+        },
+        blockchain: new BlockchainService(clientFactory),
+        account: new AccountService(clientFactory),
+        token: new TokenService(clientFactory),
+        transaction: new TransactionService(clientFactory),
+    };
+}
+//# sourceMappingURL=app-context.js.map

package/build/context/app-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-context.js","sourceRoot":"","sources":["../../src/context/app-context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAaxE,MAAM,UAAU,gBAAgB,CAC9B,aAAgC,EAChC,aAA6B;IAE7B,OAAO;QACL,MAAM,EAAE;YACN,SAAS,EAAE,OAAO,CAAC,aAAa,CAAC;YACjC,aAAa;SACd;QACD,UAAU,EAAE,IAAI,iBAAiB,CAAC,aAAa,CAAC;QAChD,OAAO,EAAE,IAAI,cAAc,CAAC,aAAa,CAAC;QAC1C,KAAK,EAAE,IAAI,YAAY,CAAC,aAAa,CAAC;QACtC,WAAW,EAAE,IAAI,kBAAkB,CAAC,aAAa,CAAC;KACnD,CAAC;AACJ,CAAC"}

package/build/crypto/wallet-key-crypto.d.ts

@@ -0,0 +1,11 @@
+export declare function isWalletEncryptionConfigured(): boolean;
+export declare function getPublicKeyPem(): string;
+export declare function getEncryptionInfo(): {
+    algorithm: string;
+    hash: string;
+    encoding: string;
+    publicKey: string;
+    instructions: string;
+};
+export declare function encryptPrivateKey(publicKeyPem: string, privateKey: string): string;
+export declare function decryptPrivateKey(encryptedBase64: string): `0x${string}`;

package/build/crypto/wallet-key-crypto.js

@@ -0,0 +1,57 @@
+import { createPrivateKey, createPublicKey, privateDecrypt, publicEncrypt, } from "node:crypto";
+const RSA_OAEP = {
+    oaepHash: "sha256",
+    padding: 4, // RSA_PKCS1_OAEP_PADDING
+};
+const PRIVATE_KEY_PATTERN = /^0x[0-9a-fA-F]{64}$/;
+let cachedPrivateKey;
+function loadPrivateKey() {
+    if (cachedPrivateKey) {
+        return cachedPrivateKey;
+    }
+    const pem = process.env.WALLET_ENCRYPTION_PRIVATE_KEY;
+    if (!pem) {
+        throw new Error("Wallet encryption is not configured. Set WALLET_ENCRYPTION_PRIVATE_KEY.");
+    }
+    cachedPrivateKey = createPrivateKey(pem);
+    return cachedPrivateKey;
+}
+export function isWalletEncryptionConfigured() {
+    return Boolean(process.env.WALLET_ENCRYPTION_PRIVATE_KEY);
+}
+export function getPublicKeyPem() {
+    const privateKey = loadPrivateKey();
+    return createPublicKey(privateKey).export({ type: "spki", format: "pem" });
+}
+export function getEncryptionInfo() {
+    return {
+        algorithm: "RSA-OAEP",
+        hash: "sha256",
+        encoding: "base64",
+        publicKey: getPublicKeyPem(),
+        instructions: "Encrypt your 0x-prefixed private key locally with this public key, then pass the base64 ciphertext as encryptedPrivateKey.",
+    };
+}
+export function encryptPrivateKey(publicKeyPem, privateKey) {
+    if (!PRIVATE_KEY_PATTERN.test(privateKey)) {
+        throw new Error("Invalid private key format. Expected 0x followed by 64 hex chars.");
+    }
+    const encrypted = publicEncrypt({ key: publicKeyPem, ...RSA_OAEP }, Buffer.from(privateKey, "utf8"));
+    return encrypted.toString("base64");
+}
+export function decryptPrivateKey(encryptedBase64) {
+    const privateKey = loadPrivateKey();
+    let decrypted;
+    try {
+        decrypted = privateDecrypt({ key: privateKey, ...RSA_OAEP }, Buffer.from(encryptedBase64, "base64"));
+    }
+    catch {
+        throw new Error("Failed to decrypt private key. Ensure it was encrypted with this server's public key.");
+    }
+    const value = decrypted.toString("utf8");
+    if (!PRIVATE_KEY_PATTERN.test(value)) {
+        throw new Error("Decrypted value is not a valid private key.");
+    }
+    return value;
+}
+//# sourceMappingURL=wallet-key-crypto.js.map

package/build/crypto/wallet-key-crypto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-key-crypto.js","sourceRoot":"","sources":["../../src/crypto/wallet-key-crypto.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,aAAa,GAEd,MAAM,aAAa,CAAC;AAErB,MAAM,QAAQ,GAAG;IACf,QAAQ,EAAE,QAAiB;IAC3B,OAAO,EAAE,CAAC,EAAE,yBAAyB;CACtC,CAAC;AAEF,MAAM,mBAAmB,GAAG,qBAAqB,CAAC;AAElD,IAAI,gBAAuC,CAAC;AAE5C,SAAS,cAAc;IACrB,IAAI,gBAAgB,EAAE,CAAC;QACrB,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC;IACtD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,yEAAyE,CAC1E,CAAC;IACJ,CAAC;IAED,gBAAgB,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACzC,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,4BAA4B;IAC1C,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC;IACpC,OAAO,eAAe,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAW,CAAC;AACvF,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO;QACL,SAAS,EAAE,UAAU;QACrB,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,QAAQ;QAClB,SAAS,EAAE,eAAe,EAAE;QAC5B,YAAY,EACV,4HAA4H;KAC/H,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,YAAoB,EACpB,UAAkB;IAElB,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;IACvF,CAAC;IAED,MAAM,SAAS,GAAG,aAAa,CAC7B,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,QAAQ,EAAE,EAClC,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAChC,CAAC;IAEF,OAAO,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,eAAuB;IACvD,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC;IACpC,IAAI,SAAiB,CAAC;IAEtB,IAAI,CAAC;QACH,SAAS,GAAG,cAAc,CACxB,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,QAAQ,EAAE,EAChC,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,CACvC,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,uFAAuF,CACxF,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACzC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IAED,OAAO,KAAsB,CAAC;AAChC,CAAC"}

package/build/http.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/build/http.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+import { app } from "./server/create-http-app.js";
+const PORT = parseInt(process.env.PORT || "10000", 10);
+if (!process.env.WALLET_ENCRYPTION_PRIVATE_KEY) {
+    console.warn("WARNING: WALLET_ENCRYPTION_PRIVATE_KEY is not set. Write tools requiring encryptedPrivateKey will fail.");
+}
+app.listen(PORT, "0.0.0.0", () => {
+    console.log(`Celina HTTP server listening on port ${PORT}`);
+});
+process.on("SIGINT", () => {
+    console.log("Shutting down server...");
+    process.exit(0);
+});
+//# sourceMappingURL=http.js.map

package/build/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,GAAG,EAAE,MAAM,6BAA6B,CAAC;AAElD,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,EAAE,EAAE,CAAC,CAAC;AAEvD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,6BAA6B,EAAE,CAAC;IAC/C,OAAO,CAAC,IAAI,CACV,yGAAyG,CAC1G,CAAC;AACJ,CAAC;AAED,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE;IAC/B,OAAO,CAAC,GAAG,CAAC,wCAAwC,IAAI,EAAE,CAAC,CAAC;AAC9D,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;IACxB,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;IACvC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/build/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/build/index.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server/create-server.js";
+async function main() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Celina running on stdio");
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;AAC3C,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/build/schemas/common.d.ts

@@ -0,0 +1,4 @@
+import { z } from "zod";
+export declare const addressSchema: z.ZodString;
+export declare const blockIdSchema: z.ZodUnion<[z.ZodNumber, z.ZodString, z.ZodLiteral<"latest">, z.ZodLiteral<"pending">]>;
+export declare const tokenSymbolSchema: z.ZodString;

package/build/schemas/common.js

@@ -0,0 +1,16 @@
+import { z } from "zod";
+export const addressSchema = z
+    .string()
+    .regex(/^0x[a-fA-F0-9]{40}$/, "Invalid Ethereum address");
+export const blockIdSchema = z
+    .union([
+    z.number().int().nonnegative(),
+    z.string().regex(/^0x[a-fA-F0-9]+$/, "Invalid block hash"),
+    z.literal("latest"),
+    z.literal("pending"),
+])
+    .describe("Block number, hash, or latest/pending");
+export const tokenSymbolSchema = z
+    .string()
+    .describe("Token symbol (e.g. CELO, USDm, G$, GoodDollar) or 0x contract address");
+//# sourceMappingURL=common.js.map

package/build/schemas/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/schemas/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC3B,MAAM,EAAE;KACR,KAAK,CAAC,qBAAqB,EAAE,0BAA0B,CAAC,CAAC;AAE5D,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC3B,KAAK,CAAC;IACL,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC9B,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,kBAAkB,EAAE,oBAAoB,CAAC;IAC1D,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACnB,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;CACrB,CAAC;KACD,QAAQ,CAAC,uCAAuC,CAAC,CAAC;AAErD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC;KAC/B,MAAM,EAAE;KACR,QAAQ,CAAC,uEAAuE,CAAC,CAAC"}

package/build/server/create-http-app.d.ts

@@ -0,0 +1 @@
+export declare const app: import("express").Express;

package/build/server/create-http-app.js

@@ -0,0 +1,134 @@
+import { randomUUID } from "node:crypto";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { createMcpExpressApp } from "@modelcontextprotocol/sdk/server/express.js";
+import { getEncryptionInfo, isWalletEncryptionConfigured, } from "../crypto/wallet-key-crypto.js";
+import { createServer } from "./create-server.js";
+const RENDER_EXTERNAL_HOSTNAME = process.env.RENDER_EXTERNAL_HOSTNAME;
+export const app = createMcpExpressApp({
+    host: "0.0.0.0",
+    allowedHosts: RENDER_EXTERNAL_HOSTNAME
+        ? [RENDER_EXTERNAL_HOSTNAME]
+        : undefined,
+});
+const transports = new Map();
+function isInitializeRequest(body) {
+    if (Array.isArray(body)) {
+        return body.some(isInitializeRequest);
+    }
+    if (!body || typeof body !== "object") {
+        return false;
+    }
+    return body.method === "initialize";
+}
+app.get("/health", (_req, res) => {
+    res.json({ status: "ok" });
+});
+app.get("/public-key", (_req, res) => {
+    if (!isWalletEncryptionConfigured()) {
+        res.status(503).json({
+            error: "Wallet encryption is not configured on this server.",
+        });
+        return;
+    }
+    const { publicKey, algorithm, hash, encoding } = getEncryptionInfo();
+    res.json({ publicKey, algorithm, hash, encoding });
+});
+app.post("/mcp", async (req, res) => {
+    const sessionId = req.headers["mcp-session-id"];
+    try {
+        let transport;
+        if (sessionId && transports.has(sessionId)) {
+            transport = transports.get(sessionId);
+        }
+        else if (!sessionId && isInitializeRequest(req.body)) {
+            transport = new StreamableHTTPServerTransport({
+                sessionIdGenerator: () => randomUUID(),
+                onsessioninitialized: (id) => {
+                    if (transport) {
+                        transports.set(id, transport);
+                    }
+                },
+            });
+            transport.onclose = () => {
+                const id = transport?.sessionId;
+                if (id) {
+                    transports.delete(id);
+                }
+            };
+            const server = createServer();
+            await server.connect(transport);
+            await transport.handleRequest(req, res, req.body);
+            return;
+        }
+        else if (sessionId) {
+            res.status(404).json({
+                jsonrpc: "2.0",
+                error: { code: -32001, message: "Session not found" },
+                id: null,
+            });
+            return;
+        }
+        else {
+            res.status(400).json({
+                jsonrpc: "2.0",
+                error: { code: -32000, message: "Bad Request: Session ID required" },
+                id: null,
+            });
+            return;
+        }
+        await transport.handleRequest(req, res, req.body);
+    }
+    catch (error) {
+        console.error("Error handling MCP request:", error);
+        if (!res.headersSent) {
+            res.status(500).json({
+                jsonrpc: "2.0",
+                error: { code: -32603, message: "Internal server error" },
+                id: null,
+            });
+        }
+    }
+});
+app.get("/mcp", async (req, res) => {
+    const sessionId = req.headers["mcp-session-id"];
+    if (!sessionId) {
+        res.status(400).send("Missing session ID");
+        return;
+    }
+    const transport = transports.get(sessionId);
+    if (!transport) {
+        res.status(404).send("Session not found");
+        return;
+    }
+    try {
+        await transport.handleRequest(req, res);
+    }
+    catch (error) {
+        console.error("Error handling MCP SSE request:", error);
+        if (!res.headersSent) {
+            res.status(500).send("Error processing SSE stream");
+        }
+    }
+});
+app.delete("/mcp", async (req, res) => {
+    const sessionId = req.headers["mcp-session-id"];
+    if (!sessionId) {
+        res.status(400).send("Missing session ID");
+        return;
+    }
+    const transport = transports.get(sessionId);
+    if (!transport) {
+        res.status(404).send("Session not found");
+        return;
+    }
+    try {
+        await transport.handleRequest(req, res);
+    }
+    catch (error) {
+        console.error("Error handling MCP session termination:", error);
+        if (!res.headersSent) {
+            res.status(500).send("Error processing session termination");
+        }
+    }
+});
+//# sourceMappingURL=create-http-app.js.map

package/build/server/create-http-app.js.map

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

package/build/server/create-server.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createServer(): McpServer;

package/build/server/create-server.js

@@ -0,0 +1,21 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { loadConfig } from "../config/env.js";
+import { CeloClientFactory } from "../clients/celo-client.js";
+import { createAppContext } from "../context/app-context.js";
+import { registerAllTools } from "../tools/index.js";
+import { SERVER_INSTRUCTIONS } from "./instructions.js";
+export function createServer() {
+    const config = loadConfig();
+    const clientFactory = new CeloClientFactory(config);
+    const clients = clientFactory.getClients();
+    const server = new McpServer({ name: "celina", version: "0.2.0" }, {
+        instructions: SERVER_INSTRUCTIONS,
+        capabilities: {
+            tools: { listChanged: true },
+            logging: {},
+        },
+    });
+    registerAllTools(server, createAppContext(clientFactory, clients.accountAddress));
+    return server;
+}
+//# sourceMappingURL=create-server.js.map

package/build/server/create-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-server.js","sourceRoot":"","sources":["../../src/server/create-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,aAAa,GAAG,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,aAAa,CAAC,UAAU,EAAE,CAAC;IAE3C,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,EACpC;QACE,YAAY,EAAE,mBAAmB;QACjC,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE;YAC5B,OAAO,EAAE,EAAE;SACZ;KACF,CACF,CAAC;IAEF,gBAAgB,CACd,MAAM,EACN,gBAAgB,CAAC,aAAa,EAAE,OAAO,CAAC,cAAc,CAAC,CACxD,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/build/server/instructions.d.ts

@@ -0,0 +1 @@
+export declare const SERVER_INSTRUCTIONS: string;

package/build/server/instructions.js

@@ -0,0 +1,13 @@
+export const SERVER_INSTRUCTIONS = `
+You are connected to Celina, the Celo MCP server (mainnet only).
+
+Guidelines:
+- Prefer read-only tools (get_*) before any write operation.
+- Always call estimate_send before send_token when possible.
+- Write tools require CELO_PRIVATE_KEY in the server environment.
+- Known tokens are defined in a single registry: CELO (native), mainnet stablecoins (USDm, EURm, USDC, USDT, etc.), and GoodDollar.
+- Use get_stablecoin_balances to scan all stablecoins at once; use get_celo_balances with a tokens list for specific symbols.
+
+Future tools (add as new modules in src/tools/): lend on Aave, Self verify, Self Agent ID check.
+`.trim();
+//# sourceMappingURL=instructions.js.map