@algorandfoundation/algokit-utils 10.0.0-alpha.3 → 10.0.0-alpha.32

package/packages/transact/src/signer.js

@@ -28,10 +28,16 @@ function generateAddressWithSigners(args) {
 			if (!txn.sender.equals(sendingAddress)) stxn.authAddress = authAddr;
 			stxns.push(stxn);
 		}
-		return stxns.map(require_signed_transaction.encodeSignedTransaction);
+		return stxns.map((stxn) => {
+			require_signed_transaction.validateSignedTransaction(stxn);
+			return require_signed_transaction.encodeSignedTransaction(stxn);
+		});
 	};
 	const lsigSigner = async (lsig, msig) => {
-		return await rawEd25519Signer(lsig.bytesToSignForDelegation(msig));
+		return {
+			sig: await rawEd25519Signer(lsig.bytesToSignForDelegation(msig)),
+			addr: sendingAddress
+		};
 	};
 	const programDataSigner = async (data, lsig) => {
 		return await rawEd25519Signer(lsig.programDataToSign(data));
@@ -59,6 +65,7 @@ function makeEmptyTransactionSigner() {
 				txn: txnGroup[index],
 				sig: new Uint8Array(64).fill(0)
 			};
+			require_signed_transaction.validateSignedTransaction(stxn);
 			unsigned.push(require_signed_transaction.encodeSignedTransaction(stxn));
 		}
 		return Promise.resolve(unsigned);

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

