@sundaeswap/sprinkles 0.4.0 → 0.6.0

package/dist/esm/Sprinkle/tx-dialog.js

@@ -0,0 +1,90 @@
+/**
+ * Transaction dialog helper utilities.
+ * Functions for working with transaction signatures and display.
+ */
+
+import { CborSet, VkeyWitness, blake2b_256 } from "@blaze-cardano/core";
+
+/**
+ * Get the payment key hash from a HotWallet's first address.
+ */
+export async function getWalletPaymentKeyHash(wallet) {
+  try {
+    const addresses = await wallet.getUsedAddresses();
+    const address = addresses[0];
+    if (!address) return null;
+    const paymentCredential = address.asBase()?.getPaymentCredential();
+    return paymentCredential?.hash?.toString() ?? null;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Count the number of vkey signatures in a transaction's witness set.
+ */
+export function countSignatures(tx) {
+  const vkeys = tx.witnessSet().vkeys();
+  return vkeys ? vkeys.size() : 0;
+}
+
+/**
+ * Check if a specific public key has already signed the transaction.
+ * Compares by vkey (public key bytes).
+ */
+export function hasVkeySigned(tx, vkeyHex) {
+  const vkeys = tx.witnessSet().vkeys();
+  if (!vkeys) return false;
+  const vkeyArray = vkeys.toCore();
+  return vkeyArray.some(([vkey]) => vkey === vkeyHex);
+}
+
+/**
+ * Get the list of required signer key hashes from the transaction body.
+ */
+export function getRequiredSigners(tx) {
+  const requiredSigners = tx.body().requiredSigners();
+  if (!requiredSigners) return [];
+  return Array.from(requiredSigners.values()).map(s => s.toString());
+}
+
+/**
+ * Compute the transaction body hash for display.
+ */
+export function getTxBodyHash(tx) {
+  const bodyCbor = tx.body().toCbor();
+  return blake2b_256(bodyCbor);
+}
+
+/**
+ * Format a hash for display: first 8 chars + ... + last 8 chars.
+ */
+export function formatHash(hash) {
+  if (hash.length <= 20) return hash;
+  return `${hash.slice(0, 8)}...${hash.slice(-8)}`;
+}
+
+/**
+ * Merge signatures from source transaction into target transaction.
+ * Prevents duplicate signatures by comparing vkey (public key).
+ * Returns the count of newly added signatures.
+ */
+export function mergeSignatures(target, source) {
+  const targetWs = target.witnessSet();
+  const sourceWs = source.witnessSet();
+  const targetVkeys = targetWs.vkeys()?.toCore() ?? [];
+  const sourceVkeys = sourceWs.vkeys()?.toCore() ?? [];
+
+  // Find vkeys in source that aren't in target (by comparing public key)
+  const existingPubKeys = new Set(targetVkeys.map(([vkey]) => vkey));
+  const newVkeys = sourceVkeys.filter(([vkey]) => !existingPubKeys.has(vkey));
+  if (newVkeys.length === 0) {
+    return 0;
+  }
+
+  // Merge the new vkeys into target
+  targetWs.setVkeys(CborSet.fromCore([...targetVkeys, ...newVkeys], VkeyWitness.fromCore));
+  target.setWitnessSet(targetWs);
+  return newVkeys.length;
+}
+//# sourceMappingURL=tx-dialog.js.map

package/dist/esm/Sprinkle/tx-dialog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tx-dialog.js","names":["CborSet","VkeyWitness","blake2b_256","getWalletPaymentKeyHash","wallet","addresses","getUsedAddresses","address","paymentCredential","asBase","getPaymentCredential","hash","toString","countSignatures","tx","vkeys","witnessSet","size","hasVkeySigned","vkeyHex","vkeyArray","toCore","some","vkey","getRequiredSigners","requiredSigners","body","Array","from","values","map","s","getTxBodyHash","bodyCbor","toCbor","formatHash","length","slice","mergeSignatures","target","source","targetWs","sourceWs","targetVkeys","sourceVkeys","existingPubKeys","Set","newVkeys","filter","has","setVkeys","fromCore","setWitnessSet"],"sources":["../../../src/Sprinkle/tx-dialog.ts"],"sourcesContent":["/**\n * Transaction dialog helper utilities.\n * Functions for working with transaction signatures and display.\n */\n\nimport { Core, HotWallet } from \"@blaze-cardano/sdk\";\nimport { CborSet, VkeyWitness, blake2b_256 } from \"@blaze-cardano/core\";\n\n/**\n * Get the payment key hash from a HotWallet's first address.\n */\nexport async function getWalletPaymentKeyHash(\n  wallet: HotWallet,\n): Promise<string | null> {\n  try {\n    const addresses = await wallet.getUsedAddresses();\n    const address = addresses[0];\n    if (!address) return null;\n    const paymentCredential = address.asBase()?.getPaymentCredential();\n    return paymentCredential?.hash?.toString() ?? null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Count the number of vkey signatures in a transaction's witness set.\n */\nexport function countSignatures(tx: Core.Transaction): number {\n  const vkeys = tx.witnessSet().vkeys();\n  return vkeys ? vkeys.size() : 0;\n}\n\n/**\n * Check if a specific public key has already signed the transaction.\n * Compares by vkey (public key bytes).\n */\nexport function hasVkeySigned(tx: Core.Transaction, vkeyHex: string): boolean {\n  const vkeys = tx.witnessSet().vkeys();\n  if (!vkeys) return false;\n  const vkeyArray = vkeys.toCore();\n  return vkeyArray.some(([vkey]) => vkey === vkeyHex);\n}\n\n/**\n * Get the list of required signer key hashes from the transaction body.\n */\nexport function getRequiredSigners(tx: Core.Transaction): string[] {\n  const requiredSigners = tx.body().requiredSigners();\n  if (!requiredSigners) return [];\n  return Array.from(requiredSigners.values()).map((s) => s.toString());\n}\n\n/**\n * Compute the transaction body hash for display.\n */\nexport function getTxBodyHash(tx: Core.Transaction): string {\n  const bodyCbor = tx.body().toCbor();\n  return blake2b_256(bodyCbor);\n}\n\n/**\n * Format a hash for display: first 8 chars + ... + last 8 chars.\n */\nexport function formatHash(hash: string): string {\n  if (hash.length <= 20) return hash;\n  return `${hash.slice(0, 8)}...${hash.slice(-8)}`;\n}\n\n/**\n * Merge signatures from source transaction into target transaction.\n * Prevents duplicate signatures by comparing vkey (public key).\n * Returns the count of newly added signatures.\n */\nexport function mergeSignatures(\n  target: Core.Transaction,\n  source: Core.Transaction,\n): number {\n  const targetWs = target.witnessSet();\n  const sourceWs = source.witnessSet();\n\n  const targetVkeys = targetWs.vkeys()?.toCore() ?? [];\n  const sourceVkeys = sourceWs.vkeys()?.toCore() ?? [];\n\n  // Find vkeys in source that aren't in target (by comparing public key)\n  const existingPubKeys = new Set(targetVkeys.map(([vkey]) => vkey));\n  const newVkeys = sourceVkeys.filter(([vkey]) => !existingPubKeys.has(vkey));\n\n  if (newVkeys.length === 0) {\n    return 0;\n  }\n\n  // Merge the new vkeys into target\n  targetWs.setVkeys(\n    CborSet.fromCore([...targetVkeys, ...newVkeys], VkeyWitness.fromCore),\n  );\n  target.setWitnessSet(targetWs);\n\n  return newVkeys.length;\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/esm/Sprinkle/type-guards.js

@@ -0,0 +1,66 @@
+/**
+ * Type guard utilities for TypeBox schema types.
+ * These are internal helpers used by FillInStruct, encryption, and other modules.
+ */
+
+import { Kind, OptionalKind } from "@sinclair/typebox";
+export const isOptional = t => t[OptionalKind] === "Optional";
+export const isImport = t => t[Kind] === "Import";
+export const isArray = t => t[Kind] === "Array";
+export const isBigInt = t => t[Kind] === "BigInt";
+export const isLiteral = t => t[Kind] === "Literal";
+export const isObject = t => t[Kind] === "Object";
+export const isRef = t => t[Kind] === "Ref";
+export const isString = t => t[Kind] === "String";
+export const isThis = t => t[Kind] === "This";
+export const isTuple = t => t[Kind] === "Tuple";
+export const isUnion = t => t[Kind] === "Union";
+
+/**
+ * Check if a schema field is marked as sensitive.
+ * Sensitive fields are encrypted when saved and masked when displayed.
+ */
+export const isSensitive = t => isString(t) && t.sensitive === true;
+
+/**
+ * Check if a schema is a Null type.
+ */
+export const isNull = t => t[Kind] === "Null";
+
+/**
+ * Check if a schema allows null values.
+ * Returns true for TNull or unions containing TNull.
+ */
+export const isNullable = t => {
+  if (isNull(t)) return true;
+  if (isUnion(t)) return t.anyOf.some(member => isNull(member));
+  return false;
+};
+
+/**
+ * Unwrap a nullable type to get the non-null inner type.
+ * For unions with Null, returns the union without the Null member.
+ * For single non-null member unions, returns just that type.
+ */
+export const unwrapNullable = t => {
+  if (isUnion(t)) {
+    const nonNull = t.anyOf.filter(member => !isNull(member));
+    if (nonNull.length === 1) return nonNull[0];
+    return {
+      ...t,
+      anyOf: nonNull
+    };
+  }
+  return t;
+};
+
+/**
+ * Check if a schema has a default value defined.
+ */
+export const hasDefault = t => "default" in t;
+
+/**
+ * Get the default value from a schema, if defined.
+ */
+export const getDefault = t => t.default;
+//# sourceMappingURL=type-guards.js.map

package/dist/esm/Sprinkle/type-guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-guards.js","names":["Kind","OptionalKind","isOptional","t","isImport","isArray","isBigInt","isLiteral","isObject","isRef","isString","isThis","isTuple","isUnion","isSensitive","sensitive","isNull","isNullable","anyOf","some","member","unwrapNullable","nonNull","filter","length","hasDefault","getDefault","default"],"sources":["../../../src/Sprinkle/type-guards.ts"],"sourcesContent":["/**\n * Type guard utilities for TypeBox schema types.\n * These are internal helpers used by FillInStruct, encryption, and other modules.\n */\n\nimport {\n  Kind,\n  type TBigInt,\n  type TLiteral,\n  type TNull,\n  type TObject,\n  type TSchema,\n  type TString,\n  type TTuple,\n  type TUnion,\n  type TArray,\n  type TThis,\n  type TRef,\n  type TImport,\n  type TOptional,\n  type Static,\n  OptionalKind,\n} from \"@sinclair/typebox\";\n\nexport const isOptional = <T extends TSchema>(t: T): t is TOptional<T> =>\n  t[OptionalKind] === \"Optional\";\n\nexport const isImport = (t: TSchema): t is TImport => t[Kind] === \"Import\";\n\nexport const isArray = (t: TSchema): t is TArray => t[Kind] === \"Array\";\n\nexport const isBigInt = (t: TSchema): t is TBigInt => t[Kind] === \"BigInt\";\n\nexport const isLiteral = (t: TSchema): t is TLiteral => t[Kind] === \"Literal\";\n\nexport const isObject = (t: TSchema): t is TObject => t[Kind] === \"Object\";\n\nexport const isRef = (t: TSchema): t is TRef => t[Kind] === \"Ref\";\n\nexport const isString = (t: TSchema): t is TString => t[Kind] === \"String\";\n\nexport const isThis = (t: TSchema): t is TThis => t[Kind] === \"This\";\n\nexport const isTuple = (t: TSchema): t is TTuple => t[Kind] === \"Tuple\";\n\nexport const isUnion = (t: TSchema): t is TUnion => t[Kind] === \"Union\";\n\n/**\n * Check if a schema field is marked as sensitive.\n * Sensitive fields are encrypted when saved and masked when displayed.\n */\nexport const isSensitive = (t: TSchema): boolean =>\n  isString(t) && t.sensitive === true;\n\n/**\n * Check if a schema is a Null type.\n */\nexport const isNull = (t: TSchema): t is TNull => t[Kind] === \"Null\";\n\n/**\n * Check if a schema allows null values.\n * Returns true for TNull or unions containing TNull.\n */\nexport const isNullable = (t: TSchema): boolean => {\n  if (isNull(t)) return true;\n  if (isUnion(t)) return t.anyOf.some((member) => isNull(member));\n  return false;\n};\n\n/**\n * Unwrap a nullable type to get the non-null inner type.\n * For unions with Null, returns the union without the Null member.\n * For single non-null member unions, returns just that type.\n */\nexport const unwrapNullable = (t: TSchema): TSchema => {\n  if (isUnion(t)) {\n    const nonNull = t.anyOf.filter((member) => !isNull(member));\n    if (nonNull.length === 1) return nonNull[0]!;\n    return { ...t, anyOf: nonNull } as TSchema;\n  }\n  return t;\n};\n\n/**\n * Check if a schema has a default value defined.\n */\nexport const hasDefault = (t: TSchema): boolean => \"default\" in t;\n\n/**\n * Get the default value from a schema, if defined.\n */\nexport const getDefault = <T extends TSchema>(t: T): Static<T> | undefined =>\n  t.default as Static<T> | undefined;\n"],"mappings":"AAAA;AACA;AACA;AACA;;AAEA,SACEA,IAAI,EAeJC,YAAY,QACP,mBAAmB;AAE1B,OAAO,MAAMC,UAAU,GAAuBC,CAAI,IAChDA,CAAC,CAACF,YAAY,CAAC,KAAK,UAAU;AAEhC,OAAO,MAAMG,QAAQ,GAAID,CAAU,IAAmBA,CAAC,CAACH,IAAI,CAAC,KAAK,QAAQ;AAE1E,OAAO,MAAMK,OAAO,GAAIF,CAAU,IAAkBA,CAAC,CAACH,IAAI,CAAC,KAAK,OAAO;AAEvE,OAAO,MAAMM,QAAQ,GAAIH,CAAU,IAAmBA,CAAC,CAACH,IAAI,CAAC,KAAK,QAAQ;AAE1E,OAAO,MAAMO,SAAS,GAAIJ,CAAU,IAAoBA,CAAC,CAACH,IAAI,CAAC,KAAK,SAAS;AAE7E,OAAO,MAAMQ,QAAQ,GAAIL,CAAU,IAAmBA,CAAC,CAACH,IAAI,CAAC,KAAK,QAAQ;AAE1E,OAAO,MAAMS,KAAK,GAAIN,CAAU,IAAgBA,CAAC,CAACH,IAAI,CAAC,KAAK,KAAK;AAEjE,OAAO,MAAMU,QAAQ,GAAIP,CAAU,IAAmBA,CAAC,CAACH,IAAI,CAAC,KAAK,QAAQ;AAE1E,OAAO,MAAMW,MAAM,GAAIR,CAAU,IAAiBA,CAAC,CAACH,IAAI,CAAC,KAAK,MAAM;AAEpE,OAAO,MAAMY,OAAO,GAAIT,CAAU,IAAkBA,CAAC,CAACH,IAAI,CAAC,KAAK,OAAO;AAEvE,OAAO,MAAMa,OAAO,GAAIV,CAAU,IAAkBA,CAAC,CAACH,IAAI,CAAC,KAAK,OAAO;;AAEvE;AACA;AACA;AACA;AACA,OAAO,MAAMc,WAAW,GAAIX,CAAU,IACpCO,QAAQ,CAACP,CAAC,CAAC,IAAIA,CAAC,CAACY,SAAS,KAAK,IAAI;;AAErC;AACA;AACA;AACA,OAAO,MAAMC,MAAM,GAAIb,CAAU,IAAiBA,CAAC,CAACH,IAAI,CAAC,KAAK,MAAM;;AAEpE;AACA;AACA;AACA;AACA,OAAO,MAAMiB,UAAU,GAAId,CAAU,IAAc;EACjD,IAAIa,MAAM,CAACb,CAAC,CAAC,EAAE,OAAO,IAAI;EAC1B,IAAIU,OAAO,CAACV,CAAC,CAAC,EAAE,OAAOA,CAAC,CAACe,KAAK,CAACC,IAAI,CAAEC,MAAM,IAAKJ,MAAM,CAACI,MAAM,CAAC,CAAC;EAC/D,OAAO,KAAK;AACd,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,cAAc,GAAIlB,CAAU,IAAc;EACrD,IAAIU,OAAO,CAACV,CAAC,CAAC,EAAE;IACd,MAAMmB,OAAO,GAAGnB,CAAC,CAACe,KAAK,CAACK,MAAM,CAAEH,MAAM,IAAK,CAACJ,MAAM,CAACI,MAAM,CAAC,CAAC;IAC3D,IAAIE,OAAO,CAACE,MAAM,KAAK,CAAC,EAAE,OAAOF,OAAO,CAAC,CAAC,CAAC;IAC3C,OAAO;MAAE,GAAGnB,CAAC;MAAEe,KAAK,EAAEI;IAAQ,CAAC;EACjC;EACA,OAAOnB,CAAC;AACV,CAAC;;AAED;AACA;AACA;AACA,OAAO,MAAMsB,UAAU,GAAItB,CAAU,IAAc,SAAS,IAAIA,CAAC;;AAEjE;AACA;AACA;AACA,OAAO,MAAMuB,UAAU,GAAuBvB,CAAI,IAChDA,CAAC,CAACwB,OAAgC","ignoreList":[]}

