infra: add startup ascii banner

src/index.ts

@@ -32,7 +32,7 @@ import { registerTracingShutdownHandlers } from "./utils/shutdownTracing";
 import { providerSecretRotationService } from "./services/providerSecretRotationService";
 import { priceAggregatorService } from "./services/priceAggregatorService";
 import { contractSanityCheckService } from "./services/contractSanityCheckService";
-
+import { BannerService } from "./services/BannerService";
 // Load environment variables
 dotenv.config();
 
@@ -330,6 +330,10 @@ process.once("SIGTERM", () => {
 });
 
 httpServer.listen(PORT, async () => {
+  BannerService.print({
+    environment: process.env.STELLAR_ENV || process.env.NODE_ENV,
+    version: process.env.ENGINE_VERSION || process.env.npm_package_version,
+  });
   console.log(`🌊 StellarFlow Backend running on port ${PORT}`);
   console.log(
     `📊 Market Rates API available at http://localhost:${PORT}/api/market-rates`,
@@ -344,11 +348,10 @@ httpServer.listen(PORT, async () => {
   let contractSanityPassed = true;
   if (contractSanityCheckService.isConfigured()) {
     try {
-      const sanityResult = await contractSanityCheckService.performSanityCheck();
+      const sanityResult =
+        await contractSanityCheckService.performSanityCheck();
       if (!sanityResult.success) {
-        console.error(
-          `❌ Contract sanity check failed: ${sanityResult.error}`,
-        );
+        console.error(`❌ Contract sanity check failed: ${sanityResult.error}`);
         console.error(
           "⛔ Preventing ingestion loop from starting due to contract failure",
         );

src/services/BannerService.ts

@@ -0,0 +1,69 @@
+type BannerOptions = {
+  environment?: string;
+  version?: string;
+};
+
+const ANSI = {
+  reset: "\x1b[0m",
+  bold: "\x1b[1m",
+  dim: "\x1b[2m",
+  cyan: "\x1b[36m",
+  green: "\x1b[32m",
+  yellow: "\x1b[33m",
+  magenta: "\x1b[35m",
+};
+
+function normalizeEnvironment(value?: string): string {
+  const env =
+    value || process.env.STELLAR_ENV || process.env.NODE_ENV || "development";
+
+  if (/mainnet|production|prod/i.test(env)) return "Mainnet";
+  if (/staging|stage/i.test(env)) return "Staging";
+  if (/testnet|test/i.test(env)) return "Testnet";
+  return env.charAt(0).toUpperCase() + env.slice(1);
+}
+
+export class BannerService {
+  static render(options: BannerOptions = {}): string {
+    const environment = normalizeEnvironment(options.environment);
+    const version =
+      options.version ||
+      process.env.ENGINE_VERSION ||
+      process.env.npm_package_version ||
+      "0.0.0";
+
+    const logo = [
+      "  ____  _       _ _             _____ _               ",
+      " / ___|| |_ ___| | | __ _ _ __|  ___| | _____      __",
+      " \\___ \\| __/ _ \\ | |/ _` | '__| |_  | |/ _ \\ \\ /\\ / /",
+      "  ___) | ||  __/ | | (_| | |  |  _| | | (_) \\ V  V / ",
+      " |____/ \\__\\___|_|_|\\__,_|_|  |_|   |_|\\___/ \\_/\\_/  ",
+    ];
+
+    const rows = [
+      `Environment : ${environment}`,
+      `Engine      : v${version}`,
+      `Runtime     : ${process.version}`,
+    ];
+
+    const width = Math.max(...rows.map((row) => row.length), 36);
+    const top = `╭${"─".repeat(width + 2)}╮`;
+    const bottom = `╰${"─".repeat(width + 2)}╯`;
+    const body = rows.map((row) => `│ ${row.padEnd(width, " ")} │`).join("\n");
+
+    return [
+      "",
+      `${ANSI.cyan}${ANSI.bold}${logo.join("\n")}${ANSI.reset}`,
+      `${ANSI.magenta}${top}${ANSI.reset}`,
+      `${ANSI.magenta}${body}${ANSI.reset}`,
+      `${ANSI.magenta}${bottom}${ANSI.reset}`,
+      `${ANSI.dim}Institutional Oracle Infrastructure • StellarFlow Network${ANSI.reset}`,
+      "",
+    ].join("\n");
+  }
+
+  static print(options: BannerOptions = {}): void {
+    // eslint-disable-next-line no-console
+    console.log(BannerService.render(options));
+  }
+}