@@ -1 +1 @@
-{"version":3,"file":"signer.js","names":["Address","signer: TransactionSigner","stxns: SignedTransaction[]","stxn: SignedTransaction","encodeTransaction","encodeSignedTransaction","lsigSigner: DelegatedLsigSigner","programDataSigner: ProgramDataSigner","mxBytesSigner: MxBytesSigner","concatArrays","unsigned: Uint8Array[]"],"sources":["../../../../packages/transact/src/signer.ts"],"sourcesContent":["import { Address, Addressable, concatArrays, Expand, ReadableAddress } from '@algorandfoundation/algokit-common'\nimport { encodeTransaction, Transaction } from './transactions/transaction'\nimport { DelegatedLsigSigner, ProgramDataSigner } from './logicsig'\nimport { encodeSignedTransaction, SignedTransaction } from './transactions/signed-transaction'\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: (bytesToSign: Uint8Array) => Promise<Uint8Array>\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(encodeSignedTransaction)\n  }\n\n  const lsigSigner: DelegatedLsigSigner = async (lsig, msig) => {\n    const bytesToSign = lsig.bytesToSignForDelegation(msig)\n    return await rawEd25519Signer(bytesToSign)\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      unsigned.push(encodeSignedTransaction(stxn))\n    }\n\n    return Promise.resolve(unsigned)\n  }\n}\n"],"mappings":";;;;;;AAmCA,MAAM,oBAAoB,WAAW,KAAK,CAAC,IAAI,GAAG,CAAC;;;;;;;;;AAUnD,SAAgB,2BAA2B,MAIpB;CACrB,MAAM,EAAE,eAAe,qBAAqB;CAC5C,MAAM,WAAW,IAAIA,wBAAQ,cAAc;CAC3C,MAAM,iBAAiB,KAAK,kBAAkB;CAE9C,MAAMC,SAA4B,OAAO,UAAyB,kBAA4B;EAC5F,MAAMC,QAA6B,EAAE;AACrC,OAAK,MAAM,SAAS,eAAe;GACjC,MAAM,MAAM,SAAS;GAGrB,MAAMC,OAA0B;IAC9B;IACA,KAHgB,MAAM,iBADJC,sCAAkB,IAAI,CACW;IAIpD;AAED,OAAI,CAAC,IAAI,OAAO,OAAO,eAAe,CACpC,MAAK,cAAc;AAGrB,SAAM,KAAK,KAAK;;AAGlB,SAAO,MAAM,IAAIC,mDAAwB;;CAG3C,MAAMC,aAAkC,OAAO,MAAM,SAAS;AAE5D,SAAO,MAAM,iBADO,KAAK,yBAAyB,KAAK,CACb;;CAG5C,MAAMC,oBAAuC,OAAO,MAAM,SAAS;AAEjE,SAAO,MAAM,iBADO,KAAK,kBAAkB,KAAK,CACN;;CAG5C,MAAMC,gBAA+B,OAAO,UAAsB;AAEhE,SAAO,MAAM,iBADOC,2BAAa,mBAAmB,MAAM,CAChB;;AAG5C,QAAO;EAAE,MAAM;EAAgB;EAAQ;EAAY;EAAmB;EAAe;;;;;;AAOvF,SAAgB,6BAAgD;AAC9D,SAAQ,UAAyB,kBAA4B;EAC3D,MAAMC,WAAyB,EAAE;AAEjC,OAAK,MAAM,SAAS,eAAe;GACjC,MAAMP,OAA0B;IAC9B,KAAK,SAAS;IACd,KAAK,IAAI,WAAW,GAAG,CAAC,KAAK,EAAE;IAChC;AACD,YAAS,KAAKE,mDAAwB,KAAK,CAAC;;AAG9C,SAAO,QAAQ,QAAQ,SAAS"}
+{"version":3,"file":"signer.js","names":["Address","signer: TransactionSigner","stxns: SignedTransaction[]","stxn: SignedTransaction","encodeTransaction","encodeSignedTransaction","lsigSigner: DelegatedLsigSigner","programDataSigner: ProgramDataSigner","mxBytesSigner: MxBytesSigner","concatArrays","unsigned: Uint8Array[]"],"sources":["../../../../packages/transact/src/signer.ts"],"sourcesContent":["import { Address, Addressable, concatArrays, Expand, ReadableAddress } from '@algorandfoundation/algokit-common'\nimport { DelegatedLsigSigner, ProgramDataSigner } from './logicsig'\nimport { encodeSignedTransaction, SignedTransaction, validateSignedTransaction } from './transactions/signed-transaction'\nimport { encodeTransaction, Transaction } from './transactions/transaction'\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: (bytesToSign: Uint8Array) => Promise<Uint8Array>\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"],"mappings":";;;;;;AAmCA,MAAM,oBAAoB,WAAW,KAAK,CAAC,IAAI,GAAG,CAAC;;;;;;;;;AAUnD,SAAgB,2BAA2B,MAIpB;CACrB,MAAM,EAAE,eAAe,qBAAqB;CAC5C,MAAM,WAAW,IAAIA,wBAAQ,cAAc;CAC3C,MAAM,iBAAiB,KAAK,kBAAkB;CAE9C,MAAMC,SAA4B,OAAO,UAAyB,kBAA4B;EAC5F,MAAMC,QAA6B,EAAE;AACrC,OAAK,MAAM,SAAS,eAAe;GACjC,MAAM,MAAM,SAAS;GAGrB,MAAMC,OAA0B;IAC9B;IACA,KAHgB,MAAM,iBADJC,sCAAkB,IAAI,CACW;IAIpD;AAED,OAAI,CAAC,IAAI,OAAO,OAAO,eAAe,CACpC,MAAK,cAAc;AAGrB,SAAM,KAAK,KAAK;;AAGlB,SAAO,MAAM,KAAK,SAAS;AACzB,wDAA0B,KAAK;AAC/B,UAAOC,mDAAwB,KAAK;IACpC;;CAGJ,MAAMC,aAAkC,OAAO,MAAM,SAAS;AAG5D,SAAO;GAAE,KADG,MAAM,iBADE,KAAK,yBAAyB,KAAK,CACR;GACjC,MAAM;GAAgB;;CAGtC,MAAMC,oBAAuC,OAAO,MAAM,SAAS;AAEjE,SAAO,MAAM,iBADO,KAAK,kBAAkB,KAAK,CACN;;CAG5C,MAAMC,gBAA+B,OAAO,UAAsB;AAEhE,SAAO,MAAM,iBADOC,2BAAa,mBAAmB,MAAM,CAChB;;AAG5C,QAAO;EAAE,MAAM;EAAgB;EAAQ;EAAY;EAAmB;EAAe;;;;;;AAOvF,SAAgB,6BAAgD;AAC9D,SAAQ,UAAyB,kBAA4B;EAC3D,MAAMC,WAAyB,EAAE;AAEjC,OAAK,MAAM,SAAS,eAAe;GACjC,MAAMP,OAA0B;IAC9B,KAAK,SAAS;IACd,KAAK,IAAI,WAAW,GAAG,CAAC,KAAK,EAAE;IAChC;AACD,wDAA0B,KAAK;AAC/B,YAAS,KAAKE,mDAAwB,KAAK,CAAC;;AAG9C,SAAO,QAAQ,QAAQ,SAAS"}

