@algorandfoundation/algokit-utils 10.0.0-alpha.9 → 10.0.0-beta.2

package/packages/transact/src/transactions/app-call.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"app-call.mjs","names":[],"sources":["../../../../../packages/transact/src/transactions/app-call.ts"],"sourcesContent":["import {\n  Address,\n  MAX_ACCOUNT_REFERENCES,\n  MAX_APP_ARGS,\n  MAX_APP_REFERENCES,\n  MAX_ARGS_SIZE,\n  MAX_ASSET_REFERENCES,\n  MAX_BOX_REFERENCES,\n  MAX_EXTRA_PROGRAM_PAGES,\n  MAX_GLOBAL_STATE_KEYS,\n  MAX_LOCAL_STATE_KEYS,\n  MAX_OVERALL_REFERENCES,\n  PROGRAM_PAGE_SIZE,\n} from '@algorandfoundation/algokit-common'\nimport { TransactionValidationError, TransactionValidationErrorType } from './common'\n\n/**\n * Represents an app call transaction that interacts with Algorand Smart Contracts.\n *\n * App call transactions are used to create, update, delete, opt-in to,\n * close out of, or clear state from Algorand apps (smart contracts).\n */\nexport type AppCallTransactionFields = {\n  /**\n   * ID of the app being called.\n   *\n   * Set this to 0 to indicate an app creation call.\n   */\n  appId: bigint\n\n  /**\n   * Defines what additional actions occur with the transaction.\n   */\n  onComplete: OnApplicationComplete\n\n  /**\n   * Logic executed for every app call transaction, except when\n   * on-completion is set to \"clear\".\n   *\n   * Approval programs may reject the transaction.\n   * Only required for app creation and update transactions.\n   */\n  approvalProgram?: Uint8Array\n\n  /**\n   * Logic executed for app call transactions with on-completion set to \"clear\".\n   *\n   * Clear state programs cannot reject the transaction.\n   * Only required for app creation and update transactions.\n   */\n  clearStateProgram?: Uint8Array\n\n  /**\n   * Holds the maximum number of global state values.\n   *\n   * Only required for app creation transactions.\n   * This cannot be changed after creation.\n   */\n  globalStateSchema?: StateSchema\n\n  /**\n   * Holds the maximum number of local state values.\n   *\n   * Only required for app creation transactions.\n   * This cannot be changed after creation.\n   */\n  localStateSchema?: StateSchema\n\n  /**\n   * Number of additional pages allocated to the app's approval\n   * and clear state programs.\n   *\n   * Each extra program page is 2048 bytes. The sum of approval program\n   * and clear state program may not exceed 2048*(1+extra_program_pages) bytes.\n   * Currently, the maximum value is 3.\n   * This cannot be changed after creation.\n   */\n  extraProgramPages?: number\n\n  /**\n   * Transaction specific arguments available in the app's\n   * approval program and clear state program.\n   */\n  args?: Uint8Array[]\n\n  /**\n   * List of accounts in addition to the sender that may be accessed\n   * from the app's approval program and clear state program.\n   */\n  accountReferences?: Address[]\n\n  /**\n   * List of apps in addition to the current app that may be called\n   * from the app's approval program and clear state program.\n   */\n  appReferences?: bigint[]\n\n  /**\n   * Lists the assets whose parameters may be accessed by this app's\n   * approval program and clear state program.\n   *\n   * The access is read-only.\n   */\n  assetReferences?: bigint[]\n\n  /**\n   * The boxes that should be made available for the runtime of the program.\n   */\n  boxReferences?: BoxReference[]\n\n  /**\n   * Resources accessed by the application\n   */\n  accessReferences?: ResourceReference[]\n\n  /**\n   * If set, the transaction will be rejected when the app's version is greater than or equal to this value. This can be used to prevent calling an app after it has been updated. Set to 0 or leave undefined to skip the version check.\n   * */\n  rejectVersion?: number\n}\n\n/**\n * On-completion actions for application transactions.\n *\n * These values define what additional actions occur with the transaction.\n */\nexport enum OnApplicationComplete {\n  /**\n   * NoOp indicates that an app transaction will simply call its\n   * approval program without any additional action.\n   */\n  NoOp,\n  /**\n   * OptIn indicates that an app transaction will allocate some\n   * local state for the app in the sender's account.\n   */\n  OptIn,\n  /**\n   * CloseOut indicates that an app transaction will deallocate\n   * some local state for the app from the user's account.\n   */\n  CloseOut,\n  /**\n   * ClearState is similar to CloseOut, but may never fail. This\n   * allows users to reclaim their minimum balance from an app\n   * they no longer wish to opt in to.\n   */\n  ClearState,\n  /**\n   * UpdateApplication indicates that an app transaction will\n   * update the approval program and clear state program for the app.\n   */\n  UpdateApplication,\n  /**\n   * DeleteApplication indicates that an app transaction will\n   * delete the app parameters for the app from the creator's\n   * balance record.\n   */\n  DeleteApplication,\n}\n\n/**\n * Schema for app state storage.\n *\n * Defines the maximum number of values that may be stored in app\n * key/value storage for both global and local state.\n */\nexport type StateSchema = {\n  /**\n   * Maximum number of integer values that may be stored.\n   */\n  numUints: number\n\n  /**\n   * Maximum number of byte slice values that may be stored.\n   */\n  numByteSlices: number\n}\n\n/**\n * Box reference for app call transactions.\n *\n * References a specific box that should be made available for the runtime\n * of the program.\n */\nexport type BoxReference = {\n  /**\n   * App ID that owns the box.\n   * A value of 0 indicates the current app.\n   */\n  appId: bigint\n\n  /**\n   * Name of the box.\n   */\n  name: Uint8Array\n}\n\n/**\n * Names a single resource reference. Only one of the fields should be set.\n */\nexport type ResourceReference = {\n  /** Any account addresses whose balance record is accessible by the executing ApprovalProgram or ClearStateProgram. */\n  address?: Address\n  /** Application ID whose GlobalState may be read by the executing ApprovalProgram or ClearStateProgram. */\n  appId?: bigint\n  /** Asset ID whose AssetParams may be read by the executing ApprovalProgram or ClearStateProgram. */\n  assetId?: bigint\n  /** Defines a holding by referring to an Address and Asset it belongs to. */\n  holding?: HoldingReference\n  /** Defines a local state by referring to an Address and App it belongs to. */\n  locals?: LocalsReference\n  /** Defines a box by its name and the application ID it belongs to. */\n  box?: BoxReference\n}\n\n/**\n * A grouping of the asset index and address of the account\n */\nexport type HoldingReference = {\n  /** The asset index of the holding */\n  assetId: bigint\n\n  /** The address of the account holding the asset */\n  address: Address\n}\n\n/** A grouping of the application index and address of the account\n */\nexport type LocalsReference = {\n  /** The application index of the local state */\n  appId: bigint\n\n  /** The address of the account holding the local state */\n  address: Address\n}\n\nconst FIELD_ARGS = 'Args'\nconst FIELD_APPROVAL_PROGRAM = 'Approval program'\nconst FIELD_CLEAR_STATE_PROGRAM = 'Clear state program'\nconst FIELD_GLOBAL_STATE_SCHEMA = 'Global state schema'\nconst FIELD_LOCAL_STATE_SCHEMA = 'Local state schema'\nconst FIELD_EXTRA_PROGRAM_PAGES = 'Extra program pages'\n\n/**\n * Validate app call transaction fields\n */\nexport function validateAppCallTransaction(appCall: AppCallTransactionFields): TransactionValidationError[] {\n  const errors = new Array<TransactionValidationError>()\n\n  if (appCall.appId === 0n) {\n    // App creation\n    errors.push(...validateAppCreation(appCall))\n  } else {\n    // App call, update, or delete\n    errors.push(...validateAppOperation(appCall))\n  }\n\n  // Common validations for all app operations\n  errors.push(...validateAppCommonFields(appCall))\n\n  return errors\n}\n\n/**\n * Validate app creation fields\n */\nfunction validateAppCreation(appCall: AppCallTransactionFields): TransactionValidationError[] {\n  const errors = new Array<TransactionValidationError>()\n\n  if (!appCall.approvalProgram || appCall.approvalProgram.length === 0) {\n    errors.push({ type: TransactionValidationErrorType.RequiredField, data: FIELD_APPROVAL_PROGRAM })\n  }\n\n  if (!appCall.clearStateProgram || appCall.clearStateProgram.length === 0) {\n    errors.push({ type: TransactionValidationErrorType.RequiredField, data: FIELD_CLEAR_STATE_PROGRAM })\n  }\n\n  const extraPages = appCall.extraProgramPages ?? 0\n  if (extraPages > MAX_EXTRA_PROGRAM_PAGES) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: { field: FIELD_EXTRA_PROGRAM_PAGES, actual: extraPages, max: MAX_EXTRA_PROGRAM_PAGES, unit: 'pages' },\n    })\n  }\n\n  const maxProgramSize = PROGRAM_PAGE_SIZE + extraPages * PROGRAM_PAGE_SIZE\n\n  if (appCall.approvalProgram && appCall.approvalProgram.length > maxProgramSize) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: { field: FIELD_APPROVAL_PROGRAM, actual: appCall.approvalProgram.length, max: maxProgramSize, unit: 'bytes' },\n    })\n  }\n\n  if (appCall.clearStateProgram && appCall.clearStateProgram.length > maxProgramSize) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: { field: FIELD_CLEAR_STATE_PROGRAM, actual: appCall.clearStateProgram.length, max: maxProgramSize, unit: 'bytes' },\n    })\n  }\n\n  const totalProgramSize = (appCall.approvalProgram?.length ?? 0) + (appCall.clearStateProgram?.length ?? 0)\n  if (totalProgramSize > maxProgramSize) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: { field: 'Combined approval and clear state programs', actual: totalProgramSize, max: maxProgramSize, unit: 'bytes' },\n    })\n  }\n\n  if (appCall.globalStateSchema) {\n    const totalKeys = appCall.globalStateSchema.numUints + appCall.globalStateSchema.numByteSlices\n    if (totalKeys > MAX_GLOBAL_STATE_KEYS) {\n      errors.push({\n        type: TransactionValidationErrorType.FieldTooLong,\n        data: {\n          field: FIELD_GLOBAL_STATE_SCHEMA,\n          actual: appCall.globalStateSchema.numUints + appCall.globalStateSchema.numByteSlices,\n          max: MAX_GLOBAL_STATE_KEYS,\n          unit: 'keys',\n        },\n      })\n    }\n  }\n\n  if (appCall.localStateSchema) {\n    const totalKeys = appCall.localStateSchema.numUints + appCall.localStateSchema.numByteSlices\n    if (totalKeys > MAX_LOCAL_STATE_KEYS) {\n      errors.push({\n        type: TransactionValidationErrorType.FieldTooLong,\n        data: {\n          field: FIELD_LOCAL_STATE_SCHEMA,\n          actual: appCall.localStateSchema.numUints + appCall.localStateSchema.numByteSlices,\n          max: MAX_LOCAL_STATE_KEYS,\n          unit: 'keys',\n        },\n      })\n    }\n  }\n\n  return errors\n}\n\n/**\n * Validate app operation (update, delete, call) fields\n */\nfunction validateAppOperation(appCall: AppCallTransactionFields): TransactionValidationError[] {\n  const errors = new Array<TransactionValidationError>()\n\n  if (appCall.onComplete === OnApplicationComplete.UpdateApplication) {\n    if (!appCall.approvalProgram || appCall.approvalProgram.length === 0) {\n      errors.push({ type: TransactionValidationErrorType.RequiredField, data: FIELD_APPROVAL_PROGRAM })\n    }\n    if (!appCall.clearStateProgram || appCall.clearStateProgram.length === 0) {\n      errors.push({ type: TransactionValidationErrorType.RequiredField, data: FIELD_CLEAR_STATE_PROGRAM })\n    }\n  }\n\n  // These fields are immutable and cannot be set for existing apps\n  if (appCall.globalStateSchema !== undefined) {\n    errors.push({ type: TransactionValidationErrorType.ImmutableField, data: FIELD_GLOBAL_STATE_SCHEMA })\n  }\n  if (appCall.localStateSchema !== undefined) {\n    errors.push({ type: TransactionValidationErrorType.ImmutableField, data: FIELD_LOCAL_STATE_SCHEMA })\n  }\n  if (appCall.extraProgramPages !== undefined) {\n    errors.push({ type: TransactionValidationErrorType.ImmutableField, data: FIELD_EXTRA_PROGRAM_PAGES })\n  }\n\n  return errors\n}\n\n/**\n * Validate common app call fields\n */\nfunction validateAppCommonFields(appCall: AppCallTransactionFields): TransactionValidationError[] {\n  const errors = new Array<TransactionValidationError>()\n\n  if (appCall.args) {\n    if (appCall.args.length > MAX_APP_ARGS) {\n      errors.push({\n        type: TransactionValidationErrorType.FieldTooLong,\n        data: { field: FIELD_ARGS, actual: appCall.args.length, max: MAX_APP_ARGS, unit: 'arguments' },\n      })\n    }\n\n    const totalArgsSize = appCall.args.reduce((sum, arg) => sum + arg.length, 0)\n    if (totalArgsSize > MAX_ARGS_SIZE) {\n      errors.push({\n        type: TransactionValidationErrorType.FieldTooLong,\n        data: { field: 'Args total size', actual: totalArgsSize, max: MAX_ARGS_SIZE, unit: 'bytes' },\n      })\n    }\n  }\n\n  if (appCall.accountReferences && appCall.accountReferences.length > MAX_ACCOUNT_REFERENCES) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: { field: 'Account references', actual: appCall.accountReferences.length, max: MAX_ACCOUNT_REFERENCES, unit: 'refs' },\n    })\n  }\n\n  if (appCall.appReferences && appCall.appReferences.length > MAX_APP_REFERENCES) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: { field: 'App references', actual: appCall.appReferences.length, max: MAX_APP_REFERENCES, unit: 'refs' },\n    })\n  }\n\n  if (appCall.assetReferences && appCall.assetReferences.length > MAX_ASSET_REFERENCES) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: { field: 'Asset references', actual: appCall.assetReferences.length, max: MAX_ASSET_REFERENCES, unit: 'refs' },\n    })\n  }\n\n  // Validate box references\n  if (appCall.boxReferences) {\n    if (appCall.boxReferences.length > MAX_BOX_REFERENCES) {\n      errors.push({\n        type: TransactionValidationErrorType.FieldTooLong,\n        data: { field: 'Box references', actual: appCall.boxReferences.length, max: MAX_BOX_REFERENCES, unit: 'refs' },\n      })\n    }\n\n    // Validate that box reference app IDs are in app references\n    const appRefs = appCall.appReferences || []\n    for (const boxRef of appCall.boxReferences) {\n      if (boxRef.appId !== 0n && boxRef.appId !== appCall.appId && !appRefs.includes(boxRef.appId)) {\n        errors.push({\n          type: TransactionValidationErrorType.ArbitraryConstraint,\n          data: `Box reference for app ID ${boxRef.appId} must be in app references`,\n        })\n      }\n    }\n  }\n\n  // Validate overall reference count\n  const totalReferences =\n    (appCall.accountReferences?.length || 0) +\n    (appCall.appReferences?.length || 0) +\n    (appCall.assetReferences?.length || 0) +\n    (appCall.boxReferences?.length || 0)\n\n  if (totalReferences > MAX_OVERALL_REFERENCES) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: { field: 'Total references', actual: totalReferences, max: MAX_OVERALL_REFERENCES, unit: 'refs' },\n    })\n  }\n\n  return errors\n}\n"],"mappings":"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"}
+{"version":3,"file":"app-call.mjs","names":[],"sources":["../../../../../packages/transact/src/transactions/app-call.ts"],"sourcesContent":["import {\n  Address,\n  MAX_ACCOUNT_REFERENCES,\n  MAX_APP_ARGS,\n  MAX_APP_REFERENCES,\n  MAX_ARGS_SIZE,\n  MAX_ASSET_REFERENCES,\n  MAX_BOX_REFERENCES,\n  MAX_EXTRA_PROGRAM_PAGES,\n  MAX_GLOBAL_STATE_KEYS,\n  MAX_LOCAL_STATE_KEYS,\n  MAX_OVERALL_REFERENCES,\n  PROGRAM_PAGE_SIZE,\n} from '@algorandfoundation/algokit-common'\nimport { TransactionValidationError, TransactionValidationErrorType } from './common'\n\n/**\n * Represents an app call transaction that interacts with Algorand Smart Contracts.\n *\n * App call transactions are used to create, update, delete, opt-in to,\n * close out of, or clear state from Algorand apps (smart contracts).\n */\nexport type AppCallTransactionFields = {\n  /**\n   * ID of the app being called.\n   *\n   * Set this to 0 to indicate an app creation call.\n   */\n  appId: bigint\n\n  /**\n   * Defines what additional actions occur with the transaction.\n   */\n  onComplete: OnApplicationComplete\n\n  /**\n   * Logic executed for every app call transaction, except when\n   * on-completion is set to \"clear\".\n   *\n   * Approval programs may reject the transaction.\n   * Only required for app creation and update transactions.\n   */\n  approvalProgram?: Uint8Array\n\n  /**\n   * Logic executed for app call transactions with on-completion set to \"clear\".\n   *\n   * Clear state programs cannot reject the transaction.\n   * Only required for app creation and update transactions.\n   */\n  clearStateProgram?: Uint8Array\n\n  /**\n   * Holds the maximum number of global state values.\n   *\n   * Only required for app creation transactions.\n   * This cannot be changed after creation.\n   */\n  globalStateSchema?: StateSchema\n\n  /**\n   * Holds the maximum number of local state values.\n   *\n   * Only required for app creation transactions.\n   * This cannot be changed after creation.\n   */\n  localStateSchema?: StateSchema\n\n  /**\n   * Number of additional pages allocated to the app's approval\n   * and clear state programs.\n   *\n   * Each extra program page is 2048 bytes. The sum of approval program\n   * and clear state program may not exceed 2048*(1+extra_program_pages) bytes.\n   * Currently, the maximum value is 3.\n   * This cannot be changed after creation.\n   */\n  extraProgramPages?: number\n\n  /**\n   * Transaction specific arguments available in the app's\n   * approval program and clear state program.\n   */\n  args?: Uint8Array[]\n\n  /**\n   * List of accounts in addition to the sender that may be accessed\n   * from the app's approval program and clear state program.\n   */\n  accountReferences?: Address[]\n\n  /**\n   * List of apps in addition to the current app that may be called\n   * from the app's approval program and clear state program.\n   */\n  appReferences?: bigint[]\n\n  /**\n   * Lists the assets whose parameters may be accessed by this app's\n   * approval program and clear state program.\n   *\n   * The access is read-only.\n   */\n  assetReferences?: bigint[]\n\n  /**\n   * The boxes that should be made available for the runtime of the program.\n   */\n  boxReferences?: BoxReference[]\n\n  /**\n   * Resources accessed by the application\n   */\n  accessReferences?: ResourceReference[]\n\n  /**\n   * If set, the transaction will be rejected when the app's version is greater than or equal to this value. This can be used to prevent calling an app after it has been updated. Set to 0 or leave undefined to skip the version check.\n   * */\n  rejectVersion?: number\n}\n\n/**\n * On-completion actions for application transactions.\n *\n * These values define what additional actions occur with the transaction.\n */\nexport enum OnApplicationComplete {\n  /**\n   * NoOp indicates that an app transaction will simply call its\n   * approval program without any additional action.\n   */\n  NoOp,\n  /**\n   * OptIn indicates that an app transaction will allocate some\n   * local state for the app in the sender's account.\n   */\n  OptIn,\n  /**\n   * CloseOut indicates that an app transaction will deallocate\n   * some local state for the app from the user's account.\n   */\n  CloseOut,\n  /**\n   * ClearState is similar to CloseOut, but may never fail. This\n   * allows users to reclaim their minimum balance from an app\n   * they no longer wish to opt in to.\n   */\n  ClearState,\n  /**\n   * UpdateApplication indicates that an app transaction will\n   * update the approval program and clear state program for the app.\n   */\n  UpdateApplication,\n  /**\n   * DeleteApplication indicates that an app transaction will\n   * delete the app parameters for the app from the creator's\n   * balance record.\n   */\n  DeleteApplication,\n}\n\n/**\n * Schema for app state storage.\n *\n * Defines the maximum number of values that may be stored in app\n * key/value storage for both global and local state.\n */\nexport type StateSchema = {\n  /**\n   * Maximum number of integer values that may be stored.\n   */\n  numUints: number\n\n  /**\n   * Maximum number of byte slice values that may be stored.\n   */\n  numByteSlices: number\n}\n\n/**\n * Box reference for app call transactions.\n *\n * References a specific box that should be made available for the runtime\n * of the program.\n */\nexport type BoxReference = {\n  /**\n   * App ID that owns the box.\n   * A value of 0 indicates the current app.\n   */\n  appId: bigint\n\n  /**\n   * Name of the box.\n   */\n  name: Uint8Array\n}\n\n/**\n * Names a single resource reference. Only one of the fields should be set.\n */\nexport type ResourceReference = {\n  /** Any account addresses whose balance record is accessible by the executing ApprovalProgram or ClearStateProgram. */\n  address?: Address\n  /** Application ID whose GlobalState may be read by the executing ApprovalProgram or ClearStateProgram. */\n  appId?: bigint\n  /** Asset ID whose AssetParams may be read by the executing ApprovalProgram or ClearStateProgram. */\n  assetId?: bigint\n  /** Defines a holding by referring to an Address and Asset it belongs to. */\n  holding?: HoldingReference\n  /** Defines a local state by referring to an Address and App it belongs to. */\n  locals?: LocalsReference\n  /** Defines a box by its name and the application ID it belongs to. */\n  box?: BoxReference\n}\n\n/**\n * A grouping of the asset index and address of the account\n */\nexport type HoldingReference = {\n  /** The asset index of the holding */\n  assetId: bigint\n\n  /** The address of the account holding the asset */\n  address: Address\n}\n\n/** A grouping of the application index and address of the account\n */\nexport type LocalsReference = {\n  /** The application index of the local state */\n  appId: bigint\n\n  /** The address of the account holding the local state */\n  address: Address\n}\n\nconst FIELD_ARGS = 'Args'\nconst FIELD_APPROVAL_PROGRAM = 'Approval program'\nconst FIELD_CLEAR_STATE_PROGRAM = 'Clear state program'\nconst FIELD_GLOBAL_STATE_SCHEMA = 'Global state schema'\nconst FIELD_LOCAL_STATE_SCHEMA = 'Local state schema'\nconst FIELD_EXTRA_PROGRAM_PAGES = 'Extra program pages'\n\n/**\n * Validate app call transaction fields\n */\nexport function validateAppCallTransaction(appCall: AppCallTransactionFields): TransactionValidationError[] {\n  const errors = new Array<TransactionValidationError>()\n\n  if (appCall.appId === 0n) {\n    // App creation\n    errors.push(...validateAppCreation(appCall))\n  } else {\n    // App call, update, or delete\n    errors.push(...validateAppOperation(appCall))\n  }\n\n  // Common validations for all app operations\n  errors.push(...validateAppCommonFields(appCall))\n\n  return errors\n}\n\n/**\n * Validate app creation fields\n */\nfunction validateAppCreation(appCall: AppCallTransactionFields): TransactionValidationError[] {\n  const errors = new Array<TransactionValidationError>()\n\n  if (!appCall.approvalProgram || appCall.approvalProgram.length === 0) {\n    errors.push({ type: TransactionValidationErrorType.RequiredField, data: FIELD_APPROVAL_PROGRAM })\n  }\n\n  if (!appCall.clearStateProgram || appCall.clearStateProgram.length === 0) {\n    errors.push({ type: TransactionValidationErrorType.RequiredField, data: FIELD_CLEAR_STATE_PROGRAM })\n  }\n\n  const extraPages = appCall.extraProgramPages ?? 0\n  if (extraPages > MAX_EXTRA_PROGRAM_PAGES) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: { field: FIELD_EXTRA_PROGRAM_PAGES, actual: extraPages, max: MAX_EXTRA_PROGRAM_PAGES, unit: 'pages' },\n    })\n  }\n\n  const maxProgramSize = PROGRAM_PAGE_SIZE + extraPages * PROGRAM_PAGE_SIZE\n\n  if (appCall.approvalProgram && appCall.approvalProgram.length > maxProgramSize) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: { field: FIELD_APPROVAL_PROGRAM, actual: appCall.approvalProgram.length, max: maxProgramSize, unit: 'bytes' },\n    })\n  }\n\n  if (appCall.clearStateProgram && appCall.clearStateProgram.length > maxProgramSize) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: { field: FIELD_CLEAR_STATE_PROGRAM, actual: appCall.clearStateProgram.length, max: maxProgramSize, unit: 'bytes' },\n    })\n  }\n\n  const totalProgramSize = (appCall.approvalProgram?.length ?? 0) + (appCall.clearStateProgram?.length ?? 0)\n  if (totalProgramSize > maxProgramSize) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: { field: 'Combined approval and clear state programs', actual: totalProgramSize, max: maxProgramSize, unit: 'bytes' },\n    })\n  }\n\n  if (appCall.globalStateSchema) {\n    const totalKeys = appCall.globalStateSchema.numUints + appCall.globalStateSchema.numByteSlices\n    if (totalKeys > MAX_GLOBAL_STATE_KEYS) {\n      errors.push({\n        type: TransactionValidationErrorType.FieldTooLong,\n        data: {\n          field: FIELD_GLOBAL_STATE_SCHEMA,\n          actual: appCall.globalStateSchema.numUints + appCall.globalStateSchema.numByteSlices,\n          max: MAX_GLOBAL_STATE_KEYS,\n          unit: 'keys',\n        },\n      })\n    }\n  }\n\n  if (appCall.localStateSchema) {\n    const totalKeys = appCall.localStateSchema.numUints + appCall.localStateSchema.numByteSlices\n    if (totalKeys > MAX_LOCAL_STATE_KEYS) {\n      errors.push({\n        type: TransactionValidationErrorType.FieldTooLong,\n        data: {\n          field: FIELD_LOCAL_STATE_SCHEMA,\n          actual: appCall.localStateSchema.numUints + appCall.localStateSchema.numByteSlices,\n          max: MAX_LOCAL_STATE_KEYS,\n          unit: 'keys',\n        },\n      })\n    }\n  }\n\n  return errors\n}\n\n/**\n * Validate app operation (update, delete, call) fields\n */\nfunction validateAppOperation(appCall: AppCallTransactionFields): TransactionValidationError[] {\n  const errors = new Array<TransactionValidationError>()\n\n  if (appCall.onComplete === OnApplicationComplete.UpdateApplication) {\n    if (!appCall.approvalProgram || appCall.approvalProgram.length === 0) {\n      errors.push({ type: TransactionValidationErrorType.RequiredField, data: FIELD_APPROVAL_PROGRAM })\n    }\n    if (!appCall.clearStateProgram || appCall.clearStateProgram.length === 0) {\n      errors.push({ type: TransactionValidationErrorType.RequiredField, data: FIELD_CLEAR_STATE_PROGRAM })\n    }\n  }\n\n  // These fields are immutable and cannot be set for existing apps\n  if (appCall.globalStateSchema !== undefined) {\n    errors.push({ type: TransactionValidationErrorType.ImmutableField, data: FIELD_GLOBAL_STATE_SCHEMA })\n  }\n  if (appCall.localStateSchema !== undefined) {\n    errors.push({ type: TransactionValidationErrorType.ImmutableField, data: FIELD_LOCAL_STATE_SCHEMA })\n  }\n  if (appCall.extraProgramPages !== undefined) {\n    errors.push({ type: TransactionValidationErrorType.ImmutableField, data: FIELD_EXTRA_PROGRAM_PAGES })\n  }\n\n  return errors\n}\n\n/**\n * Validate common app call fields\n */\nfunction validateAppCommonFields(appCall: AppCallTransactionFields): TransactionValidationError[] {\n  const errors = new Array<TransactionValidationError>()\n\n  if (appCall.args) {\n    if (appCall.args.length > MAX_APP_ARGS) {\n      errors.push({\n        type: TransactionValidationErrorType.FieldTooLong,\n        data: { field: FIELD_ARGS, actual: appCall.args.length, max: MAX_APP_ARGS, unit: 'arguments' },\n      })\n    }\n\n    const totalArgsSize = appCall.args.reduce((sum, arg) => sum + arg.length, 0)\n    if (totalArgsSize > MAX_ARGS_SIZE) {\n      errors.push({\n        type: TransactionValidationErrorType.FieldTooLong,\n        data: { field: 'Args total size', actual: totalArgsSize, max: MAX_ARGS_SIZE, unit: 'bytes' },\n      })\n    }\n  }\n\n  if (appCall.accountReferences && appCall.accountReferences.length > MAX_ACCOUNT_REFERENCES) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: { field: 'Account references', actual: appCall.accountReferences.length, max: MAX_ACCOUNT_REFERENCES, unit: 'refs' },\n    })\n  }\n\n  if (appCall.appReferences && appCall.appReferences.length > MAX_APP_REFERENCES) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: { field: 'App references', actual: appCall.appReferences.length, max: MAX_APP_REFERENCES, unit: 'refs' },\n    })\n  }\n\n  if (appCall.assetReferences && appCall.assetReferences.length > MAX_ASSET_REFERENCES) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: { field: 'Asset references', actual: appCall.assetReferences.length, max: MAX_ASSET_REFERENCES, unit: 'refs' },\n    })\n  }\n\n  // Validate box references\n  if (appCall.boxReferences) {\n    if (appCall.boxReferences.length > MAX_BOX_REFERENCES) {\n      errors.push({\n        type: TransactionValidationErrorType.FieldTooLong,\n        data: { field: 'Box references', actual: appCall.boxReferences.length, max: MAX_BOX_REFERENCES, unit: 'refs' },\n      })\n    }\n\n    // Validate that box reference app IDs are in app references\n    const appRefs = appCall.appReferences || []\n    for (const boxRef of appCall.boxReferences) {\n      if (boxRef.appId !== 0n && boxRef.appId !== appCall.appId && !appRefs.includes(boxRef.appId)) {\n        errors.push({\n          type: TransactionValidationErrorType.ArbitraryConstraint,\n          data: `Box reference for app ID ${boxRef.appId} must be in app references`,\n        })\n      }\n    }\n  }\n\n  // Validate overall reference count\n  const totalReferences =\n    (appCall.accountReferences?.length || 0) +\n    (appCall.appReferences?.length || 0) +\n    (appCall.assetReferences?.length || 0) +\n    (appCall.boxReferences?.length || 0)\n\n  if (totalReferences > MAX_OVERALL_REFERENCES) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: { field: 'Total references', actual: totalReferences, max: MAX_OVERALL_REFERENCES, unit: 'refs' },\n    })\n  }\n\n  return errors\n}\n"],"mappings":"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"}

