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

package/types/app-factory.d.ts

@@ -247,8 +247,8 @@ declare class AppFactory {
       signer: AddressWithTransactionSigner | TransactionSigner | undefined;
       method: ABIMethod;
       args: (Transaction | ABIValue | TransactionWithSigner | AppMethodCall<{
-        sender: SendingAddress;
         signer?: AddressWithTransactionSigner | TransactionSigner | undefined;
+        sender: SendingAddress;
         rekeyTo?: ReadableAddress | undefined;
         note?: string | Uint8Array | undefined;
         lease?: string | Uint8Array | undefined;
@@ -258,8 +258,7 @@ declare class AppFactory {
         validityWindow?: number | bigint | undefined;
         firstValidRound?: bigint | undefined;
         lastValidRound?: bigint | undefined;
-        appId: bigint;
-        onComplete?: OnApplicationComplete.UpdateApplication | undefined;
+        onComplete?: OnApplicationComplete.NoOp | OnApplicationComplete.OptIn | OnApplicationComplete.CloseOut | OnApplicationComplete.UpdateApplication | OnApplicationComplete.DeleteApplication | undefined;
         args?: Uint8Array[] | undefined;
         accountReferences?: ReadableAddress[] | undefined;
         appReferences?: bigint[] | undefined;
@@ -269,9 +268,16 @@ declare class AppFactory {
         rejectVersion?: number | undefined;
         approvalProgram: string | Uint8Array;
         clearStateProgram: string | Uint8Array;
-      }> | AppMethodCall<{
-        signer?: AddressWithTransactionSigner | TransactionSigner | undefined;
+        schema?: {
+          globalInts: number;
+          globalByteSlices: number;
+          localInts: number;
+          localByteSlices: number;
+        } | undefined;
+        extraProgramPages?: number | undefined;
+      }> | Promise<Transaction> | AppMethodCall<{
         sender: SendingAddress;
+        signer?: AddressWithTransactionSigner | TransactionSigner | undefined;
         rekeyTo?: ReadableAddress | undefined;
         note?: string | Uint8Array | undefined;
         lease?: string | Uint8Array | undefined;
@@ -281,7 +287,8 @@ declare class AppFactory {
         validityWindow?: number | bigint | undefined;
         firstValidRound?: bigint | undefined;
         lastValidRound?: bigint | undefined;
-        onComplete?: OnApplicationComplete.NoOp | OnApplicationComplete.OptIn | OnApplicationComplete.CloseOut | OnApplicationComplete.UpdateApplication | OnApplicationComplete.DeleteApplication | undefined;
+        appId: bigint;
+        onComplete?: OnApplicationComplete.UpdateApplication | undefined;
         args?: Uint8Array[] | undefined;
         accountReferences?: ReadableAddress[] | undefined;
         appReferences?: bigint[] | undefined;
@@ -291,14 +298,7 @@ declare class AppFactory {
         rejectVersion?: number | undefined;
         approvalProgram: string | Uint8Array;
         clearStateProgram: string | Uint8Array;
-        schema?: {
-          globalInts: number;
-          globalByteSlices: number;
-          localInts: number;
-          localByteSlices: number;
-        } | undefined;
-        extraProgramPages?: number | undefined;
-      }> | Promise<Transaction> | AppMethodCall<AppMethodCallParams> | undefined)[] | undefined;
+      }> | AppMethodCall<AppMethodCallParams> | undefined)[] | undefined;
       onComplete: OnApplicationComplete.NoOp | OnApplicationComplete.OptIn | OnApplicationComplete.CloseOut | OnApplicationComplete.UpdateApplication | OnApplicationComplete.DeleteApplication;
     }>;
     /** Return params for a deployment update ABI call */
@@ -349,8 +349,8 @@ declare class AppFactory {
       signer: AddressWithTransactionSigner | TransactionSigner | undefined;
       method: ABIMethod;
       args: (Transaction | ABIValue | TransactionWithSigner | AppMethodCall<{
-        sender: SendingAddress;
         signer?: AddressWithTransactionSigner | TransactionSigner | undefined;
+        sender: SendingAddress;
         rekeyTo?: ReadableAddress | undefined;
         note?: string | Uint8Array | undefined;
         lease?: string | Uint8Array | undefined;
@@ -360,8 +360,7 @@ declare class AppFactory {
         validityWindow?: number | bigint | undefined;
         firstValidRound?: bigint | undefined;
         lastValidRound?: bigint | undefined;
-        appId: bigint;
-        onComplete?: OnApplicationComplete.UpdateApplication | undefined;
+        onComplete?: OnApplicationComplete.NoOp | OnApplicationComplete.OptIn | OnApplicationComplete.CloseOut | OnApplicationComplete.UpdateApplication | OnApplicationComplete.DeleteApplication | undefined;
         args?: Uint8Array[] | undefined;
         accountReferences?: ReadableAddress[] | undefined;
         appReferences?: bigint[] | undefined;
@@ -371,9 +370,16 @@ declare class AppFactory {
         rejectVersion?: number | undefined;
         approvalProgram: string | Uint8Array;
         clearStateProgram: string | Uint8Array;
-      }> | AppMethodCall<{
-        signer?: AddressWithTransactionSigner | TransactionSigner | undefined;
+        schema?: {
+          globalInts: number;
+          globalByteSlices: number;
+          localInts: number;
+          localByteSlices: number;
+        } | undefined;
+        extraProgramPages?: number | undefined;
+      }> | Promise<Transaction> | AppMethodCall<{
         sender: SendingAddress;
+        signer?: AddressWithTransactionSigner | TransactionSigner | undefined;
         rekeyTo?: ReadableAddress | undefined;
         note?: string | Uint8Array | undefined;
         lease?: string | Uint8Array | undefined;
@@ -383,7 +389,8 @@ declare class AppFactory {
         validityWindow?: number | bigint | undefined;
         firstValidRound?: bigint | undefined;
         lastValidRound?: bigint | undefined;
-        onComplete?: OnApplicationComplete.NoOp | OnApplicationComplete.OptIn | OnApplicationComplete.CloseOut | OnApplicationComplete.UpdateApplication | OnApplicationComplete.DeleteApplication | undefined;
+        appId: bigint;
+        onComplete?: OnApplicationComplete.UpdateApplication | undefined;
         args?: Uint8Array[] | undefined;
         accountReferences?: ReadableAddress[] | undefined;
         appReferences?: bigint[] | undefined;
@@ -393,14 +400,7 @@ declare class AppFactory {
         rejectVersion?: number | undefined;
         approvalProgram: string | Uint8Array;
         clearStateProgram: string | Uint8Array;
-        schema?: {
-          globalInts: number;
-          globalByteSlices: number;
-          localInts: number;
-          localByteSlices: number;
-        } | undefined;
-        extraProgramPages?: number | undefined;
-      }> | Promise<Transaction> | AppMethodCall<AppMethodCallParams> | undefined)[] | undefined;
+      }> | AppMethodCall<AppMethodCallParams> | undefined)[] | undefined;
       onComplete: OnApplicationComplete.UpdateApplication;
     };
     /** Return params for a deployment delete ABI call */
@@ -451,8 +451,8 @@ declare class AppFactory {
       signer: AddressWithTransactionSigner | TransactionSigner | undefined;
       method: ABIMethod;
       args: (Transaction | ABIValue | TransactionWithSigner | AppMethodCall<{
-        sender: SendingAddress;
         signer?: AddressWithTransactionSigner | TransactionSigner | undefined;
+        sender: SendingAddress;
         rekeyTo?: ReadableAddress | undefined;
         note?: string | Uint8Array | undefined;
         lease?: string | Uint8Array | undefined;
@@ -462,8 +462,7 @@ declare class AppFactory {
         validityWindow?: number | bigint | undefined;
         firstValidRound?: bigint | undefined;
         lastValidRound?: bigint | undefined;
-        appId: bigint;
-        onComplete?: OnApplicationComplete.UpdateApplication | undefined;
+        onComplete?: OnApplicationComplete.NoOp | OnApplicationComplete.OptIn | OnApplicationComplete.CloseOut | OnApplicationComplete.UpdateApplication | OnApplicationComplete.DeleteApplication | undefined;
         args?: Uint8Array[] | undefined;
         accountReferences?: ReadableAddress[] | undefined;
         appReferences?: bigint[] | undefined;
@@ -473,9 +472,16 @@ declare class AppFactory {
         rejectVersion?: number | undefined;
         approvalProgram: string | Uint8Array;
         clearStateProgram: string | Uint8Array;
-      }> | AppMethodCall<{
-        signer?: AddressWithTransactionSigner | TransactionSigner | undefined;
+        schema?: {
+          globalInts: number;
+          globalByteSlices: number;
+          localInts: number;
+          localByteSlices: number;
+        } | undefined;
+        extraProgramPages?: number | undefined;
+      }> | Promise<Transaction> | AppMethodCall<{
         sender: SendingAddress;
+        signer?: AddressWithTransactionSigner | TransactionSigner | undefined;
         rekeyTo?: ReadableAddress | undefined;
         note?: string | Uint8Array | undefined;
         lease?: string | Uint8Array | undefined;
@@ -485,7 +491,8 @@ declare class AppFactory {
         validityWindow?: number | bigint | undefined;
         firstValidRound?: bigint | undefined;
         lastValidRound?: bigint | undefined;
-        onComplete?: OnApplicationComplete.NoOp | OnApplicationComplete.OptIn | OnApplicationComplete.CloseOut | OnApplicationComplete.UpdateApplication | OnApplicationComplete.DeleteApplication | undefined;
+        appId: bigint;
+        onComplete?: OnApplicationComplete.UpdateApplication | undefined;
         args?: Uint8Array[] | undefined;
         accountReferences?: ReadableAddress[] | undefined;
         appReferences?: bigint[] | undefined;
@@ -495,14 +502,7 @@ declare class AppFactory {
         rejectVersion?: number | undefined;
         approvalProgram: string | Uint8Array;
         clearStateProgram: string | Uint8Array;
-        schema?: {
-          globalInts: number;
-          globalByteSlices: number;
-          localInts: number;
-          localByteSlices: number;
-        } | undefined;
-        extraProgramPages?: number | undefined;
-      }> | Promise<Transaction> | AppMethodCall<AppMethodCallParams> | undefined)[] | undefined;
+      }> | AppMethodCall<AppMethodCallParams> | undefined)[] | undefined;
       onComplete: OnApplicationComplete.DeleteApplication;
     };
     bare: {
@@ -799,14 +799,14 @@ declare class AppFactory {
       compiledApproval?: CompiledTeal | undefined;
       compiledClear?: CompiledTeal | undefined;
       operationPerformed: "create";
+      updatable?: boolean | undefined;
+      deletable?: boolean | undefined;
       createdRound: bigint;
       updatedRound: bigint;
       createdMetadata: AppDeployMetadata;
       deleted: boolean;
       name: string;
       version: string;
-      deletable?: boolean | undefined;
-      updatable?: boolean | undefined;
       groupId: string | undefined;
       txIds: string[];
       returns?: ABIReturn[] | undefined;
@@ -845,14 +845,14 @@ declare class AppFactory {
       compiledApproval?: CompiledTeal | undefined;
       compiledClear?: CompiledTeal | undefined;
       operationPerformed: "replace";
+      updatable?: boolean | undefined;
+      deletable?: boolean | undefined;
       createdRound: bigint;
       updatedRound: bigint;
       createdMetadata: AppDeployMetadata;
       deleted: boolean;
       name: string;
       version: string;
-      deletable?: boolean | undefined;
-      updatable?: boolean | undefined;
       groupId: string | undefined;
       txIds: string[];
       returns?: ABIReturn[] | undefined;

package/types/app-spec.js

@@ -35,16 +35,23 @@ function arc32ToArc56(appSpec) {
 		if (c.update_application && ["ALL", type].includes(c.update_application)) actions$1.push("UpdateApplication");
 		return actions$1;
 	};
-	const getDefaultArgValue = (type, defaultArg) => {
+	const getDefaultArgValue = (defaultArg) => {
 		if (!defaultArg) return void 0;
 		if (defaultArg.source === "abi-method") return {
 			source: "method",
 			data: defaultArg.data.name
 		};
+		const mappedSource = defaultArg.source === "constant" ? "literal" : defaultArg.source === "global-state" ? "global" : "local";
+		let defaultValueType = void 0;
+		if (mappedSource === "literal") {
+			if (typeof defaultArg.data === "number") defaultValueType = "uint64";
+			else if (typeof defaultArg.data === "string") defaultValueType = "AVMString";
+		}
+		const argData = typeof defaultArg.data === "number" ? require_abi_type.ABIType.from("uint64").encode(defaultArg.data) : typeof defaultArg.data === "string" ? new TextEncoder().encode(defaultArg.data) : defaultArg.data;
 		return {
-			source: defaultArg.source === "constant" ? "literal" : defaultArg.source === "global-state" ? "global" : "local",
-			data: Buffer.from(typeof defaultArg.data === "number" ? require_abi_type.ABIType.from("uint64").encode(defaultArg.data) : defaultArg.data).toString("base64"),
-			type: type === "string" ? "AVMString" : type
+			source: mappedSource,
+			data: Buffer.from(argData).toString("base64"),
+			type: defaultValueType
 		};
 	};
 	return {
@@ -60,7 +67,7 @@ function arc32ToArc56(appSpec) {
 				type: a.type,
 				desc: a.desc,
 				struct: a.name ? hint(m)?.structs?.[a.name]?.name : void 0,
-				defaultValue: getDefaultArgValue(a.type, !a.name ? void 0 : hint(m)?.default_arguments?.[a.name])
+				defaultValue: getDefaultArgValue(!a.name ? void 0 : hint(m)?.default_arguments?.[a.name])
 			})),
 			returns: {
 				type: m.returns.type,

package/types/app-spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-spec.js","names":["hint","actions: ('NoOp' | 'OptIn' | 'CloseOut' | 'ClearState' | 'UpdateApplication' | 'DeleteApplication')[]","actions","ABITypeClass"],"sources":["../../src/types/app-spec.ts"],"sourcesContent":["import {\n  ABIMethod,\n  ABIType as ABITypeClass,\n  ARC28Event,\n  Arc56Contract,\n  Arc56Method,\n  StorageKey,\n  StructField,\n} from '@algorandfoundation/algokit-abi'\n\n/**\n * Converts an ARC-32 Application Specification to an ARC-56 Contract\n * @param appSpec The ARC-32 Application Specification\n * @returns The ARC-56 Contract\n * @example\n * ```typescript\n * const arc56AppSpec = arc32ToArc56(arc32AppSpec)\n * ```\n */\nexport function arc32ToArc56(appSpec: AppSpec): Arc56Contract {\n  const arc32Structs = Object.values(appSpec.hints).flatMap((hint) => Object.entries(hint.structs ?? {}))\n  const structs = Object.fromEntries(\n    arc32Structs.map(([_, struct]) => {\n      const fields = struct.elements.map((e) => ({ name: e[0], type: e[1] }))\n      return [struct.name, fields]\n    }),\n  ) satisfies { [structName: string]: StructField[] }\n  const hint = (m: ABIMethodParams) => appSpec.hints[getABIMethodParamsSignature(m)] as Hint | undefined\n  const actions = (m: ABIMethodParams, type: 'CREATE' | 'CALL') => {\n    // eslint-disable-next-line @typescript-eslint/no-non-null-asserted-optional-chain\n    return hint(m)?.call_config !== undefined ? callConfigToActions(hint(m)?.call_config!, type) : []\n  }\n  const bareActions = (type: 'CREATE' | 'CALL') => {\n    return callConfigToActions(appSpec.bare_call_config, type)\n  }\n  const callConfigToActions = (c: CallConfig, type: 'CREATE' | 'CALL') => {\n    const actions: ('NoOp' | 'OptIn' | 'CloseOut' | 'ClearState' | 'UpdateApplication' | 'DeleteApplication')[] = []\n    if (c.close_out && ['ALL', type].includes(c.close_out)) actions.push('CloseOut')\n    if (c.delete_application && ['ALL', type].includes(c.delete_application)) actions.push('DeleteApplication')\n    if (c.no_op && ['ALL', type].includes(c.no_op)) actions.push('NoOp')\n    if (c.opt_in && ['ALL', type].includes(c.opt_in)) actions.push('OptIn')\n    if (c.update_application && ['ALL', type].includes(c.update_application)) actions.push('UpdateApplication')\n    return actions\n  }\n  const getDefaultArgValue = (\n    type: string,\n    defaultArg: DefaultArgument | undefined,\n  ): Arc56Contract['methods'][0]['args'][0]['defaultValue'] => {\n    if (!defaultArg) return undefined\n\n    if (defaultArg.source === 'abi-method') {\n      return {\n        source: 'method',\n        data: defaultArg.data.name,\n      }\n    }\n\n    return {\n      source: defaultArg.source === 'constant' ? 'literal' : defaultArg.source === 'global-state' ? 'global' : 'local',\n      data: Buffer.from(\n        typeof defaultArg.data === 'number' ? ABITypeClass.from('uint64').encode(defaultArg.data) : defaultArg.data,\n      ).toString('base64'),\n      type: type === 'string' ? 'AVMString' : type,\n    }\n  }\n\n  return {\n    arcs: [],\n    name: appSpec.contract.name,\n    desc: appSpec.contract.desc,\n    structs: structs,\n    methods: appSpec.contract.methods.map(\n      (m) =>\n        ({\n          name: m.name,\n          desc: m.desc,\n          args: m.args.map((a) => ({\n            name: a.name,\n            type: a.type,\n            desc: a.desc,\n            struct: a.name ? hint(m)?.structs?.[a.name]?.name : undefined,\n            defaultValue: getDefaultArgValue(a.type, !a.name ? undefined : hint(m)?.default_arguments?.[a.name]),\n          })),\n          returns: {\n            type: m.returns.type,\n            desc: m.returns.desc,\n            struct: hint(m)?.structs?.output?.name,\n          },\n          events: [],\n          readonly: hint(m)?.read_only,\n          actions: {\n            create: actions(m, 'CREATE') as Arc56Method['actions']['create'],\n            call: actions(m, 'CALL'),\n          },\n        }) satisfies Arc56Method,\n    ),\n    state: {\n      schema: {\n        global: {\n          ints: appSpec.state.global.num_uints,\n          bytes: appSpec.state.global.num_byte_slices,\n        },\n        local: {\n          ints: appSpec.state.local.num_uints,\n          bytes: appSpec.state.local.num_byte_slices,\n        },\n      },\n      keys: {\n        global: Object.fromEntries(\n          Object.entries(appSpec.schema.global.declared).map((s) => [\n            s[0],\n            {\n              key: Buffer.from(s[1].key, 'utf-8').toString('base64'),\n              keyType: 'AVMString',\n              valueType: s[1].type === 'uint64' ? 'AVMUint64' : 'AVMBytes',\n              desc: s[1].descr,\n            } satisfies StorageKey,\n          ]),\n        ),\n        local: Object.fromEntries(\n          Object.entries(appSpec.schema.local.declared).map((s) => [\n            s[0],\n            {\n              key: Buffer.from(s[1].key, 'utf-8').toString('base64'),\n              keyType: 'AVMString',\n              valueType: s[1].type === 'uint64' ? 'AVMUint64' : 'AVMBytes',\n              desc: s[1].descr,\n            } satisfies StorageKey,\n          ]),\n        ),\n        box: {},\n      },\n      maps: {\n        global: {},\n        local: {},\n        box: {},\n      },\n    },\n    source: appSpec.source,\n    bareActions: {\n      create: bareActions('CREATE') as unknown as Arc56Contract['bareActions']['create'],\n      call: bareActions('CALL'),\n    },\n    byteCode: undefined,\n    compilerInfo: undefined,\n    events: undefined,\n    networks: undefined,\n    scratchVariables: undefined,\n    sourceInfo: undefined,\n    templateVariables: undefined,\n  } satisfies Arc56Contract\n}\n\nfunction getABIMethodParamsSignature(params: ABIMethodParams) {\n  const args = params.args.map((a) => a.type).join(',')\n  return `${params.name}(${args})${params.returns.type}`\n}\n\n/** An ARC-0032 Application Specification see https://github.com/algorandfoundation/ARCs/pull/150 */\nexport interface AppSpec {\n  /** Method call hints */\n  hints: HintSpec\n  /** The TEAL source */\n  source: AppSources\n  /** The ABI-0004 contract definition see https://github.com/algorandfoundation/ARCs/blob/main/ARCs/arc-0004.md */\n  contract: ABIContractParams\n  /** The values that make up the local and global state */\n  schema: SchemaSpec\n  /** The rolled-up schema allocation values for local and global state */\n  state: StateSchemaSpec\n  /** The config of all BARE calls (i.e. non ABI calls with no args) */\n  bare_call_config: CallConfig\n}\n\ninterface ABIContractParams {\n  name: string\n  desc?: string\n  networks?: ABIContractNetworks\n  methods: ABIMethodParams[]\n  events?: ARC28Event[]\n}\n\ninterface ABIContractNetworks {\n  [network: string]: ABIContractNetworkInfo\n}\n\ninterface ABIContractNetworkInfo {\n  appID: number\n}\n\ninterface ABIMethodParams {\n  name: string\n  desc?: string\n  args: ABIMethodArgParams[]\n  returns: ABIMethodReturnParams\n  /** Optional, is it a read-only method (according to [ARC-22](https://arc.algorand.foundation/ARCs/arc-0022)) */\n  readonly?: boolean\n  /** [ARC-28](https://arc.algorand.foundation/ARCs/arc-0028) events that MAY be emitted by this method */\n  events?: ARC28Event[]\n}\n\ninterface ABIMethodArgParams {\n  type: string\n  name?: string\n  desc?: string\n}\n\ninterface ABIMethodReturnParams {\n  type: string\n  desc?: string\n}\n\n/** A lookup of encoded method call spec to hint */\nexport type HintSpec = Record<string, Hint>\n\n/** The TEAL source of a contract */\nexport interface AppSources {\n  /** The TEAL source of the approval program */\n  approval: string\n  /** The TEAL source of the clear program */\n  clear: string\n}\n\n/** The various call configs:\n *  * `NEVER`: Will not be called\n *  * `CALL`: Can be called during a non-create call i.e. app id != 0\n *  * `CREATE`: Can be called during a create call i.e. app id = 0\n *  * `ALL`: Can be during a create OR non-create call\n **/\nexport type CallConfigValue = 'NEVER' | 'CALL' | 'CREATE' | 'ALL'\n\n/** Call configuration for a method */\nexport interface CallConfig {\n  /** NoOp call config */\n  no_op?: CallConfigValue\n  /** Opt-in call config */\n  opt_in?: CallConfigValue\n  /** Close out call config */\n  close_out?: CallConfigValue\n  /** Update call config */\n  update_application?: CallConfigValue\n  /** Delete call config */\n  delete_application?: CallConfigValue\n}\n\n/** Hint information for a given method call to allow client generation */\nexport interface Hint {\n  /** Any user-defined struct/tuple types used in the method call, keyed by parameter name or `output` for return type */\n  structs?: Record<string, Struct>\n  read_only?: boolean\n  default_arguments?: Record<string, DefaultArgument>\n  call_config: CallConfig\n}\n\n/** The name of a field */\nexport type FieldName = string\n\n/** The string name of an ABI type */\nexport type ABIType = string\n\n/** The elements of the struct/tuple: `FieldName`, `ABIType` */\nexport type StructElement = [FieldName, ABIType]\n\n/** A user-defined struct/tuple type */\nexport interface Struct {\n  /** The name of the type */\n  name: string\n  /** The elements (in order) that make up the struct/tuple */\n  elements: StructElement[]\n}\n\n/**\n * Defines a strategy for obtaining a default value for a given ABI arg.\n */\nexport type DefaultArgument =\n  | {\n      /**\n       * The default value should be fetched by invoking an ABI method\n       */\n      source: 'abi-method'\n      data: ABIMethod\n    }\n  | {\n      /**\n       * The default value should be fetched from global state\n       */\n      source: 'global-state'\n      /**\n       * The key of the state variable\n       */\n      data: string\n    }\n  | {\n      /**\n       * The default value should be fetched from the local state of the sender user\n       */\n      source: 'local-state'\n      /**\n       * The key of the state variable\n       */\n      data: string\n    }\n  | {\n      /**\n       * The default value is a constant.\n       */\n      source: 'constant'\n      /**\n       * The static default value to use.\n       */\n      data: string | number\n    }\n\n/** AVM data type */\nexport type AVMType = 'uint64' | 'bytes'\n\n/** Declared schema value specification */\nexport interface DeclaredSchemaValueSpec {\n  /** The type of value */\n  type: AVMType\n  /** The name of the key */\n  key: string\n  /** A description of the variable */\n  descr?: string\n  /** Whether or not the value is set statically (at create time only) or dynamically */\n  static?: boolean\n}\n\n/** Reserved schema value specification */\nexport interface ReservedSchemaValueSpec {\n  /** The type of value */\n  type: AVMType\n  /** The description of the reserved storage space */\n  descr: string\n  /** The maximum number of slots to reserve */\n  max_keys: number\n}\n\n/** The schema for global and local storage */\nexport interface SchemaSpec {\n  /** The local storage schema */\n  local: Schema\n  /** The global storage schema */\n  global: Schema\n}\n\n/** The storage schema definition */\nexport interface Schema {\n  /** Declared storage schema */\n  declared: Record<string, DeclaredSchemaValueSpec>\n  /** Reserved storage schema */\n  reserved: Record<string, ReservedSchemaValueSpec>\n}\n\n/** The rolled-up schema allocation specification for local and global state */\nexport interface StateSchemaSpec {\n  /** Global storage spec */\n  global: StateSchema\n  /** Local storage spec */\n  local: StateSchema\n}\n\n/** Schema spec summary for global or local storage */\nexport type StateSchema = {\n  /** Number of uint slots */\n  num_uints: number\n  /** Number of byte slots */\n  num_byte_slices: number\n}\n"],"mappings":"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"}
+{"version":3,"file":"app-spec.js","names":["hint","actions: ('NoOp' | 'OptIn' | 'CloseOut' | 'ClearState' | 'UpdateApplication' | 'DeleteApplication')[]","actions","defaultValueType: string | undefined","ABITypeClass"],"sources":["../../src/types/app-spec.ts"],"sourcesContent":["import {\n  ABIMethod,\n  ABIType as ABITypeClass,\n  ARC28Event,\n  Arc56Contract,\n  Arc56Method,\n  StorageKey,\n  StructField,\n} from '@algorandfoundation/algokit-abi'\n\n/**\n * Converts an ARC-32 Application Specification to an ARC-56 Contract\n * @param appSpec The ARC-32 Application Specification\n * @returns The ARC-56 Contract\n * @example\n * ```typescript\n * const arc56AppSpec = arc32ToArc56(arc32AppSpec)\n * ```\n */\nexport function arc32ToArc56(appSpec: AppSpec): Arc56Contract {\n  const arc32Structs = Object.values(appSpec.hints).flatMap((hint) => Object.entries(hint.structs ?? {}))\n  const structs = Object.fromEntries(\n    arc32Structs.map(([_, struct]) => {\n      const fields = struct.elements.map((e) => ({ name: e[0], type: e[1] }))\n      return [struct.name, fields]\n    }),\n  ) satisfies { [structName: string]: StructField[] }\n  const hint = (m: ABIMethodParams) => appSpec.hints[getABIMethodParamsSignature(m)] as Hint | undefined\n  const actions = (m: ABIMethodParams, type: 'CREATE' | 'CALL') => {\n    // eslint-disable-next-line @typescript-eslint/no-non-null-asserted-optional-chain\n    return hint(m)?.call_config !== undefined ? callConfigToActions(hint(m)?.call_config!, type) : []\n  }\n  const bareActions = (type: 'CREATE' | 'CALL') => {\n    return callConfigToActions(appSpec.bare_call_config, type)\n  }\n  const callConfigToActions = (c: CallConfig, type: 'CREATE' | 'CALL') => {\n    const actions: ('NoOp' | 'OptIn' | 'CloseOut' | 'ClearState' | 'UpdateApplication' | 'DeleteApplication')[] = []\n    if (c.close_out && ['ALL', type].includes(c.close_out)) actions.push('CloseOut')\n    if (c.delete_application && ['ALL', type].includes(c.delete_application)) actions.push('DeleteApplication')\n    if (c.no_op && ['ALL', type].includes(c.no_op)) actions.push('NoOp')\n    if (c.opt_in && ['ALL', type].includes(c.opt_in)) actions.push('OptIn')\n    if (c.update_application && ['ALL', type].includes(c.update_application)) actions.push('UpdateApplication')\n    return actions\n  }\n  const getDefaultArgValue = (defaultArg: DefaultArgument | undefined): Arc56Contract['methods'][0]['args'][0]['defaultValue'] => {\n    if (!defaultArg) return undefined\n\n    if (defaultArg.source === 'abi-method') {\n      return {\n        source: 'method',\n        data: defaultArg.data.name,\n      }\n    }\n\n    const mappedSource = defaultArg.source === 'constant' ? 'literal' : defaultArg.source === 'global-state' ? 'global' : 'local'\n\n    // type is only set for literal source\n    let defaultValueType: string | undefined = undefined\n    if (mappedSource === 'literal') {\n      if (typeof defaultArg.data === 'number') {\n        defaultValueType = 'uint64'\n      } else if (typeof defaultArg.data === 'string') {\n        defaultValueType = 'AVMString'\n      }\n    }\n\n    const argData =\n      typeof defaultArg.data === 'number'\n        ? ABITypeClass.from('uint64').encode(defaultArg.data)\n        : typeof defaultArg.data === 'string'\n          ? new TextEncoder().encode(defaultArg.data)\n          : defaultArg.data\n\n    return {\n      source: mappedSource,\n      data: Buffer.from(argData).toString('base64'),\n      type: defaultValueType,\n    }\n  }\n\n  return {\n    arcs: [],\n    name: appSpec.contract.name,\n    desc: appSpec.contract.desc,\n    structs: structs,\n    methods: appSpec.contract.methods.map(\n      (m) =>\n        ({\n          name: m.name,\n          desc: m.desc,\n          args: m.args.map((a) => ({\n            name: a.name,\n            type: a.type,\n            desc: a.desc,\n            struct: a.name ? hint(m)?.structs?.[a.name]?.name : undefined,\n            defaultValue: getDefaultArgValue(!a.name ? undefined : hint(m)?.default_arguments?.[a.name]),\n          })),\n          returns: {\n            type: m.returns.type,\n            desc: m.returns.desc,\n            struct: hint(m)?.structs?.output?.name,\n          },\n          events: [],\n          readonly: hint(m)?.read_only,\n          actions: {\n            create: actions(m, 'CREATE') as Arc56Method['actions']['create'],\n            call: actions(m, 'CALL'),\n          },\n        }) satisfies Arc56Method,\n    ),\n    state: {\n      schema: {\n        global: {\n          ints: appSpec.state.global.num_uints,\n          bytes: appSpec.state.global.num_byte_slices,\n        },\n        local: {\n          ints: appSpec.state.local.num_uints,\n          bytes: appSpec.state.local.num_byte_slices,\n        },\n      },\n      keys: {\n        global: Object.fromEntries(\n          Object.entries(appSpec.schema.global.declared).map((s) => [\n            s[0],\n            {\n              key: Buffer.from(s[1].key, 'utf-8').toString('base64'),\n              keyType: 'AVMString',\n              valueType: s[1].type === 'uint64' ? 'AVMUint64' : 'AVMBytes',\n              desc: s[1].descr,\n            } satisfies StorageKey,\n          ]),\n        ),\n        local: Object.fromEntries(\n          Object.entries(appSpec.schema.local.declared).map((s) => [\n            s[0],\n            {\n              key: Buffer.from(s[1].key, 'utf-8').toString('base64'),\n              keyType: 'AVMString',\n              valueType: s[1].type === 'uint64' ? 'AVMUint64' : 'AVMBytes',\n              desc: s[1].descr,\n            } satisfies StorageKey,\n          ]),\n        ),\n        box: {},\n      },\n      maps: {\n        global: {},\n        local: {},\n        box: {},\n      },\n    },\n    source: appSpec.source,\n    bareActions: {\n      create: bareActions('CREATE') as unknown as Arc56Contract['bareActions']['create'],\n      call: bareActions('CALL'),\n    },\n    byteCode: undefined,\n    compilerInfo: undefined,\n    events: undefined,\n    networks: undefined,\n    scratchVariables: undefined,\n    sourceInfo: undefined,\n    templateVariables: undefined,\n  } satisfies Arc56Contract\n}\n\nfunction getABIMethodParamsSignature(params: ABIMethodParams) {\n  const args = params.args.map((a) => a.type).join(',')\n  return `${params.name}(${args})${params.returns.type}`\n}\n\n/** An ARC-0032 Application Specification see https://github.com/algorandfoundation/ARCs/pull/150 */\nexport interface AppSpec {\n  /** Method call hints */\n  hints: HintSpec\n  /** The TEAL source */\n  source: AppSources\n  /** The ABI-0004 contract definition see https://github.com/algorandfoundation/ARCs/blob/main/ARCs/arc-0004.md */\n  contract: ABIContractParams\n  /** The values that make up the local and global state */\n  schema: SchemaSpec\n  /** The rolled-up schema allocation values for local and global state */\n  state: StateSchemaSpec\n  /** The config of all BARE calls (i.e. non ABI calls with no args) */\n  bare_call_config: CallConfig\n}\n\ninterface ABIContractParams {\n  name: string\n  desc?: string\n  networks?: ABIContractNetworks\n  methods: ABIMethodParams[]\n  events?: ARC28Event[]\n}\n\ninterface ABIContractNetworks {\n  [network: string]: ABIContractNetworkInfo\n}\n\ninterface ABIContractNetworkInfo {\n  appID: number\n}\n\ninterface ABIMethodParams {\n  name: string\n  desc?: string\n  args: ABIMethodArgParams[]\n  returns: ABIMethodReturnParams\n  /** Optional, is it a read-only method (according to [ARC-22](https://arc.algorand.foundation/ARCs/arc-0022)) */\n  readonly?: boolean\n  /** [ARC-28](https://arc.algorand.foundation/ARCs/arc-0028) events that MAY be emitted by this method */\n  events?: ARC28Event[]\n}\n\ninterface ABIMethodArgParams {\n  type: string\n  name?: string\n  desc?: string\n}\n\ninterface ABIMethodReturnParams {\n  type: string\n  desc?: string\n}\n\n/** A lookup of encoded method call spec to hint */\nexport type HintSpec = Record<string, Hint>\n\n/** The TEAL source of a contract */\nexport interface AppSources {\n  /** The TEAL source of the approval program */\n  approval: string\n  /** The TEAL source of the clear program */\n  clear: string\n}\n\n/** The various call configs:\n *  * `NEVER`: Will not be called\n *  * `CALL`: Can be called during a non-create call i.e. app id != 0\n *  * `CREATE`: Can be called during a create call i.e. app id = 0\n *  * `ALL`: Can be during a create OR non-create call\n **/\nexport type CallConfigValue = 'NEVER' | 'CALL' | 'CREATE' | 'ALL'\n\n/** Call configuration for a method */\nexport interface CallConfig {\n  /** NoOp call config */\n  no_op?: CallConfigValue\n  /** Opt-in call config */\n  opt_in?: CallConfigValue\n  /** Close out call config */\n  close_out?: CallConfigValue\n  /** Update call config */\n  update_application?: CallConfigValue\n  /** Delete call config */\n  delete_application?: CallConfigValue\n}\n\n/** Hint information for a given method call to allow client generation */\nexport interface Hint {\n  /** Any user-defined struct/tuple types used in the method call, keyed by parameter name or `output` for return type */\n  structs?: Record<string, Struct>\n  read_only?: boolean\n  default_arguments?: Record<string, DefaultArgument>\n  call_config: CallConfig\n}\n\n/** The name of a field */\nexport type FieldName = string\n\n/** The string name of an ABI type */\nexport type ABIType = string\n\n/** The elements of the struct/tuple: `FieldName`, `ABIType` */\nexport type StructElement = [FieldName, ABIType]\n\n/** A user-defined struct/tuple type */\nexport interface Struct {\n  /** The name of the type */\n  name: string\n  /** The elements (in order) that make up the struct/tuple */\n  elements: StructElement[]\n}\n\n/**\n * Defines a strategy for obtaining a default value for a given ABI arg.\n */\nexport type DefaultArgument =\n  | {\n      /**\n       * The default value should be fetched by invoking an ABI method\n       */\n      source: 'abi-method'\n      data: ABIMethod\n    }\n  | {\n      /**\n       * The default value should be fetched from global state\n       */\n      source: 'global-state'\n      /**\n       * The key of the state variable\n       */\n      data: string\n    }\n  | {\n      /**\n       * The default value should be fetched from the local state of the sender user\n       */\n      source: 'local-state'\n      /**\n       * The key of the state variable\n       */\n      data: string\n    }\n  | {\n      /**\n       * The default value is a constant.\n       */\n      source: 'constant'\n      /**\n       * The static default value to use.\n       */\n      data: string | number\n    }\n\n/** AVM data type */\nexport type AVMType = 'uint64' | 'bytes'\n\n/** Declared schema value specification */\nexport interface DeclaredSchemaValueSpec {\n  /** The type of value */\n  type: AVMType\n  /** The name of the key */\n  key: string\n  /** A description of the variable */\n  descr?: string\n  /** Whether or not the value is set statically (at create time only) or dynamically */\n  static?: boolean\n}\n\n/** Reserved schema value specification */\nexport interface ReservedSchemaValueSpec {\n  /** The type of value */\n  type: AVMType\n  /** The description of the reserved storage space */\n  descr: string\n  /** The maximum number of slots to reserve */\n  max_keys: number\n}\n\n/** The schema for global and local storage */\nexport interface SchemaSpec {\n  /** The local storage schema */\n  local: Schema\n  /** The global storage schema */\n  global: Schema\n}\n\n/** The storage schema definition */\nexport interface Schema {\n  /** Declared storage schema */\n  declared: Record<string, DeclaredSchemaValueSpec>\n  /** Reserved storage schema */\n  reserved: Record<string, ReservedSchemaValueSpec>\n}\n\n/** The rolled-up schema allocation specification for local and global state */\nexport interface StateSchemaSpec {\n  /** Global storage spec */\n  global: StateSchema\n  /** Local storage spec */\n  local: StateSchema\n}\n\n/** Schema spec summary for global or local storage */\nexport type StateSchema = {\n  /** Number of uint slots */\n  num_uints: number\n  /** Number of byte slots */\n  num_byte_slices: number\n}\n"],"mappings":"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"}

package/types/app-spec.mjs

@@ -35,16 +35,23 @@ function arc32ToArc56(appSpec) {
 		if (c.update_application && ["ALL", type].includes(c.update_application)) actions$1.push("UpdateApplication");
 		return actions$1;
 	};
-	const getDefaultArgValue = (type, defaultArg) => {
+	const getDefaultArgValue = (defaultArg) => {
 		if (!defaultArg) return void 0;
 		if (defaultArg.source === "abi-method") return {
 			source: "method",
 			data: defaultArg.data.name
 		};
+		const mappedSource = defaultArg.source === "constant" ? "literal" : defaultArg.source === "global-state" ? "global" : "local";
+		let defaultValueType = void 0;
+		if (mappedSource === "literal") {
+			if (typeof defaultArg.data === "number") defaultValueType = "uint64";
+			else if (typeof defaultArg.data === "string") defaultValueType = "AVMString";
+		}
+		const argData = typeof defaultArg.data === "number" ? ABIType.from("uint64").encode(defaultArg.data) : typeof defaultArg.data === "string" ? new TextEncoder().encode(defaultArg.data) : defaultArg.data;
 		return {
-			source: defaultArg.source === "constant" ? "literal" : defaultArg.source === "global-state" ? "global" : "local",
-			data: Buffer.from(typeof defaultArg.data === "number" ? ABIType.from("uint64").encode(defaultArg.data) : defaultArg.data).toString("base64"),
-			type: type === "string" ? "AVMString" : type
+			source: mappedSource,
+			data: Buffer.from(argData).toString("base64"),
+			type: defaultValueType
 		};
 	};
 	return {
@@ -60,7 +67,7 @@ function arc32ToArc56(appSpec) {
 				type: a.type,
 				desc: a.desc,
 				struct: a.name ? hint(m)?.structs?.[a.name]?.name : void 0,
-				defaultValue: getDefaultArgValue(a.type, !a.name ? void 0 : hint(m)?.default_arguments?.[a.name])
+				defaultValue: getDefaultArgValue(!a.name ? void 0 : hint(m)?.default_arguments?.[a.name])
 			})),
 			returns: {
 				type: m.returns.type,

package/types/app-spec.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"app-spec.mjs","names":["hint","actions: ('NoOp' | 'OptIn' | 'CloseOut' | 'ClearState' | 'UpdateApplication' | 'DeleteApplication')[]","actions","ABITypeClass"],"sources":["../../src/types/app-spec.ts"],"sourcesContent":["import {\n  ABIMethod,\n  ABIType as ABITypeClass,\n  ARC28Event,\n  Arc56Contract,\n  Arc56Method,\n  StorageKey,\n  StructField,\n} from '@algorandfoundation/algokit-abi'\n\n/**\n * Converts an ARC-32 Application Specification to an ARC-56 Contract\n * @param appSpec The ARC-32 Application Specification\n * @returns The ARC-56 Contract\n * @example\n * ```typescript\n * const arc56AppSpec = arc32ToArc56(arc32AppSpec)\n * ```\n */\nexport function arc32ToArc56(appSpec: AppSpec): Arc56Contract {\n  const arc32Structs = Object.values(appSpec.hints).flatMap((hint) => Object.entries(hint.structs ?? {}))\n  const structs = Object.fromEntries(\n    arc32Structs.map(([_, struct]) => {\n      const fields = struct.elements.map((e) => ({ name: e[0], type: e[1] }))\n      return [struct.name, fields]\n    }),\n  ) satisfies { [structName: string]: StructField[] }\n  const hint = (m: ABIMethodParams) => appSpec.hints[getABIMethodParamsSignature(m)] as Hint | undefined\n  const actions = (m: ABIMethodParams, type: 'CREATE' | 'CALL') => {\n    // eslint-disable-next-line @typescript-eslint/no-non-null-asserted-optional-chain\n    return hint(m)?.call_config !== undefined ? callConfigToActions(hint(m)?.call_config!, type) : []\n  }\n  const bareActions = (type: 'CREATE' | 'CALL') => {\n    return callConfigToActions(appSpec.bare_call_config, type)\n  }\n  const callConfigToActions = (c: CallConfig, type: 'CREATE' | 'CALL') => {\n    const actions: ('NoOp' | 'OptIn' | 'CloseOut' | 'ClearState' | 'UpdateApplication' | 'DeleteApplication')[] = []\n    if (c.close_out && ['ALL', type].includes(c.close_out)) actions.push('CloseOut')\n    if (c.delete_application && ['ALL', type].includes(c.delete_application)) actions.push('DeleteApplication')\n    if (c.no_op && ['ALL', type].includes(c.no_op)) actions.push('NoOp')\n    if (c.opt_in && ['ALL', type].includes(c.opt_in)) actions.push('OptIn')\n    if (c.update_application && ['ALL', type].includes(c.update_application)) actions.push('UpdateApplication')\n    return actions\n  }\n  const getDefaultArgValue = (\n    type: string,\n    defaultArg: DefaultArgument | undefined,\n  ): Arc56Contract['methods'][0]['args'][0]['defaultValue'] => {\n    if (!defaultArg) return undefined\n\n    if (defaultArg.source === 'abi-method') {\n      return {\n        source: 'method',\n        data: defaultArg.data.name,\n      }\n    }\n\n    return {\n      source: defaultArg.source === 'constant' ? 'literal' : defaultArg.source === 'global-state' ? 'global' : 'local',\n      data: Buffer.from(\n        typeof defaultArg.data === 'number' ? ABITypeClass.from('uint64').encode(defaultArg.data) : defaultArg.data,\n      ).toString('base64'),\n      type: type === 'string' ? 'AVMString' : type,\n    }\n  }\n\n  return {\n    arcs: [],\n    name: appSpec.contract.name,\n    desc: appSpec.contract.desc,\n    structs: structs,\n    methods: appSpec.contract.methods.map(\n      (m) =>\n        ({\n          name: m.name,\n          desc: m.desc,\n          args: m.args.map((a) => ({\n            name: a.name,\n            type: a.type,\n            desc: a.desc,\n            struct: a.name ? hint(m)?.structs?.[a.name]?.name : undefined,\n            defaultValue: getDefaultArgValue(a.type, !a.name ? undefined : hint(m)?.default_arguments?.[a.name]),\n          })),\n          returns: {\n            type: m.returns.type,\n            desc: m.returns.desc,\n            struct: hint(m)?.structs?.output?.name,\n          },\n          events: [],\n          readonly: hint(m)?.read_only,\n          actions: {\n            create: actions(m, 'CREATE') as Arc56Method['actions']['create'],\n            call: actions(m, 'CALL'),\n          },\n        }) satisfies Arc56Method,\n    ),\n    state: {\n      schema: {\n        global: {\n          ints: appSpec.state.global.num_uints,\n          bytes: appSpec.state.global.num_byte_slices,\n        },\n        local: {\n          ints: appSpec.state.local.num_uints,\n          bytes: appSpec.state.local.num_byte_slices,\n        },\n      },\n      keys: {\n        global: Object.fromEntries(\n          Object.entries(appSpec.schema.global.declared).map((s) => [\n            s[0],\n            {\n              key: Buffer.from(s[1].key, 'utf-8').toString('base64'),\n              keyType: 'AVMString',\n              valueType: s[1].type === 'uint64' ? 'AVMUint64' : 'AVMBytes',\n              desc: s[1].descr,\n            } satisfies StorageKey,\n          ]),\n        ),\n        local: Object.fromEntries(\n          Object.entries(appSpec.schema.local.declared).map((s) => [\n            s[0],\n            {\n              key: Buffer.from(s[1].key, 'utf-8').toString('base64'),\n              keyType: 'AVMString',\n              valueType: s[1].type === 'uint64' ? 'AVMUint64' : 'AVMBytes',\n              desc: s[1].descr,\n            } satisfies StorageKey,\n          ]),\n        ),\n        box: {},\n      },\n      maps: {\n        global: {},\n        local: {},\n        box: {},\n      },\n    },\n    source: appSpec.source,\n    bareActions: {\n      create: bareActions('CREATE') as unknown as Arc56Contract['bareActions']['create'],\n      call: bareActions('CALL'),\n    },\n    byteCode: undefined,\n    compilerInfo: undefined,\n    events: undefined,\n    networks: undefined,\n    scratchVariables: undefined,\n    sourceInfo: undefined,\n    templateVariables: undefined,\n  } satisfies Arc56Contract\n}\n\nfunction getABIMethodParamsSignature(params: ABIMethodParams) {\n  const args = params.args.map((a) => a.type).join(',')\n  return `${params.name}(${args})${params.returns.type}`\n}\n\n/** An ARC-0032 Application Specification see https://github.com/algorandfoundation/ARCs/pull/150 */\nexport interface AppSpec {\n  /** Method call hints */\n  hints: HintSpec\n  /** The TEAL source */\n  source: AppSources\n  /** The ABI-0004 contract definition see https://github.com/algorandfoundation/ARCs/blob/main/ARCs/arc-0004.md */\n  contract: ABIContractParams\n  /** The values that make up the local and global state */\n  schema: SchemaSpec\n  /** The rolled-up schema allocation values for local and global state */\n  state: StateSchemaSpec\n  /** The config of all BARE calls (i.e. non ABI calls with no args) */\n  bare_call_config: CallConfig\n}\n\ninterface ABIContractParams {\n  name: string\n  desc?: string\n  networks?: ABIContractNetworks\n  methods: ABIMethodParams[]\n  events?: ARC28Event[]\n}\n\ninterface ABIContractNetworks {\n  [network: string]: ABIContractNetworkInfo\n}\n\ninterface ABIContractNetworkInfo {\n  appID: number\n}\n\ninterface ABIMethodParams {\n  name: string\n  desc?: string\n  args: ABIMethodArgParams[]\n  returns: ABIMethodReturnParams\n  /** Optional, is it a read-only method (according to [ARC-22](https://arc.algorand.foundation/ARCs/arc-0022)) */\n  readonly?: boolean\n  /** [ARC-28](https://arc.algorand.foundation/ARCs/arc-0028) events that MAY be emitted by this method */\n  events?: ARC28Event[]\n}\n\ninterface ABIMethodArgParams {\n  type: string\n  name?: string\n  desc?: string\n}\n\ninterface ABIMethodReturnParams {\n  type: string\n  desc?: string\n}\n\n/** A lookup of encoded method call spec to hint */\nexport type HintSpec = Record<string, Hint>\n\n/** The TEAL source of a contract */\nexport interface AppSources {\n  /** The TEAL source of the approval program */\n  approval: string\n  /** The TEAL source of the clear program */\n  clear: string\n}\n\n/** The various call configs:\n *  * `NEVER`: Will not be called\n *  * `CALL`: Can be called during a non-create call i.e. app id != 0\n *  * `CREATE`: Can be called during a create call i.e. app id = 0\n *  * `ALL`: Can be during a create OR non-create call\n **/\nexport type CallConfigValue = 'NEVER' | 'CALL' | 'CREATE' | 'ALL'\n\n/** Call configuration for a method */\nexport interface CallConfig {\n  /** NoOp call config */\n  no_op?: CallConfigValue\n  /** Opt-in call config */\n  opt_in?: CallConfigValue\n  /** Close out call config */\n  close_out?: CallConfigValue\n  /** Update call config */\n  update_application?: CallConfigValue\n  /** Delete call config */\n  delete_application?: CallConfigValue\n}\n\n/** Hint information for a given method call to allow client generation */\nexport interface Hint {\n  /** Any user-defined struct/tuple types used in the method call, keyed by parameter name or `output` for return type */\n  structs?: Record<string, Struct>\n  read_only?: boolean\n  default_arguments?: Record<string, DefaultArgument>\n  call_config: CallConfig\n}\n\n/** The name of a field */\nexport type FieldName = string\n\n/** The string name of an ABI type */\nexport type ABIType = string\n\n/** The elements of the struct/tuple: `FieldName`, `ABIType` */\nexport type StructElement = [FieldName, ABIType]\n\n/** A user-defined struct/tuple type */\nexport interface Struct {\n  /** The name of the type */\n  name: string\n  /** The elements (in order) that make up the struct/tuple */\n  elements: StructElement[]\n}\n\n/**\n * Defines a strategy for obtaining a default value for a given ABI arg.\n */\nexport type DefaultArgument =\n  | {\n      /**\n       * The default value should be fetched by invoking an ABI method\n       */\n      source: 'abi-method'\n      data: ABIMethod\n    }\n  | {\n      /**\n       * The default value should be fetched from global state\n       */\n      source: 'global-state'\n      /**\n       * The key of the state variable\n       */\n      data: string\n    }\n  | {\n      /**\n       * The default value should be fetched from the local state of the sender user\n       */\n      source: 'local-state'\n      /**\n       * The key of the state variable\n       */\n      data: string\n    }\n  | {\n      /**\n       * The default value is a constant.\n       */\n      source: 'constant'\n      /**\n       * The static default value to use.\n       */\n      data: string | number\n    }\n\n/** AVM data type */\nexport type AVMType = 'uint64' | 'bytes'\n\n/** Declared schema value specification */\nexport interface DeclaredSchemaValueSpec {\n  /** The type of value */\n  type: AVMType\n  /** The name of the key */\n  key: string\n  /** A description of the variable */\n  descr?: string\n  /** Whether or not the value is set statically (at create time only) or dynamically */\n  static?: boolean\n}\n\n/** Reserved schema value specification */\nexport interface ReservedSchemaValueSpec {\n  /** The type of value */\n  type: AVMType\n  /** The description of the reserved storage space */\n  descr: string\n  /** The maximum number of slots to reserve */\n  max_keys: number\n}\n\n/** The schema for global and local storage */\nexport interface SchemaSpec {\n  /** The local storage schema */\n  local: Schema\n  /** The global storage schema */\n  global: Schema\n}\n\n/** The storage schema definition */\nexport interface Schema {\n  /** Declared storage schema */\n  declared: Record<string, DeclaredSchemaValueSpec>\n  /** Reserved storage schema */\n  reserved: Record<string, ReservedSchemaValueSpec>\n}\n\n/** The rolled-up schema allocation specification for local and global state */\nexport interface StateSchemaSpec {\n  /** Global storage spec */\n  global: StateSchema\n  /** Local storage spec */\n  local: StateSchema\n}\n\n/** Schema spec summary for global or local storage */\nexport type StateSchema = {\n  /** Number of uint slots */\n  num_uints: number\n  /** Number of byte slots */\n  num_byte_slices: number\n}\n"],"mappings":";;;;;;;;;;;;AAmBA,SAAgB,aAAa,SAAiC;CAC5D,MAAM,eAAe,OAAO,OAAO,QAAQ,MAAM,CAAC,SAAS,WAAS,OAAO,QAAQA,OAAK,WAAW,EAAE,CAAC,CAAC;CACvG,MAAM,UAAU,OAAO,YACrB,aAAa,KAAK,CAAC,GAAG,YAAY;EAChC,MAAM,SAAS,OAAO,SAAS,KAAK,OAAO;GAAE,MAAM,EAAE;GAAI,MAAM,EAAE;GAAI,EAAE;AACvE,SAAO,CAAC,OAAO,MAAM,OAAO;GAC5B,CACH;CACD,MAAM,QAAQ,MAAuB,QAAQ,MAAM,4BAA4B,EAAE;CACjF,MAAM,WAAW,GAAoB,SAA4B;AAE/D,SAAO,KAAK,EAAE,EAAE,gBAAgB,SAAY,oBAAoB,KAAK,EAAE,EAAE,aAAc,KAAK,GAAG,EAAE;;CAEnG,MAAM,eAAe,SAA4B;AAC/C,SAAO,oBAAoB,QAAQ,kBAAkB,KAAK;;CAE5D,MAAM,uBAAuB,GAAe,SAA4B;EACtE,MAAMC,YAAwG,EAAE;AAChH,MAAI,EAAE,aAAa,CAAC,OAAO,KAAK,CAAC,SAAS,EAAE,UAAU,CAAE,WAAQ,KAAK,WAAW;AAChF,MAAI,EAAE,sBAAsB,CAAC,OAAO,KAAK,CAAC,SAAS,EAAE,mBAAmB,CAAE,WAAQ,KAAK,oBAAoB;AAC3G,MAAI,EAAE,SAAS,CAAC,OAAO,KAAK,CAAC,SAAS,EAAE,MAAM,CAAE,WAAQ,KAAK,OAAO;AACpE,MAAI,EAAE,UAAU,CAAC,OAAO,KAAK,CAAC,SAAS,EAAE,OAAO,CAAE,WAAQ,KAAK,QAAQ;AACvE,MAAI,EAAE,sBAAsB,CAAC,OAAO,KAAK,CAAC,SAAS,EAAE,mBAAmB,CAAE,WAAQ,KAAK,oBAAoB;AAC3G,SAAOC;;CAET,MAAM,sBACJ,MACA,eAC2D;AAC3D,MAAI,CAAC,WAAY,QAAO;AAExB,MAAI,WAAW,WAAW,aACxB,QAAO;GACL,QAAQ;GACR,MAAM,WAAW,KAAK;GACvB;AAGH,SAAO;GACL,QAAQ,WAAW,WAAW,aAAa,YAAY,WAAW,WAAW,iBAAiB,WAAW;GACzG,MAAM,OAAO,KACX,OAAO,WAAW,SAAS,WAAWC,QAAa,KAAK,SAAS,CAAC,OAAO,WAAW,KAAK,GAAG,WAAW,KACxG,CAAC,SAAS,SAAS;GACpB,MAAM,SAAS,WAAW,cAAc;GACzC;;AAGH,QAAO;EACL,MAAM,EAAE;EACR,MAAM,QAAQ,SAAS;EACvB,MAAM,QAAQ,SAAS;EACd;EACT,SAAS,QAAQ,SAAS,QAAQ,KAC/B,OACE;GACC,MAAM,EAAE;GACR,MAAM,EAAE;GACR,MAAM,EAAE,KAAK,KAAK,OAAO;IACvB,MAAM,EAAE;IACR,MAAM,EAAE;IACR,MAAM,EAAE;IACR,QAAQ,EAAE,OAAO,KAAK,EAAE,EAAE,UAAU,EAAE,OAAO,OAAO;IACpD,cAAc,mBAAmB,EAAE,MAAM,CAAC,EAAE,OAAO,SAAY,KAAK,EAAE,EAAE,oBAAoB,EAAE,MAAM;IACrG,EAAE;GACH,SAAS;IACP,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,QAAQ,KAAK,EAAE,EAAE,SAAS,QAAQ;IACnC;GACD,QAAQ,EAAE;GACV,UAAU,KAAK,EAAE,EAAE;GACnB,SAAS;IACP,QAAQ,QAAQ,GAAG,SAAS;IAC5B,MAAM,QAAQ,GAAG,OAAO;IACzB;GACF,EACJ;EACD,OAAO;GACL,QAAQ;IACN,QAAQ;KACN,MAAM,QAAQ,MAAM,OAAO;KAC3B,OAAO,QAAQ,MAAM,OAAO;KAC7B;IACD,OAAO;KACL,MAAM,QAAQ,MAAM,MAAM;KAC1B,OAAO,QAAQ,MAAM,MAAM;KAC5B;IACF;GACD,MAAM;IACJ,QAAQ,OAAO,YACb,OAAO,QAAQ,QAAQ,OAAO,OAAO,SAAS,CAAC,KAAK,MAAM,CACxD,EAAE,IACF;KACE,KAAK,OAAO,KAAK,EAAE,GAAG,KAAK,QAAQ,CAAC,SAAS,SAAS;KACtD,SAAS;KACT,WAAW,EAAE,GAAG,SAAS,WAAW,cAAc;KAClD,MAAM,EAAE,GAAG;KACZ,CACF,CAAC,CACH;IACD,OAAO,OAAO,YACZ,OAAO,QAAQ,QAAQ,OAAO,MAAM,SAAS,CAAC,KAAK,MAAM,CACvD,EAAE,IACF;KACE,KAAK,OAAO,KAAK,EAAE,GAAG,KAAK,QAAQ,CAAC,SAAS,SAAS;KACtD,SAAS;KACT,WAAW,EAAE,GAAG,SAAS,WAAW,cAAc;KAClD,MAAM,EAAE,GAAG;KACZ,CACF,CAAC,CACH;IACD,KAAK,EAAE;IACR;GACD,MAAM;IACJ,QAAQ,EAAE;IACV,OAAO,EAAE;IACT,KAAK,EAAE;IACR;GACF;EACD,QAAQ,QAAQ;EAChB,aAAa;GACX,QAAQ,YAAY,SAAS;GAC7B,MAAM,YAAY,OAAO;GAC1B;EACD,UAAU;EACV,cAAc;EACd,QAAQ;EACR,UAAU;EACV,kBAAkB;EAClB,YAAY;EACZ,mBAAmB;EACpB;;AAGH,SAAS,4BAA4B,QAAyB;CAC5D,MAAM,OAAO,OAAO,KAAK,KAAK,MAAM,EAAE,KAAK,CAAC,KAAK,IAAI;AACrD,QAAO,GAAG,OAAO,KAAK,GAAG,KAAK,GAAG,OAAO,QAAQ"}
+{"version":3,"file":"app-spec.mjs","names":["hint","actions: ('NoOp' | 'OptIn' | 'CloseOut' | 'ClearState' | 'UpdateApplication' | 'DeleteApplication')[]","actions","defaultValueType: string | undefined","ABITypeClass"],"sources":["../../src/types/app-spec.ts"],"sourcesContent":["import {\n  ABIMethod,\n  ABIType as ABITypeClass,\n  ARC28Event,\n  Arc56Contract,\n  Arc56Method,\n  StorageKey,\n  StructField,\n} from '@algorandfoundation/algokit-abi'\n\n/**\n * Converts an ARC-32 Application Specification to an ARC-56 Contract\n * @param appSpec The ARC-32 Application Specification\n * @returns The ARC-56 Contract\n * @example\n * ```typescript\n * const arc56AppSpec = arc32ToArc56(arc32AppSpec)\n * ```\n */\nexport function arc32ToArc56(appSpec: AppSpec): Arc56Contract {\n  const arc32Structs = Object.values(appSpec.hints).flatMap((hint) => Object.entries(hint.structs ?? {}))\n  const structs = Object.fromEntries(\n    arc32Structs.map(([_, struct]) => {\n      const fields = struct.elements.map((e) => ({ name: e[0], type: e[1] }))\n      return [struct.name, fields]\n    }),\n  ) satisfies { [structName: string]: StructField[] }\n  const hint = (m: ABIMethodParams) => appSpec.hints[getABIMethodParamsSignature(m)] as Hint | undefined\n  const actions = (m: ABIMethodParams, type: 'CREATE' | 'CALL') => {\n    // eslint-disable-next-line @typescript-eslint/no-non-null-asserted-optional-chain\n    return hint(m)?.call_config !== undefined ? callConfigToActions(hint(m)?.call_config!, type) : []\n  }\n  const bareActions = (type: 'CREATE' | 'CALL') => {\n    return callConfigToActions(appSpec.bare_call_config, type)\n  }\n  const callConfigToActions = (c: CallConfig, type: 'CREATE' | 'CALL') => {\n    const actions: ('NoOp' | 'OptIn' | 'CloseOut' | 'ClearState' | 'UpdateApplication' | 'DeleteApplication')[] = []\n    if (c.close_out && ['ALL', type].includes(c.close_out)) actions.push('CloseOut')\n    if (c.delete_application && ['ALL', type].includes(c.delete_application)) actions.push('DeleteApplication')\n    if (c.no_op && ['ALL', type].includes(c.no_op)) actions.push('NoOp')\n    if (c.opt_in && ['ALL', type].includes(c.opt_in)) actions.push('OptIn')\n    if (c.update_application && ['ALL', type].includes(c.update_application)) actions.push('UpdateApplication')\n    return actions\n  }\n  const getDefaultArgValue = (defaultArg: DefaultArgument | undefined): Arc56Contract['methods'][0]['args'][0]['defaultValue'] => {\n    if (!defaultArg) return undefined\n\n    if (defaultArg.source === 'abi-method') {\n      return {\n        source: 'method',\n        data: defaultArg.data.name,\n      }\n    }\n\n    const mappedSource = defaultArg.source === 'constant' ? 'literal' : defaultArg.source === 'global-state' ? 'global' : 'local'\n\n    // type is only set for literal source\n    let defaultValueType: string | undefined = undefined\n    if (mappedSource === 'literal') {\n      if (typeof defaultArg.data === 'number') {\n        defaultValueType = 'uint64'\n      } else if (typeof defaultArg.data === 'string') {\n        defaultValueType = 'AVMString'\n      }\n    }\n\n    const argData =\n      typeof defaultArg.data === 'number'\n        ? ABITypeClass.from('uint64').encode(defaultArg.data)\n        : typeof defaultArg.data === 'string'\n          ? new TextEncoder().encode(defaultArg.data)\n          : defaultArg.data\n\n    return {\n      source: mappedSource,\n      data: Buffer.from(argData).toString('base64'),\n      type: defaultValueType,\n    }\n  }\n\n  return {\n    arcs: [],\n    name: appSpec.contract.name,\n    desc: appSpec.contract.desc,\n    structs: structs,\n    methods: appSpec.contract.methods.map(\n      (m) =>\n        ({\n          name: m.name,\n          desc: m.desc,\n          args: m.args.map((a) => ({\n            name: a.name,\n            type: a.type,\n            desc: a.desc,\n            struct: a.name ? hint(m)?.structs?.[a.name]?.name : undefined,\n            defaultValue: getDefaultArgValue(!a.name ? undefined : hint(m)?.default_arguments?.[a.name]),\n          })),\n          returns: {\n            type: m.returns.type,\n            desc: m.returns.desc,\n            struct: hint(m)?.structs?.output?.name,\n          },\n          events: [],\n          readonly: hint(m)?.read_only,\n          actions: {\n            create: actions(m, 'CREATE') as Arc56Method['actions']['create'],\n            call: actions(m, 'CALL'),\n          },\n        }) satisfies Arc56Method,\n    ),\n    state: {\n      schema: {\n        global: {\n          ints: appSpec.state.global.num_uints,\n          bytes: appSpec.state.global.num_byte_slices,\n        },\n        local: {\n          ints: appSpec.state.local.num_uints,\n          bytes: appSpec.state.local.num_byte_slices,\n        },\n      },\n      keys: {\n        global: Object.fromEntries(\n          Object.entries(appSpec.schema.global.declared).map((s) => [\n            s[0],\n            {\n              key: Buffer.from(s[1].key, 'utf-8').toString('base64'),\n              keyType: 'AVMString',\n              valueType: s[1].type === 'uint64' ? 'AVMUint64' : 'AVMBytes',\n              desc: s[1].descr,\n            } satisfies StorageKey,\n          ]),\n        ),\n        local: Object.fromEntries(\n          Object.entries(appSpec.schema.local.declared).map((s) => [\n            s[0],\n            {\n              key: Buffer.from(s[1].key, 'utf-8').toString('base64'),\n              keyType: 'AVMString',\n              valueType: s[1].type === 'uint64' ? 'AVMUint64' : 'AVMBytes',\n              desc: s[1].descr,\n            } satisfies StorageKey,\n          ]),\n        ),\n        box: {},\n      },\n      maps: {\n        global: {},\n        local: {},\n        box: {},\n      },\n    },\n    source: appSpec.source,\n    bareActions: {\n      create: bareActions('CREATE') as unknown as Arc56Contract['bareActions']['create'],\n      call: bareActions('CALL'),\n    },\n    byteCode: undefined,\n    compilerInfo: undefined,\n    events: undefined,\n    networks: undefined,\n    scratchVariables: undefined,\n    sourceInfo: undefined,\n    templateVariables: undefined,\n  } satisfies Arc56Contract\n}\n\nfunction getABIMethodParamsSignature(params: ABIMethodParams) {\n  const args = params.args.map((a) => a.type).join(',')\n  return `${params.name}(${args})${params.returns.type}`\n}\n\n/** An ARC-0032 Application Specification see https://github.com/algorandfoundation/ARCs/pull/150 */\nexport interface AppSpec {\n  /** Method call hints */\n  hints: HintSpec\n  /** The TEAL source */\n  source: AppSources\n  /** The ABI-0004 contract definition see https://github.com/algorandfoundation/ARCs/blob/main/ARCs/arc-0004.md */\n  contract: ABIContractParams\n  /** The values that make up the local and global state */\n  schema: SchemaSpec\n  /** The rolled-up schema allocation values for local and global state */\n  state: StateSchemaSpec\n  /** The config of all BARE calls (i.e. non ABI calls with no args) */\n  bare_call_config: CallConfig\n}\n\ninterface ABIContractParams {\n  name: string\n  desc?: string\n  networks?: ABIContractNetworks\n  methods: ABIMethodParams[]\n  events?: ARC28Event[]\n}\n\ninterface ABIContractNetworks {\n  [network: string]: ABIContractNetworkInfo\n}\n\ninterface ABIContractNetworkInfo {\n  appID: number\n}\n\ninterface ABIMethodParams {\n  name: string\n  desc?: string\n  args: ABIMethodArgParams[]\n  returns: ABIMethodReturnParams\n  /** Optional, is it a read-only method (according to [ARC-22](https://arc.algorand.foundation/ARCs/arc-0022)) */\n  readonly?: boolean\n  /** [ARC-28](https://arc.algorand.foundation/ARCs/arc-0028) events that MAY be emitted by this method */\n  events?: ARC28Event[]\n}\n\ninterface ABIMethodArgParams {\n  type: string\n  name?: string\n  desc?: string\n}\n\ninterface ABIMethodReturnParams {\n  type: string\n  desc?: string\n}\n\n/** A lookup of encoded method call spec to hint */\nexport type HintSpec = Record<string, Hint>\n\n/** The TEAL source of a contract */\nexport interface AppSources {\n  /** The TEAL source of the approval program */\n  approval: string\n  /** The TEAL source of the clear program */\n  clear: string\n}\n\n/** The various call configs:\n *  * `NEVER`: Will not be called\n *  * `CALL`: Can be called during a non-create call i.e. app id != 0\n *  * `CREATE`: Can be called during a create call i.e. app id = 0\n *  * `ALL`: Can be during a create OR non-create call\n **/\nexport type CallConfigValue = 'NEVER' | 'CALL' | 'CREATE' | 'ALL'\n\n/** Call configuration for a method */\nexport interface CallConfig {\n  /** NoOp call config */\n  no_op?: CallConfigValue\n  /** Opt-in call config */\n  opt_in?: CallConfigValue\n  /** Close out call config */\n  close_out?: CallConfigValue\n  /** Update call config */\n  update_application?: CallConfigValue\n  /** Delete call config */\n  delete_application?: CallConfigValue\n}\n\n/** Hint information for a given method call to allow client generation */\nexport interface Hint {\n  /** Any user-defined struct/tuple types used in the method call, keyed by parameter name or `output` for return type */\n  structs?: Record<string, Struct>\n  read_only?: boolean\n  default_arguments?: Record<string, DefaultArgument>\n  call_config: CallConfig\n}\n\n/** The name of a field */\nexport type FieldName = string\n\n/** The string name of an ABI type */\nexport type ABIType = string\n\n/** The elements of the struct/tuple: `FieldName`, `ABIType` */\nexport type StructElement = [FieldName, ABIType]\n\n/** A user-defined struct/tuple type */\nexport interface Struct {\n  /** The name of the type */\n  name: string\n  /** The elements (in order) that make up the struct/tuple */\n  elements: StructElement[]\n}\n\n/**\n * Defines a strategy for obtaining a default value for a given ABI arg.\n */\nexport type DefaultArgument =\n  | {\n      /**\n       * The default value should be fetched by invoking an ABI method\n       */\n      source: 'abi-method'\n      data: ABIMethod\n    }\n  | {\n      /**\n       * The default value should be fetched from global state\n       */\n      source: 'global-state'\n      /**\n       * The key of the state variable\n       */\n      data: string\n    }\n  | {\n      /**\n       * The default value should be fetched from the local state of the sender user\n       */\n      source: 'local-state'\n      /**\n       * The key of the state variable\n       */\n      data: string\n    }\n  | {\n      /**\n       * The default value is a constant.\n       */\n      source: 'constant'\n      /**\n       * The static default value to use.\n       */\n      data: string | number\n    }\n\n/** AVM data type */\nexport type AVMType = 'uint64' | 'bytes'\n\n/** Declared schema value specification */\nexport interface DeclaredSchemaValueSpec {\n  /** The type of value */\n  type: AVMType\n  /** The name of the key */\n  key: string\n  /** A description of the variable */\n  descr?: string\n  /** Whether or not the value is set statically (at create time only) or dynamically */\n  static?: boolean\n}\n\n/** Reserved schema value specification */\nexport interface ReservedSchemaValueSpec {\n  /** The type of value */\n  type: AVMType\n  /** The description of the reserved storage space */\n  descr: string\n  /** The maximum number of slots to reserve */\n  max_keys: number\n}\n\n/** The schema for global and local storage */\nexport interface SchemaSpec {\n  /** The local storage schema */\n  local: Schema\n  /** The global storage schema */\n  global: Schema\n}\n\n/** The storage schema definition */\nexport interface Schema {\n  /** Declared storage schema */\n  declared: Record<string, DeclaredSchemaValueSpec>\n  /** Reserved storage schema */\n  reserved: Record<string, ReservedSchemaValueSpec>\n}\n\n/** The rolled-up schema allocation specification for local and global state */\nexport interface StateSchemaSpec {\n  /** Global storage spec */\n  global: StateSchema\n  /** Local storage spec */\n  local: StateSchema\n}\n\n/** Schema spec summary for global or local storage */\nexport type StateSchema = {\n  /** Number of uint slots */\n  num_uints: number\n  /** Number of byte slots */\n  num_byte_slices: number\n}\n"],"mappings":"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"}