package/dist/esm/Sprinkle/types.js

@@ -0,0 +1,66 @@
+/**
+ * Utility type to extract the static type from a TypeBox schema.
+ */
+
+/**
+ * Options for encrypting/decrypting sensitive fields in settings.
+ */
+
+/**
+ * Options for configuring a Sprinkle instance.
+ */
+
+/**
+ * Metadata for a profile.
+ */
+
+/**
+ * Current profile information including ID.
+ */
+
+/**
+ * Profile entry as returned by scanProfiles().
+ */
+
+/**
+ * Result of the TxDialog interaction.
+ */
+
+/**
+ * Options for TxDialog.
+ */
+
+/**
+ * Error thrown when user cancels a prompt via Escape key.
+ */
+export class UserCancelledError extends Error {
+  constructor(message = "User cancelled the operation") {
+    super(message);
+    this.name = "UserCancelledError";
+  }
+}
+
+// --- Menu-based FillInStruct types ---
+
+/**
+ * State tracking for a single field during menu-based editing.
+ */
+
+// explicitly set to null
+
+/**
+ * Result of counting required fields in a schema.
+ */
+
+/**
+ * Result from field menu interaction.
+ */
+
+/**
+ * Result from object menu interaction.
+ */
+
+/**
+ * Result from array menu interaction.
+ */
+//# sourceMappingURL=types.js.map