package/packages/transact/src/signer.mjs

@@ -1,7 +1,7 @@
 import { concatArrays } from "../../common/src/array.mjs";
 import { Address } from "../../common/src/address.mjs";
 import { encodeTransaction } from "./transactions/transaction.mjs";
-import { encodeSignedTransaction } from "./transactions/signed-transaction.mjs";
+import { encodeSignedTransaction, validateSignedTransaction } from "./transactions/signed-transaction.mjs";
 
 //#region packages/transact/src/signer.ts
 const SIGN_BYTES_PREFIX = Uint8Array.from([77, 88]);
@@ -28,10 +28,16 @@ function generateAddressWithSigners(args) {
 			if (!txn.sender.equals(sendingAddress)) stxn.authAddress = authAddr;
 			stxns.push(stxn);
 		}
-		return stxns.map(encodeSignedTransaction);
+		return stxns.map((stxn) => {
+			validateSignedTransaction(stxn);
+			return encodeSignedTransaction(stxn);
+		});
 	};
 	const lsigSigner = async (lsig, msig) => {
-		return await rawEd25519Signer(lsig.bytesToSignForDelegation(msig));
+		return {
+			sig: await rawEd25519Signer(lsig.bytesToSignForDelegation(msig)),
+			addr: sendingAddress
+		};
 	};
 	const programDataSigner = async (data, lsig) => {
 		return await rawEd25519Signer(lsig.programDataToSign(data));
@@ -59,6 +65,7 @@ function makeEmptyTransactionSigner() {
 				txn: txnGroup[index],
 				sig: new Uint8Array(64).fill(0)
 			};
+			validateSignedTransaction(stxn);
 			unsigned.push(encodeSignedTransaction(stxn));
 		}
 		return Promise.resolve(unsigned);

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

@@ -1 +1 @@
-{"version":3,"file":"signer.mjs","names":["signer: TransactionSigner","stxns: SignedTransaction[]","stxn: SignedTransaction","lsigSigner: DelegatedLsigSigner","programDataSigner: ProgramDataSigner","mxBytesSigner: MxBytesSigner","unsigned: Uint8Array[]"],"sources":["../../../../packages/transact/src/signer.ts"],"sourcesContent":["import { Address, Addressable, concatArrays, Expand, ReadableAddress } from '@algorandfoundation/algokit-common'\nimport { encodeTransaction, Transaction } from './transactions/transaction'\nimport { DelegatedLsigSigner, ProgramDataSigner } from './logicsig'\nimport { encodeSignedTransaction, SignedTransaction } from './transactions/signed-transaction'\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: (bytesToSign: Uint8Array) => Promise<Uint8Array>\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(encodeSignedTransaction)\n  }\n\n  const lsigSigner: DelegatedLsigSigner = async (lsig, msig) => {\n    const bytesToSign = lsig.bytesToSignForDelegation(msig)\n    return await rawEd25519Signer(bytesToSign)\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      unsigned.push(encodeSignedTransaction(stxn))\n    }\n\n    return Promise.resolve(unsigned)\n  }\n}\n"],"mappings":";;;;;;AAmCA,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,MAAMA,SAA4B,OAAO,UAAyB,kBAA4B;EAC5F,MAAMC,QAA6B,EAAE;AACrC,OAAK,MAAM,SAAS,eAAe;GACjC,MAAM,MAAM,SAAS;GAGrB,MAAMC,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,IAAI,wBAAwB;;CAG3C,MAAMC,aAAkC,OAAO,MAAM,SAAS;AAE5D,SAAO,MAAM,iBADO,KAAK,yBAAyB,KAAK,CACb;;CAG5C,MAAMC,oBAAuC,OAAO,MAAM,SAAS;AAEjE,SAAO,MAAM,iBADO,KAAK,kBAAkB,KAAK,CACN;;CAG5C,MAAMC,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,MAAMC,WAAyB,EAAE;AAEjC,OAAK,MAAM,SAAS,eAAe;GACjC,MAAMJ,OAA0B;IAC9B,KAAK,SAAS;IACd,KAAK,IAAI,WAAW,GAAG,CAAC,KAAK,EAAE;IAChC;AACD,YAAS,KAAK,wBAAwB,KAAK,CAAC;;AAG9C,SAAO,QAAQ,QAAQ,SAAS"}
+{"version":3,"file":"signer.mjs","names":["signer: TransactionSigner","stxns: SignedTransaction[]","stxn: SignedTransaction","lsigSigner: DelegatedLsigSigner","programDataSigner: ProgramDataSigner","mxBytesSigner: MxBytesSigner","unsigned: Uint8Array[]"],"sources":["../../../../packages/transact/src/signer.ts"],"sourcesContent":["import { Address, Addressable, concatArrays, Expand, ReadableAddress } from '@algorandfoundation/algokit-common'\nimport { DelegatedLsigSigner, ProgramDataSigner } from './logicsig'\nimport { encodeSignedTransaction, SignedTransaction, validateSignedTransaction } from './transactions/signed-transaction'\nimport { encodeTransaction, Transaction } from './transactions/transaction'\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: (bytesToSign: Uint8Array) => Promise<Uint8Array>\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"],"mappings":";;;;;;AAmCA,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,MAAMA,SAA4B,OAAO,UAAyB,kBAA4B;EAC5F,MAAMC,QAA6B,EAAE;AACrC,OAAK,MAAM,SAAS,eAAe;GACjC,MAAM,MAAM,SAAS;GAGrB,MAAMC,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,MAAMC,aAAkC,OAAO,MAAM,SAAS;AAG5D,SAAO;GAAE,KADG,MAAM,iBADE,KAAK,yBAAyB,KAAK,CACR;GACjC,MAAM;GAAgB;;CAGtC,MAAMC,oBAAuC,OAAO,MAAM,SAAS;AAEjE,SAAO,MAAM,iBADO,KAAK,kBAAkB,KAAK,CACN;;CAG5C,MAAMC,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,MAAMC,WAAyB,EAAE;AAEjC,OAAK,MAAM,SAAS,eAAe;GACjC,MAAMJ,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"}

