@caatinga/core 2.3.0 → 2.3.1

package/dist/index.cjs

@@ -48,6 +48,7 @@ __export(index_exports, {
   collectProjectStatus: () => collectProjectStatus,
   createInitialArtifacts: () => createInitialArtifacts,
   createProjectFromTemplate: () => createProjectFromTemplate,
+  createZkProject: () => createZkProject,
   defineConfig: () => defineConfig,
   deployContract: () => deployContract,
   deployContractGraph: () => deployContractGraph,
@@ -186,7 +187,7 @@ function formatCause(cause) {
 }
 
 // src/version.ts
-var CAATINGA_CORE_VERSION = "2.3.0";
+var CAATINGA_CORE_VERSION = "2.3.1";
 
 // src/config/config.schema.ts
 var import_zod = require("zod");
@@ -224,7 +225,7 @@ var CaatingaConfigSchema = import_zod.z.object({
   frontend: import_zod.z.object({
     framework: import_zod.z.enum(["vite-react", "next", "astro"]).default("vite-react"),
     bindingsOutput: import_zod.z.string().min(1)
-  }),
+  }).optional(),
   zk: ZkConfigSchema
 });
 
@@ -423,6 +424,15 @@ async function listGeneratedEntries(outputDir) {
 }
 async function evaluateBindingFreshness(options) {
   const cwd = options.cwd ?? process.cwd();
+  if (!options.config.frontend) {
+    return {
+      contractName: options.contractName,
+      status: "unknown",
+      outputDir: "",
+      marker: null,
+      reason: "frontend bindings are not configured"
+    };
+  }
   const outputDir = import_node_path5.default.resolve(cwd, options.config.frontend.bindingsOutput, options.contractName);
   const contractArtifact = options.artifacts.networks[options.networkName]?.contracts[options.contractName];
   if (!contractArtifact) {
@@ -1441,6 +1451,13 @@ async function removeLegacyBindingStub(cwd, bindingsOutput, contractName) {
 }
 async function generateBindings(options) {
   const cwd = options.cwd ?? process.cwd();
+  if (!options.config.frontend) {
+    throw new CaatingaError(
+      "Frontend bindings are not configured.",
+      CaatingaErrorCode.INVALID_CONFIG,
+      "Add a frontend.bindingsOutput entry to caatinga.config.ts before running caatinga generate."
+    );
+  }
   const network = resolveNetwork(options.config, options.networkName);
   const artifacts = await readArtifacts(cwd);
   const contractArtifact = artifacts.networks[network.name]?.contracts[options.contractName];
@@ -1788,6 +1805,119 @@ function isTextTemplateFile(filePath) {
   ].includes(import_node_path10.default.extname(filePath));
 }
 
+// src/scaffold/create-zk-project.ts
+var import_promises9 = require("fs/promises");
+var import_node_fs = require("fs");
+var import_node_path11 = __toESM(require("path"), 1);
+var import_node_url = require("url");
+var import_meta2 = {};
+var moduleDir = typeof __dirname === "string" ? __dirname : import_node_path11.default.dirname((0, import_node_url.fileURLToPath)(import_meta2.url));
+function scaffoldRoot() {
+  const candidates = [
+    import_node_path11.default.resolve(moduleDir, "../../scaffolds"),
+    import_node_path11.default.resolve(moduleDir, "../scaffolds")
+  ];
+  const found = candidates.find((candidate) => (0, import_node_fs.existsSync)(candidate));
+  return found ?? candidates[0];
+}
+function configSource(projectName) {
+  return `import { defineConfig } from "@caatinga/core";
+
+export default defineConfig({
+  project: "${projectName}",
+  defaultNetwork: "testnet",
+  contracts: {
+    verifier: {
+      path: "./contracts/verifier",
+      wasm: "./contracts/verifier/target/wasm32v1-none/release/verifier.wasm"
+    }
+  },
+  networks: {
+    testnet: {
+      rpcUrl: "https://soroban-testnet.stellar.org",
+      networkPassphrase: "Test SDF Network ; September 2015"
+    }
+  },
+  zk: {
+    circuits: {
+      main: {
+        path: "./circuits",
+        protocol: "groth16",
+        curve: "bls12381",
+        verifierContract: "verifier"
+      }
+    }
+  }
+});
+`;
+}
+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"
+    },
+    devDependencies: {
+      "@caatinga/cli": `^${CAATINGA_CORE_VERSION}`,
+      "@caatinga/core": `^${CAATINGA_CORE_VERSION}`
+    }
+  }, null, 2)}
+`;
+}
+function readmeSource(projectName) {
+  return `# ${projectName}
+
+Minimal Caatinga ZK project.
+
+## Workflow
+
+\`\`\`bash
+npm install
+npx caatinga zk build main
+npx caatinga build verifier
+npx caatinga deploy verifier --network testnet
+npx caatinga zk prove main
+\`\`\`
+
+Replace \`circuits/main.circom\` with your circuit. Keep the entry point named \`main\`.
+`;
+}
+async function createZkProject(options) {
+  const targetDir = import_node_path11.default.resolve(options.targetDir);
+  const force = options.force ?? false;
+  const projectFiles = options.projectFiles ?? true;
+  await (0, import_promises9.mkdir)(targetDir, { recursive: true });
+  if (projectFiles) {
+    await Promise.all([
+      (0, import_promises9.writeFile)(import_node_path11.default.join(targetDir, "caatinga.config.ts"), configSource(options.projectName), { encoding: "utf8", flag: force ? "w" : "wx" }),
+      (0, import_promises9.writeFile)(import_node_path11.default.join(targetDir, "package.json"), packageJsonSource(options.projectName), { encoding: "utf8", flag: force ? "w" : "wx" }),
+      (0, import_promises9.writeFile)(import_node_path11.default.join(targetDir, ".gitignore"), "node_modules\n.artifacts\ntarget\n", { encoding: "utf8", flag: force ? "w" : "wx" }),
+      (0, import_promises9.writeFile)(import_node_path11.default.join(targetDir, "README.md"), readmeSource(options.projectName), { encoding: "utf8", flag: force ? "w" : "wx" })
+    ]);
+  }
+  await (0, import_promises9.mkdir)(import_node_path11.default.join(targetDir, "contracts"), { recursive: true });
+  await (0, import_promises9.cp)(import_node_path11.default.join(scaffoldRoot(), "zk-circuit-stub"), import_node_path11.default.join(targetDir, "circuits"), {
+    recursive: true,
+    force,
+    errorOnExist: !force
+  });
+  await (0, import_promises9.cp)(import_node_path11.default.join(scaffoldRoot(), "zk-verifier"), import_node_path11.default.join(targetDir, "contracts", "verifier"), {
+    recursive: true,
+    force,
+    errorOnExist: !force
+  });
+  if (projectFiles) {
+    await writeArtifacts(createInitialArtifacts(options.projectName, { networks: ["testnet"] }), targetDir);
+  }
+  return { targetDir };
+}
+
 // src/ci/is-transient-testnet-smoke-failure.ts
 var NO_RETRY_CAATINGA_SUBSTRINGS = [
   "CAATINGA_UNSUPPORTED_CLI_VERSION",
@@ -1828,6 +1958,7 @@ function isTransientTestnetSmokeFailure(logText) {
   collectProjectStatus,
   createInitialArtifacts,
   createProjectFromTemplate,
+  createZkProject,
   defineConfig,
   deployContract,
   deployContractGraph,

package/dist/index.d.cts

@@ -2,7 +2,7 @@ import { C as CaatingaArtifacts, a as ContractArtifact, b as CaatingaErrorCodeVa
 export { d as CaatingaArtifactsSchema, e as CaatingaErrorCode, f as formatCaatingaError, t as toCaatingaError } from './browser-Cq4ZofIq.cjs';
 import { z } from 'zod';
 
-declare const CAATINGA_CORE_VERSION = "2.3.0";
+declare const CAATINGA_CORE_VERSION = "2.3.1";
 
 declare const ContractConfigSchema: z.ZodObject<{
     path: z.ZodString;
@@ -75,7 +75,7 @@ declare const CaatingaConfigSchema: z.ZodObject<{
         rpcUrl: string;
         networkPassphrase: string;
     }>>;
-    frontend: z.ZodObject<{
+    frontend: z.ZodOptional<z.ZodObject<{
         framework: z.ZodDefault<z.ZodEnum<["vite-react", "next", "astro"]>>;
         bindingsOutput: z.ZodString;
     }, "strip", z.ZodTypeAny, {
@@ -84,7 +84,7 @@ declare const CaatingaConfigSchema: z.ZodObject<{
     }, {
         bindingsOutput: string;
         framework?: "vite-react" | "next" | "astro" | undefined;
-    }>;
+    }>>;
     zk: z.ZodOptional<z.ZodObject<{
         circuits: z.ZodRecord<z.ZodString, z.ZodObject<{
             path: z.ZodString;
@@ -130,10 +130,10 @@ declare const CaatingaConfigSchema: z.ZodObject<{
         rpcUrl: string;
         networkPassphrase: string;
     }>;
-    frontend: {
+    frontend?: {
         framework: "vite-react" | "next" | "astro";
         bindingsOutput: string;
-    };
+    } | undefined;
     zk?: {
         circuits: Record<string, {
             path: string;
@@ -154,11 +154,11 @@ declare const CaatingaConfigSchema: z.ZodObject<{
         rpcUrl: string;
         networkPassphrase: string;
     }>;
-    frontend: {
+    defaultNetwork?: string | undefined;
+    frontend?: {
         bindingsOutput: string;
         framework?: "vite-react" | "next" | "astro" | undefined;
-    };
-    defaultNetwork?: string | undefined;
+    } | undefined;
     zk?: {
         circuits: Record<string, {
             path: string;
@@ -522,6 +522,16 @@ declare function createProjectFromTemplate(options: CreateProjectFromTemplateOpt
     };
 }>;
 
+type CreateZkProjectOptions = {
+    projectName: string;
+    targetDir: string;
+    force?: boolean;
+    projectFiles?: boolean;
+};
+declare function createZkProject(options: CreateZkProjectOptions): Promise<{
+    targetDir: string;
+}>;
+
 declare const TemplateManifestSchema: z.ZodObject<{
     name: z.ZodString;
     version: z.ZodString;
@@ -611,4 +621,4 @@ type TemplateManifest = z.infer<typeof TemplateManifestSchema>;
 
 declare function isTransientTestnetSmokeFailure(logText: string): boolean;
 
-export { BINDING_MARKER_FILENAME, type BindingFreshness, type BindingFreshnessStatus, type BindingMarker, BindingMarkerSchema, type BuildContractOptions, CAATINGA_CORE_VERSION, CaatingaArtifacts, type CaatingaConfig, CaatingaConfigSchema, CaatingaError, type CheckStellarCliVersionOptions, type CollectProjectStatusOptions, type CompatibilityReport, type CompatibilityStatus, type CompatibilityWarning, type CompatibilityWarningCode, ContractArtifact, type ContractConfig, type ContractStatusEntry, type CreateInitialArtifactsOptions, type CreateProjectFromTemplateOptions, type DeployArgValue, type DeployContractGraphResult, type DeployContractOptions, type EvaluateBindingFreshnessOptions, type EvaluateStellarCliCompatibilityInput, type GenerateBindingsGraphResult, type GenerateBindingsOptions, type InvokeContractOptions, type InvokeTarget, type LoadConfigOptions, type NetworkConfig, type NetworkStatus, type ProjectStatus, type ResolvedContract, type ResolvedNetwork, type RunCommandResult, STELLAR_CLI_LAST_TESTED_VERSION, STELLAR_CLI_MIN_VERSION, type SkippedContract, type TemplateManifest, TemplateManifestSchema, WELL_KNOWN_NETWORKS, buildContract, buildDependencyGraph, checkBinary, checkStellarCliVersion, collectProjectStatus, createInitialArtifacts, createProjectFromTemplate, defineConfig, deployContract, deployContractGraph, evaluateBindingFreshness, evaluateBindingsFreshness, evaluateStellarCliCompatibility, generateBindings, generateBindingsGraph, invokeContract, isTransientTestnetSmokeFailure, loadConfig, parseContractId, parseInvokeTarget, parseStellarCliVersion, readArtifacts, readBindingMarker, resolveContract, resolveDefaultContractName, resolveDeployArgs, resolveDeployOrder, resolveNetwork, runCommand, updateArtifact, validateSourceShape, writeArtifacts, writeBindingMarker };
+export { BINDING_MARKER_FILENAME, type BindingFreshness, type BindingFreshnessStatus, type BindingMarker, BindingMarkerSchema, type BuildContractOptions, CAATINGA_CORE_VERSION, CaatingaArtifacts, type CaatingaConfig, CaatingaConfigSchema, CaatingaError, type CheckStellarCliVersionOptions, type CollectProjectStatusOptions, type CompatibilityReport, type CompatibilityStatus, type CompatibilityWarning, type CompatibilityWarningCode, ContractArtifact, type ContractConfig, type ContractStatusEntry, type CreateInitialArtifactsOptions, type CreateProjectFromTemplateOptions, type CreateZkProjectOptions, type DeployArgValue, type DeployContractGraphResult, type DeployContractOptions, type EvaluateBindingFreshnessOptions, type EvaluateStellarCliCompatibilityInput, type GenerateBindingsGraphResult, type GenerateBindingsOptions, type InvokeContractOptions, type InvokeTarget, type LoadConfigOptions, type NetworkConfig, type NetworkStatus, type ProjectStatus, type ResolvedContract, type ResolvedNetwork, type RunCommandResult, STELLAR_CLI_LAST_TESTED_VERSION, STELLAR_CLI_MIN_VERSION, type SkippedContract, type TemplateManifest, TemplateManifestSchema, WELL_KNOWN_NETWORKS, buildContract, buildDependencyGraph, checkBinary, checkStellarCliVersion, collectProjectStatus, createInitialArtifacts, createProjectFromTemplate, createZkProject, defineConfig, deployContract, deployContractGraph, evaluateBindingFreshness, evaluateBindingsFreshness, evaluateStellarCliCompatibility, generateBindings, generateBindingsGraph, invokeContract, isTransientTestnetSmokeFailure, loadConfig, parseContractId, parseInvokeTarget, parseStellarCliVersion, readArtifacts, readBindingMarker, resolveContract, resolveDefaultContractName, resolveDeployArgs, resolveDeployOrder, resolveNetwork, runCommand, updateArtifact, validateSourceShape, writeArtifacts, writeBindingMarker };

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import { C as CaatingaArtifacts, a as ContractArtifact, b as CaatingaErrorCodeVa
 export { d as CaatingaArtifactsSchema, e as CaatingaErrorCode, f as formatCaatingaError, t as toCaatingaError } from './browser-Cq4ZofIq.js';
 import { z } from 'zod';
 
-declare const CAATINGA_CORE_VERSION = "2.3.0";
+declare const CAATINGA_CORE_VERSION = "2.3.1";
 
 declare const ContractConfigSchema: z.ZodObject<{
     path: z.ZodString;
@@ -75,7 +75,7 @@ declare const CaatingaConfigSchema: z.ZodObject<{
         rpcUrl: string;
         networkPassphrase: string;
     }>>;
-    frontend: z.ZodObject<{
+    frontend: z.ZodOptional<z.ZodObject<{
         framework: z.ZodDefault<z.ZodEnum<["vite-react", "next", "astro"]>>;
         bindingsOutput: z.ZodString;
     }, "strip", z.ZodTypeAny, {
@@ -84,7 +84,7 @@ declare const CaatingaConfigSchema: z.ZodObject<{
     }, {
         bindingsOutput: string;
         framework?: "vite-react" | "next" | "astro" | undefined;
-    }>;
+    }>>;
     zk: z.ZodOptional<z.ZodObject<{
         circuits: z.ZodRecord<z.ZodString, z.ZodObject<{
             path: z.ZodString;
@@ -130,10 +130,10 @@ declare const CaatingaConfigSchema: z.ZodObject<{
         rpcUrl: string;
         networkPassphrase: string;
     }>;
-    frontend: {
+    frontend?: {
         framework: "vite-react" | "next" | "astro";
         bindingsOutput: string;
-    };
+    } | undefined;
     zk?: {
         circuits: Record<string, {
             path: string;
@@ -154,11 +154,11 @@ declare const CaatingaConfigSchema: z.ZodObject<{
         rpcUrl: string;
         networkPassphrase: string;
     }>;
-    frontend: {
+    defaultNetwork?: string | undefined;
+    frontend?: {
         bindingsOutput: string;
         framework?: "vite-react" | "next" | "astro" | undefined;
-    };
-    defaultNetwork?: string | undefined;
+    } | undefined;
     zk?: {
         circuits: Record<string, {
             path: string;
@@ -522,6 +522,16 @@ declare function createProjectFromTemplate(options: CreateProjectFromTemplateOpt
     };
 }>;
 
+type CreateZkProjectOptions = {
+    projectName: string;
+    targetDir: string;
+    force?: boolean;
+    projectFiles?: boolean;
+};
+declare function createZkProject(options: CreateZkProjectOptions): Promise<{
+    targetDir: string;
+}>;
+
 declare const TemplateManifestSchema: z.ZodObject<{
     name: z.ZodString;
     version: z.ZodString;
@@ -611,4 +621,4 @@ type TemplateManifest = z.infer<typeof TemplateManifestSchema>;
 
 declare function isTransientTestnetSmokeFailure(logText: string): boolean;
 
-export { BINDING_MARKER_FILENAME, type BindingFreshness, type BindingFreshnessStatus, type BindingMarker, BindingMarkerSchema, type BuildContractOptions, CAATINGA_CORE_VERSION, CaatingaArtifacts, type CaatingaConfig, CaatingaConfigSchema, CaatingaError, type CheckStellarCliVersionOptions, type CollectProjectStatusOptions, type CompatibilityReport, type CompatibilityStatus, type CompatibilityWarning, type CompatibilityWarningCode, ContractArtifact, type ContractConfig, type ContractStatusEntry, type CreateInitialArtifactsOptions, type CreateProjectFromTemplateOptions, type DeployArgValue, type DeployContractGraphResult, type DeployContractOptions, type EvaluateBindingFreshnessOptions, type EvaluateStellarCliCompatibilityInput, type GenerateBindingsGraphResult, type GenerateBindingsOptions, type InvokeContractOptions, type InvokeTarget, type LoadConfigOptions, type NetworkConfig, type NetworkStatus, type ProjectStatus, type ResolvedContract, type ResolvedNetwork, type RunCommandResult, STELLAR_CLI_LAST_TESTED_VERSION, STELLAR_CLI_MIN_VERSION, type SkippedContract, type TemplateManifest, TemplateManifestSchema, WELL_KNOWN_NETWORKS, buildContract, buildDependencyGraph, checkBinary, checkStellarCliVersion, collectProjectStatus, createInitialArtifacts, createProjectFromTemplate, defineConfig, deployContract, deployContractGraph, evaluateBindingFreshness, evaluateBindingsFreshness, evaluateStellarCliCompatibility, generateBindings, generateBindingsGraph, invokeContract, isTransientTestnetSmokeFailure, loadConfig, parseContractId, parseInvokeTarget, parseStellarCliVersion, readArtifacts, readBindingMarker, resolveContract, resolveDefaultContractName, resolveDeployArgs, resolveDeployOrder, resolveNetwork, runCommand, updateArtifact, validateSourceShape, writeArtifacts, writeBindingMarker };
+export { BINDING_MARKER_FILENAME, type BindingFreshness, type BindingFreshnessStatus, type BindingMarker, BindingMarkerSchema, type BuildContractOptions, CAATINGA_CORE_VERSION, CaatingaArtifacts, type CaatingaConfig, CaatingaConfigSchema, CaatingaError, type CheckStellarCliVersionOptions, type CollectProjectStatusOptions, type CompatibilityReport, type CompatibilityStatus, type CompatibilityWarning, type CompatibilityWarningCode, ContractArtifact, type ContractConfig, type ContractStatusEntry, type CreateInitialArtifactsOptions, type CreateProjectFromTemplateOptions, type CreateZkProjectOptions, type DeployArgValue, type DeployContractGraphResult, type DeployContractOptions, type EvaluateBindingFreshnessOptions, type EvaluateStellarCliCompatibilityInput, type GenerateBindingsGraphResult, type GenerateBindingsOptions, type InvokeContractOptions, type InvokeTarget, type LoadConfigOptions, type NetworkConfig, type NetworkStatus, type ProjectStatus, type ResolvedContract, type ResolvedNetwork, type RunCommandResult, STELLAR_CLI_LAST_TESTED_VERSION, STELLAR_CLI_MIN_VERSION, type SkippedContract, type TemplateManifest, TemplateManifestSchema, WELL_KNOWN_NETWORKS, buildContract, buildDependencyGraph, checkBinary, checkStellarCliVersion, collectProjectStatus, createInitialArtifacts, createProjectFromTemplate, createZkProject, defineConfig, deployContract, deployContractGraph, evaluateBindingFreshness, evaluateBindingsFreshness, evaluateStellarCliCompatibility, generateBindings, generateBindingsGraph, invokeContract, isTransientTestnetSmokeFailure, loadConfig, parseContractId, parseInvokeTarget, parseStellarCliVersion, readArtifacts, readBindingMarker, resolveContract, resolveDefaultContractName, resolveDeployArgs, resolveDeployOrder, resolveNetwork, runCommand, updateArtifact, validateSourceShape, writeArtifacts, writeBindingMarker };

package/dist/index.js

@@ -105,7 +105,7 @@ function formatCause(cause) {
 }
 
 // src/version.ts
-var CAATINGA_CORE_VERSION = "2.3.0";
+var CAATINGA_CORE_VERSION = "2.3.1";
 
 // src/config/config.schema.ts
 import { z } from "zod";
@@ -143,7 +143,7 @@ var CaatingaConfigSchema = z.object({
   frontend: z.object({
     framework: z.enum(["vite-react", "next", "astro"]).default("vite-react"),
     bindingsOutput: z.string().min(1)
-  }),
+  }).optional(),
   zk: ZkConfigSchema
 });
 
@@ -341,6 +341,15 @@ async function listGeneratedEntries(outputDir) {
 }
 async function evaluateBindingFreshness(options) {
   const cwd = options.cwd ?? process.cwd();
+  if (!options.config.frontend) {
+    return {
+      contractName: options.contractName,
+      status: "unknown",
+      outputDir: "",
+      marker: null,
+      reason: "frontend bindings are not configured"
+    };
+  }
   const outputDir = path5.resolve(cwd, options.config.frontend.bindingsOutput, options.contractName);
   const contractArtifact = options.artifacts.networks[options.networkName]?.contracts[options.contractName];
   if (!contractArtifact) {
@@ -1359,6 +1368,13 @@ async function removeLegacyBindingStub(cwd, bindingsOutput, contractName) {
 }
 async function generateBindings(options) {
   const cwd = options.cwd ?? process.cwd();
+  if (!options.config.frontend) {
+    throw new CaatingaError(
+      "Frontend bindings are not configured.",
+      CaatingaErrorCode.INVALID_CONFIG,
+      "Add a frontend.bindingsOutput entry to caatinga.config.ts before running caatinga generate."
+    );
+  }
   const network = resolveNetwork(options.config, options.networkName);
   const artifacts = await readArtifacts(cwd);
   const contractArtifact = artifacts.networks[network.name]?.contracts[options.contractName];
@@ -1706,6 +1722,118 @@ function isTextTemplateFile(filePath) {
   ].includes(path10.extname(filePath));
 }
 
+// src/scaffold/create-zk-project.ts
+import { cp as cp2, mkdir as mkdir4, writeFile as writeFile4 } from "fs/promises";
+import { existsSync } from "fs";
+import path11 from "path";
+import { fileURLToPath } from "url";
+var moduleDir = typeof __dirname === "string" ? __dirname : path11.dirname(fileURLToPath(import.meta.url));
+function scaffoldRoot() {
+  const candidates = [
+    path11.resolve(moduleDir, "../../scaffolds"),
+    path11.resolve(moduleDir, "../scaffolds")
+  ];
+  const found = candidates.find((candidate) => existsSync(candidate));
+  return found ?? candidates[0];
+}
+function configSource(projectName) {
+  return `import { defineConfig } from "@caatinga/core";
+
+export default defineConfig({
+  project: "${projectName}",
+  defaultNetwork: "testnet",
+  contracts: {
+    verifier: {
+      path: "./contracts/verifier",
+      wasm: "./contracts/verifier/target/wasm32v1-none/release/verifier.wasm"
+    }
+  },
+  networks: {
+    testnet: {
+      rpcUrl: "https://soroban-testnet.stellar.org",
+      networkPassphrase: "Test SDF Network ; September 2015"
+    }
+  },
+  zk: {
+    circuits: {
+      main: {
+        path: "./circuits",
+        protocol: "groth16",
+        curve: "bls12381",
+        verifierContract: "verifier"
+      }
+    }
+  }
+});
+`;
+}
+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"
+    },
+    devDependencies: {
+      "@caatinga/cli": `^${CAATINGA_CORE_VERSION}`,
+      "@caatinga/core": `^${CAATINGA_CORE_VERSION}`
+    }
+  }, null, 2)}
+`;
+}
+function readmeSource(projectName) {
+  return `# ${projectName}
+
+Minimal Caatinga ZK project.
+
+## Workflow
+
+\`\`\`bash
+npm install
+npx caatinga zk build main
+npx caatinga build verifier
+npx caatinga deploy verifier --network testnet
+npx caatinga zk prove main
+\`\`\`
+
+Replace \`circuits/main.circom\` with your circuit. Keep the entry point named \`main\`.
+`;
+}
+async function createZkProject(options) {
+  const targetDir = path11.resolve(options.targetDir);
+  const force = options.force ?? false;
+  const projectFiles = options.projectFiles ?? true;
+  await mkdir4(targetDir, { recursive: true });
+  if (projectFiles) {
+    await Promise.all([
+      writeFile4(path11.join(targetDir, "caatinga.config.ts"), configSource(options.projectName), { encoding: "utf8", flag: force ? "w" : "wx" }),
+      writeFile4(path11.join(targetDir, "package.json"), packageJsonSource(options.projectName), { encoding: "utf8", flag: force ? "w" : "wx" }),
+      writeFile4(path11.join(targetDir, ".gitignore"), "node_modules\n.artifacts\ntarget\n", { encoding: "utf8", flag: force ? "w" : "wx" }),
+      writeFile4(path11.join(targetDir, "README.md"), readmeSource(options.projectName), { encoding: "utf8", flag: force ? "w" : "wx" })
+    ]);
+  }
+  await mkdir4(path11.join(targetDir, "contracts"), { recursive: true });
+  await cp2(path11.join(scaffoldRoot(), "zk-circuit-stub"), path11.join(targetDir, "circuits"), {
+    recursive: true,
+    force,
+    errorOnExist: !force
+  });
+  await cp2(path11.join(scaffoldRoot(), "zk-verifier"), path11.join(targetDir, "contracts", "verifier"), {
+    recursive: true,
+    force,
+    errorOnExist: !force
+  });
+  if (projectFiles) {
+    await writeArtifacts(createInitialArtifacts(options.projectName, { networks: ["testnet"] }), targetDir);
+  }
+  return { targetDir };
+}
+
 // src/ci/is-transient-testnet-smoke-failure.ts
 var NO_RETRY_CAATINGA_SUBSTRINGS = [
   "CAATINGA_UNSUPPORTED_CLI_VERSION",
@@ -1745,6 +1873,7 @@ export {
   collectProjectStatus,
   createInitialArtifacts,
   createProjectFromTemplate,
+  createZkProject,
   defineConfig,
   deployContract,
   deployContractGraph,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@caatinga/core",
-  "version": "2.3.0",
+  "version": "2.3.1",
   "description": "Core config, artifacts, command orchestration, and error primitives for Caatinga/Soroban toolkit",
   "keywords": [
     "stellar",
@@ -45,6 +45,7 @@
   },
   "files": [
     "dist",
+    "scaffolds",
     "README.md",
     "LICENSE"
   ],

package/scaffolds/zk-circuit-stub/input.json

@@ -0,0 +1,3 @@
+{
+  "a": "1"
+}

package/scaffolds/zk-circuit-stub/main.circom

@@ -0,0 +1,9 @@
+pragma circom 2.1.6;
+
+template Main() {
+    signal input a;
+    signal output b;
+    b <== a;
+}
+
+component main = Main();