package/dist/esm/Sprinkle/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":["UserCancelledError","Error","constructor","message","name"],"sources":["../../../src/Sprinkle/types.ts"],"sourcesContent":["import { Core } from \"@blaze-cardano/sdk\";\nimport type { Static, TSchema } from \"@sinclair/typebox\";\n\n/**\n * Utility type to extract the static type from a TypeBox schema.\n */\nexport type TExact<T> = T extends TSchema ? Static<T> : T;\n\n/**\n * Options for encrypting/decrypting sensitive fields in settings.\n */\nexport interface IEncryptionOptions {\n  encrypt: (plaintext: string) => string;\n  decrypt: (ciphertext: string) => Promise<string>;\n}\n\n/**\n * Options for configuring a Sprinkle instance.\n */\nexport interface ISprinkleOptions {\n  encryption?: IEncryptionOptions;\n}\n\n/**\n * Metadata for a profile.\n */\nexport interface IProfileMeta {\n  name: string;\n  description?: string;\n  createdAt: string;\n  updatedAt: string;\n}\n\n/**\n * Current profile information including ID.\n */\nexport interface ICurrentProfile extends IProfileMeta {\n  id: string;\n}\n\n/**\n * Profile entry as returned by scanProfiles().\n */\nexport interface IProfileEntry {\n  id: string;\n  meta: IProfileMeta;\n}\n\n/**\n * Result of the TxDialog interaction.\n */\nexport interface TxDialogResult {\n  action: \"submitted\" | \"signed\" | \"cancelled\";\n  txId?: string; // present only if action === 'submitted'\n  tx: Core.Transaction; // the (potentially signed) transaction\n}\n\n/**\n * Options for TxDialog.\n */\nexport interface TxDialogOptions {\n  beforeSign?: () => Promise<void>;\n}\n\n/**\n * Error thrown when user cancels a prompt via Escape key.\n */\nexport class UserCancelledError extends Error {\n  constructor(message: string = \"User cancelled the operation\") {\n    super(message);\n    this.name = \"UserCancelledError\";\n  }\n}\n\n// --- Menu-based FillInStruct types ---\n\n/**\n * State tracking for a single field during menu-based editing.\n */\nexport type FieldState<T = unknown> =\n  | { status: \"unset\" }\n  | { status: \"set\"; value: T }\n  | { status: \"null\" }; // explicitly set to null\n\n/**\n * Result of counting required fields in a schema.\n */\nexport interface RequiredFieldCount {\n  total: number;\n  filled: number;\n}\n\n/**\n * Result from field menu interaction.\n */\nexport type FieldMenuResult<T = unknown> =\n  | { action: \"edit\" }\n  | { action: \"view\" }\n  | { action: \"clear\" }\n  | { action: \"setNull\" }\n  | { action: \"reset\"; defaultValue: T }\n  | { action: \"back\" };\n\n/**\n * Result from object menu interaction.\n */\nexport type ObjectMenuResult<T = unknown> =\n  | { action: \"submit\"; value: T }\n  | { action: \"cancel\" };\n\n/**\n * Result from array menu interaction.\n */\nexport type ArrayMenuResult<T = unknown> =\n  | { action: \"done\"; value: T[] }\n  | { action: \"back\" };\n"],"mappings":"AAGA;AACA;AACA;;AAGA;AACA;AACA;;AAMA;AACA;AACA;;AAKA;AACA;AACA;;AAQA;AACA;AACA;;AAKA;AACA;AACA;;AAMA;AACA;AACA;;AAOA;AACA;AACA;;AAKA;AACA;AACA;AACA,OAAO,MAAMA,kBAAkB,SAASC,KAAK,CAAC;EAC5CC,WAAWA,CAACC,OAAe,GAAG,8BAA8B,EAAE;IAC5D,KAAK,CAACA,OAAO,CAAC;IACd,IAAI,CAACC,IAAI,GAAG,oBAAoB;EAClC;AACF;;AAEA;;AAEA;AACA;AACA;;AAIwB;;AAExB;AACA;AACA;;AAMA;AACA;AACA;;AASA;AACA;AACA;;AAKA;AACA;AACA","ignoreList":[]}