package/packages/transact/src/transactions/app-call.d.ts

@@ -1,5 +1,4 @@
 import { Address } from "../../../common/src/address.js";
-import { TransactionValidationError } from "./common.js";
 
 //#region packages/transact/src/transactions/app-call.d.ts
 
@@ -88,10 +87,10 @@ type AppCallTransactionFields = {
   /**
    * Resources accessed by the application
    */
-  accessReferences?: AccessReference[];
+  accessReferences?: ResourceReference[];
   /**
-   * The lowest application version for which this transaction should immediately fail. 0 indicates that no version check should be performed.
-   */
+   * 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.
+   * */
   rejectVersion?: number;
 };
 /**
@@ -169,7 +168,7 @@ type BoxReference = {
 /**
  * Names a single resource reference. Only one of the fields should be set.
  */
-interface AccessReference {
+type ResourceReference = {
   /** Any account addresses whose balance record is accessible by the executing ApprovalProgram or ClearStateProgram. */
   address?: Address;
   /** Application ID whose GlobalState may be read by the executing ApprovalProgram or ClearStateProgram. */
@@ -182,28 +181,24 @@ interface AccessReference {
   locals?: LocalsReference;
   /** Defines a box by its name and the application ID it belongs to. */
   box?: BoxReference;
-}
+};
 /**
  * A grouping of the asset index and address of the account
  */
-interface HoldingReference {
+type HoldingReference = {
   /** The asset index of the holding */
   assetId: bigint;
   /** The address of the account holding the asset */
   address: Address;
-}
+};
 /** A grouping of the application index and address of the account
  */
-interface LocalsReference {
+type LocalsReference = {
   /** The application index of the local state */
   appId: bigint;
   /** The address of the account holding the local state */
   address: Address;
-}
-/**
- * Validate app call transaction fields
- */
-declare function validateAppCallTransaction(appCall: AppCallTransactionFields): TransactionValidationError[];
+};
 //#endregion
-export { AccessReference, AppCallTransactionFields, BoxReference, HoldingReference, LocalsReference, OnApplicationComplete, StateSchema, validateAppCallTransaction };
+export { AppCallTransactionFields, BoxReference, HoldingReference, LocalsReference, OnApplicationComplete, ResourceReference, StateSchema };
 //# sourceMappingURL=app-call.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"app-call.js","names":["TransactionValidationErrorType","MAX_EXTRA_PROGRAM_PAGES","PROGRAM_PAGE_SIZE","MAX_GLOBAL_STATE_KEYS","MAX_LOCAL_STATE_KEYS","MAX_APP_ARGS","MAX_ARGS_SIZE","MAX_ACCOUNT_REFERENCES","MAX_APP_REFERENCES","MAX_ASSET_REFERENCES","MAX_BOX_REFERENCES","MAX_OVERALL_REFERENCES"],"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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"}
+{"version":3,"file":"app-call.js","names":["TransactionValidationErrorType","MAX_EXTRA_PROGRAM_PAGES","PROGRAM_PAGE_SIZE","MAX_GLOBAL_STATE_KEYS","MAX_LOCAL_STATE_KEYS","MAX_APP_ARGS","MAX_ARGS_SIZE","MAX_ACCOUNT_REFERENCES","MAX_APP_REFERENCES","MAX_ASSET_REFERENCES","MAX_BOX_REFERENCES","MAX_OVERALL_REFERENCES"],"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":";;;;;;;;;AA8HA,IAAY,0EAAL;;;;;AAKL;;;;;AAKA;;;;;AAKA;;;;;;AAMA;;;;;AAKA;;;;;;AAMA;;;AA+EF,MAAM,aAAa;AACnB,MAAM,yBAAyB;AAC/B,MAAM,4BAA4B;AAClC,MAAM,4BAA4B;AAClC,MAAM,2BAA2B;AACjC,MAAM,4BAA4B;;;;AAKlC,SAAgB,2BAA2B,SAAiE;CAC1G,MAAM,SAAS,IAAI,OAAmC;AAEtD,KAAI,QAAQ,UAAU,GAEpB,QAAO,KAAK,GAAG,oBAAoB,QAAQ,CAAC;KAG5C,QAAO,KAAK,GAAG,qBAAqB,QAAQ,CAAC;AAI/C,QAAO,KAAK,GAAG,wBAAwB,QAAQ,CAAC;AAEhD,QAAO;;;;;AAMT,SAAS,oBAAoB,SAAiE;CAC5F,MAAM,SAAS,IAAI,OAAmC;AAEtD,KAAI,CAAC,QAAQ,mBAAmB,QAAQ,gBAAgB,WAAW,EACjE,QAAO,KAAK;EAAE,MAAMA,8CAA+B;EAAe,MAAM;EAAwB,CAAC;AAGnG,KAAI,CAAC,QAAQ,qBAAqB,QAAQ,kBAAkB,WAAW,EACrE,QAAO,KAAK;EAAE,MAAMA,8CAA+B;EAAe,MAAM;EAA2B,CAAC;CAGtG,MAAM,aAAa,QAAQ,qBAAqB;AAChD,KAAI,aAAaC,0CACf,QAAO,KAAK;EACV,MAAMD,8CAA+B;EACrC,MAAM;GAAE,OAAO;GAA2B,QAAQ;GAAY,KAAKC;GAAyB,MAAM;GAAS;EAC5G,CAAC;CAGJ,MAAM,iBAAiBC,sCAAoB,aAAaA;AAExD,KAAI,QAAQ,mBAAmB,QAAQ,gBAAgB,SAAS,eAC9D,QAAO,KAAK;EACV,MAAMF,8CAA+B;EACrC,MAAM;GAAE,OAAO;GAAwB,QAAQ,QAAQ,gBAAgB;GAAQ,KAAK;GAAgB,MAAM;GAAS;EACpH,CAAC;AAGJ,KAAI,QAAQ,qBAAqB,QAAQ,kBAAkB,SAAS,eAClE,QAAO,KAAK;EACV,MAAMA,8CAA+B;EACrC,MAAM;GAAE,OAAO;GAA2B,QAAQ,QAAQ,kBAAkB;GAAQ,KAAK;GAAgB,MAAM;GAAS;EACzH,CAAC;CAGJ,MAAM,oBAAoB,QAAQ,iBAAiB,UAAU,MAAM,QAAQ,mBAAmB,UAAU;AACxG,KAAI,mBAAmB,eACrB,QAAO,KAAK;EACV,MAAMA,8CAA+B;EACrC,MAAM;GAAE,OAAO;GAA8C,QAAQ;GAAkB,KAAK;GAAgB,MAAM;GAAS;EAC5H,CAAC;AAGJ,KAAI,QAAQ,mBAEV;MADkB,QAAQ,kBAAkB,WAAW,QAAQ,kBAAkB,gBACjEG,wCACd,QAAO,KAAK;GACV,MAAMH,8CAA+B;GACrC,MAAM;IACJ,OAAO;IACP,QAAQ,QAAQ,kBAAkB,WAAW,QAAQ,kBAAkB;IACvE,KAAKG;IACL,MAAM;IACP;GACF,CAAC;;AAIN,KAAI,QAAQ,kBAEV;MADkB,QAAQ,iBAAiB,WAAW,QAAQ,iBAAiB,gBAC/DC,uCACd,QAAO,KAAK;GACV,MAAMJ,8CAA+B;GACrC,MAAM;IACJ,OAAO;IACP,QAAQ,QAAQ,iBAAiB,WAAW,QAAQ,iBAAiB;IACrE,KAAKI;IACL,MAAM;IACP;GACF,CAAC;;AAIN,QAAO;;;;;AAMT,SAAS,qBAAqB,SAAiE;CAC7F,MAAM,SAAS,IAAI,OAAmC;AAEtD,KAAI,QAAQ,eAAe,sBAAsB,mBAAmB;AAClE,MAAI,CAAC,QAAQ,mBAAmB,QAAQ,gBAAgB,WAAW,EACjE,QAAO,KAAK;GAAE,MAAMJ,8CAA+B;GAAe,MAAM;GAAwB,CAAC;AAEnG,MAAI,CAAC,QAAQ,qBAAqB,QAAQ,kBAAkB,WAAW,EACrE,QAAO,KAAK;GAAE,MAAMA,8CAA+B;GAAe,MAAM;GAA2B,CAAC;;AAKxG,KAAI,QAAQ,sBAAsB,OAChC,QAAO,KAAK;EAAE,MAAMA,8CAA+B;EAAgB,MAAM;EAA2B,CAAC;AAEvG,KAAI,QAAQ,qBAAqB,OAC/B,QAAO,KAAK;EAAE,MAAMA,8CAA+B;EAAgB,MAAM;EAA0B,CAAC;AAEtG,KAAI,QAAQ,sBAAsB,OAChC,QAAO,KAAK;EAAE,MAAMA,8CAA+B;EAAgB,MAAM;EAA2B,CAAC;AAGvG,QAAO;;;;;AAMT,SAAS,wBAAwB,SAAiE;CAChG,MAAM,SAAS,IAAI,OAAmC;AAEtD,KAAI,QAAQ,MAAM;AAChB,MAAI,QAAQ,KAAK,SAASK,+BACxB,QAAO,KAAK;GACV,MAAML,8CAA+B;GACrC,MAAM;IAAE,OAAO;IAAY,QAAQ,QAAQ,KAAK;IAAQ,KAAKK;IAAc,MAAM;IAAa;GAC/F,CAAC;EAGJ,MAAM,gBAAgB,QAAQ,KAAK,QAAQ,KAAK,QAAQ,MAAM,IAAI,QAAQ,EAAE;AAC5E,MAAI,gBAAgBC,gCAClB,QAAO,KAAK;GACV,MAAMN,8CAA+B;GACrC,MAAM;IAAE,OAAO;IAAmB,QAAQ;IAAe,KAAKM;IAAe,MAAM;IAAS;GAC7F,CAAC;;AAIN,KAAI,QAAQ,qBAAqB,QAAQ,kBAAkB,SAASC,yCAClE,QAAO,KAAK;EACV,MAAMP,8CAA+B;EACrC,MAAM;GAAE,OAAO;GAAsB,QAAQ,QAAQ,kBAAkB;GAAQ,KAAKO;GAAwB,MAAM;GAAQ;EAC3H,CAAC;AAGJ,KAAI,QAAQ,iBAAiB,QAAQ,cAAc,SAASC,qCAC1D,QAAO,KAAK;EACV,MAAMR,8CAA+B;EACrC,MAAM;GAAE,OAAO;GAAkB,QAAQ,QAAQ,cAAc;GAAQ,KAAKQ;GAAoB,MAAM;GAAQ;EAC/G,CAAC;AAGJ,KAAI,QAAQ,mBAAmB,QAAQ,gBAAgB,SAASC,uCAC9D,QAAO,KAAK;EACV,MAAMT,8CAA+B;EACrC,MAAM;GAAE,OAAO;GAAoB,QAAQ,QAAQ,gBAAgB;GAAQ,KAAKS;GAAsB,MAAM;GAAQ;EACrH,CAAC;AAIJ,KAAI,QAAQ,eAAe;AACzB,MAAI,QAAQ,cAAc,SAASC,qCACjC,QAAO,KAAK;GACV,MAAMV,8CAA+B;GACrC,MAAM;IAAE,OAAO;IAAkB,QAAQ,QAAQ,cAAc;IAAQ,KAAKU;IAAoB,MAAM;IAAQ;GAC/G,CAAC;EAIJ,MAAM,UAAU,QAAQ,iBAAiB,EAAE;AAC3C,OAAK,MAAM,UAAU,QAAQ,cAC3B,KAAI,OAAO,UAAU,MAAM,OAAO,UAAU,QAAQ,SAAS,CAAC,QAAQ,SAAS,OAAO,MAAM,CAC1F,QAAO,KAAK;GACV,MAAMV,8CAA+B;GACrC,MAAM,4BAA4B,OAAO,MAAM;GAChD,CAAC;;CAMR,MAAM,mBACH,QAAQ,mBAAmB,UAAU,MACrC,QAAQ,eAAe,UAAU,MACjC,QAAQ,iBAAiB,UAAU,MACnC,QAAQ,eAAe,UAAU;AAEpC,KAAI,kBAAkBW,yCACpB,QAAO,KAAK;EACV,MAAMX,8CAA+B;EACrC,MAAM;GAAE,OAAO;GAAoB,QAAQ;GAAiB,KAAKW;GAAwB,MAAM;GAAQ;EACxG,CAAC;AAGJ,QAAO"}

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

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

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

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

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

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

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

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

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

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

package/packages/transact/src/transactions/key-registration.d.ts

@@ -1,7 +1,4 @@
-import { TransactionValidationError } from "./common.js";
-
 //#region packages/transact/src/transactions/key-registration.d.ts
-
 /**
  * Represents a key registration transaction that registers an account online or offline
  * for participation in Algorand consensus.
@@ -36,10 +33,6 @@ type KeyRegistrationTransactionFields = {
    */
   nonParticipation?: boolean;
 };
