@algorandfoundation/algokit-utils 10.0.0-alpha.45 → 10.0.0-alpha.47

package/packages/abi/src/arc56-contract.d.ts

@@ -1,36 +1,24 @@
 import { ABIType } from "./abi-type.js";
 
 //#region packages/abi/src/arc56-contract.d.ts
-
 /** Describes a single key in app storage with parsed ABI types */
 type ABIStorageKey = {
-  /** The bytes of the key encoded as base64 */
-  key: string;
-  /** The parsed type of the key (ABI type or AVM type) */
-  keyType: ABIType | AVMType;
-  /** The parsed type of the value (ABI type or AVM type) */
-  valueType: ABIType | AVMType;
-  /** Description of what this storage key holds */
+  /** The bytes of the key encoded as base64 */key: string; /** The parsed type of the key (ABI type or AVM type) */
+  keyType: ABIType | AVMType; /** The parsed type of the value (ABI type or AVM type) */
+  valueType: ABIType | AVMType; /** Description of what this storage key holds */
   desc?: string;
 };
 /** Describes a storage map with parsed ABI types */
 type ABIStorageMap = {
-  /** The parsed type of the keys in the map (ABI type or AVM type) */
-  keyType: ABIType | AVMType;
-  /** The parsed type of the values in the map (ABI type or AVM type) */
-  valueType: ABIType | AVMType;
-  /** Description of what the key-value pairs in this mapping hold */
-  desc?: string;
-  /** The base64-encoded prefix of the map keys */
+  /** The parsed type of the keys in the map (ABI type or AVM type) */keyType: ABIType | AVMType; /** The parsed type of the values in the map (ABI type or AVM type) */
+  valueType: ABIType | AVMType; /** Description of what the key-value pairs in this mapping hold */
+  desc?: string; /** The base64-encoded prefix of the map keys */
   prefix?: string;
 };
 /** Describes the entire contract. This type is an extension of the type described in ARC-4 */
 type Arc56Contract = {
-  /** The ARCs used and/or supported by this contract. All contracts implicitly support ARC4 and ARC56 */
-  arcs: number[];
-  /** A user-friendly name for the contract */
-  name: string;
-  /** Optional, user-friendly description for the type */
+  /** The ARCs used and/or supported by this contract. All contracts implicitly support ARC4 and ARC56 */arcs: number[]; /** A user-friendly name for the contract */
+  name: string; /** Optional, user-friendly description for the type */
   desc?: string;
   /**
    * Optional object listing the contract instances across different networks.
@@ -41,19 +29,15 @@ type Arc56Contract = {
    */
   networks?: {
     [network: string]: {
-      /** The app ID of the deployed contract in this network */
-      appID: number;
+      /** The app ID of the deployed contract in this network */appID: number;
     };
-  };
-  /** Named structs used by the application. Each struct field appears in the same order as ABI encoding. */
+  }; /** Named structs used by the application. Each struct field appears in the same order as ABI encoding. */
   structs: {
     [structName: StructName]: StructField[];
-  };
-  /** All of the methods that the contract implements */
+  }; /** All of the methods that the contract implements */
   methods: Arc56Method[];
   state: {
-    /** Defines the values that should be used for GlobalNumUint, GlobalNumByteSlice, LocalNumUint, and LocalNumByteSlice when creating the application  */
-    schema: {
+    /** Defines the values that should be used for GlobalNumUint, GlobalNumByteSlice, LocalNumUint, and LocalNumByteSlice when creating the application  */schema: {
       global: {
         ints: number;
         bytes: number;
@@ -62,8 +46,7 @@ type Arc56Contract = {
         ints: number;
         bytes: number;
       };
-    };
-    /** Mapping of human-readable names to StorageKey objects */
+    }; /** Mapping of human-readable names to StorageKey objects */
     keys: {
       global: {
         [name: string]: StorageKey;
@@ -74,8 +57,7 @@ type Arc56Contract = {
       box: {
         [name: string]: StorageKey;
       };
-    };
-    /** Mapping of human-readable names to StorageMap objects */
+    }; /** Mapping of human-readable names to StorageMap objects */
     maps: {
       global: {
         [name: string]: StorageMap;
@@ -87,59 +69,39 @@ type Arc56Contract = {
         [name: string]: StorageMap;
       };
     };
-  };
-  /** Supported bare actions for the contract. An action is a combination of call/create and an OnComplete */
+  }; /** Supported bare actions for the contract. An action is a combination of call/create and an OnComplete */
   bareActions: {
-    /** OnCompletes this method allows when appID === 0 */
-    create: ('NoOp' | 'OptIn' | 'DeleteApplication')[];
-    /** OnCompletes this method allows when appID !== 0 */
+    /** OnCompletes this method allows when appID === 0 */create: ('NoOp' | 'OptIn' | 'DeleteApplication')[]; /** OnCompletes this method allows when appID !== 0 */
     call: ('NoOp' | 'OptIn' | 'CloseOut' | 'ClearState' | 'UpdateApplication' | 'DeleteApplication')[];
-  };
-  /** Information about the TEAL programs */
+  }; /** Information about the TEAL programs */
   sourceInfo?: {
-    /** Approval program information */
-    approval: ProgramSourceInfo;
-    /** Clear program information */
+    /** Approval program information */approval: ProgramSourceInfo; /** Clear program information */
     clear: ProgramSourceInfo;
-  };
-  /** The pre-compiled TEAL that may contain template variables. MUST be omitted if included as part of ARC23 */
+  }; /** The pre-compiled TEAL that may contain template variables. MUST be omitted if included as part of ARC23 */
   source?: {
-    /** The approval program */
-    approval: string;
-    /** The clear program */
+    /** The approval program */approval: string; /** The clear program */
     clear: string;
-  };
-  /** The compiled bytecode for the application. MUST be omitted if included as part of ARC23 */
+  }; /** The compiled bytecode for the application. MUST be omitted if included as part of ARC23 */
   byteCode?: {
-    /** The approval program */
-    approval: string;
-    /** The clear program */
+    /** The approval program */approval: string; /** The clear program */
     clear: string;
-  };
-  /** Information used to get the given byteCode and/or PC values in sourceInfo. MUST be given if byteCode or PC values are present */
+  }; /** Information used to get the given byteCode and/or PC values in sourceInfo. MUST be given if byteCode or PC values are present */
   compilerInfo?: {
-    /** The name of the compiler */
-    compiler: 'algod' | 'puya';
-    /** Compiler version information */
+    /** The name of the compiler */compiler: 'algod' | 'puya'; /** Compiler version information */
     compilerVersion: {
       major: number;
       minor: number;
       patch: number;
       commitHash?: string;
     };
-  };
-  /** ARC-28 events that MAY be emitted by this contract */
-  events?: Array<Event>;
-  /** A mapping of template variable names as they appear in the TEAL (not including TMPL_ prefix) to their respective types and values (if applicable) */
+  }; /** ARC-28 events that MAY be emitted by this contract */
+  events?: Array<Event>; /** A mapping of template variable names as they appear in the TEAL (not including TMPL_ prefix) to their respective types and values (if applicable) */
   templateVariables?: {
     [name: string]: {
-      /** The type of the template variable */
-      type: ABITypeName | AVMType | StructName;
-      /** If given, the base64 encoded value used for the given app/program */
+      /** The type of the template variable */type: ABITypeName | AVMType | StructName; /** If given, the base64 encoded value used for the given app/program */
       value?: string;
     };
-  };
-  /** The scratch variables used during runtime */
+  }; /** The scratch variables used during runtime */
   scratchVariables?: {
     [name: string]: {
       slot: number;
@@ -149,25 +111,15 @@ type Arc56Contract = {
 };
 /** Describes a method in the contract. This type is an extension of the type described in ARC-4 */
 type Arc56Method = {
-  /** The name of the method */
-  name: string;
-  /** Optional, user-friendly description for the method */
-  desc?: string;
-  /** The arguments of the method, in order */
+  /** The name of the method */name: string; /** Optional, user-friendly description for the method */
+  desc?: string; /** The arguments of the method, in order */
   args: Array<{
-    /** The type of the argument. The `struct` field should also be checked to determine if this arg is a struct. */
-    type: ABITypeName;
-    /** If the type is a struct, the name of the struct */
-    struct?: StructName;
-    /** Optional, user-friendly name for the argument */
-    name?: string;
-    /** Optional, user-friendly description for the argument */
-    desc?: string;
-    /** The default value that clients should use. */
+    /** The type of the argument. The `struct` field should also be checked to determine if this arg is a struct. */type: ABITypeName; /** If the type is a struct, the name of the struct */
+    struct?: StructName; /** Optional, user-friendly name for the argument */
+    name?: string; /** Optional, user-friendly description for the argument */
+    desc?: string; /** The default value that clients should use. */
     defaultValue?: {
-      /** Base64 encoded bytes, base64 ARC4 encoded uint64, or UTF-8 method selector */
-      data: string;
-      /** How the data is encoded. This is the encoding for the data provided here, not the arg type */
+      /** Base64 encoded bytes, base64 ARC4 encoded uint64, or UTF-8 method selector */data: string; /** How the data is encoded. This is the encoding for the data provided here, not the arg type */
       type?: ABITypeName | AVMType;
       /** Where the default value is coming from
        * - box: The data key signifies the box key to read the value from
@@ -178,65 +130,39 @@ type Arc56Method = {
        */
       source: 'box' | 'global' | 'local' | 'literal' | 'method';
     };
-  }>;
-  /** Information about the method's return value */
+  }>; /** Information about the method's return value */
   returns: {
-    /** The type of the return value, or "void" to indicate no return value. The `struct` field should also be checked to determine if this return value is a struct. */
-    type: ABITypeName;
-    /** If the type is a struct, the name of the struct */
-    struct?: StructName;
-    /** Optional, user-friendly description for the return value */
+    /** The type of the return value, or "void" to indicate no return value. The `struct` field should also be checked to determine if this return value is a struct. */type: ABITypeName; /** If the type is a struct, the name of the struct */
+    struct?: StructName; /** Optional, user-friendly description for the return value */
     desc?: string;
-  };
-  /** an action is a combination of call/create and an OnComplete */
+  }; /** an action is a combination of call/create and an OnComplete */
   actions: {
-    /** OnCompletes this method allows when appID === 0 */
-    create: ('NoOp' | 'OptIn' | 'DeleteApplication')[];
-    /** OnCompletes this method allows when appID !== 0 */
+    /** OnCompletes this method allows when appID === 0 */create: ('NoOp' | 'OptIn' | 'DeleteApplication')[]; /** OnCompletes this method allows when appID !== 0 */
     call: ('NoOp' | 'OptIn' | 'CloseOut' | 'ClearState' | 'UpdateApplication' | 'DeleteApplication')[];
-  };
-  /** If this method does not write anything to the ledger (ARC-22) */
-  readonly?: boolean;
-  /** ARC-28 events that MAY be emitted by this method */
-  events?: Array<Event>;
-  /** Information that clients can use when calling the method */
+  }; /** If this method does not write anything to the ledger (ARC-22) */
+  readonly?: boolean; /** ARC-28 events that MAY be emitted by this method */
+  events?: Array<Event>; /** Information that clients can use when calling the method */
   recommendations?: {
-    /** The number of inner transactions the caller should cover the fees for */
-    innerTransactionCount?: number;
-    /** Recommended box references to include */
+    /** The number of inner transactions the caller should cover the fees for */innerTransactionCount?: number; /** Recommended box references to include */
     boxes?: {
-      /** The app ID for the box */
-      app?: number;
-      /** The base64 encoded box key */
-      key: string;
-      /** The number of bytes being read from the box */
-      readBytes: number;
-      /** The number of bytes being written to the box */
+      /** The app ID for the box */app?: number; /** The base64 encoded box key */
+      key: string; /** The number of bytes being read from the box */
+      readBytes: number; /** The number of bytes being written to the box */
       writeBytes: number;
-    };
-    /** Recommended foreign accounts */
-    accounts?: string[];
-    /** Recommended foreign apps */
-    apps?: number[];
-    /** Recommended foreign assets */
+    }; /** Recommended foreign accounts */
+    accounts?: string[]; /** Recommended foreign apps */
+    apps?: number[]; /** Recommended foreign assets */
     assets?: number[];
   };
 };
 /** ARC-28 event */
 type Event = {
-  /** The name of the event */
-  name: string;
-  /** Optional, user-friendly description for the event */
-  desc?: string;
-  /** The arguments of the event, in order */
+  /** The name of the event */name: string; /** Optional, user-friendly description for the event */
+  desc?: string; /** The arguments of the event, in order */
   args: Array<{
-    /** The type of the argument. The `struct` field should also be checked to determine if this arg is a struct. */
-    type: ABITypeName;
-    /** Optional, user-friendly name for the argument */
-    name?: string;
-    /** Optional, user-friendly description for the argument */
-    desc?: string;
-    /** If the type is a struct, the name of the struct */
+    /** The type of the argument. The `struct` field should also be checked to determine if this arg is a struct. */type: ABITypeName; /** Optional, user-friendly name for the argument */
+    name?: string; /** Optional, user-friendly description for the argument */
+    desc?: string; /** If the type is a struct, the name of the struct */
     struct?: StructName;
   }>;
 };