package/dist/esm/Sprinkle/utils/field-utils.js

@@ -0,0 +1,145 @@
+/**
+ * Field utilities for menu-based struct editing.
+ * Provides required field counting and label building.
+ */
+
+import { isOptional, isNullable, hasDefault, getDefault, isLiteral } from "../type-guards.js";
+import { formatValuePreview } from "./formatting.js";
+
+/**
+ * Count required fields in an object schema and how many are filled.
+ *
+ * @param type - The object schema
+ * @param state - Map of field names to their current state
+ * @returns Count of total required fields and how many are filled
+ */
+export function countRequiredFields(type, state) {
+  const fields = type.properties;
+  let total = 0;
+  let filled = 0;
+  for (const [fieldName, fieldType] of Object.entries(fields)) {
+    // Skip optional fields - they're not required
+    if (isOptional(fieldType)) {
+      continue;
+    }
+
+    // Non-nullable fields with defaults don't require user input
+    if (hasDefault(fieldType) && !isNullable(fieldType)) {
+      continue;
+    }
+
+    // Literal fields auto-fill, so they're not required from the user
+    if (isLiteral(fieldType)) {
+      continue;
+    }
+
+    // This is a required field
+    total++;
+
+    // Check if it's filled
+    const fieldState = state.get(fieldName);
+    if (fieldState?.status === "set" || fieldState?.status === "null") {
+      filled++;
+    }
+  }
+  return {
+    total,
+    filled
+  };
+}
+
+/**
+ * Determine if a field is required (must have a value to submit).
+ *
+ * @param fieldType - The field's schema
+ * @returns true if the field is required
+ */
+export function isFieldRequired(fieldType) {
+  // Optional fields are not required
+  if (isOptional(fieldType)) {
+    return false;
+  }
+
+  // Literal fields auto-fill, so they're not required from the user
+  if (isLiteral(fieldType)) {
+    return false;
+  }
+
+  // Non-nullable fields with defaults are not required (default will be used)
+  if (hasDefault(fieldType) && !isNullable(fieldType)) {
+    return false;
+  }
+  return true;
+}
+
+/**
+ * Build a display label for a field in the menu.
+ *
+ * @param fieldName - The field name
+ * @param fieldType - The field's schema
+ * @param state - The current state of the field
+ * @returns Formatted label string
+ */
+export function buildFieldLabel(fieldName, fieldType, state) {
+  const required = isFieldRequired(fieldType);
+  const requiredMarker = required ? " *" : "";
+  switch (state.status) {
+    case "unset":
+      {
+        // Check for default value
+        if (hasDefault(fieldType)) {
+          const defaultVal = getDefault(fieldType);
+          const preview = formatValuePreview(defaultVal, 30);
+          return `${fieldName}: [default: ${preview}]${requiredMarker}`;
+        }
+        return `${fieldName}: [not set]${requiredMarker}`;
+      }
+    case "null":
+      return `${fieldName}: null${requiredMarker}`;
+    case "set":
+      {
+        const preview = formatValuePreview(state.value, 40);
+        return `${fieldName}: ${preview}${requiredMarker}`;
+      }
+  }
+}
+
+/**
+ * Get the initial FieldState for a field based on its type and any existing value.
+ *
+ * @param _fieldType - The field's schema (reserved for future logic)
+ * @param existingValue - Existing value if editing
+ * @returns Initial FieldState
+ */
+export function getInitialFieldState(_fieldType, existingValue) {
+  if (existingValue === undefined) {
+    return {
+      status: "unset"
+    };
+  }
+  if (existingValue === null) {
+    return {
+      status: "null"
+    };
+  }
+  return {
+    status: "set",
+    value: existingValue
+  };
+}
+
+/**
+ * Check if all required fields are filled in the state map.
+ *
+ * @param type - The object schema
+ * @param state - Map of field names to their current state
+ * @returns true if all required fields have values
+ */
+export function allRequiredFieldsFilled(type, state) {
+  const {
+    total,
+    filled
+  } = countRequiredFields(type, state);
+  return filled >= total;
+}
+//# sourceMappingURL=field-utils.js.map

