create-stellar-devkit-app 1.0.0

package/dist/index.js

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+#!/usr/bin/env node
+
+// src/index.ts
+import { program } from "commander";
+import chalk from "chalk";
+import fs from "fs-extra";
+import path from "path";
+import { execSync } from "child_process";
+import prompts from "prompts";
+var pkg = await fs.readJSON(path.join(path.dirname(new URL(import.meta.url).pathname), "../package.json"));
+function getTemplatesDir() {
+  const candidates = [
+    path.join(process.cwd(), "node_modules/create-stellar-devkit-app/templates"),
+    path.join(path.dirname(new URL(import.meta.url).pathname), "../templates")
+  ];
+  for (const d of candidates) {
+    if (fs.existsSync(d)) return d;
+  }
+  throw new Error("Templates directory not found");
+}
+function getTemplateName(projectType) {
+  return projectType === "agent-kit" ? "agent-kit" : "x402-api";
+}
+async function main() {
+  console.log();
+  console.log(chalk.bold.cyan("  Stellar DevKit"));
+  console.log(chalk.gray("  Agent Kit DeFi  \u2022  x402 Pay-per-Request APIs"));
+  console.log(chalk.gray(`  v${pkg.version}`));
+  console.log();
+  program.name("create-stellar-devkit-app").description("Create a new Stellar DevKit project").version(pkg.version).argument("[project-name]", "Project name").option("--agent-kit", "Use Agent Kit template (swap UI + StellarAgentKit)").option("--x402-api", "Use x402 API template (payment-gated endpoints)").option("--skip-install", "Skip installing dependencies").parse();
+  const args = program.opts();
+  let projectName = program.args[0];
+  let projectType = args.agentKit ? "agent-kit" : args.x402Api ? "x402-api" : void 0;
+  const skipInstall = !!args.skipInstall;
+  if (!projectName) {
+    const { name } = await prompts({
+      type: "text",
+      name: "name",
+      message: "Project name?",
+      initial: "my-stellar-app",
+      validate: (v) => /^[a-z0-9-_]+$/i.test(v) ? true : "Use only letters, numbers, hyphens, underscores"
+    });
+    projectName = name;
+  }
+  if (!projectType) {
+    const { type } = await prompts({
+      type: "select",
+      name: "type",
+      message: "Which template?",
+      choices: [
+        { title: chalk.green("Agent Kit"), value: "agent-kit", description: "Swap UI + StellarAgentKit" },
+        { title: chalk.cyan("x402 API"), value: "x402-api", description: "Payment-gated API with Stellar" }
+      ],
+      initial: 0
+    });
+    projectType = type;
+  }
+  const projectPath = path.resolve(process.cwd(), projectName);
+  if (fs.existsSync(projectPath)) {
+    console.log(chalk.red(`Directory ${projectName} already exists.`));
+    process.exit(1);
+  }
+  const templatesDir = getTemplatesDir();
+  const templateName = getTemplateName(projectType);
+  const templatePath = path.join(templatesDir, templateName);
+  if (!fs.existsSync(templatePath)) {
+    console.log(chalk.yellow(`Template "${templateName}" not found. Available: ${fs.readdirSync(templatesDir).join(", ")}`));
+    process.exit(1);
+  }
+  fs.copySync(templatePath, projectPath);
+  const pkgPath = path.join(projectPath, "package.json");
+  if (fs.existsSync(pkgPath)) {
+    const pkgJson = await fs.readJSON(pkgPath);
+    pkgJson.name = projectName;
+    await fs.writeJSON(pkgPath, pkgJson, { spaces: 2 });
+  }
+  if (!skipInstall) {
+    try {
+      execSync("npm install", { cwd: projectPath, stdio: "inherit" });
+    } catch {
+      console.log(chalk.yellow("Install failed. Run manually: cd " + projectName + " && npm install"));
+    }
+  }
+  console.log();
+  console.log(chalk.green.bold("\u2714 Success!"), "Created", chalk.cyan(projectName));
+  console.log(chalk.gray("  cd " + projectName));
+  if (skipInstall) console.log(chalk.gray("  npm install"));
+  console.log(chalk.gray("  cp .env.example .env  # then add SECRET_KEY / SOROSWAP_API_KEY"));
+  console.log(chalk.gray("  npm run dev"));
+  console.log();
+}
+main().catch((e) => {
+  console.error(e);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "create-stellar-devkit-app",
+  "version": "1.0.0",
+  "description": "Scaffold Stellar DevKit apps – Agent Kit or x402 API",
+  "type": "module",
+  "bin": "./dist/index.js",
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0",
+    "fs-extra": "^11.2.0",
+    "prompts": "^2.4.2"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "tsup": "^8.5.0",
+    "typescript": "^5.3.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/codewmilan/stellar-agent-kit.git"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/templates/agent-kit/.env.example

@@ -0,0 +1,4 @@
+# Stellar Agent Kit – testnet by default
+SECRET_KEY=S...
+SOROSWAP_API_KEY=sk_...
+NETWORK=testnet

package/templates/agent-kit/README.md

@@ -0,0 +1,27 @@
+# Stellar Agent Kit starter
+
+Minimal Next.js app using `stellar-agent-kit` for a DEX quote.
+
+## Setup
+
+1. Copy env and set your keys:
+   ```bash
+   cp .env.example .env
+   ```
+   Edit `.env`:
+   - `SECRET_KEY` — Stellar secret key (S...) for the quote API (server-only).
+   - `SOROSWAP_API_KEY` — Optional for quote; required if you add swap execution.
+   - `NETWORK` — `testnet` or `mainnet` (default: testnet).
+
+2. Install and run:
+   ```bash
+   npm install
+   npm run dev
+   ```
+
+3. Open http://localhost:3000 and click **Get XLM → USDC quote**.
+
+## Next steps
+
+- Add a swap flow: call `agent.dexSwap(quote)` from an API route (keep `SECRET_KEY` server-side) or use Freighter to sign in the browser and submit via your API.
+- Use the full [Warly UI](../../../ui) in this repo as reference for swap UI, wallet connect, and API routes.

package/templates/agent-kit/app/api/quote/route.ts

@@ -0,0 +1,35 @@
+import { NextResponse } from "next/server";
+import { StellarAgentKit, MAINNET_ASSETS, TESTNET_ASSETS } from "stellar-agent-kit";
+
+export async function GET() {
+  const secretKey = process.env.SECRET_KEY;
+  const network = (process.env.NETWORK === "mainnet" ? "mainnet" : "testnet") as "mainnet" | "testnet";
+  const assets = network === "mainnet" ? MAINNET_ASSETS : TESTNET_ASSETS;
+
+  if (!secretKey) {
+    return NextResponse.json(
+      { error: "Set SECRET_KEY in .env" },
+      { status: 500 }
+    );
+  }
+
+  try {
+    const agent = new StellarAgentKit(secretKey, network);
+    await agent.initialize();
+
+    const quote = await agent.dexGetQuote(
+      { contractId: assets.XLM.contractId },
+      { contractId: assets.USDC.contractId },
+      "10000000" // 1 XLM (7 decimals)
+    );
+
+    return NextResponse.json({
+      amountIn: quote.expectedIn,
+      amountOut: quote.expectedOut,
+      minOut: quote.minOut,
+    });
+  } catch (e) {
+    const message = e instanceof Error ? e.message : "Quote failed";
+    return NextResponse.json({ error: message }, { status: 500 });
+  }
+}

package/templates/agent-kit/app/layout.tsx

@@ -0,0 +1,13 @@
+export default function RootLayout({
+  children,
+}: {
+  children: React.ReactNode;
+}) {
+  return (
+    <html lang="en">
+      <body style={{ fontFamily: "system-ui", margin: 0, padding: 24 }}>
+        {children}
+      </body>
+    </html>
+  );
+}

package/templates/agent-kit/app/page.tsx

@@ -0,0 +1,53 @@
+"use client";
+
+import { useState } from "react";
+
+export default function Home() {
+  const [quote, setQuote] = useState<{ in: string; out: string } | null>(null);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+
+  const getQuote = async () => {
+    setLoading(true);
+    setError(null);
+    setQuote(null);
+    try {
+      const res = await fetch("/api/quote");
+      if (!res.ok) throw new Error(await res.text());
+      const data = await res.json();
+      setQuote({ in: data.amountIn ?? "", out: data.amountOut ?? "" });
+    } catch (e) {
+      setError(e instanceof Error ? e.message : "Request failed");
+    } finally {
+      setLoading(false);
+    }
+  };
+
+  return (
+    <div style={{ maxWidth: 560 }}>
+      <h1 style={{ fontSize: 24, marginBottom: 8 }}>Stellar Agent Kit</h1>
+      <p style={{ color: "#666", marginBottom: 24 }}>
+        Starter app. Set <code>SECRET_KEY</code> and <code>SOROSWAP_API_KEY</code> in{" "}
+        <code>.env</code>, then run <code>npm run dev</code>.
+      </p>
+      <button
+        type="button"
+        onClick={getQuote}
+        disabled={loading}
+        style={{
+          padding: "8px 16px",
+          fontSize: 14,
+          cursor: loading ? "not-allowed" : "pointer",
+        }}
+      >
+        {loading ? "Loading…" : "Get XLM → USDC quote (1 XLM)"}
+      </button>
+      {error && <p style={{ color: "crimson", marginTop: 16 }}>{error}</p>}
+      {quote && (
+        <pre style={{ marginTop: 16, padding: 16, background: "#f5f5f5", borderRadius: 8 }}>
+          {JSON.stringify(quote, null, 2)}
+        </pre>
+      )}
+    </div>
+  );
+}

package/templates/agent-kit/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "my-stellar-app",
+  "version": "0.0.1",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start"
+  },
+  "dependencies": {
+    "next": "^14.0.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "stellar-agent-kit": "^1.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0"
+  }
+}

