@algorandfoundation/algokit-utils 10.0.0-beta.3 → 10.0.0-beta.4

package/packages/transact/src/signer.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"signer.mjs","names":[],"sources":["../../../../packages/transact/src/signer.ts"],"sourcesContent":["import { Address, Addressable, concatArrays, Expand, ReadableAddress } from '@algorandfoundation/algokit-common'\nimport { DelegatedLsigSigner, LogicSig, ProgramDataSigner } from './logicsig'\nimport { encodeSignedTransaction, SignedTransaction, validateSignedTransaction } from './transactions/signed-transaction'\nimport { encodeTransaction, Transaction } from './transactions/transaction'\nimport type { RawEd25519Signer } from '@algorandfoundation/algokit-crypto'\nimport { MultisigAccount } from './multisig'\n\n/** Function for signing a group of transactions */\nexport type TransactionSigner = (txnGroup: Transaction[], indexesToSign: number[]) => Promise<Uint8Array[]>\n\n/** A transaction signer attached to an address */\nexport interface AddressWithTransactionSigner extends Addressable {\n  signer: TransactionSigner\n}\n\n/** An address that can be used to send transactions that may or may not have a signer */\nexport type SendingAddress = ReadableAddress | AddressWithTransactionSigner\n\n/** A delegated logic signature signer attached to an address */\nexport interface AddressWithDelegatedLsigSigner extends Addressable {\n  lsigSigner: DelegatedLsigSigner\n}\n\nexport interface AddressWithProgramDataSigner extends Addressable {\n  programDataSigner: ProgramDataSigner\n}\n\nexport type MxBytesSigner = (bytesToSign: Uint8Array) => Promise<Uint8Array>\n\nexport interface AddressWithMxBytesSigner extends Addressable {\n  mxBytesSigner: MxBytesSigner\n}\n\nexport type AddressWithSigners = Expand<\n  Addressable & AddressWithTransactionSigner & AddressWithDelegatedLsigSigner & AddressWithProgramDataSigner & AddressWithMxBytesSigner\n>\n\nconst SIGN_BYTES_PREFIX = Uint8Array.from([77, 88]) // \"MX\"\n\n/**\n * Generate type-safe domain-separated signer callbacks given an ed25519 pubkey and a signing callback\n * @param args - The arguments for generating signers\n * @param args.ed25519Pubkey - The ed25519 public key used for signing\n * @param args.sendingAddress - The address that will be used as the sender of transactions. If not provided, defaults to the address derived from the ed25519 public key. This is useful when signing for a rekeyed account where the sending address differs from the auth address.\n * @param args.rawEd25519Signer - A callback function that signs raw bytes using the ed25519 private key\n * @returns An object containing the sending address and various signer functions\n */\nexport function generateAddressWithSigners(args: {\n  ed25519Pubkey: Uint8Array\n  sendingAddress?: Address\n  rawEd25519Signer: RawEd25519Signer\n}): AddressWithSigners {\n  const { ed25519Pubkey, rawEd25519Signer } = args\n  const authAddr = new Address(ed25519Pubkey)\n  const sendingAddress = args.sendingAddress ?? authAddr\n\n  const signer: TransactionSigner = async (txnGroup: Transaction[], indexesToSign: number[]) => {\n    const stxns: SignedTransaction[] = []\n    for (const index of indexesToSign) {\n      const txn = txnGroup[index]\n      const bytesToSign = encodeTransaction(txn)\n      const signature = await rawEd25519Signer(bytesToSign)\n      const stxn: SignedTransaction = {\n        txn,\n        sig: signature,\n      }\n\n      if (!txn.sender.equals(sendingAddress)) {\n        stxn.authAddress = authAddr\n      }\n\n      stxns.push(stxn)\n    }\n\n    return stxns.map((stxn) => {\n      validateSignedTransaction(stxn)\n      return encodeSignedTransaction(stxn)\n    })\n  }\n\n  const lsigSigner: DelegatedLsigSigner = async (lsig, msig) => {\n    const bytesToSign = lsig.bytesToSignForDelegation(msig)\n    const sig = await rawEd25519Signer(bytesToSign)\n    return { sig, addr: sendingAddress }\n  }\n\n  const programDataSigner: ProgramDataSigner = async (data, lsig) => {\n    const bytesToSign = lsig.programDataToSign(data)\n    return await rawEd25519Signer(bytesToSign)\n  }\n\n  const mxBytesSigner: MxBytesSigner = async (bytes: Uint8Array) => {\n    const bytesToSign = concatArrays(SIGN_BYTES_PREFIX, bytes)\n    return await rawEd25519Signer(bytesToSign)\n  }\n\n  return { addr: sendingAddress, signer, lsigSigner, programDataSigner, mxBytesSigner }\n}\n\n/**\n * Create a makeEmptyTransactionSigner that does not specify any signer or\n * signing capabilities. This should only be used to simulate transactions.\n */\nexport function makeEmptyTransactionSigner(): TransactionSigner {\n  return (txnGroup: Transaction[], indexesToSign: number[]) => {\n    const unsigned: Uint8Array[] = []\n\n    for (const index of indexesToSign) {\n      const stxn: SignedTransaction = {\n        txn: txnGroup[index],\n        sig: new Uint8Array(64).fill(0),\n      }\n      validateSignedTransaction(stxn)\n      unsigned.push(encodeSignedTransaction(stxn))\n    }\n\n    return Promise.resolve(unsigned)\n  }\n}\n\nexport const bytesForSigning = {\n  transaction(txn: Transaction): Uint8Array {\n    return encodeTransaction(txn)\n  },\n  mxBytes(bytes: Uint8Array): Uint8Array {\n    return concatArrays(SIGN_BYTES_PREFIX, bytes)\n  },\n  lsigForDelegation(lsig: LogicSig, msig?: MultisigAccount): Uint8Array {\n    return lsig.bytesToSignForDelegation(msig)\n  },\n  programData(lsig: LogicSig, data: Uint8Array): Uint8Array {\n    return lsig.programDataToSign(data)\n  },\n}\n"],"mappings":";;;;;AAqCA,MAAM,oBAAoB,WAAW,KAAK,CAAC,IAAI,GAAG,CAAC;;;;;;;;;AAUnD,SAAgB,2BAA2B,MAIpB;CACrB,MAAM,EAAE,eAAe,qBAAqB;CAC5C,MAAM,WAAW,IAAI,QAAQ,cAAc;CAC3C,MAAM,iBAAiB,KAAK,kBAAkB;CAE9C,MAAM,SAA4B,OAAO,UAAyB,kBAA4B;EAC5F,MAAM,QAA6B,EAAE;AACrC,OAAK,MAAM,SAAS,eAAe;GACjC,MAAM,MAAM,SAAS;GAGrB,MAAM,OAA0B;IAC9B;IACA,KAHgB,MAAM,iBADJ,kBAAkB,IAAI,CACW;IAIpD;AAED,OAAI,CAAC,IAAI,OAAO,OAAO,eAAe,CACpC,MAAK,cAAc;AAGrB,SAAM,KAAK,KAAK;;AAGlB,SAAO,MAAM,KAAK,SAAS;AACzB,6BAA0B,KAAK;AAC/B,UAAO,wBAAwB,KAAK;IACpC;;CAGJ,MAAM,aAAkC,OAAO,MAAM,SAAS;AAG5D,SAAO;GAAE,KADG,MAAM,iBADE,KAAK,yBAAyB,KAAK,CACR;GACjC,MAAM;GAAgB;;CAGtC,MAAM,oBAAuC,OAAO,MAAM,SAAS;AAEjE,SAAO,MAAM,iBADO,KAAK,kBAAkB,KAAK,CACN;;CAG5C,MAAM,gBAA+B,OAAO,UAAsB;AAEhE,SAAO,MAAM,iBADO,aAAa,mBAAmB,MAAM,CAChB;;AAG5C,QAAO;EAAE,MAAM;EAAgB;EAAQ;EAAY;EAAmB;EAAe;;;;;;AAOvF,SAAgB,6BAAgD;AAC9D,SAAQ,UAAyB,kBAA4B;EAC3D,MAAM,WAAyB,EAAE;AAEjC,OAAK,MAAM,SAAS,eAAe;GACjC,MAAM,OAA0B;IAC9B,KAAK,SAAS;IACd,KAAK,IAAI,WAAW,GAAG,CAAC,KAAK,EAAE;IAChC;AACD,6BAA0B,KAAK;AAC/B,YAAS,KAAK,wBAAwB,KAAK,CAAC;;AAG9C,SAAO,QAAQ,QAAQ,SAAS;;;AAIpC,MAAa,kBAAkB;CAC7B,YAAY,KAA8B;AACxC,SAAO,kBAAkB,IAAI;;CAE/B,QAAQ,OAA+B;AACrC,SAAO,aAAa,mBAAmB,MAAM;;CAE/C,kBAAkB,MAAgB,MAAoC;AACpE,SAAO,KAAK,yBAAyB,KAAK;;CAE5C,YAAY,MAAgB,MAA8B;AACxD,SAAO,KAAK,kBAAkB,KAAK;;CAEtC"}
+{"version":3,"file":"signer.mjs","names":[],"sources":["../../../../packages/transact/src/signer.ts"],"sourcesContent":["import { Address, Addressable, concatArrays, Expand, ReadableAddress } from '@algorandfoundation/algokit-common'\nimport { DelegatedLsigSigner, LogicSig, ProgramDataSigner } from './logicsig'\nimport { encodeSignedTransaction, SignedTransaction, validateSignedTransaction } from './transactions/signed-transaction'\nimport { encodeTransaction, Transaction } from './transactions/transaction'\nimport type { RawEd25519Signer } from '@algorandfoundation/algokit-crypto'\nimport { MultisigAccount } from './multisig'\n\n/** Function for signing a group of transactions */\nexport type TransactionSigner = (txnGroup: Transaction[], indexesToSign: number[]) => Promise<Uint8Array[]>\n\n/** A transaction signer attached to an address */\nexport interface AddressWithTransactionSigner extends Addressable {\n  signer: TransactionSigner\n}\n\n/** An address that can be used to send transactions that may or may not have a signer */\nexport type SendingAddress = ReadableAddress | AddressWithTransactionSigner\n\n/** A delegated logic signature signer attached to an address */\nexport interface AddressWithDelegatedLsigSigner extends Addressable {\n  lsigSigner: DelegatedLsigSigner\n}\n\nexport interface AddressWithProgramDataSigner extends Addressable {\n  programDataSigner: ProgramDataSigner\n}\n\nexport type MxBytesSigner = (bytesToSign: Uint8Array) => Promise<Uint8Array>\n\nexport interface AddressWithMxBytesSigner extends Addressable {\n  mxBytesSigner: MxBytesSigner\n}\n\nexport type AddressWithSigners = Expand<\n  Addressable & AddressWithTransactionSigner & AddressWithDelegatedLsigSigner & AddressWithProgramDataSigner & AddressWithMxBytesSigner\n>\n\nconst SIGN_BYTES_PREFIX = Uint8Array.from([77, 88]) // \"MX\"\n\n/**\n * Generate type-safe domain-separated signer callbacks given an ed25519 pubkey and a signing callback\n * @param args - The arguments for generating signers\n * @param args.ed25519Pubkey - The ed25519 public key used for signing\n * @param args.sendingAddress - The address that will be used as the sender of transactions. If not provided, defaults to the address derived from the ed25519 public key. This is useful when signing for a rekeyed account where the sending address differs from the auth address.\n * @param args.rawEd25519Signer - A callback function that signs raw bytes using the ed25519 private key\n * @returns An object containing the sending address and various signer functions\n */\nexport function generateAddressWithSigners(args: {\n  ed25519Pubkey: Uint8Array\n  sendingAddress?: Address\n  rawEd25519Signer: RawEd25519Signer\n}): AddressWithSigners {\n  const { ed25519Pubkey, rawEd25519Signer } = args\n  const authAddr = new Address(ed25519Pubkey)\n  const sendingAddress = args.sendingAddress ?? authAddr\n\n  const signer: TransactionSigner = async (txnGroup: Transaction[], indexesToSign: number[]) => {\n    const stxns: SignedTransaction[] = []\n    for (const index of indexesToSign) {\n      const txn = txnGroup[index]\n      const bytesToSign = encodeTransaction(txn)\n      const signature = await rawEd25519Signer(bytesToSign)\n      const stxn: SignedTransaction = {\n        txn,\n        sig: signature,\n      }\n\n      if (!txn.sender.equals(sendingAddress)) {\n        stxn.authAddress = authAddr\n      }\n\n      stxns.push(stxn)\n    }\n\n    return stxns.map((stxn) => {\n      validateSignedTransaction(stxn)\n      return encodeSignedTransaction(stxn)\n    })\n  }\n\n  const lsigSigner: DelegatedLsigSigner = async (lsig, msig) => {\n    const bytesToSign = lsig.bytesToSignForDelegation(msig)\n    const sig = await rawEd25519Signer(bytesToSign)\n    return { sig, addr: sendingAddress }\n  }\n\n  const programDataSigner: ProgramDataSigner = async (data, lsig) => {\n    const bytesToSign = lsig.programDataToSign(data)\n    return await rawEd25519Signer(bytesToSign)\n  }\n\n  const mxBytesSigner: MxBytesSigner = async (bytes: Uint8Array) => {\n    const bytesToSign = concatArrays(SIGN_BYTES_PREFIX, bytes)\n    return await rawEd25519Signer(bytesToSign)\n  }\n\n  return { addr: sendingAddress, signer, lsigSigner, programDataSigner, mxBytesSigner }\n}\n\n/**\n * Create a makeEmptyTransactionSigner that does not specify any signer or\n * signing capabilities. This should only be used to simulate transactions.\n */\nexport function makeEmptyTransactionSigner(): TransactionSigner {\n  return (txnGroup: Transaction[], indexesToSign: number[]) => {\n    const unsigned: Uint8Array[] = []\n\n    for (const index of indexesToSign) {\n      const stxn: SignedTransaction = {\n        txn: txnGroup[index],\n        sig: new Uint8Array(64).fill(0),\n      }\n      validateSignedTransaction(stxn)\n      unsigned.push(encodeSignedTransaction(stxn))\n    }\n\n    return Promise.resolve(unsigned)\n  }\n}\n\nexport const bytesForSigning = {\n  transaction(txn: Transaction): Uint8Array {\n    return encodeTransaction(txn)\n  },\n  mxBytes(bytes: Uint8Array): Uint8Array {\n    return concatArrays(SIGN_BYTES_PREFIX, bytes)\n  },\n  lsigForDelegation(lsig: LogicSig, msig?: MultisigAccount): Uint8Array {\n    return lsig.bytesToSignForDelegation(msig)\n  },\n  programData(lsig: LogicSig, data: Uint8Array): Uint8Array {\n    return lsig.programDataToSign(data)\n  },\n}\n"],"mappings":";;;;;AAqCA,MAAM,oBAAoB,WAAW,KAAK,CAAC,IAAI,EAAE,CAAC;;;;;;;;;AAUlD,SAAgB,2BAA2B,MAIpB;CACrB,MAAM,EAAE,eAAe,qBAAqB;CAC5C,MAAM,WAAW,IAAI,QAAQ,aAAa;CAC1C,MAAM,iBAAiB,KAAK,kBAAkB;CAE9C,MAAM,SAA4B,OAAO,UAAyB,kBAA4B;EAC5F,MAAM,QAA6B,CAAC;EACpC,KAAK,MAAM,SAAS,eAAe;GACjC,MAAM,MAAM,SAAS;GAGrB,MAAM,OAA0B;IAC9B;IACA,KAAK,MAHiB,iBADJ,kBAAkB,GACa,CAAC;GAIpD;GAEA,IAAI,CAAC,IAAI,OAAO,OAAO,cAAc,GACnC,KAAK,cAAc;GAGrB,MAAM,KAAK,IAAI;EACjB;EAEA,OAAO,MAAM,KAAK,SAAS;GACzB,0BAA0B,IAAI;GAC9B,OAAO,wBAAwB,IAAI;EACrC,CAAC;CACH;CAEA,MAAM,aAAkC,OAAO,MAAM,SAAS;EAG5D,OAAO;GAAE,KAAA,MADS,iBADE,KAAK,yBAAyB,IACL,CAAC;GAChC,MAAM;EAAe;CACrC;CAEA,MAAM,oBAAuC,OAAO,MAAM,SAAS;EAEjE,OAAO,MAAM,iBADO,KAAK,kBAAkB,IACH,CAAC;CAC3C;CAEA,MAAM,gBAA+B,OAAO,UAAsB;EAEhE,OAAO,MAAM,iBADO,aAAa,mBAAmB,KACZ,CAAC;CAC3C;CAEA,OAAO;EAAE,MAAM;EAAgB;EAAQ;EAAY;EAAmB;CAAc;AACtF;;;;;AAMA,SAAgB,6BAAgD;CAC9D,QAAQ,UAAyB,kBAA4B;EAC3D,MAAM,WAAyB,CAAC;EAEhC,KAAK,MAAM,SAAS,eAAe;GACjC,MAAM,OAA0B;IAC9B,KAAK,SAAS;IACd,KAAK,IAAI,WAAW,EAAE,EAAE,KAAK,CAAC;GAChC;GACA,0BAA0B,IAAI;GAC9B,SAAS,KAAK,wBAAwB,IAAI,CAAC;EAC7C;EAEA,OAAO,QAAQ,QAAQ,QAAQ;CACjC;AACF;AAEA,MAAa,kBAAkB;CAC7B,YAAY,KAA8B;EACxC,OAAO,kBAAkB,GAAG;CAC9B;CACA,QAAQ,OAA+B;EACrC,OAAO,aAAa,mBAAmB,KAAK;CAC9C;CACA,kBAAkB,MAAgB,MAAoC;EACpE,OAAO,KAAK,yBAAyB,IAAI;CAC3C;CACA,YAAY,MAAgB,MAA8B;EACxD,OAAO,KAAK,kBAAkB,IAAI;CACpC;AACF"}

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

