@caatinga/core 3.0.1 → 3.1.1

package/dist/index.cjs

@@ -1608,8 +1608,101 @@ async function deployContractGraph(options) {
 }
 
 // src/contracts/generate-bindings.ts
+var import_promises8 = require("fs/promises");
+var import_node_path11 = __toESM(require("path"), 1);
+
+// src/bindings/patch-generated-binding-package.ts
 var import_promises7 = require("fs/promises");
 var import_node_path10 = __toESM(require("path"), 1);
+var BUNDLER_ENTRY = "./src/index.ts";
+var ROOT_BINDING_INDEX_CONTENT = 'export * from "./src/index.js";\n';
+function resolveExportEntry(exportsField) {
+  if (!exportsField) {
+    return void 0;
+  }
+  const rootExport = exportsField["."];
+  if (typeof rootExport === "string") {
+    return rootExport;
+  }
+  if (rootExport && typeof rootExport === "object" && !Array.isArray(rootExport)) {
+    const conditions = rootExport;
+    for (const key of ["import", "default", "types"]) {
+      const value = conditions[key];
+      if (typeof value === "string") {
+        return value;
+      }
+    }
+  }
+  return void 0;
+}
+function pointsToDist(main) {
+  return typeof main === "string" && main.replace(/^\.\//, "").startsWith("dist/");
+}
+function pointsToBundlerSource(entry) {
+  return entry === BUNDLER_ENTRY || entry === "./src/index.js";
+}
+function shouldPatchPackageJson(packageJson) {
+  const exportEntry = resolveExportEntry(
+    typeof packageJson.exports === "object" && packageJson.exports !== null && !Array.isArray(packageJson.exports) ? packageJson.exports : void 0
+  );
+  return pointsToDist(packageJson.main) || pointsToDist(packageJson.types) || !pointsToBundlerSource(exportEntry);
+}
+async function ensureRootBindingIndex(outputDir) {
+  const rootIndexPath = import_node_path10.default.join(outputDir, "index.ts");
+  try {
+    const existing = await (0, import_promises7.readFile)(rootIndexPath, "utf8");
+    if (existing === ROOT_BINDING_INDEX_CONTENT) {
+      return;
+    }
+    return;
+  } catch {
+    await (0, import_promises7.writeFile)(rootIndexPath, ROOT_BINDING_INDEX_CONTENT, "utf8");
+  }
+}
+async function patchGeneratedBindingPackage(outputDir) {
+  const packageJsonPath = import_node_path10.default.join(outputDir, "package.json");
+  const entryPath = import_node_path10.default.join(outputDir, "src", "index.ts");
+  try {
+    await (0, import_promises7.access)(entryPath);
+  } catch {
+    throw new CaatingaError(
+      "Generated binding package is missing src/index.ts.",
+      CaatingaErrorCode.BINDINGS_FAILED,
+      "Re-run caatinga generate or check @stellar/stellar-sdk generate output."
+    );
+  }
+  let raw;
+  try {
+    raw = await (0, import_promises7.readFile)(packageJsonPath, "utf8");
+  } catch {
+    throw new CaatingaError(
+      "Generated binding package is missing package.json.",
+      CaatingaErrorCode.BINDINGS_FAILED,
+      "Re-run caatinga generate or check @stellar/stellar-sdk generate output."
+    );
+  }
+  let packageJson;
+  try {
+    packageJson = JSON.parse(raw);
+  } catch {
+    throw new CaatingaError(
+      "Generated binding package.json is not valid JSON.",
+      CaatingaErrorCode.BINDINGS_FAILED,
+      "Re-run caatinga generate or check @stellar/stellar-sdk generate output."
+    );
+  }
+  if (shouldPatchPackageJson(packageJson)) {
+    packageJson.main = BUNDLER_ENTRY;
+    packageJson.types = BUNDLER_ENTRY;
+    packageJson.exports = {
+      ...typeof packageJson.exports === "object" && packageJson.exports !== null && !Array.isArray(packageJson.exports) ? packageJson.exports : {},
+      ".": BUNDLER_ENTRY
+    };
+    await (0, import_promises7.writeFile)(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}
+`, "utf8");
+  }
+  await ensureRootBindingIndex(outputDir);
+}
 
 // src/contracts/build-generate-network-args.ts
 function buildGenerateNetworkArgs(network) {
@@ -1621,14 +1714,14 @@ function buildGenerateNetworkArgs(network) {
 
 // src/contracts/generate-bindings.ts
 function toBindingImportPath(bindingsOutput, contractName) {
-  const normalized = bindingsOutput.replace(/^\.\//, "").split(import_node_path10.default.sep).join("/");
-  return `./${import_node_path10.default.posix.join(normalized, contractName)}`;
+  const normalized = bindingsOutput.replace(/^\.\//, "").split(import_node_path11.default.sep).join("/");
+  return `./${import_node_path11.default.posix.join(normalized, contractName)}`;
 }
 async function removeLegacyBindingStub(cwd, bindingsOutput, contractName) {
-  const legacyPath = import_node_path10.default.resolve(cwd, bindingsOutput, `${contractName}.ts`);
+  const legacyPath = import_node_path11.default.resolve(cwd, bindingsOutput, `${contractName}.ts`);
   try {
-    await (0, import_promises7.access)(legacyPath);
-    await (0, import_promises7.unlink)(legacyPath);
+    await (0, import_promises8.access)(legacyPath);
+    await (0, import_promises8.unlink)(legacyPath);
     return true;
   } catch {
     return false;
@@ -1653,8 +1746,8 @@ async function generateBindings(options) {
       "Run caatinga deploy for this contract and network before generating bindings."
     );
   }
-  const outputDir = import_node_path10.default.resolve(cwd, options.config.frontend.bindingsOutput, options.contractName);
-  await (0, import_promises7.mkdir)(outputDir, { recursive: true });
+  const outputDir = import_node_path11.default.resolve(cwd, options.config.frontend.bindingsOutput, options.contractName);
+  await (0, import_promises8.mkdir)(outputDir, { recursive: true });
   const result = await runCommand(
     "npx",
     [
@@ -1680,6 +1773,7 @@ async function generateBindings(options) {
     options.config.frontend.bindingsOutput,
     options.contractName
   );
+  await patchGeneratedBindingPackage(outputDir);
   const marker = {
     version: 1,
     contractId: contractArtifact.contractId,
@@ -1879,8 +1973,8 @@ async function readContract(options) {
 }
 
 // src/templates/create-project-from-template.ts
-var import_promises8 = require("fs/promises");
-var import_node_path11 = __toESM(require("path"), 1);
+var import_promises9 = require("fs/promises");
+var import_node_path12 = __toESM(require("path"), 1);
 var import_zod7 = require("zod");
 
 // src/templates/template-manifest.schema.ts
@@ -1951,10 +2045,10 @@ function formatTemplateCompatibilityHint(issue) {
 // src/templates/create-project-from-template.ts
 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);
+  const targetDir = import_node_path12.default.resolve(options.targetDir);
+  const templateDir = import_node_path12.default.resolve(options.templateDir);
   try {
-    await (0, import_promises8.stat)(templateDir);
+    await (0, import_promises9.stat)(templateDir);
   } catch {
     throw new CaatingaError(
       `Template directory was not found: ${templateDir}`,
@@ -1964,11 +2058,11 @@ async function createProjectFromTemplate(options) {
   }
   const manifest = await readTemplateManifest(templateDir);
   const mergeIntoExisting = Boolean(options.filter);
-  await (0, import_promises8.mkdir)(targetDir, { recursive: true });
-  await (0, import_promises8.cp)(templateDir, targetDir, {
+  await (0, import_promises9.mkdir)(targetDir, { recursive: true });
+  await (0, import_promises9.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);
@@ -1993,9 +2087,9 @@ async function ensureArtifacts(targetDir, projectName) {
   }
 }
 async function readTemplateManifest(templateDir) {
-  const manifestPath = import_node_path11.default.join(templateDir, "caatinga.template.json");
+  const manifestPath = import_node_path12.default.join(templateDir, "caatinga.template.json");
   try {
-    const rawManifest = await (0, import_promises8.readFile)(manifestPath, "utf8");
+    const rawManifest = await (0, import_promises9.readFile)(manifestPath, "utf8");
     const manifest = TemplateManifestSchema.parse(JSON.parse(rawManifest));
     const compatibilityIssue = getTemplateCompatibilityIssue(manifest);
     if (compatibilityIssue) {
@@ -2028,11 +2122,11 @@ async function readTemplateManifest(templateDir) {
   }
 }
 async function replaceTemplateVariables(dir, projectName) {
-  const entries = await (0, import_promises8.readdir)(dir);
+  const entries = await (0, import_promises9.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);
+      const entryPath = import_node_path12.default.join(dir, entry);
+      const entryStat = await (0, import_promises9.stat)(entryPath);
       if (entryStat.isDirectory()) {
         await replaceTemplateVariables(entryPath, projectName);
         return;
@@ -2040,39 +2134,39 @@ async function replaceTemplateVariables(dir, projectName) {
       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");
+      const content = await (0, import_promises9.readFile)(entryPath, "utf8");
+      await (0, import_promises9.writeFile)(entryPath, content.replaceAll("__PROJECT_NAME__", projectName), "utf8");
     })
   );
 }
 function shouldCopyTemplateEntry(templateDir, source, userFilter) {
-  const relativePath = import_node_path11.default.relative(templateDir, source);
+  const relativePath = import_node_path12.default.relative(templateDir, source);
   if (!relativePath || relativePath === ".") {
     return true;
   }
-  const normalizedPath = relativePath.split(import_node_path11.default.sep).join("/");
+  const normalizedPath = relativePath.split(import_node_path12.default.sep).join("/");
   if (userFilter && !userFilter(normalizedPath)) {
     return false;
   }
-  return !relativePath.split(import_node_path11.default.sep).some((segment) => TEMPLATE_COPY_EXCLUDED_DIRS.has(segment));
+  return !relativePath.split(import_node_path12.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)
+    import_node_path12.default.extname(filePath)
   );
 }
 
 // src/scaffold/create-zk-project.ts
-var import_promises9 = require("fs/promises");
+var import_promises10 = require("fs/promises");
 var import_node_fs2 = require("fs");
-var import_node_path12 = __toESM(require("path"), 1);
+var import_node_path13 = __toESM(require("path"), 1);
 var import_node_url = require("url");
 var import_meta3 = {};
-var moduleDir = typeof __dirname === "string" ? __dirname : import_node_path12.default.dirname((0, import_node_url.fileURLToPath)(import_meta3.url));
+var moduleDir = typeof __dirname === "string" ? __dirname : import_node_path13.default.dirname((0, import_node_url.fileURLToPath)(import_meta3.url));
 function scaffoldRoot() {
   const candidates = [
-    import_node_path12.default.resolve(moduleDir, "../../scaffolds"),
-    import_node_path12.default.resolve(moduleDir, "../scaffolds")
+    import_node_path13.default.resolve(moduleDir, "../../scaffolds"),
+    import_node_path13.default.resolve(moduleDir, "../scaffolds")
   ];
   const found = candidates.find((candidate) => (0, import_node_fs2.existsSync)(candidate));
   return found ?? candidates[0];
@@ -2120,7 +2214,8 @@ function packageJsonSource(projectName) {
         "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"
+        doctor: "caatinga doctor --network testnet",
+        test: "cargo test --manifest-path contracts/verifier/Cargo.toml"
       },
       devDependencies: {
         "@caatinga/cli": `^${CAATINGA_CORE_VERSION}`,
@@ -2141,49 +2236,60 @@ 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\`.
 `;
 }
 async function createZkProject(options) {
-  const targetDir = import_node_path12.default.resolve(options.targetDir);
+  const targetDir = import_node_path13.default.resolve(options.targetDir);
   const force = options.force ?? false;
   const projectFiles = options.projectFiles ?? true;
-  await (0, import_promises9.mkdir)(targetDir, { recursive: true });
+  await (0, import_promises10.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), {
+      (0, import_promises10.writeFile)(import_node_path13.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), {
+      (0, import_promises10.writeFile)(import_node_path13.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", {
+      (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_promises9.writeFile)(import_node_path12.default.join(targetDir, "README.md"), readmeSource(options.projectName), {
+      (0, import_promises10.writeFile)(import_node_path13.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 });
-  await (0, import_promises9.cp)(import_node_path12.default.join(scaffoldRoot(), "zk-circuit-stub"), import_node_path12.default.join(targetDir, "circuits"), {
+  await (0, import_promises10.mkdir)(import_node_path13.default.join(targetDir, "contracts"), { recursive: true });
+  await (0, import_promises10.cp)(import_node_path13.default.join(scaffoldRoot(), "zk-circuit-stub"), import_node_path13.default.join(targetDir, "circuits"), {
     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"),
+  await (0, import_promises10.cp)(
+    import_node_path13.default.join(scaffoldRoot(), "zk-verifier"),
+    import_node_path13.default.join(targetDir, "contracts", "verifier"),
     {
       recursive: true,
       force,
@@ -2200,16 +2306,16 @@ async function createZkProject(options) {
 }
 
 // src/scaffold/create-minimal-project.ts
-var import_promises10 = require("fs/promises");
+var import_promises11 = require("fs/promises");
 var import_node_fs3 = require("fs");
-var import_node_path13 = __toESM(require("path"), 1);
+var import_node_path14 = __toESM(require("path"), 1);
 var import_node_url2 = require("url");
 var import_meta4 = {};
-var moduleDir2 = typeof __dirname === "string" ? __dirname : import_node_path13.default.dirname((0, import_node_url2.fileURLToPath)(import_meta4.url));
+var moduleDir2 = typeof __dirname === "string" ? __dirname : import_node_path14.default.dirname((0, import_node_url2.fileURLToPath)(import_meta4.url));
 function scaffoldRoot2() {
   const candidates = [
-    import_node_path13.default.resolve(moduleDir2, "../../scaffolds"),
-    import_node_path13.default.resolve(moduleDir2, "../scaffolds")
+    import_node_path14.default.resolve(moduleDir2, "../../scaffolds"),
+    import_node_path14.default.resolve(moduleDir2, "../scaffolds")
   ];
   const found = candidates.find((candidate) => (0, import_node_fs3.existsSync)(candidate));
   return found ?? candidates[0];
@@ -2246,6 +2352,7 @@ function packageJsonSource2(projectName) {
         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}"
       },
@@ -2268,6 +2375,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>
@@ -2275,6 +2383,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\`
@@ -2288,31 +2406,31 @@ Edit \`contracts/app/src/lib.rs\` to customize the contract. Add a frontend late
 `;
 }
 async function createMinimalProject(options) {
-  const targetDir = import_node_path13.default.resolve(options.targetDir);
+  const targetDir = import_node_path14.default.resolve(options.targetDir);
   const force = options.force ?? false;
-  await (0, import_promises10.mkdir)(targetDir, { recursive: true });
+  await (0, import_promises11.mkdir)(targetDir, { recursive: true });
   await Promise.all([
-    (0, import_promises10.writeFile)(import_node_path13.default.join(targetDir, "caatinga.config.ts"), configSource2(options.projectName), {
+    (0, import_promises11.writeFile)(import_node_path14.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), {
+    (0, import_promises11.writeFile)(import_node_path14.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", {
+    (0, import_promises11.writeFile)(import_node_path14.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), {
+    (0, import_promises11.writeFile)(import_node_path14.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"),
+  await (0, import_promises11.mkdir)(import_node_path14.default.join(targetDir, "contracts"), { recursive: true });
+  await (0, import_promises11.cp)(
+    import_node_path14.default.join(scaffoldRoot2(), "soroban-contract-stub"),
+    import_node_path14.default.join(targetDir, "contracts", "app"),
     {
       recursive: true,
       force,

package/dist/index.js

@@ -1517,8 +1517,101 @@ async function deployContractGraph(options) {
 }
 
 // src/contracts/generate-bindings.ts
-import { access as access3, mkdir as mkdir2, unlink } from "fs/promises";
+import { access as access4, mkdir as mkdir2, unlink } from "fs/promises";
+import path11 from "path";
+
+// src/bindings/patch-generated-binding-package.ts
+import { access as access3, readFile as readFile4, writeFile as writeFile3 } from "fs/promises";
 import path10 from "path";
+var BUNDLER_ENTRY = "./src/index.ts";
+var ROOT_BINDING_INDEX_CONTENT = 'export * from "./src/index.js";\n';
+function resolveExportEntry(exportsField) {
+  if (!exportsField) {
+    return void 0;
+  }
+  const rootExport = exportsField["."];
+  if (typeof rootExport === "string") {
+    return rootExport;
+  }
+  if (rootExport && typeof rootExport === "object" && !Array.isArray(rootExport)) {
+    const conditions = rootExport;
+    for (const key of ["import", "default", "types"]) {
+      const value = conditions[key];
+      if (typeof value === "string") {
+        return value;
+      }
+    }
+  }
+  return void 0;
+}
+function pointsToDist(main) {
+  return typeof main === "string" && main.replace(/^\.\//, "").startsWith("dist/");
+}
+function pointsToBundlerSource(entry) {
+  return entry === BUNDLER_ENTRY || entry === "./src/index.js";
+}
+function shouldPatchPackageJson(packageJson) {
+  const exportEntry = resolveExportEntry(
+    typeof packageJson.exports === "object" && packageJson.exports !== null && !Array.isArray(packageJson.exports) ? packageJson.exports : void 0
+  );
+  return pointsToDist(packageJson.main) || pointsToDist(packageJson.types) || !pointsToBundlerSource(exportEntry);
+}
+async function ensureRootBindingIndex(outputDir) {
+  const rootIndexPath = path10.join(outputDir, "index.ts");
+  try {
+    const existing = await readFile4(rootIndexPath, "utf8");
+    if (existing === ROOT_BINDING_INDEX_CONTENT) {
+      return;
+    }
+    return;
+  } catch {
+    await writeFile3(rootIndexPath, ROOT_BINDING_INDEX_CONTENT, "utf8");
+  }
+}
+async function patchGeneratedBindingPackage(outputDir) {
+  const packageJsonPath = path10.join(outputDir, "package.json");
+  const entryPath = path10.join(outputDir, "src", "index.ts");
+  try {
+    await access3(entryPath);
+  } catch {
+    throw new CaatingaError(
+      "Generated binding package is missing src/index.ts.",
+      CaatingaErrorCode.BINDINGS_FAILED,
+      "Re-run caatinga generate or check @stellar/stellar-sdk generate output."
+    );
+  }
+  let raw;
+  try {
+    raw = await readFile4(packageJsonPath, "utf8");
+  } catch {
+    throw new CaatingaError(
+      "Generated binding package is missing package.json.",
+      CaatingaErrorCode.BINDINGS_FAILED,
+      "Re-run caatinga generate or check @stellar/stellar-sdk generate output."
+    );
+  }
+  let packageJson;
+  try {
+    packageJson = JSON.parse(raw);
+  } catch {
+    throw new CaatingaError(
+      "Generated binding package.json is not valid JSON.",
+      CaatingaErrorCode.BINDINGS_FAILED,
+      "Re-run caatinga generate or check @stellar/stellar-sdk generate output."
+    );
+  }
+  if (shouldPatchPackageJson(packageJson)) {
+    packageJson.main = BUNDLER_ENTRY;
+    packageJson.types = BUNDLER_ENTRY;
+    packageJson.exports = {
+      ...typeof packageJson.exports === "object" && packageJson.exports !== null && !Array.isArray(packageJson.exports) ? packageJson.exports : {},
+      ".": BUNDLER_ENTRY
+    };
+    await writeFile3(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}
+`, "utf8");
+  }
+  await ensureRootBindingIndex(outputDir);
+}
 
 // src/contracts/build-generate-network-args.ts
 function buildGenerateNetworkArgs(network) {
@@ -1530,13 +1623,13 @@ function buildGenerateNetworkArgs(network) {
 
 // src/contracts/generate-bindings.ts
 function toBindingImportPath(bindingsOutput, contractName) {
-  const normalized = bindingsOutput.replace(/^\.\//, "").split(path10.sep).join("/");
-  return `./${path10.posix.join(normalized, contractName)}`;
+  const normalized = bindingsOutput.replace(/^\.\//, "").split(path11.sep).join("/");
+  return `./${path11.posix.join(normalized, contractName)}`;
 }
 async function removeLegacyBindingStub(cwd, bindingsOutput, contractName) {
-  const legacyPath = path10.resolve(cwd, bindingsOutput, `${contractName}.ts`);
+  const legacyPath = path11.resolve(cwd, bindingsOutput, `${contractName}.ts`);
   try {
-    await access3(legacyPath);
+    await access4(legacyPath);
     await unlink(legacyPath);
     return true;
   } catch {
@@ -1562,7 +1655,7 @@ async function generateBindings(options) {
       "Run caatinga deploy for this contract and network before generating bindings."
     );
   }
-  const outputDir = path10.resolve(cwd, options.config.frontend.bindingsOutput, options.contractName);
+  const outputDir = path11.resolve(cwd, options.config.frontend.bindingsOutput, options.contractName);
   await mkdir2(outputDir, { recursive: true });
   const result = await runCommand(
     "npx",
@@ -1589,6 +1682,7 @@ async function generateBindings(options) {
     options.config.frontend.bindingsOutput,
     options.contractName
   );
+  await patchGeneratedBindingPackage(outputDir);
   const marker = {
     version: 1,
     contractId: contractArtifact.contractId,
@@ -1788,8 +1882,8 @@ async function readContract(options) {
 }
 
 // src/templates/create-project-from-template.ts
-import { cp, mkdir as mkdir3, readFile as readFile4, readdir as readdir3, stat as stat2, writeFile as writeFile3 } from "fs/promises";
-import path11 from "path";
+import { cp, mkdir as mkdir3, readFile as readFile5, readdir as readdir3, stat as stat2, writeFile as writeFile4 } from "fs/promises";
+import path12 from "path";
 import { z as z7 } from "zod";
 
 // src/templates/template-manifest.schema.ts
@@ -1860,8 +1954,8 @@ function formatTemplateCompatibilityHint(issue) {
 // src/templates/create-project-from-template.ts
 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);
+  const targetDir = path12.resolve(options.targetDir);
+  const templateDir = path12.resolve(options.templateDir);
   try {
     await stat2(templateDir);
   } catch {
@@ -1876,8 +1970,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);
@@ -1902,9 +1996,9 @@ async function ensureArtifacts(targetDir, projectName) {
   }
 }
 async function readTemplateManifest(templateDir) {
-  const manifestPath = path11.join(templateDir, "caatinga.template.json");
+  const manifestPath = path12.join(templateDir, "caatinga.template.json");
   try {
-    const rawManifest = await readFile4(manifestPath, "utf8");
+    const rawManifest = await readFile5(manifestPath, "utf8");
     const manifest = TemplateManifestSchema.parse(JSON.parse(rawManifest));
     const compatibilityIssue = getTemplateCompatibilityIssue(manifest);
     if (compatibilityIssue) {
@@ -1940,7 +2034,7 @@ async function replaceTemplateVariables(dir, projectName) {
   const entries = await readdir3(dir);
   await Promise.all(
     entries.map(async (entry) => {
-      const entryPath = path11.join(dir, entry);
+      const entryPath = path12.join(dir, entry);
       const entryStat = await stat2(entryPath);
       if (entryStat.isDirectory()) {
         await replaceTemplateVariables(entryPath, projectName);
@@ -1949,38 +2043,38 @@ async function replaceTemplateVariables(dir, projectName) {
       if (!isTextTemplateFile(entryPath)) {
         return;
       }
-      const content = await readFile4(entryPath, "utf8");
-      await writeFile3(entryPath, content.replaceAll("__PROJECT_NAME__", projectName), "utf8");
+      const content = await readFile5(entryPath, "utf8");
+      await writeFile4(entryPath, content.replaceAll("__PROJECT_NAME__", projectName), "utf8");
     })
   );
 }
 function shouldCopyTemplateEntry(templateDir, source, userFilter) {
-  const relativePath = path11.relative(templateDir, source);
+  const relativePath = path12.relative(templateDir, source);
   if (!relativePath || relativePath === ".") {
     return true;
   }
-  const normalizedPath = relativePath.split(path11.sep).join("/");
+  const normalizedPath = relativePath.split(path12.sep).join("/");
   if (userFilter && !userFilter(normalizedPath)) {
     return false;
   }
-  return !relativePath.split(path11.sep).some((segment) => TEMPLATE_COPY_EXCLUDED_DIRS.has(segment));
+  return !relativePath.split(path12.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)
+    path12.extname(filePath)
   );
 }
 
 // src/scaffold/create-zk-project.ts
-import { cp as cp2, mkdir as mkdir4, writeFile as writeFile4 } from "fs/promises";
+import { cp as cp2, mkdir as mkdir4, writeFile as writeFile5 } from "fs/promises";
 import { existsSync as existsSync2 } from "fs";
-import path12 from "path";
+import path13 from "path";
 import { fileURLToPath } from "url";
-var moduleDir = typeof __dirname === "string" ? __dirname : path12.dirname(fileURLToPath(import.meta.url));
+var moduleDir = typeof __dirname === "string" ? __dirname : path13.dirname(fileURLToPath(import.meta.url));
 function scaffoldRoot() {
   const candidates = [
-    path12.resolve(moduleDir, "../../scaffolds"),
-    path12.resolve(moduleDir, "../scaffolds")
+    path13.resolve(moduleDir, "../../scaffolds"),
+    path13.resolve(moduleDir, "../scaffolds")
   ];
   const found = candidates.find((candidate) => existsSync2(candidate));
   return found ?? candidates[0];
@@ -2028,7 +2122,8 @@ function packageJsonSource(projectName) {
         "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"
+        doctor: "caatinga doctor --network testnet",
+        test: "cargo test --manifest-path contracts/verifier/Cargo.toml"
       },
       devDependencies: {
         "@caatinga/cli": `^${CAATINGA_CORE_VERSION}`,
@@ -2049,49 +2144,60 @@ 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\`.
 `;
 }
 async function createZkProject(options) {
-  const targetDir = path12.resolve(options.targetDir);
+  const targetDir = path13.resolve(options.targetDir);
   const force = options.force ?? false;
   const projectFiles = options.projectFiles ?? true;
   await mkdir4(targetDir, { recursive: true });
   if (projectFiles) {
     await Promise.all([
-      writeFile4(path12.join(targetDir, "caatinga.config.ts"), configSource(options.projectName), {
+      writeFile5(path13.join(targetDir, "caatinga.config.ts"), configSource(options.projectName), {
         encoding: "utf8",
         flag: force ? "w" : "wx"
       }),
-      writeFile4(path12.join(targetDir, "package.json"), packageJsonSource(options.projectName), {
+      writeFile5(path13.join(targetDir, "package.json"), packageJsonSource(options.projectName), {
         encoding: "utf8",
         flag: force ? "w" : "wx"
       }),
-      writeFile4(path12.join(targetDir, ".gitignore"), "node_modules\n.artifacts\ntarget\n", {
+      writeFile5(path13.join(targetDir, ".gitignore"), "node_modules\n.artifacts\ntarget\n", {
         encoding: "utf8",
         flag: force ? "w" : "wx"
       }),
-      writeFile4(path12.join(targetDir, "README.md"), readmeSource(options.projectName), {
+      writeFile5(path13.join(targetDir, "README.md"), readmeSource(options.projectName), {
         encoding: "utf8",
         flag: force ? "w" : "wx"
       })
     ]);
   }
-  await mkdir4(path12.join(targetDir, "contracts"), { recursive: true });
-  await cp2(path12.join(scaffoldRoot(), "zk-circuit-stub"), path12.join(targetDir, "circuits"), {
+  await mkdir4(path13.join(targetDir, "contracts"), { recursive: true });
+  await cp2(path13.join(scaffoldRoot(), "zk-circuit-stub"), path13.join(targetDir, "circuits"), {
     recursive: true,
     force,
     errorOnExist: !force
   });
   await cp2(
-    path12.join(scaffoldRoot(), "zk-verifier"),
-    path12.join(targetDir, "contracts", "verifier"),
+    path13.join(scaffoldRoot(), "zk-verifier"),
+    path13.join(targetDir, "contracts", "verifier"),
     {
       recursive: true,
       force,
@@ -2108,15 +2214,15 @@ async function createZkProject(options) {
 }
 
 // src/scaffold/create-minimal-project.ts
-import { cp as cp3, mkdir as mkdir5, writeFile as writeFile5 } from "fs/promises";
+import { cp as cp3, mkdir as mkdir5, writeFile as writeFile6 } from "fs/promises";
 import { existsSync as existsSync3 } from "fs";
-import path13 from "path";
+import path14 from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
-var moduleDir2 = typeof __dirname === "string" ? __dirname : path13.dirname(fileURLToPath2(import.meta.url));
+var moduleDir2 = typeof __dirname === "string" ? __dirname : path14.dirname(fileURLToPath2(import.meta.url));
 function scaffoldRoot2() {
   const candidates = [
-    path13.resolve(moduleDir2, "../../scaffolds"),
-    path13.resolve(moduleDir2, "../scaffolds")
+    path14.resolve(moduleDir2, "../../scaffolds"),
+    path14.resolve(moduleDir2, "../scaffolds")
   ];
   const found = candidates.find((candidate) => existsSync3(candidate));
   return found ?? candidates[0];
@@ -2153,6 +2259,7 @@ function packageJsonSource2(projectName) {
         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}"
       },
@@ -2175,6 +2282,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>
@@ -2182,6 +2290,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\`
@@ -2195,31 +2313,31 @@ Edit \`contracts/app/src/lib.rs\` to customize the contract. Add a frontend late
 `;
 }
 async function createMinimalProject(options) {
-  const targetDir = path13.resolve(options.targetDir);
+  const targetDir = path14.resolve(options.targetDir);
   const force = options.force ?? false;
   await mkdir5(targetDir, { recursive: true });
   await Promise.all([
-    writeFile5(path13.join(targetDir, "caatinga.config.ts"), configSource2(options.projectName), {
+    writeFile6(path14.join(targetDir, "caatinga.config.ts"), configSource2(options.projectName), {
       encoding: "utf8",
       flag: force ? "w" : "wx"
     }),
-    writeFile5(path13.join(targetDir, "package.json"), packageJsonSource2(options.projectName), {
+    writeFile6(path14.join(targetDir, "package.json"), packageJsonSource2(options.projectName), {
       encoding: "utf8",
       flag: force ? "w" : "wx"
     }),
-    writeFile5(path13.join(targetDir, ".gitignore"), "node_modules\n.artifacts\ntarget\n", {
+    writeFile6(path14.join(targetDir, ".gitignore"), "node_modules\n.artifacts\ntarget\n", {
       encoding: "utf8",
       flag: force ? "w" : "wx"
     }),
-    writeFile5(path13.join(targetDir, "README.md"), readmeSource2(options.projectName), {
+    writeFile6(path14.join(targetDir, "README.md"), readmeSource2(options.projectName), {
       encoding: "utf8",
       flag: force ? "w" : "wx"
     })
   ]);
-  await mkdir5(path13.join(targetDir, "contracts"), { recursive: true });
+  await mkdir5(path14.join(targetDir, "contracts"), { recursive: true });
   await cp3(
-    path13.join(scaffoldRoot2(), "soroban-contract-stub"),
-    path13.join(targetDir, "contracts", "app"),
+    path14.join(scaffoldRoot2(), "soroban-contract-stub"),
+    path14.join(targetDir, "contracts", "app"),
     {
       recursive: true,
       force,

package/package.json

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

package/dist/artifact.schema-CGCFfl0g.d.cts

@@ -1,185 +0,0 @@
-import { z } from 'zod';
-
-declare const CaatingaErrorCode: {
-    readonly CONFIG_NOT_FOUND: "CAATINGA_CONFIG_NOT_FOUND";
-    readonly DEPENDENCIES_NOT_INSTALLED: "CAATINGA_DEPENDENCIES_NOT_INSTALLED";
-    readonly INVALID_CONFIG: "CAATINGA_INVALID_CONFIG";
-    readonly COMMAND_FAILED: "CAATINGA_COMMAND_FAILED";
-    readonly UNEXPECTED_ERROR: "CAATINGA_UNEXPECTED_ERROR";
-    readonly STELLAR_CLI_NOT_FOUND: "CAATINGA_STELLAR_CLI_NOT_FOUND";
-    readonly STELLAR_CLI_VERSION_PARSE_FAILED: "CAATINGA_STELLAR_CLI_VERSION_PARSE_FAILED";
-    readonly UNSUPPORTED_CLI_VERSION: "CAATINGA_UNSUPPORTED_CLI_VERSION";
-    readonly RUST_NOT_FOUND: "CAATINGA_RUST_NOT_FOUND";
-    readonly RUST_TARGET_NOT_FOUND: "CAATINGA_RUST_TARGET_NOT_FOUND";
-    readonly DEPLOY_FAILED: "CAATINGA_DEPLOY_FAILED";
-    readonly BUILD_FAILED: "CAATINGA_BUILD_FAILED";
-    readonly BINDINGS_FAILED: "CAATINGA_BINDINGS_FAILED";
-    readonly INVOKE_FAILED: "CAATINGA_INVOKE_FAILED";
-    readonly CONTRACT_NOT_FOUND: "CAATINGA_CONTRACT_NOT_FOUND";
-    readonly NETWORK_NOT_FOUND: "CAATINGA_NETWORK_NOT_FOUND";
-    readonly ARTIFACT_NOT_FOUND: "CAATINGA_ARTIFACT_NOT_FOUND";
-    readonly ARTIFACT_INVALID: "CAATINGA_ARTIFACT_INVALID";
-    readonly CONTRACT_ID_NOT_FOUND: "CAATINGA_CONTRACT_ID_NOT_FOUND";
-    readonly CONTRACT_ARTIFACT_NOT_FOUND: "CAATINGA_CONTRACT_ARTIFACT_NOT_FOUND";
-    readonly CONTRACT_DEPENDENCY_NOT_FOUND: "CAATINGA_CONTRACT_DEPENDENCY_NOT_FOUND";
-    readonly CONTRACT_DEPENDENCY_CYCLE: "CAATINGA_CONTRACT_DEPENDENCY_CYCLE";
-    readonly CONTRACT_DEPENDENCY_ARTIFACT_NOT_FOUND: "CAATINGA_CONTRACT_DEPENDENCY_ARTIFACT_NOT_FOUND";
-    readonly DEPENDENCY_CONTRACT_NOT_FOUND: "CAATINGA_DEPENDENCY_CONTRACT_NOT_FOUND";
-    readonly DEPLOY_ARG_PLACEHOLDER_INVALID: "CAATINGA_DEPLOY_ARG_PLACEHOLDER_INVALID";
-    readonly DEPLOY_ARG_PLACEHOLDER_UNRESOLVED: "CAATINGA_DEPLOY_ARG_PLACEHOLDER_UNRESOLVED";
-    readonly BINDING_CLIENT_NOT_FOUND: "CAATINGA_BINDING_CLIENT_NOT_FOUND";
-    readonly BINDING_METHOD_NOT_FOUND: "CAATINGA_BINDING_METHOD_NOT_FOUND";
-    readonly PLACEHOLDER_BINDING: "CAATINGA_PLACEHOLDER_BINDING";
-    readonly XDR_BUILD_FAILED: "CAATINGA_XDR_BUILD_FAILED";
-    readonly XDR_PREPARE_FAILED: "CAATINGA_XDR_PREPARE_FAILED";
-    readonly XDR_SIGN_FAILED: "CAATINGA_XDR_SIGN_FAILED";
-    readonly XDR_SUBMIT_FAILED: "CAATINGA_XDR_SUBMIT_FAILED";
-    readonly XDR_RESULT_FAILED: "CAATINGA_XDR_RESULT_FAILED";
-    readonly READ_RESULT_MISSING: "CAATINGA_READ_RESULT_MISSING";
-    readonly WALLET_NOT_CONNECTED: "CAATINGA_WALLET_NOT_CONNECTED";
-    readonly WALLET_TIMEOUT: "CAATINGA_WALLET_TIMEOUT";
-    readonly SOURCE_ACCOUNT_REQUIRED: "CAATINGA_SOURCE_ACCOUNT_REQUIRED";
-    readonly SOURCE_IS_SECRET_KEY: "CAATINGA_SOURCE_IS_SECRET_KEY";
-    readonly SOURCE_IS_SEED_PHRASE: "CAATINGA_SOURCE_IS_SEED_PHRASE";
-    readonly SOURCE_IS_PUBLIC_KEY: "CAATINGA_SOURCE_IS_PUBLIC_KEY";
-    readonly UNSAFE_SOURCE_ACCOUNT: "CAATINGA_UNSAFE_SOURCE_ACCOUNT";
-    readonly INVOKE_TARGET_INVALID: "CAATINGA_INVOKE_TARGET_INVALID";
-    readonly TEMPLATE_NOT_FOUND: "CAATINGA_TEMPLATE_NOT_FOUND";
-    readonly INVALID_TEMPLATE_MANIFEST: "CAATINGA_INVALID_TEMPLATE_MANIFEST";
-    readonly TEMPLATE_MANIFEST_NOT_FOUND: "CAATINGA_TEMPLATE_MANIFEST_NOT_FOUND";
-    readonly TEMPLATE_INCOMPATIBLE: "CAATINGA_TEMPLATE_INCOMPATIBLE";
-    readonly ZK_VERIFICATION_FAILED: "CAATINGA_ZK_VERIFICATION_FAILED";
-    readonly DOCTOR_PARTIAL_DEPLOY: "CAATINGA_DOCTOR_PARTIAL_DEPLOY";
-    readonly MULTI_AUTH_REQUIRED: "CAATINGA_MULTI_AUTH_REQUIRED";
-};
-type CaatingaErrorCodeValue = typeof CaatingaErrorCode[keyof typeof CaatingaErrorCode];
-
-declare class CaatingaError extends Error {
-    readonly code: CaatingaErrorCodeValue;
-    readonly hint?: string | undefined;
-    readonly cause?: unknown | undefined;
-    constructor(message: string, code: CaatingaErrorCodeValue, hint?: string | undefined, cause?: unknown | undefined);
-}
-declare function toCaatingaError(error: unknown): CaatingaError;
-
-/**
- * Render an error for display. For a {@link CaatingaError} this surfaces the
- * code, message, and hint, plus the underlying `cause` (when present) so the
- * real reason — e.g. a wallet rejection or an XDR parse error — is never hidden
- * behind a generic hint. Falls back to the plain message for other errors.
- */
-declare function formatCaatingaError(error: unknown): string;
-
-declare const ContractArtifactSchema: z.ZodObject<{
-    contractId: z.ZodString;
-    wasmHash: z.ZodString;
-    deployedAt: z.ZodString;
-    sourcePath: z.ZodString;
-    wasmPath: z.ZodString;
-    dependencies: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-    resolvedDeployArgs: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
-}, "strip", z.ZodTypeAny, {
-    contractId: string;
-    wasmHash: string;
-    deployedAt: string;
-    sourcePath: string;
-    wasmPath: string;
-    dependencies: string[];
-    resolvedDeployArgs: Record<string, string | number | boolean>;
-}, {
-    contractId: string;
-    wasmHash: string;
-    deployedAt: string;
-    sourcePath: string;
-    wasmPath: string;
-    dependencies?: string[] | undefined;
-    resolvedDeployArgs?: Record<string, string | number | boolean> | undefined;
-}>;
-declare const CaatingaArtifactsSchema: z.ZodObject<{
-    project: z.ZodString;
-    version: z.ZodLiteral<1>;
-    networks: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
-        contracts: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
-            contractId: z.ZodString;
-            wasmHash: z.ZodString;
-            deployedAt: z.ZodString;
-            sourcePath: z.ZodString;
-            wasmPath: z.ZodString;
-            dependencies: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-            resolvedDeployArgs: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
-        }, "strip", z.ZodTypeAny, {
-            contractId: string;
-            wasmHash: string;
-            deployedAt: string;
-            sourcePath: string;
-            wasmPath: string;
-            dependencies: string[];
-            resolvedDeployArgs: Record<string, string | number | boolean>;
-        }, {
-            contractId: string;
-            wasmHash: string;
-            deployedAt: string;
-            sourcePath: string;
-            wasmPath: string;
-            dependencies?: string[] | undefined;
-            resolvedDeployArgs?: Record<string, string | number | boolean> | undefined;
-        }>>>;
-        dependencyGraph: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
-    }, "strip", z.ZodTypeAny, {
-        contracts: Record<string, {
-            contractId: string;
-            wasmHash: string;
-            deployedAt: string;
-            sourcePath: string;
-            wasmPath: string;
-            dependencies: string[];
-            resolvedDeployArgs: Record<string, string | number | boolean>;
-        }>;
-        dependencyGraph: Record<string, string[]>;
-    }, {
-        contracts?: Record<string, {
-            contractId: string;
-            wasmHash: string;
-            deployedAt: string;
-            sourcePath: string;
-            wasmPath: string;
-            dependencies?: string[] | undefined;
-            resolvedDeployArgs?: Record<string, string | number | boolean> | undefined;
-        }> | undefined;
-        dependencyGraph?: Record<string, string[]> | undefined;
-    }>>>;
-}, "strip", z.ZodTypeAny, {
-    project: string;
-    version: 1;
-    networks: Record<string, {
-        contracts: Record<string, {
-            contractId: string;
-            wasmHash: string;
-            deployedAt: string;
-            sourcePath: string;
-            wasmPath: string;
-            dependencies: string[];
-            resolvedDeployArgs: Record<string, string | number | boolean>;
-        }>;
-        dependencyGraph: Record<string, string[]>;
-    }>;
-}, {
-    project: string;
-    version: 1;
-    networks?: Record<string, {
-        contracts?: Record<string, {
-            contractId: string;
-            wasmHash: string;
-            deployedAt: string;
-            sourcePath: string;
-            wasmPath: string;
-            dependencies?: string[] | undefined;
-            resolvedDeployArgs?: Record<string, string | number | boolean> | undefined;
-        }> | undefined;
-        dependencyGraph?: Record<string, string[]> | undefined;
-    }> | undefined;
-}>;
-type ContractArtifact = z.infer<typeof ContractArtifactSchema>;
-type CaatingaArtifacts = z.infer<typeof CaatingaArtifactsSchema>;
-
-export { type CaatingaArtifacts as C, CaatingaError as a, CaatingaErrorCode as b, type ContractArtifact as c, type CaatingaErrorCodeValue as d, CaatingaArtifactsSchema as e, formatCaatingaError as f, toCaatingaError as t };

package/dist/artifact.schema-CGCFfl0g.d.ts

@@ -1,185 +0,0 @@
-import { z } from 'zod';
-
-declare const CaatingaErrorCode: {
-    readonly CONFIG_NOT_FOUND: "CAATINGA_CONFIG_NOT_FOUND";
-    readonly DEPENDENCIES_NOT_INSTALLED: "CAATINGA_DEPENDENCIES_NOT_INSTALLED";
-    readonly INVALID_CONFIG: "CAATINGA_INVALID_CONFIG";
-    readonly COMMAND_FAILED: "CAATINGA_COMMAND_FAILED";
-    readonly UNEXPECTED_ERROR: "CAATINGA_UNEXPECTED_ERROR";
-    readonly STELLAR_CLI_NOT_FOUND: "CAATINGA_STELLAR_CLI_NOT_FOUND";
-    readonly STELLAR_CLI_VERSION_PARSE_FAILED: "CAATINGA_STELLAR_CLI_VERSION_PARSE_FAILED";
-    readonly UNSUPPORTED_CLI_VERSION: "CAATINGA_UNSUPPORTED_CLI_VERSION";
-    readonly RUST_NOT_FOUND: "CAATINGA_RUST_NOT_FOUND";
-    readonly RUST_TARGET_NOT_FOUND: "CAATINGA_RUST_TARGET_NOT_FOUND";
-    readonly DEPLOY_FAILED: "CAATINGA_DEPLOY_FAILED";
-    readonly BUILD_FAILED: "CAATINGA_BUILD_FAILED";
-    readonly BINDINGS_FAILED: "CAATINGA_BINDINGS_FAILED";
-    readonly INVOKE_FAILED: "CAATINGA_INVOKE_FAILED";
-    readonly CONTRACT_NOT_FOUND: "CAATINGA_CONTRACT_NOT_FOUND";
-    readonly NETWORK_NOT_FOUND: "CAATINGA_NETWORK_NOT_FOUND";
-    readonly ARTIFACT_NOT_FOUND: "CAATINGA_ARTIFACT_NOT_FOUND";
-    readonly ARTIFACT_INVALID: "CAATINGA_ARTIFACT_INVALID";
-    readonly CONTRACT_ID_NOT_FOUND: "CAATINGA_CONTRACT_ID_NOT_FOUND";
-    readonly CONTRACT_ARTIFACT_NOT_FOUND: "CAATINGA_CONTRACT_ARTIFACT_NOT_FOUND";
-    readonly CONTRACT_DEPENDENCY_NOT_FOUND: "CAATINGA_CONTRACT_DEPENDENCY_NOT_FOUND";
-    readonly CONTRACT_DEPENDENCY_CYCLE: "CAATINGA_CONTRACT_DEPENDENCY_CYCLE";
-    readonly CONTRACT_DEPENDENCY_ARTIFACT_NOT_FOUND: "CAATINGA_CONTRACT_DEPENDENCY_ARTIFACT_NOT_FOUND";
-    readonly DEPENDENCY_CONTRACT_NOT_FOUND: "CAATINGA_DEPENDENCY_CONTRACT_NOT_FOUND";
-    readonly DEPLOY_ARG_PLACEHOLDER_INVALID: "CAATINGA_DEPLOY_ARG_PLACEHOLDER_INVALID";
-    readonly DEPLOY_ARG_PLACEHOLDER_UNRESOLVED: "CAATINGA_DEPLOY_ARG_PLACEHOLDER_UNRESOLVED";
-    readonly BINDING_CLIENT_NOT_FOUND: "CAATINGA_BINDING_CLIENT_NOT_FOUND";
-    readonly BINDING_METHOD_NOT_FOUND: "CAATINGA_BINDING_METHOD_NOT_FOUND";
-    readonly PLACEHOLDER_BINDING: "CAATINGA_PLACEHOLDER_BINDING";
-    readonly XDR_BUILD_FAILED: "CAATINGA_XDR_BUILD_FAILED";
-    readonly XDR_PREPARE_FAILED: "CAATINGA_XDR_PREPARE_FAILED";
-    readonly XDR_SIGN_FAILED: "CAATINGA_XDR_SIGN_FAILED";
-    readonly XDR_SUBMIT_FAILED: "CAATINGA_XDR_SUBMIT_FAILED";
-    readonly XDR_RESULT_FAILED: "CAATINGA_XDR_RESULT_FAILED";
-    readonly READ_RESULT_MISSING: "CAATINGA_READ_RESULT_MISSING";
-    readonly WALLET_NOT_CONNECTED: "CAATINGA_WALLET_NOT_CONNECTED";
-    readonly WALLET_TIMEOUT: "CAATINGA_WALLET_TIMEOUT";
-    readonly SOURCE_ACCOUNT_REQUIRED: "CAATINGA_SOURCE_ACCOUNT_REQUIRED";
-    readonly SOURCE_IS_SECRET_KEY: "CAATINGA_SOURCE_IS_SECRET_KEY";
-    readonly SOURCE_IS_SEED_PHRASE: "CAATINGA_SOURCE_IS_SEED_PHRASE";
-    readonly SOURCE_IS_PUBLIC_KEY: "CAATINGA_SOURCE_IS_PUBLIC_KEY";
-    readonly UNSAFE_SOURCE_ACCOUNT: "CAATINGA_UNSAFE_SOURCE_ACCOUNT";
-    readonly INVOKE_TARGET_INVALID: "CAATINGA_INVOKE_TARGET_INVALID";
-    readonly TEMPLATE_NOT_FOUND: "CAATINGA_TEMPLATE_NOT_FOUND";
-    readonly INVALID_TEMPLATE_MANIFEST: "CAATINGA_INVALID_TEMPLATE_MANIFEST";
-    readonly TEMPLATE_MANIFEST_NOT_FOUND: "CAATINGA_TEMPLATE_MANIFEST_NOT_FOUND";
-    readonly TEMPLATE_INCOMPATIBLE: "CAATINGA_TEMPLATE_INCOMPATIBLE";
-    readonly ZK_VERIFICATION_FAILED: "CAATINGA_ZK_VERIFICATION_FAILED";
-    readonly DOCTOR_PARTIAL_DEPLOY: "CAATINGA_DOCTOR_PARTIAL_DEPLOY";
-    readonly MULTI_AUTH_REQUIRED: "CAATINGA_MULTI_AUTH_REQUIRED";
-};
-type CaatingaErrorCodeValue = typeof CaatingaErrorCode[keyof typeof CaatingaErrorCode];
-
-declare class CaatingaError extends Error {
-    readonly code: CaatingaErrorCodeValue;
-    readonly hint?: string | undefined;
-    readonly cause?: unknown | undefined;
-    constructor(message: string, code: CaatingaErrorCodeValue, hint?: string | undefined, cause?: unknown | undefined);
-}
-declare function toCaatingaError(error: unknown): CaatingaError;
-
-/**
- * Render an error for display. For a {@link CaatingaError} this surfaces the
- * code, message, and hint, plus the underlying `cause` (when present) so the
- * real reason — e.g. a wallet rejection or an XDR parse error — is never hidden
- * behind a generic hint. Falls back to the plain message for other errors.
- */
-declare function formatCaatingaError(error: unknown): string;
-
-declare const ContractArtifactSchema: z.ZodObject<{
-    contractId: z.ZodString;
-    wasmHash: z.ZodString;
-    deployedAt: z.ZodString;
-    sourcePath: z.ZodString;
-    wasmPath: z.ZodString;
-    dependencies: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-    resolvedDeployArgs: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
-}, "strip", z.ZodTypeAny, {
-    contractId: string;
-    wasmHash: string;
-    deployedAt: string;
-    sourcePath: string;
-    wasmPath: string;
-    dependencies: string[];
-    resolvedDeployArgs: Record<string, string | number | boolean>;
-}, {
-    contractId: string;
-    wasmHash: string;
-    deployedAt: string;
-    sourcePath: string;
-    wasmPath: string;
-    dependencies?: string[] | undefined;
-    resolvedDeployArgs?: Record<string, string | number | boolean> | undefined;
-}>;
-declare const CaatingaArtifactsSchema: z.ZodObject<{
-    project: z.ZodString;
-    version: z.ZodLiteral<1>;
-    networks: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
-        contracts: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
-            contractId: z.ZodString;
-            wasmHash: z.ZodString;
-            deployedAt: z.ZodString;
-            sourcePath: z.ZodString;
-            wasmPath: z.ZodString;
-            dependencies: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-            resolvedDeployArgs: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
-        }, "strip", z.ZodTypeAny, {
-            contractId: string;
-            wasmHash: string;
-            deployedAt: string;
-            sourcePath: string;
-            wasmPath: string;
-            dependencies: string[];
-            resolvedDeployArgs: Record<string, string | number | boolean>;
-        }, {
-            contractId: string;
-            wasmHash: string;
-            deployedAt: string;
-            sourcePath: string;
-            wasmPath: string;
-            dependencies?: string[] | undefined;
-            resolvedDeployArgs?: Record<string, string | number | boolean> | undefined;
-        }>>>;
-        dependencyGraph: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
-    }, "strip", z.ZodTypeAny, {
-        contracts: Record<string, {
-            contractId: string;
-            wasmHash: string;
-            deployedAt: string;
-            sourcePath: string;
-            wasmPath: string;
-            dependencies: string[];
-            resolvedDeployArgs: Record<string, string | number | boolean>;
-        }>;
-        dependencyGraph: Record<string, string[]>;
-    }, {
-        contracts?: Record<string, {
-            contractId: string;
-            wasmHash: string;
-            deployedAt: string;
-            sourcePath: string;
-            wasmPath: string;
-            dependencies?: string[] | undefined;
-            resolvedDeployArgs?: Record<string, string | number | boolean> | undefined;
-        }> | undefined;
-        dependencyGraph?: Record<string, string[]> | undefined;
-    }>>>;
-}, "strip", z.ZodTypeAny, {
-    project: string;
-    version: 1;
-    networks: Record<string, {
-        contracts: Record<string, {
-            contractId: string;
-            wasmHash: string;
-            deployedAt: string;
-            sourcePath: string;
-            wasmPath: string;
-            dependencies: string[];
-            resolvedDeployArgs: Record<string, string | number | boolean>;
-        }>;
-        dependencyGraph: Record<string, string[]>;
-    }>;
-}, {
-    project: string;
-    version: 1;
-    networks?: Record<string, {
-        contracts?: Record<string, {
-            contractId: string;
-            wasmHash: string;
-            deployedAt: string;
-            sourcePath: string;
-            wasmPath: string;
-            dependencies?: string[] | undefined;
-            resolvedDeployArgs?: Record<string, string | number | boolean> | undefined;
-        }> | undefined;
-        dependencyGraph?: Record<string, string[]> | undefined;
-    }> | undefined;
-}>;
-type ContractArtifact = z.infer<typeof ContractArtifactSchema>;
-type CaatingaArtifacts = z.infer<typeof CaatingaArtifactsSchema>;
-
-export { type CaatingaArtifacts as C, CaatingaError as a, CaatingaErrorCode as b, type ContractArtifact as c, type CaatingaErrorCodeValue as d, CaatingaArtifactsSchema as e, formatCaatingaError as f, toCaatingaError as t };