-/**
- * Validate key registration transaction fields
- */
-declare function validateKeyRegistrationTransaction(keyReg: KeyRegistrationTransactionFields): TransactionValidationError[];
 //#endregion
-export { KeyRegistrationTransactionFields, validateKeyRegistrationTransaction };
+export { KeyRegistrationTransactionFields };
 //# sourceMappingURL=key-registration.d.ts.map

package/packages/transact/src/transactions/reference-types-meta.d.ts

@@ -0,0 +1,26 @@
+import { ObjectModelMetadata } from "../../../common/src/codecs/types.js";
+import { BoxReference, HoldingReference, LocalsReference } from "./app-call.js";
+
+//#region packages/transact/src/transactions/reference-types-meta.d.ts
+
+/**
+ * Metadata for BoxReference
+ *
+ * Maps wire format (app, name) to BoxReference (appId, name)
+ */
+declare const BoxReferenceMeta: ObjectModelMetadata<BoxReference>;
+/**
+ * Metadata for HoldingReference
+ *
+ * Maps wire format (account, asset) to HoldingReference (address, assetId)
+ */
+declare const HoldingReferenceMeta: ObjectModelMetadata<HoldingReference>;
+/**
+ * Metadata for LocalsReference
+ *
+ * Maps wire format (account, app) to LocalsReference (address, appId)
+ */
+declare const LocalsReferenceMeta: ObjectModelMetadata<LocalsReference>;
+//#endregion
+export { BoxReferenceMeta, HoldingReferenceMeta, LocalsReferenceMeta };
+//# sourceMappingURL=reference-types-meta.d.ts.map