package/dist/esm/Sprinkle/utils/field-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-utils.js","names":["isOptional","isNullable","hasDefault","getDefault","isLiteral","formatValuePreview","countRequiredFields","type","state","fields","properties","total","filled","fieldName","fieldType","Object","entries","fieldState","get","status","isFieldRequired","buildFieldLabel","required","requiredMarker","defaultVal","preview","value","getInitialFieldState","_fieldType","existingValue","undefined","allRequiredFieldsFilled"],"sources":["../../../../src/Sprinkle/utils/field-utils.ts"],"sourcesContent":["/**\n * Field utilities for menu-based struct editing.\n * Provides required field counting and label building.\n */\n\nimport type { TObject, TSchema } from \"@sinclair/typebox\";\nimport type { FieldState, RequiredFieldCount } from \"../types.js\";\nimport {\n  isOptional,\n  isNullable,\n  hasDefault,\n  getDefault,\n  isLiteral,\n} from \"../type-guards.js\";\nimport { formatValuePreview } from \"./formatting.js\";\n\n/**\n * Count required fields in an object schema and how many are filled.\n *\n * @param type - The object schema\n * @param state - Map of field names to their current state\n * @returns Count of total required fields and how many are filled\n */\nexport function countRequiredFields(\n  type: TObject,\n  state: Map<string, FieldState>,\n): RequiredFieldCount {\n  const fields = type.properties as Record<string, TSchema>;\n  let total = 0;\n  let filled = 0;\n\n  for (const [fieldName, fieldType] of Object.entries(fields)) {\n    // Skip optional fields - they're not required\n    if (isOptional(fieldType)) {\n      continue;\n    }\n\n    // Non-nullable fields with defaults don't require user input\n    if (hasDefault(fieldType) && !isNullable(fieldType)) {\n      continue;\n    }\n\n    // Literal fields auto-fill, so they're not required from the user\n    if (isLiteral(fieldType)) {\n      continue;\n    }\n\n    // This is a required field\n    total++;\n\n    // Check if it's filled\n    const fieldState = state.get(fieldName);\n    if (fieldState?.status === \"set\" || fieldState?.status === \"null\") {\n      filled++;\n    }\n  }\n\n  return { total, filled };\n}\n\n/**\n * Determine if a field is required (must have a value to submit).\n *\n * @param fieldType - The field's schema\n * @returns true if the field is required\n */\nexport function isFieldRequired(fieldType: TSchema): boolean {\n  // Optional fields are not required\n  if (isOptional(fieldType)) {\n    return false;\n  }\n\n  // Literal fields auto-fill, so they're not required from the user\n  if (isLiteral(fieldType)) {\n    return false;\n  }\n\n  // Non-nullable fields with defaults are not required (default will be used)\n  if (hasDefault(fieldType) && !isNullable(fieldType)) {\n    return false;\n  }\n\n  return true;\n}\n\n/**\n * Build a display label for a field in the menu.\n *\n * @param fieldName - The field name\n * @param fieldType - The field's schema\n * @param state - The current state of the field\n * @returns Formatted label string\n */\nexport function buildFieldLabel(\n  fieldName: string,\n  fieldType: TSchema,\n  state: FieldState,\n): string {\n  const required = isFieldRequired(fieldType);\n  const requiredMarker = required ? \" *\" : \"\";\n\n  switch (state.status) {\n    case \"unset\": {\n      // Check for default value\n      if (hasDefault(fieldType)) {\n        const defaultVal = getDefault(fieldType);\n        const preview = formatValuePreview(defaultVal, 30);\n        return `${fieldName}: [default: ${preview}]${requiredMarker}`;\n      }\n      return `${fieldName}: [not set]${requiredMarker}`;\n    }\n\n    case \"null\":\n      return `${fieldName}: null${requiredMarker}`;\n\n    case \"set\": {\n      const preview = formatValuePreview(state.value, 40);\n      return `${fieldName}: ${preview}${requiredMarker}`;\n    }\n  }\n}\n\n/**\n * Get the initial FieldState for a field based on its type and any existing value.\n *\n * @param _fieldType - The field's schema (reserved for future logic)\n * @param existingValue - Existing value if editing\n * @returns Initial FieldState\n */\nexport function getInitialFieldState<T>(\n  _fieldType: TSchema,\n  existingValue?: T,\n): FieldState<T> {\n  if (existingValue === undefined) {\n    return { status: \"unset\" };\n  }\n\n  if (existingValue === null) {\n    return { status: \"null\" };\n  }\n\n  return { status: \"set\", value: existingValue };\n}\n\n/**\n * Check if all required fields are filled in the state map.\n *\n * @param type - The object schema\n * @param state - Map of field names to their current state\n * @returns true if all required fields have values\n */\nexport function allRequiredFieldsFilled(\n  type: TObject,\n  state: Map<string, FieldState>,\n): boolean {\n  const { total, filled } = countRequiredFields(type, state);\n  return filled >= total;\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/esm/Sprinkle/utils/formatting.js

