@xo-cash/utils 0.0.1-development.13987669945

package/dist/index.d.mts

@@ -0,0 +1,1346 @@
+import { z } from "zod";
+import { $ZodIssue } from "zod/v4/core";
+import { XOTemplate } from "@xo-cash/types";
+
+//#region source/extended-json.d.ts
+/**
+ * The JSON replacer that encodes `bigint` and `Uint8Array` values in Extended JSON format,
+ * compatible with the format expected by `extendedJsonReviver`.
+ *
+ * - BigInts are encoded as `<bigint: 123n>`.
+ * - Uint8Arrays are encoded as `<uint8array: abcd>`.
+ * All other values pass through unchanged and if any incompatible type is encountered, an error is thrown.
+ *
+ * Note: To use this function, pass it as the second argument to `JSON.stringify` when serializing data.
+ *
+ * Note to developers: Libauth's `stringify` is the replacer. It also serializes functions and symbols,
+ * which we do not support. Passing it would let templates include those values, but revival would then fail.
+ * This module provides a dedicated replacer and reviver so serialization and deserialization stay aligned.
+ *
+ * @param _propertyKey The property key being serialized, required by the `JSON.stringify` replacer but not used here.
+ * @param value The value to encode or pass through unchanged.
+ * @returns The encoded string
+ */
+declare const extendedJsonReplacer: (_propertyKey: string, value: unknown) => unknown;
+/**
+ * The JSON reviver that reconstructs `bigint` and `Uint8Array` values encoded by `extendedJsonReplacer`.
+ *
+ * Note: To use this function, pass it as the second argument to `JSON.parse` when deserializing data.
+ *
+ * @param _propertyKey The property key being deserialized, required by the `JSON.parse` reviver but not used here.
+ * @param value The value to reconstruct or pass through unchanged.
+ * @returns The reconstructed value
+ */
+declare const extendedJsonReviver: (_propertyKey: string, value: unknown) => unknown;
+//#endregion
+//#region source/script.d.ts
+/**
+ * Converts a script to a scriptHash.
+ * @param {Uint8Array} script - The script to convert.
+ * @returns {string} The scriptHash as a reversed hex string.
+ */
+declare const scriptToScriptHash: (script: Uint8Array) => string;
+//#endregion
+//#region source/template/errors.d.ts
+/**
+ * Formats the Zod validation failures into a single string with one line each: "- <field>: <message>" and top level failures
+ * with no field path show as "(root)" for better readability.
+ *
+ * @param issues The Zod validation failures to format.
+ * @returns A human readable error string for better debugging.
+ */
+declare const buildErrorDescription: (issues: $ZodIssue[]) => string;
+/**
+ * Thrown when the provided template does not satisfy the XOTemplate schema.
+ */
+declare class TemplateInvalidError extends Error {
+  constructor(details: string);
+}
+/**
+ * Thrown when a string passed to `deserializeTemplate` cannot be parsed as JSON.
+ */
+declare class TemplateJsonMalformedError extends Error {
+  constructor(reason: string);
+}
+/**
+ * Thrown when `serializeTemplate` fails to produce a JSON string from the template.
+ */
+declare class TemplateSerializationFailedError extends Error {
+  constructor(reason: string);
+}
+//#endregion
+//#region source/template/identifier.d.ts
+/**
+ * Generates a deterministic template identifier by hashing the template.
+ *
+ * Note: This expects a template that has been validated by `parseTemplate`.
+ *
+ * @param template - The template to generate an identifier for.
+ * @returns The sha256 hex identifier for the template.
+ */
+declare const generateTemplateIdentifier: (template: XOTemplate) => string;
+//#endregion
+//#region source/template/parser.d.ts
+/**
+ * Accepts a template value and returns a validated XOTemplate object. The input may be
+ * either an Extended JSON string or a pre-parsed object. Both are validated
+ * against the XOTemplate schema.
+ *
+ * @param inputTemplate - The value to validate. May be an Extended JSON string or a pre-parsed object.
+ * @returns The validated template object
+ * @throws {TemplateSerializationFailedError} If a pre-parsed object input cannot be serialized to JSON for normalization.
+ * @throws {TemplateJsonMalformedError} If the string input is not valid JSON.
+ * @throws {TemplateInvalidError} If the value does not conform to the XOTemplate schema.
+ */
+declare const parseTemplate: (inputTemplate: string | XOTemplate) => XOTemplate;
+//#endregion
+//#region source/template/schemas.d.ts
+/**
+ * Validation schema for a BCH VM version identifier. Defines the set of known BCH VM versions
+ * that XO templates declare support for.
+ *
+ * Zod's `z.enum` requires the exact values to be defined inline because it needs to know each
+ * specific value at compile time to validate against them. Defining the versions here directly
+ * satisfies that requirement and allows `z.array(bchVmVersionSchema)` to be used elsewhere
+ *
+ * ```
+ * {
+ *   "supported": [ "BCH_2025_05" ]  ← each value
+ * }
+ * ```
+ */
+declare const bchVmVersionSchema: z.ZodEnum<{
+  BCH_2020_05: "BCH_2020_05";
+  BCH_2021_05: "BCH_2021_05";
+  BCH_2022_05: "BCH_2022_05";
+  BCH_2023_05: "BCH_2023_05";
+  BCH_2024_05: "BCH_2024_05";
+  BCH_2025_05: "BCH_2025_05";
+  BCH_2026_05: "BCH_2026_05";
+}>;
+/**
+ * Validation schema for the capability of a non-fungible token. Defines the three capability
+ * types supported on BCH: minting tokens can create new NFTs, mutable tokens can update their
+ * commitment, and none tokens cannot be changed after creation.
+ *
+ * ```
+ * {
+ *   "inputs|outputs": {
+ *     "[id]": {
+ *       "token": {
+ *         "nft": {
+ *           "capability": "minting"  ← this schema
+ *         }
+ *       }
+ *     }
+ *   }
+ * }
+ * ```
+ */
+declare const xoTemplateNftCapabilitySchema: z.ZodEnum<{
+  minting: "minting";
+  mutable: "mutable";
+  none: "none";
+}>;
+/**
+ * Validation schema for a BCH locking script type. Defines the standard locking script types
+ * supported on BCH.
+ *
+ * ```
+ * {
+ *   "lockingScripts": {
+ *     "[id]": {
+ *       "lockingType": "p2pkh"  ← this schema
+ *     }
+ *   }
+ * }
+ * ```
+ */
+declare const xoTemplateLockingTypeSchema: z.ZodEnum<{
+  p2s: "p2s";
+  p2pkh: "p2pkh";
+  p2sh: "p2sh";
+}>;
+/**
+ * Validation schema for a primitive type identifier. Defines the set of primitive types
+ * that can be declared in an XO template. Used by constants, variables, and data fields.
+ */
+declare const xoTemplatePrimitiveTypeSchema: z.ZodEnum<{
+  string: "string";
+  bigint: "bigint";
+  boolean: "boolean";
+  bytes: "bytes";
+  integer: "integer";
+  private_key: "private_key";
+  public_key: "public_key";
+}>;
+/**
+ * Validation schema for byte array fields i.e. Uint8Array instance.
+ */
+declare const uint8ArraySchema: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
+/**
+ * Validation schema for the Satoshis type i.e. bigint.
+ */
+declare const satoshisSchema: z.ZodBigInt;
+/** Maximum character length for name fields on view properties. */
+declare const VIEW_PROPERTIES_NAME_MAX_LENGTH = 200;
+/** Maximum character length for description fields on view properties. */
+declare const VIEW_PROPERTIES_DESCRIPTION_MAX_LENGTH = 5000;
+/** Maximum character length for icon fields on view properties. */
+declare const VIEW_PROPERTIES_ICON_MAX_LENGTH = 50;
+/**
+ * Validation schema for view properties shared across many template elements i.e. name, description, icon.
+ * Extended by most other schemas in this file.
+ */
+declare const xoTemplateViewPropertiesSchema: z.ZodObject<{
+  name: z.ZodString;
+  description: z.ZodString;
+  icon: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/**
+ * Validation schema for the base intent structure. Describes the common data parameters shared
+ * by all intent types regardless of what they target.
+ *
+ * An optional templateIdentifier allows the intent to reference a target defined in a different
+ * template, enabling cross-template interaction.
+ *
+ * Extended by: xoTemplateActionIntentSchema, xoTemplateOutputIntentSchema,
+ * xoTemplateLockingScriptIntentSchema.
+ */
+declare const xoTemplateIntentSchema: z.ZodObject<{
+  templateIdentifier: z.ZodOptional<z.ZodString>;
+  role: z.ZodOptional<z.ZodString>;
+  generate: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  variables: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+  constants: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+  secrets: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+}, z.core.$strict>;
+/**
+ * Validation schema for an action intent. Extends the base intent structure with an action
+ * identifier. Used in locking script action lists and in the template's start array.
+ *
+ * ```
+ * {
+ *   "start": [
+ *     { "action": "..." }  ← this schema
+ *   ],
+ *   "lockingScripts": {
+ *     "[id]": {
+ *       "actions": [
+ *         { "action": "..." }  ← this schema
+ *       ],
+ *       "roles": {
+ *         "[roleId]": {
+ *           "actions": [
+ *             { "action": "..." }  ← this schema
+ *           ]
+ *         }
+ *       }
+ *     }
+ *   }
+ * }
+ * ```
+ */
+declare const xoTemplateActionIntentSchema: z.ZodObject<{
+  templateIdentifier: z.ZodOptional<z.ZodString>;
+  role: z.ZodOptional<z.ZodString>;
+  generate: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  variables: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+  constants: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+  secrets: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+  action: z.ZodString;
+}, z.core.$strict>;
+/**
+ * Validation schema for an output intent. Extends the base intent structure with an output
+ * identifier. Used in the template's defaults block.
+ *
+ * ```
+ * {
+ *   "defaults": {
+ *     "change": { "output": "..." }  ← this schema
+ *   }
+ * }
+ * ```
+ */
+declare const xoTemplateOutputIntentSchema: z.ZodObject<{
+  templateIdentifier: z.ZodOptional<z.ZodString>;
+  role: z.ZodOptional<z.ZodString>;
+  generate: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  variables: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+  constants: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+  secrets: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+  output: z.ZodString;
+}, z.core.$strict>;
+/**
+ * Validation schema for a locking script intent. Extends the base intent structure with
+ * a locking script identifier.
+ *
+ * @todo The location of this schema in the template JSON is not yet determined.
+ */
+declare const xoTemplateLockingScriptIntentSchema: z.ZodObject<{
+  templateIdentifier: z.ZodOptional<z.ZodString>;
+  role: z.ZodOptional<z.ZodString>;
+  generate: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  variables: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+  constants: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+  secrets: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+  lockingScript: z.ZodString;
+}, z.core.$strict>;
+/**
+ * Validation schema for the slot count configuration on a role requirement. Declares how many
+ * participants of a given role are needed. min sets the lower bound and max sets the upper bound.
+ * When max is absent, there is no upper limit.
+ *
+ * ```
+ * {
+ *   "actions": {
+ *     "[id]": {
+ *       "requirements": {
+ *         "participants": [
+ *           { "slots": { "min": 1, "max": 1 } }  ← this schema
+ *         ]
+ *       }
+ *     }
+ *   }
+ * }
+ * ```
+ */
+declare const xoTemplateRoleSlotsRequirementsSchema: z.ZodObject<{
+  min: z.ZodNumber;
+  max: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+/**
+ * Validation schema for the capability requirements declared on a role within an action.
+ * Describes what data, secrets, or state the role is responsible for providing when participating in an action.
+ *
+ * ```
+ * {
+ *   "actions": {
+ *     "[id]": {
+ *       "roles": {
+ *         "[roleId]": {
+ *           "requirements": { "variables": [], "secrets": [] }  ← this schema
+ *         }
+ *       }
+ *     }
+ *   }
+ * }
+ * ```
+ */
+declare const xoTemplateActionRoleRequirementsSchema: z.ZodObject<{
+  variables: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  secrets: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+/**
+ * Validation schema for a role-specific definition within an action.
+ * All view properties are optional.
+ *
+ * ```
+ * {
+ *   "actions": {
+ *     "[id]": {
+ *       "roles": {
+ *         "[roleId]": { }  ← this schema
+ *       }
+ *     }
+ *   }
+ * }
+ * ```
+ */
+declare const xoTemplateActionRoleSchema: z.ZodObject<{
+  name: z.ZodOptional<z.ZodString>;
+  description: z.ZodOptional<z.ZodString>;
+  icon: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+  generate: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  requirements: z.ZodOptional<z.ZodObject<{
+    variables: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    secrets: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  }, z.core.$strict>>;
+}, z.core.$strict>;
+/**
+ * Validation schema for a role participation requirement in an action's requirements block.
+ *
+ * ```
+ * {
+ *   "actions": {
+ *     "[id]": {
+ *       "requirements": {
+ *         "participants": [
+ *           { "role": "...", "slots": { } }  ← this schema
+ *         ]
+ *       }
+ *     }
+ *   }
+ * }
+ * ```
+ */
+declare const xoTemplateRoleSlotSchema: z.ZodObject<{
+  role: z.ZodString;
+  slots: z.ZodObject<{
+    min: z.ZodNumber;
+    max: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strict>;
+}, z.core.$strict>;
+/**
+ * Validation schema for the requirements of an action.
+ *
+ * ```
+ * {
+ *   "actions": {
+ *     "[id]": {
+ *       "requirements": { "participants": [], "secrets": [] }  ← this schema
+ *     }
+ *   }
+ * }
+ * ```
+ */
+declare const xoTemplateActionRequirementsSchema: z.ZodObject<{
+  participants: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    role: z.ZodString;
+    slots: z.ZodObject<{
+      min: z.ZodNumber;
+      max: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>;
+  }, z.core.$strict>>>;
+  secrets: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+/**
+ * Validation schema for an action definition.
+ *
+ * ```
+ * {
+ *   "actions": {
+ *     "[id]": { }  ← this schema
+ *   }
+ * }
+ * ```
+ */
+declare const xoTemplateActionSchema: z.ZodObject<{
+  name: z.ZodString;
+  description: z.ZodString;
+  icon: z.ZodOptional<z.ZodString>;
+  roles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    generate: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    requirements: z.ZodOptional<z.ZodObject<{
+      variables: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      secrets: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+  }, z.core.$strict>>>;
+  requirements: z.ZodOptional<z.ZodObject<{
+    participants: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      role: z.ZodString;
+      slots: z.ZodObject<{
+        min: z.ZodNumber;
+        max: z.ZodOptional<z.ZodNumber>;
+      }, z.core.$strict>;
+    }, z.core.$strict>>>;
+    secrets: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  }, z.core.$strict>>;
+  conditions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  transaction: z.ZodOptional<z.ZodString>;
+  data: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/**
+ * Validation schema for the non-fungible token configuration within a token field.
+ *
+ * ```
+ * {
+ *   "inputs|outputs": {
+ *     "[id]": {
+ *       "token": {
+ *         "nft": { }  ← this schema
+ *       }
+ *     }
+ *   }
+ * }
+ * ```
+ */
+declare const xoTemplateNonFungibleTokenDetailsSchema: z.ZodObject<{
+  capability: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+    minting: "minting";
+    mutable: "mutable";
+    none: "none";
+  }>, z.ZodString]>>;
+  commitment: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/**
+ * Validation schema for the token configuration on inputs and outputs.
+ *
+ * ```
+ * {
+ *   "inputs|outputs": {
+ *     "[id]": {
+ *       "token": { }  ← this schema
+ *     }
+ *   }
+ * }
+ * ```
+ */
+declare const xoTemplateTokenSchema: z.ZodObject<{
+  category: z.ZodOptional<z.ZodString>;
+  amount: z.ZodOptional<z.ZodUnion<readonly [z.ZodBigInt, z.ZodString, z.ZodNull]>>;
+  nft: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    capability: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+      minting: "minting";
+      mutable: "mutable";
+      none: "none";
+    }>, z.ZodString]>>;
+    commitment: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>>>;
+}, z.core.$strict>;
+/**
+ * Validation schema for the asset amounts configuration. Used by omitChangeAmounts on inputs
+ * and by balance on locking scripts, outputs, and their roles.
+ */
+declare const xoTemplateAssetAmountsSchema: z.ZodObject<{
+  satoshis: z.ZodOptional<z.ZodUnion<readonly [z.ZodBigInt, z.ZodString, z.ZodLiteral<true>]>>;
+  fungibleTokens: z.ZodOptional<z.ZodUnion<readonly [z.ZodBigInt, z.ZodString, z.ZodLiteral<true>]>>;
+  nonfungibleTokens: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodString, z.ZodLiteral<true>]>>;
+}, z.core.$strict>;
+/**
+ * Validation schema for the state configuration shared by a locking script and its individual roles.
+ * Declares which variables and secrets are tracked in the on-chain state for a given participant.
+ *
+ * ```
+ * {
+ *   "lockingScripts": {
+ *     "[id]": {
+ *       "state": { "variables": [], "secrets": [] }  ← this schema
+ *       "roles": {
+ *         "[roleId]": {
+ *           "state": { "variables": [], "secrets": [] }  ← this schema
+ *         }
+ *       }
+ *     }
+ *   }
+ * }
+ * ```
+ */
+declare const xoTemplateStateSchema: z.ZodObject<{
+  variables: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  secrets: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+/**
+ * Validation schema for a role definition for a locking script.
+ *
+ * ```
+ * {
+ *   "lockingScripts": {
+ *     "[id]": {
+ *       "roles": {
+ *         "[roleId]": { }  ← this schema
+ *       }
+ *     }
+ *   }
+ * }
+ * ```
+ */
+declare const xoTemplateLockingScriptRoleSchema: z.ZodObject<{
+  name: z.ZodOptional<z.ZodString>;
+  description: z.ZodOptional<z.ZodString>;
+  icon: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+  state: z.ZodOptional<z.ZodObject<{
+    variables: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    secrets: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  }, z.core.$strict>>;
+  actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    templateIdentifier: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodString>;
+    generate: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    variables: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    constants: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    secrets: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    action: z.ZodString;
+  }, z.core.$strict>>>;
+  balance: z.ZodOptional<z.ZodObject<{
+    satoshis: z.ZodOptional<z.ZodOptional<z.ZodUnion<readonly [z.ZodBigInt, z.ZodString, z.ZodLiteral<true>]>>>;
+    fungibleTokens: z.ZodOptional<z.ZodOptional<z.ZodUnion<readonly [z.ZodBigInt, z.ZodString, z.ZodLiteral<true>]>>>;
+    nonfungibleTokens: z.ZodOptional<z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodString, z.ZodLiteral<true>]>>>;
+  }, z.core.$strict>>;
+  selectable: z.ZodOptional<z.ZodBoolean>;
+  privacy: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+}, z.core.$strict>;
+/**
+ * Validation schema for a locking script definition.
+ *
+ * ```
+ * {
+ *   "lockingScripts": {
+ *     "[id]": { }  ← this schema
+ *   }
+ * }
+ * ```
+ */
+declare const xoTemplateLockingScriptSchema: z.ZodObject<{
+  name: z.ZodString;
+  description: z.ZodString;
+  icon: z.ZodOptional<z.ZodString>;
+  lockingType: z.ZodOptional<z.ZodEnum<{
+    p2s: "p2s";
+    p2pkh: "p2pkh";
+    p2sh: "p2sh";
+  }>>;
+  lockingBytecode: z.ZodString;
+  unlockingBytecode: z.ZodOptional<z.ZodString>;
+  actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    templateIdentifier: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodString>;
+    generate: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    variables: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    constants: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    secrets: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    action: z.ZodString;
+  }, z.core.$strict>>>;
+  state: z.ZodOptional<z.ZodObject<{
+    variables: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    secrets: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  }, z.core.$strict>>;
+  balance: z.ZodOptional<z.ZodObject<{
+    satoshis: z.ZodOptional<z.ZodOptional<z.ZodUnion<readonly [z.ZodBigInt, z.ZodString, z.ZodLiteral<true>]>>>;
+    fungibleTokens: z.ZodOptional<z.ZodOptional<z.ZodUnion<readonly [z.ZodBigInt, z.ZodString, z.ZodLiteral<true>]>>>;
+    nonfungibleTokens: z.ZodOptional<z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodString, z.ZodLiteral<true>]>>>;
+  }, z.core.$strict>>;
+  selectable: z.ZodOptional<z.ZodBoolean>;
+  privacy: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+  roles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    state: z.ZodOptional<z.ZodObject<{
+      variables: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      secrets: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+    actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      templateIdentifier: z.ZodOptional<z.ZodString>;
+      role: z.ZodOptional<z.ZodString>;
+      generate: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      variables: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+      constants: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+      secrets: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+      action: z.ZodString;
+    }, z.core.$strict>>>;
+    balance: z.ZodOptional<z.ZodObject<{
+      satoshis: z.ZodOptional<z.ZodOptional<z.ZodUnion<readonly [z.ZodBigInt, z.ZodString, z.ZodLiteral<true>]>>>;
+      fungibleTokens: z.ZodOptional<z.ZodOptional<z.ZodUnion<readonly [z.ZodBigInt, z.ZodString, z.ZodLiteral<true>]>>>;
+      nonfungibleTokens: z.ZodOptional<z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodString, z.ZodLiteral<true>]>>>;
+    }, z.core.$strict>>;
+    selectable: z.ZodOptional<z.ZodBoolean>;
+    privacy: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+  }, z.core.$strict>>>;
+}, z.core.$strict>;
+/**
+ * Validation schema for an input definition in the template. Extends view properties with optional
+ * satoshi value, token configuration, and other transaction level fields.
+ *
+ * ```
+ * {
+ *   "inputs": {
+ *     "[id]": { }  ← this schema
+ *   }
+ * }
+ * ```
+ */
+declare const xoTemplateInputSchema: z.ZodObject<{
+  name: z.ZodString;
+  description: z.ZodString;
+  icon: z.ZodOptional<z.ZodString>;
+  valueSatoshis: z.ZodOptional<z.ZodUnion<readonly [z.ZodBigInt, z.ZodString]>>;
+  token: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    category: z.ZodOptional<z.ZodString>;
+    amount: z.ZodOptional<z.ZodUnion<readonly [z.ZodBigInt, z.ZodString, z.ZodNull]>>;
+    nft: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+      capability: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+        minting: "minting";
+        mutable: "mutable";
+        none: "none";
+      }>, z.ZodString]>>;
+      commitment: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+  }, z.core.$strict>>>;
+  sequenceNumber: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+  unlockingScript: z.ZodOptional<z.ZodString>;
+  omitChangeAmounts: z.ZodOptional<z.ZodObject<{
+    satoshis: z.ZodOptional<z.ZodUnion<readonly [z.ZodBigInt, z.ZodString, z.ZodLiteral<true>]>>;
+    fungibleTokens: z.ZodOptional<z.ZodUnion<readonly [z.ZodBigInt, z.ZodString, z.ZodLiteral<true>]>>;
+    nonfungibleTokens: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodString, z.ZodLiteral<true>]>>;
+  }, z.core.$strict>>;
+}, z.core.$strict>;
+/**
+ * Validation schema for an output definition. Extends the locking script schema so that
+ * every output inherits the same locking script fields and adds output-specific fields.
+ *
+ * ```
+ * {
+ *   "outputs": {
+ *     "[id]": { }  ← this schema
+ *   }
+ * }
+ * ```
+ */
+declare const xoTemplateOutputSchema: z.ZodObject<{
+  name: z.ZodString;
+  description: z.ZodString;
+  icon: z.ZodOptional<z.ZodString>;
+  roles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    state: z.ZodOptional<z.ZodObject<{
+      variables: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      secrets: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+    actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      templateIdentifier: z.ZodOptional<z.ZodString>;
+      role: z.ZodOptional<z.ZodString>;
+      generate: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      variables: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+      constants: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+      secrets: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+      action: z.ZodString;
+    }, z.core.$strict>>>;
+    balance: z.ZodOptional<z.ZodObject<{
+      satoshis: z.ZodOptional<z.ZodOptional<z.ZodUnion<readonly [z.ZodBigInt, z.ZodString, z.ZodLiteral<true>]>>>;
+      fungibleTokens: z.ZodOptional<z.ZodOptional<z.ZodUnion<readonly [z.ZodBigInt, z.ZodString, z.ZodLiteral<true>]>>>;
+      nonfungibleTokens: z.ZodOptional<z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodString, z.ZodLiteral<true>]>>>;
+    }, z.core.$strict>>;
+    selectable: z.ZodOptional<z.ZodBoolean>;
+    privacy: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+  }, z.core.$strict>>>;
+  state: z.ZodOptional<z.ZodObject<{
+    variables: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    secrets: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  }, z.core.$strict>>;
+  actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    templateIdentifier: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodString>;
+    generate: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    variables: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    constants: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    secrets: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    action: z.ZodString;
+  }, z.core.$strict>>>;
+  balance: z.ZodOptional<z.ZodObject<{
+    satoshis: z.ZodOptional<z.ZodOptional<z.ZodUnion<readonly [z.ZodBigInt, z.ZodString, z.ZodLiteral<true>]>>>;
+    fungibleTokens: z.ZodOptional<z.ZodOptional<z.ZodUnion<readonly [z.ZodBigInt, z.ZodString, z.ZodLiteral<true>]>>>;
+    nonfungibleTokens: z.ZodOptional<z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodString, z.ZodLiteral<true>]>>>;
+  }, z.core.$strict>>;
+  selectable: z.ZodOptional<z.ZodBoolean>;
+  privacy: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+  lockingScript: z.ZodString;
+  valueSatoshis: z.ZodOptional<z.ZodUnion<readonly [z.ZodBigInt, z.ZodString]>>;
+  token: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    category: z.ZodOptional<z.ZodString>;
+    amount: z.ZodOptional<z.ZodUnion<readonly [z.ZodBigInt, z.ZodString, z.ZodNull]>>;
+    nft: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+      capability: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+        minting: "minting";
+        mutable: "mutable";
+        none: "none";
+      }>, z.ZodString]>>;
+      commitment: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+  }, z.core.$strict>>>;
+}, z.core.$strict>;
+/**
+ * Validation schema for a transaction input reference for a transaction definition.
+ *
+ * ```
+ * {
+ *   "transactions": {
+ *     "[id]": {
+ *       "inputs": [
+ *         { "input": "..." }  ← this schema
+ *       ]
+ *     }
+ *   }
+ * }
+ * ```
+ */
+declare const xoTemplateTransactionInputSchema: z.ZodObject<{
+  input: z.ZodString;
+  inputIndex: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+/**
+ * Validation schema for a transaction output reference for a transaction definition.
+ *
+ * ```
+ * {
+ *   "transactions": {
+ *     "[id]": {
+ *       "outputs": [
+ *         { "output": "..." }  ← this schema
+ *       ]
+ *     }
+ *   }
+ * }
+ * ```
+ */
+declare const xoTemplateTransactionOutputSchema: z.ZodObject<{
+  output: z.ZodString;
+  outputIndex: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+/**
+ * Validation schema for role-specific data for a transaction definition.
+ *
+ * ```
+ * {
+ *   "transactions": {
+ *     "[id]": {
+ *       "roles": {
+ *         "[roleId]": { }  ← this schema
+ *       }
+ *     }
+ *   }
+ * }
+ * ```
+ */
+declare const xoTemplateTransactionRoleDataSchema: z.ZodObject<{
+  name: z.ZodOptional<z.ZodString>;
+  description: z.ZodOptional<z.ZodString>;
+  icon: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+  inputs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    input: z.ZodString;
+    inputIndex: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strict>>>;
+  outputs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    output: z.ZodString;
+    outputIndex: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strict>>>;
+}, z.core.$strict>;
+/**
+ * Validation schema for a transaction template definition.
+ *
+ * ```
+ * {
+ *   "transactions": {
+ *     "[id]": { }  ← this schema
+ *   }
+ * }
+ * ```
+ */
+declare const xoTemplateTransactionSchema: z.ZodObject<{
+  name: z.ZodString;
+  description: z.ZodString;
+  icon: z.ZodOptional<z.ZodString>;
+  version: z.ZodOptional<z.ZodNumber>;
+  locktime: z.ZodOptional<z.ZodNumber>;
+  inputs: z.ZodArray<z.ZodObject<{
+    input: z.ZodString;
+    inputIndex: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strict>>;
+  outputs: z.ZodArray<z.ZodObject<{
+    output: z.ZodString;
+    outputIndex: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strict>>;
+  roles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    inputs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      input: z.ZodString;
+      inputIndex: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>>;
+    outputs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      output: z.ZodString;
+      outputIndex: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>>;
+  }, z.core.$strict>>>;
+  composable: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+/**
+ * Validation schema for a constant value definition.
+ *
+ * ```
+ * {
+ *   "constants": {
+ *     "[id]": { }  ← this schema
+ *   }
+ * }
+ * ```
+ */
+declare const xoTemplateConstantSchema: z.ZodObject<{
+  name: z.ZodString;
+  description: z.ZodString;
+  icon: z.ZodOptional<z.ZodString>;
+  type: z.ZodEnum<{
+    string: "string";
+    bigint: "bigint";
+    boolean: "boolean";
+    bytes: "bytes";
+    integer: "integer";
+    private_key: "private_key";
+    public_key: "public_key";
+  }>;
+  value: z.ZodUnknown;
+  hint: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/**
+ * Validation schema for a data field definition.
+ *
+ * ```
+ * {
+ *   "data": {
+ *     "[id]": { }  ← this schema
+ *   }
+ * }
+ * ```
+ */
+declare const xoTemplateDataSchema: z.ZodObject<{
+  type: z.ZodEnum<{
+    string: "string";
+    bigint: "bigint";
+    boolean: "boolean";
+    bytes: "bytes";
+    integer: "integer";
+    private_key: "private_key";
+    public_key: "public_key";
+  }>;
+  value: z.ZodUnknown;
+  hint: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/**
+ * Validation schema for an import default value intent. Extends the base intent with optional
+ * view properties that the engine evaluates at runtime to produce human-readable output.
+ *
+ * ```
+ * {
+ *   "variables": {
+ *     "[id]": {
+ *       "importDefaultValue": { }  ← this schema
+ *     }
+ *   }
+ * }
+ * ```
+ */
+declare const xoTemplateImportDefaultValueSchema: z.ZodObject<{
+  templateIdentifier: z.ZodOptional<z.ZodString>;
+  role: z.ZodOptional<z.ZodString>;
+  generate: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  variables: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+  constants: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+  secrets: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+  name: z.ZodOptional<z.ZodString>;
+  description: z.ZodOptional<z.ZodString>;
+  icon: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+}, z.core.$strict>;
+/**
+ * Validation schema for a variable definition.
+ *
+ * ```
+ * {
+ *   "variables": {
+ *     "[id]": { }  ← this schema
+ *   }
+ * }
+ * ```
+ */
+declare const xoTemplateVariableSchema: z.ZodObject<{
+  name: z.ZodString;
+  description: z.ZodString;
+  icon: z.ZodOptional<z.ZodString>;
+  type: z.ZodOptional<z.ZodEnum<{
+    string: "string";
+    bigint: "bigint";
+    boolean: "boolean";
+    bytes: "bytes";
+    integer: "integer";
+    private_key: "private_key";
+    public_key: "public_key";
+  }>>;
+  hint: z.ZodOptional<z.ZodString>;
+  importDefaultValue: z.ZodOptional<z.ZodObject<{
+    templateIdentifier: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodString>;
+    generate: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    variables: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    constants: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    secrets: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+  }, z.core.$strict>>;
+}, z.core.$strict>;
+/**
+ * Validation schema for a resource reference attached to a template element. Extends view
+ * properties with a URL pointing to external documentation or tooling.
+ *
+ * ```
+ * {
+ *   "resources": [
+ *     { "name": "...", "description": "...", "url": "..." }  ← this schema
+ *   ]
+ * }
+ * ```
+ */
+declare const xoTemplateResourceSchema: z.ZodObject<{
+  name: z.ZodString;
+  description: z.ZodString;
+  icon: z.ZodOptional<z.ZodString>;
+  url: z.ZodString;
+}, z.core.$strict>;
+/**
+ * Validation schema for an icon reference.
+ *
+ * ```
+ * {
+ *   "icons": [
+ *     { "name": "...", "hash": "..." }  ← this schema
+ *   ]
+ * }
+ * ```
+ */
+declare const xoTemplateIconSchema: z.ZodObject<{
+  name: z.ZodString;
+  hash: z.ZodString;
+}, z.core.$strict>;
+/**
+ * Validation schema for the defaults block of a template.
+ *
+ * ```
+ * {
+ *   "defaults": { }  ← this schema
+ * }
+ * ```
+ */
+declare const xoTemplateDefaultsSchema: z.ZodObject<{
+  change: z.ZodOptional<z.ZodObject<{
+    templateIdentifier: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodString>;
+    generate: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    variables: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    constants: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    secrets: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    output: z.ZodString;
+  }, z.core.$strict>>;
+}, z.core.$strict>;
+/**
+ * Validation schema for the full XOTemplate type.
+ */
+declare const xoTemplateSchema: z.ZodObject<{
+  name: z.ZodString;
+  description: z.ZodString;
+  icon: z.ZodOptional<z.ZodString>;
+  $schema: z.ZodString;
+  version: z.ZodOptional<z.ZodString>;
+  supported: z.ZodArray<z.ZodEnum<{
+    BCH_2020_05: "BCH_2020_05";
+    BCH_2021_05: "BCH_2021_05";
+    BCH_2022_05: "BCH_2022_05";
+    BCH_2023_05: "BCH_2023_05";
+    BCH_2024_05: "BCH_2024_05";
+    BCH_2025_05: "BCH_2025_05";
+    BCH_2026_05: "BCH_2026_05";
+  }>>;
+  defaults: z.ZodOptional<z.ZodObject<{
+    change: z.ZodOptional<z.ZodObject<{
+      templateIdentifier: z.ZodOptional<z.ZodString>;
+      role: z.ZodOptional<z.ZodString>;
+      generate: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      variables: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+      constants: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+      secrets: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+      output: z.ZodString;
+    }, z.core.$strict>>;
+  }, z.core.$strict>>;
+  roles: z.ZodRecord<z.ZodString, z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    icon: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>>;
+  start: z.ZodArray<z.ZodObject<{
+    templateIdentifier: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodString>;
+    generate: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    variables: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    constants: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    secrets: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    action: z.ZodString;
+  }, z.core.$strict>>;
+  actions: z.ZodRecord<z.ZodString, z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    icon: z.ZodOptional<z.ZodString>;
+    roles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+      name: z.ZodOptional<z.ZodString>;
+      description: z.ZodOptional<z.ZodString>;
+      icon: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+      generate: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      requirements: z.ZodOptional<z.ZodObject<{
+        variables: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        secrets: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      }, z.core.$strict>>;
+    }, z.core.$strict>>>;
+    requirements: z.ZodOptional<z.ZodObject<{
+      participants: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        role: z.ZodString;
+        slots: z.ZodObject<{
+          min: z.ZodNumber;
+          max: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>;
+      }, z.core.$strict>>>;
+      secrets: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+    conditions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    transaction: z.ZodOptional<z.ZodString>;
+    data: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>>;
+  data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+    type: z.ZodEnum<{
+      string: "string";
+      bigint: "bigint";
+      boolean: "boolean";
+      bytes: "bytes";
+      integer: "integer";
+      private_key: "private_key";
+      public_key: "public_key";
+    }>;
+    value: z.ZodUnknown;
+    hint: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>>>;
+  transactions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    icon: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodNumber>;
+    locktime: z.ZodOptional<z.ZodNumber>;
+    inputs: z.ZodArray<z.ZodObject<{
+      input: z.ZodString;
+      inputIndex: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    outputs: z.ZodArray<z.ZodObject<{
+      output: z.ZodString;
+      outputIndex: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    roles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+      name: z.ZodOptional<z.ZodString>;
+      description: z.ZodOptional<z.ZodString>;
+      icon: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+      inputs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        input: z.ZodString;
+        inputIndex: z.ZodOptional<z.ZodNumber>;
+      }, z.core.$strict>>>;
+      outputs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        output: z.ZodString;
+        outputIndex: z.ZodOptional<z.ZodNumber>;
+      }, z.core.$strict>>>;
+    }, z.core.$strict>>>;
+    composable: z.ZodOptional<z.ZodBoolean>;
+  }, z.core.$strict>>>;
+  inputs: z.ZodRecord<z.ZodString, z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    icon: z.ZodOptional<z.ZodString>;
+    valueSatoshis: z.ZodOptional<z.ZodUnion<readonly [z.ZodBigInt, z.ZodString]>>;
+    token: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+      category: z.ZodOptional<z.ZodString>;
+      amount: z.ZodOptional<z.ZodUnion<readonly [z.ZodBigInt, z.ZodString, z.ZodNull]>>;
+      nft: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        capability: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+          minting: "minting";
+          mutable: "mutable";
+          none: "none";
+        }>, z.ZodString]>>;
+        commitment: z.ZodOptional<z.ZodString>;
+      }, z.core.$strict>>>;
+    }, z.core.$strict>>>;
+    sequenceNumber: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+    unlockingScript: z.ZodOptional<z.ZodString>;
+    omitChangeAmounts: z.ZodOptional<z.ZodObject<{
+      satoshis: z.ZodOptional<z.ZodUnion<readonly [z.ZodBigInt, z.ZodString, z.ZodLiteral<true>]>>;
+      fungibleTokens: z.ZodOptional<z.ZodUnion<readonly [z.ZodBigInt, z.ZodString, z.ZodLiteral<true>]>>;
+      nonfungibleTokens: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodString, z.ZodLiteral<true>]>>;
+    }, z.core.$strict>>;
+  }, z.core.$strict>>;
+  outputs: z.ZodRecord<z.ZodString, z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    icon: z.ZodOptional<z.ZodString>;
+    roles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+      name: z.ZodOptional<z.ZodString>;
+      description: z.ZodOptional<z.ZodString>;
+      icon: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+      state: z.ZodOptional<z.ZodObject<{
+        variables: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        secrets: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      }, z.core.$strict>>;
+      actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        templateIdentifier: z.ZodOptional<z.ZodString>;
+        role: z.ZodOptional<z.ZodString>;
+        generate: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        variables: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+        constants: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+        secrets: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+        action: z.ZodString;
+      }, z.core.$strict>>>;
+      balance: z.ZodOptional<z.ZodObject<{
+        satoshis: z.ZodOptional<z.ZodOptional<z.ZodUnion<readonly [z.ZodBigInt, z.ZodString, z.ZodLiteral<true>]>>>;
+        fungibleTokens: z.ZodOptional<z.ZodOptional<z.ZodUnion<readonly [z.ZodBigInt, z.ZodString, z.ZodLiteral<true>]>>>;
+        nonfungibleTokens: z.ZodOptional<z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodString, z.ZodLiteral<true>]>>>;
+      }, z.core.$strict>>;
+      selectable: z.ZodOptional<z.ZodBoolean>;
+      privacy: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+    }, z.core.$strict>>>;
+    state: z.ZodOptional<z.ZodObject<{
+      variables: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      secrets: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+    actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      templateIdentifier: z.ZodOptional<z.ZodString>;
+      role: z.ZodOptional<z.ZodString>;
+      generate: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      variables: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+      constants: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+      secrets: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+      action: z.ZodString;
+    }, z.core.$strict>>>;
+    balance: z.ZodOptional<z.ZodObject<{
+      satoshis: z.ZodOptional<z.ZodOptional<z.ZodUnion<readonly [z.ZodBigInt, z.ZodString, z.ZodLiteral<true>]>>>;
+      fungibleTokens: z.ZodOptional<z.ZodOptional<z.ZodUnion<readonly [z.ZodBigInt, z.ZodString, z.ZodLiteral<true>]>>>;
+      nonfungibleTokens: z.ZodOptional<z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodString, z.ZodLiteral<true>]>>>;
+    }, z.core.$strict>>;
+    selectable: z.ZodOptional<z.ZodBoolean>;
+    privacy: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+    lockingScript: z.ZodString;
+    valueSatoshis: z.ZodOptional<z.ZodUnion<readonly [z.ZodBigInt, z.ZodString]>>;
+    token: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+      category: z.ZodOptional<z.ZodString>;
+      amount: z.ZodOptional<z.ZodUnion<readonly [z.ZodBigInt, z.ZodString, z.ZodNull]>>;
+      nft: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        capability: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+          minting: "minting";
+          mutable: "mutable";
+          none: "none";
+        }>, z.ZodString]>>;
+        commitment: z.ZodOptional<z.ZodString>;
+      }, z.core.$strict>>>;
+    }, z.core.$strict>>>;
+  }, z.core.$strict>>;
+  lockingScripts: z.ZodRecord<z.ZodString, z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    icon: z.ZodOptional<z.ZodString>;
+    lockingType: z.ZodOptional<z.ZodEnum<{
+      p2s: "p2s";
+      p2pkh: "p2pkh";
+      p2sh: "p2sh";
+    }>>;
+    lockingBytecode: z.ZodString;
+    unlockingBytecode: z.ZodOptional<z.ZodString>;
+    actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      templateIdentifier: z.ZodOptional<z.ZodString>;
+      role: z.ZodOptional<z.ZodString>;
+      generate: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      variables: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+      constants: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+      secrets: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+      action: z.ZodString;
+    }, z.core.$strict>>>;
+    state: z.ZodOptional<z.ZodObject<{
+      variables: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      secrets: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+    balance: z.ZodOptional<z.ZodObject<{
+      satoshis: z.ZodOptional<z.ZodOptional<z.ZodUnion<readonly [z.ZodBigInt, z.ZodString, z.ZodLiteral<true>]>>>;
+      fungibleTokens: z.ZodOptional<z.ZodOptional<z.ZodUnion<readonly [z.ZodBigInt, z.ZodString, z.ZodLiteral<true>]>>>;
+      nonfungibleTokens: z.ZodOptional<z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodString, z.ZodLiteral<true>]>>>;
+    }, z.core.$strict>>;
+    selectable: z.ZodOptional<z.ZodBoolean>;
+    privacy: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+    roles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+      name: z.ZodOptional<z.ZodString>;
+      description: z.ZodOptional<z.ZodString>;
+      icon: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+      state: z.ZodOptional<z.ZodObject<{
+        variables: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        secrets: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      }, z.core.$strict>>;
+      actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        templateIdentifier: z.ZodOptional<z.ZodString>;
+        role: z.ZodOptional<z.ZodString>;
+        generate: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        variables: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+        constants: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+        secrets: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+        action: z.ZodString;
+      }, z.core.$strict>>>;
+      balance: z.ZodOptional<z.ZodObject<{
+        satoshis: z.ZodOptional<z.ZodOptional<z.ZodUnion<readonly [z.ZodBigInt, z.ZodString, z.ZodLiteral<true>]>>>;
+        fungibleTokens: z.ZodOptional<z.ZodOptional<z.ZodUnion<readonly [z.ZodBigInt, z.ZodString, z.ZodLiteral<true>]>>>;
+        nonfungibleTokens: z.ZodOptional<z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodString, z.ZodLiteral<true>]>>>;
+      }, z.core.$strict>>;
+      selectable: z.ZodOptional<z.ZodBoolean>;
+      privacy: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+    }, z.core.$strict>>>;
+  }, z.core.$strict>>;
+  scripts: z.ZodRecord<z.ZodString, z.ZodString>;
+  constants: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    icon: z.ZodOptional<z.ZodString>;
+    type: z.ZodEnum<{
+      string: "string";
+      bigint: "bigint";
+      boolean: "boolean";
+      bytes: "bytes";
+      integer: "integer";
+      private_key: "private_key";
+      public_key: "public_key";
+    }>;
+    value: z.ZodUnknown;
+    hint: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>>>;
+  variables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    icon: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodEnum<{
+      string: "string";
+      bigint: "bigint";
+      boolean: "boolean";
+      bytes: "bytes";
+      integer: "integer";
+      private_key: "private_key";
+      public_key: "public_key";
+    }>>;
+    hint: z.ZodOptional<z.ZodString>;
+    importDefaultValue: z.ZodOptional<z.ZodObject<{
+      templateIdentifier: z.ZodOptional<z.ZodString>;
+      role: z.ZodOptional<z.ZodString>;
+      generate: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      variables: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+      constants: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+      secrets: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+      name: z.ZodOptional<z.ZodString>;
+      description: z.ZodOptional<z.ZodString>;
+      icon: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    }, z.core.$strict>>;
+  }, z.core.$strict>>>;
+  resources: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    icon: z.ZodOptional<z.ZodString>;
+    url: z.ZodString;
+  }, z.core.$strict>>>;
+  icons: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    hash: z.ZodString;
+  }, z.core.$strict>>>;
+  scenarios: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strict>;
+//#endregion
+//#region source/template/serialization.d.ts
+/**
+ * Serializes an XOTemplate to a JSON string. Encodes `bigint` and `Uint8Array` fields in
+ * Extended JSON format so they can be reconstructed by `deserializeTemplate`.
+ *
+ * @param template The template to serialize.
+ * @returns A JSON string representation of the template.
+ * @throws {TemplateSerializationFailedError} If the template cannot be serialized to JSON.
+ */
+declare const serializeTemplate: (template: XOTemplate) => string;
+//#endregion
+export { TemplateInvalidError, TemplateJsonMalformedError, TemplateSerializationFailedError, VIEW_PROPERTIES_DESCRIPTION_MAX_LENGTH, VIEW_PROPERTIES_ICON_MAX_LENGTH, VIEW_PROPERTIES_NAME_MAX_LENGTH, bchVmVersionSchema, buildErrorDescription, extendedJsonReplacer, extendedJsonReviver, generateTemplateIdentifier, parseTemplate, satoshisSchema, scriptToScriptHash, serializeTemplate, uint8ArraySchema, xoTemplateActionIntentSchema, xoTemplateActionRequirementsSchema, xoTemplateActionRoleRequirementsSchema, xoTemplateActionRoleSchema, xoTemplateActionSchema, xoTemplateAssetAmountsSchema, xoTemplateConstantSchema, xoTemplateDataSchema, xoTemplateDefaultsSchema, xoTemplateIconSchema, xoTemplateImportDefaultValueSchema, xoTemplateInputSchema, xoTemplateIntentSchema, xoTemplateLockingScriptIntentSchema, xoTemplateLockingScriptRoleSchema, xoTemplateLockingScriptSchema, xoTemplateLockingTypeSchema, xoTemplateNftCapabilitySchema, xoTemplateNonFungibleTokenDetailsSchema, xoTemplateOutputIntentSchema, xoTemplateOutputSchema, xoTemplatePrimitiveTypeSchema, xoTemplateResourceSchema, xoTemplateRoleSlotSchema, xoTemplateRoleSlotsRequirementsSchema, xoTemplateSchema, xoTemplateStateSchema, xoTemplateTokenSchema, xoTemplateTransactionInputSchema, xoTemplateTransactionOutputSchema, xoTemplateTransactionRoleDataSchema, xoTemplateTransactionSchema, xoTemplateVariableSchema, xoTemplateViewPropertiesSchema };
+//# sourceMappingURL=index.d.mts.map