@caatinga/core 3.0.0 → 3.1.0

package/README.md

@@ -53,19 +53,19 @@ export default defineConfig({
   contracts: {
     counter: {
       path: "./contracts/counter",
-      wasm: "./contracts/counter/target/wasm32v1-none/release/counter.wasm"
-    }
+      wasm: "./contracts/counter/target/wasm32v1-none/release/counter.wasm",
+    },
   },
   networks: {
     testnet: {
       rpcUrl: "https://soroban-testnet.stellar.org",
-      networkPassphrase: "Test SDF Network ; September 2015"
-    }
+      networkPassphrase: "Test SDF Network ; September 2015",
+    },
   },
   frontend: {
     framework: "vite-react",
-    bindingsOutput: "./contracts/generated"
-  }
+    bindingsOutput: "./contracts/generated",
+  },
 });
 ```
 
@@ -73,11 +73,11 @@ Multi-contract projects may declare `dependsOn` and `${contracts.<name>.contract
 
 ## Consumer guidance
 
-| Goal | Package |
-| --- | --- |
-| End-user CLI workflow | `@caatinga/cli` |
-| Browser / Node client over generated bindings | `@caatinga/client` |
-| `caatinga.config.ts` in a Caatinga project | `defineConfig` from `@caatinga/core` |
+| Goal                                                                     | Package                                             |
+| ------------------------------------------------------------------------ | --------------------------------------------------- |
+| End-user CLI workflow                                                    | `@caatinga/cli`                                     |
+| Browser / Node client over generated bindings                            | `@caatinga/client`                                  |
+| `caatinga.config.ts` in a Caatinga project                               | `defineConfig` from `@caatinga/core`                |
 | Custom tooling on deploy graphs, artifacts, or Stellar CLI orchestration | `@caatinga/core` (advanced; track releases closely) |
 
 ## Error codes

package/dist/{artifact.schema-CGCFfl0g.d.cts → artifact.schema-D4r8dyYK.d.cts}

@@ -52,7 +52,7 @@ declare const CaatingaErrorCode: {
     readonly DOCTOR_PARTIAL_DEPLOY: "CAATINGA_DOCTOR_PARTIAL_DEPLOY";
     readonly MULTI_AUTH_REQUIRED: "CAATINGA_MULTI_AUTH_REQUIRED";
 };
-type CaatingaErrorCodeValue = typeof CaatingaErrorCode[keyof typeof CaatingaErrorCode];
+type CaatingaErrorCodeValue = (typeof CaatingaErrorCode)[keyof typeof CaatingaErrorCode];
 
 declare class CaatingaError extends Error {
     readonly code: CaatingaErrorCodeValue;

package/dist/{artifact.schema-CGCFfl0g.d.ts → artifact.schema-D4r8dyYK.d.ts}

@@ -52,7 +52,7 @@ declare const CaatingaErrorCode: {
     readonly DOCTOR_PARTIAL_DEPLOY: "CAATINGA_DOCTOR_PARTIAL_DEPLOY";
     readonly MULTI_AUTH_REQUIRED: "CAATINGA_MULTI_AUTH_REQUIRED";
 };
-type CaatingaErrorCodeValue = typeof CaatingaErrorCode[keyof typeof CaatingaErrorCode];
+type CaatingaErrorCodeValue = (typeof CaatingaErrorCode)[keyof typeof CaatingaErrorCode];
 
 declare class CaatingaError extends Error {
     readonly code: CaatingaErrorCodeValue;

package/dist/browser.d.cts

@@ -1,4 +1,4 @@
-export { C as CaatingaArtifacts, a as CaatingaError, b as CaatingaErrorCode, c as ContractArtifact, f as formatCaatingaError, t as toCaatingaError } from './artifact.schema-CGCFfl0g.cjs';
+export { C as CaatingaArtifacts, a as CaatingaError, b as CaatingaErrorCode, c as ContractArtifact, f as formatCaatingaError, t as toCaatingaError } from './artifact.schema-D4r8dyYK.cjs';
 import 'zod';
 
 declare function assertSorobanSymbol(value: string, paramName?: string): void;

package/dist/browser.d.ts

@@ -1,4 +1,4 @@
-export { C as CaatingaArtifacts, a as CaatingaError, b as CaatingaErrorCode, c as ContractArtifact, f as formatCaatingaError, t as toCaatingaError } from './artifact.schema-CGCFfl0g.js';
+export { C as CaatingaArtifacts, a as CaatingaError, b as CaatingaErrorCode, c as ContractArtifact, f as formatCaatingaError, t as toCaatingaError } from './artifact.schema-D4r8dyYK.js';
 import 'zod';
 
 declare function assertSorobanSymbol(value: string, paramName?: string): void;

package/dist/index.cjs

@@ -211,9 +211,7 @@ function formatCause(cause) {
 // src/version.ts
 var import_node_module = require("module");
 var import_meta = {};
-var require2 = (0, import_node_module.createRequire)(
-  typeof __filename === "string" ? __filename : import_meta.url
-);
+var require2 = (0, import_node_module.createRequire)(typeof __filename === "string" ? __filename : import_meta.url);
 var CAATINGA_CORE_VERSION = require2("../package.json").version;
 
 // src/config/config.schema.ts
@@ -861,12 +859,7 @@ function matchesWellKnownNetwork(name, config) {
   return known.rpcUrl === config.rpcUrl && known.networkPassphrase === config.networkPassphrase;
 }
 function buildRpcNetworkArgs(config) {
-  return [
-    "--rpc-url",
-    config.rpcUrl,
-    "--network-passphrase",
-    config.networkPassphrase
-  ];
+  return ["--rpc-url", config.rpcUrl, "--network-passphrase", config.networkPassphrase];
 }
 function buildStellarNetworkArgsFromConfig(config) {
   for (const [name, known] of Object.entries(WELL_KNOWN_NETWORKS)) {
@@ -920,19 +913,23 @@ async function fetchCreateContractSalt(horizonUrl, transactionHash, fetchImpl =
 }
 async function resolveContractIdFromDeploySalt(options) {
   const saltHex = decimalSaltToHex(options.salt);
-  const result = await runCommand("stellar", [
-    "contract",
-    "id",
-    "wasm",
-    "--salt",
-    saltHex,
-    "--source-account",
-    options.source,
-    ...buildStellarNetworkArgsFromConfig(options.network)
-  ], {
-    cwd: options.cwd,
-    skipStellarVersionCheck: true
-  });
+  const result = await runCommand(
+    "stellar",
+    [
+      "contract",
+      "id",
+      "wasm",
+      "--salt",
+      saltHex,
+      "--source-account",
+      options.source,
+      ...buildStellarNetworkArgsFromConfig(options.network)
+    ],
+    {
+      cwd: options.cwd,
+      skipStellarVersionCheck: true
+    }
+  );
   return parseContractId(result.all || `${result.stdout}
 ${result.stderr}`);
 }
@@ -1080,8 +1077,12 @@ function buildAlternateWasmCandidates(configuredWasmPath, options) {
     addCandidate(import_node_path8.default.join(cargoTargetDir, LEGACY_RUST_WASM_TARGET, "release", fileName));
   }
   if (options?.sourcePath) {
-    addCandidate(import_node_path8.default.join(options.sourcePath, "target", CURRENT_RUST_WASM_TARGET, "release", fileName));
-    addCandidate(import_node_path8.default.join(options.sourcePath, "target", LEGACY_RUST_WASM_TARGET, "release", fileName));
+    addCandidate(
+      import_node_path8.default.join(options.sourcePath, "target", CURRENT_RUST_WASM_TARGET, "release", fileName)
+    );
+    addCandidate(
+      import_node_path8.default.join(options.sourcePath, "target", LEGACY_RUST_WASM_TARGET, "release", fileName)
+    );
   }
   return candidates;
 }
@@ -1496,17 +1497,21 @@ function toSkippedContract(name, contractId, network) {
 // src/contracts/verify-dependency-contract.ts
 async function verifyDependencyContract(options) {
   try {
-    await runCommand("stellar", [
-      "contract",
-      "info",
-      "interface",
-      "--contract-id",
-      options.contractId,
-      ...buildStellarNetworkArgs(options.network)
-    ], {
-      cwd: options.cwd,
-      failureCode: CaatingaErrorCode.DEPENDENCY_CONTRACT_NOT_FOUND
-    });
+    await runCommand(
+      "stellar",
+      [
+        "contract",
+        "info",
+        "interface",
+        "--contract-id",
+        options.contractId,
+        ...buildStellarNetworkArgs(options.network)
+      ],
+      {
+        cwd: options.cwd,
+        failureCode: CaatingaErrorCode.DEPENDENCY_CONTRACT_NOT_FOUND
+      }
+    );
   } catch (error) {
     if (error instanceof CaatingaError && error.code === CaatingaErrorCode.DEPENDENCY_CONTRACT_NOT_FOUND) {
       throw new CaatingaError(
@@ -1568,9 +1573,7 @@ async function deployContractGraph(options) {
       network: network.name
     });
     if (existing?.contractId && !options.force) {
-      skippedContracts.push(
-        toSkippedContract(contractName, existing.contractId, network.name)
-      );
+      skippedContracts.push(toSkippedContract(contractName, existing.contractId, network.name));
       continue;
     }
     const result = await deployContract({
@@ -1591,9 +1594,7 @@ async function deployContractGraph(options) {
       });
     }
     if (result.skipped) {
-      skippedContracts.push(
-        toSkippedContract(contractName, result.contractId, network.name)
-      );
+      skippedContracts.push(toSkippedContract(contractName, result.contractId, network.name));
     } else {
       deployedContracts.push({ name: contractName, contractId: result.contractId });
     }
@@ -1654,22 +1655,26 @@ async function generateBindings(options) {
   }
   const outputDir = import_node_path10.default.resolve(cwd, options.config.frontend.bindingsOutput, options.contractName);
   await (0, import_promises7.mkdir)(outputDir, { recursive: true });
-  const result = await runCommand("npx", [
-    "--yes",
-    "@stellar/stellar-sdk",
-    "generate",
-    "--contract-id",
-    contractArtifact.contractId,
-    "--output-dir",
-    outputDir,
-    "--contract-name",
-    options.contractName,
-    "--overwrite",
-    ...buildGenerateNetworkArgs(network)
-  ], {
-    cwd,
-    failureCode: CaatingaErrorCode.BINDINGS_FAILED
-  });
+  const result = await runCommand(
+    "npx",
+    [
+      "--yes",
+      "@stellar/stellar-sdk",
+      "generate",
+      "--contract-id",
+      contractArtifact.contractId,
+      "--output-dir",
+      outputDir,
+      "--contract-name",
+      options.contractName,
+      "--overwrite",
+      ...buildGenerateNetworkArgs(network)
+    ],
+    {
+      cwd,
+      failureCode: CaatingaErrorCode.BINDINGS_FAILED
+    }
+  );
   const legacyStubRemoved = await removeLegacyBindingStub(
     cwd,
     options.config.frontend.bindingsOutput,
@@ -1781,21 +1786,25 @@ async function invokeContract(options) {
   await checkBinary("stellar", "Install Stellar CLI before running caatinga invoke.");
   let result;
   try {
-    result = await runCommand("stellar", [
-      "contract",
-      "invoke",
-      "--id",
-      contractArtifact.contractId,
-      "--source-account",
-      source,
-      ...buildStellarNetworkArgs(network),
-      "--",
-      target.method,
-      ...options.args ?? []
-    ], {
-      cwd,
-      failureCode: CaatingaErrorCode.INVOKE_FAILED
-    });
+    result = await runCommand(
+      "stellar",
+      [
+        "contract",
+        "invoke",
+        "--id",
+        contractArtifact.contractId,
+        "--source-account",
+        source,
+        ...buildStellarNetworkArgs(network),
+        "--",
+        target.method,
+        ...options.args ?? []
+      ],
+      {
+        cwd,
+        failureCode: CaatingaErrorCode.INVOKE_FAILED
+      }
+    );
   } catch (error) {
     if (error instanceof CaatingaError && error.code === CaatingaErrorCode.INVOKE_FAILED && isReadCallFailure(error)) {
       throw new CaatingaError(
@@ -1940,12 +1949,7 @@ function formatTemplateCompatibilityHint(issue) {
 }
 
 // src/templates/create-project-from-template.ts
-var TEMPLATE_COPY_EXCLUDED_DIRS = /* @__PURE__ */ new Set([
-  "target",
-  "test_snapshots",
-  "node_modules",
-  ".git"
-]);
+var TEMPLATE_COPY_EXCLUDED_DIRS = /* @__PURE__ */ new Set(["target", "test_snapshots", "node_modules", ".git"]);
 async function createProjectFromTemplate(options) {
   const targetDir = import_node_path11.default.resolve(options.targetDir);
   const templateDir = import_node_path11.default.resolve(options.templateDir);
@@ -1963,8 +1967,8 @@ async function createProjectFromTemplate(options) {
   await (0, import_promises8.mkdir)(targetDir, { recursive: true });
   await (0, import_promises8.cp)(templateDir, targetDir, {
     recursive: true,
-    force: mergeIntoExisting,
-    errorOnExist: !mergeIntoExisting,
+    force: true,
+    errorOnExist: false,
     filter: (source) => shouldCopyTemplateEntry(templateDir, source, options.filter)
   });
   await replaceTemplateVariables(targetDir, options.projectName);
@@ -1979,7 +1983,10 @@ async function ensureArtifacts(targetDir, projectName) {
     await writeArtifacts({ ...artifacts, project: projectName }, targetDir);
   } catch (error) {
     if (error instanceof CaatingaError && error.code === CaatingaErrorCode.ARTIFACT_NOT_FOUND) {
-      await writeArtifacts(createInitialArtifacts(projectName, { networks: ["testnet"] }), targetDir);
+      await writeArtifacts(
+        createInitialArtifacts(projectName, { networks: ["testnet"] }),
+        targetDir
+      );
       return;
     }
     throw error;
@@ -2022,19 +2029,21 @@ async function readTemplateManifest(templateDir) {
 }
 async function replaceTemplateVariables(dir, projectName) {
   const entries = await (0, import_promises8.readdir)(dir);
-  await Promise.all(entries.map(async (entry) => {
-    const entryPath = import_node_path11.default.join(dir, entry);
-    const entryStat = await (0, import_promises8.stat)(entryPath);
-    if (entryStat.isDirectory()) {
-      await replaceTemplateVariables(entryPath, projectName);
-      return;
-    }
-    if (!isTextTemplateFile(entryPath)) {
-      return;
-    }
-    const content = await (0, import_promises8.readFile)(entryPath, "utf8");
-    await (0, import_promises8.writeFile)(entryPath, content.replaceAll("__PROJECT_NAME__", projectName), "utf8");
-  }));
+  await Promise.all(
+    entries.map(async (entry) => {
+      const entryPath = import_node_path11.default.join(dir, entry);
+      const entryStat = await (0, import_promises8.stat)(entryPath);
+      if (entryStat.isDirectory()) {
+        await replaceTemplateVariables(entryPath, projectName);
+        return;
+      }
+      if (!isTextTemplateFile(entryPath)) {
+        return;
+      }
+      const content = await (0, import_promises8.readFile)(entryPath, "utf8");
+      await (0, import_promises8.writeFile)(entryPath, content.replaceAll("__PROJECT_NAME__", projectName), "utf8");
+    })
+  );
 }
 function shouldCopyTemplateEntry(templateDir, source, userFilter) {
   const relativePath = import_node_path11.default.relative(templateDir, source);
@@ -2048,16 +2057,9 @@ function shouldCopyTemplateEntry(templateDir, source, userFilter) {
   return !relativePath.split(import_node_path11.default.sep).some((segment) => TEMPLATE_COPY_EXCLUDED_DIRS.has(segment));
 }
 function isTextTemplateFile(filePath) {
-  return [
-    ".json",
-    ".md",
-    ".rs",
-    ".toml",
-    ".ts",
-    ".tsx",
-    ".css",
-    ".html"
-  ].includes(import_node_path11.default.extname(filePath));
+  return [".json", ".md", ".rs", ".toml", ".ts", ".tsx", ".css", ".html"].includes(
+    import_node_path11.default.extname(filePath)
+  );
 }
 
 // src/scaffold/create-zk-project.ts
@@ -2107,23 +2109,28 @@ export default defineConfig({
 `;
 }
 function packageJsonSource(projectName) {
-  return `${JSON.stringify({
-    name: projectName,
-    version: "0.1.0",
-    private: true,
-    type: "module",
-    scripts: {
-      "zk:build": "caatinga zk build main",
-      "zk:prove": "caatinga zk prove main",
-      build: "caatinga build verifier",
-      deploy: "caatinga deploy verifier --network testnet --source ${CAATINGA_SOURCE:-alice}",
-      doctor: "caatinga doctor --network testnet"
+  return `${JSON.stringify(
+    {
+      name: projectName,
+      version: "0.1.0",
+      private: true,
+      type: "module",
+      scripts: {
+        "zk:build": "caatinga zk build main",
+        "zk:prove": "caatinga zk prove main",
+        build: "caatinga build verifier",
+        deploy: "caatinga deploy verifier --network testnet --source ${CAATINGA_SOURCE:-alice}",
+        doctor: "caatinga doctor --network testnet",
+        test: "cargo test --manifest-path contracts/verifier/Cargo.toml"
+      },
+      devDependencies: {
+        "@caatinga/cli": `^${CAATINGA_CORE_VERSION}`,
+        "@caatinga/core": `^${CAATINGA_CORE_VERSION}`
+      }
     },
-    devDependencies: {
-      "@caatinga/cli": `^${CAATINGA_CORE_VERSION}`,
-      "@caatinga/core": `^${CAATINGA_CORE_VERSION}`
-    }
-  }, null, 2)}
+    null,
+    2
+  )}
 `;
 }
 function readmeSource(projectName) {
@@ -2135,12 +2142,23 @@ Minimal Caatinga ZK project.
 
 \`\`\`bash
 npm install
+npm test
 npx caatinga zk build main
 npx caatinga build verifier
 npx caatinga deploy verifier --network testnet --source <identity>
 npx caatinga zk prove main
 \`\`\`
 
+## Tests
+
+Run the Rust verifier contract tests from the project root:
+
+\`\`\`bash
+npm test
+# or directly:
+cargo test --manifest-path contracts/verifier/Cargo.toml
+\`\`\`
+
 Replace \`circuits/main.circom\` with your circuit. Keep the entry point named \`main\`.
 `;
 }
@@ -2151,10 +2169,22 @@ async function createZkProject(options) {
   await (0, import_promises9.mkdir)(targetDir, { recursive: true });
   if (projectFiles) {
     await Promise.all([
-      (0, import_promises9.writeFile)(import_node_path12.default.join(targetDir, "caatinga.config.ts"), configSource(options.projectName), { encoding: "utf8", flag: force ? "w" : "wx" }),
-      (0, import_promises9.writeFile)(import_node_path12.default.join(targetDir, "package.json"), packageJsonSource(options.projectName), { encoding: "utf8", flag: force ? "w" : "wx" }),
-      (0, import_promises9.writeFile)(import_node_path12.default.join(targetDir, ".gitignore"), "node_modules\n.artifacts\ntarget\n", { encoding: "utf8", flag: force ? "w" : "wx" }),
-      (0, import_promises9.writeFile)(import_node_path12.default.join(targetDir, "README.md"), readmeSource(options.projectName), { encoding: "utf8", flag: force ? "w" : "wx" })
+      (0, import_promises9.writeFile)(import_node_path12.default.join(targetDir, "caatinga.config.ts"), configSource(options.projectName), {
+        encoding: "utf8",
+        flag: force ? "w" : "wx"
+      }),
+      (0, import_promises9.writeFile)(import_node_path12.default.join(targetDir, "package.json"), packageJsonSource(options.projectName), {
+        encoding: "utf8",
+        flag: force ? "w" : "wx"
+      }),
+      (0, import_promises9.writeFile)(import_node_path12.default.join(targetDir, ".gitignore"), "node_modules\n.artifacts\ntarget\n", {
+        encoding: "utf8",
+        flag: force ? "w" : "wx"
+      }),
+      (0, import_promises9.writeFile)(import_node_path12.default.join(targetDir, "README.md"), readmeSource(options.projectName), {
+        encoding: "utf8",
+        flag: force ? "w" : "wx"
+      })
     ]);
   }
   await (0, import_promises9.mkdir)(import_node_path12.default.join(targetDir, "contracts"), { recursive: true });
@@ -2163,13 +2193,20 @@ async function createZkProject(options) {
     force,
     errorOnExist: !force
   });
-  await (0, import_promises9.cp)(import_node_path12.default.join(scaffoldRoot(), "zk-verifier"), import_node_path12.default.join(targetDir, "contracts", "verifier"), {
-    recursive: true,
-    force,
-    errorOnExist: !force
-  });
+  await (0, import_promises9.cp)(
+    import_node_path12.default.join(scaffoldRoot(), "zk-verifier"),
+    import_node_path12.default.join(targetDir, "contracts", "verifier"),
+    {
+      recursive: true,
+      force,
+      errorOnExist: !force
+    }
+  );
   if (projectFiles) {
-    await writeArtifacts(createInitialArtifacts(options.projectName, { networks: ["testnet"] }), targetDir);
+    await writeArtifacts(
+      createInitialArtifacts(options.projectName, { networks: ["testnet"] }),
+      targetDir
+    );
   }
   return { targetDir };
 }
@@ -2211,23 +2248,28 @@ export default defineConfig({
 `;
 }
 function packageJsonSource2(projectName) {
-  return `${JSON.stringify({
-    name: projectName,
-    version: "0.1.0",
-    private: true,
-    type: "module",
-    scripts: {
-      build: "caatinga build app",
-      deploy: "caatinga deploy app --network testnet --source ${CAATINGA_SOURCE:-alice}",
-      doctor: "caatinga doctor --network testnet",
-      "read:hello": "caatinga read app.hello --network testnet --source ${CAATINGA_SOURCE:-alice}",
-      "read:version": "caatinga read app.version --network testnet --source ${CAATINGA_SOURCE:-alice}"
+  return `${JSON.stringify(
+    {
+      name: projectName,
+      version: "0.1.0",
+      private: true,
+      type: "module",
+      scripts: {
+        build: "caatinga build app",
+        deploy: "caatinga deploy app --network testnet --source ${CAATINGA_SOURCE:-alice}",
+        doctor: "caatinga doctor --network testnet",
+        test: "cargo test --manifest-path contracts/app/Cargo.toml",
+        "read:hello": "caatinga read app.hello --network testnet --source ${CAATINGA_SOURCE:-alice}",
+        "read:version": "caatinga read app.version --network testnet --source ${CAATINGA_SOURCE:-alice}"
+      },
+      devDependencies: {
+        "@caatinga/cli": `^${CAATINGA_CORE_VERSION}`,
+        "@caatinga/core": `^${CAATINGA_CORE_VERSION}`
+      }
     },
-    devDependencies: {
-      "@caatinga/cli": `^${CAATINGA_CORE_VERSION}`,
-      "@caatinga/core": `^${CAATINGA_CORE_VERSION}`
-    }
-  }, null, 2)}
+    null,
+    2
+  )}
 `;
 }
 function readmeSource2(projectName) {
@@ -2239,6 +2281,7 @@ Minimal Caatinga project with a Soroban contract stub (no frontend template).
 
 \`\`\`bash
 npm install
+npm test
 npx caatinga doctor
 npx caatinga build app
 npx caatinga deploy app --network testnet --source <identity>
@@ -2246,6 +2289,16 @@ npx caatinga read app.version --network testnet
 npx caatinga read app.hello --network testnet
 \`\`\`
 
+## Tests
+
+Run the Rust contract tests from the project root:
+
+\`\`\`bash
+npm test
+# or directly:
+cargo test --manifest-path contracts/app/Cargo.toml
+\`\`\`
+
 ## Contract
 
 - \`hello()\` \u2014 read-only; returns Soroban Symbol \`hello\`
@@ -2263,18 +2316,37 @@ async function createMinimalProject(options) {
   const force = options.force ?? false;
   await (0, import_promises10.mkdir)(targetDir, { recursive: true });
   await Promise.all([
-    (0, import_promises10.writeFile)(import_node_path13.default.join(targetDir, "caatinga.config.ts"), configSource2(options.projectName), { encoding: "utf8", flag: force ? "w" : "wx" }),
-    (0, import_promises10.writeFile)(import_node_path13.default.join(targetDir, "package.json"), packageJsonSource2(options.projectName), { encoding: "utf8", flag: force ? "w" : "wx" }),
-    (0, import_promises10.writeFile)(import_node_path13.default.join(targetDir, ".gitignore"), "node_modules\n.artifacts\ntarget\n", { encoding: "utf8", flag: force ? "w" : "wx" }),
-    (0, import_promises10.writeFile)(import_node_path13.default.join(targetDir, "README.md"), readmeSource2(options.projectName), { encoding: "utf8", flag: force ? "w" : "wx" })
+    (0, import_promises10.writeFile)(import_node_path13.default.join(targetDir, "caatinga.config.ts"), configSource2(options.projectName), {
+      encoding: "utf8",
+      flag: force ? "w" : "wx"
+    }),
+    (0, import_promises10.writeFile)(import_node_path13.default.join(targetDir, "package.json"), packageJsonSource2(options.projectName), {
+      encoding: "utf8",
+      flag: force ? "w" : "wx"
+    }),
+    (0, import_promises10.writeFile)(import_node_path13.default.join(targetDir, ".gitignore"), "node_modules\n.artifacts\ntarget\n", {
+      encoding: "utf8",
+      flag: force ? "w" : "wx"
+    }),
+    (0, import_promises10.writeFile)(import_node_path13.default.join(targetDir, "README.md"), readmeSource2(options.projectName), {
+      encoding: "utf8",
+      flag: force ? "w" : "wx"
+    })
   ]);
   await (0, import_promises10.mkdir)(import_node_path13.default.join(targetDir, "contracts"), { recursive: true });
-  await (0, import_promises10.cp)(import_node_path13.default.join(scaffoldRoot2(), "soroban-contract-stub"), import_node_path13.default.join(targetDir, "contracts", "app"), {
-    recursive: true,
-    force,
-    errorOnExist: !force
-  });
-  await writeArtifacts(createInitialArtifacts(options.projectName, { networks: ["testnet"] }), targetDir);
+  await (0, import_promises10.cp)(
+    import_node_path13.default.join(scaffoldRoot2(), "soroban-contract-stub"),
+    import_node_path13.default.join(targetDir, "contracts", "app"),
+    {
+      recursive: true,
+      force,
+      errorOnExist: !force
+    }
+  );
+  await writeArtifacts(
+    createInitialArtifacts(options.projectName, { networks: ["testnet"] }),
+    targetDir
+  );
   return { targetDir };
 }
 

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { C as CaatingaArtifacts, c as ContractArtifact, d as CaatingaErrorCodeValue, a as CaatingaError } from './artifact.schema-CGCFfl0g.cjs';
-export { e as CaatingaArtifactsSchema, b as CaatingaErrorCode, f as formatCaatingaError, t as toCaatingaError } from './artifact.schema-CGCFfl0g.cjs';
+import { C as CaatingaArtifacts, c as ContractArtifact, d as CaatingaErrorCodeValue, a as CaatingaError } from './artifact.schema-D4r8dyYK.cjs';
+export { e as CaatingaArtifactsSchema, b as CaatingaErrorCode, f as formatCaatingaError, t as toCaatingaError } from './artifact.schema-D4r8dyYK.cjs';
 import { z } from 'zod';
 
 declare const CAATINGA_CORE_VERSION: string;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { C as CaatingaArtifacts, c as ContractArtifact, d as CaatingaErrorCodeValue, a as CaatingaError } from './artifact.schema-CGCFfl0g.js';
-export { e as CaatingaArtifactsSchema, b as CaatingaErrorCode, f as formatCaatingaError, t as toCaatingaError } from './artifact.schema-CGCFfl0g.js';
+import { C as CaatingaArtifacts, c as ContractArtifact, d as CaatingaErrorCodeValue, a as CaatingaError } from './artifact.schema-D4r8dyYK.js';
+export { e as CaatingaArtifactsSchema, b as CaatingaErrorCode, f as formatCaatingaError, t as toCaatingaError } from './artifact.schema-D4r8dyYK.js';
 import { z } from 'zod';
 
 declare const CAATINGA_CORE_VERSION: string;

package/dist/index.js

@@ -121,9 +121,7 @@ function formatCause(cause) {
 
 // src/version.ts
 import { createRequire } from "module";
-var require2 = createRequire(
-  typeof __filename === "string" ? __filename : import.meta.url
-);
+var require2 = createRequire(typeof __filename === "string" ? __filename : import.meta.url);
 var CAATINGA_CORE_VERSION = require2("../package.json").version;
 
 // src/config/config.schema.ts
@@ -770,12 +768,7 @@ function matchesWellKnownNetwork(name, config) {
   return known.rpcUrl === config.rpcUrl && known.networkPassphrase === config.networkPassphrase;
 }
 function buildRpcNetworkArgs(config) {
-  return [
-    "--rpc-url",
-    config.rpcUrl,
-    "--network-passphrase",
-    config.networkPassphrase
-  ];
+  return ["--rpc-url", config.rpcUrl, "--network-passphrase", config.networkPassphrase];
 }
 function buildStellarNetworkArgsFromConfig(config) {
   for (const [name, known] of Object.entries(WELL_KNOWN_NETWORKS)) {
@@ -829,19 +822,23 @@ async function fetchCreateContractSalt(horizonUrl, transactionHash, fetchImpl =
 }
 async function resolveContractIdFromDeploySalt(options) {
   const saltHex = decimalSaltToHex(options.salt);
-  const result = await runCommand("stellar", [
-    "contract",
-    "id",
-    "wasm",
-    "--salt",
-    saltHex,
-    "--source-account",
-    options.source,
-    ...buildStellarNetworkArgsFromConfig(options.network)
-  ], {
-    cwd: options.cwd,
-    skipStellarVersionCheck: true
-  });
+  const result = await runCommand(
+    "stellar",
+    [
+      "contract",
+      "id",
+      "wasm",
+      "--salt",
+      saltHex,
+      "--source-account",
+      options.source,
+      ...buildStellarNetworkArgsFromConfig(options.network)
+    ],
+    {
+      cwd: options.cwd,
+      skipStellarVersionCheck: true
+    }
+  );
   return parseContractId(result.all || `${result.stdout}
 ${result.stderr}`);
 }
@@ -989,8 +986,12 @@ function buildAlternateWasmCandidates(configuredWasmPath, options) {
     addCandidate(path8.join(cargoTargetDir, LEGACY_RUST_WASM_TARGET, "release", fileName));
   }
   if (options?.sourcePath) {
-    addCandidate(path8.join(options.sourcePath, "target", CURRENT_RUST_WASM_TARGET, "release", fileName));
-    addCandidate(path8.join(options.sourcePath, "target", LEGACY_RUST_WASM_TARGET, "release", fileName));
+    addCandidate(
+      path8.join(options.sourcePath, "target", CURRENT_RUST_WASM_TARGET, "release", fileName)
+    );
+    addCandidate(
+      path8.join(options.sourcePath, "target", LEGACY_RUST_WASM_TARGET, "release", fileName)
+    );
   }
   return candidates;
 }
@@ -1405,17 +1406,21 @@ function toSkippedContract(name, contractId, network) {
 // src/contracts/verify-dependency-contract.ts
 async function verifyDependencyContract(options) {
   try {
-    await runCommand("stellar", [
-      "contract",
-      "info",
-      "interface",
-      "--contract-id",
-      options.contractId,
-      ...buildStellarNetworkArgs(options.network)
-    ], {
-      cwd: options.cwd,
-      failureCode: CaatingaErrorCode.DEPENDENCY_CONTRACT_NOT_FOUND
-    });
+    await runCommand(
+      "stellar",
+      [
+        "contract",
+        "info",
+        "interface",
+        "--contract-id",
+        options.contractId,
+        ...buildStellarNetworkArgs(options.network)
+      ],
+      {
+        cwd: options.cwd,
+        failureCode: CaatingaErrorCode.DEPENDENCY_CONTRACT_NOT_FOUND
+      }
+    );
   } catch (error) {
     if (error instanceof CaatingaError && error.code === CaatingaErrorCode.DEPENDENCY_CONTRACT_NOT_FOUND) {
       throw new CaatingaError(
@@ -1477,9 +1482,7 @@ async function deployContractGraph(options) {
       network: network.name
     });
     if (existing?.contractId && !options.force) {
-      skippedContracts.push(
-        toSkippedContract(contractName, existing.contractId, network.name)
-      );
+      skippedContracts.push(toSkippedContract(contractName, existing.contractId, network.name));
       continue;
     }
     const result = await deployContract({
@@ -1500,9 +1503,7 @@ async function deployContractGraph(options) {
       });
     }
     if (result.skipped) {
-      skippedContracts.push(
-        toSkippedContract(contractName, result.contractId, network.name)
-      );
+      skippedContracts.push(toSkippedContract(contractName, result.contractId, network.name));
     } else {
       deployedContracts.push({ name: contractName, contractId: result.contractId });
     }
@@ -1563,22 +1564,26 @@ async function generateBindings(options) {
   }
   const outputDir = path10.resolve(cwd, options.config.frontend.bindingsOutput, options.contractName);
   await mkdir2(outputDir, { recursive: true });
-  const result = await runCommand("npx", [
-    "--yes",
-    "@stellar/stellar-sdk",
-    "generate",
-    "--contract-id",
-    contractArtifact.contractId,
-    "--output-dir",
-    outputDir,
-    "--contract-name",
-    options.contractName,
-    "--overwrite",
-    ...buildGenerateNetworkArgs(network)
-  ], {
-    cwd,
-    failureCode: CaatingaErrorCode.BINDINGS_FAILED
-  });
+  const result = await runCommand(
+    "npx",
+    [
+      "--yes",
+      "@stellar/stellar-sdk",
+      "generate",
+      "--contract-id",
+      contractArtifact.contractId,
+      "--output-dir",
+      outputDir,
+      "--contract-name",
+      options.contractName,
+      "--overwrite",
+      ...buildGenerateNetworkArgs(network)
+    ],
+    {
+      cwd,
+      failureCode: CaatingaErrorCode.BINDINGS_FAILED
+    }
+  );
   const legacyStubRemoved = await removeLegacyBindingStub(
     cwd,
     options.config.frontend.bindingsOutput,
@@ -1690,21 +1695,25 @@ async function invokeContract(options) {
   await checkBinary("stellar", "Install Stellar CLI before running caatinga invoke.");
   let result;
   try {
-    result = await runCommand("stellar", [
-      "contract",
-      "invoke",
-      "--id",
-      contractArtifact.contractId,
-      "--source-account",
-      source,
-      ...buildStellarNetworkArgs(network),
-      "--",
-      target.method,
-      ...options.args ?? []
-    ], {
-      cwd,
-      failureCode: CaatingaErrorCode.INVOKE_FAILED
-    });
+    result = await runCommand(
+      "stellar",
+      [
+        "contract",
+        "invoke",
+        "--id",
+        contractArtifact.contractId,
+        "--source-account",
+        source,
+        ...buildStellarNetworkArgs(network),
+        "--",
+        target.method,
+        ...options.args ?? []
+      ],
+      {
+        cwd,
+        failureCode: CaatingaErrorCode.INVOKE_FAILED
+      }
+    );
   } catch (error) {
     if (error instanceof CaatingaError && error.code === CaatingaErrorCode.INVOKE_FAILED && isReadCallFailure(error)) {
       throw new CaatingaError(
@@ -1849,12 +1858,7 @@ function formatTemplateCompatibilityHint(issue) {
 }
 
 // src/templates/create-project-from-template.ts
-var TEMPLATE_COPY_EXCLUDED_DIRS = /* @__PURE__ */ new Set([
-  "target",
-  "test_snapshots",
-  "node_modules",
-  ".git"
-]);
+var TEMPLATE_COPY_EXCLUDED_DIRS = /* @__PURE__ */ new Set(["target", "test_snapshots", "node_modules", ".git"]);
 async function createProjectFromTemplate(options) {
   const targetDir = path11.resolve(options.targetDir);
   const templateDir = path11.resolve(options.templateDir);
@@ -1872,8 +1876,8 @@ async function createProjectFromTemplate(options) {
   await mkdir3(targetDir, { recursive: true });
   await cp(templateDir, targetDir, {
     recursive: true,
-    force: mergeIntoExisting,
-    errorOnExist: !mergeIntoExisting,
+    force: true,
+    errorOnExist: false,
     filter: (source) => shouldCopyTemplateEntry(templateDir, source, options.filter)
   });
   await replaceTemplateVariables(targetDir, options.projectName);
@@ -1888,7 +1892,10 @@ async function ensureArtifacts(targetDir, projectName) {
     await writeArtifacts({ ...artifacts, project: projectName }, targetDir);
   } catch (error) {
     if (error instanceof CaatingaError && error.code === CaatingaErrorCode.ARTIFACT_NOT_FOUND) {
-      await writeArtifacts(createInitialArtifacts(projectName, { networks: ["testnet"] }), targetDir);
+      await writeArtifacts(
+        createInitialArtifacts(projectName, { networks: ["testnet"] }),
+        targetDir
+      );
       return;
     }
     throw error;
@@ -1931,19 +1938,21 @@ async function readTemplateManifest(templateDir) {
 }
 async function replaceTemplateVariables(dir, projectName) {
   const entries = await readdir3(dir);
-  await Promise.all(entries.map(async (entry) => {
-    const entryPath = path11.join(dir, entry);
-    const entryStat = await stat2(entryPath);
-    if (entryStat.isDirectory()) {
-      await replaceTemplateVariables(entryPath, projectName);
-      return;
-    }
-    if (!isTextTemplateFile(entryPath)) {
-      return;
-    }
-    const content = await readFile4(entryPath, "utf8");
-    await writeFile3(entryPath, content.replaceAll("__PROJECT_NAME__", projectName), "utf8");
-  }));
+  await Promise.all(
+    entries.map(async (entry) => {
+      const entryPath = path11.join(dir, entry);
+      const entryStat = await stat2(entryPath);
+      if (entryStat.isDirectory()) {
+        await replaceTemplateVariables(entryPath, projectName);
+        return;
+      }
+      if (!isTextTemplateFile(entryPath)) {
+        return;
+      }
+      const content = await readFile4(entryPath, "utf8");
+      await writeFile3(entryPath, content.replaceAll("__PROJECT_NAME__", projectName), "utf8");
+    })
+  );
 }
 function shouldCopyTemplateEntry(templateDir, source, userFilter) {
   const relativePath = path11.relative(templateDir, source);
@@ -1957,16 +1966,9 @@ function shouldCopyTemplateEntry(templateDir, source, userFilter) {
   return !relativePath.split(path11.sep).some((segment) => TEMPLATE_COPY_EXCLUDED_DIRS.has(segment));
 }
 function isTextTemplateFile(filePath) {
-  return [
-    ".json",
-    ".md",
-    ".rs",
-    ".toml",
-    ".ts",
-    ".tsx",
-    ".css",
-    ".html"
-  ].includes(path11.extname(filePath));
+  return [".json", ".md", ".rs", ".toml", ".ts", ".tsx", ".css", ".html"].includes(
+    path11.extname(filePath)
+  );
 }
 
 // src/scaffold/create-zk-project.ts
@@ -2015,23 +2017,28 @@ export default defineConfig({
 `;
 }
 function packageJsonSource(projectName) {
-  return `${JSON.stringify({
-    name: projectName,
-    version: "0.1.0",
-    private: true,
-    type: "module",
-    scripts: {
-      "zk:build": "caatinga zk build main",
-      "zk:prove": "caatinga zk prove main",
-      build: "caatinga build verifier",
-      deploy: "caatinga deploy verifier --network testnet --source ${CAATINGA_SOURCE:-alice}",
-      doctor: "caatinga doctor --network testnet"
+  return `${JSON.stringify(
+    {
+      name: projectName,
+      version: "0.1.0",
+      private: true,
+      type: "module",
+      scripts: {
+        "zk:build": "caatinga zk build main",
+        "zk:prove": "caatinga zk prove main",
+        build: "caatinga build verifier",
+        deploy: "caatinga deploy verifier --network testnet --source ${CAATINGA_SOURCE:-alice}",
+        doctor: "caatinga doctor --network testnet",
+        test: "cargo test --manifest-path contracts/verifier/Cargo.toml"
+      },
+      devDependencies: {
+        "@caatinga/cli": `^${CAATINGA_CORE_VERSION}`,
+        "@caatinga/core": `^${CAATINGA_CORE_VERSION}`
+      }
     },
-    devDependencies: {
-      "@caatinga/cli": `^${CAATINGA_CORE_VERSION}`,
-      "@caatinga/core": `^${CAATINGA_CORE_VERSION}`
-    }
-  }, null, 2)}
+    null,
+    2
+  )}
 `;
 }
 function readmeSource(projectName) {
@@ -2043,12 +2050,23 @@ Minimal Caatinga ZK project.
 
 \`\`\`bash
 npm install
+npm test
 npx caatinga zk build main
 npx caatinga build verifier
 npx caatinga deploy verifier --network testnet --source <identity>
 npx caatinga zk prove main
 \`\`\`
 
+## Tests
+
+Run the Rust verifier contract tests from the project root:
+
+\`\`\`bash
+npm test
+# or directly:
+cargo test --manifest-path contracts/verifier/Cargo.toml
+\`\`\`
+
 Replace \`circuits/main.circom\` with your circuit. Keep the entry point named \`main\`.
 `;
 }
@@ -2059,10 +2077,22 @@ async function createZkProject(options) {
   await mkdir4(targetDir, { recursive: true });
   if (projectFiles) {
     await Promise.all([
-      writeFile4(path12.join(targetDir, "caatinga.config.ts"), configSource(options.projectName), { encoding: "utf8", flag: force ? "w" : "wx" }),
-      writeFile4(path12.join(targetDir, "package.json"), packageJsonSource(options.projectName), { encoding: "utf8", flag: force ? "w" : "wx" }),
-      writeFile4(path12.join(targetDir, ".gitignore"), "node_modules\n.artifacts\ntarget\n", { encoding: "utf8", flag: force ? "w" : "wx" }),
-      writeFile4(path12.join(targetDir, "README.md"), readmeSource(options.projectName), { encoding: "utf8", flag: force ? "w" : "wx" })
+      writeFile4(path12.join(targetDir, "caatinga.config.ts"), configSource(options.projectName), {
+        encoding: "utf8",
+        flag: force ? "w" : "wx"
+      }),
+      writeFile4(path12.join(targetDir, "package.json"), packageJsonSource(options.projectName), {
+        encoding: "utf8",
+        flag: force ? "w" : "wx"
+      }),
+      writeFile4(path12.join(targetDir, ".gitignore"), "node_modules\n.artifacts\ntarget\n", {
+        encoding: "utf8",
+        flag: force ? "w" : "wx"
+      }),
+      writeFile4(path12.join(targetDir, "README.md"), readmeSource(options.projectName), {
+        encoding: "utf8",
+        flag: force ? "w" : "wx"
+      })
     ]);
   }
   await mkdir4(path12.join(targetDir, "contracts"), { recursive: true });
@@ -2071,13 +2101,20 @@ async function createZkProject(options) {
     force,
     errorOnExist: !force
   });
-  await cp2(path12.join(scaffoldRoot(), "zk-verifier"), path12.join(targetDir, "contracts", "verifier"), {
-    recursive: true,
-    force,
-    errorOnExist: !force
-  });
+  await cp2(
+    path12.join(scaffoldRoot(), "zk-verifier"),
+    path12.join(targetDir, "contracts", "verifier"),
+    {
+      recursive: true,
+      force,
+      errorOnExist: !force
+    }
+  );
   if (projectFiles) {
-    await writeArtifacts(createInitialArtifacts(options.projectName, { networks: ["testnet"] }), targetDir);
+    await writeArtifacts(
+      createInitialArtifacts(options.projectName, { networks: ["testnet"] }),
+      targetDir
+    );
   }
   return { targetDir };
 }
@@ -2118,23 +2155,28 @@ export default defineConfig({
 `;
 }
 function packageJsonSource2(projectName) {
-  return `${JSON.stringify({
-    name: projectName,
-    version: "0.1.0",
-    private: true,
-    type: "module",
-    scripts: {
-      build: "caatinga build app",
-      deploy: "caatinga deploy app --network testnet --source ${CAATINGA_SOURCE:-alice}",
-      doctor: "caatinga doctor --network testnet",
-      "read:hello": "caatinga read app.hello --network testnet --source ${CAATINGA_SOURCE:-alice}",
-      "read:version": "caatinga read app.version --network testnet --source ${CAATINGA_SOURCE:-alice}"
+  return `${JSON.stringify(
+    {
+      name: projectName,
+      version: "0.1.0",
+      private: true,
+      type: "module",
+      scripts: {
+        build: "caatinga build app",
+        deploy: "caatinga deploy app --network testnet --source ${CAATINGA_SOURCE:-alice}",
+        doctor: "caatinga doctor --network testnet",
+        test: "cargo test --manifest-path contracts/app/Cargo.toml",
+        "read:hello": "caatinga read app.hello --network testnet --source ${CAATINGA_SOURCE:-alice}",
+        "read:version": "caatinga read app.version --network testnet --source ${CAATINGA_SOURCE:-alice}"
+      },
+      devDependencies: {
+        "@caatinga/cli": `^${CAATINGA_CORE_VERSION}`,
+        "@caatinga/core": `^${CAATINGA_CORE_VERSION}`
+      }
     },
-    devDependencies: {
-      "@caatinga/cli": `^${CAATINGA_CORE_VERSION}`,
-      "@caatinga/core": `^${CAATINGA_CORE_VERSION}`
-    }
-  }, null, 2)}
+    null,
+    2
+  )}
 `;
 }
 function readmeSource2(projectName) {
@@ -2146,6 +2188,7 @@ Minimal Caatinga project with a Soroban contract stub (no frontend template).
 
 \`\`\`bash
 npm install
+npm test
 npx caatinga doctor
 npx caatinga build app
 npx caatinga deploy app --network testnet --source <identity>
@@ -2153,6 +2196,16 @@ npx caatinga read app.version --network testnet
 npx caatinga read app.hello --network testnet
 \`\`\`
 
+## Tests
+
+Run the Rust contract tests from the project root:
+
+\`\`\`bash
+npm test
+# or directly:
+cargo test --manifest-path contracts/app/Cargo.toml
+\`\`\`
+
 ## Contract
 
 - \`hello()\` \u2014 read-only; returns Soroban Symbol \`hello\`
@@ -2170,18 +2223,37 @@ async function createMinimalProject(options) {
   const force = options.force ?? false;
   await mkdir5(targetDir, { recursive: true });
   await Promise.all([
-    writeFile5(path13.join(targetDir, "caatinga.config.ts"), configSource2(options.projectName), { encoding: "utf8", flag: force ? "w" : "wx" }),
-    writeFile5(path13.join(targetDir, "package.json"), packageJsonSource2(options.projectName), { encoding: "utf8", flag: force ? "w" : "wx" }),
-    writeFile5(path13.join(targetDir, ".gitignore"), "node_modules\n.artifacts\ntarget\n", { encoding: "utf8", flag: force ? "w" : "wx" }),
-    writeFile5(path13.join(targetDir, "README.md"), readmeSource2(options.projectName), { encoding: "utf8", flag: force ? "w" : "wx" })
+    writeFile5(path13.join(targetDir, "caatinga.config.ts"), configSource2(options.projectName), {
+      encoding: "utf8",
+      flag: force ? "w" : "wx"
+    }),
+    writeFile5(path13.join(targetDir, "package.json"), packageJsonSource2(options.projectName), {
+      encoding: "utf8",
+      flag: force ? "w" : "wx"
+    }),
+    writeFile5(path13.join(targetDir, ".gitignore"), "node_modules\n.artifacts\ntarget\n", {
+      encoding: "utf8",
+      flag: force ? "w" : "wx"
+    }),
+    writeFile5(path13.join(targetDir, "README.md"), readmeSource2(options.projectName), {
+      encoding: "utf8",
+      flag: force ? "w" : "wx"
+    })
   ]);
   await mkdir5(path13.join(targetDir, "contracts"), { recursive: true });
-  await cp3(path13.join(scaffoldRoot2(), "soroban-contract-stub"), path13.join(targetDir, "contracts", "app"), {
-    recursive: true,
-    force,
-    errorOnExist: !force
-  });
-  await writeArtifacts(createInitialArtifacts(options.projectName, { networks: ["testnet"] }), targetDir);
+  await cp3(
+    path13.join(scaffoldRoot2(), "soroban-contract-stub"),
+    path13.join(targetDir, "contracts", "app"),
+    {
+      recursive: true,
+      force,
+      errorOnExist: !force
+    }
+  );
+  await writeArtifacts(
+    createInitialArtifacts(options.projectName, { networks: ["testnet"] }),
+    targetDir
+  );
   return { targetDir };
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@caatinga/core",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "description": "Core config, artifacts, command orchestration, and error primitives for Caatinga/Soroban toolkit",
   "keywords": [
     "stellar",