@@ -0,0 +1,118 @@
+/**
+ * Formatting utilities for menu-based struct editing.
+ * Provides value preview, path formatting, and breadcrumb generation.
+ */
+
+/**
+ * Format a value for display in a menu item.
+ * Truncates long values and provides type-appropriate previews.
+ *
+ * @param value - The value to format
+ * @param maxLength - Maximum length before truncation (default 40)
+ * @returns Formatted string representation
+ */
+export function formatValuePreview(value, maxLength = 40) {
+  if (value === null) {
+    return "null";
+  }
+  if (value === undefined) {
+    return "[not set]";
+  }
+  if (typeof value === "string") {
+    const escaped = JSON.stringify(value);
+    if (escaped.length <= maxLength) {
+      return escaped;
+    }
+    // Truncate inside the quotes (guard against negative maxLength from recursion)
+    return `"${value.slice(0, Math.max(0, maxLength - 5))}..."`;
+  }
+  if (typeof value === "number" || typeof value === "bigint") {
+    return String(value);
+  }
+  if (typeof value === "boolean") {
+    return String(value);
+  }
+  if (Array.isArray(value)) {
+    return `[${value.length} item${value.length === 1 ? "" : "s"}]`;
+  }
+  if (typeof value === "object") {
+    // For objects, try to show a meaningful preview
+    const keys = Object.keys(value);
+    if (keys.length === 0) {
+      return "{}";
+    }
+
+    // If object has a single key (like union type), show it
+    if (keys.length === 1) {
+      const key = keys[0];
+      const innerValue = value[key];
+      const innerPreview = formatValuePreview(innerValue, maxLength - key.length - 6);
+      const preview = `{ ${key}: ${innerPreview} }`;
+      if (preview.length <= maxLength) {
+        return preview;
+      }
+      return `{ ${key}: ... }`;
+    }
+
+    // Multiple keys - show abbreviated
+    const firstKey = keys[0];
+    return `{ ${firstKey}: ..., +${keys.length - 1} }`;
+  }
+  return String(value).slice(0, maxLength);
+}
+
+/**
+ * Format a path array for display, stripping the "root" prefix.
+ *
+ * @param path - Array of path segments (e.g., ["root", "settings", "name"])
+ * @returns Formatted path string (e.g., "settings.name")
+ */
+export function formatPath(path) {
+  // Filter out "root" prefix
+  const filtered = path.filter(segment => segment !== "root");
+  if (filtered.length === 0) {
+    return "";
+  }
+  return filtered.join(".");
+}
+
+/**
+ * Format a path as a breadcrumb trail for nested navigation.
+ * Truncates from the left if too long.
+ *
+ * @param path - Array of path segments
+ * @param maxLength - Maximum total length (default 50)
+ * @returns Breadcrumb string (e.g., "settings → permissions → mint")
+ */
+export function formatBreadcrumb(path, maxLength = 50) {
+  // Filter out "root" prefix
+  const filtered = path.filter(segment => segment !== "root");
+  if (filtered.length === 0) {
+    return "";
+  }
+  const separator = " \u2192 "; // Unicode right arrow
+  const joined = filtered.join(separator);
+  if (joined.length <= maxLength) {
+    return joined;
+  }
+
+  // Truncate from left, keeping most recent segments
+  const ellipsis = "...";
+  let result = "";
+  for (let i = filtered.length - 1; i >= 0; i--) {
+    const segment = filtered[i];
+    const candidate = i === filtered.length - 1 ? segment : segment + separator + result;
+    if (candidate.length + ellipsis.length + separator.length > maxLength && i < filtered.length - 1) {
+      return ellipsis + separator + result;
+    }
+    result = candidate;
+  }
+
+  // Safety clamp: if we still exceeded maxLength (e.g., last segment alone is too long),
+  // fall back to just the ellipsis to honor the maxLength contract.
+  if (result.length > maxLength) {
+    return ellipsis;
+  }
+  return result;
+}
+//# sourceMappingURL=formatting.js.map

