@algorandfoundation/algokit-utils 9.2.0-beta.7 → 10.0.0-alpha.1

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

@@ -0,0 +1,250 @@
+import { MAX_ACCOUNT_REFERENCES, MAX_APP_ARGS, MAX_APP_REFERENCES, MAX_ARGS_SIZE, MAX_ASSET_REFERENCES, MAX_BOX_REFERENCES, MAX_EXTRA_PROGRAM_PAGES, MAX_GLOBAL_STATE_KEYS, MAX_LOCAL_STATE_KEYS, MAX_OVERALL_REFERENCES, PROGRAM_PAGE_SIZE } from "../../../common/src/constants.mjs";
+import { TransactionValidationErrorType } from "./common.mjs";
+
+//#region packages/transact/src/transactions/app-call.ts
+/**
+* On-completion actions for application transactions.
+*
+* These values define what additional actions occur with the transaction.
+*/
+let OnApplicationComplete = /* @__PURE__ */ function(OnApplicationComplete$1) {
+	/**
+	* NoOp indicates that an app transaction will simply call its
+	* approval program without any additional action.
+	*/
+	OnApplicationComplete$1[OnApplicationComplete$1["NoOp"] = 0] = "NoOp";
+	/**
+	* OptIn indicates that an app transaction will allocate some
+	* local state for the app in the sender's account.
+	*/
+	OnApplicationComplete$1[OnApplicationComplete$1["OptIn"] = 1] = "OptIn";
+	/**
+	* CloseOut indicates that an app transaction will deallocate
+	* some local state for the app from the user's account.
+	*/
+	OnApplicationComplete$1[OnApplicationComplete$1["CloseOut"] = 2] = "CloseOut";
+	/**
+	* ClearState is similar to CloseOut, but may never fail. This
+	* allows users to reclaim their minimum balance from an app
+	* they no longer wish to opt in to.
+	*/
+	OnApplicationComplete$1[OnApplicationComplete$1["ClearState"] = 3] = "ClearState";
+	/**
+	* UpdateApplication indicates that an app transaction will
+	* update the approval program and clear state program for the app.
+	*/
+	OnApplicationComplete$1[OnApplicationComplete$1["UpdateApplication"] = 4] = "UpdateApplication";
+	/**
+	* DeleteApplication indicates that an app transaction will
+	* delete the app parameters for the app from the creator's
+	* balance record.
+	*/
+	OnApplicationComplete$1[OnApplicationComplete$1["DeleteApplication"] = 5] = "DeleteApplication";
+	return OnApplicationComplete$1;
+}({});
+const FIELD_ARGS = "Args";
+const FIELD_APPROVAL_PROGRAM = "Approval program";
+const FIELD_CLEAR_STATE_PROGRAM = "Clear state program";
+const FIELD_GLOBAL_STATE_SCHEMA = "Global state schema";
+const FIELD_LOCAL_STATE_SCHEMA = "Local state schema";
+const FIELD_EXTRA_PROGRAM_PAGES = "Extra program pages";
+/**
+* Validate app call transaction fields
+*/
+function validateAppCallTransaction(appCall) {
+	const errors = new Array();
+	if (appCall.appId === 0n) errors.push(...validateAppCreation(appCall));
+	else errors.push(...validateAppOperation(appCall));
+	errors.push(...validateAppCommonFields(appCall));
+	return errors;
+}
+/**
+* Validate app creation fields
+*/
+function validateAppCreation(appCall) {
+	const errors = new Array();
+	if (!appCall.approvalProgram || appCall.approvalProgram.length === 0) errors.push({
+		type: TransactionValidationErrorType.RequiredField,
+		data: FIELD_APPROVAL_PROGRAM
+	});
+	if (!appCall.clearStateProgram || appCall.clearStateProgram.length === 0) errors.push({
+		type: TransactionValidationErrorType.RequiredField,
+		data: FIELD_CLEAR_STATE_PROGRAM
+	});
+	const extraPages = appCall.extraProgramPages ?? 0;
+	if (extraPages > MAX_EXTRA_PROGRAM_PAGES) errors.push({
+		type: TransactionValidationErrorType.FieldTooLong,
+		data: {
+			field: FIELD_EXTRA_PROGRAM_PAGES,
+			actual: extraPages,
+			max: MAX_EXTRA_PROGRAM_PAGES,
+			unit: "pages"
+		}
+	});
+	const maxProgramSize = PROGRAM_PAGE_SIZE + extraPages * PROGRAM_PAGE_SIZE;
+	if (appCall.approvalProgram && appCall.approvalProgram.length > maxProgramSize) errors.push({
+		type: TransactionValidationErrorType.FieldTooLong,
+		data: {
+			field: FIELD_APPROVAL_PROGRAM,
+			actual: appCall.approvalProgram.length,
+			max: maxProgramSize,
+			unit: "bytes"
+		}
+	});
+	if (appCall.clearStateProgram && appCall.clearStateProgram.length > maxProgramSize) errors.push({
+		type: TransactionValidationErrorType.FieldTooLong,
+		data: {
+			field: FIELD_CLEAR_STATE_PROGRAM,
+			actual: appCall.clearStateProgram.length,
+			max: maxProgramSize,
+			unit: "bytes"
+		}
+	});
+	const totalProgramSize = (appCall.approvalProgram?.length ?? 0) + (appCall.clearStateProgram?.length ?? 0);
+	if (totalProgramSize > maxProgramSize) errors.push({
+		type: TransactionValidationErrorType.FieldTooLong,
+		data: {
+			field: "Combined approval and clear state programs",
+			actual: totalProgramSize,
+			max: maxProgramSize,
+			unit: "bytes"
+		}
+	});
+	if (appCall.globalStateSchema) {
+		if (appCall.globalStateSchema.numUints + appCall.globalStateSchema.numByteSlices > MAX_GLOBAL_STATE_KEYS) errors.push({
+			type: TransactionValidationErrorType.FieldTooLong,
+			data: {
+				field: FIELD_GLOBAL_STATE_SCHEMA,
+				actual: appCall.globalStateSchema.numUints + appCall.globalStateSchema.numByteSlices,
+				max: MAX_GLOBAL_STATE_KEYS,
+				unit: "keys"
+			}
+		});
+	}
+	if (appCall.localStateSchema) {
+		if (appCall.localStateSchema.numUints + appCall.localStateSchema.numByteSlices > MAX_LOCAL_STATE_KEYS) errors.push({
+			type: TransactionValidationErrorType.FieldTooLong,
+			data: {
+				field: FIELD_LOCAL_STATE_SCHEMA,
+				actual: appCall.localStateSchema.numUints + appCall.localStateSchema.numByteSlices,
+				max: MAX_LOCAL_STATE_KEYS,
+				unit: "keys"
+			}
+		});
+	}
+	return errors;
+}
+/**
+* Validate app operation (update, delete, call) fields
+*/
+function validateAppOperation(appCall) {
+	const errors = new Array();
+	if (appCall.onComplete === OnApplicationComplete.UpdateApplication) {
+		if (!appCall.approvalProgram || appCall.approvalProgram.length === 0) errors.push({
+			type: TransactionValidationErrorType.RequiredField,
+			data: FIELD_APPROVAL_PROGRAM
+		});
+		if (!appCall.clearStateProgram || appCall.clearStateProgram.length === 0) errors.push({
+			type: TransactionValidationErrorType.RequiredField,
+			data: FIELD_CLEAR_STATE_PROGRAM
+		});
+	}
+	if (appCall.globalStateSchema !== void 0) errors.push({
+		type: TransactionValidationErrorType.ImmutableField,
+		data: FIELD_GLOBAL_STATE_SCHEMA
+	});
+	if (appCall.localStateSchema !== void 0) errors.push({
+		type: TransactionValidationErrorType.ImmutableField,
+		data: FIELD_LOCAL_STATE_SCHEMA
+	});
+	if (appCall.extraProgramPages !== void 0) errors.push({
+		type: TransactionValidationErrorType.ImmutableField,
+		data: FIELD_EXTRA_PROGRAM_PAGES
+	});
+	return errors;
+}
+/**
+* Validate common app call fields
+*/
+function validateAppCommonFields(appCall) {
+	const errors = new Array();
+	if (appCall.args) {
+		if (appCall.args.length > MAX_APP_ARGS) errors.push({
+			type: TransactionValidationErrorType.FieldTooLong,
+			data: {
+				field: FIELD_ARGS,
+				actual: appCall.args.length,
+				max: MAX_APP_ARGS,
+				unit: "arguments"
+			}
+		});
+		const totalArgsSize = appCall.args.reduce((sum, arg) => sum + arg.length, 0);
+		if (totalArgsSize > MAX_ARGS_SIZE) errors.push({
+			type: TransactionValidationErrorType.FieldTooLong,
+			data: {
+				field: "Args total size",
+				actual: totalArgsSize,
+				max: MAX_ARGS_SIZE,
+				unit: "bytes"
+			}
+		});
+	}
+	if (appCall.accountReferences && appCall.accountReferences.length > MAX_ACCOUNT_REFERENCES) errors.push({
+		type: TransactionValidationErrorType.FieldTooLong,
+		data: {
+			field: "Account references",
+			actual: appCall.accountReferences.length,
+			max: MAX_ACCOUNT_REFERENCES,
+			unit: "refs"
+		}
+	});
+	if (appCall.appReferences && appCall.appReferences.length > MAX_APP_REFERENCES) errors.push({
+		type: TransactionValidationErrorType.FieldTooLong,
+		data: {
+			field: "App references",
+			actual: appCall.appReferences.length,
+			max: MAX_APP_REFERENCES,
+			unit: "refs"
+		}
+	});
+	if (appCall.assetReferences && appCall.assetReferences.length > MAX_ASSET_REFERENCES) errors.push({
+		type: TransactionValidationErrorType.FieldTooLong,
+		data: {
+			field: "Asset references",
+			actual: appCall.assetReferences.length,
+			max: MAX_ASSET_REFERENCES,
+			unit: "refs"
+		}
+	});
+	if (appCall.boxReferences) {
+		if (appCall.boxReferences.length > MAX_BOX_REFERENCES) errors.push({
+			type: TransactionValidationErrorType.FieldTooLong,
+			data: {
+				field: "Box references",
+				actual: appCall.boxReferences.length,
+				max: MAX_BOX_REFERENCES,
+				unit: "refs"
+			}
+		});
+		const appRefs = appCall.appReferences || [];
+		for (const boxRef of appCall.boxReferences) if (boxRef.appId !== 0n && boxRef.appId !== appCall.appId && !appRefs.includes(boxRef.appId)) errors.push({
+			type: TransactionValidationErrorType.ArbitraryConstraint,
+			data: `Box reference for app ID ${boxRef.appId} must be in app references`
+		});
+	}
+	const totalReferences = (appCall.accountReferences?.length || 0) + (appCall.appReferences?.length || 0) + (appCall.assetReferences?.length || 0) + (appCall.boxReferences?.length || 0);
+	if (totalReferences > MAX_OVERALL_REFERENCES) errors.push({
+		type: TransactionValidationErrorType.FieldTooLong,
+		data: {
+			field: "Total references",
+			actual: totalReferences,
+			max: MAX_OVERALL_REFERENCES,
+			unit: "refs"
+		}
+	});
+	return errors;
+}
+
+//#endregion
+export { OnApplicationComplete, validateAppCallTransaction };
+//# sourceMappingURL=app-call.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"app-call.mjs","names":[],"sources":["../../../../../packages/transact/src/transactions/app-call.ts"],"sourcesContent":["import {\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  Address,\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?: AccessReference[]\n\n  /**\n   * The lowest application version for which this transaction should immediately fail. 0 indicates that no version check should be performed.\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 interface AccessReference {\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 interface 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 interface 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({\n      type: TransactionValidationErrorType.RequiredField,\n      data: FIELD_APPROVAL_PROGRAM,\n    })\n  }\n\n  if (!appCall.clearStateProgram || appCall.clearStateProgram.length === 0) {\n    errors.push({\n      type: TransactionValidationErrorType.RequiredField,\n      data: FIELD_CLEAR_STATE_PROGRAM,\n    })\n  }\n\n  const extraPages = appCall.extraProgramPages ?? 0\n  if (extraPages > MAX_EXTRA_PROGRAM_PAGES) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: {\n        field: FIELD_EXTRA_PROGRAM_PAGES,\n        actual: extraPages,\n        max: MAX_EXTRA_PROGRAM_PAGES,\n        unit: 'pages',\n      },\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: {\n        field: FIELD_APPROVAL_PROGRAM,\n        actual: appCall.approvalProgram.length,\n        max: maxProgramSize,\n        unit: 'bytes',\n      },\n    })\n  }\n\n  if (appCall.clearStateProgram && appCall.clearStateProgram.length > maxProgramSize) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: {\n        field: FIELD_CLEAR_STATE_PROGRAM,\n        actual: appCall.clearStateProgram.length,\n        max: maxProgramSize,\n        unit: 'bytes',\n      },\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: {\n        field: 'Combined approval and clear state programs',\n        actual: totalProgramSize,\n        max: maxProgramSize,\n        unit: 'bytes',\n      },\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({\n        type: TransactionValidationErrorType.RequiredField,\n        data: FIELD_APPROVAL_PROGRAM,\n      })\n    }\n    if (!appCall.clearStateProgram || appCall.clearStateProgram.length === 0) {\n      errors.push({\n        type: TransactionValidationErrorType.RequiredField,\n        data: FIELD_CLEAR_STATE_PROGRAM,\n      })\n    }\n  }\n\n  // These fields are immutable and cannot be set for existing apps\n  if (appCall.globalStateSchema !== undefined) {\n    errors.push({\n      type: TransactionValidationErrorType.ImmutableField,\n      data: FIELD_GLOBAL_STATE_SCHEMA,\n    })\n  }\n  if (appCall.localStateSchema !== undefined) {\n    errors.push({\n      type: TransactionValidationErrorType.ImmutableField,\n      data: FIELD_LOCAL_STATE_SCHEMA,\n    })\n  }\n  if (appCall.extraProgramPages !== undefined) {\n    errors.push({\n      type: TransactionValidationErrorType.ImmutableField,\n      data: FIELD_EXTRA_PROGRAM_PAGES,\n    })\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: {\n          field: FIELD_ARGS,\n          actual: appCall.args.length,\n          max: MAX_APP_ARGS,\n          unit: 'arguments',\n        },\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: {\n          field: 'Args total size',\n          actual: totalArgsSize,\n          max: MAX_ARGS_SIZE,\n          unit: 'bytes',\n        },\n      })\n    }\n  }\n\n  if (appCall.accountReferences && appCall.accountReferences.length > MAX_ACCOUNT_REFERENCES) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: {\n        field: 'Account references',\n        actual: appCall.accountReferences.length,\n        max: MAX_ACCOUNT_REFERENCES,\n        unit: 'refs',\n      },\n    })\n  }\n\n  if (appCall.appReferences && appCall.appReferences.length > MAX_APP_REFERENCES) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: {\n        field: 'App references',\n        actual: appCall.appReferences.length,\n        max: MAX_APP_REFERENCES,\n        unit: 'refs',\n      },\n    })\n  }\n\n  if (appCall.assetReferences && appCall.assetReferences.length > MAX_ASSET_REFERENCES) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: {\n        field: 'Asset references',\n        actual: appCall.assetReferences.length,\n        max: MAX_ASSET_REFERENCES,\n        unit: 'refs',\n      },\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: {\n          field: 'Box references',\n          actual: appCall.boxReferences.length,\n          max: MAX_BOX_REFERENCES,\n          unit: 'refs',\n        },\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: {\n        field: 'Total references',\n        actual: totalReferences,\n        max: MAX_OVERALL_REFERENCES,\n        unit: 'refs',\n      },\n    })\n  }\n\n  return errors\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,131 @@
+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.
+ */
+type AssetConfigTransactionFields = {
+  /**
+   * ID of the asset to operate on.
+   *
+   * For asset creation, this must be 0.
+   * For asset reconfiguration this is the ID of the existing asset to be reconfigured,
+   * For asset destroy this is the ID of the existing asset to be destroyed.
+   */
+  assetId: bigint;
+  /**
+   * The total amount of the smallest divisible (decimal) unit to create.
+   *
+   * Required when creating a new asset.
+   * For example, if creating a asset with 2 decimals and wanting a total supply of 100 units, this value should be 10000.
+   *
+   * This field can only be specified upon asset creation.
+   */
+  total?: bigint;
+  /**
+   * The amount of decimal places the asset should have.
+   *
+   * If unspecified then the asset will be in whole units (i.e. `0`).
+   * * If 0, the asset is not divisible;
+   * * If 1, the base unit of the asset is in tenths;
+   * * If 2, the base unit of the asset is in hundredths;
+   * * If 3, the base unit of the asset is in thousandths;
+   *
+   * and so on up to 19 decimal places.
+   *
+   * This field can only be specified upon asset creation.
+   */
+  decimals?: number;
+  /**
+   * Whether the asset is frozen by default for all accounts.
+   * Defaults to `false`.
+   *
+   * If `true` then for anyone apart from the creator to hold the
+   * asset it needs to be unfrozen per account using an asset freeze
+   * transaction from the `freeze` account, which must be set on creation.
+   *
+   * This field can only be specified upon asset creation.
+   */
+  defaultFrozen?: boolean;
+  /**
+   * The optional name of the asset.
+   *
+   * Max size is 32 bytes.
+   *
+   * This field can only be specified upon asset creation.
+   */
+  assetName?: string;
+  /**
+   * The optional name of the unit of this asset (e.g. ticker name).
+   *
+   * Max size is 8 bytes.
+   *
+   * This field can only be specified upon asset creation.
+   */
+  unitName?: string;
+  /**
+   * Specifies an optional URL where more information about the asset can be retrieved (e.g. metadata).
+   *
+   * Max size is 96 bytes.
+   *
+   * This field can only be specified upon asset creation.
+   */
+  url?: string;
+  /**
+   * 32-byte hash of some metadata that is relevant to your asset and/or asset holders.
+   *
+   * The format of this metadata is up to the application.
+   *
+   * This field can only be specified upon asset creation.
+   */
+  metadataHash?: Uint8Array;
+  /**
+   * The address of the optional account that can manage the configuration of the asset and destroy it.
+   *
+   * The configuration fields it can change are `manager`, `reserve`, `clawback`, and `freeze`.
+   *
+   * If not set or set to the Zero address the asset becomes permanently immutable.
+   */
+  manager?: Address;
+  /**
+   * The address of the optional account that holds the reserve (uncirculated supply) units of the asset.
+   *
+   * This address has no specific authority in the protocol itself and is informational only.
+   *
+   * Some standards like [ARC-19](https://github.com/algorandfoundation/ARCs/blob/main/ARCs/arc-0019.md)
+   * rely on this field to hold meaningful data.
+   *
+   * It can be used in the case where you want to signal to holders of your asset that the uncirculated units
+   * of the asset reside in an account that is different from the default creator account.
+   *
+   * If not set or set to the Zero address the field is permanently empty.
+   */
+  reserve?: Address;
+  /**
+   * The address of the optional account that can be used to freeze or unfreeze holdings of this asset for any account.
+   *
+   * If empty, freezing is not permitted.
+   *
+   * If not set or set to the Zero address the field is permanently empty.
+   */
+  freeze?: Address;
+  /**
+   * The address of the optional account that can clawback holdings of this asset from any account.
+   *
+   * **This field should be used with caution** as the clawback account has the ability to **unconditionally take assets from any account**.
+   *
+   * If empty, clawback is not permitted.
+   *
+   * If not set or set to the Zero address the field is permanently empty.
+   */
+  clawback?: Address;
+};
+/**
+ * Validate asset configuration transaction fields
+ */
+declare function validateAssetConfigTransaction(assetConfig: AssetConfigTransactionFields): TransactionValidationError[];
+//#endregion
+export { AssetConfigTransactionFields, validateAssetConfigTransaction };
+//# sourceMappingURL=asset-config.d.ts.map

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

