@caatinga/cli 0.2.1 → 0.2.3

package/README.md

@@ -14,12 +14,12 @@ Inside a generated project, prefer `npx caatinga` so the project-local workflow
 ## Requirements
 
 - Node.js `>=20`
-- [Stellar CLI](https://developers.stellar.org/docs/tools/developer-tools/cli/stellar-cli) `>=22.0.0` and `<=25.2.0` on `PATH`
-- Rust stable and the `wasm32-unknown-unknown` target (contract builds)
+- [Stellar CLI](https://developers.stellar.org/docs/tools/developer-tools/cli/stellar-cli) `>=23.0.0` and `<=25.2.0` on `PATH` (22.x breaks `caatinga invoke` signing)
+- Rust 1.84.0 or newer with the `wasm32v1-none` target (contract builds)
 - A funded Stellar CLI identity for `deploy` and `invoke` (for example `alice`)
 
 ```bash
-rustup target add wasm32-unknown-unknown
+rustup target add wasm32v1-none
 stellar keys generate alice --fund --network testnet
 ```
 
@@ -45,6 +45,7 @@ npx caatinga invoke counter.increment --network testnet --source alice
 | Command | What it does |
 | --- | --- |
 | `caatinga init <projectName>` | Create a project from a bundled template and write `caatinga.artifacts.json` |
+| `caatinga doctor [--network <network>] [--source <identity>]` | Check local Node, Stellar CLI, Rust, config, artifacts, network, and source identity setup |
 | `caatinga build [contract]` | Compile contract WASM through Stellar CLI (default contract: `counter`) |
 | `caatinga deploy [contract]` | Deploy one contract or the full configured graph; record IDs in artifacts |
 | `caatinga generate <contract>` | Generate TypeScript bindings from a deployed contract ID |
@@ -63,6 +64,12 @@ The supported CLI flow is `init -> build -> deploy -> generate -> invoke`.
 - `[contract]` defaults to `counter` when omitted
 - `--allow-untested-stellar-cli` allows a Stellar CLI newer than Caatinga's tested maximum (local only)
 
+### `doctor`
+
+- `-n, --network <network>` validates that the network exists in `caatinga.config.ts`
+- `-s, --source <identity>` validates that the local Stellar CLI identity exists
+- exits `0` when all diagnostics pass and non-zero when a blocking diagnostic fails
+
 ### `deploy`
 
 - Omit `[contract]` to deploy the full configured dependency graph
@@ -84,7 +91,7 @@ Dependencies listed in `dependsOn` deploy first unless `--no-deps` is set. Deplo
 
 ## Supported inputs
 
-- `--source` accepts a Stellar CLI identity alias that can sign transactions; public `G...` addresses and secret keys are rejected
+- `--source` accepts a local Stellar CLI identity alias that can sign transactions; public `G...` addresses and secret keys are rejected
 - `--network` must match a network defined in `caatinga.config.ts`
 - Project commands require `caatinga.config.ts` in the working directory
 

package/dist/index.js

@@ -1,5 +1,34 @@
 #!/usr/bin/env node
 
+// src/utils/preflight.ts
+import chalk from "chalk";
+var NODE_MIN_MAJOR = 20;
+function checkNodeVersion() {
+  const major = parseInt(process.versions.node.split(".")[0] ?? "0", 10);
+  if (major < NODE_MIN_MAJOR) {
+    return `Node.js ${process.versions.node} is below the required minimum v${NODE_MIN_MAJOR}.
+  Install Node.js ${NODE_MIN_MAJOR} or newer: https://nodejs.org/`;
+  }
+  return null;
+}
+function runPreflight() {
+  const failures = [];
+  const nodeFailure = checkNodeVersion();
+  if (nodeFailure) failures.push(nodeFailure);
+  if (failures.length > 0) return { ok: false, failures };
+  return { ok: true };
+}
+function assertPreflight() {
+  const result = runPreflight();
+  if (result.ok) return;
+  console.error(chalk.red.bold("\n\u2716 Caatinga preflight check failed\n"));
+  for (const failure of result.failures) {
+    console.error(chalk.red(`  \u2022 ${failure}
+`));
+  }
+  process.exit(1);
+}
+
 // src/program.ts
 import { Command } from "commander";
 
@@ -7,47 +36,54 @@ import { Command } from "commander";
 import { buildContract, loadConfig } from "@caatinga/core";
 
 // src/utils/errors.ts
+import chalk2 from "chalk";
 import { toCaatingaError } from "@caatinga/core";
+var SEPARATOR = chalk2.gray("\u2500".repeat(50));
+function printError(error) {
+  const caatingaError = toCaatingaError(error);
+  console.error("");
+  console.error(SEPARATOR);
+  console.error(chalk2.red.bold("  \u2716 Error"));
+  console.error(SEPARATOR);
+  console.error(chalk2.red(`  ${caatingaError.message}`));
+  console.error("");
+  console.error(chalk2.gray(`  Code: ${caatingaError.code}`));
+  if (caatingaError.hint) {
+    console.error("");
+    console.error(chalk2.yellow(`  Hint: ${caatingaError.hint}`));
+  }
+  console.error(SEPARATOR);
+  console.error("");
+}
+async function runCliAction(action) {
+  try {
+    await action();
+  } catch (error) {
+    printError(error);
+    process.exitCode = 1;
+  }
+}
 
 // src/utils/logger.ts
-import chalk from "chalk";
+import chalk3 from "chalk";
 var logger = {
   info(message) {
     console.log(message);
   },
   success(message) {
-    console.log(chalk.green(message));
+    console.log(chalk3.green(message));
   },
   warn(message) {
-    console.warn(chalk.yellow(message));
+    console.warn(chalk3.yellow(message));
   },
   error(message) {
-    console.error(chalk.red(message));
+    console.error(chalk3.red(message));
   },
   muted(message) {
-    console.log(chalk.gray(message));
+    console.log(chalk3.gray(message));
   }
 };
 
-// src/utils/errors.ts
-function printError(error) {
-  const caatingaError = toCaatingaError(error);
-  logger.error(`Error: ${caatingaError.message}`);
-  logger.info("");
-  logger.info(`Code: ${caatingaError.code}`);
-  if (caatingaError.hint) {
-    logger.info(`Hint: ${caatingaError.hint}`);
-  }
-}
-async function runCliAction(action) {
-  try {
-    await action();
-  } catch (error) {
-    printError(error);
-    process.exitCode = 1;
-  }
-}
-
 // src/commands/build.command.ts
 function registerBuildCommand(program2) {
   program2.command("build").description("Build a configured Soroban contract").argument("[contract]", "Contract name", "counter").option("--allow-untested-stellar-cli", "Allow local use of a Stellar CLI version newer than Caatinga's tested maximum").action((contractName, options) => runCliAction(async () => {
@@ -67,7 +103,7 @@ function registerBuildCommand(program2) {
 // src/commands/deploy.command.ts
 import { deployContractGraph, CaatingaError, CaatingaErrorCode, loadConfig as loadConfig2 } from "@caatinga/core";
 function registerDeployCommand(program2) {
-  program2.command("deploy").description("Deploy one or all configured Soroban contracts").argument("[contract]", "Contract name").option("-n, --network <network>", "Configured network name").requiredOption("-s, --source <source>", "Stellar CLI identity alias that can sign (for example alice)").option("--force", "Redeploy contracts even if artifacts already contain contract IDs").option("--no-deps", "Do not deploy missing dependencies for a selected contract").option("--allow-untested-stellar-cli", "Allow local use of a Stellar CLI version newer than Caatinga's tested maximum").action((contractName, options) => runCliAction(async () => {
+  program2.command("deploy").description("Deploy one or all configured Soroban contracts").argument("[contract]", "Contract name").option("-n, --network <network>", "Configured network name").requiredOption("-s, --source <source>", "Stellar CLI identity alias that can sign (for example alice)").option("--force", "Redeploy contracts even if artifacts already contain contract IDs").option("--no-deps", "Do not deploy missing dependencies for a selected contract").option("--no-stale-check", "Do not warn when WASM may be older than contract sources").option("--allow-untested-stellar-cli", "Allow local use of a Stellar CLI version newer than Caatinga's tested maximum").option("--verify-deps", "Verify dependency contract IDs exist on-chain before deploy").action((contractName, options) => runCliAction(async () => {
     if (options.deps === false && !contractName) {
       throw new CaatingaError(
         "`--no-deps` requires a contract name.",
@@ -83,14 +119,23 @@ function registerDeployCommand(program2) {
       source: options.source,
       includeDependencies: options.deps !== false,
       force: options.force === true,
+      checkStaleWasm: options.staleCheck !== false,
+      verifyDeps: options.verifyDeps === true,
       allowUntestedStellarCli: options.allowUntestedStellarCli === true
     });
+    for (const warning of result.staleWasmWarnings) {
+      logger.warn(warning.message);
+    }
     logger.success("Deploy complete");
     logger.info("");
     logger.info(`Network: ${result.network.name}`);
+    for (const skipped of result.skippedContracts) {
+      logger.info(`[skipped] ${skipped.name} \u2014 already deployed on ${result.network.name}`);
+      logger.info(`  Contract ID: ${skipped.contractId}`);
+    }
     for (const contract of result.deployedContracts) {
-      logger.info(`Contract: ${contract.name}`);
-      logger.info(`Contract ID: ${contract.contractId}`);
+      logger.info(`[deployed] ${contract.name}`);
+      logger.info(`  Contract ID: ${contract.contractId}`);
     }
     logger.info("Artifacts updated: caatinga.artifacts.json");
   }));
@@ -108,11 +153,248 @@ function registerDevCommand(program2) {
   dev.configureHelp({ visibleOptions: () => [] });
 }
 
+// src/commands/doctor.command.ts
+import { access } from "fs/promises";
+import {
+  assertSupportedStellarCliVersion,
+  CaatingaError as CaatingaError2,
+  CaatingaErrorCode as CaatingaErrorCode2,
+  loadConfig as loadConfig4,
+  parseStellarCliVersion,
+  readArtifacts as readArtifacts2,
+  resolveNetwork as resolveNetwork2,
+  runCommand,
+  validateSourceShape
+} from "@caatinga/core";
+
+// src/commands/doctor-deploy-coverage.ts
+import { loadConfig as loadConfig3, readArtifacts, resolveNetwork } from "@caatinga/core";
+async function evaluateDeployCoverage(options) {
+  const cwd = options.cwd;
+  const config = await loadConfig3({ cwd });
+  const network = resolveNetwork(config, options.networkName);
+  const artifacts = await readArtifacts(cwd);
+  const lines = [];
+  for (const name of Object.keys(config.contracts)) {
+    const contractId = artifacts.networks[network.name]?.contracts[name]?.contractId;
+    if (contractId) {
+      lines.push({ name, ok: true, contractId });
+    } else {
+      lines.push({
+        name,
+        ok: false,
+        fix: `Run: caatinga deploy ${name} --network ${network.name}`
+      });
+    }
+  }
+  return { lines, complete: lines.every((line) => line.ok) };
+}
+
+// src/commands/doctor.command.ts
+var NODE_MIN_MAJOR2 = 20;
+var WASM_TARGET = "wasm32v1-none";
+function nodeDiagnostic() {
+  const version = process.versions.node;
+  const major = Number.parseInt(version.split(".")[0] ?? "0", 10);
+  if (major < NODE_MIN_MAJOR2) {
+    return {
+      ok: false,
+      label: `Node.js ${version} is below the required minimum ${NODE_MIN_MAJOR2}.0.0`,
+      fix: `Install Node.js ${NODE_MIN_MAJOR2} or newer.`
+    };
+  }
+  return { ok: true, label: `Node.js ${version}` };
+}
+async function stellarDiagnostic(allowUntested) {
+  try {
+    const result = await runCommand("stellar", ["--version"], {
+      skipStellarVersionCheck: true
+    });
+    const version = assertSupportedStellarCliVersion({
+      version: parseStellarCliVersion(result.all || result.stdout || result.stderr),
+      allowUntested
+    });
+    return { ok: true, label: `Stellar CLI ${version}` };
+  } catch (error) {
+    const hint = error instanceof CaatingaError2 ? error.hint : void 0;
+    return {
+      ok: false,
+      label: "Stellar CLI not ready",
+      fix: hint ?? "Install Stellar CLI: cargo install --locked stellar-cli --version 25.2.0"
+    };
+  }
+}
+async function rustDiagnostic() {
+  try {
+    const result = await runCommand("rustc", ["--version"]);
+    return { ok: true, label: result.stdout || result.all || "Rust installed" };
+  } catch {
+    return {
+      ok: false,
+      label: "Rust not found",
+      fix: "Install Rust, then run: rustup target add wasm32v1-none"
+    };
+  }
+}
+async function wasmTargetDiagnostic() {
+  try {
+    const result = await runCommand("rustup", ["target", "list", "--installed"]);
+    const installedTargets = result.stdout || result.all;
+    if (installedTargets.split(/\r?\n/).includes(WASM_TARGET)) {
+      return { ok: true, label: `${WASM_TARGET} target installed` };
+    }
+    return {
+      ok: false,
+      label: `${WASM_TARGET} target not installed`,
+      fix: `Run: rustup target add ${WASM_TARGET}`
+    };
+  } catch {
+    return {
+      ok: false,
+      label: "rustup not found",
+      fix: "Install rustup, then run: rustup target add wasm32v1-none"
+    };
+  }
+}
+async function configDiagnostic() {
+  try {
+    await loadConfig4();
+    return { ok: true, label: "caatinga.config.ts found" };
+  } catch (error) {
+    const hint = error instanceof CaatingaError2 ? error.hint : void 0;
+    return {
+      ok: false,
+      label: "caatinga.config.ts not ready",
+      fix: hint ?? "Run this command from a Caatinga project root."
+    };
+  }
+}
+async function artifactsDiagnostic() {
+  try {
+    await access("caatinga.artifacts.json");
+    await readArtifacts2();
+    return { ok: true, label: "caatinga.artifacts.json found" };
+  } catch {
+    return {
+      ok: false,
+      label: "caatinga.artifacts.json not found or invalid",
+      fix: "Run caatinga init, or restore a valid caatinga.artifacts.json file."
+    };
+  }
+}
+async function networkDiagnostic(networkName) {
+  if (!networkName) return void 0;
+  try {
+    const config = await loadConfig4();
+    const network = resolveNetwork2(config, networkName);
+    return { ok: true, label: `network ${network.name} found` };
+  } catch (error) {
+    const hint = error instanceof CaatingaError2 ? error.hint : void 0;
+    return {
+      ok: false,
+      label: `network ${networkName} not found`,
+      fix: hint ?? `Add "${networkName}" to caatinga.config.ts networks.`
+    };
+  }
+}
+async function sourceDiagnostic(source) {
+  if (!source) return void 0;
+  const unsafeSource = validateSourceShape(source);
+  if (unsafeSource) {
+    return {
+      ok: false,
+      label: `source identity ${source} rejected (${unsafeSource.code})`,
+      fix: unsafeSource.hint
+    };
+  }
+  try {
+    await runCommand("stellar", ["keys", "public-key", source]);
+    return { ok: true, label: `source identity ${source} found` };
+  } catch {
+    return {
+      ok: false,
+      label: `source identity ${source} not found`,
+      fix: `Create and fund it: stellar keys generate ${source} --fund --network testnet`
+    };
+  }
+}
+function printDiagnostic(diagnostic) {
+  logger.info(`${diagnostic.ok ? "\u2713" : "\u2717"} ${diagnostic.label}`);
+}
+function printFixes(diagnostics) {
+  const failures = diagnostics.filter((diagnostic) => !diagnostic.ok);
+  if (failures.length === 0) return;
+  logger.info("");
+  logger.info("Fix:");
+  for (const failure of failures) {
+    if (failure.fix) logger.info(failure.fix);
+  }
+}
+function printDeployCoverageLine(line) {
+  if (line.ok) {
+    logger.info(`\u2713 ${line.name} \u2014 ${line.contractId}`);
+    return;
+  }
+  logger.info(`\u2717 ${line.name}`);
+  if (line.fix) logger.info(`  ${line.fix}`);
+}
+async function reportDeployCoverage(networkName) {
+  const coverage = await evaluateDeployCoverage({ networkName });
+  logger.info("");
+  logger.info(`Deploy coverage (${networkName}):`);
+  for (const line of coverage.lines) {
+    printDeployCoverageLine(line);
+  }
+  if (!coverage.complete) {
+    const missing = coverage.lines.filter((line) => !line.ok).map((line) => line.name);
+    throw new CaatingaError2(
+      `Not all configured contracts are deployed on ${networkName}.`,
+      CaatingaErrorCode2.DOCTOR_PARTIAL_DEPLOY,
+      `Deploy missing contracts: ${missing.join(", ")}. See the commands above.`
+    );
+  }
+  return true;
+}
+function registerDoctorCommand(program2) {
+  program2.command("doctor").description("Check local Caatinga, Stellar CLI, Rust, config, and source identity setup").option("-n, --network <network>", "Configured network name to validate").option("-s, --source <source>", "Stellar CLI identity alias to validate").option("--allow-untested-stellar-cli", "Allow local use of a Stellar CLI version newer than Caatinga's tested maximum").action((options) => runCliAction(async () => {
+    logger.info("Caatinga Doctor");
+    logger.info("");
+    const diagnostics = [
+      nodeDiagnostic(),
+      await stellarDiagnostic(options.allowUntestedStellarCli === true),
+      await rustDiagnostic(),
+      await wasmTargetDiagnostic(),
+      await configDiagnostic(),
+      await artifactsDiagnostic(),
+      await networkDiagnostic(options.network),
+      await sourceDiagnostic(options.source)
+    ].filter((diagnostic) => diagnostic !== void 0);
+    for (const diagnostic of diagnostics) {
+      printDiagnostic(diagnostic);
+    }
+    printFixes(diagnostics);
+    let ready = diagnostics.every((diagnostic) => diagnostic.ok);
+    if (options.network && ready) {
+      try {
+        await reportDeployCoverage(options.network);
+      } catch (error) {
+        ready = false;
+        throw error;
+      }
+    }
+    logger.info("");
+    logger.info(`Status: ${ready ? "ready" : "blocked"}`);
+    if (!ready) {
+      process.exitCode = 1;
+    }
+  }));
+}
+
 // src/commands/generate.command.ts
-import { generateBindings, loadConfig as loadConfig3 } from "@caatinga/core";
+import { generateBindings, loadConfig as loadConfig5 } from "@caatinga/core";
 function registerGenerateCommand(program2) {
   program2.command("generate").description("Generate TypeScript bindings for a deployed contract").argument("<contract>", "Contract name").option("-n, --network <network>", "Configured network name").option("--allow-untested-stellar-cli", "Allow local use of a Stellar CLI version newer than Caatinga's tested maximum").action((contractName, options) => runCliAction(async () => {
-    const config = await loadConfig3();
+    const config = await loadConfig5();
     const result = await generateBindings({
       config,
       contractName,
@@ -132,10 +414,10 @@ import path2 from "path";
 import { createProjectFromTemplate } from "@caatinga/core";
 
 // src/utils/template-path.ts
-import { access } from "fs/promises";
+import { access as access2 } from "fs/promises";
 import path from "path";
 import { fileURLToPath } from "url";
-import { CaatingaError as CaatingaError2, CaatingaErrorCode as CaatingaErrorCode2 } from "@caatinga/core";
+import { CaatingaError as CaatingaError3, CaatingaErrorCode as CaatingaErrorCode3 } from "@caatinga/core";
 async function resolveTemplateDir(templateName) {
   const envTemplatesDir = process.env.CAATINGA_TEMPLATES_DIR;
   const candidates = [
@@ -145,14 +427,14 @@ async function resolveTemplateDir(templateName) {
   ].filter((candidate) => Boolean(candidate));
   for (const candidate of candidates) {
     try {
-      await access(candidate);
+      await access2(candidate);
       return candidate;
     } catch {
     }
   }
-  throw new CaatingaError2(
+  throw new CaatingaError3(
     `Template "${templateName}" was not found.`,
-    CaatingaErrorCode2.TEMPLATE_NOT_FOUND,
+    CaatingaErrorCode3.TEMPLATE_NOT_FOUND,
     "Set CAATINGA_TEMPLATES_DIR or run from a Caatinga checkout that includes packages/templates."
   );
 }
@@ -191,15 +473,18 @@ function registerInitCommand(program2) {
     logger.info("Next steps:");
     logger.info(`  cd ${projectDirectory}`);
     logger.info("  npm install");
-    logger.info("  npx caatinga build counter");
+    const defaultContract = result.template.contracts.default;
+    logger.info(
+      defaultContract ? `  npx caatinga build ${defaultContract}` : "  npx caatinga build"
+    );
   }));
 }
 
 // src/commands/invoke.command.ts
-import { invokeContract, loadConfig as loadConfig4 } from "@caatinga/core";
+import { invokeContract, loadConfig as loadConfig6 } from "@caatinga/core";
 function registerInvokeCommand(program2) {
   program2.command("invoke").description("Invoke a deployed contract function").argument("<target>", "Invoke target in contract.method format").argument("[args...]", "Arguments forwarded to Stellar CLI after the method name").option("-n, --network <network>", "Configured network name").requiredOption("-s, --source <source>", "Stellar CLI identity alias that can sign (for example alice)").option("--allow-untested-stellar-cli", "Allow local use of a Stellar CLI version newer than Caatinga's tested maximum").allowUnknownOption(true).allowExcessArguments(true).action((target, args, options) => runCliAction(async () => {
-    const config = await loadConfig4();
+    const config = await loadConfig6();
     const result = await invokeContract({
       config,
       target,
@@ -221,7 +506,7 @@ function registerInvokeCommand(program2) {
 }
 
 // src/version.ts
-var CAATINGA_CLI_VERSION = "0.2.1";
+var CAATINGA_CLI_VERSION = "0.2.3";
 
 // src/program.ts
 function createProgram() {
@@ -229,6 +514,7 @@ function createProgram() {
   program2.name("caatinga").description("Developer toolkit for Stellar/Soroban dApps").version(CAATINGA_CLI_VERSION);
   registerInitCommand(program2);
   registerDevCommand(program2);
+  registerDoctorCommand(program2);
   registerBuildCommand(program2);
   registerDeployCommand(program2);
   registerGenerateCommand(program2);
@@ -237,6 +523,7 @@ function createProgram() {
 }
 
 // src/index.ts
+assertPreflight();
 var program = createProgram();
 void program.parseAsync(process.argv).catch((error) => {
   console.error(error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@caatinga/cli",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Caatinga CLI for building dApps on Stellar/Soroban",
   "keywords": [
     "stellar",
@@ -43,9 +43,9 @@
     "LICENSE"
   ],
   "dependencies": {
+    "@caatinga/core": "^0.2.3",
     "chalk": "^5.4.1",
-    "commander": "^12.1.0",
-    "@caatinga/core": "^0.2.1"
+    "commander": "^12.1.0"
   },
   "devDependencies": {
     "tsup": "^8.3.5",

package/templates/marketplace-with-token/README.md

@@ -1,19 +0,0 @@
-# __PROJECT_NAME__
-
-Experimental Caatinga multi-contract template.
-
-## Deploy
-
-```bash
-npm install
-npx caatinga build token
-npx caatinga build marketplace
-npx caatinga deploy --network testnet --source alice
-```
-
-Deploy order:
-
-1. `token`
-2. `marketplace`
-
-`marketplace.deployArgs.tokenContractId` resolves from `${contracts.token.contractId}` after the token deploy writes `caatinga.artifacts.json`.

package/templates/marketplace-with-token/caatinga.artifacts.json

@@ -1,10 +0,0 @@
-{
-  "project": "__PROJECT_NAME__",
-  "version": 1,
-  "networks": {
-    "testnet": {
-      "contracts": {},
-      "dependencyGraph": {}
-    }
-  }
-}

package/templates/marketplace-with-token/caatinga.config.ts

@@ -1,30 +0,0 @@
-import { defineConfig } from "@caatinga/core";
-
-export default defineConfig({
-  project: "__PROJECT_NAME__",
-  defaultNetwork: "testnet",
-  contracts: {
-    token: {
-      path: "./contracts/token",
-      wasm: "./contracts/token/target/wasm32-unknown-unknown/release/token.wasm"
-    },
-    marketplace: {
-      path: "./contracts/marketplace",
-      wasm: "./contracts/marketplace/target/wasm32-unknown-unknown/release/marketplace.wasm",
-      dependsOn: ["token"],
-      deployArgs: {
-        tokenContractId: "${contracts.token.contractId}"
-      }
-    }
-  },
-  networks: {
-    testnet: {
-      rpcUrl: "https://soroban-testnet.stellar.org",
-      networkPassphrase: "Test SDF Network ; September 2015"
-    }
-  },
-  frontend: {
-    framework: "vite-react",
-    bindingsOutput: "./src/contracts/generated"
-  }
-});

package/templates/marketplace-with-token/caatinga.template.json

@@ -1,21 +0,0 @@
-{
-  "name": "marketplace-with-token",
-  "version": "0.1.0",
-  "description": "Experimental multi-contract Soroban template with token dependency injection.",
-  "caatinga": {
-    "compatibleCore": "^0.2.1",
-    "templateVersion": 1
-  },
-  "frontend": {
-    "framework": "vite-react",
-    "packageManager": "npm"
-  },
-  "contracts": {
-    "path": "contracts",
-    "default": "marketplace"
-  },
-  "files": {
-    "config": "caatinga.config.ts",
-    "artifacts": "caatinga.artifacts.json"
-  }
-}

package/templates/marketplace-with-token/contracts/marketplace/Cargo.toml

@@ -1,23 +0,0 @@
-[package]
-name = "marketplace"
-version = "0.1.0"
-edition = "2021"
-
-[lib]
-crate-type = ["cdylib"]
-
-[dependencies]
-soroban-sdk = "22.0.1"
-
-[dev-dependencies]
-soroban-sdk = { version = "22.0.1", features = ["testutils"] }
-
-[profile.release]
-opt-level = "z"
-overflow-checks = true
-debug = 0
-strip = "symbols"
-debug-assertions = false
-panic = "abort"
-codegen-units = 1
-lto = true

package/templates/marketplace-with-token/contracts/marketplace/src/lib.rs

@@ -1,13 +0,0 @@
-#![no_std]
-
-use soroban_sdk::{contract, contractimpl, Env};
-
-#[contract]
-pub struct MarketplaceContract;
-
-#[contractimpl]
-impl MarketplaceContract {
-    pub fn version(_env: Env) -> u32 {
-        1
-    }
-}

package/templates/marketplace-with-token/contracts/token/Cargo.toml

@@ -1,23 +0,0 @@
-[package]
-name = "token"
-version = "0.1.0"
-edition = "2021"
-
-[lib]
-crate-type = ["cdylib"]
-
-[dependencies]
-soroban-sdk = "22.0.1"
-
-[dev-dependencies]
-soroban-sdk = { version = "22.0.1", features = ["testutils"] }
-
-[profile.release]
-opt-level = "z"
-overflow-checks = true
-debug = 0
-strip = "symbols"
-debug-assertions = false
-panic = "abort"
-codegen-units = 1
-lto = true

package/templates/marketplace-with-token/contracts/token/src/lib.rs

@@ -1,13 +0,0 @@
-#![no_std]
-
-use soroban_sdk::{contract, contractimpl, Env};
-
-#[contract]
-pub struct TokenContract;
-
-#[contractimpl]
-impl TokenContract {
-    pub fn version(_env: Env) -> u32 {
-        1
-    }
-}

package/templates/marketplace-with-token/package.json

@@ -1,17 +0,0 @@
-{
-  "name": "__PROJECT_NAME__",
-  "version": "0.1.0",
-  "private": true,
-  "type": "module",
-  "scripts": {
-    "caatinga:build": "caatinga build token && caatinga build marketplace",
-    "caatinga:deploy": "caatinga deploy --network testnet"
-  },
-  "dependencies": {
-    "@caatinga/core": "^0.2.1"
-  },
-  "devDependencies": {
-    "@caatinga/cli": "^0.2.1",
-    "typescript": "^5.7.2"
-  }
-}

package/templates/marketplace-with-token/src/main.ts

@@ -1,10 +0,0 @@
-export const templateId = "marketplace-with-token";
-
-export function describeDeployFlow(): string {
-  return [
-    "1. caatinga build token",
-    "2. caatinga build marketplace",
-    "3. caatinga deploy --network testnet --source <identity>",
-    "marketplace.deployArgs.tokenContractId resolves from caatinga.artifacts.json"
-  ].join("\n");
-}

package/templates/marketplace-with-token/tsconfig.json

@@ -1,11 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2020",
-    "module": "ESNext",
-    "moduleResolution": "Bundler",
-    "strict": true,
-    "skipLibCheck": true,
-    "noEmit": true
-  },
-  "include": ["src", "caatinga.config.ts"]
-}

package/templates/react-vite-counter/README.md

@@ -1,58 +0,0 @@
-# __PROJECT_NAME__
-
-Caatinga counter dApp for Stellar/Soroban.
-
-## CLI Flow
-
-```bash
-npm install
-npx caatinga build counter
-npx caatinga deploy counter --network testnet --source alice
-npx caatinga generate counter --network testnet
-npx caatinga invoke counter.increment --network testnet --source alice
-npm run dev
-```
-
-Use a Stellar CLI identity alias or public account address for `--source`; do not pass seed phrases or secret keys.
-
-## Client Smoke Path
-
-After `caatinga generate`, wire generated bindings to the client:
-
-```ts
-import { createCaatingaClient } from "@caatinga/client";
-import { freighterWalletAdapter } from "@caatinga/client/freighter";
-import * as Counter from "./contracts/generated/counter";
-import artifacts from "../caatinga.artifacts.json";
-
-export const caatingaClient = createCaatingaClient({
-  network: {
-    name: "testnet",
-    rpcUrl: "https://soroban-testnet.stellar.org",
-    networkPassphrase: "Test SDF Network ; September 2015"
-  },
-  artifacts,
-  wallet: freighterWalletAdapter,
-  contracts: {
-    counter: {
-      binding: Counter
-    }
-  }
-});
-```
-
-Build XDR without wallet signing:
-
-```ts
-const tx = await caatingaClient.contract("counter").buildXdr("increment");
-console.log(tx.preparedXdr);
-```
-
-Invoke through Freighter:
-
-```ts
-const result = await caatingaClient.contract("counter").invoke("increment", {
-  debugXdr: true
-});
-console.log(result.transactionHash);
-```

package/templates/react-vite-counter/caatinga.config.ts

@@ -1,26 +0,0 @@
-import { defineConfig } from "@caatinga/core";
-
-export default defineConfig({
-  project: "__PROJECT_NAME__",
-  defaultNetwork: "testnet",
-  contracts: {
-    counter: {
-      path: "./contracts/counter",
-      wasm: "./contracts/counter/target/wasm32-unknown-unknown/release/counter.wasm"
-    }
-  },
-  networks: {
-    testnet: {
-      rpcUrl: "https://soroban-testnet.stellar.org",
-      networkPassphrase: "Test SDF Network ; September 2015"
-    },
-    mainnet: {
-      rpcUrl: "https://mainnet.sorobanrpc.com",
-      networkPassphrase: "Public Global Stellar Network ; September 2015"
-    }
-  },
-  frontend: {
-    framework: "vite-react",
-    bindingsOutput: "./src/contracts/generated"
-  }
-});

package/templates/react-vite-counter/caatinga.template.json

@@ -1,21 +0,0 @@
-{
-  "name": "react-vite-counter",
-  "version": "0.1.0",
-  "description": "Minimal Vite + React + Soroban counter dApp.",
-  "caatinga": {
-    "compatibleCore": "^0.2.1",
-    "templateVersion": 1
-  },
-  "frontend": {
-    "framework": "vite-react",
-    "packageManager": "npm"
-  },
-  "contracts": {
-    "path": "contracts",
-    "default": "counter"
-  },
-  "files": {
-    "config": "caatinga.config.ts",
-    "artifacts": "caatinga.artifacts.json"
-  }
-}

package/templates/react-vite-counter/contracts/counter/Cargo.toml

@@ -1,23 +0,0 @@
-[package]
-name = "counter"
-version = "0.1.0"
-edition = "2021"
-
-[lib]
-crate-type = ["cdylib"]
-
-[dependencies]
-soroban-sdk = "22.0.1"
-
-[dev-dependencies]
-soroban-sdk = { version = "22.0.1", features = ["testutils"] }
-
-[profile.release]
-opt-level = "z"
-overflow-checks = true
-debug = 0
-strip = "symbols"
-debug-assertions = false
-panic = "abort"
-codegen-units = 1
-lto = true

package/templates/react-vite-counter/contracts/counter/src/lib.rs

@@ -1,36 +0,0 @@
-#![no_std]
-
-use soroban_sdk::{contract, contractimpl, Env};
-
-#[contract]
-pub struct CounterContract;
-
-#[contractimpl]
-impl CounterContract {
-    pub fn get(env: Env) -> u32 {
-        env.storage().instance().get(&"count").unwrap_or(0)
-    }
-
-    pub fn increment(env: Env) -> u32 {
-        let count = Self::get(env.clone()) + 1;
-        env.storage().instance().set(&"count", &count);
-        count
-    }
-}
-
-#[cfg(test)]
-mod test {
-    use super::*;
-    use soroban_sdk::Env;
-
-    #[test]
-    fn increments_counter() {
-        let env = Env::default();
-        let contract_id = env.register(CounterContract, ());
-        let client = CounterContractClient::new(&env, &contract_id);
-
-        assert_eq!(client.get(), 0);
-        assert_eq!(client.increment(), 1);
-        assert_eq!(client.get(), 1);
-    }
-}

package/templates/react-vite-counter/index.html

@@ -1,12 +0,0 @@
-<!doctype html>
-<html lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>__PROJECT_NAME__</title>
-  </head>
-  <body>
-    <div id="root"></div>
-    <script type="module" src="/src/main.tsx"></script>
-  </body>
-</html>

package/templates/react-vite-counter/package.json

@@ -1,29 +0,0 @@
-{
-  "name": "__PROJECT_NAME__",
-  "version": "0.1.0",
-  "private": true,
-  "type": "module",
-  "scripts": {
-    "dev": "vite",
-    "build": "tsc && vite build",
-    "preview": "vite preview",
-    "caatinga:build": "caatinga build counter",
-    "caatinga:deploy": "caatinga deploy counter",
-    "caatinga:generate": "caatinga generate counter"
-  },
-  "dependencies": {
-    "@caatinga/client": "^0.2.1",
-    "@caatinga/core": "^0.2.1",
-    "@stellar/freighter-api": "^4.0.0",
-    "@vitejs/plugin-react": "^4.3.4",
-    "vite": "^6.0.6",
-    "react": "^18.3.1",
-    "react-dom": "^18.3.1"
-  },
-  "devDependencies": {
-    "@caatinga/cli": "^0.2.1",
-    "@types/react": "^18.3.18",
-    "@types/react-dom": "^18.3.5",
-    "typescript": "^5.7.2"
-  }
-}

package/templates/react-vite-counter/public/.gitkeep

@@ -1 +0,0 @@
-

package/templates/react-vite-counter/src/App.tsx

@@ -1,18 +0,0 @@
-import { CounterCard } from "./components/CounterCard";
-import { WalletButton } from "./components/WalletButton";
-
-export default function App() {
-  return (
-    <main className="app-shell">
-      <header className="topbar">
-        <div>
-          <p className="eyebrow">Caatinga</p>
-          <h1>__PROJECT_NAME__</h1>
-        </div>
-        <WalletButton />
-      </header>
-
-      <CounterCard />
-    </main>
-  );
-}

package/templates/react-vite-counter/src/components/CounterCard.tsx

@@ -1,29 +0,0 @@
-import { useMemo, useState } from "react";
-
-export function CounterCard() {
-  const [count, setCount] = useState(0);
-  const formattedCount = useMemo(() => new Intl.NumberFormat().format(count), [count]);
-
-  return (
-    <section className="counter-panel" aria-labelledby="counter-title">
-      <div className="counter-panel__header">
-        <div>
-          <p className="eyebrow">Counter Contract</p>
-          <h2 id="counter-title">Counter</h2>
-        </div>
-        <span className="network-pill">testnet</span>
-      </div>
-
-      <div className="counter-value">{formattedCount}</div>
-
-      <div className="counter-actions">
-        <button type="button" onClick={() => setCount((value) => value + 1)}>
-          Increment
-        </button>
-        <button className="secondary-button" type="button" onClick={() => setCount(0)}>
-          Reset
-        </button>
-      </div>
-    </section>
-  );
-}

package/templates/react-vite-counter/src/components/WalletButton.tsx

@@ -1,12 +0,0 @@
-import { useState } from "react";
-
-export function WalletButton() {
-  const [connected, setConnected] = useState(false);
-
-  return (
-    <button className="wallet-button" type="button" onClick={() => setConnected((value) => !value)}>
-      <span className={connected ? "status-dot status-dot--on" : "status-dot"} />
-      {connected ? "Connected" : "Connect"}
-    </button>
-  );
-}

package/templates/react-vite-counter/src/contracts/generated/.gitkeep

@@ -1 +0,0 @@
-

package/templates/react-vite-counter/src/main.tsx

@@ -1,10 +0,0 @@
-import React from "react";
-import ReactDOM from "react-dom/client";
-import App from "./App";
-import "./styles.css";
-
-ReactDOM.createRoot(document.getElementById("root")!).render(
-  <React.StrictMode>
-    <App />
-  </React.StrictMode>
-);

package/templates/react-vite-counter/src/styles.css

@@ -1,155 +0,0 @@
-:root {
-  color: #20232a;
-  background: #f4f2ec;
-  font-family:
-    Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
-  font-synthesis: none;
-  text-rendering: optimizeLegibility;
-}
-
-* {
-  box-sizing: border-box;
-}
-
-body {
-  min-width: 320px;
-  min-height: 100vh;
-  margin: 0;
-}
-
-button {
-  min-height: 44px;
-  border: 0;
-  border-radius: 8px;
-  padding: 0 16px;
-  background: #1d6154;
-  color: #ffffff;
-  font: inherit;
-  font-weight: 700;
-  cursor: pointer;
-}
-
-button:hover {
-  background: #174d44;
-}
-
-.app-shell {
-  width: min(960px, calc(100vw - 32px));
-  margin: 0 auto;
-  padding: 24px 0;
-}
-
-.topbar {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  gap: 16px;
-  margin-bottom: 32px;
-}
-
-.topbar h1,
-.counter-panel h2 {
-  margin: 0;
-  color: #16181d;
-  letter-spacing: 0;
-}
-
-.topbar h1 {
-  font-size: clamp(2rem, 8vw, 4rem);
-  line-height: 1;
-}
-
-.counter-panel h2 {
-  font-size: 1.35rem;
-}
-
-.eyebrow {
-  margin: 0 0 8px;
-  color: #697076;
-  font-size: 0.78rem;
-  font-weight: 800;
-  letter-spacing: 0.08em;
-  text-transform: uppercase;
-}
-
-.wallet-button,
-.network-pill {
-  display: inline-flex;
-  align-items: center;
-  gap: 8px;
-  white-space: nowrap;
-}
-
-.status-dot {
-  width: 8px;
-  height: 8px;
-  border-radius: 999px;
-  background: #a9afb4;
-}
-
-.status-dot--on {
-  background: #66c887;
-}
-
-.counter-panel {
-  border: 1px solid #d9d5ca;
-  border-radius: 8px;
-  padding: clamp(20px, 5vw, 40px);
-  background: #fffdf7;
-  box-shadow: 0 18px 60px rgba(32, 35, 42, 0.08);
-}
-
-.counter-panel__header {
-  display: flex;
-  align-items: flex-start;
-  justify-content: space-between;
-  gap: 16px;
-}
-
-.network-pill {
-  min-height: 32px;
-  border: 1px solid #d9d5ca;
-  border-radius: 999px;
-  padding: 0 12px;
-  color: #45515a;
-  font-weight: 700;
-}
-
-.counter-value {
-  margin: 48px 0;
-  color: #111318;
-  font-size: clamp(5rem, 24vw, 12rem);
-  font-weight: 900;
-  line-height: 0.9;
-  letter-spacing: 0;
-}
-
-.counter-actions {
-  display: flex;
-  flex-wrap: wrap;
-  gap: 12px;
-}
-
-.secondary-button {
-  border: 1px solid #d9d5ca;
-  background: #ffffff;
-  color: #20232a;
-}
-
-.secondary-button:hover {
-  background: #f4f2ec;
-}
-
-@media (max-width: 560px) {
-  .topbar,
-  .counter-panel__header {
-    align-items: stretch;
-    flex-direction: column;
-  }
-
-  .wallet-button,
-  .counter-actions button {
-    width: 100%;
-    justify-content: center;
-  }
-}

package/templates/react-vite-counter/tsconfig.json

@@ -1,21 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2020",
-    "useDefineForClassFields": true,
-    "lib": ["DOM", "DOM.Iterable", "ES2020"],
-    "allowJs": false,
-    "skipLibCheck": true,
-    "esModuleInterop": true,
-    "allowSyntheticDefaultImports": true,
-    "strict": true,
-    "forceConsistentCasingInFileNames": true,
-    "module": "ESNext",
-    "moduleResolution": "Node",
-    "resolveJsonModule": true,
-    "isolatedModules": true,
-    "noEmit": true,
-    "jsx": "react-jsx"
-  },
-  "include": ["src"],
-  "references": []
-}

package/templates/react-vite-counter/vite.config.ts

@@ -1,6 +0,0 @@
-import { defineConfig } from "vite";
-import react from "@vitejs/plugin-react";
-
-export default defineConfig({
-  plugins: [react()]
-});