package/dist/esm/Sprinkle/utils/formatting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatting.js","names":["formatValuePreview","value","maxLength","undefined","escaped","JSON","stringify","length","slice","Math","max","String","Array","isArray","keys","Object","key","innerValue","innerPreview","preview","firstKey","formatPath","path","filtered","filter","segment","join","formatBreadcrumb","separator","joined","ellipsis","result","i","candidate"],"sources":["../../../../src/Sprinkle/utils/formatting.ts"],"sourcesContent":["/**\n * Formatting utilities for menu-based struct editing.\n * Provides value preview, path formatting, and breadcrumb generation.\n */\n\n/**\n * Format a value for display in a menu item.\n * Truncates long values and provides type-appropriate previews.\n *\n * @param value - The value to format\n * @param maxLength - Maximum length before truncation (default 40)\n * @returns Formatted string representation\n */\nexport function formatValuePreview(value: unknown, maxLength = 40): string {\n  if (value === null) {\n    return \"null\";\n  }\n\n  if (value === undefined) {\n    return \"[not set]\";\n  }\n\n  if (typeof value === \"string\") {\n    const escaped = JSON.stringify(value);\n    if (escaped.length <= maxLength) {\n      return escaped;\n    }\n    // Truncate inside the quotes (guard against negative maxLength from recursion)\n    return `\"${value.slice(0, Math.max(0, maxLength - 5))}...\"`;\n  }\n\n  if (typeof value === \"number\" || typeof value === \"bigint\") {\n    return String(value);\n  }\n\n  if (typeof value === \"boolean\") {\n    return String(value);\n  }\n\n  if (Array.isArray(value)) {\n    return `[${value.length} item${value.length === 1 ? \"\" : \"s\"}]`;\n  }\n\n  if (typeof value === \"object\") {\n    // For objects, try to show a meaningful preview\n    const keys = Object.keys(value);\n    if (keys.length === 0) {\n      return \"{}\";\n    }\n\n    // If object has a single key (like union type), show it\n    if (keys.length === 1) {\n      const key = keys[0]!;\n      const innerValue = (value as Record<string, unknown>)[key];\n      const innerPreview = formatValuePreview(innerValue, maxLength - key.length - 6);\n      const preview = `{ ${key}: ${innerPreview} }`;\n      if (preview.length <= maxLength) {\n        return preview;\n      }\n      return `{ ${key}: ... }`;\n    }\n\n    // Multiple keys - show abbreviated\n    const firstKey = keys[0]!;\n    return `{ ${firstKey}: ..., +${keys.length - 1} }`;\n  }\n\n  return String(value).slice(0, maxLength);\n}\n\n/**\n * Format a path array for display, stripping the \"root\" prefix.\n *\n * @param path - Array of path segments (e.g., [\"root\", \"settings\", \"name\"])\n * @returns Formatted path string (e.g., \"settings.name\")\n */\nexport function formatPath(path: string[]): string {\n  // Filter out \"root\" prefix\n  const filtered = path.filter((segment) => segment !== \"root\");\n  if (filtered.length === 0) {\n    return \"\";\n  }\n  return filtered.join(\".\");\n}\n\n/**\n * Format a path as a breadcrumb trail for nested navigation.\n * Truncates from the left if too long.\n *\n * @param path - Array of path segments\n * @param maxLength - Maximum total length (default 50)\n * @returns Breadcrumb string (e.g., \"settings → permissions → mint\")\n */\nexport function formatBreadcrumb(path: string[], maxLength = 50): string {\n  // Filter out \"root\" prefix\n  const filtered = path.filter((segment) => segment !== \"root\");\n  if (filtered.length === 0) {\n    return \"\";\n  }\n\n  const separator = \" \\u2192 \"; // Unicode right arrow\n  const joined = filtered.join(separator);\n\n  if (joined.length <= maxLength) {\n    return joined;\n  }\n\n  // Truncate from left, keeping most recent segments\n  const ellipsis = \"...\";\n  let result = \"\";\n  for (let i = filtered.length - 1; i >= 0; i--) {\n    const segment = filtered[i]!;\n    const candidate = i === filtered.length - 1 ? segment : segment + separator + result;\n    if (candidate.length + ellipsis.length + separator.length > maxLength && i < filtered.length - 1) {\n      return ellipsis + separator + result;\n    }\n    result = candidate;\n  }\n\n  // Safety clamp: if we still exceeded maxLength (e.g., last segment alone is too long),\n  // fall back to just the ellipsis to honor the maxLength contract.\n  if (result.length > maxLength) {\n    return ellipsis;\n  }\n\n  return result;\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/esm/Sprinkle/utils/index.js

@@ -0,0 +1,7 @@
+/**
+ * Utility functions for menu-based struct editing.
+ */
+
+export { formatValuePreview, formatPath, formatBreadcrumb } from "./formatting.js";
+export { countRequiredFields, isFieldRequired, buildFieldLabel, getInitialFieldState, allRequiredFieldsFilled } from "./field-utils.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/Sprinkle/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["formatValuePreview","formatPath","formatBreadcrumb","countRequiredFields","isFieldRequired","buildFieldLabel","getInitialFieldState","allRequiredFieldsFilled"],"sources":["../../../../src/Sprinkle/utils/index.ts"],"sourcesContent":["/**\n * Utility functions for menu-based struct editing.\n */\n\nexport {\n  formatValuePreview,\n  formatPath,\n  formatBreadcrumb,\n} from \"./formatting.js\";\n\nexport {\n  countRequiredFields,\n  isFieldRequired,\n  buildFieldLabel,\n  getInitialFieldState,\n  allRequiredFieldsFilled,\n} from \"./field-utils.js\";\n"],"mappings":"AAAA;AACA;AACA;;AAEA,SACEA,kBAAkB,EAClBC,UAAU,EACVC,gBAAgB,QACX,iBAAiB;AAExB,SACEC,mBAAmB,EACnBC,eAAe,EACfC,eAAe,EACfC,oBAAoB,EACpBC,uBAAuB,QAClB,kBAAkB","ignoreList":[]}

