@caatinga/core 2.4.5 → 3.0.1

package/dist/index.js

@@ -48,7 +48,8 @@ var CaatingaErrorCode = {
   TEMPLATE_MANIFEST_NOT_FOUND: "CAATINGA_TEMPLATE_MANIFEST_NOT_FOUND",
   TEMPLATE_INCOMPATIBLE: "CAATINGA_TEMPLATE_INCOMPATIBLE",
   ZK_VERIFICATION_FAILED: "CAATINGA_ZK_VERIFICATION_FAILED",
-  DOCTOR_PARTIAL_DEPLOY: "CAATINGA_DOCTOR_PARTIAL_DEPLOY"
+  DOCTOR_PARTIAL_DEPLOY: "CAATINGA_DOCTOR_PARTIAL_DEPLOY",
+  MULTI_AUTH_REQUIRED: "CAATINGA_MULTI_AUTH_REQUIRED"
 };
 
 // src/errors/CaatingaError.ts
@@ -120,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
@@ -769,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)) {
@@ -828,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}`);
 }
@@ -988,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;
 }
@@ -1404,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(
@@ -1476,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({
@@ -1499,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 });
     }
@@ -1517,9 +1519,19 @@ async function deployContractGraph(options) {
 // src/contracts/generate-bindings.ts
 import { access as access3, mkdir as mkdir2, unlink } from "fs/promises";
 import path10 from "path";
+
+// src/contracts/build-generate-network-args.ts
+function buildGenerateNetworkArgs(network) {
+  if (WELL_KNOWN_NETWORKS[network.name]) {
+    return ["--network", network.name, "--rpc-url", network.config.rpcUrl];
+  }
+  return ["--rpc-url", network.config.rpcUrl];
+}
+
+// src/contracts/generate-bindings.ts
 function toBindingImportPath(bindingsOutput, contractName) {
   const normalized = bindingsOutput.replace(/^\.\//, "").split(path10.sep).join("/");
-  return `./${path10.posix.join(normalized, contractName, "src", "index.js")}`;
+  return `./${path10.posix.join(normalized, contractName)}`;
 }
 async function removeLegacyBindingStub(cwd, bindingsOutput, contractName) {
   const legacyPath = path10.resolve(cwd, bindingsOutput, `${contractName}.ts`);
@@ -1550,23 +1562,28 @@ async function generateBindings(options) {
       "Run caatinga deploy for this contract and network before generating bindings."
     );
   }
-  await checkBinary("stellar", "Install Stellar CLI before running caatinga generate.");
   const outputDir = path10.resolve(cwd, options.config.frontend.bindingsOutput, options.contractName);
   await mkdir2(outputDir, { recursive: true });
-  const result = await runCommand("stellar", [
-    "contract",
-    "bindings",
-    "typescript",
-    "--contract-id",
-    contractArtifact.contractId,
-    "--output-dir",
-    outputDir,
-    "--overwrite",
-    ...buildStellarNetworkArgs(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,
@@ -1678,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(
@@ -1837,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);
@@ -1876,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;
@@ -1919,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);
@@ -1945,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
@@ -2003,23 +2017,27 @@ 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"
+      },
+      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) {
@@ -2047,10 +2065,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 });
@@ -2059,13 +2089,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 };
 }
@@ -2106,23 +2143,27 @@ 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",
+        "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) {
@@ -2158,18 +2199,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/dist/runtime/requirements.cjs

@@ -90,7 +90,8 @@ var CaatingaErrorCode = {
   TEMPLATE_MANIFEST_NOT_FOUND: "CAATINGA_TEMPLATE_MANIFEST_NOT_FOUND",
   TEMPLATE_INCOMPATIBLE: "CAATINGA_TEMPLATE_INCOMPATIBLE",
   ZK_VERIFICATION_FAILED: "CAATINGA_ZK_VERIFICATION_FAILED",
-  DOCTOR_PARTIAL_DEPLOY: "CAATINGA_DOCTOR_PARTIAL_DEPLOY"
+  DOCTOR_PARTIAL_DEPLOY: "CAATINGA_DOCTOR_PARTIAL_DEPLOY",
+  MULTI_AUTH_REQUIRED: "CAATINGA_MULTI_AUTH_REQUIRED"
 };
 
 // src/errors/CaatingaError.ts

package/dist/runtime/requirements.js

@@ -53,7 +53,8 @@ var CaatingaErrorCode = {
   TEMPLATE_MANIFEST_NOT_FOUND: "CAATINGA_TEMPLATE_MANIFEST_NOT_FOUND",
   TEMPLATE_INCOMPATIBLE: "CAATINGA_TEMPLATE_INCOMPATIBLE",
   ZK_VERIFICATION_FAILED: "CAATINGA_ZK_VERIFICATION_FAILED",
-  DOCTOR_PARTIAL_DEPLOY: "CAATINGA_DOCTOR_PARTIAL_DEPLOY"
+  DOCTOR_PARTIAL_DEPLOY: "CAATINGA_DOCTOR_PARTIAL_DEPLOY",
+  MULTI_AUTH_REQUIRED: "CAATINGA_MULTI_AUTH_REQUIRED"
 };
 
 // src/errors/CaatingaError.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@caatinga/core",
-  "version": "2.4.5",
+  "version": "3.0.1",
   "description": "Core config, artifacts, command orchestration, and error primitives for Caatinga/Soroban toolkit",
   "keywords": [
     "stellar",
@@ -20,7 +20,7 @@
   "author": "Caatinga contributors",
   "license": "MIT",
   "engines": {
-    "node": ">=20"
+    "node": ">=22"
   },
   "type": "module",
   "main": "./dist/index.cjs",