@algorandfoundation/algokit-utils 10.0.0-alpha.4 → 10.0.0-alpha.6

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   * 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 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({\n      type: TransactionValidationErrorType.RequiredField,\n      data: FIELD_APPROVAL_PROGRAM,\n    })\n  }\n\n  if (!appCall.clearStateProgram || appCall.clearStateProgram.length === 0) {\n    errors.push({\n      type: TransactionValidationErrorType.RequiredField,\n      data: FIELD_CLEAR_STATE_PROGRAM,\n    })\n  }\n\n  const extraPages = appCall.extraProgramPages ?? 0\n  if (extraPages > MAX_EXTRA_PROGRAM_PAGES) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: {\n        field: FIELD_EXTRA_PROGRAM_PAGES,\n        actual: extraPages,\n        max: MAX_EXTRA_PROGRAM_PAGES,\n        unit: 'pages',\n      },\n    })\n  }\n\n  const maxProgramSize = PROGRAM_PAGE_SIZE + extraPages * PROGRAM_PAGE_SIZE\n\n  if (appCall.approvalProgram && appCall.approvalProgram.length > maxProgramSize) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: {\n        field: FIELD_APPROVAL_PROGRAM,\n        actual: appCall.approvalProgram.length,\n        max: maxProgramSize,\n        unit: 'bytes',\n      },\n    })\n  }\n\n  if (appCall.clearStateProgram && appCall.clearStateProgram.length > maxProgramSize) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: {\n        field: FIELD_CLEAR_STATE_PROGRAM,\n        actual: appCall.clearStateProgram.length,\n        max: maxProgramSize,\n        unit: 'bytes',\n      },\n    })\n  }\n\n  const totalProgramSize = (appCall.approvalProgram?.length ?? 0) + (appCall.clearStateProgram?.length ?? 0)\n  if (totalProgramSize > maxProgramSize) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: {\n        field: 'Combined approval and clear state programs',\n        actual: totalProgramSize,\n        max: maxProgramSize,\n        unit: 'bytes',\n      },\n    })\n  }\n\n  if (appCall.globalStateSchema) {\n    const totalKeys = appCall.globalStateSchema.numUints + appCall.globalStateSchema.numByteSlices\n    if (totalKeys > MAX_GLOBAL_STATE_KEYS) {\n      errors.push({\n        type: TransactionValidationErrorType.FieldTooLong,\n        data: {\n          field: FIELD_GLOBAL_STATE_SCHEMA,\n          actual: appCall.globalStateSchema.numUints + appCall.globalStateSchema.numByteSlices,\n          max: MAX_GLOBAL_STATE_KEYS,\n          unit: 'keys',\n        },\n      })\n    }\n  }\n\n  if (appCall.localStateSchema) {\n    const totalKeys = appCall.localStateSchema.numUints + appCall.localStateSchema.numByteSlices\n    if (totalKeys > MAX_LOCAL_STATE_KEYS) {\n      errors.push({\n        type: TransactionValidationErrorType.FieldTooLong,\n        data: {\n          field: FIELD_LOCAL_STATE_SCHEMA,\n          actual: appCall.localStateSchema.numUints + appCall.localStateSchema.numByteSlices,\n          max: MAX_LOCAL_STATE_KEYS,\n          unit: 'keys',\n        },\n      })\n    }\n  }\n\n  return errors\n}\n\n/**\n * Validate app operation (update, delete, call) fields\n */\nfunction validateAppOperation(appCall: AppCallTransactionFields): TransactionValidationError[] {\n  const errors = new Array<TransactionValidationError>()\n\n  if (appCall.onComplete === OnApplicationComplete.UpdateApplication) {\n    if (!appCall.approvalProgram || appCall.approvalProgram.length === 0) {\n      errors.push({\n        type: TransactionValidationErrorType.RequiredField,\n        data: FIELD_APPROVAL_PROGRAM,\n      })\n    }\n    if (!appCall.clearStateProgram || appCall.clearStateProgram.length === 0) {\n      errors.push({\n        type: TransactionValidationErrorType.RequiredField,\n        data: FIELD_CLEAR_STATE_PROGRAM,\n      })\n    }\n  }\n\n  // These fields are immutable and cannot be set for existing apps\n  if (appCall.globalStateSchema !== undefined) {\n    errors.push({\n      type: TransactionValidationErrorType.ImmutableField,\n      data: FIELD_GLOBAL_STATE_SCHEMA,\n    })\n  }\n  if (appCall.localStateSchema !== undefined) {\n    errors.push({\n      type: TransactionValidationErrorType.ImmutableField,\n      data: FIELD_LOCAL_STATE_SCHEMA,\n    })\n  }\n  if (appCall.extraProgramPages !== undefined) {\n    errors.push({\n      type: TransactionValidationErrorType.ImmutableField,\n      data: FIELD_EXTRA_PROGRAM_PAGES,\n    })\n  }\n\n  return errors\n}\n\n/**\n * Validate common app call fields\n */\nfunction validateAppCommonFields(appCall: AppCallTransactionFields): TransactionValidationError[] {\n  const errors = new Array<TransactionValidationError>()\n\n  if (appCall.args) {\n    if (appCall.args.length > MAX_APP_ARGS) {\n      errors.push({\n        type: TransactionValidationErrorType.FieldTooLong,\n        data: {\n          field: FIELD_ARGS,\n          actual: appCall.args.length,\n          max: MAX_APP_ARGS,\n          unit: 'arguments',\n        },\n      })\n    }\n\n    const totalArgsSize = appCall.args.reduce((sum, arg) => sum + arg.length, 0)\n    if (totalArgsSize > MAX_ARGS_SIZE) {\n      errors.push({\n        type: TransactionValidationErrorType.FieldTooLong,\n        data: {\n          field: 'Args total size',\n          actual: totalArgsSize,\n          max: MAX_ARGS_SIZE,\n          unit: 'bytes',\n        },\n      })\n    }\n  }\n\n  if (appCall.accountReferences && appCall.accountReferences.length > MAX_ACCOUNT_REFERENCES) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: {\n        field: 'Account references',\n        actual: appCall.accountReferences.length,\n        max: MAX_ACCOUNT_REFERENCES,\n        unit: 'refs',\n      },\n    })\n  }\n\n  if (appCall.appReferences && appCall.appReferences.length > MAX_APP_REFERENCES) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: {\n        field: 'App references',\n        actual: appCall.appReferences.length,\n        max: MAX_APP_REFERENCES,\n        unit: 'refs',\n      },\n    })\n  }\n\n  if (appCall.assetReferences && appCall.assetReferences.length > MAX_ASSET_REFERENCES) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: {\n        field: 'Asset references',\n        actual: appCall.assetReferences.length,\n        max: MAX_ASSET_REFERENCES,\n        unit: 'refs',\n      },\n    })\n  }\n\n  // Validate box references\n  if (appCall.boxReferences) {\n    if (appCall.boxReferences.length > MAX_BOX_REFERENCES) {\n      errors.push({\n        type: TransactionValidationErrorType.FieldTooLong,\n        data: {\n          field: 'Box references',\n          actual: appCall.boxReferences.length,\n          max: MAX_BOX_REFERENCES,\n          unit: 'refs',\n        },\n      })\n    }\n\n    // Validate that box reference app IDs are in app references\n    const appRefs = appCall.appReferences || []\n    for (const boxRef of appCall.boxReferences) {\n      if (boxRef.appId !== 0n && boxRef.appId !== appCall.appId && !appRefs.includes(boxRef.appId)) {\n        errors.push({\n          type: TransactionValidationErrorType.ArbitraryConstraint,\n          data: `Box reference for app ID ${boxRef.appId} must be in app references`,\n        })\n      }\n    }\n  }\n\n  // Validate overall reference count\n  const totalReferences =\n    (appCall.accountReferences?.length || 0) +\n    (appCall.appReferences?.length || 0) +\n    (appCall.assetReferences?.length || 0) +\n    (appCall.boxReferences?.length || 0)\n\n  if (totalReferences > MAX_OVERALL_REFERENCES) {\n    errors.push({\n      type: TransactionValidationErrorType.FieldTooLong,\n      data: {\n        field: 'Total references',\n        actual: totalReferences,\n        max: MAX_OVERALL_REFERENCES,\n        unit: 'refs',\n      },\n    })\n  }\n\n  return errors\n}\n"],"mappings":"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"}

package/packages/transact/src/transactions/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

package/packages/transact/src/transactions/reference-types-meta.js

@@ -0,0 +1,71 @@
+const require_address = require('../../../common/src/codecs/primitives/address.js');
+const require_bigint = require('../../../common/src/codecs/primitives/bigint.js');
+const require_bytes = require('../../../common/src/codecs/primitives/bytes.js');
+
+//#region packages/transact/src/transactions/reference-types-meta.ts
+/**
+* Metadata for BoxReference
+*
+* Maps wire format (app, name) to BoxReference (appId, name)
+*/
+const BoxReferenceMeta = {
+	name: "BoxReference",
+	kind: "object",
+	fields: [{
+		name: "appId",
+		wireKey: "app",
+		optional: false,
+		codec: require_bigint.bigIntCodec
+	}, {
+		name: "name",
+		wireKey: "name",
+		optional: false,
+		codec: require_bytes.bytesCodec
+	}]
+};
+/**
+* Metadata for HoldingReference
+*
+* Maps wire format (account, asset) to HoldingReference (address, assetId)
+*/
+const HoldingReferenceMeta = {
+	name: "HoldingReference",
+	kind: "object",
+	fields: [{
+		name: "address",
+		wireKey: "account",
+		optional: false,
+		codec: require_address.addressCodec
+	}, {
+		name: "assetId",
+		wireKey: "asset",
+		optional: false,
+		codec: require_bigint.bigIntCodec
+	}]
+};
+/**
+* Metadata for LocalsReference
+*
+* Maps wire format (account, app) to LocalsReference (address, appId)
+*/
+const LocalsReferenceMeta = {
+	name: "LocalsReference",
+	kind: "object",
+	fields: [{
+		name: "address",
+		wireKey: "account",
+		optional: false,
+		codec: require_address.addressCodec
+	}, {
+		name: "appId",
+		wireKey: "app",
+		optional: false,
+		codec: require_bigint.bigIntCodec
+	}]
+};
+
+//#endregion
+exports.BoxReferenceMeta = BoxReferenceMeta;
+exports.HoldingReferenceMeta = HoldingReferenceMeta;
+exports.LocalsReferenceMeta = LocalsReferenceMeta;
+//# sourceMappingURL=reference-types-meta.js.map

package/packages/transact/src/transactions/reference-types-meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-types-meta.js","names":["BoxReferenceMeta: ObjectModelMetadata<BoxReference>","bigIntCodec","bytesCodec","HoldingReferenceMeta: ObjectModelMetadata<HoldingReference>","addressCodec","LocalsReferenceMeta: ObjectModelMetadata<LocalsReference>"],"sources":["../../../../../packages/transact/src/transactions/reference-types-meta.ts"],"sourcesContent":["import type { ObjectModelMetadata } from '@algorandfoundation/algokit-common'\nimport { addressCodec, bigIntCodec, bytesCodec } from '@algorandfoundation/algokit-common'\nimport type { BoxReference, HoldingReference, LocalsReference } from './app-call'\n\n/**\n * Metadata for BoxReference\n *\n * Maps wire format (app, name) to BoxReference (appId, name)\n */\nexport const BoxReferenceMeta: ObjectModelMetadata<BoxReference> = {\n  name: 'BoxReference',\n  kind: 'object',\n  fields: [\n    { name: 'appId', wireKey: 'app', optional: false, codec: bigIntCodec },\n    { name: 'name', wireKey: 'name', optional: false, codec: bytesCodec },\n  ],\n}\n\n/**\n * Metadata for HoldingReference\n *\n * Maps wire format (account, asset) to HoldingReference (address, assetId)\n */\nexport const HoldingReferenceMeta: ObjectModelMetadata<HoldingReference> = {\n  name: 'HoldingReference',\n  kind: 'object',\n  fields: [\n    { name: 'address', wireKey: 'account', optional: false, codec: addressCodec },\n    { name: 'assetId', wireKey: 'asset', optional: false, codec: bigIntCodec },\n  ],\n}\n\n/**\n * Metadata for LocalsReference\n *\n * Maps wire format (account, app) to LocalsReference (address, appId)\n */\nexport const LocalsReferenceMeta: ObjectModelMetadata<LocalsReference> = {\n  name: 'LocalsReference',\n  kind: 'object',\n  fields: [\n    { name: 'address', wireKey: 'account', optional: false, codec: addressCodec },\n    { name: 'appId', wireKey: 'app', optional: false, codec: bigIntCodec },\n  ],\n}\n"],"mappings":";;;;;;;;;;AASA,MAAaA,mBAAsD;CACjE,MAAM;CACN,MAAM;CACN,QAAQ,CACN;EAAE,MAAM;EAAS,SAAS;EAAO,UAAU;EAAO,OAAOC;EAAa,EACtE;EAAE,MAAM;EAAQ,SAAS;EAAQ,UAAU;EAAO,OAAOC;EAAY,CACtE;CACF;;;;;;AAOD,MAAaC,uBAA8D;CACzE,MAAM;CACN,MAAM;CACN,QAAQ,CACN;EAAE,MAAM;EAAW,SAAS;EAAW,UAAU;EAAO,OAAOC;EAAc,EAC7E;EAAE,MAAM;EAAW,SAAS;EAAS,UAAU;EAAO,OAAOH;EAAa,CAC3E;CACF;;;;;;AAOD,MAAaI,sBAA4D;CACvE,MAAM;CACN,MAAM;CACN,QAAQ,CACN;EAAE,MAAM;EAAW,SAAS;EAAW,UAAU;EAAO,OAAOD;EAAc,EAC7E;EAAE,MAAM;EAAS,SAAS;EAAO,UAAU;EAAO,OAAOH;EAAa,CACvE;CACF"}

package/packages/transact/src/transactions/reference-types-meta.mjs

@@ -0,0 +1,69 @@
+import { addressCodec } from "../../../common/src/codecs/primitives/address.mjs";
+import { bigIntCodec } from "../../../common/src/codecs/primitives/bigint.mjs";
+import { bytesCodec } from "../../../common/src/codecs/primitives/bytes.mjs";
+
+//#region packages/transact/src/transactions/reference-types-meta.ts
+/**
+* Metadata for BoxReference
+*
+* Maps wire format (app, name) to BoxReference (appId, name)
+*/
+const BoxReferenceMeta = {
+	name: "BoxReference",
+	kind: "object",
+	fields: [{
+		name: "appId",
+		wireKey: "app",
+		optional: false,
+		codec: bigIntCodec
+	}, {
+		name: "name",
+		wireKey: "name",
+		optional: false,
+		codec: bytesCodec
+	}]
+};
+/**
+* Metadata for HoldingReference
+*
+* Maps wire format (account, asset) to HoldingReference (address, assetId)
+*/
+const HoldingReferenceMeta = {
+	name: "HoldingReference",
+	kind: "object",
+	fields: [{
+		name: "address",
+		wireKey: "account",
+		optional: false,
+		codec: addressCodec
+	}, {
+		name: "assetId",
+		wireKey: "asset",
+		optional: false,
+		codec: bigIntCodec
+	}]
+};
+/**
+* Metadata for LocalsReference
+*
+* Maps wire format (account, app) to LocalsReference (address, appId)
+*/
+const LocalsReferenceMeta = {
+	name: "LocalsReference",
+	kind: "object",
+	fields: [{
+		name: "address",
+		wireKey: "account",
+		optional: false,
+		codec: addressCodec
+	}, {
+		name: "appId",
+		wireKey: "app",
+		optional: false,
+		codec: bigIntCodec
+	}]
+};
+
+//#endregion
+export { BoxReferenceMeta, HoldingReferenceMeta, LocalsReferenceMeta };
+//# sourceMappingURL=reference-types-meta.mjs.map

package/packages/transact/src/transactions/reference-types-meta.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-types-meta.mjs","names":["BoxReferenceMeta: ObjectModelMetadata<BoxReference>","HoldingReferenceMeta: ObjectModelMetadata<HoldingReference>","LocalsReferenceMeta: ObjectModelMetadata<LocalsReference>"],"sources":["../../../../../packages/transact/src/transactions/reference-types-meta.ts"],"sourcesContent":["import type { ObjectModelMetadata } from '@algorandfoundation/algokit-common'\nimport { addressCodec, bigIntCodec, bytesCodec } from '@algorandfoundation/algokit-common'\nimport type { BoxReference, HoldingReference, LocalsReference } from './app-call'\n\n/**\n * Metadata for BoxReference\n *\n * Maps wire format (app, name) to BoxReference (appId, name)\n */\nexport const BoxReferenceMeta: ObjectModelMetadata<BoxReference> = {\n  name: 'BoxReference',\n  kind: 'object',\n  fields: [\n    { name: 'appId', wireKey: 'app', optional: false, codec: bigIntCodec },\n    { name: 'name', wireKey: 'name', optional: false, codec: bytesCodec },\n  ],\n}\n\n/**\n * Metadata for HoldingReference\n *\n * Maps wire format (account, asset) to HoldingReference (address, assetId)\n */\nexport const HoldingReferenceMeta: ObjectModelMetadata<HoldingReference> = {\n  name: 'HoldingReference',\n  kind: 'object',\n  fields: [\n    { name: 'address', wireKey: 'account', optional: false, codec: addressCodec },\n    { name: 'assetId', wireKey: 'asset', optional: false, codec: bigIntCodec },\n  ],\n}\n\n/**\n * Metadata for LocalsReference\n *\n * Maps wire format (account, app) to LocalsReference (address, appId)\n */\nexport const LocalsReferenceMeta: ObjectModelMetadata<LocalsReference> = {\n  name: 'LocalsReference',\n  kind: 'object',\n  fields: [\n    { name: 'address', wireKey: 'account', optional: false, codec: addressCodec },\n    { name: 'appId', wireKey: 'app', optional: false, codec: bigIntCodec },\n  ],\n}\n"],"mappings":";;;;;;;;;;AASA,MAAaA,mBAAsD;CACjE,MAAM;CACN,MAAM;CACN,QAAQ,CACN;EAAE,MAAM;EAAS,SAAS;EAAO,UAAU;EAAO,OAAO;EAAa,EACtE;EAAE,MAAM;EAAQ,SAAS;EAAQ,UAAU;EAAO,OAAO;EAAY,CACtE;CACF;;;;;;AAOD,MAAaC,uBAA8D;CACzE,MAAM;CACN,MAAM;CACN,QAAQ,CACN;EAAE,MAAM;EAAW,SAAS;EAAW,UAAU;EAAO,OAAO;EAAc,EAC7E;EAAE,MAAM;EAAW,SAAS;EAAS,UAAU;EAAO,OAAO;EAAa,CAC3E;CACF;;;;;;AAOD,MAAaC,sBAA4D;CACvE,MAAM;CACN,MAAM;CACN,QAAQ,CACN;EAAE,MAAM;EAAW,SAAS;EAAW,UAAU;EAAO,OAAO;EAAc,EAC7E;EAAE,MAAM;EAAS,SAAS;EAAO,UAAU;EAAO,OAAO;EAAa,CACvE;CACF"}

package/packages/transact/src/transactions/transaction-meta.js

@@ -93,8 +93,8 @@ var AssetConfigDataCodec = class extends require_codec.Codec {
 var AppCallDataCodec = class extends require_codec.Codec {
 	appCallFieldsCodec = new require_object_model.ObjectModelCodec(AppCallTransactionFieldsMeta);
 	defaultValue() {}
-	encodeAccessReferences(appId, accessReferences, format) {
-		if (!accessReferences || accessReferences.length === 0) return void 0;
+	encodeResourceReferences(appId, resourceReferences, format) {
+		if (!resourceReferences || resourceReferences.length === 0) return void 0;
 		const accessList = [];
 		const ensure = (target) => {
 			for (let idx = 0; idx < accessList.length; idx++) {
@@ -109,13 +109,13 @@ var AppCallDataCodec = class extends require_codec.Codec {
 			if (target.appId !== void 0) accessList.push({ p: require_bigint.bigIntCodec.encodeOptional(target.appId, format) });
 			return accessList.length;
 		};
-		for (const accessRef of accessReferences) {
-			if (accessRef.address || accessRef.assetId !== void 0 || accessRef.appId !== void 0) {
-				ensure(accessRef);
+		for (const resourceRef of resourceReferences) {
+			if (resourceRef.address || resourceRef.assetId !== void 0 || resourceRef.appId !== void 0) {
+				ensure(resourceRef);
 				continue;
 			}
-			if (accessRef.holding) {
-				const holding = accessRef.holding;
+			if (resourceRef.holding) {
+				const holding = resourceRef.holding;
 				let addressIndex = 0;
 				if (holding.address && !holding.address.equals(require_address.Address.zeroAddress())) addressIndex = ensure({ address: holding.address });
 				const assetIndex = ensure({ assetId: holding.assetId });
@@ -125,8 +125,8 @@ var AppCallDataCodec = class extends require_codec.Codec {
 				} });
 				continue;
 			}
-			if (accessRef.locals) {
-				const locals = accessRef.locals;
+			if (resourceRef.locals) {
+				const locals = resourceRef.locals;
 				let addressIndex = 0;
 				if (locals.address && !locals.address.equals(require_address.Address.zeroAddress())) addressIndex = ensure({ address: locals.address });
 				let appIndex = 0;
@@ -137,8 +137,8 @@ var AppCallDataCodec = class extends require_codec.Codec {
 				} });
 				continue;
 			}
-			if (accessRef.box) {
-				const box = accessRef.box;
+			if (resourceRef.box) {
+				const box = resourceRef.box;
 				let appIndex = 0;
 				if (box.appId && box.appId !== appId) appIndex = ensure({ appId: box.appId });
 				accessList.push({ b: {
@@ -150,11 +150,11 @@ var AppCallDataCodec = class extends require_codec.Codec {
 		}
 		return accessList.length > 0 ? accessList : void 0;
 	}
-	decodeAccessReferences(_wireAccessReferences, format) {
-		if (!_wireAccessReferences || _wireAccessReferences.length === 0) return [];
+	decodeResourceReferences(_wireResourceReferences, format) {
+		if (!_wireResourceReferences || _wireResourceReferences.length === 0) return [];
 		const result = [];
-		const wireAccessReferences = _wireAccessReferences.map((ref) => require_wire.normalizeWireObject(ref));
-		for (const ref of wireAccessReferences) {
+		const wireResourceReferences = _wireResourceReferences.map((ref) => require_wire.normalizeWireObject(ref));
+		for (const ref of wireResourceReferences) {
 			const d = ref.d;
 			const s = ref.s;
 			const p = ref.p;
@@ -180,8 +180,8 @@ var AppCallDataCodec = class extends require_codec.Codec {
 				const addrIdx = h.d ?? 0;
 				const assetIdx = h.s;
 				if (assetIdx === void 0) throw new Error("Access list holding reference is missing asset index");
-				const holdingAddress = addrIdx === 0 ? require_address.Address.zeroAddress() : require_address$1.addressCodec.decode(wireAccessReferences[addrIdx - 1].d, format);
-				const holdingAssetId = wireAccessReferences[assetIdx - 1].s;
+				const holdingAddress = addrIdx === 0 ? require_address.Address.zeroAddress() : require_address$1.addressCodec.decode(wireResourceReferences[addrIdx - 1].d, format);
+				const holdingAssetId = wireResourceReferences[assetIdx - 1].s;
 				result.push({ holding: {
 					assetId: require_bigint.bigIntCodec.decode(holdingAssetId, format),
 					address: holdingAddress
@@ -191,8 +191,8 @@ var AppCallDataCodec = class extends require_codec.Codec {
 			if (l) {
 				const addrIdx = l.d ?? 0;
 				const appIdx = l.p ?? 0;
-				const localsAddress = addrIdx === 0 ? require_address.Address.zeroAddress() : require_address$1.addressCodec.decode(wireAccessReferences[addrIdx - 1].d, format);
-				const localsAppId = appIdx === 0 ? 0n : wireAccessReferences[appIdx - 1].p;
+				const localsAddress = addrIdx === 0 ? require_address.Address.zeroAddress() : require_address$1.addressCodec.decode(wireResourceReferences[addrIdx - 1].d, format);
+				const localsAppId = appIdx === 0 ? 0n : wireResourceReferences[appIdx - 1].p;
 				result.push({ locals: {
 					appId: require_bigint.bigIntCodec.decode(localsAppId, format),
 					address: localsAddress
@@ -203,7 +203,7 @@ var AppCallDataCodec = class extends require_codec.Codec {
 				const boxAppIdx = b.i ?? 0;
 				const name = b.n;
 				if (!name) throw new Error("Access list box reference is missing name");
-				const boxAppId = boxAppIdx === 0 ? 0n : wireAccessReferences[boxAppIdx - 1].p;
+				const boxAppId = boxAppIdx === 0 ? 0n : wireResourceReferences[boxAppIdx - 1].p;
 				result.push({ box: {
 					appId: require_bigint.bigIntCodec.decode(boxAppId, format),
 					name: require_bytes.bytesCodec.decode(name, format)
@@ -253,7 +253,7 @@ var AppCallDataCodec = class extends require_codec.Codec {
 		if (encodedParams && Object.keys(encodedParams).length > 0) Object.assign(result, encodedParams);
 		const wireBoxReferences = this.encodeBoxReferences(value.appId, value.appReferences, value.boxReferences, format);
 		if (wireBoxReferences) result.apbx = wireBoxReferences;
-		const wireAccessReferences = this.encodeAccessReferences(value.appId, value.accessReferences, format);
+		const wireAccessReferences = this.encodeResourceReferences(value.appId, value.accessReferences, format);
 		if (wireAccessReferences) result.al = wireAccessReferences;
 		return result;
 	}
@@ -264,7 +264,7 @@ var AppCallDataCodec = class extends require_codec.Codec {
 		const wireBoxReferences = value.apbx;
 		const wireAccessReferences = value.al;
 		const boxReferences = this.decodeBoxReferences(appReferences?.map((ar) => require_bigint.bigIntCodec.decode(ar, format)), wireBoxReferences, format);
-		const accessReferences = this.decodeAccessReferences(wireAccessReferences, format);
+		const accessReferences = this.decodeResourceReferences(wireAccessReferences, format);
 		return {
 			...this.appCallFieldsCodec.decode(value, format),
 			...accessReferences.length > 0 && { accessReferences },