package/dist/esm/Sprinkle/wallet.js

@@ -0,0 +1,90 @@
+/**
+ * Wallet and provider setup utilities.
+ * Functions for creating providers, wallets, and Blaze instances.
+ */
+
+import { Blockfrost } from "@blaze-cardano/query";
+import { Blaze, ColdWallet, Core, HotWallet } from "@blaze-cardano/sdk";
+import { wordlist } from "@blaze-cardano/core";
+import { confirmCancellable } from "./prompts.js";
+import { UserCancelledError } from "./types.js";
+/**
+ * Creates a blockchain data provider based on settings.
+ */
+export async function GetProvider(network, settings) {
+  switch (settings.type) {
+    case "blockfrost":
+      return new Blockfrost({
+        network: `cardano-${network}`,
+        projectId: settings.projectId
+      });
+    case "maestro":
+      // Dynamic import - Maestro may or may not be exported depending on @blaze-cardano/query version
+      const queryModule = await import("@blaze-cardano/query");
+      if (!queryModule.Maestro) {
+        throw new Error("Maestro is not available in the installed version of @blaze-cardano/query. Please install a version that includes Maestro support.");
+      }
+      return new queryModule.Maestro({
+        network: network,
+        apiKey: settings.apiKey
+      });
+    default:
+      throw new Error("Invalid provider type");
+  }
+}
+
+/**
+ * Creates a wallet instance based on settings.
+ */
+export async function GetWallet(settings, provider) {
+  switch (settings.type) {
+    case "hot":
+      return HotWallet.fromMasterkey(Core.Bip32PrivateKeyHex(settings.privateKey), provider, provider.network);
+    case "cold":
+      return new ColdWallet(Core.Address.fromBech32(settings.address), provider.network, provider);
+    default:
+      throw new Error("Invalid wallet type");
+  }
+}
+
+/**
+ * Creates a Blaze instance with provider and wallet.
+ */
+export async function GetBlaze(network, providerSettings, walletSettings) {
+  const provider = await GetProvider(network, providerSettings);
+  const wallet = await GetWallet(walletSettings, provider);
+  return Blaze.from(provider, wallet);
+}
+
+/**
+ * Generates a new wallet from a BIP39 mnemonic phrase.
+ * Displays the 24-word recovery phrase and requires user confirmation.
+ * @returns The Bip32PrivateKey hex string for storage
+ */
+export async function generateWalletFromMnemonic() {
+  const mnemonic = Core.generateMnemonic(wordlist, 256); // 24 words
+  const words = mnemonic.split(" ");
+  console.log("\n=== NEW WALLET GENERATED ===\n");
+  console.log("IMPORTANT: Save these 24 words in a secure location.");
+  console.log("This is the ONLY way to recover your wallet.\n");
+
+  // Display in 4 columns
+  for (let i = 0; i < 6; i++) {
+    console.log(`${(i + 1).toString().padStart(2)}. ${words[i].padEnd(12)} ` + `${(i + 7).toString().padStart(2)}. ${words[i + 6].padEnd(12)} ` + `${(i + 13).toString().padStart(2)}. ${words[i + 12].padEnd(12)} ` + `${(i + 19).toString().padStart(2)}. ${words[i + 18]}`);
+  }
+  console.log("");
+  const confirmed = await confirmCancellable({
+    message: "Have you saved your recovery phrase?",
+    default: false
+  });
+  if (confirmed === null) {
+    throw new UserCancelledError("Wallet generation cancelled");
+  }
+  if (!confirmed) {
+    throw new Error("Wallet generation cancelled - recovery phrase not saved");
+  }
+  const entropy = Core.mnemonicToEntropy(mnemonic, wordlist);
+  const masterKey = Core.Bip32PrivateKey.fromBip39Entropy(Buffer.from(entropy), "");
+  return masterKey.hex();
+}
+//# sourceMappingURL=wallet.js.map