package/packages/transact/src/transactions/asset-config.d.ts

@@ -1,8 +1,6 @@
 import { Address } from "../../../common/src/address.js";
-import { TransactionValidationError } from "./common.js";
 
 //#region packages/transact/src/transactions/asset-config.d.ts
-
 /**
  * Represents an asset configuration transaction that creates, reconfigures, or destroys assets.
  */
@@ -122,10 +120,6 @@ type AssetConfigTransactionFields = {
    */
   clawback?: Address;
 };
-/**
- * Validate asset configuration transaction fields
- */
-declare function validateAssetConfigTransaction(assetConfig: AssetConfigTransactionFields): TransactionValidationError[];
 //#endregion
-export { AssetConfigTransactionFields, validateAssetConfigTransaction };
+export { AssetConfigTransactionFields };
 //# sourceMappingURL=asset-config.d.ts.map

package/packages/transact/src/transactions/asset-config.js

@@ -1,6 +1,5 @@
-const require_constants = require('../../../common/src/constants.js');
-const require_common = require('./common.js');
-
+require("../../../common/src/constants.js");
+const require_common = require("./common.js");
 //#region packages/transact/src/transactions/asset-config.ts
 /**
 * Validate asset configuration transaction fields
@@ -20,39 +19,39 @@ function validateAssetCreation(assetConfig) {
 		type: require_common.TransactionValidationErrorType.RequiredField,
 		data: "Total"
 	});
-	if (assetConfig.decimals !== void 0 && assetConfig.decimals > require_constants.MAX_ASSET_DECIMALS) errors.push({
+	if (assetConfig.decimals !== void 0 && assetConfig.decimals > 19) errors.push({
 		type: require_common.TransactionValidationErrorType.FieldTooLong,
 		data: {
 			field: "Decimals",
 			actual: assetConfig.decimals,
-			max: require_constants.MAX_ASSET_DECIMALS,
+			max: 19,
 			unit: "decimal places"
 		}
 	});
-	if (assetConfig.unitName && assetConfig.unitName.length > require_constants.MAX_ASSET_UNIT_NAME_LENGTH) errors.push({
+	if (assetConfig.unitName && assetConfig.unitName.length > 8) errors.push({
 		type: require_common.TransactionValidationErrorType.FieldTooLong,
 		data: {
 			field: "Unit name",
 			actual: assetConfig.unitName.length,
-			max: require_constants.MAX_ASSET_UNIT_NAME_LENGTH,
+			max: 8,
 			unit: "bytes"
 		}
 	});
-	if (assetConfig.assetName && assetConfig.assetName.length > require_constants.MAX_ASSET_NAME_LENGTH) errors.push({
+	if (assetConfig.assetName && assetConfig.assetName.length > 32) errors.push({
 		type: require_common.TransactionValidationErrorType.FieldTooLong,
 		data: {
 			field: "Asset name",
 			actual: assetConfig.assetName.length,
-			max: require_constants.MAX_ASSET_NAME_LENGTH,
+			max: 32,
 			unit: "bytes"
 		}
 	});
-	if (assetConfig.url && assetConfig.url.length > require_constants.MAX_ASSET_URL_LENGTH) errors.push({
+	if (assetConfig.url && assetConfig.url.length > 96) errors.push({
 		type: require_common.TransactionValidationErrorType.FieldTooLong,
 		data: {
 			field: "Url",
 			actual: assetConfig.url.length,
-			max: require_constants.MAX_ASSET_URL_LENGTH,
+			max: 96,
 			unit: "bytes"
 		}
 	});
@@ -95,7 +94,7 @@ function validateAssetConfiguration(assetConfig) {
 	}
 	return errors;
 }
-
 //#endregion
 exports.validateAssetConfigTransaction = validateAssetConfigTransaction;
+
 //# sourceMappingURL=asset-config.js.map

package/packages/transact/src/transactions/asset-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"asset-config.js","names":["TransactionValidationErrorType","MAX_ASSET_DECIMALS","MAX_ASSET_UNIT_NAME_LENGTH","MAX_ASSET_NAME_LENGTH","MAX_ASSET_URL_LENGTH"],"sources":["../../../../../packages/transact/src/transactions/asset-config.ts"],"sourcesContent":["import {\n  MAX_ASSET_DECIMALS,\n  MAX_ASSET_NAME_LENGTH,\n  MAX_ASSET_UNIT_NAME_LENGTH,\n  MAX_ASSET_URL_LENGTH,\n  Address,\n} from '@algorandfoundation/algokit-common'\nimport { TransactionValidationError, TransactionValidationErrorType } from './common'\n\n/**\n * Represents an asset configuration transaction that creates, reconfigures, or destroys assets.\n */\nexport type AssetConfigTransactionFields = {\n  /**\n   * ID of the asset to operate on.\n   *\n   * For asset creation, this must be 0.\n   * For asset reconfiguration this is the ID of the existing asset to be reconfigured,\n   * For asset destroy this is the ID of the existing asset to be destroyed.\n   */\n  assetId: bigint\n\n  /**\n   * The total amount of the smallest divisible (decimal) unit to create.\n   *\n   * Required when creating a new asset.\n   * For example, if creating a asset with 2 decimals and wanting a total supply of 100 units, this value should be 10000.\n   *\n   * This field can only be specified upon asset creation.\n   */\n  total?: bigint\n\n  /**\n   * The amount of decimal places the asset should have.\n   *\n   * If unspecified then the asset will be in whole units (i.e. `0`).\n   * * If 0, the asset is not divisible;\n   * * If 1, the base unit of the asset is in tenths;\n   * * If 2, the base unit of the asset is in hundredths;\n   * * If 3, the base unit of the asset is in thousandths;\n   *\n   * and so on up to 19 decimal places.\n   *\n   * This field can only be specified upon asset creation.\n   */\n  decimals?: number\n\n  /**\n   * Whether the asset is frozen by default for all accounts.\n   * Defaults to `false`.\n   *\n   * If `true` then for anyone apart from the creator to hold the\n   * asset it needs to be unfrozen per account using an asset freeze\n   * transaction from the `freeze` account, which must be set on creation.\n   *\n   * This field can only be specified upon asset creation.\n   */\n  defaultFrozen?: boolean\n\n  /**\n   * The optional name of the asset.\n   *\n   * Max size is 32 bytes.\n   *\n   * This field can only be specified upon asset creation.\n   */\n  assetName?: string\n\n  /**\n   * The optional name of the unit of this asset (e.g. ticker name).\n   *\n   * Max size is 8 bytes.\n   *\n   * This field can only be specified upon asset creation.\n   */\n  unitName?: string\n\n  /**\n   * Specifies an optional URL where more information about the asset can be retrieved (e.g. metadata).\n   *\n   * Max size is 96 bytes.\n   *\n   * This field can only be specified upon asset creation.\n   */\n  url?: string\n\n  /**\n   * 32-byte hash of some metadata that is relevant to your asset and/or asset holders.\n   *\n   * The format of this metadata is up to the application.\n   *\n   * This field can only be specified upon asset creation.\n   */\n  metadataHash?: Uint8Array\n\n  /**\n   * The address of the optional account that can manage the configuration of the asset and destroy it.\n   *\n   * The configuration fields it can change are `manager`, `reserve`, `clawback`, and `freeze`.\n   *\n   * If not set or set to the Zero address the asset becomes permanently immutable.\n   */\n  manager?: Address\n\n  /**\n   * The address of the optional account that holds the reserve (uncirculated supply) units of the asset.\n   *\n   * This address has no specific authority in the protocol itself and is informational only.\n   *\n   * Some standards like [ARC-19](https://github.com/algorandfoundation/ARCs/blob/main/ARCs/arc-0019.md)\n   * rely on this field to hold meaningful data.\n   *\n   * It can be used in the case where you want to signal to holders of your asset that the uncirculated units\n   * of the asset reside in an account that is different from the default creator account.\n   *\n   * If not set or set to the Zero address the field is permanently empty.\n   */\n  reserve?: Address\n\n  /**\n   * The address of the optional account that can be used to freeze or unfreeze holdings of this asset for any account.\n   *\n   * If empty, freezing is not permitted.\n   *\n   * If not set or set to the Zero address the field is permanently empty.\n   */\n  freeze?: Address\n\n  /**\n   * The address of the optional account that can clawback holdings of this asset from any account.\n   *\n   * **This field should be used with caution** as the clawback account has the ability to **unconditionally take assets from any account**.\n   *\n   * If empty, clawback is not permitted.\n   *\n   * If not set or set to the Zero address the field is permanently empty.\n   */\n  clawback?: Address\n}\n\n/**\n * Validate asset configuration transaction fields\n */\nexport function validateAssetConfigTransaction(assetConfig: AssetConfigTransactionFields): TransactionValidationError[] {\n  const errors = new Array<TransactionValidationError>()\n\n  if (assetConfig.assetId === 0n) {\n    // Asset creation\n    errors.push(...validateAssetCreation(assetConfig))\n  } else {\n    // Asset configuration or destruction\n    errors.push(...validateAssetConfiguration(assetConfig))\n  }\n\n  return errors\n}\n\n/**\n * Validate asset creation fields\n */\nfunction validateAssetCreation(assetConfig: AssetConfigTransactionFields): TransactionValidationError[] {\n  const errors = new Array<TransactionValidationError>()\n\n  if (assetConfig.total === undefined) {\n    errors.push({\n      type: TransactionValidationErrorType.RequiredField,\n      data: 'Total',\n    })\n  }\n\n  if (assetConfig.decimals !== undefined && assetConfig.decimals > MAX_ASSET_DECIMALS) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: {\n        field: 'Decimals',\n        actual: assetConfig.decimals,\n        max: MAX_ASSET_DECIMALS,\n        unit: 'decimal places',\n      },\n    })\n  }\n\n  if (assetConfig.unitName && assetConfig.unitName.length > MAX_ASSET_UNIT_NAME_LENGTH) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: {\n        field: 'Unit name',\n        actual: assetConfig.unitName.length,\n        max: MAX_ASSET_UNIT_NAME_LENGTH,\n        unit: 'bytes',\n      },\n    })\n  }\n\n  if (assetConfig.assetName && assetConfig.assetName.length > MAX_ASSET_NAME_LENGTH) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: {\n        field: 'Asset name',\n        actual: assetConfig.assetName.length,\n        max: MAX_ASSET_NAME_LENGTH,\n        unit: 'bytes',\n      },\n    })\n  }\n\n  if (assetConfig.url && assetConfig.url.length > MAX_ASSET_URL_LENGTH) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: {\n        field: 'Url',\n        actual: assetConfig.url.length,\n        max: MAX_ASSET_URL_LENGTH,\n        unit: 'bytes',\n      },\n    })\n  }\n\n  return errors\n}\n\n/**\n * Validate asset configuration fields\n */\nfunction validateAssetConfiguration(assetConfig: AssetConfigTransactionFields): TransactionValidationError[] {\n  const errors = new Array<TransactionValidationError>()\n\n  const hasAssetParams =\n    assetConfig.total !== undefined ||\n    assetConfig.decimals !== undefined ||\n    assetConfig.defaultFrozen !== undefined ||\n    assetConfig.assetName !== undefined ||\n    assetConfig.unitName !== undefined ||\n    assetConfig.url !== undefined ||\n    assetConfig.metadataHash !== undefined ||\n    assetConfig.manager !== undefined ||\n    assetConfig.reserve !== undefined ||\n    assetConfig.freeze !== undefined ||\n    assetConfig.clawback !== undefined\n\n  if (hasAssetParams) {\n    // These fields are immutable after creation\n    if (assetConfig.total !== undefined) {\n      errors.push({\n        type: TransactionValidationErrorType.ImmutableField,\n        data: 'Total',\n      })\n    }\n    if (assetConfig.decimals !== undefined) {\n      errors.push({\n        type: TransactionValidationErrorType.ImmutableField,\n        data: 'Decimals',\n      })\n    }\n    if (assetConfig.defaultFrozen !== undefined) {\n      errors.push({\n        type: TransactionValidationErrorType.ImmutableField,\n        data: 'Default frozen',\n      })\n    }\n    if (assetConfig.assetName !== undefined) {\n      errors.push({\n        type: TransactionValidationErrorType.ImmutableField,\n        data: 'Asset name',\n      })\n    }\n    if (assetConfig.unitName !== undefined) {\n      errors.push({\n        type: TransactionValidationErrorType.ImmutableField,\n        data: 'Unit name',\n      })\n    }\n    if (assetConfig.url !== undefined) {\n      errors.push({\n        type: TransactionValidationErrorType.ImmutableField,\n        data: 'Url',\n      })\n    }\n    if (assetConfig.metadataHash !== undefined) {\n      errors.push({\n        type: TransactionValidationErrorType.ImmutableField,\n        data: 'Metadata hash',\n      })\n    }\n  }\n\n  return errors\n}\n"],"mappings":";;;;;;;AA+IA,SAAgB,+BAA+B,aAAyE;CACtH,MAAM,SAAS,IAAI,OAAmC;AAEtD,KAAI,YAAY,YAAY,GAE1B,QAAO,KAAK,GAAG,sBAAsB,YAAY,CAAC;KAGlD,QAAO,KAAK,GAAG,2BAA2B,YAAY,CAAC;AAGzD,QAAO;;;;;AAMT,SAAS,sBAAsB,aAAyE;CACtG,MAAM,SAAS,IAAI,OAAmC;AAEtD,KAAI,YAAY,UAAU,OACxB,QAAO,KAAK;EACV,MAAMA,8CAA+B;EACrC,MAAM;EACP,CAAC;AAGJ,KAAI,YAAY,aAAa,UAAa,YAAY,WAAWC,qCAC/D,QAAO,KAAK;EACV,MAAMD,8CAA+B;EACrC,MAAM;GACJ,OAAO;GACP,QAAQ,YAAY;GACpB,KAAKC;GACL,MAAM;GACP;EACF,CAAC;AAGJ,KAAI,YAAY,YAAY,YAAY,SAAS,SAASC,6CACxD,QAAO,KAAK;EACV,MAAMF,8CAA+B;EACrC,MAAM;GACJ,OAAO;GACP,QAAQ,YAAY,SAAS;GAC7B,KAAKE;GACL,MAAM;GACP;EACF,CAAC;AAGJ,KAAI,YAAY,aAAa,YAAY,UAAU,SAASC,wCAC1D,QAAO,KAAK;EACV,MAAMH,8CAA+B;EACrC,MAAM;GACJ,OAAO;GACP,QAAQ,YAAY,UAAU;GAC9B,KAAKG;GACL,MAAM;GACP;EACF,CAAC;AAGJ,KAAI,YAAY,OAAO,YAAY,IAAI,SAASC,uCAC9C,QAAO,KAAK;EACV,MAAMJ,8CAA+B;EACrC,MAAM;GACJ,OAAO;GACP,QAAQ,YAAY,IAAI;GACxB,KAAKI;GACL,MAAM;GACP;EACF,CAAC;AAGJ,QAAO;;;;;AAMT,SAAS,2BAA2B,aAAyE;CAC3G,MAAM,SAAS,IAAI,OAAmC;AAetD,KAZE,YAAY,UAAU,UACtB,YAAY,aAAa,UACzB,YAAY,kBAAkB,UAC9B,YAAY,cAAc,UAC1B,YAAY,aAAa,UACzB,YAAY,QAAQ,UACpB,YAAY,iBAAiB,UAC7B,YAAY,YAAY,UACxB,YAAY,YAAY,UACxB,YAAY,WAAW,UACvB,YAAY,aAAa,QAEP;AAElB,MAAI,YAAY,UAAU,OACxB,QAAO,KAAK;GACV,MAAMJ,8CAA+B;GACrC,MAAM;GACP,CAAC;AAEJ,MAAI,YAAY,aAAa,OAC3B,QAAO,KAAK;GACV,MAAMA,8CAA+B;GACrC,MAAM;GACP,CAAC;AAEJ,MAAI,YAAY,kBAAkB,OAChC,QAAO,KAAK;GACV,MAAMA,8CAA+B;GACrC,MAAM;GACP,CAAC;AAEJ,MAAI,YAAY,cAAc,OAC5B,QAAO,KAAK;GACV,MAAMA,8CAA+B;GACrC,MAAM;GACP,CAAC;AAEJ,MAAI,YAAY,aAAa,OAC3B,QAAO,KAAK;GACV,MAAMA,8CAA+B;GACrC,MAAM;GACP,CAAC;AAEJ,MAAI,YAAY,QAAQ,OACtB,QAAO,KAAK;GACV,MAAMA,8CAA+B;GACrC,MAAM;GACP,CAAC;AAEJ,MAAI,YAAY,iBAAiB,OAC/B,QAAO,KAAK;GACV,MAAMA,8CAA+B;GACrC,MAAM;GACP,CAAC;;AAIN,QAAO"}
+{"version":3,"file":"asset-config.js","names":["TransactionValidationErrorType"],"sources":["../../../../../packages/transact/src/transactions/asset-config.ts"],"sourcesContent":["import {\n  Address,\n  MAX_ASSET_DECIMALS,\n  MAX_ASSET_NAME_LENGTH,\n  MAX_ASSET_UNIT_NAME_LENGTH,\n  MAX_ASSET_URL_LENGTH,\n} from '@algorandfoundation/algokit-common'\nimport { TransactionValidationError, TransactionValidationErrorType } from './common'\n\n/**\n * Represents an asset configuration transaction that creates, reconfigures, or destroys assets.\n */\nexport type AssetConfigTransactionFields = {\n  /**\n   * ID of the asset to operate on.\n   *\n   * For asset creation, this must be 0.\n   * For asset reconfiguration this is the ID of the existing asset to be reconfigured,\n   * For asset destroy this is the ID of the existing asset to be destroyed.\n   */\n  assetId: bigint\n\n  /**\n   * The total amount of the smallest divisible (decimal) unit to create.\n   *\n   * Required when creating a new asset.\n   * For example, if creating a asset with 2 decimals and wanting a total supply of 100 units, this value should be 10000.\n   *\n   * This field can only be specified upon asset creation.\n   */\n  total?: bigint\n\n  /**\n   * The amount of decimal places the asset should have.\n   *\n   * If unspecified then the asset will be in whole units (i.e. `0`).\n   * * If 0, the asset is not divisible;\n   * * If 1, the base unit of the asset is in tenths;\n   * * If 2, the base unit of the asset is in hundredths;\n   * * If 3, the base unit of the asset is in thousandths;\n   *\n   * and so on up to 19 decimal places.\n   *\n   * This field can only be specified upon asset creation.\n   */\n  decimals?: number\n\n  /**\n   * Whether the asset is frozen by default for all accounts.\n   * Defaults to `false`.\n   *\n   * If `true` then for anyone apart from the creator to hold the\n   * asset it needs to be unfrozen per account using an asset freeze\n   * transaction from the `freeze` account, which must be set on creation.\n   *\n   * This field can only be specified upon asset creation.\n   */\n  defaultFrozen?: boolean\n\n  /**\n   * The optional name of the asset.\n   *\n   * Max size is 32 bytes.\n   *\n   * This field can only be specified upon asset creation.\n   */\n  assetName?: string\n\n  /**\n   * The optional name of the unit of this asset (e.g. ticker name).\n   *\n   * Max size is 8 bytes.\n   *\n   * This field can only be specified upon asset creation.\n   */\n  unitName?: string\n\n  /**\n   * Specifies an optional URL where more information about the asset can be retrieved (e.g. metadata).\n   *\n   * Max size is 96 bytes.\n   *\n   * This field can only be specified upon asset creation.\n   */\n  url?: string\n\n  /**\n   * 32-byte hash of some metadata that is relevant to your asset and/or asset holders.\n   *\n   * The format of this metadata is up to the application.\n   *\n   * This field can only be specified upon asset creation.\n   */\n  metadataHash?: Uint8Array\n\n  /**\n   * The address of the optional account that can manage the configuration of the asset and destroy it.\n   *\n   * The configuration fields it can change are `manager`, `reserve`, `clawback`, and `freeze`.\n   *\n   * If not set or set to the Zero address the asset becomes permanently immutable.\n   */\n  manager?: Address\n\n  /**\n   * The address of the optional account that holds the reserve (uncirculated supply) units of the asset.\n   *\n   * This address has no specific authority in the protocol itself and is informational only.\n   *\n   * Some standards like [ARC-19](https://github.com/algorandfoundation/ARCs/blob/main/ARCs/arc-0019.md)\n   * rely on this field to hold meaningful data.\n   *\n   * It can be used in the case where you want to signal to holders of your asset that the uncirculated units\n   * of the asset reside in an account that is different from the default creator account.\n   *\n   * If not set or set to the Zero address the field is permanently empty.\n   */\n  reserve?: Address\n\n  /**\n   * The address of the optional account that can be used to freeze or unfreeze holdings of this asset for any account.\n   *\n   * If empty, freezing is not permitted.\n   *\n   * If not set or set to the Zero address the field is permanently empty.\n   */\n  freeze?: Address\n\n  /**\n   * The address of the optional account that can clawback holdings of this asset from any account.\n   *\n   * **This field should be used with caution** as the clawback account has the ability to **unconditionally take assets from any account**.\n   *\n   * If empty, clawback is not permitted.\n   *\n   * If not set or set to the Zero address the field is permanently empty.\n   */\n  clawback?: Address\n}\n\n/**\n * Validate asset configuration transaction fields\n */\nexport function validateAssetConfigTransaction(assetConfig: AssetConfigTransactionFields): TransactionValidationError[] {\n  const errors = new Array<TransactionValidationError>()\n\n  if (assetConfig.assetId === 0n) {\n    // Asset creation\n    errors.push(...validateAssetCreation(assetConfig))\n  } else {\n    // Asset configuration or destruction\n    errors.push(...validateAssetConfiguration(assetConfig))\n  }\n\n  return errors\n}\n\n/**\n * Validate asset creation fields\n */\nfunction validateAssetCreation(assetConfig: AssetConfigTransactionFields): TransactionValidationError[] {\n  const errors = new Array<TransactionValidationError>()\n\n  if (assetConfig.total === undefined) {\n    errors.push({\n      type: TransactionValidationErrorType.RequiredField,\n      data: 'Total',\n    })\n  }\n\n  if (assetConfig.decimals !== undefined && assetConfig.decimals > MAX_ASSET_DECIMALS) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: {\n        field: 'Decimals',\n        actual: assetConfig.decimals,\n        max: MAX_ASSET_DECIMALS,\n        unit: 'decimal places',\n      },\n    })\n  }\n\n  if (assetConfig.unitName && assetConfig.unitName.length > MAX_ASSET_UNIT_NAME_LENGTH) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: {\n        field: 'Unit name',\n        actual: assetConfig.unitName.length,\n        max: MAX_ASSET_UNIT_NAME_LENGTH,\n        unit: 'bytes',\n      },\n    })\n  }\n\n  if (assetConfig.assetName && assetConfig.assetName.length > MAX_ASSET_NAME_LENGTH) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: {\n        field: 'Asset name',\n        actual: assetConfig.assetName.length,\n        max: MAX_ASSET_NAME_LENGTH,\n        unit: 'bytes',\n      },\n    })\n  }\n\n  if (assetConfig.url && assetConfig.url.length > MAX_ASSET_URL_LENGTH) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: {\n        field: 'Url',\n        actual: assetConfig.url.length,\n        max: MAX_ASSET_URL_LENGTH,\n        unit: 'bytes',\n      },\n    })\n  }\n\n  return errors\n}\n\n/**\n * Validate asset configuration fields\n */\nfunction validateAssetConfiguration(assetConfig: AssetConfigTransactionFields): TransactionValidationError[] {\n  const errors = new Array<TransactionValidationError>()\n\n  const hasAssetParams =\n    assetConfig.total !== undefined ||\n    assetConfig.decimals !== undefined ||\n    assetConfig.defaultFrozen !== undefined ||\n    assetConfig.assetName !== undefined ||\n    assetConfig.unitName !== undefined ||\n    assetConfig.url !== undefined ||\n    assetConfig.metadataHash !== undefined ||\n    assetConfig.manager !== undefined ||\n    assetConfig.reserve !== undefined ||\n    assetConfig.freeze !== undefined ||\n    assetConfig.clawback !== undefined\n\n  if (hasAssetParams) {\n    // These fields are immutable after creation\n    if (assetConfig.total !== undefined) {\n      errors.push({\n        type: TransactionValidationErrorType.ImmutableField,\n        data: 'Total',\n      })\n    }\n    if (assetConfig.decimals !== undefined) {\n      errors.push({\n        type: TransactionValidationErrorType.ImmutableField,\n        data: 'Decimals',\n      })\n    }\n    if (assetConfig.defaultFrozen !== undefined) {\n      errors.push({\n        type: TransactionValidationErrorType.ImmutableField,\n        data: 'Default frozen',\n      })\n    }\n    if (assetConfig.assetName !== undefined) {\n      errors.push({\n        type: TransactionValidationErrorType.ImmutableField,\n        data: 'Asset name',\n      })\n    }\n    if (assetConfig.unitName !== undefined) {\n      errors.push({\n        type: TransactionValidationErrorType.ImmutableField,\n        data: 'Unit name',\n      })\n    }\n    if (assetConfig.url !== undefined) {\n      errors.push({\n        type: TransactionValidationErrorType.ImmutableField,\n        data: 'Url',\n      })\n    }\n    if (assetConfig.metadataHash !== undefined) {\n      errors.push({\n        type: TransactionValidationErrorType.ImmutableField,\n        data: 'Metadata hash',\n      })\n    }\n  }\n\n  return errors\n}\n"],"mappings":";;;;;;AA+IA,SAAgB,+BAA+B,aAAyE;CACtH,MAAM,SAAS,IAAI,OAAmC;AAEtD,KAAI,YAAY,YAAY,GAE1B,QAAO,KAAK,GAAG,sBAAsB,YAAY,CAAC;KAGlD,QAAO,KAAK,GAAG,2BAA2B,YAAY,CAAC;AAGzD,QAAO;;;;;AAMT,SAAS,sBAAsB,aAAyE;CACtG,MAAM,SAAS,IAAI,OAAmC;AAEtD,KAAI,YAAY,UAAU,KAAA,EACxB,QAAO,KAAK;EACV,MAAMA,eAAAA,+BAA+B;EACrC,MAAM;EACP,CAAC;AAGJ,KAAI,YAAY,aAAa,KAAA,KAAa,YAAY,WAAA,GACpD,QAAO,KAAK;EACV,MAAMA,eAAAA,+BAA+B;EACrC,MAAM;GACJ,OAAO;GACP,QAAQ,YAAY;GACpB,KAAA;GACA,MAAM;GACP;EACF,CAAC;AAGJ,KAAI,YAAY,YAAY,YAAY,SAAS,SAAA,EAC/C,QAAO,KAAK;EACV,MAAMA,eAAAA,+BAA+B;EACrC,MAAM;GACJ,OAAO;GACP,QAAQ,YAAY,SAAS;GAC7B,KAAA;GACA,MAAM;GACP;EACF,CAAC;AAGJ,KAAI,YAAY,aAAa,YAAY,UAAU,SAAA,GACjD,QAAO,KAAK;EACV,MAAMA,eAAAA,+BAA+B;EACrC,MAAM;GACJ,OAAO;GACP,QAAQ,YAAY,UAAU;GAC9B,KAAA;GACA,MAAM;GACP;EACF,CAAC;AAGJ,KAAI,YAAY,OAAO,YAAY,IAAI,SAAA,GACrC,QAAO,KAAK;EACV,MAAMA,eAAAA,+BAA+B;EACrC,MAAM;GACJ,OAAO;GACP,QAAQ,YAAY,IAAI;GACxB,KAAA;GACA,MAAM;GACP;EACF,CAAC;AAGJ,QAAO;;;;;AAMT,SAAS,2BAA2B,aAAyE;CAC3G,MAAM,SAAS,IAAI,OAAmC;AAetD,KAZE,YAAY,UAAU,KAAA,KACtB,YAAY,aAAa,KAAA,KACzB,YAAY,kBAAkB,KAAA,KAC9B,YAAY,cAAc,KAAA,KAC1B,YAAY,aAAa,KAAA,KACzB,YAAY,QAAQ,KAAA,KACpB,YAAY,iBAAiB,KAAA,KAC7B,YAAY,YAAY,KAAA,KACxB,YAAY,YAAY,KAAA,KACxB,YAAY,WAAW,KAAA,KACvB,YAAY,aAAa,KAAA,GAEP;AAElB,MAAI,YAAY,UAAU,KAAA,EACxB,QAAO,KAAK;GACV,MAAMA,eAAAA,+BAA+B;GACrC,MAAM;GACP,CAAC;AAEJ,MAAI,YAAY,aAAa,KAAA,EAC3B,QAAO,KAAK;GACV,MAAMA,eAAAA,+BAA+B;GACrC,MAAM;GACP,CAAC;AAEJ,MAAI,YAAY,kBAAkB,KAAA,EAChC,QAAO,KAAK;GACV,MAAMA,eAAAA,+BAA+B;GACrC,MAAM;GACP,CAAC;AAEJ,MAAI,YAAY,cAAc,KAAA,EAC5B,QAAO,KAAK;GACV,MAAMA,eAAAA,+BAA+B;GACrC,MAAM;GACP,CAAC;AAEJ,MAAI,YAAY,aAAa,KAAA,EAC3B,QAAO,KAAK;GACV,MAAMA,eAAAA,+BAA+B;GACrC,MAAM;GACP,CAAC;AAEJ,MAAI,YAAY,QAAQ,KAAA,EACtB,QAAO,KAAK;GACV,MAAMA,eAAAA,+BAA+B;GACrC,MAAM;GACP,CAAC;AAEJ,MAAI,YAAY,iBAAiB,KAAA,EAC/B,QAAO,KAAK;GACV,MAAMA,eAAAA,+BAA+B;GACrC,MAAM;GACP,CAAC;;AAIN,QAAO"}

package/packages/transact/src/transactions/asset-config.mjs

@@ -1,6 +1,5 @@
-import { MAX_ASSET_DECIMALS, MAX_ASSET_NAME_LENGTH, MAX_ASSET_UNIT_NAME_LENGTH, MAX_ASSET_URL_LENGTH } from "../../../common/src/constants.mjs";
+import "../../../common/src/constants.mjs";
 import { TransactionValidationErrorType } from "./common.mjs";
-
 //#region packages/transact/src/transactions/asset-config.ts
 /**
 * Validate asset configuration transaction fields
@@ -20,39 +19,39 @@ function validateAssetCreation(assetConfig) {
 		type: TransactionValidationErrorType.RequiredField,
 		data: "Total"
 	});
-	if (assetConfig.decimals !== void 0 && assetConfig.decimals > MAX_ASSET_DECIMALS) errors.push({
+	if (assetConfig.decimals !== void 0 && assetConfig.decimals > 19) errors.push({
 		type: TransactionValidationErrorType.FieldTooLong,
 		data: {
 			field: "Decimals",
 			actual: assetConfig.decimals,
-			max: MAX_ASSET_DECIMALS,
+			max: 19,
 			unit: "decimal places"
 		}
 	});
-	if (assetConfig.unitName && assetConfig.unitName.length > MAX_ASSET_UNIT_NAME_LENGTH) errors.push({
+	if (assetConfig.unitName && assetConfig.unitName.length > 8) errors.push({
 		type: TransactionValidationErrorType.FieldTooLong,
 		data: {
 			field: "Unit name",
 			actual: assetConfig.unitName.length,
-			max: MAX_ASSET_UNIT_NAME_LENGTH,
+			max: 8,
 			unit: "bytes"
 		}
 	});
-	if (assetConfig.assetName && assetConfig.assetName.length > MAX_ASSET_NAME_LENGTH) errors.push({
+	if (assetConfig.assetName && assetConfig.assetName.length > 32) errors.push({
 		type: TransactionValidationErrorType.FieldTooLong,
 		data: {
 			field: "Asset name",
 			actual: assetConfig.assetName.length,
-			max: MAX_ASSET_NAME_LENGTH,
+			max: 32,
 			unit: "bytes"
 		}
 	});
-	if (assetConfig.url && assetConfig.url.length > MAX_ASSET_URL_LENGTH) errors.push({
+	if (assetConfig.url && assetConfig.url.length > 96) errors.push({
 		type: TransactionValidationErrorType.FieldTooLong,
 		data: {
 			field: "Url",
 			actual: assetConfig.url.length,
-			max: MAX_ASSET_URL_LENGTH,
+			max: 96,
 			unit: "bytes"
 		}
 	});
@@ -95,7 +94,7 @@ function validateAssetConfiguration(assetConfig) {
 	}
 	return errors;
 }
-
 //#endregion
 export { validateAssetConfigTransaction };
+
 //# sourceMappingURL=asset-config.mjs.map

package/packages/transact/src/transactions/asset-config.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"asset-config.mjs","names":[],"sources":["../../../../../packages/transact/src/transactions/asset-config.ts"],"sourcesContent":["import {\n  MAX_ASSET_DECIMALS,\n  MAX_ASSET_NAME_LENGTH,\n  MAX_ASSET_UNIT_NAME_LENGTH,\n  MAX_ASSET_URL_LENGTH,\n  Address,\n} from '@algorandfoundation/algokit-common'\nimport { TransactionValidationError, TransactionValidationErrorType } from './common'\n\n/**\n * Represents an asset configuration transaction that creates, reconfigures, or destroys assets.\n */\nexport type AssetConfigTransactionFields = {\n  /**\n   * ID of the asset to operate on.\n   *\n   * For asset creation, this must be 0.\n   * For asset reconfiguration this is the ID of the existing asset to be reconfigured,\n   * For asset destroy this is the ID of the existing asset to be destroyed.\n   */\n  assetId: bigint\n\n  /**\n   * The total amount of the smallest divisible (decimal) unit to create.\n   *\n   * Required when creating a new asset.\n   * For example, if creating a asset with 2 decimals and wanting a total supply of 100 units, this value should be 10000.\n   *\n   * This field can only be specified upon asset creation.\n   */\n  total?: bigint\n\n  /**\n   * The amount of decimal places the asset should have.\n   *\n   * If unspecified then the asset will be in whole units (i.e. `0`).\n   * * If 0, the asset is not divisible;\n   * * If 1, the base unit of the asset is in tenths;\n   * * If 2, the base unit of the asset is in hundredths;\n   * * If 3, the base unit of the asset is in thousandths;\n   *\n   * and so on up to 19 decimal places.\n   *\n   * This field can only be specified upon asset creation.\n   */\n  decimals?: number\n\n  /**\n   * Whether the asset is frozen by default for all accounts.\n   * Defaults to `false`.\n   *\n   * If `true` then for anyone apart from the creator to hold the\n   * asset it needs to be unfrozen per account using an asset freeze\n   * transaction from the `freeze` account, which must be set on creation.\n   *\n   * This field can only be specified upon asset creation.\n   */\n  defaultFrozen?: boolean\n\n  /**\n   * The optional name of the asset.\n   *\n   * Max size is 32 bytes.\n   *\n   * This field can only be specified upon asset creation.\n   */\n  assetName?: string\n\n  /**\n   * The optional name of the unit of this asset (e.g. ticker name).\n   *\n   * Max size is 8 bytes.\n   *\n   * This field can only be specified upon asset creation.\n   */\n  unitName?: string\n\n  /**\n   * Specifies an optional URL where more information about the asset can be retrieved (e.g. metadata).\n   *\n   * Max size is 96 bytes.\n   *\n   * This field can only be specified upon asset creation.\n   */\n  url?: string\n\n  /**\n   * 32-byte hash of some metadata that is relevant to your asset and/or asset holders.\n   *\n   * The format of this metadata is up to the application.\n   *\n   * This field can only be specified upon asset creation.\n   */\n  metadataHash?: Uint8Array\n\n  /**\n   * The address of the optional account that can manage the configuration of the asset and destroy it.\n   *\n   * The configuration fields it can change are `manager`, `reserve`, `clawback`, and `freeze`.\n   *\n   * If not set or set to the Zero address the asset becomes permanently immutable.\n   */\n  manager?: Address\n\n  /**\n   * The address of the optional account that holds the reserve (uncirculated supply) units of the asset.\n   *\n   * This address has no specific authority in the protocol itself and is informational only.\n   *\n   * Some standards like [ARC-19](https://github.com/algorandfoundation/ARCs/blob/main/ARCs/arc-0019.md)\n   * rely on this field to hold meaningful data.\n   *\n   * It can be used in the case where you want to signal to holders of your asset that the uncirculated units\n   * of the asset reside in an account that is different from the default creator account.\n   *\n   * If not set or set to the Zero address the field is permanently empty.\n   */\n  reserve?: Address\n\n  /**\n   * The address of the optional account that can be used to freeze or unfreeze holdings of this asset for any account.\n   *\n   * If empty, freezing is not permitted.\n   *\n   * If not set or set to the Zero address the field is permanently empty.\n   */\n  freeze?: Address\n\n  /**\n   * The address of the optional account that can clawback holdings of this asset from any account.\n   *\n   * **This field should be used with caution** as the clawback account has the ability to **unconditionally take assets from any account**.\n   *\n   * If empty, clawback is not permitted.\n   *\n   * If not set or set to the Zero address the field is permanently empty.\n   */\n  clawback?: Address\n}\n\n/**\n * Validate asset configuration transaction fields\n */\nexport function validateAssetConfigTransaction(assetConfig: AssetConfigTransactionFields): TransactionValidationError[] {\n  const errors = new Array<TransactionValidationError>()\n\n  if (assetConfig.assetId === 0n) {\n    // Asset creation\n    errors.push(...validateAssetCreation(assetConfig))\n  } else {\n    // Asset configuration or destruction\n    errors.push(...validateAssetConfiguration(assetConfig))\n  }\n\n  return errors\n}\n\n/**\n * Validate asset creation fields\n */\nfunction validateAssetCreation(assetConfig: AssetConfigTransactionFields): TransactionValidationError[] {\n  const errors = new Array<TransactionValidationError>()\n\n  if (assetConfig.total === undefined) {\n    errors.push({\n      type: TransactionValidationErrorType.RequiredField,\n      data: 'Total',\n    })\n  }\n\n  if (assetConfig.decimals !== undefined && assetConfig.decimals > MAX_ASSET_DECIMALS) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: {\n        field: 'Decimals',\n        actual: assetConfig.decimals,\n        max: MAX_ASSET_DECIMALS,\n        unit: 'decimal places',\n      },\n    })\n  }\n\n  if (assetConfig.unitName && assetConfig.unitName.length > MAX_ASSET_UNIT_NAME_LENGTH) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: {\n        field: 'Unit name',\n        actual: assetConfig.unitName.length,\n        max: MAX_ASSET_UNIT_NAME_LENGTH,\n        unit: 'bytes',\n      },\n    })\n  }\n\n  if (assetConfig.assetName && assetConfig.assetName.length > MAX_ASSET_NAME_LENGTH) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: {\n        field: 'Asset name',\n        actual: assetConfig.assetName.length,\n        max: MAX_ASSET_NAME_LENGTH,\n        unit: 'bytes',\n      },\n    })\n  }\n\n  if (assetConfig.url && assetConfig.url.length > MAX_ASSET_URL_LENGTH) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: {\n        field: 'Url',\n        actual: assetConfig.url.length,\n        max: MAX_ASSET_URL_LENGTH,\n        unit: 'bytes',\n      },\n    })\n  }\n\n  return errors\n}\n\n/**\n * Validate asset configuration fields\n */\nfunction validateAssetConfiguration(assetConfig: AssetConfigTransactionFields): TransactionValidationError[] {\n  const errors = new Array<TransactionValidationError>()\n\n  const hasAssetParams =\n    assetConfig.total !== undefined ||\n    assetConfig.decimals !== undefined ||\n    assetConfig.defaultFrozen !== undefined ||\n    assetConfig.assetName !== undefined ||\n    assetConfig.unitName !== undefined ||\n    assetConfig.url !== undefined ||\n    assetConfig.metadataHash !== undefined ||\n    assetConfig.manager !== undefined ||\n    assetConfig.reserve !== undefined ||\n    assetConfig.freeze !== undefined ||\n    assetConfig.clawback !== undefined\n\n  if (hasAssetParams) {\n    // These fields are immutable after creation\n    if (assetConfig.total !== undefined) {\n      errors.push({\n        type: TransactionValidationErrorType.ImmutableField,\n        data: 'Total',\n      })\n    }\n    if (assetConfig.decimals !== undefined) {\n      errors.push({\n        type: TransactionValidationErrorType.ImmutableField,\n        data: 'Decimals',\n      })\n    }\n    if (assetConfig.defaultFrozen !== undefined) {\n      errors.push({\n        type: TransactionValidationErrorType.ImmutableField,\n        data: 'Default frozen',\n      })\n    }\n    if (assetConfig.assetName !== undefined) {\n      errors.push({\n        type: TransactionValidationErrorType.ImmutableField,\n        data: 'Asset name',\n      })\n    }\n    if (assetConfig.unitName !== undefined) {\n      errors.push({\n        type: TransactionValidationErrorType.ImmutableField,\n        data: 'Unit name',\n      })\n    }\n    if (assetConfig.url !== undefined) {\n      errors.push({\n        type: TransactionValidationErrorType.ImmutableField,\n        data: 'Url',\n      })\n    }\n    if (assetConfig.metadataHash !== undefined) {\n      errors.push({\n        type: TransactionValidationErrorType.ImmutableField,\n        data: 'Metadata hash',\n      })\n    }\n  }\n\n  return errors\n}\n"],"mappings":";;;;;;;AA+IA,SAAgB,+BAA+B,aAAyE;CACtH,MAAM,SAAS,IAAI,OAAmC;AAEtD,KAAI,YAAY,YAAY,GAE1B,QAAO,KAAK,GAAG,sBAAsB,YAAY,CAAC;KAGlD,QAAO,KAAK,GAAG,2BAA2B,YAAY,CAAC;AAGzD,QAAO;;;;;AAMT,SAAS,sBAAsB,aAAyE;CACtG,MAAM,SAAS,IAAI,OAAmC;AAEtD,KAAI,YAAY,UAAU,OACxB,QAAO,KAAK;EACV,MAAM,+BAA+B;EACrC,MAAM;EACP,CAAC;AAGJ,KAAI,YAAY,aAAa,UAAa,YAAY,WAAW,mBAC/D,QAAO,KAAK;EACV,MAAM,+BAA+B;EACrC,MAAM;GACJ,OAAO;GACP,QAAQ,YAAY;GACpB,KAAK;GACL,MAAM;GACP;EACF,CAAC;AAGJ,KAAI,YAAY,YAAY,YAAY,SAAS,SAAS,2BACxD,QAAO,KAAK;EACV,MAAM,+BAA+B;EACrC,MAAM;GACJ,OAAO;GACP,QAAQ,YAAY,SAAS;GAC7B,KAAK;GACL,MAAM;GACP;EACF,CAAC;AAGJ,KAAI,YAAY,aAAa,YAAY,UAAU,SAAS,sBAC1D,QAAO,KAAK;EACV,MAAM,+BAA+B;EACrC,MAAM;GACJ,OAAO;GACP,QAAQ,YAAY,UAAU;GAC9B,KAAK;GACL,MAAM;GACP;EACF,CAAC;AAGJ,KAAI,YAAY,OAAO,YAAY,IAAI,SAAS,qBAC9C,QAAO,KAAK;EACV,MAAM,+BAA+B;EACrC,MAAM;GACJ,OAAO;GACP,QAAQ,YAAY,IAAI;GACxB,KAAK;GACL,MAAM;GACP;EACF,CAAC;AAGJ,QAAO;;;;;AAMT,SAAS,2BAA2B,aAAyE;CAC3G,MAAM,SAAS,IAAI,OAAmC;AAetD,KAZE,YAAY,UAAU,UACtB,YAAY,aAAa,UACzB,YAAY,kBAAkB,UAC9B,YAAY,cAAc,UAC1B,YAAY,aAAa,UACzB,YAAY,QAAQ,UACpB,YAAY,iBAAiB,UAC7B,YAAY,YAAY,UACxB,YAAY,YAAY,UACxB,YAAY,WAAW,UACvB,YAAY,aAAa,QAEP;AAElB,MAAI,YAAY,UAAU,OACxB,QAAO,KAAK;GACV,MAAM,+BAA+B;GACrC,MAAM;GACP,CAAC;AAEJ,MAAI,YAAY,aAAa,OAC3B,QAAO,KAAK;GACV,MAAM,+BAA+B;GACrC,MAAM;GACP,CAAC;AAEJ,MAAI,YAAY,kBAAkB,OAChC,QAAO,KAAK;GACV,MAAM,+BAA+B;GACrC,MAAM;GACP,CAAC;AAEJ,MAAI,YAAY,cAAc,OAC5B,QAAO,KAAK;GACV,MAAM,+BAA+B;GACrC,MAAM;GACP,CAAC;AAEJ,MAAI,YAAY,aAAa,OAC3B,QAAO,KAAK;GACV,MAAM,+BAA+B;GACrC,MAAM;GACP,CAAC;AAEJ,MAAI,YAAY,QAAQ,OACtB,QAAO,KAAK;GACV,MAAM,+BAA+B;GACrC,MAAM;GACP,CAAC;AAEJ,MAAI,YAAY,iBAAiB,OAC/B,QAAO,KAAK;GACV,MAAM,+BAA+B;GACrC,MAAM;GACP,CAAC;;AAIN,QAAO"}
+{"version":3,"file":"asset-config.mjs","names":[],"sources":["../../../../../packages/transact/src/transactions/asset-config.ts"],"sourcesContent":["import {\n  Address,\n  MAX_ASSET_DECIMALS,\n  MAX_ASSET_NAME_LENGTH,\n  MAX_ASSET_UNIT_NAME_LENGTH,\n  MAX_ASSET_URL_LENGTH,\n} from '@algorandfoundation/algokit-common'\nimport { TransactionValidationError, TransactionValidationErrorType } from './common'\n\n/**\n * Represents an asset configuration transaction that creates, reconfigures, or destroys assets.\n */\nexport type AssetConfigTransactionFields = {\n  /**\n   * ID of the asset to operate on.\n   *\n   * For asset creation, this must be 0.\n   * For asset reconfiguration this is the ID of the existing asset to be reconfigured,\n   * For asset destroy this is the ID of the existing asset to be destroyed.\n   */\n  assetId: bigint\n\n  /**\n   * The total amount of the smallest divisible (decimal) unit to create.\n   *\n   * Required when creating a new asset.\n   * For example, if creating a asset with 2 decimals and wanting a total supply of 100 units, this value should be 10000.\n   *\n   * This field can only be specified upon asset creation.\n   */\n  total?: bigint\n\n  /**\n   * The amount of decimal places the asset should have.\n   *\n   * If unspecified then the asset will be in whole units (i.e. `0`).\n   * * If 0, the asset is not divisible;\n   * * If 1, the base unit of the asset is in tenths;\n   * * If 2, the base unit of the asset is in hundredths;\n   * * If 3, the base unit of the asset is in thousandths;\n   *\n   * and so on up to 19 decimal places.\n   *\n   * This field can only be specified upon asset creation.\n   */\n  decimals?: number\n\n  /**\n   * Whether the asset is frozen by default for all accounts.\n   * Defaults to `false`.\n   *\n   * If `true` then for anyone apart from the creator to hold the\n   * asset it needs to be unfrozen per account using an asset freeze\n   * transaction from the `freeze` account, which must be set on creation.\n   *\n   * This field can only be specified upon asset creation.\n   */\n  defaultFrozen?: boolean\n\n  /**\n   * The optional name of the asset.\n   *\n   * Max size is 32 bytes.\n   *\n   * This field can only be specified upon asset creation.\n   */\n  assetName?: string\n\n  /**\n   * The optional name of the unit of this asset (e.g. ticker name).\n   *\n   * Max size is 8 bytes.\n   *\n   * This field can only be specified upon asset creation.\n   */\n  unitName?: string\n\n  /**\n   * Specifies an optional URL where more information about the asset can be retrieved (e.g. metadata).\n   *\n   * Max size is 96 bytes.\n   *\n   * This field can only be specified upon asset creation.\n   */\n  url?: string\n\n  /**\n   * 32-byte hash of some metadata that is relevant to your asset and/or asset holders.\n   *\n   * The format of this metadata is up to the application.\n   *\n   * This field can only be specified upon asset creation.\n   */\n  metadataHash?: Uint8Array\n\n  /**\n   * The address of the optional account that can manage the configuration of the asset and destroy it.\n   *\n   * The configuration fields it can change are `manager`, `reserve`, `clawback`, and `freeze`.\n   *\n   * If not set or set to the Zero address the asset becomes permanently immutable.\n   */\n  manager?: Address\n\n  /**\n   * The address of the optional account that holds the reserve (uncirculated supply) units of the asset.\n   *\n   * This address has no specific authority in the protocol itself and is informational only.\n   *\n   * Some standards like [ARC-19](https://github.com/algorandfoundation/ARCs/blob/main/ARCs/arc-0019.md)\n   * rely on this field to hold meaningful data.\n   *\n   * It can be used in the case where you want to signal to holders of your asset that the uncirculated units\n   * of the asset reside in an account that is different from the default creator account.\n   *\n   * If not set or set to the Zero address the field is permanently empty.\n   */\n  reserve?: Address\n\n  /**\n   * The address of the optional account that can be used to freeze or unfreeze holdings of this asset for any account.\n   *\n   * If empty, freezing is not permitted.\n   *\n   * If not set or set to the Zero address the field is permanently empty.\n   */\n  freeze?: Address\n\n  /**\n   * The address of the optional account that can clawback holdings of this asset from any account.\n   *\n   * **This field should be used with caution** as the clawback account has the ability to **unconditionally take assets from any account**.\n   *\n   * If empty, clawback is not permitted.\n   *\n   * If not set or set to the Zero address the field is permanently empty.\n   */\n  clawback?: Address\n}\n\n/**\n * Validate asset configuration transaction fields\n */\nexport function validateAssetConfigTransaction(assetConfig: AssetConfigTransactionFields): TransactionValidationError[] {\n  const errors = new Array<TransactionValidationError>()\n\n  if (assetConfig.assetId === 0n) {\n    // Asset creation\n    errors.push(...validateAssetCreation(assetConfig))\n  } else {\n    // Asset configuration or destruction\n    errors.push(...validateAssetConfiguration(assetConfig))\n  }\n\n  return errors\n}\n\n/**\n * Validate asset creation fields\n */\nfunction validateAssetCreation(assetConfig: AssetConfigTransactionFields): TransactionValidationError[] {\n  const errors = new Array<TransactionValidationError>()\n\n  if (assetConfig.total === undefined) {\n    errors.push({\n      type: TransactionValidationErrorType.RequiredField,\n      data: 'Total',\n    })\n  }\n\n  if (assetConfig.decimals !== undefined && assetConfig.decimals > MAX_ASSET_DECIMALS) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: {\n        field: 'Decimals',\n        actual: assetConfig.decimals,\n        max: MAX_ASSET_DECIMALS,\n        unit: 'decimal places',\n      },\n    })\n  }\n\n  if (assetConfig.unitName && assetConfig.unitName.length > MAX_ASSET_UNIT_NAME_LENGTH) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: {\n        field: 'Unit name',\n        actual: assetConfig.unitName.length,\n        max: MAX_ASSET_UNIT_NAME_LENGTH,\n        unit: 'bytes',\n      },\n    })\n  }\n\n  if (assetConfig.assetName && assetConfig.assetName.length > MAX_ASSET_NAME_LENGTH) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: {\n        field: 'Asset name',\n        actual: assetConfig.assetName.length,\n        max: MAX_ASSET_NAME_LENGTH,\n        unit: 'bytes',\n      },\n    })\n  }\n\n  if (assetConfig.url && assetConfig.url.length > MAX_ASSET_URL_LENGTH) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: {\n        field: 'Url',\n        actual: assetConfig.url.length,\n        max: MAX_ASSET_URL_LENGTH,\n        unit: 'bytes',\n      },\n    })\n  }\n\n  return errors\n}\n\n/**\n * Validate asset configuration fields\n */\nfunction validateAssetConfiguration(assetConfig: AssetConfigTransactionFields): TransactionValidationError[] {\n  const errors = new Array<TransactionValidationError>()\n\n  const hasAssetParams =\n    assetConfig.total !== undefined ||\n    assetConfig.decimals !== undefined ||\n    assetConfig.defaultFrozen !== undefined ||\n    assetConfig.assetName !== undefined ||\n    assetConfig.unitName !== undefined ||\n    assetConfig.url !== undefined ||\n    assetConfig.metadataHash !== undefined ||\n    assetConfig.manager !== undefined ||\n    assetConfig.reserve !== undefined ||\n    assetConfig.freeze !== undefined ||\n    assetConfig.clawback !== undefined\n\n  if (hasAssetParams) {\n    // These fields are immutable after creation\n    if (assetConfig.total !== undefined) {\n      errors.push({\n        type: TransactionValidationErrorType.ImmutableField,\n        data: 'Total',\n      })\n    }\n    if (assetConfig.decimals !== undefined) {\n      errors.push({\n        type: TransactionValidationErrorType.ImmutableField,\n        data: 'Decimals',\n      })\n    }\n    if (assetConfig.defaultFrozen !== undefined) {\n      errors.push({\n        type: TransactionValidationErrorType.ImmutableField,\n        data: 'Default frozen',\n      })\n    }\n    if (assetConfig.assetName !== undefined) {\n      errors.push({\n        type: TransactionValidationErrorType.ImmutableField,\n        data: 'Asset name',\n      })\n    }\n    if (assetConfig.unitName !== undefined) {\n      errors.push({\n        type: TransactionValidationErrorType.ImmutableField,\n        data: 'Unit name',\n      })\n    }\n    if (assetConfig.url !== undefined) {\n      errors.push({\n        type: TransactionValidationErrorType.ImmutableField,\n        data: 'Url',\n      })\n    }\n    if (assetConfig.metadataHash !== undefined) {\n      errors.push({\n        type: TransactionValidationErrorType.ImmutableField,\n        data: 'Metadata hash',\n      })\n    }\n  }\n\n  return errors\n}\n"],"mappings":";;;;;;AA+IA,SAAgB,+BAA+B,aAAyE;CACtH,MAAM,SAAS,IAAI,OAAmC;AAEtD,KAAI,YAAY,YAAY,GAE1B,QAAO,KAAK,GAAG,sBAAsB,YAAY,CAAC;KAGlD,QAAO,KAAK,GAAG,2BAA2B,YAAY,CAAC;AAGzD,QAAO;;;;;AAMT,SAAS,sBAAsB,aAAyE;CACtG,MAAM,SAAS,IAAI,OAAmC;AAEtD,KAAI,YAAY,UAAU,KAAA,EACxB,QAAO,KAAK;EACV,MAAM,+BAA+B;EACrC,MAAM;EACP,CAAC;AAGJ,KAAI,YAAY,aAAa,KAAA,KAAa,YAAY,WAAA,GACpD,QAAO,KAAK;EACV,MAAM,+BAA+B;EACrC,MAAM;GACJ,OAAO;GACP,QAAQ,YAAY;GACpB,KAAA;GACA,MAAM;GACP;EACF,CAAC;AAGJ,KAAI,YAAY,YAAY,YAAY,SAAS,SAAA,EAC/C,QAAO,KAAK;EACV,MAAM,+BAA+B;EACrC,MAAM;GACJ,OAAO;GACP,QAAQ,YAAY,SAAS;GAC7B,KAAA;GACA,MAAM;GACP;EACF,CAAC;AAGJ,KAAI,YAAY,aAAa,YAAY,UAAU,SAAA,GACjD,QAAO,KAAK;EACV,MAAM,+BAA+B;EACrC,MAAM;GACJ,OAAO;GACP,QAAQ,YAAY,UAAU;GAC9B,KAAA;GACA,MAAM;GACP;EACF,CAAC;AAGJ,KAAI,YAAY,OAAO,YAAY,IAAI,SAAA,GACrC,QAAO,KAAK;EACV,MAAM,+BAA+B;EACrC,MAAM;GACJ,OAAO;GACP,QAAQ,YAAY,IAAI;GACxB,KAAA;GACA,MAAM;GACP;EACF,CAAC;AAGJ,QAAO;;;;;AAMT,SAAS,2BAA2B,aAAyE;CAC3G,MAAM,SAAS,IAAI,OAAmC;AAetD,KAZE,YAAY,UAAU,KAAA,KACtB,YAAY,aAAa,KAAA,KACzB,YAAY,kBAAkB,KAAA,KAC9B,YAAY,cAAc,KAAA,KAC1B,YAAY,aAAa,KAAA,KACzB,YAAY,QAAQ,KAAA,KACpB,YAAY,iBAAiB,KAAA,KAC7B,YAAY,YAAY,KAAA,KACxB,YAAY,YAAY,KAAA,KACxB,YAAY,WAAW,KAAA,KACvB,YAAY,aAAa,KAAA,GAEP;AAElB,MAAI,YAAY,UAAU,KAAA,EACxB,QAAO,KAAK;GACV,MAAM,+BAA+B;GACrC,MAAM;GACP,CAAC;AAEJ,MAAI,YAAY,aAAa,KAAA,EAC3B,QAAO,KAAK;GACV,MAAM,+BAA+B;GACrC,MAAM;GACP,CAAC;AAEJ,MAAI,YAAY,kBAAkB,KAAA,EAChC,QAAO,KAAK;GACV,MAAM,+BAA+B;GACrC,MAAM;GACP,CAAC;AAEJ,MAAI,YAAY,cAAc,KAAA,EAC5B,QAAO,KAAK;GACV,MAAM,+BAA+B;GACrC,MAAM;GACP,CAAC;AAEJ,MAAI,YAAY,aAAa,KAAA,EAC3B,QAAO,KAAK;GACV,MAAM,+BAA+B;GACrC,MAAM;GACP,CAAC;AAEJ,MAAI,YAAY,QAAQ,KAAA,EACtB,QAAO,KAAK;GACV,MAAM,+BAA+B;GACrC,MAAM;GACP,CAAC;AAEJ,MAAI,YAAY,iBAAiB,KAAA,EAC/B,QAAO,KAAK;GACV,MAAM,+BAA+B;GACrC,MAAM;GACP,CAAC;;AAIN,QAAO"}

package/packages/transact/src/transactions/asset-freeze.d.ts

@@ -1,8 +1,6 @@
 import { Address } from "../../../common/src/address.js";
-import { TransactionValidationError } from "./common.js";
 
 //#region packages/transact/src/transactions/asset-freeze.d.ts
-
 /**
  * Represents an asset freeze transaction that freezes or unfreezes asset holdings.
  *
@@ -26,10 +24,6 @@ type AssetFreezeTransactionFields = {
    */
   frozen: boolean;
 };
-/**
- * Validate asset freeze transaction fields
- */
-declare function validateAssetFreezeTransaction(assetFreeze: AssetFreezeTransactionFields): TransactionValidationError[];
 //#endregion
-export { AssetFreezeTransactionFields, validateAssetFreezeTransaction };
+export { AssetFreezeTransactionFields };
 //# sourceMappingURL=asset-freeze.d.ts.map

package/packages/transact/src/transactions/asset-freeze.js

@@ -1,5 +1,4 @@
-const require_common = require('./common.js');
-
+const require_common = require("./common.js");
 //#region packages/transact/src/transactions/asset-freeze.ts
 /**
 * Validate asset freeze transaction fields
@@ -12,7 +11,7 @@ function validateAssetFreezeTransaction(assetFreeze) {
 	});
 	return errors;
 }
-
 //#endregion
 exports.validateAssetFreezeTransaction = validateAssetFreezeTransaction;
+
 //# sourceMappingURL=asset-freeze.js.map

package/packages/transact/src/transactions/asset-freeze.js.map

@@ -1 +1 @@
-{"version":3,"file":"asset-freeze.js","names":["TransactionValidationErrorType"],"sources":["../../../../../packages/transact/src/transactions/asset-freeze.ts"],"sourcesContent":["import { Address } from '@algorandfoundation/algokit-common'\nimport { TransactionValidationError, TransactionValidationErrorType } from './common'\n\n/**\n * Represents an asset freeze transaction that freezes or unfreezes asset holdings.\n *\n * Asset freeze transactions are used by the asset freeze account to control\n * whether a specific account can transfer a particular asset.\n */\nexport type AssetFreezeTransactionFields = {\n  /**\n   * The ID of the asset being frozen/unfrozen.\n   */\n  assetId: bigint\n\n  /**\n   * The target account whose asset holdings will be affected.\n   */\n  freezeTarget: Address\n\n  /**\n   * The new freeze status.\n   *\n   * `true` to freeze the asset holdings (prevent transfers),\n   * `false` to unfreeze the asset holdings (allow transfers).\n   */\n  frozen: boolean\n}\n\n/**\n * Validate asset freeze transaction fields\n */\nexport function validateAssetFreezeTransaction(assetFreeze: AssetFreezeTransactionFields): TransactionValidationError[] {\n  const errors = new Array<TransactionValidationError>()\n\n  if (assetFreeze.assetId === 0n) {\n    errors.push({\n      type: TransactionValidationErrorType.ZeroValueField,\n      data: 'Asset ID',\n    })\n  }\n\n  return errors\n}\n"],"mappings":";;;;;;AAgCA,SAAgB,+BAA+B,aAAyE;CACtH,MAAM,SAAS,IAAI,OAAmC;AAEtD,KAAI,YAAY,YAAY,GAC1B,QAAO,KAAK;EACV,MAAMA,8CAA+B;EACrC,MAAM;EACP,CAAC;AAGJ,QAAO"}
+{"version":3,"file":"asset-freeze.js","names":["TransactionValidationErrorType"],"sources":["../../../../../packages/transact/src/transactions/asset-freeze.ts"],"sourcesContent":["import { Address } from '@algorandfoundation/algokit-common'\nimport { TransactionValidationError, TransactionValidationErrorType } from './common'\n\n/**\n * Represents an asset freeze transaction that freezes or unfreezes asset holdings.\n *\n * Asset freeze transactions are used by the asset freeze account to control\n * whether a specific account can transfer a particular asset.\n */\nexport type AssetFreezeTransactionFields = {\n  /**\n   * The ID of the asset being frozen/unfrozen.\n   */\n  assetId: bigint\n\n  /**\n   * The target account whose asset holdings will be affected.\n   */\n  freezeTarget: Address\n\n  /**\n   * The new freeze status.\n   *\n   * `true` to freeze the asset holdings (prevent transfers),\n   * `false` to unfreeze the asset holdings (allow transfers).\n   */\n  frozen: boolean\n}\n\n/**\n * Validate asset freeze transaction fields\n */\nexport function validateAssetFreezeTransaction(assetFreeze: AssetFreezeTransactionFields): TransactionValidationError[] {\n  const errors = new Array<TransactionValidationError>()\n\n  if (assetFreeze.assetId === 0n) {\n    errors.push({\n      type: TransactionValidationErrorType.ZeroValueField,\n      data: 'Asset ID',\n    })\n  }\n\n  return errors\n}\n"],"mappings":";;;;;AAgCA,SAAgB,+BAA+B,aAAyE;CACtH,MAAM,SAAS,IAAI,OAAmC;AAEtD,KAAI,YAAY,YAAY,GAC1B,QAAO,KAAK;EACV,MAAMA,eAAAA,+BAA+B;EACrC,MAAM;EACP,CAAC;AAGJ,QAAO"}

package/packages/transact/src/transactions/asset-freeze.mjs

@@ -1,5 +1,4 @@
 import { TransactionValidationErrorType } from "./common.mjs";
-
 //#region packages/transact/src/transactions/asset-freeze.ts
 /**
 * Validate asset freeze transaction fields
@@ -12,7 +11,7 @@ function validateAssetFreezeTransaction(assetFreeze) {
 	});
 	return errors;
 }
-
 //#endregion
 export { validateAssetFreezeTransaction };
+
 //# sourceMappingURL=asset-freeze.mjs.map

package/packages/transact/src/transactions/asset-freeze.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"asset-freeze.mjs","names":[],"sources":["../../../../../packages/transact/src/transactions/asset-freeze.ts"],"sourcesContent":["import { Address } from '@algorandfoundation/algokit-common'\nimport { TransactionValidationError, TransactionValidationErrorType } from './common'\n\n/**\n * Represents an asset freeze transaction that freezes or unfreezes asset holdings.\n *\n * Asset freeze transactions are used by the asset freeze account to control\n * whether a specific account can transfer a particular asset.\n */\nexport type AssetFreezeTransactionFields = {\n  /**\n   * The ID of the asset being frozen/unfrozen.\n   */\n  assetId: bigint\n\n  /**\n   * The target account whose asset holdings will be affected.\n   */\n  freezeTarget: Address\n\n  /**\n   * The new freeze status.\n   *\n   * `true` to freeze the asset holdings (prevent transfers),\n   * `false` to unfreeze the asset holdings (allow transfers).\n   */\n  frozen: boolean\n}\n\n/**\n * Validate asset freeze transaction fields\n */\nexport function validateAssetFreezeTransaction(assetFreeze: AssetFreezeTransactionFields): TransactionValidationError[] {\n  const errors = new Array<TransactionValidationError>()\n\n  if (assetFreeze.assetId === 0n) {\n    errors.push({\n      type: TransactionValidationErrorType.ZeroValueField,\n      data: 'Asset ID',\n    })\n  }\n\n  return errors\n}\n"],"mappings":";;;;;;AAgCA,SAAgB,+BAA+B,aAAyE;CACtH,MAAM,SAAS,IAAI,OAAmC;AAEtD,KAAI,YAAY,YAAY,GAC1B,QAAO,KAAK;EACV,MAAM,+BAA+B;EACrC,MAAM;EACP,CAAC;AAGJ,QAAO"}
+{"version":3,"file":"asset-freeze.mjs","names":[],"sources":["../../../../../packages/transact/src/transactions/asset-freeze.ts"],"sourcesContent":["import { Address } from '@algorandfoundation/algokit-common'\nimport { TransactionValidationError, TransactionValidationErrorType } from './common'\n\n/**\n * Represents an asset freeze transaction that freezes or unfreezes asset holdings.\n *\n * Asset freeze transactions are used by the asset freeze account to control\n * whether a specific account can transfer a particular asset.\n */\nexport type AssetFreezeTransactionFields = {\n  /**\n   * The ID of the asset being frozen/unfrozen.\n   */\n  assetId: bigint\n\n  /**\n   * The target account whose asset holdings will be affected.\n   */\n  freezeTarget: Address\n\n  /**\n   * The new freeze status.\n   *\n   * `true` to freeze the asset holdings (prevent transfers),\n   * `false` to unfreeze the asset holdings (allow transfers).\n   */\n  frozen: boolean\n}\n\n/**\n * Validate asset freeze transaction fields\n */\nexport function validateAssetFreezeTransaction(assetFreeze: AssetFreezeTransactionFields): TransactionValidationError[] {\n  const errors = new Array<TransactionValidationError>()\n\n  if (assetFreeze.assetId === 0n) {\n    errors.push({\n      type: TransactionValidationErrorType.ZeroValueField,\n      data: 'Asset ID',\n    })\n  }\n\n  return errors\n}\n"],"mappings":";;;;;AAgCA,SAAgB,+BAA+B,aAAyE;CACtH,MAAM,SAAS,IAAI,OAAmC;AAEtD,KAAI,YAAY,YAAY,GAC1B,QAAO,KAAK;EACV,MAAM,+BAA+B;EACrC,MAAM;EACP,CAAC;AAGJ,QAAO"}

package/packages/transact/src/transactions/asset-transfer.d.ts

@@ -1,8 +1,6 @@
 import { Address } from "../../../common/src/address.js";
-import { TransactionValidationError } from "./common.js";
 
 //#region packages/transact/src/transactions/asset-transfer.d.ts
-
 /**
  * Represents an asset transfer transaction that moves ASAs between accounts.
  *
@@ -47,10 +45,6 @@ type AssetTransferTransactionFields = {
    */
   closeRemainderTo?: Address;
 };
-/**
- * Validate asset transfer transaction fields
- */
-declare function validateAssetTransferTransaction(assetTransfer: AssetTransferTransactionFields): TransactionValidationError[];
 //#endregion
-export { AssetTransferTransactionFields, validateAssetTransferTransaction };
+export { AssetTransferTransactionFields };
 //# sourceMappingURL=asset-transfer.d.ts.map

package/packages/transact/src/transactions/asset-transfer.js

@@ -1,5 +1,4 @@
-const require_common = require('./common.js');
-
+const require_common = require("./common.js");
 //#region packages/transact/src/transactions/asset-transfer.ts
 /**
 * Validate asset transfer transaction fields
@@ -12,7 +11,7 @@ function validateAssetTransferTransaction(assetTransfer) {
 	});
 	return errors;
 }
-
 //#endregion
 exports.validateAssetTransferTransaction = validateAssetTransferTransaction;
+
 //# sourceMappingURL=asset-transfer.js.map

package/packages/transact/src/transactions/asset-transfer.js.map

@@ -1 +1 @@
-{"version":3,"file":"asset-transfer.js","names":["TransactionValidationErrorType"],"sources":["../../../../../packages/transact/src/transactions/asset-transfer.ts"],"sourcesContent":["import { Address } from '@algorandfoundation/algokit-common'\nimport { TransactionValidationError, TransactionValidationErrorType } from './common'\n\n/**\n * Represents an asset transfer transaction that moves ASAs between accounts.\n *\n * Asset transfer transactions are used to transfer Algorand Standard Assets (ASAs)\n * from one account to another.\n */\nexport type AssetTransferTransactionFields = {\n  /**\n   * The ID of the asset being transferred.\n   */\n  assetId: bigint\n\n  /**\n   * The amount of the asset to transfer.\n   *\n   * An integer value representing the number of units (to their smallest denomination) of\n   * the asset that are being transferred.\n   * In other words, the asset decimals don't play a role in this value.\n   * It should be up to the caller (or a higher abstraction) to handle the conversion based on\n   * the asset decimals.\n   */\n  amount: bigint\n\n  /**\n   * The address of the account that will receive the asset.\n   *\n   * The receiver must have opted-in to the asset before they can receive it.\n   */\n  receiver: Address\n\n  /**\n   * Optional address of the account that actually holds the asset being transferred.\n   *\n   * If provided, this indicates that the transaction is a clawback operation,\n   * where the sender is the asset clawback address and is forcibly moving assets\n   * from this account to the receiver.\n   */\n  assetSender?: Address\n\n  /**\n   * Optional address to send all remaining asset units to after the transfer.\n   *\n   * If specified, this indicates that the sender is closing out their position in the asset,\n   * and all remaining units of this asset owned by the sender will be transferred to this address.\n   * This effectively removes the asset from the sender's account.\n   */\n  closeRemainderTo?: Address\n}\n\n/**\n * Validate asset transfer transaction fields\n */\nexport function validateAssetTransferTransaction(assetTransfer: AssetTransferTransactionFields): TransactionValidationError[] {\n  const errors = new Array<TransactionValidationError>()\n\n  if (assetTransfer.assetId === 0n) {\n    errors.push({\n      type: TransactionValidationErrorType.ZeroValueField,\n      data: 'Asset ID',\n    })\n  }\n\n  return errors\n}\n"],"mappings":";;;;;;AAuDA,SAAgB,iCAAiC,eAA6E;CAC5H,MAAM,SAAS,IAAI,OAAmC;AAEtD,KAAI,cAAc,YAAY,GAC5B,QAAO,KAAK;EACV,MAAMA,8CAA+B;EACrC,MAAM;EACP,CAAC;AAGJ,QAAO"}
+{"version":3,"file":"asset-transfer.js","names":["TransactionValidationErrorType"],"sources":["../../../../../packages/transact/src/transactions/asset-transfer.ts"],"sourcesContent":["import { Address } from '@algorandfoundation/algokit-common'\nimport { TransactionValidationError, TransactionValidationErrorType } from './common'\n\n/**\n * Represents an asset transfer transaction that moves ASAs between accounts.\n *\n * Asset transfer transactions are used to transfer Algorand Standard Assets (ASAs)\n * from one account to another.\n */\nexport type AssetTransferTransactionFields = {\n  /**\n   * The ID of the asset being transferred.\n   */\n  assetId: bigint\n\n  /**\n   * The amount of the asset to transfer.\n   *\n   * An integer value representing the number of units (to their smallest denomination) of\n   * the asset that are being transferred.\n   * In other words, the asset decimals don't play a role in this value.\n   * It should be up to the caller (or a higher abstraction) to handle the conversion based on\n   * the asset decimals.\n   */\n  amount: bigint\n\n  /**\n   * The address of the account that will receive the asset.\n   *\n   * The receiver must have opted-in to the asset before they can receive it.\n   */\n  receiver: Address\n\n  /**\n   * Optional address of the account that actually holds the asset being transferred.\n   *\n   * If provided, this indicates that the transaction is a clawback operation,\n   * where the sender is the asset clawback address and is forcibly moving assets\n   * from this account to the receiver.\n   */\n  assetSender?: Address\n\n  /**\n   * Optional address to send all remaining asset units to after the transfer.\n   *\n   * If specified, this indicates that the sender is closing out their position in the asset,\n   * and all remaining units of this asset owned by the sender will be transferred to this address.\n   * This effectively removes the asset from the sender's account.\n   */\n  closeRemainderTo?: Address\n}\n\n/**\n * Validate asset transfer transaction fields\n */\nexport function validateAssetTransferTransaction(assetTransfer: AssetTransferTransactionFields): TransactionValidationError[] {\n  const errors = new Array<TransactionValidationError>()\n\n  if (assetTransfer.assetId === 0n) {\n    errors.push({\n      type: TransactionValidationErrorType.ZeroValueField,\n      data: 'Asset ID',\n    })\n  }\n\n  return errors\n}\n"],"mappings":";;;;;AAuDA,SAAgB,iCAAiC,eAA6E;CAC5H,MAAM,SAAS,IAAI,OAAmC;AAEtD,KAAI,cAAc,YAAY,GAC5B,QAAO,KAAK;EACV,MAAMA,eAAAA,+BAA+B;EACrC,MAAM;EACP,CAAC;AAGJ,QAAO"}

package/packages/transact/src/transactions/asset-transfer.mjs

@@ -1,5 +1,4 @@
 import { TransactionValidationErrorType } from "./common.mjs";
-
 //#region packages/transact/src/transactions/asset-transfer.ts
 /**
 * Validate asset transfer transaction fields
@@ -12,7 +11,7 @@ function validateAssetTransferTransaction(assetTransfer) {
 	});
 	return errors;
 }
-
 //#endregion
 export { validateAssetTransferTransaction };
+
 //# sourceMappingURL=asset-transfer.mjs.map

package/packages/transact/src/transactions/asset-transfer.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"asset-transfer.mjs","names":[],"sources":["../../../../../packages/transact/src/transactions/asset-transfer.ts"],"sourcesContent":["import { Address } from '@algorandfoundation/algokit-common'\nimport { TransactionValidationError, TransactionValidationErrorType } from './common'\n\n/**\n * Represents an asset transfer transaction that moves ASAs between accounts.\n *\n * Asset transfer transactions are used to transfer Algorand Standard Assets (ASAs)\n * from one account to another.\n */\nexport type AssetTransferTransactionFields = {\n  /**\n   * The ID of the asset being transferred.\n   */\n  assetId: bigint\n\n  /**\n   * The amount of the asset to transfer.\n   *\n   * An integer value representing the number of units (to their smallest denomination) of\n   * the asset that are being transferred.\n   * In other words, the asset decimals don't play a role in this value.\n   * It should be up to the caller (or a higher abstraction) to handle the conversion based on\n   * the asset decimals.\n   */\n  amount: bigint\n\n  /**\n   * The address of the account that will receive the asset.\n   *\n   * The receiver must have opted-in to the asset before they can receive it.\n   */\n  receiver: Address\n\n  /**\n   * Optional address of the account that actually holds the asset being transferred.\n   *\n   * If provided, this indicates that the transaction is a clawback operation,\n   * where the sender is the asset clawback address and is forcibly moving assets\n   * from this account to the receiver.\n   */\n  assetSender?: Address\n\n  /**\n   * Optional address to send all remaining asset units to after the transfer.\n   *\n   * If specified, this indicates that the sender is closing out their position in the asset,\n   * and all remaining units of this asset owned by the sender will be transferred to this address.\n   * This effectively removes the asset from the sender's account.\n   */\n  closeRemainderTo?: Address\n}\n\n/**\n * Validate asset transfer transaction fields\n */\nexport function validateAssetTransferTransaction(assetTransfer: AssetTransferTransactionFields): TransactionValidationError[] {\n  const errors = new Array<TransactionValidationError>()\n\n  if (assetTransfer.assetId === 0n) {\n    errors.push({\n      type: TransactionValidationErrorType.ZeroValueField,\n      data: 'Asset ID',\n    })\n  }\n\n  return errors\n}\n"],"mappings":";;;;;;AAuDA,SAAgB,iCAAiC,eAA6E;CAC5H,MAAM,SAAS,IAAI,OAAmC;AAEtD,KAAI,cAAc,YAAY,GAC5B,QAAO,KAAK;EACV,MAAM,+BAA+B;EACrC,MAAM;EACP,CAAC;AAGJ,QAAO"}
+{"version":3,"file":"asset-transfer.mjs","names":[],"sources":["../../../../../packages/transact/src/transactions/asset-transfer.ts"],"sourcesContent":["import { Address } from '@algorandfoundation/algokit-common'\nimport { TransactionValidationError, TransactionValidationErrorType } from './common'\n\n/**\n * Represents an asset transfer transaction that moves ASAs between accounts.\n *\n * Asset transfer transactions are used to transfer Algorand Standard Assets (ASAs)\n * from one account to another.\n */\nexport type AssetTransferTransactionFields = {\n  /**\n   * The ID of the asset being transferred.\n   */\n  assetId: bigint\n\n  /**\n   * The amount of the asset to transfer.\n   *\n   * An integer value representing the number of units (to their smallest denomination) of\n   * the asset that are being transferred.\n   * In other words, the asset decimals don't play a role in this value.\n   * It should be up to the caller (or a higher abstraction) to handle the conversion based on\n   * the asset decimals.\n   */\n  amount: bigint\n\n  /**\n   * The address of the account that will receive the asset.\n   *\n   * The receiver must have opted-in to the asset before they can receive it.\n   */\n  receiver: Address\n\n  /**\n   * Optional address of the account that actually holds the asset being transferred.\n   *\n   * If provided, this indicates that the transaction is a clawback operation,\n   * where the sender is the asset clawback address and is forcibly moving assets\n   * from this account to the receiver.\n   */\n  assetSender?: Address\n\n  /**\n   * Optional address to send all remaining asset units to after the transfer.\n   *\n   * If specified, this indicates that the sender is closing out their position in the asset,\n   * and all remaining units of this asset owned by the sender will be transferred to this address.\n   * This effectively removes the asset from the sender's account.\n   */\n  closeRemainderTo?: Address\n}\n\n/**\n * Validate asset transfer transaction fields\n */\nexport function validateAssetTransferTransaction(assetTransfer: AssetTransferTransactionFields): TransactionValidationError[] {\n  const errors = new Array<TransactionValidationError>()\n\n  if (assetTransfer.assetId === 0n) {\n    errors.push({\n      type: TransactionValidationErrorType.ZeroValueField,\n      data: 'Asset ID',\n    })\n  }\n\n  return errors\n}\n"],"mappings":";;;;;AAuDA,SAAgB,iCAAiC,eAA6E;CAC5H,MAAM,SAAS,IAAI,OAAmC;AAEtD,KAAI,cAAc,YAAY,GAC5B,QAAO,KAAK;EACV,MAAM,+BAA+B;EACrC,MAAM;EACP,CAAC;AAGJ,QAAO"}

package/packages/transact/src/transactions/common.js

@@ -1,12 +1,11 @@
-
 //#region packages/transact/src/transactions/common.ts
-let TransactionValidationErrorType = /* @__PURE__ */ function(TransactionValidationErrorType$1) {
-	TransactionValidationErrorType$1[TransactionValidationErrorType$1["RequiredField"] = 0] = "RequiredField";
-	TransactionValidationErrorType$1[TransactionValidationErrorType$1["FieldTooLong"] = 1] = "FieldTooLong";
-	TransactionValidationErrorType$1[TransactionValidationErrorType$1["ImmutableField"] = 2] = "ImmutableField";
-	TransactionValidationErrorType$1[TransactionValidationErrorType$1["ZeroValueField"] = 3] = "ZeroValueField";
-	TransactionValidationErrorType$1[TransactionValidationErrorType$1["ArbitraryConstraint"] = 4] = "ArbitraryConstraint";
-	return TransactionValidationErrorType$1;
+let TransactionValidationErrorType = /* @__PURE__ */ function(TransactionValidationErrorType) {
+	TransactionValidationErrorType[TransactionValidationErrorType["RequiredField"] = 0] = "RequiredField";
+	TransactionValidationErrorType[TransactionValidationErrorType["FieldTooLong"] = 1] = "FieldTooLong";
+	TransactionValidationErrorType[TransactionValidationErrorType["ImmutableField"] = 2] = "ImmutableField";
+	TransactionValidationErrorType[TransactionValidationErrorType["ZeroValueField"] = 3] = "ZeroValueField";
+	TransactionValidationErrorType[TransactionValidationErrorType["ArbitraryConstraint"] = 4] = "ArbitraryConstraint";
+	return TransactionValidationErrorType;
 }({});
 function getValidationErrorMessage(validationError) {
 	switch (validationError.type) {
@@ -17,8 +16,8 @@ function getValidationErrorMessage(validationError) {
 		case TransactionValidationErrorType.ArbitraryConstraint: return validationError.data;
 	}
 }
-
 //#endregion
 exports.TransactionValidationErrorType = TransactionValidationErrorType;
 exports.getValidationErrorMessage = getValidationErrorMessage;
+
 //# sourceMappingURL=common.js.map

package/packages/transact/src/transactions/common.js.map

@@ -1 +1 @@
-{"version":3,"file":"common.js","names":[],"sources":["../../../../../packages/transact/src/transactions/common.ts"],"sourcesContent":["export enum TransactionValidationErrorType {\n  RequiredField,\n  FieldTooLong,\n  ImmutableField,\n  ZeroValueField,\n  ArbitraryConstraint,\n}\n\nexport type TransactionValidationError =\n  | RequiredFieldValidationError\n  | FieldTooLongValidationError\n  | ImmutableFieldValidationError\n  | ZeroValueFieldValidationError\n  | ArbitraryConstraintValidationError\n\ntype RequiredFieldValidationError = {\n  type: TransactionValidationErrorType.RequiredField\n  data: string\n}\n\ntype FieldTooLongValidationError = {\n  type: TransactionValidationErrorType.FieldTooLong\n  data: {\n    field: string\n    actual: number\n    max: number\n    unit: string\n  }\n}\n\ntype ImmutableFieldValidationError = {\n  type: TransactionValidationErrorType.ImmutableField\n  data: string\n}\n\ntype ZeroValueFieldValidationError = {\n  type: TransactionValidationErrorType.ZeroValueField\n  data: string\n}\n\ntype ArbitraryConstraintValidationError = {\n  type: TransactionValidationErrorType.ArbitraryConstraint\n  data: string\n}\n\nexport function getValidationErrorMessage(validationError: TransactionValidationError): string {\n  switch (validationError.type) {\n    case TransactionValidationErrorType.RequiredField:\n      return `${validationError.data} is required`\n    case TransactionValidationErrorType.FieldTooLong:\n      return `${validationError.data.field} cannot exceed ${validationError.data.max} ${validationError.data.unit}, got ${validationError.data.actual}`\n    case TransactionValidationErrorType.ImmutableField:\n      return `${validationError.data} is immutable and cannot be changed`\n    case TransactionValidationErrorType.ZeroValueField:\n      return `${validationError.data} must not be 0`\n    case TransactionValidationErrorType.ArbitraryConstraint:\n      return validationError.data\n  }\n}\n"],"mappings":";;AAAA,IAAY,4FAAL;AACL;AACA;AACA;AACA;AACA;;;AAwCF,SAAgB,0BAA0B,iBAAqD;AAC7F,SAAQ,gBAAgB,MAAxB;EACE,KAAK,+BAA+B,cAClC,QAAO,GAAG,gBAAgB,KAAK;EACjC,KAAK,+BAA+B,aAClC,QAAO,GAAG,gBAAgB,KAAK,MAAM,iBAAiB,gBAAgB,KAAK,IAAI,GAAG,gBAAgB,KAAK,KAAK,QAAQ,gBAAgB,KAAK;EAC3I,KAAK,+BAA+B,eAClC,QAAO,GAAG,gBAAgB,KAAK;EACjC,KAAK,+BAA+B,eAClC,QAAO,GAAG,gBAAgB,KAAK;EACjC,KAAK,+BAA+B,oBAClC,QAAO,gBAAgB"}
+{"version":3,"file":"common.js","names":[],"sources":["../../../../../packages/transact/src/transactions/common.ts"],"sourcesContent":["export enum TransactionValidationErrorType {\n  RequiredField,\n  FieldTooLong,\n  ImmutableField,\n  ZeroValueField,\n  ArbitraryConstraint,\n}\n\nexport type TransactionValidationError =\n  | RequiredFieldValidationError\n  | FieldTooLongValidationError\n  | ImmutableFieldValidationError\n  | ZeroValueFieldValidationError\n  | ArbitraryConstraintValidationError\n\ntype RequiredFieldValidationError = {\n  type: TransactionValidationErrorType.RequiredField\n  data: string\n}\n\ntype FieldTooLongValidationError = {\n  type: TransactionValidationErrorType.FieldTooLong\n  data: {\n    field: string\n    actual: number\n    max: number\n    unit: string\n  }\n}\n\ntype ImmutableFieldValidationError = {\n  type: TransactionValidationErrorType.ImmutableField\n  data: string\n}\n\ntype ZeroValueFieldValidationError = {\n  type: TransactionValidationErrorType.ZeroValueField\n  data: string\n}\n\ntype ArbitraryConstraintValidationError = {\n  type: TransactionValidationErrorType.ArbitraryConstraint\n  data: string\n}\n\nexport function getValidationErrorMessage(validationError: TransactionValidationError): string {\n  switch (validationError.type) {\n    case TransactionValidationErrorType.RequiredField:\n      return `${validationError.data} is required`\n    case TransactionValidationErrorType.FieldTooLong:\n      return `${validationError.data.field} cannot exceed ${validationError.data.max} ${validationError.data.unit}, got ${validationError.data.actual}`\n    case TransactionValidationErrorType.ImmutableField:\n      return `${validationError.data} is immutable and cannot be changed`\n    case TransactionValidationErrorType.ZeroValueField:\n      return `${validationError.data} must not be 0`\n    case TransactionValidationErrorType.ArbitraryConstraint:\n      return validationError.data\n  }\n}\n"],"mappings":";AAAA,IAAY,iCAAL,yBAAA,gCAAA;AACL,gCAAA,+BAAA,mBAAA,KAAA;AACA,gCAAA,+BAAA,kBAAA,KAAA;AACA,gCAAA,+BAAA,oBAAA,KAAA;AACA,gCAAA,+BAAA,oBAAA,KAAA;AACA,gCAAA,+BAAA,yBAAA,KAAA;;KACD;AAuCD,SAAgB,0BAA0B,iBAAqD;AAC7F,SAAQ,gBAAgB,MAAxB;EACE,KAAK,+BAA+B,cAClC,QAAO,GAAG,gBAAgB,KAAK;EACjC,KAAK,+BAA+B,aAClC,QAAO,GAAG,gBAAgB,KAAK,MAAM,iBAAiB,gBAAgB,KAAK,IAAI,GAAG,gBAAgB,KAAK,KAAK,QAAQ,gBAAgB,KAAK;EAC3I,KAAK,+BAA+B,eAClC,QAAO,GAAG,gBAAgB,KAAK;EACjC,KAAK,+BAA+B,eAClC,QAAO,GAAG,gBAAgB,KAAK;EACjC,KAAK,+BAA+B,oBAClC,QAAO,gBAAgB"}

package/packages/transact/src/transactions/common.mjs

@@ -1,11 +1,11 @@
 //#region packages/transact/src/transactions/common.ts
-let TransactionValidationErrorType = /* @__PURE__ */ function(TransactionValidationErrorType$1) {
-	TransactionValidationErrorType$1[TransactionValidationErrorType$1["RequiredField"] = 0] = "RequiredField";
-	TransactionValidationErrorType$1[TransactionValidationErrorType$1["FieldTooLong"] = 1] = "FieldTooLong";
-	TransactionValidationErrorType$1[TransactionValidationErrorType$1["ImmutableField"] = 2] = "ImmutableField";
-	TransactionValidationErrorType$1[TransactionValidationErrorType$1["ZeroValueField"] = 3] = "ZeroValueField";
-	TransactionValidationErrorType$1[TransactionValidationErrorType$1["ArbitraryConstraint"] = 4] = "ArbitraryConstraint";
-	return TransactionValidationErrorType$1;
+let TransactionValidationErrorType = /* @__PURE__ */ function(TransactionValidationErrorType) {
+	TransactionValidationErrorType[TransactionValidationErrorType["RequiredField"] = 0] = "RequiredField";
+	TransactionValidationErrorType[TransactionValidationErrorType["FieldTooLong"] = 1] = "FieldTooLong";
+	TransactionValidationErrorType[TransactionValidationErrorType["ImmutableField"] = 2] = "ImmutableField";
+	TransactionValidationErrorType[TransactionValidationErrorType["ZeroValueField"] = 3] = "ZeroValueField";
+	TransactionValidationErrorType[TransactionValidationErrorType["ArbitraryConstraint"] = 4] = "ArbitraryConstraint";
+	return TransactionValidationErrorType;
 }({});
 function getValidationErrorMessage(validationError) {
 	switch (validationError.type) {
@@ -16,7 +16,7 @@ function getValidationErrorMessage(validationError) {
 		case TransactionValidationErrorType.ArbitraryConstraint: return validationError.data;
 	}
 }
-
 //#endregion
 export { TransactionValidationErrorType, getValidationErrorMessage };
+
 //# sourceMappingURL=common.mjs.map

package/packages/transact/src/transactions/common.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"common.mjs","names":[],"sources":["../../../../../packages/transact/src/transactions/common.ts"],"sourcesContent":["export enum TransactionValidationErrorType {\n  RequiredField,\n  FieldTooLong,\n  ImmutableField,\n  ZeroValueField,\n  ArbitraryConstraint,\n}\n\nexport type TransactionValidationError =\n  | RequiredFieldValidationError\n  | FieldTooLongValidationError\n  | ImmutableFieldValidationError\n  | ZeroValueFieldValidationError\n  | ArbitraryConstraintValidationError\n\ntype RequiredFieldValidationError = {\n  type: TransactionValidationErrorType.RequiredField\n  data: string\n}\n\ntype FieldTooLongValidationError = {\n  type: TransactionValidationErrorType.FieldTooLong\n  data: {\n    field: string\n    actual: number\n    max: number\n    unit: string\n  }\n}\n\ntype ImmutableFieldValidationError = {\n  type: TransactionValidationErrorType.ImmutableField\n  data: string\n}\n\ntype ZeroValueFieldValidationError = {\n  type: TransactionValidationErrorType.ZeroValueField\n  data: string\n}\n\ntype ArbitraryConstraintValidationError = {\n  type: TransactionValidationErrorType.ArbitraryConstraint\n  data: string\n}\n\nexport function getValidationErrorMessage(validationError: TransactionValidationError): string {\n  switch (validationError.type) {\n    case TransactionValidationErrorType.RequiredField:\n      return `${validationError.data} is required`\n    case TransactionValidationErrorType.FieldTooLong:\n      return `${validationError.data.field} cannot exceed ${validationError.data.max} ${validationError.data.unit}, got ${validationError.data.actual}`\n    case TransactionValidationErrorType.ImmutableField:\n      return `${validationError.data} is immutable and cannot be changed`\n    case TransactionValidationErrorType.ZeroValueField:\n      return `${validationError.data} must not be 0`\n    case TransactionValidationErrorType.ArbitraryConstraint:\n      return validationError.data\n  }\n}\n"],"mappings":";AAAA,IAAY,4FAAL;AACL;AACA;AACA;AACA;AACA;;;AAwCF,SAAgB,0BAA0B,iBAAqD;AAC7F,SAAQ,gBAAgB,MAAxB;EACE,KAAK,+BAA+B,cAClC,QAAO,GAAG,gBAAgB,KAAK;EACjC,KAAK,+BAA+B,aAClC,QAAO,GAAG,gBAAgB,KAAK,MAAM,iBAAiB,gBAAgB,KAAK,IAAI,GAAG,gBAAgB,KAAK,KAAK,QAAQ,gBAAgB,KAAK;EAC3I,KAAK,+BAA+B,eAClC,QAAO,GAAG,gBAAgB,KAAK;EACjC,KAAK,+BAA+B,eAClC,QAAO,GAAG,gBAAgB,KAAK;EACjC,KAAK,+BAA+B,oBAClC,QAAO,gBAAgB"}
+{"version":3,"file":"common.mjs","names":[],"sources":["../../../../../packages/transact/src/transactions/common.ts"],"sourcesContent":["export enum TransactionValidationErrorType {\n  RequiredField,\n  FieldTooLong,\n  ImmutableField,\n  ZeroValueField,\n  ArbitraryConstraint,\n}\n\nexport type TransactionValidationError =\n  | RequiredFieldValidationError\n  | FieldTooLongValidationError\n  | ImmutableFieldValidationError\n  | ZeroValueFieldValidationError\n  | ArbitraryConstraintValidationError\n\ntype RequiredFieldValidationError = {\n  type: TransactionValidationErrorType.RequiredField\n  data: string\n}\n\ntype FieldTooLongValidationError = {\n  type: TransactionValidationErrorType.FieldTooLong\n  data: {\n    field: string\n    actual: number\n    max: number\n    unit: string\n  }\n}\n\ntype ImmutableFieldValidationError = {\n  type: TransactionValidationErrorType.ImmutableField\n  data: string\n}\n\ntype ZeroValueFieldValidationError = {\n  type: TransactionValidationErrorType.ZeroValueField\n  data: string\n}\n\ntype ArbitraryConstraintValidationError = {\n  type: TransactionValidationErrorType.ArbitraryConstraint\n  data: string\n}\n\nexport function getValidationErrorMessage(validationError: TransactionValidationError): string {\n  switch (validationError.type) {\n    case TransactionValidationErrorType.RequiredField:\n      return `${validationError.data} is required`\n    case TransactionValidationErrorType.FieldTooLong:\n      return `${validationError.data.field} cannot exceed ${validationError.data.max} ${validationError.data.unit}, got ${validationError.data.actual}`\n    case TransactionValidationErrorType.ImmutableField:\n      return `${validationError.data} is immutable and cannot be changed`\n    case TransactionValidationErrorType.ZeroValueField:\n      return `${validationError.data} must not be 0`\n    case TransactionValidationErrorType.ArbitraryConstraint:\n      return validationError.data\n  }\n}\n"],"mappings":";AAAA,IAAY,iCAAL,yBAAA,gCAAA;AACL,gCAAA,+BAAA,mBAAA,KAAA;AACA,gCAAA,+BAAA,kBAAA,KAAA;AACA,gCAAA,+BAAA,oBAAA,KAAA;AACA,gCAAA,+BAAA,oBAAA,KAAA;AACA,gCAAA,+BAAA,yBAAA,KAAA;;KACD;AAuCD,SAAgB,0BAA0B,iBAAqD;AAC7F,SAAQ,gBAAgB,MAAxB;EACE,KAAK,+BAA+B,cAClC,QAAO,GAAG,gBAAgB,KAAK;EACjC,KAAK,+BAA+B,aAClC,QAAO,GAAG,gBAAgB,KAAK,MAAM,iBAAiB,gBAAgB,KAAK,IAAI,GAAG,gBAAgB,KAAK,KAAK,QAAQ,gBAAgB,KAAK;EAC3I,KAAK,+BAA+B,eAClC,QAAO,GAAG,gBAAgB,KAAK;EACjC,KAAK,+BAA+B,eAClC,QAAO,GAAG,gBAAgB,KAAK;EACjC,KAAK,+BAA+B,oBAClC,QAAO,gBAAgB"}