@@ -1,5 +1,4 @@
 const require_constants = require("../../../common/src/constants.js");
-const require_common = require("./common.js");
 //#region packages/transact/src/transactions/app-call.ts
 /**
 * On-completion actions for application transactions.
@@ -63,16 +62,16 @@ function validateAppCallTransaction(appCall) {
 function validateAppCreation(appCall) {
 	const errors = new Array();
 	if (!appCall.approvalProgram || appCall.approvalProgram.length === 0) errors.push({
-		type: require_common.TransactionValidationErrorType.RequiredField,
+		type: 0,
 		data: FIELD_APPROVAL_PROGRAM
 	});
 	if (!appCall.clearStateProgram || appCall.clearStateProgram.length === 0) errors.push({
-		type: require_common.TransactionValidationErrorType.RequiredField,
+		type: 0,
 		data: FIELD_CLEAR_STATE_PROGRAM
 	});
 	const extraPages = appCall.extraProgramPages ?? 0;
 	if (extraPages > 3) errors.push({
-		type: require_common.TransactionValidationErrorType.FieldTooLong,
+		type: 1,
 		data: {
 			field: FIELD_EXTRA_PROGRAM_PAGES,
 			actual: extraPages,
@@ -82,7 +81,7 @@ function validateAppCreation(appCall) {
 	});
 	const maxProgramSize = require_constants.PROGRAM_PAGE_SIZE + extraPages * require_constants.PROGRAM_PAGE_SIZE;
 	if (appCall.approvalProgram && appCall.approvalProgram.length > maxProgramSize) errors.push({
-		type: require_common.TransactionValidationErrorType.FieldTooLong,
+		type: 1,
 		data: {
 			field: FIELD_APPROVAL_PROGRAM,
 			actual: appCall.approvalProgram.length,
@@ -91,7 +90,7 @@ function validateAppCreation(appCall) {
 		}
 	});
 	if (appCall.clearStateProgram && appCall.clearStateProgram.length > maxProgramSize) errors.push({
-		type: require_common.TransactionValidationErrorType.FieldTooLong,
+		type: 1,
 		data: {
 			field: FIELD_CLEAR_STATE_PROGRAM,
 			actual: appCall.clearStateProgram.length,
@@ -101,7 +100,7 @@ function validateAppCreation(appCall) {
 	});
 	const totalProgramSize = (appCall.approvalProgram?.length ?? 0) + (appCall.clearStateProgram?.length ?? 0);
 	if (totalProgramSize > maxProgramSize) errors.push({
-		type: require_common.TransactionValidationErrorType.FieldTooLong,
+		type: 1,
 		data: {
 			field: "Combined approval and clear state programs",
 			actual: totalProgramSize,
@@ -111,7 +110,7 @@ function validateAppCreation(appCall) {
 	});
 	if (appCall.globalStateSchema) {
 		if (appCall.globalStateSchema.numUints + appCall.globalStateSchema.numByteSlices > 64) errors.push({
-			type: require_common.TransactionValidationErrorType.FieldTooLong,
+			type: 1,
 			data: {
 				field: FIELD_GLOBAL_STATE_SCHEMA,
 				actual: appCall.globalStateSchema.numUints + appCall.globalStateSchema.numByteSlices,
@@ -122,7 +121,7 @@ function validateAppCreation(appCall) {
 	}
 	if (appCall.localStateSchema) {
 		if (appCall.localStateSchema.numUints + appCall.localStateSchema.numByteSlices > 16) errors.push({
-			type: require_common.TransactionValidationErrorType.FieldTooLong,
+			type: 1,
 			data: {
 				field: FIELD_LOCAL_STATE_SCHEMA,
 				actual: appCall.localStateSchema.numUints + appCall.localStateSchema.numByteSlices,
@@ -138,26 +137,26 @@ function validateAppCreation(appCall) {
 */
 function validateAppOperation(appCall) {
 	const errors = new Array();
-	if (appCall.onComplete === OnApplicationComplete.UpdateApplication) {
+	if (appCall.onComplete === 4) {
 		if (!appCall.approvalProgram || appCall.approvalProgram.length === 0) errors.push({
-			type: require_common.TransactionValidationErrorType.RequiredField,
+			type: 0,
 			data: FIELD_APPROVAL_PROGRAM
 		});
 		if (!appCall.clearStateProgram || appCall.clearStateProgram.length === 0) errors.push({
-			type: require_common.TransactionValidationErrorType.RequiredField,
+			type: 0,
 			data: FIELD_CLEAR_STATE_PROGRAM
 		});
 	}
 	if (appCall.globalStateSchema !== void 0) errors.push({
-		type: require_common.TransactionValidationErrorType.ImmutableField,
+		type: 2,
 		data: FIELD_GLOBAL_STATE_SCHEMA
 	});
 	if (appCall.localStateSchema !== void 0) errors.push({
-		type: require_common.TransactionValidationErrorType.ImmutableField,
+		type: 2,
 		data: FIELD_LOCAL_STATE_SCHEMA
 	});
 	if (appCall.extraProgramPages !== void 0) errors.push({
-		type: require_common.TransactionValidationErrorType.ImmutableField,
+		type: 2,
 		data: FIELD_EXTRA_PROGRAM_PAGES
 	});
 	return errors;
@@ -169,7 +168,7 @@ function validateAppCommonFields(appCall) {
 	const errors = new Array();
 	if (appCall.args) {
 		if (appCall.args.length > 16) errors.push({
-			type: require_common.TransactionValidationErrorType.FieldTooLong,
+			type: 1,
 			data: {
 				field: FIELD_ARGS,
 				actual: appCall.args.length,
@@ -179,7 +178,7 @@ function validateAppCommonFields(appCall) {
 		});
 		const totalArgsSize = appCall.args.reduce((sum, arg) => sum + arg.length, 0);
 		if (totalArgsSize > 2048) errors.push({
-			type: require_common.TransactionValidationErrorType.FieldTooLong,
+			type: 1,
 			data: {
 				field: "Args total size",
 				actual: totalArgsSize,
@@ -189,7 +188,7 @@ function validateAppCommonFields(appCall) {
 		});
 	}
 	if (appCall.accountReferences && appCall.accountReferences.length > 8) errors.push({
-		type: require_common.TransactionValidationErrorType.FieldTooLong,
+		type: 1,
 		data: {
 			field: "Account references",
 			actual: appCall.accountReferences.length,
@@ -198,7 +197,7 @@ function validateAppCommonFields(appCall) {
 		}
 	});
 	if (appCall.appReferences && appCall.appReferences.length > 8) errors.push({
-		type: require_common.TransactionValidationErrorType.FieldTooLong,
+		type: 1,
 		data: {
 			field: "App references",
 			actual: appCall.appReferences.length,
@@ -207,7 +206,7 @@ function validateAppCommonFields(appCall) {
 		}
 	});
 	if (appCall.assetReferences && appCall.assetReferences.length > 8) errors.push({
-		type: require_common.TransactionValidationErrorType.FieldTooLong,
+		type: 1,
 		data: {
 			field: "Asset references",
 			actual: appCall.assetReferences.length,
@@ -217,7 +216,7 @@ function validateAppCommonFields(appCall) {
 	});
 	if (appCall.boxReferences) {
 		if (appCall.boxReferences.length > 8) errors.push({
-			type: require_common.TransactionValidationErrorType.FieldTooLong,
+			type: 1,
 			data: {
 				field: "Box references",
 				actual: appCall.boxReferences.length,
@@ -227,13 +226,13 @@ function validateAppCommonFields(appCall) {
 		});
 		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: require_common.TransactionValidationErrorType.ArbitraryConstraint,
+			type: 4,
 			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 > 8) errors.push({
-		type: require_common.TransactionValidationErrorType.FieldTooLong,
+		type: 1,
 		data: {
 			field: "Total references",
 			actual: totalReferences,

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

@@ -1 +1 @@
-{"version":3,"file":"app-call.js","names":["TransactionValidationErrorType","PROGRAM_PAGE_SIZE","MAX_ARGS_SIZE"],"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.js","names":["PROGRAM_PAGE_SIZE","MAX_ARGS_SIZE"],"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/app-call.mjs

@@ -1,5 +1,4 @@
 import { MAX_ARGS_SIZE, 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.
@@ -63,16 +62,16 @@ function validateAppCallTransaction(appCall) {
 function validateAppCreation(appCall) {
 	const errors = new Array();
 	if (!appCall.approvalProgram || appCall.approvalProgram.length === 0) errors.push({
-		type: TransactionValidationErrorType.RequiredField,
+		type: 0,
 		data: FIELD_APPROVAL_PROGRAM
 	});
 	if (!appCall.clearStateProgram || appCall.clearStateProgram.length === 0) errors.push({
-		type: TransactionValidationErrorType.RequiredField,
+		type: 0,
 		data: FIELD_CLEAR_STATE_PROGRAM
 	});
 	const extraPages = appCall.extraProgramPages ?? 0;
 	if (extraPages > 3) errors.push({
-		type: TransactionValidationErrorType.FieldTooLong,
+		type: 1,
 		data: {
 			field: FIELD_EXTRA_PROGRAM_PAGES,
 			actual: extraPages,
@@ -82,7 +81,7 @@ function validateAppCreation(appCall) {
 	});
 	const maxProgramSize = PROGRAM_PAGE_SIZE + extraPages * PROGRAM_PAGE_SIZE;
 	if (appCall.approvalProgram && appCall.approvalProgram.length > maxProgramSize) errors.push({
-		type: TransactionValidationErrorType.FieldTooLong,
+		type: 1,
 		data: {
 			field: FIELD_APPROVAL_PROGRAM,
 			actual: appCall.approvalProgram.length,
@@ -91,7 +90,7 @@ function validateAppCreation(appCall) {
 		}
 	});
 	if (appCall.clearStateProgram && appCall.clearStateProgram.length > maxProgramSize) errors.push({
-		type: TransactionValidationErrorType.FieldTooLong,
+		type: 1,
 		data: {
 			field: FIELD_CLEAR_STATE_PROGRAM,
 			actual: appCall.clearStateProgram.length,
@@ -101,7 +100,7 @@ function validateAppCreation(appCall) {
 	});
 	const totalProgramSize = (appCall.approvalProgram?.length ?? 0) + (appCall.clearStateProgram?.length ?? 0);
 	if (totalProgramSize > maxProgramSize) errors.push({
-		type: TransactionValidationErrorType.FieldTooLong,
+		type: 1,
 		data: {
 			field: "Combined approval and clear state programs",
 			actual: totalProgramSize,
@@ -111,7 +110,7 @@ function validateAppCreation(appCall) {
 	});
 	if (appCall.globalStateSchema) {
 		if (appCall.globalStateSchema.numUints + appCall.globalStateSchema.numByteSlices > 64) errors.push({
-			type: TransactionValidationErrorType.FieldTooLong,
+			type: 1,
 			data: {
 				field: FIELD_GLOBAL_STATE_SCHEMA,
 				actual: appCall.globalStateSchema.numUints + appCall.globalStateSchema.numByteSlices,
@@ -122,7 +121,7 @@ function validateAppCreation(appCall) {
 	}
 	if (appCall.localStateSchema) {
 		if (appCall.localStateSchema.numUints + appCall.localStateSchema.numByteSlices > 16) errors.push({
-			type: TransactionValidationErrorType.FieldTooLong,
+			type: 1,
 			data: {
 				field: FIELD_LOCAL_STATE_SCHEMA,
 				actual: appCall.localStateSchema.numUints + appCall.localStateSchema.numByteSlices,
@@ -138,26 +137,26 @@ function validateAppCreation(appCall) {
 */
 function validateAppOperation(appCall) {
 	const errors = new Array();
-	if (appCall.onComplete === OnApplicationComplete.UpdateApplication) {
+	if (appCall.onComplete === 4) {
 		if (!appCall.approvalProgram || appCall.approvalProgram.length === 0) errors.push({
-			type: TransactionValidationErrorType.RequiredField,
+			type: 0,
 			data: FIELD_APPROVAL_PROGRAM
 		});
 		if (!appCall.clearStateProgram || appCall.clearStateProgram.length === 0) errors.push({
-			type: TransactionValidationErrorType.RequiredField,
+			type: 0,
 			data: FIELD_CLEAR_STATE_PROGRAM
 		});
 	}
 	if (appCall.globalStateSchema !== void 0) errors.push({
-		type: TransactionValidationErrorType.ImmutableField,
+		type: 2,
 		data: FIELD_GLOBAL_STATE_SCHEMA
 	});
 	if (appCall.localStateSchema !== void 0) errors.push({
-		type: TransactionValidationErrorType.ImmutableField,
+		type: 2,
 		data: FIELD_LOCAL_STATE_SCHEMA
 	});
 	if (appCall.extraProgramPages !== void 0) errors.push({
-		type: TransactionValidationErrorType.ImmutableField,
+		type: 2,
 		data: FIELD_EXTRA_PROGRAM_PAGES
 	});
 	return errors;
@@ -169,7 +168,7 @@ function validateAppCommonFields(appCall) {
 	const errors = new Array();
 	if (appCall.args) {
 		if (appCall.args.length > 16) errors.push({
-			type: TransactionValidationErrorType.FieldTooLong,
+			type: 1,
 			data: {
 				field: FIELD_ARGS,
 				actual: appCall.args.length,
@@ -179,7 +178,7 @@ function validateAppCommonFields(appCall) {
 		});
 		const totalArgsSize = appCall.args.reduce((sum, arg) => sum + arg.length, 0);
 		if (totalArgsSize > 2048) errors.push({
-			type: TransactionValidationErrorType.FieldTooLong,
+			type: 1,
 			data: {
 				field: "Args total size",
 				actual: totalArgsSize,
@@ -189,7 +188,7 @@ function validateAppCommonFields(appCall) {
 		});
 	}
 	if (appCall.accountReferences && appCall.accountReferences.length > 8) errors.push({
-		type: TransactionValidationErrorType.FieldTooLong,
+		type: 1,
 		data: {
 			field: "Account references",
 			actual: appCall.accountReferences.length,
@@ -198,7 +197,7 @@ function validateAppCommonFields(appCall) {
 		}
 	});
 	if (appCall.appReferences && appCall.appReferences.length > 8) errors.push({
-		type: TransactionValidationErrorType.FieldTooLong,
+		type: 1,
 		data: {
 			field: "App references",
 			actual: appCall.appReferences.length,
@@ -207,7 +206,7 @@ function validateAppCommonFields(appCall) {
 		}
 	});
 	if (appCall.assetReferences && appCall.assetReferences.length > 8) errors.push({
-		type: TransactionValidationErrorType.FieldTooLong,
+		type: 1,
 		data: {
 			field: "Asset references",
 			actual: appCall.assetReferences.length,
@@ -217,7 +216,7 @@ function validateAppCommonFields(appCall) {
 	});
 	if (appCall.boxReferences) {
 		if (appCall.boxReferences.length > 8) errors.push({
-			type: TransactionValidationErrorType.FieldTooLong,
+			type: 1,
 			data: {
 				field: "Box references",
 				actual: appCall.boxReferences.length,
@@ -227,13 +226,13 @@ function validateAppCommonFields(appCall) {
 		});
 		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,
+			type: 4,
 			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 > 8) errors.push({
-		type: TransactionValidationErrorType.FieldTooLong,
+		type: 1,
 		data: {
 			field: "Total references",
 			actual: totalReferences,

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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"}