Merge pull request #251 from Austinaminu2/feat/stellar-discovery

feat: add stellar.toml and OpenAPI well-known discovery endpoints

Author: Baskarayelu

README.md

@@ -502,3 +502,11 @@ Insurance endpoints (v1)
 Notes:
 - These endpoints return transaction XDRs composed with `manageData` operations to encode policy actions. If you prefer Soroban contract invocations, I can convert the builders to use contract calls.
 
+## API Discovery
+
+RemitWise exposes an OpenAPI discovery endpoint:
+
+/api/.well-known/openapi
+
+This allows integrators and wallets to automatically discover
+the RemitWise API specification.

app/.well-known/stellar.toml/route.ts

@@ -0,0 +1,25 @@
+export async function GET() {
+  const toml = `
+VERSION="2.0.0"
+
+NETWORK_PASSPHRASE="Test SDF Network ; September 2015"
+
+ORG_NAME="RemitWise"
+ORG_URL="https://remitwise.app"
+ORG_DESCRIPTION="Stellar-based cross-border remittance platform"
+
+DOCUMENTATION="https://remitwise.app/docs"
+
+SIGNING_KEY="REPLACE_WITH_PROJECT_PUBLIC_KEY"
+
+WEB_AUTH_ENDPOINT="https://remitwise.app/api/auth"
+
+TRANSFER_SERVER="https://remitwise.app/api/anchor"
+`;
+
+  return new Response(toml.trim(), {
+    headers: {
+      "Content-Type": "text/plain",
+    },
+  });
+}

app/api/.well-known/openapi/route.ts

@@ -0,0 +1,13 @@
+import fs from "fs";
+import path from "path";
+
+export async function GET() {
+  const file = path.join(process.cwd(), "openapi.yaml");
+  const yaml = fs.readFileSync(file, "utf8");
+
+  return new Response(yaml, {
+    headers: {
+      "Content-Type": "text/yaml",
+    },
+  });
+}