@@ -254,46 +180,31 @@ type AVMUint64 = 'AVMUint64';
 type AVMType = AVMBytes | AVMString | AVMUint64;
 /** Information about a single field in a struct */
 type StructField = {
-  /** The name of the struct field */
-  name: string;
-  /** The type of the struct field's value */
+  /** The name of the struct field */name: string; /** The type of the struct field's value */
   type: ABITypeName | StructName | StructField[];
 };
 /** Describes a single key in app storage */
 type StorageKey = {
-  /** Description of what this storage key holds */
-  desc?: string;
-  /** The type of the key */
-  keyType: ABITypeName | AVMType | StructName;
-  /** The type of the value */
-  valueType: ABITypeName | AVMType | StructName;
-  /** The bytes of the key encoded as base64 */
+  /** Description of what this storage key holds */desc?: string; /** The type of the key */
+  keyType: ABITypeName | AVMType | StructName; /** The type of the value */
+  valueType: ABITypeName | AVMType | StructName; /** The bytes of the key encoded as base64 */
   key: string;
 };
 /** Describes a mapping of key-value pairs in storage */
 type StorageMap = {
-  /** Description of what the key-value pairs in this mapping hold */
-  desc?: string;
-  /** The type of the keys in the map */
-  keyType: ABITypeName | AVMType | StructName;
-  /** The type of the values in the map */
-  valueType: ABITypeName | AVMType | StructName;
-  /** The base64-encoded prefix of the map keys*/
+  /** Description of what the key-value pairs in this mapping hold */desc?: string; /** The type of the keys in the map */
+  keyType: ABITypeName | AVMType | StructName; /** The type of the values in the map */
+  valueType: ABITypeName | AVMType | StructName; /** The base64-encoded prefix of the map keys*/
   prefix?: string;
 };
 type SourceInfo = {
-  /** The program counter value(s). Could be offset if pcOffsetMethod is not "none" */
-  pc: Array<number>;
-  /** A human-readable string that describes the error when the program fails at the given PC */
-  errorMessage?: string;
-  /** The TEAL line number that corresponds to the given PC. RECOMMENDED to be used for development purposes, but not required for clients */
-  teal?: number;
-  /** The original source file and line number that corresponds to the given PC. RECOMMENDED to be used for development purposes, but not required for clients */
+  /** The program counter value(s). Could be offset if pcOffsetMethod is not "none" */pc: Array<number>; /** A human-readable string that describes the error when the program fails at the given PC */
+  errorMessage?: string; /** The TEAL line number that corresponds to the given PC. RECOMMENDED to be used for development purposes, but not required for clients */
+  teal?: number; /** The original source file and line number that corresponds to the given PC. RECOMMENDED to be used for development purposes, but not required for clients */
   source?: string;
 };
 type ProgramSourceInfo = {
-  /** The source information for the program */
-  sourceInfo: SourceInfo[];
+  /** The source information for the program */sourceInfo: SourceInfo[];
   /** How the program counter offset is calculated
    * - none: The pc values in sourceInfo are not offset
    * - cblocks: The pc values in sourceInfo are offset by the PC of the first op following the last cblock at the top of the program

package/packages/abi/src/arc56-contract.js

@@ -1,5 +1,4 @@
-const require_abi_type = require('./abi-type.js');
-
+const require_abi_type = require("./abi-type.js");
 //#region packages/abi/src/arc56-contract.ts
 /** ARC-56 spec */
 /** Storage Helper Functions */
@@ -180,7 +179,6 @@ function getBoxABIStorageMaps(contract) {
 	for (const [name, storageMap] of Object.entries(contract.state.maps.box)) result[name] = convertStorageMap(storageMap, contract.structs);
 	return result;
 }
-
 //#endregion
 exports.getBoxABIStorageKey = getBoxABIStorageKey;
 exports.getBoxABIStorageKeys = getBoxABIStorageKeys;
@@ -194,4 +192,5 @@ exports.getLocalABIStorageKey = getLocalABIStorageKey;
 exports.getLocalABIStorageKeys = getLocalABIStorageKeys;
 exports.getLocalABIStorageMap = getLocalABIStorageMap;
 exports.getLocalABIStorageMaps = getLocalABIStorageMaps;
+
 //# sourceMappingURL=arc56-contract.js.map

package/packages/abi/src/arc56-contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"arc56-contract.js","names":["ABIStructType","ABIType"],"sources":["../../../../packages/abi/src/arc56-contract.ts"],"sourcesContent":["/****************/\n/** ARC-56 spec */\n/****************/\n\nimport { ABIStructType, ABIType } from './abi-type'\n\n/** Describes a single key in app storage with parsed ABI types */\nexport type ABIStorageKey = {\n  /** The bytes of the key encoded as base64 */\n  key: string\n  /** The parsed type of the key (ABI type or AVM type) */\n  keyType: ABIType | AVMType\n  /** The parsed type of the value (ABI type or AVM type) */\n  valueType: ABIType | AVMType\n  /** Description of what this storage key holds */\n  desc?: string\n}\n\n/** Describes a storage map with parsed ABI types */\nexport type ABIStorageMap = {\n  /** The parsed type of the keys in the map (ABI type or AVM type) */\n  keyType: ABIType | AVMType\n  /** The parsed type of the values in the map (ABI type or AVM type) */\n  valueType: ABIType | AVMType\n  /** Description of what the key-value pairs in this mapping hold */\n  desc?: string\n  /** The base64-encoded prefix of the map keys */\n  prefix?: string\n}\n\n/** Describes the entire contract. This type is an extension of the type described in ARC-4 */\nexport type Arc56Contract = {\n  /** The ARCs used and/or supported by this contract. All contracts implicitly support ARC4 and ARC56 */\n  arcs: number[]\n  /** A user-friendly name for the contract */\n  name: string\n  /** Optional, user-friendly description for the type */\n  desc?: string\n  /**\n   * Optional object listing the contract instances across different networks.\n   * The key is the base64 genesis hash of the network, and the value contains\n   * information about the deployed contract in the network indicated by the\n   * key. A key containing the human-readable name of the network MAY be\n   * included, but the corresponding genesis hash key MUST also be defined\n   */\n  networks?: {\n    [network: string]: {\n      /** The app ID of the deployed contract in this network */\n      appID: number\n    }\n  }\n  /** Named structs used by the application. Each struct field appears in the same order as ABI encoding. */\n  structs: { [structName: StructName]: StructField[] }\n  /** All of the methods that the contract implements */\n  methods: Arc56Method[]\n  state: {\n    /** Defines the values that should be used for GlobalNumUint, GlobalNumByteSlice, LocalNumUint, and LocalNumByteSlice when creating the application  */\n    schema: {\n      global: {\n        ints: number\n        bytes: number\n      }\n      local: {\n        ints: number\n        bytes: number\n      }\n    }\n    /** Mapping of human-readable names to StorageKey objects */\n    keys: {\n      global: { [name: string]: StorageKey }\n      local: { [name: string]: StorageKey }\n      box: { [name: string]: StorageKey }\n    }\n    /** Mapping of human-readable names to StorageMap objects */\n    maps: {\n      global: { [name: string]: StorageMap }\n      local: { [name: string]: StorageMap }\n      box: { [name: string]: StorageMap }\n    }\n  }\n  /** Supported bare actions for the contract. An action is a combination of call/create and an OnComplete */\n  bareActions: {\n    /** OnCompletes this method allows when appID === 0 */\n    create: ('NoOp' | 'OptIn' | 'DeleteApplication')[]\n    /** OnCompletes this method allows when appID !== 0 */\n    call: ('NoOp' | 'OptIn' | 'CloseOut' | 'ClearState' | 'UpdateApplication' | 'DeleteApplication')[]\n  }\n  /** Information about the TEAL programs */\n  sourceInfo?: {\n    /** Approval program information */\n    approval: ProgramSourceInfo\n    /** Clear program information */\n    clear: ProgramSourceInfo\n  }\n  /** The pre-compiled TEAL that may contain template variables. MUST be omitted if included as part of ARC23 */\n  source?: {\n    /** The approval program */\n    approval: string\n    /** The clear program */\n    clear: string\n  }\n  /** The compiled bytecode for the application. MUST be omitted if included as part of ARC23 */\n  byteCode?: {\n    /** The approval program */\n    approval: string\n    /** The clear program */\n    clear: string\n  }\n  /** Information used to get the given byteCode and/or PC values in sourceInfo. MUST be given if byteCode or PC values are present */\n  compilerInfo?: {\n    /** The name of the compiler */\n    compiler: 'algod' | 'puya'\n    /** Compiler version information */\n    compilerVersion: {\n      major: number\n      minor: number\n      patch: number\n      commitHash?: string\n    }\n  }\n  /** ARC-28 events that MAY be emitted by this contract */\n  events?: Array<Event>\n  /** A mapping of template variable names as they appear in the TEAL (not including TMPL_ prefix) to their respective types and values (if applicable) */\n  templateVariables?: {\n    [name: string]: {\n      /** The type of the template variable */\n      type: ABITypeName | AVMType | StructName\n      /** If given, the base64 encoded value used for the given app/program */\n      value?: string\n    }\n  }\n  /** The scratch variables used during runtime */\n  scratchVariables?: {\n    [name: string]: {\n      slot: number\n      type: ABITypeName | AVMType | StructName\n    }\n  }\n}\n\n/** Describes a method in the contract. This type is an extension of the type described in ARC-4 */\nexport type Arc56Method = {\n  /** The name of the method */\n  name: string\n  /** Optional, user-friendly description for the method */\n  desc?: string\n  /** The arguments of the method, in order */\n  args: Array<{\n    /** The type of the argument. The `struct` field should also be checked to determine if this arg is a struct. */\n    type: ABITypeName\n    /** If the type is a struct, the name of the struct */\n    struct?: StructName\n    /** Optional, user-friendly name for the argument */\n    name?: string\n    /** Optional, user-friendly description for the argument */\n    desc?: string\n    /** The default value that clients should use. */\n    defaultValue?: {\n      /** Base64 encoded bytes, base64 ARC4 encoded uint64, or UTF-8 method selector */\n      data: string\n      /** How the data is encoded. This is the encoding for the data provided here, not the arg type */\n      type?: ABITypeName | AVMType\n      /** Where the default value is coming from\n       * - box: The data key signifies the box key to read the value from\n       * - global: The data key signifies the global state key to read the value from\n       * - local: The data key signifies the local state key to read the value from (for the sender)\n       * - literal: the value is a literal and should be passed directly as the argument\n       * - method: The utf8 signature of the method in this contract to call to get the default value. If the method has arguments, they all must have default values. The method **MUST** be readonly so simulate can be used to get the default value\n       */\n      source: 'box' | 'global' | 'local' | 'literal' | 'method'\n    }\n  }>\n  /** Information about the method's return value */\n  returns: {\n    /** The type of the return value, or \"void\" to indicate no return value. The `struct` field should also be checked to determine if this return value is a struct. */\n    type: ABITypeName\n    /** If the type is a struct, the name of the struct */\n    struct?: StructName\n    /** Optional, user-friendly description for the return value */\n    desc?: string\n  }\n  /** an action is a combination of call/create and an OnComplete */\n  actions: {\n    /** OnCompletes this method allows when appID === 0 */\n    create: ('NoOp' | 'OptIn' | 'DeleteApplication')[]\n    /** OnCompletes this method allows when appID !== 0 */\n    call: ('NoOp' | 'OptIn' | 'CloseOut' | 'ClearState' | 'UpdateApplication' | 'DeleteApplication')[]\n  }\n  /** If this method does not write anything to the ledger (ARC-22) */\n  readonly?: boolean\n  /** ARC-28 events that MAY be emitted by this method */\n  events?: Array<Event>\n  /** Information that clients can use when calling the method */\n  recommendations?: {\n    /** The number of inner transactions the caller should cover the fees for */\n    innerTransactionCount?: number\n    /** Recommended box references to include */\n    boxes?: {\n      /** The app ID for the box */\n      app?: number\n      /** The base64 encoded box key */\n      key: string\n      /** The number of bytes being read from the box */\n      readBytes: number\n      /** The number of bytes being written to the box */\n      writeBytes: number\n    }\n    /** Recommended foreign accounts */\n    accounts?: string[]\n    /** Recommended foreign apps */\n    apps?: number[]\n    /** Recommended foreign assets */\n    assets?: number[]\n  }\n}\n\n/** ARC-28 event */\nexport type Event = {\n  /** The name of the event */\n  name: string\n  /** Optional, user-friendly description for the event */\n  desc?: string\n  /** The arguments of the event, in order */\n  args: Array<{\n    /** The type of the argument. The `struct` field should also be checked to determine if this arg is a struct. */\n    type: ABITypeName\n    /** Optional, user-friendly name for the argument */\n    name?: string\n    /** Optional, user-friendly description for the argument */\n    desc?: string\n    /** If the type is a struct, the name of the struct */\n    struct?: StructName\n  }>\n}\n\n/** An ABI-encoded type */\nexport type ABITypeName = string\n\n/** The name of a defined struct */\nexport type StructName = string\n\n/** Raw byteslice without the length prefixed that is specified in ARC-4 */\nexport type AVMBytes = 'AVMBytes'\n\n/** A utf-8 string without the length prefix that is specified in ARC-4 */\nexport type AVMString = 'AVMString'\n\n/** A 64-bit unsigned integer */\nexport type AVMUint64 = 'AVMUint64'\n\n/** A native AVM type */\nexport type AVMType = AVMBytes | AVMString | AVMUint64\n\n/** Information about a single field in a struct */\nexport type StructField = {\n  /** The name of the struct field */\n  name: string\n  /** The type of the struct field's value */\n  type: ABITypeName | StructName | StructField[]\n}\n\n/** Describes a single key in app storage */\nexport type StorageKey = {\n  /** Description of what this storage key holds */\n  desc?: string\n  /** The type of the key */\n  keyType: ABITypeName | AVMType | StructName\n\n  /** The type of the value */\n  valueType: ABITypeName | AVMType | StructName\n  /** The bytes of the key encoded as base64 */\n  key: string\n}\n\n/** Describes a mapping of key-value pairs in storage */\nexport type StorageMap = {\n  /** Description of what the key-value pairs in this mapping hold */\n  desc?: string\n  /** The type of the keys in the map */\n  keyType: ABITypeName | AVMType | StructName\n  /** The type of the values in the map */\n  valueType: ABITypeName | AVMType | StructName\n  /** The base64-encoded prefix of the map keys*/\n  prefix?: string\n}\n\ntype SourceInfo = {\n  /** The program counter value(s). Could be offset if pcOffsetMethod is not \"none\" */\n  pc: Array<number>\n  /** A human-readable string that describes the error when the program fails at the given PC */\n  errorMessage?: string\n  /** The TEAL line number that corresponds to the given PC. RECOMMENDED to be used for development purposes, but not required for clients */\n  teal?: number\n  /** The original source file and line number that corresponds to the given PC. RECOMMENDED to be used for development purposes, but not required for clients */\n  source?: string\n}\n\nexport type ProgramSourceInfo = {\n  /** The source information for the program */\n  sourceInfo: SourceInfo[]\n  /** How the program counter offset is calculated\n   * - none: The pc values in sourceInfo are not offset\n   * - cblocks: The pc values in sourceInfo are offset by the PC of the first op following the last cblock at the top of the program\n   */\n  pcOffsetMethod: 'none' | 'cblocks'\n}\n\n/*************************/\n/** Storage Helper Functions */\n/*************************/\n\n/**\n * Resolves a storage type string (ABI type, AVM type, or struct name) into an ABIType or AVMType\n * @param typeStr The type string to resolve\n * @param structs The structs defined in the contract\n * @returns The parsed ABIType or AVMType string\n */\nfunction resolveStorageType(typeStr: string, structs: Record<string, StructField[]>): ABIType | AVMType {\n  // Check if it's an AVM type\n  if (typeStr === 'AVMBytes' || typeStr === 'AVMString' || typeStr === 'AVMUint64') {\n    return typeStr as AVMType\n  }\n\n  // Check if it's a struct type\n  if (structs[typeStr]) {\n    return ABIStructType.fromStruct(typeStr, structs)\n  }\n\n  // Otherwise parse as ABI type\n  try {\n    return ABIType.from(typeStr)\n  } catch (error) {\n    throw new Error(`Failed to parse storage type '${typeStr}': ${error}`)\n  }\n}\n\n/**\n * Converts a StorageKey to an ABIStorageKey with parsed types\n * @param storageKey The storage key to convert\n * @param structs The structs defined in the contract\n * @returns The converted ABIStorageKey\n */\nfunction convertStorageKey(storageKey: StorageKey, structs: Record<string, StructField[]>): ABIStorageKey {\n  const keyType = resolveStorageType(storageKey.keyType, structs)\n  const valueType = resolveStorageType(storageKey.valueType, structs)\n\n  return {\n    key: storageKey.key,\n    keyType,\n    valueType,\n    desc: storageKey.desc,\n  }\n}\n\n/**\n * Converts a StorageMap to an ABIStorageMap with parsed types\n * @param storageMap The storage map to convert\n * @param structs The structs defined in the contract\n * @returns The converted ABIStorageMap\n */\nfunction convertStorageMap(storageMap: StorageMap, structs: Record<string, StructField[]>): ABIStorageMap {\n  const keyType = resolveStorageType(storageMap.keyType, structs)\n  const valueType = resolveStorageType(storageMap.valueType, structs)\n\n  return {\n    keyType,\n    valueType,\n    desc: storageMap.desc,\n    prefix: storageMap.prefix,\n  }\n}\n\n/**\n * Get a specific global storage key with parsed ABI types\n * @param contract The ARC-56 contract\n * @param keyName The name of the storage key\n * @returns The ABIStorageKey with parsed types\n * @throws Error if the key is not found\n */\nexport function getGlobalABIStorageKey(contract: Arc56Contract, keyName: string): ABIStorageKey {\n  const storageKey = contract.state.keys.global[keyName]\n  if (!storageKey) {\n    throw new Error(`Global storage key '${keyName}' not found in contract '${contract.name}'`)\n  }\n  return convertStorageKey(storageKey, contract.structs)\n}\n\n/**\n * Get a specific local storage key with parsed ABI types\n * @param contract The ARC-56 contract\n * @param keyName The name of the storage key\n * @returns The ABIStorageKey with parsed types\n * @throws Error if the key is not found\n */\nexport function getLocalABIStorageKey(contract: Arc56Contract, keyName: string): ABIStorageKey {\n  const storageKey = contract.state.keys.local[keyName]\n  if (!storageKey) {\n    throw new Error(`Local storage key '${keyName}' not found in contract '${contract.name}'`)\n  }\n  return convertStorageKey(storageKey, contract.structs)\n}\n\n/**\n * Get a specific box storage key with parsed ABI types\n * @param contract The ARC-56 contract\n * @param keyName The name of the storage key\n * @returns The ABIStorageKey with parsed types\n * @throws Error if the key is not found\n */\nexport function getBoxABIStorageKey(contract: Arc56Contract, keyName: string): ABIStorageKey {\n  const storageKey = contract.state.keys.box[keyName]\n  if (!storageKey) {\n    throw new Error(`Box storage key '${keyName}' not found in contract '${contract.name}'`)\n  }\n  return convertStorageKey(storageKey, contract.structs)\n}\n\n/**\n * Get all global storage keys with parsed ABI types\n * @param contract The ARC-56 contract\n * @returns A record of storage key names to ABIStorageKey objects\n */\nexport function getGlobalABIStorageKeys(contract: Arc56Contract): Record<string, ABIStorageKey> {\n  const result: Record<string, ABIStorageKey> = {}\n  for (const [name, storageKey] of Object.entries(contract.state.keys.global)) {\n    result[name] = convertStorageKey(storageKey, contract.structs)\n  }\n  return result\n}\n\n/**\n * Get all local storage keys with parsed ABI types\n * @param contract The ARC-56 contract\n * @returns A record of storage key names to ABIStorageKey objects\n */\nexport function getLocalABIStorageKeys(contract: Arc56Contract): Record<string, ABIStorageKey> {\n  const result: Record<string, ABIStorageKey> = {}\n  for (const [name, storageKey] of Object.entries(contract.state.keys.local)) {\n    result[name] = convertStorageKey(storageKey, contract.structs)\n  }\n  return result\n}\n\n/**\n * Get all box storage keys with parsed ABI types\n * @param contract The ARC-56 contract\n * @returns A record of storage key names to ABIStorageKey objects\n */\nexport function getBoxABIStorageKeys(contract: Arc56Contract): Record<string, ABIStorageKey> {\n  const result: Record<string, ABIStorageKey> = {}\n  for (const [name, storageKey] of Object.entries(contract.state.keys.box)) {\n    result[name] = convertStorageKey(storageKey, contract.structs)\n  }\n  return result\n}\n\n/**\n * Get a specific global storage map with parsed ABI types\n * @param contract The ARC-56 contract\n * @param mapName The name of the storage map\n * @returns The ABIStorageMap with parsed types\n * @throws Error if the map is not found\n */\nexport function getGlobalABIStorageMap(contract: Arc56Contract, mapName: string): ABIStorageMap {\n  const storageMap = contract.state.maps.global[mapName]\n  if (!storageMap) {\n    throw new Error(`Global storage map '${mapName}' not found in contract '${contract.name}'`)\n  }\n  return convertStorageMap(storageMap, contract.structs)\n}\n\n/**\n * Get a specific local storage map with parsed ABI types\n * @param contract The ARC-56 contract\n * @param mapName The name of the storage map\n * @returns The ABIStorageMap with parsed types\n * @throws Error if the map is not found\n */\nexport function getLocalABIStorageMap(contract: Arc56Contract, mapName: string): ABIStorageMap {\n  const storageMap = contract.state.maps.local[mapName]\n  if (!storageMap) {\n    throw new Error(`Local storage map '${mapName}' not found in contract '${contract.name}'`)\n  }\n  return convertStorageMap(storageMap, contract.structs)\n}\n\n/**\n * Get a specific box storage map with parsed ABI types\n * @param contract The ARC-56 contract\n * @param mapName The name of the storage map\n * @returns The ABIStorageMap with parsed types\n * @throws Error if the map is not found\n */\nexport function getBoxABIStorageMap(contract: Arc56Contract, mapName: string): ABIStorageMap {\n  const storageMap = contract.state.maps.box[mapName]\n  if (!storageMap) {\n    throw new Error(`Box storage map '${mapName}' not found in contract '${contract.name}'`)\n  }\n  return convertStorageMap(storageMap, contract.structs)\n}\n\n/**\n * Get all global storage maps with parsed ABI types\n * @param contract The ARC-56 contract\n * @returns A record of storage map names to ABIStorageMap objects\n */\nexport function getGlobalABIStorageMaps(contract: Arc56Contract): Record<string, ABIStorageMap> {\n  const result: Record<string, ABIStorageMap> = {}\n  for (const [name, storageMap] of Object.entries(contract.state.maps.global)) {\n    result[name] = convertStorageMap(storageMap, contract.structs)\n  }\n  return result\n}\n\n/**\n * Get all local storage maps with parsed ABI types\n * @param contract The ARC-56 contract\n * @returns A record of storage map names to ABIStorageMap objects\n */\nexport function getLocalABIStorageMaps(contract: Arc56Contract): Record<string, ABIStorageMap> {\n  const result: Record<string, ABIStorageMap> = {}\n  for (const [name, storageMap] of Object.entries(contract.state.maps.local)) {\n    result[name] = convertStorageMap(storageMap, contract.structs)\n  }\n  return result\n}\n\n/**\n * Get all box storage maps with parsed ABI types\n * @param contract The ARC-56 contract\n * @returns A record of storage map names to ABIStorageMap objects\n */\nexport function getBoxABIStorageMaps(contract: Arc56Contract): Record<string, ABIStorageMap> {\n  const result: Record<string, ABIStorageMap> = {}\n  for (const [name, storageMap] of Object.entries(contract.state.maps.box)) {\n    result[name] = convertStorageMap(storageMap, contract.structs)\n  }\n  return result\n}\n"],"mappings":";;;;;;;;;;;AA6TA,SAAS,mBAAmB,SAAiB,SAA2D;AAEtG,KAAI,YAAY,cAAc,YAAY,eAAe,YAAY,YACnE,QAAO;AAIT,KAAI,QAAQ,SACV,QAAOA,+BAAc,WAAW,SAAS,QAAQ;AAInD,KAAI;AACF,SAAOC,yBAAQ,KAAK,QAAQ;UACrB,OAAO;AACd,QAAM,IAAI,MAAM,iCAAiC,QAAQ,KAAK,QAAQ;;;;;;;;;AAU1E,SAAS,kBAAkB,YAAwB,SAAuD;CACxG,MAAM,UAAU,mBAAmB,WAAW,SAAS,QAAQ;CAC/D,MAAM,YAAY,mBAAmB,WAAW,WAAW,QAAQ;AAEnE,QAAO;EACL,KAAK,WAAW;EAChB;EACA;EACA,MAAM,WAAW;EAClB;;;;;;;;AASH,SAAS,kBAAkB,YAAwB,SAAuD;AAIxG,QAAO;EACL,SAJc,mBAAmB,WAAW,SAAS,QAAQ;EAK7D,WAJgB,mBAAmB,WAAW,WAAW,QAAQ;EAKjE,MAAM,WAAW;EACjB,QAAQ,WAAW;EACpB;;;;;;;;;AAUH,SAAgB,uBAAuB,UAAyB,SAAgC;CAC9F,MAAM,aAAa,SAAS,MAAM,KAAK,OAAO;AAC9C,KAAI,CAAC,WACH,OAAM,IAAI,MAAM,uBAAuB,QAAQ,2BAA2B,SAAS,KAAK,GAAG;AAE7F,QAAO,kBAAkB,YAAY,SAAS,QAAQ;;;;;;;;;AAUxD,SAAgB,sBAAsB,UAAyB,SAAgC;CAC7F,MAAM,aAAa,SAAS,MAAM,KAAK,MAAM;AAC7C,KAAI,CAAC,WACH,OAAM,IAAI,MAAM,sBAAsB,QAAQ,2BAA2B,SAAS,KAAK,GAAG;AAE5F,QAAO,kBAAkB,YAAY,SAAS,QAAQ;;;;;;;;;AAUxD,SAAgB,oBAAoB,UAAyB,SAAgC;CAC3F,MAAM,aAAa,SAAS,MAAM,KAAK,IAAI;AAC3C,KAAI,CAAC,WACH,OAAM,IAAI,MAAM,oBAAoB,QAAQ,2BAA2B,SAAS,KAAK,GAAG;AAE1F,QAAO,kBAAkB,YAAY,SAAS,QAAQ;;;;;;;AAQxD,SAAgB,wBAAwB,UAAwD;CAC9F,MAAM,SAAwC,EAAE;AAChD,MAAK,MAAM,CAAC,MAAM,eAAe,OAAO,QAAQ,SAAS,MAAM,KAAK,OAAO,CACzE,QAAO,QAAQ,kBAAkB,YAAY,SAAS,QAAQ;AAEhE,QAAO;;;;;;;AAQT,SAAgB,uBAAuB,UAAwD;CAC7F,MAAM,SAAwC,EAAE;AAChD,MAAK,MAAM,CAAC,MAAM,eAAe,OAAO,QAAQ,SAAS,MAAM,KAAK,MAAM,CACxE,QAAO,QAAQ,kBAAkB,YAAY,SAAS,QAAQ;AAEhE,QAAO;;;;;;;AAQT,SAAgB,qBAAqB,UAAwD;CAC3F,MAAM,SAAwC,EAAE;AAChD,MAAK,MAAM,CAAC,MAAM,eAAe,OAAO,QAAQ,SAAS,MAAM,KAAK,IAAI,CACtE,QAAO,QAAQ,kBAAkB,YAAY,SAAS,QAAQ;AAEhE,QAAO;;;;;;;;;AAUT,SAAgB,uBAAuB,UAAyB,SAAgC;CAC9F,MAAM,aAAa,SAAS,MAAM,KAAK,OAAO;AAC9C,KAAI,CAAC,WACH,OAAM,IAAI,MAAM,uBAAuB,QAAQ,2BAA2B,SAAS,KAAK,GAAG;AAE7F,QAAO,kBAAkB,YAAY,SAAS,QAAQ;;;;;;;;;AAUxD,SAAgB,sBAAsB,UAAyB,SAAgC;CAC7F,MAAM,aAAa,SAAS,MAAM,KAAK,MAAM;AAC7C,KAAI,CAAC,WACH,OAAM,IAAI,MAAM,sBAAsB,QAAQ,2BAA2B,SAAS,KAAK,GAAG;AAE5F,QAAO,kBAAkB,YAAY,SAAS,QAAQ;;;;;;;;;AAUxD,SAAgB,oBAAoB,UAAyB,SAAgC;CAC3F,MAAM,aAAa,SAAS,MAAM,KAAK,IAAI;AAC3C,KAAI,CAAC,WACH,OAAM,IAAI,MAAM,oBAAoB,QAAQ,2BAA2B,SAAS,KAAK,GAAG;AAE1F,QAAO,kBAAkB,YAAY,SAAS,QAAQ;;;;;;;AAQxD,SAAgB,wBAAwB,UAAwD;CAC9F,MAAM,SAAwC,EAAE;AAChD,MAAK,MAAM,CAAC,MAAM,eAAe,OAAO,QAAQ,SAAS,MAAM,KAAK,OAAO,CACzE,QAAO,QAAQ,kBAAkB,YAAY,SAAS,QAAQ;AAEhE,QAAO;;;;;;;AAQT,SAAgB,uBAAuB,UAAwD;CAC7F,MAAM,SAAwC,EAAE;AAChD,MAAK,MAAM,CAAC,MAAM,eAAe,OAAO,QAAQ,SAAS,MAAM,KAAK,MAAM,CACxE,QAAO,QAAQ,kBAAkB,YAAY,SAAS,QAAQ;AAEhE,QAAO;;;;;;;AAQT,SAAgB,qBAAqB,UAAwD;CAC3F,MAAM,SAAwC,EAAE;AAChD,MAAK,MAAM,CAAC,MAAM,eAAe,OAAO,QAAQ,SAAS,MAAM,KAAK,IAAI,CACtE,QAAO,QAAQ,kBAAkB,YAAY,SAAS,QAAQ;AAEhE,QAAO"}
+{"version":3,"file":"arc56-contract.js","names":["ABIStructType","ABIType"],"sources":["../../../../packages/abi/src/arc56-contract.ts"],"sourcesContent":["/****************/\n/** ARC-56 spec */\n/****************/\n\nimport { ABIStructType, ABIType } from './abi-type'\n\n/** Describes a single key in app storage with parsed ABI types */\nexport type ABIStorageKey = {\n  /** The bytes of the key encoded as base64 */\n  key: string\n  /** The parsed type of the key (ABI type or AVM type) */\n  keyType: ABIType | AVMType\n  /** The parsed type of the value (ABI type or AVM type) */\n  valueType: ABIType | AVMType\n  /** Description of what this storage key holds */\n  desc?: string\n}\n\n/** Describes a storage map with parsed ABI types */\nexport type ABIStorageMap = {\n  /** The parsed type of the keys in the map (ABI type or AVM type) */\n  keyType: ABIType | AVMType\n  /** The parsed type of the values in the map (ABI type or AVM type) */\n  valueType: ABIType | AVMType\n  /** Description of what the key-value pairs in this mapping hold */\n  desc?: string\n  /** The base64-encoded prefix of the map keys */\n  prefix?: string\n}\n\n/** Describes the entire contract. This type is an extension of the type described in ARC-4 */\nexport type Arc56Contract = {\n  /** The ARCs used and/or supported by this contract. All contracts implicitly support ARC4 and ARC56 */\n  arcs: number[]\n  /** A user-friendly name for the contract */\n  name: string\n  /** Optional, user-friendly description for the type */\n  desc?: string\n  /**\n   * Optional object listing the contract instances across different networks.\n   * The key is the base64 genesis hash of the network, and the value contains\n   * information about the deployed contract in the network indicated by the\n   * key. A key containing the human-readable name of the network MAY be\n   * included, but the corresponding genesis hash key MUST also be defined\n   */\n  networks?: {\n    [network: string]: {\n      /** The app ID of the deployed contract in this network */\n      appID: number\n    }\n  }\n  /** Named structs used by the application. Each struct field appears in the same order as ABI encoding. */\n  structs: { [structName: StructName]: StructField[] }\n  /** All of the methods that the contract implements */\n  methods: Arc56Method[]\n  state: {\n    /** Defines the values that should be used for GlobalNumUint, GlobalNumByteSlice, LocalNumUint, and LocalNumByteSlice when creating the application  */\n    schema: {\n      global: {\n        ints: number\n        bytes: number\n      }\n      local: {\n        ints: number\n        bytes: number\n      }\n    }\n    /** Mapping of human-readable names to StorageKey objects */\n    keys: {\n      global: { [name: string]: StorageKey }\n      local: { [name: string]: StorageKey }\n      box: { [name: string]: StorageKey }\n    }\n    /** Mapping of human-readable names to StorageMap objects */\n    maps: {\n      global: { [name: string]: StorageMap }\n      local: { [name: string]: StorageMap }\n      box: { [name: string]: StorageMap }\n    }\n  }\n  /** Supported bare actions for the contract. An action is a combination of call/create and an OnComplete */\n  bareActions: {\n    /** OnCompletes this method allows when appID === 0 */\n    create: ('NoOp' | 'OptIn' | 'DeleteApplication')[]\n    /** OnCompletes this method allows when appID !== 0 */\n    call: ('NoOp' | 'OptIn' | 'CloseOut' | 'ClearState' | 'UpdateApplication' | 'DeleteApplication')[]\n  }\n  /** Information about the TEAL programs */\n  sourceInfo?: {\n    /** Approval program information */\n    approval: ProgramSourceInfo\n    /** Clear program information */\n    clear: ProgramSourceInfo\n  }\n  /** The pre-compiled TEAL that may contain template variables. MUST be omitted if included as part of ARC23 */\n  source?: {\n    /** The approval program */\n    approval: string\n    /** The clear program */\n    clear: string\n  }\n  /** The compiled bytecode for the application. MUST be omitted if included as part of ARC23 */\n  byteCode?: {\n    /** The approval program */\n    approval: string\n    /** The clear program */\n    clear: string\n  }\n  /** Information used to get the given byteCode and/or PC values in sourceInfo. MUST be given if byteCode or PC values are present */\n  compilerInfo?: {\n    /** The name of the compiler */\n    compiler: 'algod' | 'puya'\n    /** Compiler version information */\n    compilerVersion: {\n      major: number\n      minor: number\n      patch: number\n      commitHash?: string\n    }\n  }\n  /** ARC-28 events that MAY be emitted by this contract */\n  events?: Array<Event>\n  /** A mapping of template variable names as they appear in the TEAL (not including TMPL_ prefix) to their respective types and values (if applicable) */\n  templateVariables?: {\n    [name: string]: {\n      /** The type of the template variable */\n      type: ABITypeName | AVMType | StructName\n      /** If given, the base64 encoded value used for the given app/program */\n      value?: string\n    }\n  }\n  /** The scratch variables used during runtime */\n  scratchVariables?: {\n    [name: string]: {\n      slot: number\n      type: ABITypeName | AVMType | StructName\n    }\n  }\n}\n\n/** Describes a method in the contract. This type is an extension of the type described in ARC-4 */\nexport type Arc56Method = {\n  /** The name of the method */\n  name: string\n  /** Optional, user-friendly description for the method */\n  desc?: string\n  /** The arguments of the method, in order */\n  args: Array<{\n    /** The type of the argument. The `struct` field should also be checked to determine if this arg is a struct. */\n    type: ABITypeName\n    /** If the type is a struct, the name of the struct */\n    struct?: StructName\n    /** Optional, user-friendly name for the argument */\n    name?: string\n    /** Optional, user-friendly description for the argument */\n    desc?: string\n    /** The default value that clients should use. */\n    defaultValue?: {\n      /** Base64 encoded bytes, base64 ARC4 encoded uint64, or UTF-8 method selector */\n      data: string\n      /** How the data is encoded. This is the encoding for the data provided here, not the arg type */\n      type?: ABITypeName | AVMType\n      /** Where the default value is coming from\n       * - box: The data key signifies the box key to read the value from\n       * - global: The data key signifies the global state key to read the value from\n       * - local: The data key signifies the local state key to read the value from (for the sender)\n       * - literal: the value is a literal and should be passed directly as the argument\n       * - method: The utf8 signature of the method in this contract to call to get the default value. If the method has arguments, they all must have default values. The method **MUST** be readonly so simulate can be used to get the default value\n       */\n      source: 'box' | 'global' | 'local' | 'literal' | 'method'\n    }\n  }>\n  /** Information about the method's return value */\n  returns: {\n    /** The type of the return value, or \"void\" to indicate no return value. The `struct` field should also be checked to determine if this return value is a struct. */\n    type: ABITypeName\n    /** If the type is a struct, the name of the struct */\n    struct?: StructName\n    /** Optional, user-friendly description for the return value */\n    desc?: string\n  }\n  /** an action is a combination of call/create and an OnComplete */\n  actions: {\n    /** OnCompletes this method allows when appID === 0 */\n    create: ('NoOp' | 'OptIn' | 'DeleteApplication')[]\n    /** OnCompletes this method allows when appID !== 0 */\n    call: ('NoOp' | 'OptIn' | 'CloseOut' | 'ClearState' | 'UpdateApplication' | 'DeleteApplication')[]\n  }\n  /** If this method does not write anything to the ledger (ARC-22) */\n  readonly?: boolean\n  /** ARC-28 events that MAY be emitted by this method */\n  events?: Array<Event>\n  /** Information that clients can use when calling the method */\n  recommendations?: {\n    /** The number of inner transactions the caller should cover the fees for */\n    innerTransactionCount?: number\n    /** Recommended box references to include */\n    boxes?: {\n      /** The app ID for the box */\n      app?: number\n      /** The base64 encoded box key */\n      key: string\n      /** The number of bytes being read from the box */\n      readBytes: number\n      /** The number of bytes being written to the box */\n      writeBytes: number\n    }\n    /** Recommended foreign accounts */\n    accounts?: string[]\n    /** Recommended foreign apps */\n    apps?: number[]\n    /** Recommended foreign assets */\n    assets?: number[]\n  }\n}\n\n/** ARC-28 event */\nexport type Event = {\n  /** The name of the event */\n  name: string\n  /** Optional, user-friendly description for the event */\n  desc?: string\n  /** The arguments of the event, in order */\n  args: Array<{\n    /** The type of the argument. The `struct` field should also be checked to determine if this arg is a struct. */\n    type: ABITypeName\n    /** Optional, user-friendly name for the argument */\n    name?: string\n    /** Optional, user-friendly description for the argument */\n    desc?: string\n    /** If the type is a struct, the name of the struct */\n    struct?: StructName\n  }>\n}\n\n/** An ABI-encoded type */\nexport type ABITypeName = string\n\n/** The name of a defined struct */\nexport type StructName = string\n\n/** Raw byteslice without the length prefixed that is specified in ARC-4 */\nexport type AVMBytes = 'AVMBytes'\n\n/** A utf-8 string without the length prefix that is specified in ARC-4 */\nexport type AVMString = 'AVMString'\n\n/** A 64-bit unsigned integer */\nexport type AVMUint64 = 'AVMUint64'\n\n/** A native AVM type */\nexport type AVMType = AVMBytes | AVMString | AVMUint64\n\n/** Information about a single field in a struct */\nexport type StructField = {\n  /** The name of the struct field */\n  name: string\n  /** The type of the struct field's value */\n  type: ABITypeName | StructName | StructField[]\n}\n\n/** Describes a single key in app storage */\nexport type StorageKey = {\n  /** Description of what this storage key holds */\n  desc?: string\n  /** The type of the key */\n  keyType: ABITypeName | AVMType | StructName\n\n  /** The type of the value */\n  valueType: ABITypeName | AVMType | StructName\n  /** The bytes of the key encoded as base64 */\n  key: string\n}\n\n/** Describes a mapping of key-value pairs in storage */\nexport type StorageMap = {\n  /** Description of what the key-value pairs in this mapping hold */\n  desc?: string\n  /** The type of the keys in the map */\n  keyType: ABITypeName | AVMType | StructName\n  /** The type of the values in the map */\n  valueType: ABITypeName | AVMType | StructName\n  /** The base64-encoded prefix of the map keys*/\n  prefix?: string\n}\n\ntype SourceInfo = {\n  /** The program counter value(s). Could be offset if pcOffsetMethod is not \"none\" */\n  pc: Array<number>\n  /** A human-readable string that describes the error when the program fails at the given PC */\n  errorMessage?: string\n  /** The TEAL line number that corresponds to the given PC. RECOMMENDED to be used for development purposes, but not required for clients */\n  teal?: number\n  /** The original source file and line number that corresponds to the given PC. RECOMMENDED to be used for development purposes, but not required for clients */\n  source?: string\n}\n\nexport type ProgramSourceInfo = {\n  /** The source information for the program */\n  sourceInfo: SourceInfo[]\n  /** How the program counter offset is calculated\n   * - none: The pc values in sourceInfo are not offset\n   * - cblocks: The pc values in sourceInfo are offset by the PC of the first op following the last cblock at the top of the program\n   */\n  pcOffsetMethod: 'none' | 'cblocks'\n}\n\n/*************************/\n/** Storage Helper Functions */\n/*************************/\n\n/**\n * Resolves a storage type string (ABI type, AVM type, or struct name) into an ABIType or AVMType\n * @param typeStr The type string to resolve\n * @param structs The structs defined in the contract\n * @returns The parsed ABIType or AVMType string\n */\nfunction resolveStorageType(typeStr: string, structs: Record<string, StructField[]>): ABIType | AVMType {\n  // Check if it's an AVM type\n  if (typeStr === 'AVMBytes' || typeStr === 'AVMString' || typeStr === 'AVMUint64') {\n    return typeStr as AVMType\n  }\n\n  // Check if it's a struct type\n  if (structs[typeStr]) {\n    return ABIStructType.fromStruct(typeStr, structs)\n  }\n\n  // Otherwise parse as ABI type\n  try {\n    return ABIType.from(typeStr)\n  } catch (error) {\n    throw new Error(`Failed to parse storage type '${typeStr}': ${error}`)\n  }\n}\n\n/**\n * Converts a StorageKey to an ABIStorageKey with parsed types\n * @param storageKey The storage key to convert\n * @param structs The structs defined in the contract\n * @returns The converted ABIStorageKey\n */\nfunction convertStorageKey(storageKey: StorageKey, structs: Record<string, StructField[]>): ABIStorageKey {\n  const keyType = resolveStorageType(storageKey.keyType, structs)\n  const valueType = resolveStorageType(storageKey.valueType, structs)\n\n  return {\n    key: storageKey.key,\n    keyType,\n    valueType,\n    desc: storageKey.desc,\n  }\n}\n\n/**\n * Converts a StorageMap to an ABIStorageMap with parsed types\n * @param storageMap The storage map to convert\n * @param structs The structs defined in the contract\n * @returns The converted ABIStorageMap\n */\nfunction convertStorageMap(storageMap: StorageMap, structs: Record<string, StructField[]>): ABIStorageMap {\n  const keyType = resolveStorageType(storageMap.keyType, structs)\n  const valueType = resolveStorageType(storageMap.valueType, structs)\n\n  return {\n    keyType,\n    valueType,\n    desc: storageMap.desc,\n    prefix: storageMap.prefix,\n  }\n}\n\n/**\n * Get a specific global storage key with parsed ABI types\n * @param contract The ARC-56 contract\n * @param keyName The name of the storage key\n * @returns The ABIStorageKey with parsed types\n * @throws Error if the key is not found\n */\nexport function getGlobalABIStorageKey(contract: Arc56Contract, keyName: string): ABIStorageKey {\n  const storageKey = contract.state.keys.global[keyName]\n  if (!storageKey) {\n    throw new Error(`Global storage key '${keyName}' not found in contract '${contract.name}'`)\n  }\n  return convertStorageKey(storageKey, contract.structs)\n}\n\n/**\n * Get a specific local storage key with parsed ABI types\n * @param contract The ARC-56 contract\n * @param keyName The name of the storage key\n * @returns The ABIStorageKey with parsed types\n * @throws Error if the key is not found\n */\nexport function getLocalABIStorageKey(contract: Arc56Contract, keyName: string): ABIStorageKey {\n  const storageKey = contract.state.keys.local[keyName]\n  if (!storageKey) {\n    throw new Error(`Local storage key '${keyName}' not found in contract '${contract.name}'`)\n  }\n  return convertStorageKey(storageKey, contract.structs)\n}\n\n/**\n * Get a specific box storage key with parsed ABI types\n * @param contract The ARC-56 contract\n * @param keyName The name of the storage key\n * @returns The ABIStorageKey with parsed types\n * @throws Error if the key is not found\n */\nexport function getBoxABIStorageKey(contract: Arc56Contract, keyName: string): ABIStorageKey {\n  const storageKey = contract.state.keys.box[keyName]\n  if (!storageKey) {\n    throw new Error(`Box storage key '${keyName}' not found in contract '${contract.name}'`)\n  }\n  return convertStorageKey(storageKey, contract.structs)\n}\n\n/**\n * Get all global storage keys with parsed ABI types\n * @param contract The ARC-56 contract\n * @returns A record of storage key names to ABIStorageKey objects\n */\nexport function getGlobalABIStorageKeys(contract: Arc56Contract): Record<string, ABIStorageKey> {\n  const result: Record<string, ABIStorageKey> = {}\n  for (const [name, storageKey] of Object.entries(contract.state.keys.global)) {\n    result[name] = convertStorageKey(storageKey, contract.structs)\n  }\n  return result\n}\n\n/**\n * Get all local storage keys with parsed ABI types\n * @param contract The ARC-56 contract\n * @returns A record of storage key names to ABIStorageKey objects\n */\nexport function getLocalABIStorageKeys(contract: Arc56Contract): Record<string, ABIStorageKey> {\n  const result: Record<string, ABIStorageKey> = {}\n  for (const [name, storageKey] of Object.entries(contract.state.keys.local)) {\n    result[name] = convertStorageKey(storageKey, contract.structs)\n  }\n  return result\n}\n\n/**\n * Get all box storage keys with parsed ABI types\n * @param contract The ARC-56 contract\n * @returns A record of storage key names to ABIStorageKey objects\n */\nexport function getBoxABIStorageKeys(contract: Arc56Contract): Record<string, ABIStorageKey> {\n  const result: Record<string, ABIStorageKey> = {}\n  for (const [name, storageKey] of Object.entries(contract.state.keys.box)) {\n    result[name] = convertStorageKey(storageKey, contract.structs)\n  }\n  return result\n}\n\n/**\n * Get a specific global storage map with parsed ABI types\n * @param contract The ARC-56 contract\n * @param mapName The name of the storage map\n * @returns The ABIStorageMap with parsed types\n * @throws Error if the map is not found\n */\nexport function getGlobalABIStorageMap(contract: Arc56Contract, mapName: string): ABIStorageMap {\n  const storageMap = contract.state.maps.global[mapName]\n  if (!storageMap) {\n    throw new Error(`Global storage map '${mapName}' not found in contract '${contract.name}'`)\n  }\n  return convertStorageMap(storageMap, contract.structs)\n}\n\n/**\n * Get a specific local storage map with parsed ABI types\n * @param contract The ARC-56 contract\n * @param mapName The name of the storage map\n * @returns The ABIStorageMap with parsed types\n * @throws Error if the map is not found\n */\nexport function getLocalABIStorageMap(contract: Arc56Contract, mapName: string): ABIStorageMap {\n  const storageMap = contract.state.maps.local[mapName]\n  if (!storageMap) {\n    throw new Error(`Local storage map '${mapName}' not found in contract '${contract.name}'`)\n  }\n  return convertStorageMap(storageMap, contract.structs)\n}\n\n/**\n * Get a specific box storage map with parsed ABI types\n * @param contract The ARC-56 contract\n * @param mapName The name of the storage map\n * @returns The ABIStorageMap with parsed types\n * @throws Error if the map is not found\n */\nexport function getBoxABIStorageMap(contract: Arc56Contract, mapName: string): ABIStorageMap {\n  const storageMap = contract.state.maps.box[mapName]\n  if (!storageMap) {\n    throw new Error(`Box storage map '${mapName}' not found in contract '${contract.name}'`)\n  }\n  return convertStorageMap(storageMap, contract.structs)\n}\n\n/**\n * Get all global storage maps with parsed ABI types\n * @param contract The ARC-56 contract\n * @returns A record of storage map names to ABIStorageMap objects\n */\nexport function getGlobalABIStorageMaps(contract: Arc56Contract): Record<string, ABIStorageMap> {\n  const result: Record<string, ABIStorageMap> = {}\n  for (const [name, storageMap] of Object.entries(contract.state.maps.global)) {\n    result[name] = convertStorageMap(storageMap, contract.structs)\n  }\n  return result\n}\n\n/**\n * Get all local storage maps with parsed ABI types\n * @param contract The ARC-56 contract\n * @returns A record of storage map names to ABIStorageMap objects\n */\nexport function getLocalABIStorageMaps(contract: Arc56Contract): Record<string, ABIStorageMap> {\n  const result: Record<string, ABIStorageMap> = {}\n  for (const [name, storageMap] of Object.entries(contract.state.maps.local)) {\n    result[name] = convertStorageMap(storageMap, contract.structs)\n  }\n  return result\n}\n\n/**\n * Get all box storage maps with parsed ABI types\n * @param contract The ARC-56 contract\n * @returns A record of storage map names to ABIStorageMap objects\n */\nexport function getBoxABIStorageMaps(contract: Arc56Contract): Record<string, ABIStorageMap> {\n  const result: Record<string, ABIStorageMap> = {}\n  for (const [name, storageMap] of Object.entries(contract.state.maps.box)) {\n    result[name] = convertStorageMap(storageMap, contract.structs)\n  }\n  return result\n}\n"],"mappings":"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"}

