@caatinga/core 0.2.1 → 0.2.2

package/dist/index.d.cts

@@ -1,58 +1,8 @@
+import { C as CaatingaArtifacts, a as ContractArtifact, b as CaatingaErrorCodeValue, c as CaatingaError } from './browser-DUcSR5D3.cjs';
+export { d as CaatingaArtifactsSchema, e as CaatingaErrorCode, t as toCaatingaError } from './browser-DUcSR5D3.cjs';
 import { z } from 'zod';
 
-declare const CaatingaErrorCode: {
-    readonly CONFIG_NOT_FOUND: "CAATINGA_CONFIG_NOT_FOUND";
-    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 UNTESTED_CLI_VERSION: "CAATINGA_UNTESTED_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 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 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 WALLET_NOT_CONNECTED: "CAATINGA_WALLET_NOT_CONNECTED";
-    readonly SOURCE_ACCOUNT_REQUIRED: "CAATINGA_SOURCE_ACCOUNT_REQUIRED";
-    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";
-};
-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;
-
-declare const CAATINGA_CORE_VERSION = "0.2.1";
+declare const CAATINGA_CORE_VERSION = "0.2.2";
 
 declare const ContractConfigSchema: z.ZodObject<{
     path: z.ZodString;
@@ -182,118 +132,6 @@ type LoadConfigOptions = {
 };
 declare function loadConfig(options?: LoadConfigOptions): Promise<CaatingaConfig>;
 
-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;
-    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[]>;
-    }>;
-    version: 1;
-}, {
-    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>;
-
 declare function readArtifacts(cwd?: string): Promise<CaatingaArtifacts>;
 
 declare function writeArtifacts(artifacts: CaatingaArtifacts, cwd?: string): Promise<string>;
@@ -333,7 +171,7 @@ declare function checkBinary(binary: string, hint: string, options?: CheckBinary
 
 declare function parseContractId(output: string): string;
 
-declare const STELLAR_CLI_MIN_VERSION = "22.0.0";
+declare const STELLAR_CLI_MIN_VERSION = "23.0.0";
 declare const STELLAR_CLI_TESTED_MAX_VERSION = "25.2.0";
 declare function parseStellarCliVersion(output: string): string;
 declare function assertSupportedStellarCliVersion(input: {
@@ -341,6 +179,8 @@ declare function assertSupportedStellarCliVersion(input: {
     allowUntested: boolean;
 }): string;
 
+declare function validateSourceShape(source: string): CaatingaError | undefined;
+
 type ResolvedContract = {
     name: string;
     config: ContractConfig;
@@ -356,7 +196,12 @@ type BuildContractOptions = {
     allowUntestedStellarCli?: boolean;
 };
 declare function buildContract(options: BuildContractOptions): Promise<{
-    contract: ResolvedContract;
+    contract: {
+        wasmPath: string;
+        name: string;
+        config: ContractConfig;
+        sourcePath: string;
+    };
     output: string;
 }>;
 
@@ -375,25 +220,57 @@ type DeployContractOptions = {
     cwd?: string;
     allowUntestedStellarCli?: boolean;
     force?: boolean;
+    checkStaleWasm?: boolean;
     resolvedDeployArgs?: Record<string, DeployArgValue>;
     dependencies?: string[];
 };
 declare function deployContract(options: DeployContractOptions): Promise<{
-    contract: ResolvedContract;
+    contract: {
+        wasmPath: string;
+        name: string;
+        config: ContractConfig;
+        sourcePath: string;
+    };
     network: ResolvedNetwork;
     contractId: string;
     artifactsPath: string;
     output: string;
     skipped: true;
+    staleWasmWarning: string | undefined;
 } | {
-    contract: ResolvedContract;
+    contract: {
+        wasmPath: string;
+        name: string;
+        config: ContractConfig;
+        sourcePath: string;
+    };
     network: ResolvedNetwork;
     contractId: string;
     artifactsPath: string;
     output: string;
     skipped: false;
+    staleWasmWarning: string | undefined;
 }>;
 
+type SkippedContract = {
+    name: string;
+    contractId: string;
+    network: string;
+    reason: "already-deployed";
+};
+type StaleWasmWarning = {
+    contract: string;
+    message: string;
+};
+type DeployContractGraphResult = {
+    network: ResolvedNetwork;
+    deployedContracts: Array<{
+        name: string;
+        contractId: string;
+    }>;
+    skippedContracts: SkippedContract[];
+    staleWasmWarnings: StaleWasmWarning[];
+};
 declare function deployContractGraph(options: {
     config: CaatingaConfig;
     contractName?: string;
@@ -403,13 +280,9 @@ declare function deployContractGraph(options: {
     includeDependencies: boolean;
     force: boolean;
     allowUntestedStellarCli?: boolean;
-}): Promise<{
-    network: ResolvedNetwork;
-    deployedContracts: {
-        name: string;
-        contractId: string;
-    }[];
-}>;
+    checkStaleWasm?: boolean;
+    verifyDeps?: boolean;
+}): Promise<DeployContractGraphResult>;
 
 declare function buildDependencyGraph(contracts: Record<string, ContractConfig>): Record<string, string[]>;
 
@@ -572,4 +445,4 @@ type TemplateManifest = z.infer<typeof TemplateManifestSchema>;
 
 declare function isTransientTestnetSmokeFailure(logText: string): boolean;
 
-export { type BuildContractOptions, CAATINGA_CORE_VERSION, type CaatingaArtifacts, CaatingaArtifactsSchema, type CaatingaConfig, CaatingaConfigSchema, CaatingaError, CaatingaErrorCode, type ContractArtifact, type ContractConfig, type CreateProjectFromTemplateOptions, type DeployArgValue, type DeployContractOptions, type GenerateBindingsOptions, type InvokeContractOptions, type InvokeTarget, type LoadConfigOptions, type NetworkConfig, type ResolvedContract, type ResolvedNetwork, type RunCommandResult, STELLAR_CLI_MIN_VERSION, STELLAR_CLI_TESTED_MAX_VERSION, type TemplateManifest, TemplateManifestSchema, WELL_KNOWN_NETWORKS, assertSupportedStellarCliVersion, buildContract, buildDependencyGraph, checkBinary, createInitialArtifacts, createProjectFromTemplate, defineConfig, deployContract, deployContractGraph, generateBindings, invokeContract, isTransientTestnetSmokeFailure, loadConfig, parseContractId, parseInvokeTarget, parseStellarCliVersion, readArtifacts, resolveContract, resolveDeployArgs, resolveDeployOrder, resolveNetwork, runCommand, toCaatingaError, updateArtifact, writeArtifacts };
+export { type BuildContractOptions, CAATINGA_CORE_VERSION, CaatingaArtifacts, type CaatingaConfig, CaatingaConfigSchema, CaatingaError, ContractArtifact, type ContractConfig, type CreateProjectFromTemplateOptions, type DeployArgValue, type DeployContractGraphResult, type DeployContractOptions, type GenerateBindingsOptions, type InvokeContractOptions, type InvokeTarget, type LoadConfigOptions, type NetworkConfig, type ResolvedContract, type ResolvedNetwork, type RunCommandResult, STELLAR_CLI_MIN_VERSION, STELLAR_CLI_TESTED_MAX_VERSION, type SkippedContract, type TemplateManifest, TemplateManifestSchema, WELL_KNOWN_NETWORKS, assertSupportedStellarCliVersion, buildContract, buildDependencyGraph, checkBinary, createInitialArtifacts, createProjectFromTemplate, defineConfig, deployContract, deployContractGraph, generateBindings, invokeContract, isTransientTestnetSmokeFailure, loadConfig, parseContractId, parseInvokeTarget, parseStellarCliVersion, readArtifacts, resolveContract, resolveDeployArgs, resolveDeployOrder, resolveNetwork, runCommand, updateArtifact, validateSourceShape, writeArtifacts };

package/dist/index.d.ts

@@ -1,58 +1,8 @@
+import { C as CaatingaArtifacts, a as ContractArtifact, b as CaatingaErrorCodeValue, c as CaatingaError } from './browser-DUcSR5D3.js';
+export { d as CaatingaArtifactsSchema, e as CaatingaErrorCode, t as toCaatingaError } from './browser-DUcSR5D3.js';
 import { z } from 'zod';
 
-declare const CaatingaErrorCode: {
-    readonly CONFIG_NOT_FOUND: "CAATINGA_CONFIG_NOT_FOUND";
-    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 UNTESTED_CLI_VERSION: "CAATINGA_UNTESTED_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 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 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 WALLET_NOT_CONNECTED: "CAATINGA_WALLET_NOT_CONNECTED";
-    readonly SOURCE_ACCOUNT_REQUIRED: "CAATINGA_SOURCE_ACCOUNT_REQUIRED";
-    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";
-};
-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;
-
-declare const CAATINGA_CORE_VERSION = "0.2.1";
+declare const CAATINGA_CORE_VERSION = "0.2.2";
 
 declare const ContractConfigSchema: z.ZodObject<{
     path: z.ZodString;
@@ -182,118 +132,6 @@ type LoadConfigOptions = {
 };
 declare function loadConfig(options?: LoadConfigOptions): Promise<CaatingaConfig>;
 
-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;
-    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[]>;
-    }>;
-    version: 1;
-}, {
-    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>;
-
 declare function readArtifacts(cwd?: string): Promise<CaatingaArtifacts>;
 
 declare function writeArtifacts(artifacts: CaatingaArtifacts, cwd?: string): Promise<string>;
@@ -333,7 +171,7 @@ declare function checkBinary(binary: string, hint: string, options?: CheckBinary
 
 declare function parseContractId(output: string): string;
 
-declare const STELLAR_CLI_MIN_VERSION = "22.0.0";
+declare const STELLAR_CLI_MIN_VERSION = "23.0.0";
 declare const STELLAR_CLI_TESTED_MAX_VERSION = "25.2.0";
 declare function parseStellarCliVersion(output: string): string;
 declare function assertSupportedStellarCliVersion(input: {
@@ -341,6 +179,8 @@ declare function assertSupportedStellarCliVersion(input: {
     allowUntested: boolean;
 }): string;
 
+declare function validateSourceShape(source: string): CaatingaError | undefined;
+
 type ResolvedContract = {
     name: string;
     config: ContractConfig;
@@ -356,7 +196,12 @@ type BuildContractOptions = {
     allowUntestedStellarCli?: boolean;
 };
 declare function buildContract(options: BuildContractOptions): Promise<{
-    contract: ResolvedContract;
+    contract: {
+        wasmPath: string;
+        name: string;
+        config: ContractConfig;
+        sourcePath: string;
+    };
     output: string;
 }>;
 
@@ -375,25 +220,57 @@ type DeployContractOptions = {
     cwd?: string;
     allowUntestedStellarCli?: boolean;
     force?: boolean;
+    checkStaleWasm?: boolean;
     resolvedDeployArgs?: Record<string, DeployArgValue>;
     dependencies?: string[];
 };
 declare function deployContract(options: DeployContractOptions): Promise<{
-    contract: ResolvedContract;
+    contract: {
+        wasmPath: string;
+        name: string;
+        config: ContractConfig;
+        sourcePath: string;
+    };
     network: ResolvedNetwork;
     contractId: string;
     artifactsPath: string;
     output: string;
     skipped: true;
+    staleWasmWarning: string | undefined;
 } | {
-    contract: ResolvedContract;
+    contract: {
+        wasmPath: string;
+        name: string;
+        config: ContractConfig;
+        sourcePath: string;
+    };
     network: ResolvedNetwork;
     contractId: string;
     artifactsPath: string;
     output: string;
     skipped: false;
+    staleWasmWarning: string | undefined;
 }>;
 
+type SkippedContract = {
+    name: string;
+    contractId: string;
+    network: string;
+    reason: "already-deployed";
+};
+type StaleWasmWarning = {
+    contract: string;
+    message: string;
+};
+type DeployContractGraphResult = {
+    network: ResolvedNetwork;
+    deployedContracts: Array<{
+        name: string;
+        contractId: string;
+    }>;
+    skippedContracts: SkippedContract[];
+    staleWasmWarnings: StaleWasmWarning[];
+};
 declare function deployContractGraph(options: {
     config: CaatingaConfig;
     contractName?: string;
@@ -403,13 +280,9 @@ declare function deployContractGraph(options: {
     includeDependencies: boolean;
     force: boolean;
     allowUntestedStellarCli?: boolean;
-}): Promise<{
-    network: ResolvedNetwork;
-    deployedContracts: {
-        name: string;
-        contractId: string;
-    }[];
-}>;
+    checkStaleWasm?: boolean;
+    verifyDeps?: boolean;
+}): Promise<DeployContractGraphResult>;
 
 declare function buildDependencyGraph(contracts: Record<string, ContractConfig>): Record<string, string[]>;
 
@@ -572,4 +445,4 @@ type TemplateManifest = z.infer<typeof TemplateManifestSchema>;
 
 declare function isTransientTestnetSmokeFailure(logText: string): boolean;
 
-export { type BuildContractOptions, CAATINGA_CORE_VERSION, type CaatingaArtifacts, CaatingaArtifactsSchema, type CaatingaConfig, CaatingaConfigSchema, CaatingaError, CaatingaErrorCode, type ContractArtifact, type ContractConfig, type CreateProjectFromTemplateOptions, type DeployArgValue, type DeployContractOptions, type GenerateBindingsOptions, type InvokeContractOptions, type InvokeTarget, type LoadConfigOptions, type NetworkConfig, type ResolvedContract, type ResolvedNetwork, type RunCommandResult, STELLAR_CLI_MIN_VERSION, STELLAR_CLI_TESTED_MAX_VERSION, type TemplateManifest, TemplateManifestSchema, WELL_KNOWN_NETWORKS, assertSupportedStellarCliVersion, buildContract, buildDependencyGraph, checkBinary, createInitialArtifacts, createProjectFromTemplate, defineConfig, deployContract, deployContractGraph, generateBindings, invokeContract, isTransientTestnetSmokeFailure, loadConfig, parseContractId, parseInvokeTarget, parseStellarCliVersion, readArtifacts, resolveContract, resolveDeployArgs, resolveDeployOrder, resolveNetwork, runCommand, toCaatingaError, updateArtifact, writeArtifacts };
+export { type BuildContractOptions, CAATINGA_CORE_VERSION, CaatingaArtifacts, type CaatingaConfig, CaatingaConfigSchema, CaatingaError, ContractArtifact, type ContractConfig, type CreateProjectFromTemplateOptions, type DeployArgValue, type DeployContractGraphResult, type DeployContractOptions, type GenerateBindingsOptions, type InvokeContractOptions, type InvokeTarget, type LoadConfigOptions, type NetworkConfig, type ResolvedContract, type ResolvedNetwork, type RunCommandResult, STELLAR_CLI_MIN_VERSION, STELLAR_CLI_TESTED_MAX_VERSION, type SkippedContract, type TemplateManifest, TemplateManifestSchema, WELL_KNOWN_NETWORKS, assertSupportedStellarCliVersion, buildContract, buildDependencyGraph, checkBinary, createInitialArtifacts, createProjectFromTemplate, defineConfig, deployContract, deployContractGraph, generateBindings, invokeContract, isTransientTestnetSmokeFailure, loadConfig, parseContractId, parseInvokeTarget, parseStellarCliVersion, readArtifacts, resolveContract, resolveDeployArgs, resolveDeployOrder, resolveNetwork, runCommand, updateArtifact, validateSourceShape, writeArtifacts };