package/templates/x402-api/.env.example

@@ -0,0 +1,3 @@
+# x402 Stellar API – payment receiver account (G...)
+X402_DESTINATION=G...
+NETWORK=testnet

package/templates/x402-api/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "my-x402-api",
+  "version": "0.0.1",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "express": "^4.18.0",
+    "x402-stellar-sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0"
+  }
+}

package/templates/x402-api/src/index.ts

@@ -0,0 +1,29 @@
+/**
+ * Minimal x402 API – premium route gated by Stellar payment.
+ */
+import express from "express";
+import { x402 } from "x402-stellar-sdk/server";
+
+const app = express();
+app.use(express.json());
+
+const destination = process.env.X402_DESTINATION || "GAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA2X";
+const network = (process.env.NETWORK === "mainnet" ? "mainnet" : "testnet") as "mainnet" | "testnet";
+
+app.use(
+  "/api/premium",
+  x402({
+    price: "1",
+    assetCode: "XLM",
+    network,
+    destination,
+    memo: "premium-api",
+  })
+);
+
+app.get("/api/premium", (_req, res) => {
+  res.json({ data: "Premium content – payment verified." });
+});
+
+const port = process.env.PORT || 3000;
+app.listen(port, () => console.log(`x402 API at http://localhost:${port}`));