package/packages/abi/src/arc56-contract.mjs

@@ -1,5 +1,4 @@
 import { ABIStructType, ABIType } from "./abi-type.mjs";
-
 //#region packages/abi/src/arc56-contract.ts
 /** ARC-56 spec */
 /** Storage Helper Functions */
@@ -180,7 +179,7 @@ function getBoxABIStorageMaps(contract) {
 	for (const [name, storageMap] of Object.entries(contract.state.maps.box)) result[name] = convertStorageMap(storageMap, contract.structs);
 	return result;
 }
-
 //#endregion
 export { getBoxABIStorageKey, getBoxABIStorageKeys, getBoxABIStorageMap, getBoxABIStorageMaps, getGlobalABIStorageKey, getGlobalABIStorageKeys, getGlobalABIStorageMap, getGlobalABIStorageMaps, getLocalABIStorageKey, getLocalABIStorageKeys, getLocalABIStorageMap, getLocalABIStorageMaps };
+
 //# sourceMappingURL=arc56-contract.mjs.map

package/packages/abi/src/arc56-contract.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"arc56-contract.mjs","names":[],"sources":["../../../../packages/abi/src/arc56-contract.ts"],"sourcesContent":["/****************/\n/** ARC-56 spec */\n/****************/\n\nimport { ABIStructType, ABIType } from './abi-type'\n\n/** Describes a single key in app storage with parsed ABI types */\nexport type ABIStorageKey = {\n  /** The bytes of the key encoded as base64 */\n  key: string\n  /** The parsed type of the key (ABI type or AVM type) */\n  keyType: ABIType | AVMType\n  /** The parsed type of the value (ABI type or AVM type) */\n  valueType: ABIType | AVMType\n  /** Description of what this storage key holds */\n  desc?: string\n}\n\n/** Describes a storage map with parsed ABI types */\nexport type ABIStorageMap = {\n  /** The parsed type of the keys in the map (ABI type or AVM type) */\n  keyType: ABIType | AVMType\n  /** The parsed type of the values in the map (ABI type or AVM type) */\n  valueType: ABIType | AVMType\n  /** Description of what the key-value pairs in this mapping hold */\n  desc?: string\n  /** The base64-encoded prefix of the map keys */\n  prefix?: string\n}\n\n/** Describes the entire contract. This type is an extension of the type described in ARC-4 */\nexport type Arc56Contract = {\n  /** The ARCs used and/or supported by this contract. All contracts implicitly support ARC4 and ARC56 */\n  arcs: number[]\n  /** A user-friendly name for the contract */\n  name: string\n  /** Optional, user-friendly description for the type */\n  desc?: string\n  /**\n   * Optional object listing the contract instances across different networks.\n   * The key is the base64 genesis hash of the network, and the value contains\n   * information about the deployed contract in the network indicated by the\n   * key. A key containing the human-readable name of the network MAY be\n   * included, but the corresponding genesis hash key MUST also be defined\n   */\n  networks?: {\n    [network: string]: {\n      /** The app ID of the deployed contract in this network */\n      appID: number\n    }\n  }\n  /** Named structs used by the application. Each struct field appears in the same order as ABI encoding. */\n  structs: { [structName: StructName]: StructField[] }\n  /** All of the methods that the contract implements */\n  methods: Arc56Method[]\n  state: {\n    /** Defines the values that should be used for GlobalNumUint, GlobalNumByteSlice, LocalNumUint, and LocalNumByteSlice when creating the application  */\n    schema: {\n      global: {\n        ints: number\n        bytes: number\n      }\n      local: {\n        ints: number\n        bytes: number\n      }\n    }\n    /** Mapping of human-readable names to StorageKey objects */\n    keys: {\n      global: { [name: string]: StorageKey }\n      local: { [name: string]: StorageKey }\n      box: { [name: string]: StorageKey }\n    }\n    /** Mapping of human-readable names to StorageMap objects */\n    maps: {\n      global: { [name: string]: StorageMap }\n      local: { [name: string]: StorageMap }\n      box: { [name: string]: StorageMap }\n    }\n  }\n  /** Supported bare actions for the contract. An action is a combination of call/create and an OnComplete */\n  bareActions: {\n    /** OnCompletes this method allows when appID === 0 */\n    create: ('NoOp' | 'OptIn' | 'DeleteApplication')[]\n    /** OnCompletes this method allows when appID !== 0 */\n    call: ('NoOp' | 'OptIn' | 'CloseOut' | 'ClearState' | 'UpdateApplication' | 'DeleteApplication')[]\n  }\n  /** Information about the TEAL programs */\n  sourceInfo?: {\n    /** Approval program information */\n    approval: ProgramSourceInfo\n    /** Clear program information */\n    clear: ProgramSourceInfo\n  }\n  /** The pre-compiled TEAL that may contain template variables. MUST be omitted if included as part of ARC23 */\n  source?: {\n    /** The approval program */\n    approval: string\n    /** The clear program */\n    clear: string\n  }\n  /** The compiled bytecode for the application. MUST be omitted if included as part of ARC23 */\n  byteCode?: {\n    /** The approval program */\n    approval: string\n    /** The clear program */\n    clear: string\n  }\n  /** Information used to get the given byteCode and/or PC values in sourceInfo. MUST be given if byteCode or PC values are present */\n  compilerInfo?: {\n    /** The name of the compiler */\n    compiler: 'algod' | 'puya'\n    /** Compiler version information */\n    compilerVersion: {\n      major: number\n      minor: number\n      patch: number\n      commitHash?: string\n    }\n  }\n  /** ARC-28 events that MAY be emitted by this contract */\n  events?: Array<Event>\n  /** A mapping of template variable names as they appear in the TEAL (not including TMPL_ prefix) to their respective types and values (if applicable) */\n  templateVariables?: {\n    [name: string]: {\n      /** The type of the template variable */\n      type: ABITypeName | AVMType | StructName\n      /** If given, the base64 encoded value used for the given app/program */\n      value?: string\n    }\n  }\n  /** The scratch variables used during runtime */\n  scratchVariables?: {\n    [name: string]: {\n      slot: number\n      type: ABITypeName | AVMType | StructName\n    }\n  }\n}\n\n/** Describes a method in the contract. This type is an extension of the type described in ARC-4 */\nexport type Arc56Method = {\n  /** The name of the method */\n  name: string\n  /** Optional, user-friendly description for the method */\n  desc?: string\n  /** The arguments of the method, in order */\n  args: Array<{\n    /** The type of the argument. The `struct` field should also be checked to determine if this arg is a struct. */\n    type: ABITypeName\n    /** If the type is a struct, the name of the struct */\n    struct?: StructName\n    /** Optional, user-friendly name for the argument */\n    name?: string\n    /** Optional, user-friendly description for the argument */\n    desc?: string\n    /** The default value that clients should use. */\n    defaultValue?: {\n      /** Base64 encoded bytes, base64 ARC4 encoded uint64, or UTF-8 method selector */\n      data: string\n      /** How the data is encoded. This is the encoding for the data provided here, not the arg type */\n      type?: ABITypeName | AVMType\n      /** Where the default value is coming from\n       * - box: The data key signifies the box key to read the value from\n       * - global: The data key signifies the global state key to read the value from\n       * - local: The data key signifies the local state key to read the value from (for the sender)\n       * - literal: the value is a literal and should be passed directly as the argument\n       * - method: The utf8 signature of the method in this contract to call to get the default value. If the method has arguments, they all must have default values. The method **MUST** be readonly so simulate can be used to get the default value\n       */\n      source: 'box' | 'global' | 'local' | 'literal' | 'method'\n    }\n  }>\n  /** Information about the method's return value */\n  returns: {\n    /** The type of the return value, or \"void\" to indicate no return value. The `struct` field should also be checked to determine if this return value is a struct. */\n    type: ABITypeName\n    /** If the type is a struct, the name of the struct */\n    struct?: StructName\n    /** Optional, user-friendly description for the return value */\n    desc?: string\n  }\n  /** an action is a combination of call/create and an OnComplete */\n  actions: {\n    /** OnCompletes this method allows when appID === 0 */\n    create: ('NoOp' | 'OptIn' | 'DeleteApplication')[]\n    /** OnCompletes this method allows when appID !== 0 */\n    call: ('NoOp' | 'OptIn' | 'CloseOut' | 'ClearState' | 'UpdateApplication' | 'DeleteApplication')[]\n  }\n  /** If this method does not write anything to the ledger (ARC-22) */\n  readonly?: boolean\n  /** ARC-28 events that MAY be emitted by this method */\n  events?: Array<Event>\n  /** Information that clients can use when calling the method */\n  recommendations?: {\n    /** The number of inner transactions the caller should cover the fees for */\n    innerTransactionCount?: number\n    /** Recommended box references to include */\n    boxes?: {\n      /** The app ID for the box */\n      app?: number\n      /** The base64 encoded box key */\n      key: string\n      /** The number of bytes being read from the box */\n      readBytes: number\n      /** The number of bytes being written to the box */\n      writeBytes: number\n    }\n    /** Recommended foreign accounts */\n    accounts?: string[]\n    /** Recommended foreign apps */\n    apps?: number[]\n    /** Recommended foreign assets */\n    assets?: number[]\n  }\n}\n\n/** ARC-28 event */\nexport type Event = {\n  /** The name of the event */\n  name: string\n  /** Optional, user-friendly description for the event */\n  desc?: string\n  /** The arguments of the event, in order */\n  args: Array<{\n    /** The type of the argument. The `struct` field should also be checked to determine if this arg is a struct. */\n    type: ABITypeName\n    /** Optional, user-friendly name for the argument */\n    name?: string\n    /** Optional, user-friendly description for the argument */\n    desc?: string\n    /** If the type is a struct, the name of the struct */\n    struct?: StructName\n  }>\n}\n\n/** An ABI-encoded type */\nexport type ABITypeName = string\n\n/** The name of a defined struct */\nexport type StructName = string\n\n/** Raw byteslice without the length prefixed that is specified in ARC-4 */\nexport type AVMBytes = 'AVMBytes'\n\n/** A utf-8 string without the length prefix that is specified in ARC-4 */\nexport type AVMString = 'AVMString'\n\n/** A 64-bit unsigned integer */\nexport type AVMUint64 = 'AVMUint64'\n\n/** A native AVM type */\nexport type AVMType = AVMBytes | AVMString | AVMUint64\n\n/** Information about a single field in a struct */\nexport type StructField = {\n  /** The name of the struct field */\n  name: string\n  /** The type of the struct field's value */\n  type: ABITypeName | StructName | StructField[]\n}\n\n/** Describes a single key in app storage */\nexport type StorageKey = {\n  /** Description of what this storage key holds */\n  desc?: string\n  /** The type of the key */\n  keyType: ABITypeName | AVMType | StructName\n\n  /** The type of the value */\n  valueType: ABITypeName | AVMType | StructName\n  /** The bytes of the key encoded as base64 */\n  key: string\n}\n\n/** Describes a mapping of key-value pairs in storage */\nexport type StorageMap = {\n  /** Description of what the key-value pairs in this mapping hold */\n  desc?: string\n  /** The type of the keys in the map */\n  keyType: ABITypeName | AVMType | StructName\n  /** The type of the values in the map */\n  valueType: ABITypeName | AVMType | StructName\n  /** The base64-encoded prefix of the map keys*/\n  prefix?: string\n}\n\ntype SourceInfo = {\n  /** The program counter value(s). Could be offset if pcOffsetMethod is not \"none\" */\n  pc: Array<number>\n  /** A human-readable string that describes the error when the program fails at the given PC */\n  errorMessage?: string\n  /** The TEAL line number that corresponds to the given PC. RECOMMENDED to be used for development purposes, but not required for clients */\n  teal?: number\n  /** The original source file and line number that corresponds to the given PC. RECOMMENDED to be used for development purposes, but not required for clients */\n  source?: string\n}\n\nexport type ProgramSourceInfo = {\n  /** The source information for the program */\n  sourceInfo: SourceInfo[]\n  /** How the program counter offset is calculated\n   * - none: The pc values in sourceInfo are not offset\n   * - cblocks: The pc values in sourceInfo are offset by the PC of the first op following the last cblock at the top of the program\n   */\n  pcOffsetMethod: 'none' | 'cblocks'\n}\n\n/*************************/\n/** Storage Helper Functions */\n/*************************/\n\n/**\n * Resolves a storage type string (ABI type, AVM type, or struct name) into an ABIType or AVMType\n * @param typeStr The type string to resolve\n * @param structs The structs defined in the contract\n * @returns The parsed ABIType or AVMType string\n */\nfunction resolveStorageType(typeStr: string, structs: Record<string, StructField[]>): ABIType | AVMType {\n  // Check if it's an AVM type\n  if (typeStr === 'AVMBytes' || typeStr === 'AVMString' || typeStr === 'AVMUint64') {\n    return typeStr as AVMType\n  }\n\n  // Check if it's a struct type\n  if (structs[typeStr]) {\n    return ABIStructType.fromStruct(typeStr, structs)\n  }\n\n  // Otherwise parse as ABI type\n  try {\n    return ABIType.from(typeStr)\n  } catch (error) {\n    throw new Error(`Failed to parse storage type '${typeStr}': ${error}`)\n  }\n}\n\n/**\n * Converts a StorageKey to an ABIStorageKey with parsed types\n * @param storageKey The storage key to convert\n * @param structs The structs defined in the contract\n * @returns The converted ABIStorageKey\n */\nfunction convertStorageKey(storageKey: StorageKey, structs: Record<string, StructField[]>): ABIStorageKey {\n  const keyType = resolveStorageType(storageKey.keyType, structs)\n  const valueType = resolveStorageType(storageKey.valueType, structs)\n\n  return {\n    key: storageKey.key,\n    keyType,\n    valueType,\n    desc: storageKey.desc,\n  }\n}\n\n/**\n * Converts a StorageMap to an ABIStorageMap with parsed types\n * @param storageMap The storage map to convert\n * @param structs The structs defined in the contract\n * @returns The converted ABIStorageMap\n */\nfunction convertStorageMap(storageMap: StorageMap, structs: Record<string, StructField[]>): ABIStorageMap {\n  const keyType = resolveStorageType(storageMap.keyType, structs)\n  const valueType = resolveStorageType(storageMap.valueType, structs)\n\n  return {\n    keyType,\n    valueType,\n    desc: storageMap.desc,\n    prefix: storageMap.prefix,\n  }\n}\n\n/**\n * Get a specific global storage key with parsed ABI types\n * @param contract The ARC-56 contract\n * @param keyName The name of the storage key\n * @returns The ABIStorageKey with parsed types\n * @throws Error if the key is not found\n */\nexport function getGlobalABIStorageKey(contract: Arc56Contract, keyName: string): ABIStorageKey {\n  const storageKey = contract.state.keys.global[keyName]\n  if (!storageKey) {\n    throw new Error(`Global storage key '${keyName}' not found in contract '${contract.name}'`)\n  }\n  return convertStorageKey(storageKey, contract.structs)\n}\n\n/**\n * Get a specific local storage key with parsed ABI types\n * @param contract The ARC-56 contract\n * @param keyName The name of the storage key\n * @returns The ABIStorageKey with parsed types\n * @throws Error if the key is not found\n */\nexport function getLocalABIStorageKey(contract: Arc56Contract, keyName: string): ABIStorageKey {\n  const storageKey = contract.state.keys.local[keyName]\n  if (!storageKey) {\n    throw new Error(`Local storage key '${keyName}' not found in contract '${contract.name}'`)\n  }\n  return convertStorageKey(storageKey, contract.structs)\n}\n\n/**\n * Get a specific box storage key with parsed ABI types\n * @param contract The ARC-56 contract\n * @param keyName The name of the storage key\n * @returns The ABIStorageKey with parsed types\n * @throws Error if the key is not found\n */\nexport function getBoxABIStorageKey(contract: Arc56Contract, keyName: string): ABIStorageKey {\n  const storageKey = contract.state.keys.box[keyName]\n  if (!storageKey) {\n    throw new Error(`Box storage key '${keyName}' not found in contract '${contract.name}'`)\n  }\n  return convertStorageKey(storageKey, contract.structs)\n}\n\n/**\n * Get all global storage keys with parsed ABI types\n * @param contract The ARC-56 contract\n * @returns A record of storage key names to ABIStorageKey objects\n */\nexport function getGlobalABIStorageKeys(contract: Arc56Contract): Record<string, ABIStorageKey> {\n  const result: Record<string, ABIStorageKey> = {}\n  for (const [name, storageKey] of Object.entries(contract.state.keys.global)) {\n    result[name] = convertStorageKey(storageKey, contract.structs)\n  }\n  return result\n}\n\n/**\n * Get all local storage keys with parsed ABI types\n * @param contract The ARC-56 contract\n * @returns A record of storage key names to ABIStorageKey objects\n */\nexport function getLocalABIStorageKeys(contract: Arc56Contract): Record<string, ABIStorageKey> {\n  const result: Record<string, ABIStorageKey> = {}\n  for (const [name, storageKey] of Object.entries(contract.state.keys.local)) {\n    result[name] = convertStorageKey(storageKey, contract.structs)\n  }\n  return result\n}\n\n/**\n * Get all box storage keys with parsed ABI types\n * @param contract The ARC-56 contract\n * @returns A record of storage key names to ABIStorageKey objects\n */\nexport function getBoxABIStorageKeys(contract: Arc56Contract): Record<string, ABIStorageKey> {\n  const result: Record<string, ABIStorageKey> = {}\n  for (const [name, storageKey] of Object.entries(contract.state.keys.box)) {\n    result[name] = convertStorageKey(storageKey, contract.structs)\n  }\n  return result\n}\n\n/**\n * Get a specific global storage map with parsed ABI types\n * @param contract The ARC-56 contract\n * @param mapName The name of the storage map\n * @returns The ABIStorageMap with parsed types\n * @throws Error if the map is not found\n */\nexport function getGlobalABIStorageMap(contract: Arc56Contract, mapName: string): ABIStorageMap {\n  const storageMap = contract.state.maps.global[mapName]\n  if (!storageMap) {\n    throw new Error(`Global storage map '${mapName}' not found in contract '${contract.name}'`)\n  }\n  return convertStorageMap(storageMap, contract.structs)\n}\n\n/**\n * Get a specific local storage map with parsed ABI types\n * @param contract The ARC-56 contract\n * @param mapName The name of the storage map\n * @returns The ABIStorageMap with parsed types\n * @throws Error if the map is not found\n */\nexport function getLocalABIStorageMap(contract: Arc56Contract, mapName: string): ABIStorageMap {\n  const storageMap = contract.state.maps.local[mapName]\n  if (!storageMap) {\n    throw new Error(`Local storage map '${mapName}' not found in contract '${contract.name}'`)\n  }\n  return convertStorageMap(storageMap, contract.structs)\n}\n\n/**\n * Get a specific box storage map with parsed ABI types\n * @param contract The ARC-56 contract\n * @param mapName The name of the storage map\n * @returns The ABIStorageMap with parsed types\n * @throws Error if the map is not found\n */\nexport function getBoxABIStorageMap(contract: Arc56Contract, mapName: string): ABIStorageMap {\n  const storageMap = contract.state.maps.box[mapName]\n  if (!storageMap) {\n    throw new Error(`Box storage map '${mapName}' not found in contract '${contract.name}'`)\n  }\n  return convertStorageMap(storageMap, contract.structs)\n}\n\n/**\n * Get all global storage maps with parsed ABI types\n * @param contract The ARC-56 contract\n * @returns A record of storage map names to ABIStorageMap objects\n */\nexport function getGlobalABIStorageMaps(contract: Arc56Contract): Record<string, ABIStorageMap> {\n  const result: Record<string, ABIStorageMap> = {}\n  for (const [name, storageMap] of Object.entries(contract.state.maps.global)) {\n    result[name] = convertStorageMap(storageMap, contract.structs)\n  }\n  return result\n}\n\n/**\n * Get all local storage maps with parsed ABI types\n * @param contract The ARC-56 contract\n * @returns A record of storage map names to ABIStorageMap objects\n */\nexport function getLocalABIStorageMaps(contract: Arc56Contract): Record<string, ABIStorageMap> {\n  const result: Record<string, ABIStorageMap> = {}\n  for (const [name, storageMap] of Object.entries(contract.state.maps.local)) {\n    result[name] = convertStorageMap(storageMap, contract.structs)\n  }\n  return result\n}\n\n/**\n * Get all box storage maps with parsed ABI types\n * @param contract The ARC-56 contract\n * @returns A record of storage map names to ABIStorageMap objects\n */\nexport function getBoxABIStorageMaps(contract: Arc56Contract): Record<string, ABIStorageMap> {\n  const result: Record<string, ABIStorageMap> = {}\n  for (const [name, storageMap] of Object.entries(contract.state.maps.box)) {\n    result[name] = convertStorageMap(storageMap, contract.structs)\n  }\n  return result\n}\n"],"mappings":"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"}
+{"version":3,"file":"arc56-contract.mjs","names":[],"sources":["../../../../packages/abi/src/arc56-contract.ts"],"sourcesContent":["/****************/\n/** ARC-56 spec */\n/****************/\n\nimport { ABIStructType, ABIType } from './abi-type'\n\n/** Describes a single key in app storage with parsed ABI types */\nexport type ABIStorageKey = {\n  /** The bytes of the key encoded as base64 */\n  key: string\n  /** The parsed type of the key (ABI type or AVM type) */\n  keyType: ABIType | AVMType\n  /** The parsed type of the value (ABI type or AVM type) */\n  valueType: ABIType | AVMType\n  /** Description of what this storage key holds */\n  desc?: string\n}\n\n/** Describes a storage map with parsed ABI types */\nexport type ABIStorageMap = {\n  /** The parsed type of the keys in the map (ABI type or AVM type) */\n  keyType: ABIType | AVMType\n  /** The parsed type of the values in the map (ABI type or AVM type) */\n  valueType: ABIType | AVMType\n  /** Description of what the key-value pairs in this mapping hold */\n  desc?: string\n  /** The base64-encoded prefix of the map keys */\n  prefix?: string\n}\n\n/** Describes the entire contract. This type is an extension of the type described in ARC-4 */\nexport type Arc56Contract = {\n  /** The ARCs used and/or supported by this contract. All contracts implicitly support ARC4 and ARC56 */\n  arcs: number[]\n  /** A user-friendly name for the contract */\n  name: string\n  /** Optional, user-friendly description for the type */\n  desc?: string\n  /**\n   * Optional object listing the contract instances across different networks.\n   * The key is the base64 genesis hash of the network, and the value contains\n   * information about the deployed contract in the network indicated by the\n   * key. A key containing the human-readable name of the network MAY be\n   * included, but the corresponding genesis hash key MUST also be defined\n   */\n  networks?: {\n    [network: string]: {\n      /** The app ID of the deployed contract in this network */\n      appID: number\n    }\n  }\n  /** Named structs used by the application. Each struct field appears in the same order as ABI encoding. */\n  structs: { [structName: StructName]: StructField[] }\n  /** All of the methods that the contract implements */\n  methods: Arc56Method[]\n  state: {\n    /** Defines the values that should be used for GlobalNumUint, GlobalNumByteSlice, LocalNumUint, and LocalNumByteSlice when creating the application  */\n    schema: {\n      global: {\n        ints: number\n        bytes: number\n      }\n      local: {\n        ints: number\n        bytes: number\n      }\n    }\n    /** Mapping of human-readable names to StorageKey objects */\n    keys: {\n      global: { [name: string]: StorageKey }\n      local: { [name: string]: StorageKey }\n      box: { [name: string]: StorageKey }\n    }\n    /** Mapping of human-readable names to StorageMap objects */\n    maps: {\n      global: { [name: string]: StorageMap }\n      local: { [name: string]: StorageMap }\n      box: { [name: string]: StorageMap }\n    }\n  }\n  /** Supported bare actions for the contract. An action is a combination of call/create and an OnComplete */\n  bareActions: {\n    /** OnCompletes this method allows when appID === 0 */\n    create: ('NoOp' | 'OptIn' | 'DeleteApplication')[]\n    /** OnCompletes this method allows when appID !== 0 */\n    call: ('NoOp' | 'OptIn' | 'CloseOut' | 'ClearState' | 'UpdateApplication' | 'DeleteApplication')[]\n  }\n  /** Information about the TEAL programs */\n  sourceInfo?: {\n    /** Approval program information */\n    approval: ProgramSourceInfo\n    /** Clear program information */\n    clear: ProgramSourceInfo\n  }\n  /** The pre-compiled TEAL that may contain template variables. MUST be omitted if included as part of ARC23 */\n  source?: {\n    /** The approval program */\n    approval: string\n    /** The clear program */\n    clear: string\n  }\n  /** The compiled bytecode for the application. MUST be omitted if included as part of ARC23 */\n  byteCode?: {\n    /** The approval program */\n    approval: string\n    /** The clear program */\n    clear: string\n  }\n  /** Information used to get the given byteCode and/or PC values in sourceInfo. MUST be given if byteCode or PC values are present */\n  compilerInfo?: {\n    /** The name of the compiler */\n    compiler: 'algod' | 'puya'\n    /** Compiler version information */\n    compilerVersion: {\n      major: number\n      minor: number\n      patch: number\n      commitHash?: string\n    }\n  }\n  /** ARC-28 events that MAY be emitted by this contract */\n  events?: Array<Event>\n  /** A mapping of template variable names as they appear in the TEAL (not including TMPL_ prefix) to their respective types and values (if applicable) */\n  templateVariables?: {\n    [name: string]: {\n      /** The type of the template variable */\n      type: ABITypeName | AVMType | StructName\n      /** If given, the base64 encoded value used for the given app/program */\n      value?: string\n    }\n  }\n  /** The scratch variables used during runtime */\n  scratchVariables?: {\n    [name: string]: {\n      slot: number\n      type: ABITypeName | AVMType | StructName\n    }\n  }\n}\n\n/** Describes a method in the contract. This type is an extension of the type described in ARC-4 */\nexport type Arc56Method = {\n  /** The name of the method */\n  name: string\n  /** Optional, user-friendly description for the method */\n  desc?: string\n  /** The arguments of the method, in order */\n  args: Array<{\n    /** The type of the argument. The `struct` field should also be checked to determine if this arg is a struct. */\n    type: ABITypeName\n    /** If the type is a struct, the name of the struct */\n    struct?: StructName\n    /** Optional, user-friendly name for the argument */\n    name?: string\n    /** Optional, user-friendly description for the argument */\n    desc?: string\n    /** The default value that clients should use. */\n    defaultValue?: {\n      /** Base64 encoded bytes, base64 ARC4 encoded uint64, or UTF-8 method selector */\n      data: string\n      /** How the data is encoded. This is the encoding for the data provided here, not the arg type */\n      type?: ABITypeName | AVMType\n      /** Where the default value is coming from\n       * - box: The data key signifies the box key to read the value from\n       * - global: The data key signifies the global state key to read the value from\n       * - local: The data key signifies the local state key to read the value from (for the sender)\n       * - literal: the value is a literal and should be passed directly as the argument\n       * - method: The utf8 signature of the method in this contract to call to get the default value. If the method has arguments, they all must have default values. The method **MUST** be readonly so simulate can be used to get the default value\n       */\n      source: 'box' | 'global' | 'local' | 'literal' | 'method'\n    }\n  }>\n  /** Information about the method's return value */\n  returns: {\n    /** The type of the return value, or \"void\" to indicate no return value. The `struct` field should also be checked to determine if this return value is a struct. */\n    type: ABITypeName\n    /** If the type is a struct, the name of the struct */\n    struct?: StructName\n    /** Optional, user-friendly description for the return value */\n    desc?: string\n  }\n  /** an action is a combination of call/create and an OnComplete */\n  actions: {\n    /** OnCompletes this method allows when appID === 0 */\n    create: ('NoOp' | 'OptIn' | 'DeleteApplication')[]\n    /** OnCompletes this method allows when appID !== 0 */\n    call: ('NoOp' | 'OptIn' | 'CloseOut' | 'ClearState' | 'UpdateApplication' | 'DeleteApplication')[]\n  }\n  /** If this method does not write anything to the ledger (ARC-22) */\n  readonly?: boolean\n  /** ARC-28 events that MAY be emitted by this method */\n  events?: Array<Event>\n  /** Information that clients can use when calling the method */\n  recommendations?: {\n    /** The number of inner transactions the caller should cover the fees for */\n    innerTransactionCount?: number\n    /** Recommended box references to include */\n    boxes?: {\n      /** The app ID for the box */\n      app?: number\n      /** The base64 encoded box key */\n      key: string\n      /** The number of bytes being read from the box */\n      readBytes: number\n      /** The number of bytes being written to the box */\n      writeBytes: number\n    }\n    /** Recommended foreign accounts */\n    accounts?: string[]\n    /** Recommended foreign apps */\n    apps?: number[]\n    /** Recommended foreign assets */\n    assets?: number[]\n  }\n}\n\n/** ARC-28 event */\nexport type Event = {\n  /** The name of the event */\n  name: string\n  /** Optional, user-friendly description for the event */\n  desc?: string\n  /** The arguments of the event, in order */\n  args: Array<{\n    /** The type of the argument. The `struct` field should also be checked to determine if this arg is a struct. */\n    type: ABITypeName\n    /** Optional, user-friendly name for the argument */\n    name?: string\n    /** Optional, user-friendly description for the argument */\n    desc?: string\n    /** If the type is a struct, the name of the struct */\n    struct?: StructName\n  }>\n}\n\n/** An ABI-encoded type */\nexport type ABITypeName = string\n\n/** The name of a defined struct */\nexport type StructName = string\n\n/** Raw byteslice without the length prefixed that is specified in ARC-4 */\nexport type AVMBytes = 'AVMBytes'\n\n/** A utf-8 string without the length prefix that is specified in ARC-4 */\nexport type AVMString = 'AVMString'\n\n/** A 64-bit unsigned integer */\nexport type AVMUint64 = 'AVMUint64'\n\n/** A native AVM type */\nexport type AVMType = AVMBytes | AVMString | AVMUint64\n\n/** Information about a single field in a struct */\nexport type StructField = {\n  /** The name of the struct field */\n  name: string\n  /** The type of the struct field's value */\n  type: ABITypeName | StructName | StructField[]\n}\n\n/** Describes a single key in app storage */\nexport type StorageKey = {\n  /** Description of what this storage key holds */\n  desc?: string\n  /** The type of the key */\n  keyType: ABITypeName | AVMType | StructName\n\n  /** The type of the value */\n  valueType: ABITypeName | AVMType | StructName\n  /** The bytes of the key encoded as base64 */\n  key: string\n}\n\n/** Describes a mapping of key-value pairs in storage */\nexport type StorageMap = {\n  /** Description of what the key-value pairs in this mapping hold */\n  desc?: string\n  /** The type of the keys in the map */\n  keyType: ABITypeName | AVMType | StructName\n  /** The type of the values in the map */\n  valueType: ABITypeName | AVMType | StructName\n  /** The base64-encoded prefix of the map keys*/\n  prefix?: string\n}\n\ntype SourceInfo = {\n  /** The program counter value(s). Could be offset if pcOffsetMethod is not \"none\" */\n  pc: Array<number>\n  /** A human-readable string that describes the error when the program fails at the given PC */\n  errorMessage?: string\n  /** The TEAL line number that corresponds to the given PC. RECOMMENDED to be used for development purposes, but not required for clients */\n  teal?: number\n  /** The original source file and line number that corresponds to the given PC. RECOMMENDED to be used for development purposes, but not required for clients */\n  source?: string\n}\n\nexport type ProgramSourceInfo = {\n  /** The source information for the program */\n  sourceInfo: SourceInfo[]\n  /** How the program counter offset is calculated\n   * - none: The pc values in sourceInfo are not offset\n   * - cblocks: The pc values in sourceInfo are offset by the PC of the first op following the last cblock at the top of the program\n   */\n  pcOffsetMethod: 'none' | 'cblocks'\n}\n\n/*************************/\n/** Storage Helper Functions */\n/*************************/\n\n/**\n * Resolves a storage type string (ABI type, AVM type, or struct name) into an ABIType or AVMType\n * @param typeStr The type string to resolve\n * @param structs The structs defined in the contract\n * @returns The parsed ABIType or AVMType string\n */\nfunction resolveStorageType(typeStr: string, structs: Record<string, StructField[]>): ABIType | AVMType {\n  // Check if it's an AVM type\n  if (typeStr === 'AVMBytes' || typeStr === 'AVMString' || typeStr === 'AVMUint64') {\n    return typeStr as AVMType\n  }\n\n  // Check if it's a struct type\n  if (structs[typeStr]) {\n    return ABIStructType.fromStruct(typeStr, structs)\n  }\n\n  // Otherwise parse as ABI type\n  try {\n    return ABIType.from(typeStr)\n  } catch (error) {\n    throw new Error(`Failed to parse storage type '${typeStr}': ${error}`)\n  }\n}\n\n/**\n * Converts a StorageKey to an ABIStorageKey with parsed types\n * @param storageKey The storage key to convert\n * @param structs The structs defined in the contract\n * @returns The converted ABIStorageKey\n */\nfunction convertStorageKey(storageKey: StorageKey, structs: Record<string, StructField[]>): ABIStorageKey {\n  const keyType = resolveStorageType(storageKey.keyType, structs)\n  const valueType = resolveStorageType(storageKey.valueType, structs)\n\n  return {\n    key: storageKey.key,\n    keyType,\n    valueType,\n    desc: storageKey.desc,\n  }\n}\n\n/**\n * Converts a StorageMap to an ABIStorageMap with parsed types\n * @param storageMap The storage map to convert\n * @param structs The structs defined in the contract\n * @returns The converted ABIStorageMap\n */\nfunction convertStorageMap(storageMap: StorageMap, structs: Record<string, StructField[]>): ABIStorageMap {\n  const keyType = resolveStorageType(storageMap.keyType, structs)\n  const valueType = resolveStorageType(storageMap.valueType, structs)\n\n  return {\n    keyType,\n    valueType,\n    desc: storageMap.desc,\n    prefix: storageMap.prefix,\n  }\n}\n\n/**\n * Get a specific global storage key with parsed ABI types\n * @param contract The ARC-56 contract\n * @param keyName The name of the storage key\n * @returns The ABIStorageKey with parsed types\n * @throws Error if the key is not found\n */\nexport function getGlobalABIStorageKey(contract: Arc56Contract, keyName: string): ABIStorageKey {\n  const storageKey = contract.state.keys.global[keyName]\n  if (!storageKey) {\n    throw new Error(`Global storage key '${keyName}' not found in contract '${contract.name}'`)\n  }\n  return convertStorageKey(storageKey, contract.structs)\n}\n\n/**\n * Get a specific local storage key with parsed ABI types\n * @param contract The ARC-56 contract\n * @param keyName The name of the storage key\n * @returns The ABIStorageKey with parsed types\n * @throws Error if the key is not found\n */\nexport function getLocalABIStorageKey(contract: Arc56Contract, keyName: string): ABIStorageKey {\n  const storageKey = contract.state.keys.local[keyName]\n  if (!storageKey) {\n    throw new Error(`Local storage key '${keyName}' not found in contract '${contract.name}'`)\n  }\n  return convertStorageKey(storageKey, contract.structs)\n}\n\n/**\n * Get a specific box storage key with parsed ABI types\n * @param contract The ARC-56 contract\n * @param keyName The name of the storage key\n * @returns The ABIStorageKey with parsed types\n * @throws Error if the key is not found\n */\nexport function getBoxABIStorageKey(contract: Arc56Contract, keyName: string): ABIStorageKey {\n  const storageKey = contract.state.keys.box[keyName]\n  if (!storageKey) {\n    throw new Error(`Box storage key '${keyName}' not found in contract '${contract.name}'`)\n  }\n  return convertStorageKey(storageKey, contract.structs)\n}\n\n/**\n * Get all global storage keys with parsed ABI types\n * @param contract The ARC-56 contract\n * @returns A record of storage key names to ABIStorageKey objects\n */\nexport function getGlobalABIStorageKeys(contract: Arc56Contract): Record<string, ABIStorageKey> {\n  const result: Record<string, ABIStorageKey> = {}\n  for (const [name, storageKey] of Object.entries(contract.state.keys.global)) {\n    result[name] = convertStorageKey(storageKey, contract.structs)\n  }\n  return result\n}\n\n/**\n * Get all local storage keys with parsed ABI types\n * @param contract The ARC-56 contract\n * @returns A record of storage key names to ABIStorageKey objects\n */\nexport function getLocalABIStorageKeys(contract: Arc56Contract): Record<string, ABIStorageKey> {\n  const result: Record<string, ABIStorageKey> = {}\n  for (const [name, storageKey] of Object.entries(contract.state.keys.local)) {\n    result[name] = convertStorageKey(storageKey, contract.structs)\n  }\n  return result\n}\n\n/**\n * Get all box storage keys with parsed ABI types\n * @param contract The ARC-56 contract\n * @returns A record of storage key names to ABIStorageKey objects\n */\nexport function getBoxABIStorageKeys(contract: Arc56Contract): Record<string, ABIStorageKey> {\n  const result: Record<string, ABIStorageKey> = {}\n  for (const [name, storageKey] of Object.entries(contract.state.keys.box)) {\n    result[name] = convertStorageKey(storageKey, contract.structs)\n  }\n  return result\n}\n\n/**\n * Get a specific global storage map with parsed ABI types\n * @param contract The ARC-56 contract\n * @param mapName The name of the storage map\n * @returns The ABIStorageMap with parsed types\n * @throws Error if the map is not found\n */\nexport function getGlobalABIStorageMap(contract: Arc56Contract, mapName: string): ABIStorageMap {\n  const storageMap = contract.state.maps.global[mapName]\n  if (!storageMap) {\n    throw new Error(`Global storage map '${mapName}' not found in contract '${contract.name}'`)\n  }\n  return convertStorageMap(storageMap, contract.structs)\n}\n\n/**\n * Get a specific local storage map with parsed ABI types\n * @param contract The ARC-56 contract\n * @param mapName The name of the storage map\n * @returns The ABIStorageMap with parsed types\n * @throws Error if the map is not found\n */\nexport function getLocalABIStorageMap(contract: Arc56Contract, mapName: string): ABIStorageMap {\n  const storageMap = contract.state.maps.local[mapName]\n  if (!storageMap) {\n    throw new Error(`Local storage map '${mapName}' not found in contract '${contract.name}'`)\n  }\n  return convertStorageMap(storageMap, contract.structs)\n}\n\n/**\n * Get a specific box storage map with parsed ABI types\n * @param contract The ARC-56 contract\n * @param mapName The name of the storage map\n * @returns The ABIStorageMap with parsed types\n * @throws Error if the map is not found\n */\nexport function getBoxABIStorageMap(contract: Arc56Contract, mapName: string): ABIStorageMap {\n  const storageMap = contract.state.maps.box[mapName]\n  if (!storageMap) {\n    throw new Error(`Box storage map '${mapName}' not found in contract '${contract.name}'`)\n  }\n  return convertStorageMap(storageMap, contract.structs)\n}\n\n/**\n * Get all global storage maps with parsed ABI types\n * @param contract The ARC-56 contract\n * @returns A record of storage map names to ABIStorageMap objects\n */\nexport function getGlobalABIStorageMaps(contract: Arc56Contract): Record<string, ABIStorageMap> {\n  const result: Record<string, ABIStorageMap> = {}\n  for (const [name, storageMap] of Object.entries(contract.state.maps.global)) {\n    result[name] = convertStorageMap(storageMap, contract.structs)\n  }\n  return result\n}\n\n/**\n * Get all local storage maps with parsed ABI types\n * @param contract The ARC-56 contract\n * @returns A record of storage map names to ABIStorageMap objects\n */\nexport function getLocalABIStorageMaps(contract: Arc56Contract): Record<string, ABIStorageMap> {\n  const result: Record<string, ABIStorageMap> = {}\n  for (const [name, storageMap] of Object.entries(contract.state.maps.local)) {\n    result[name] = convertStorageMap(storageMap, contract.structs)\n  }\n  return result\n}\n\n/**\n * Get all box storage maps with parsed ABI types\n * @param contract The ARC-56 contract\n * @returns A record of storage map names to ABIStorageMap objects\n */\nexport function getBoxABIStorageMaps(contract: Arc56Contract): Record<string, ABIStorageMap> {\n  const result: Record<string, ABIStorageMap> = {}\n  for (const [name, storageMap] of Object.entries(contract.state.maps.box)) {\n    result[name] = convertStorageMap(storageMap, contract.structs)\n  }\n  return result\n}\n"],"mappings":"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"}