@@ -0,0 +1,101 @@
+const require_constants = require('../../../common/src/constants.js');
+const require_common = require('./common.js');
+
+//#region packages/transact/src/transactions/asset-config.ts
+/**
+* Validate asset configuration transaction fields
+*/
+function validateAssetConfigTransaction(assetConfig) {
+	const errors = new Array();
+	if (assetConfig.assetId === 0n) errors.push(...validateAssetCreation(assetConfig));
+	else errors.push(...validateAssetConfiguration(assetConfig));
+	return errors;
+}
+/**
+* Validate asset creation fields
+*/
+function validateAssetCreation(assetConfig) {
+	const errors = new Array();
+	if (assetConfig.total === void 0) errors.push({
+		type: require_common.TransactionValidationErrorType.RequiredField,
+		data: "Total"
+	});
+	if (assetConfig.decimals !== void 0 && assetConfig.decimals > require_constants.MAX_ASSET_DECIMALS) errors.push({
+		type: require_common.TransactionValidationErrorType.FieldTooLong,
+		data: {
+			field: "Decimals",
+			actual: assetConfig.decimals,
+			max: require_constants.MAX_ASSET_DECIMALS,
+			unit: "decimal places"
+		}
+	});
+	if (assetConfig.unitName && assetConfig.unitName.length > require_constants.MAX_ASSET_UNIT_NAME_LENGTH) errors.push({
+		type: require_common.TransactionValidationErrorType.FieldTooLong,
+		data: {
+			field: "Unit name",
+			actual: assetConfig.unitName.length,
+			max: require_constants.MAX_ASSET_UNIT_NAME_LENGTH,
+			unit: "bytes"
+		}
+	});
+	if (assetConfig.assetName && assetConfig.assetName.length > require_constants.MAX_ASSET_NAME_LENGTH) errors.push({
+		type: require_common.TransactionValidationErrorType.FieldTooLong,
+		data: {
+			field: "Asset name",
+			actual: assetConfig.assetName.length,
+			max: require_constants.MAX_ASSET_NAME_LENGTH,
+			unit: "bytes"
+		}
+	});
+	if (assetConfig.url && assetConfig.url.length > require_constants.MAX_ASSET_URL_LENGTH) errors.push({
+		type: require_common.TransactionValidationErrorType.FieldTooLong,
+		data: {
+			field: "Url",
+			actual: assetConfig.url.length,
+			max: require_constants.MAX_ASSET_URL_LENGTH,
+			unit: "bytes"
+		}
+	});
+	return errors;
+}
+/**
+* Validate asset configuration fields
+*/
+function validateAssetConfiguration(assetConfig) {
+	const errors = new Array();
+	if (assetConfig.total !== void 0 || assetConfig.decimals !== void 0 || assetConfig.defaultFrozen !== void 0 || assetConfig.assetName !== void 0 || assetConfig.unitName !== void 0 || assetConfig.url !== void 0 || assetConfig.metadataHash !== void 0 || assetConfig.manager !== void 0 || assetConfig.reserve !== void 0 || assetConfig.freeze !== void 0 || assetConfig.clawback !== void 0) {
+		if (assetConfig.total !== void 0) errors.push({
+			type: require_common.TransactionValidationErrorType.ImmutableField,
+			data: "Total"
+		});
+		if (assetConfig.decimals !== void 0) errors.push({
+			type: require_common.TransactionValidationErrorType.ImmutableField,
+			data: "Decimals"
+		});
+		if (assetConfig.defaultFrozen !== void 0) errors.push({
+			type: require_common.TransactionValidationErrorType.ImmutableField,
+			data: "Default frozen"
+		});
+		if (assetConfig.assetName !== void 0) errors.push({
+			type: require_common.TransactionValidationErrorType.ImmutableField,
+			data: "Asset name"
+		});
+		if (assetConfig.unitName !== void 0) errors.push({
+			type: require_common.TransactionValidationErrorType.ImmutableField,
+			data: "Unit name"
+		});
+		if (assetConfig.url !== void 0) errors.push({
+			type: require_common.TransactionValidationErrorType.ImmutableField,
+			data: "Url"
+		});
+		if (assetConfig.metadataHash !== void 0) errors.push({
+			type: require_common.TransactionValidationErrorType.ImmutableField,
+			data: "Metadata hash"
+		});
+	}
+	return errors;
+}
+
+//#endregion
+exports.validateAssetConfigTransaction = validateAssetConfigTransaction;
+//# sourceMappingURL=asset-config.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,101 @@
+import { MAX_ASSET_DECIMALS, MAX_ASSET_NAME_LENGTH, MAX_ASSET_UNIT_NAME_LENGTH, MAX_ASSET_URL_LENGTH } from "../../../common/src/constants.mjs";
+import { TransactionValidationErrorType } from "./common.mjs";
+
+//#region packages/transact/src/transactions/asset-config.ts
+/**
+* Validate asset configuration transaction fields
+*/
+function validateAssetConfigTransaction(assetConfig) {
+	const errors = new Array();
+	if (assetConfig.assetId === 0n) errors.push(...validateAssetCreation(assetConfig));
+	else errors.push(...validateAssetConfiguration(assetConfig));
+	return errors;
+}
+/**
+* Validate asset creation fields
+*/
+function validateAssetCreation(assetConfig) {
+	const errors = new Array();
+	if (assetConfig.total === void 0) errors.push({
+		type: TransactionValidationErrorType.RequiredField,
+		data: "Total"
+	});
+	if (assetConfig.decimals !== void 0 && assetConfig.decimals > MAX_ASSET_DECIMALS) errors.push({
+		type: TransactionValidationErrorType.FieldTooLong,
+		data: {
+			field: "Decimals",
+			actual: assetConfig.decimals,
+			max: MAX_ASSET_DECIMALS,
+			unit: "decimal places"
+		}
+	});
+	if (assetConfig.unitName && assetConfig.unitName.length > MAX_ASSET_UNIT_NAME_LENGTH) errors.push({
+		type: TransactionValidationErrorType.FieldTooLong,
+		data: {
+			field: "Unit name",
+			actual: assetConfig.unitName.length,
+			max: MAX_ASSET_UNIT_NAME_LENGTH,
+			unit: "bytes"
+		}
+	});
+	if (assetConfig.assetName && assetConfig.assetName.length > MAX_ASSET_NAME_LENGTH) errors.push({
+		type: TransactionValidationErrorType.FieldTooLong,
+		data: {
+			field: "Asset name",
+			actual: assetConfig.assetName.length,
+			max: MAX_ASSET_NAME_LENGTH,
+			unit: "bytes"
+		}
+	});
+	if (assetConfig.url && assetConfig.url.length > MAX_ASSET_URL_LENGTH) errors.push({
+		type: TransactionValidationErrorType.FieldTooLong,
+		data: {
+			field: "Url",
+			actual: assetConfig.url.length,
+			max: MAX_ASSET_URL_LENGTH,
+			unit: "bytes"
+		}
+	});
+	return errors;
+}
+/**
+* Validate asset configuration fields
+*/
+function validateAssetConfiguration(assetConfig) {
+	const errors = new Array();
+	if (assetConfig.total !== void 0 || assetConfig.decimals !== void 0 || assetConfig.defaultFrozen !== void 0 || assetConfig.assetName !== void 0 || assetConfig.unitName !== void 0 || assetConfig.url !== void 0 || assetConfig.metadataHash !== void 0 || assetConfig.manager !== void 0 || assetConfig.reserve !== void 0 || assetConfig.freeze !== void 0 || assetConfig.clawback !== void 0) {
+		if (assetConfig.total !== void 0) errors.push({
+			type: TransactionValidationErrorType.ImmutableField,
+			data: "Total"
+		});
+		if (assetConfig.decimals !== void 0) errors.push({
+			type: TransactionValidationErrorType.ImmutableField,
+			data: "Decimals"
+		});
+		if (assetConfig.defaultFrozen !== void 0) errors.push({
+			type: TransactionValidationErrorType.ImmutableField,
+			data: "Default frozen"
+		});
+		if (assetConfig.assetName !== void 0) errors.push({
+			type: TransactionValidationErrorType.ImmutableField,
+			data: "Asset name"
+		});
+		if (assetConfig.unitName !== void 0) errors.push({
+			type: TransactionValidationErrorType.ImmutableField,
+			data: "Unit name"
+		});
+		if (assetConfig.url !== void 0) errors.push({
+			type: TransactionValidationErrorType.ImmutableField,
+			data: "Url"
+		});
+		if (assetConfig.metadataHash !== void 0) errors.push({
+			type: TransactionValidationErrorType.ImmutableField,
+			data: "Metadata hash"
+		});
+	}
+	return errors;
+}
+
+//#endregion
+export { validateAssetConfigTransaction };
+//# sourceMappingURL=asset-config.mjs.map