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

package/algo25/index.d.ts

@@ -0,0 +1,2 @@
+import { FAIL_TO_DECODE_MNEMONIC_ERROR_MSG, NOT_IN_WORDS_LIST_ERROR_MSG, masterDerivationKeyToMnemonic, mnemonicFromSeed, mnemonicToMasterDerivationKey, secretKeyToMnemonic, seedFromMnemonic } from "../packages/algo25/src/index.js";
+export { FAIL_TO_DECODE_MNEMONIC_ERROR_MSG, NOT_IN_WORDS_LIST_ERROR_MSG, masterDerivationKeyToMnemonic, mnemonicFromSeed, mnemonicToMasterDerivationKey, secretKeyToMnemonic, seedFromMnemonic };

package/algo25/index.js

@@ -0,0 +1,9 @@
+const require_index = require('../packages/algo25/src/index.js');
+
+exports.FAIL_TO_DECODE_MNEMONIC_ERROR_MSG = require_index.FAIL_TO_DECODE_MNEMONIC_ERROR_MSG;
+exports.NOT_IN_WORDS_LIST_ERROR_MSG = require_index.NOT_IN_WORDS_LIST_ERROR_MSG;
+exports.masterDerivationKeyToMnemonic = require_index.masterDerivationKeyToMnemonic;
+exports.mnemonicFromSeed = require_index.mnemonicFromSeed;
+exports.mnemonicToMasterDerivationKey = require_index.mnemonicToMasterDerivationKey;
+exports.secretKeyToMnemonic = require_index.secretKeyToMnemonic;
+exports.seedFromMnemonic = require_index.seedFromMnemonic;

package/algo25/index.mjs

@@ -0,0 +1,3 @@
+import { FAIL_TO_DECODE_MNEMONIC_ERROR_MSG, NOT_IN_WORDS_LIST_ERROR_MSG, masterDerivationKeyToMnemonic, mnemonicFromSeed, mnemonicToMasterDerivationKey, secretKeyToMnemonic, seedFromMnemonic } from "../packages/algo25/src/index.mjs";
+
+export { FAIL_TO_DECODE_MNEMONIC_ERROR_MSG, NOT_IN_WORDS_LIST_ERROR_MSG, masterDerivationKeyToMnemonic, mnemonicFromSeed, mnemonicToMasterDerivationKey, secretKeyToMnemonic, seedFromMnemonic };

package/package.json

@@ -6,7 +6,7 @@
     "**"
   ],
   "name": "@algorandfoundation/algokit-utils",
-  "version": "10.0.0-alpha.2",
+  "version": "10.0.0-alpha.4",
   "private": false,
   "description": "A set of core Algorand utilities written in TypeScript and released via npm that make it easier to build solutions on Algorand.",
   "author": "Algorand Foundation",

package/packages/abi/src/abi-method.d.ts

@@ -61,7 +61,7 @@ type ABIReturn = {
   rawReturnValue?: undefined;
   returnValue?: undefined;
   method: ABIMethod;
-  decodeError: Error;
+  decodeError?: Error;
 };
 declare class ABIMethod {
   readonly name: string;

package/packages/abi/src/abi-method.js.map

@@ -1 +1 @@
-{"version":3,"file":"abi-method.js","names":["sha512","parseTupleContent","ABIType","convertedDefaultValue: ABIDefaultValue | undefined","ABIStructType","ABIUintType","ABIAddressType"],"sources":["../../../../packages/abi/src/abi-method.ts"],"sourcesContent":["import sha512 from 'js-sha512'\nimport { ABIAddressType, ABIStructType, ABIType, ABIUintType, parseTupleContent } from './abi-type'\nimport { ABIValue } from './abi-value'\nimport { ARC28Event } from './arc28-event'\nimport { AVMType, Arc56Contract, Arc56Method } from './arc56-contract'\n\nexport enum ABITransactionType {\n  Txn = 'txn',\n  Payment = 'pay',\n  KeyRegistration = 'keyreg',\n  AssetConfig = 'acfg',\n  AssetTransfer = 'axfer',\n  AssetFreeze = 'afrz',\n  AppCall = 'appl',\n}\nexport enum ABIReferenceType {\n  Account = 'account',\n  Application = 'application',\n  Asset = 'asset',\n}\nexport type ABIMethodArgType = ABIType | ABITransactionType | ABIReferenceType\nexport type ABIMethodReturnType = ABIType | 'void'\n\nexport type ABIMethodArg = {\n  type: ABIMethodArgType\n  name?: string\n  description?: string\n  defaultValue?: ABIDefaultValue\n}\n\nexport type ABIMethodReturn = {\n  type: ABIMethodReturnType\n  description?: string\n}\n\nexport type ABIDefaultValue = {\n  /** Base64 encoded bytes, base64 ARC4 encoded uint64, or UTF-8 method selector */\n  data: string\n  /** Where the default value is coming from */\n  source: DefaultValueSource\n  /** How the data is encoded. This is the encoding for the data provided here, not the arg type */\n  type?: ABIType | AVMType\n}\n\nexport enum DefaultValueSource {\n  Box = 'box',\n  Global = 'global',\n  Local = 'local',\n  Literal = 'literal',\n  Method = 'method',\n}\n\n/** Represents an ABI method return value with parsed data. */\nexport type ABIReturn =\n  | {\n      /** The method that was called. */\n      method: ABIMethod\n      /** The raw return value as bytes.\n       *\n       * This is the value from the last app call log with the first 4 bytes (the ABI return prefix) omitted.\n       */\n      rawReturnValue: Uint8Array\n      /** The parsed ABI return value. */\n      returnValue: ABIValue\n      decodeError: undefined\n    }\n  | { rawReturnValue?: undefined; returnValue?: undefined; method: ABIMethod; decodeError: Error }\n\n/** Decoded ARC-56 struct as a struct rather than a tuple. */\nexport type ABIStruct = {\n  [key: string]: ABIStruct | ABIValue\n}\n\nexport class ABIMethod {\n  readonly name: string\n  readonly description?: string\n  readonly args: ABIMethodArg[]\n  readonly returns: ABIMethodReturn\n  readonly events?: ARC28Event[]\n  readonly readonly?: boolean\n\n  constructor(params: {\n    name: string\n    description?: string\n    args: ABIMethodArg[]\n    returns: ABIMethodReturn\n    events?: ARC28Event[]\n    readonly?: boolean\n  }) {\n    this.name = params.name\n    this.description = params.description\n    this.args = params.args\n    this.returns = params.returns\n    this.events = params.events\n    this.readonly = params.readonly\n  }\n\n  /**\n   * Returns the signature of this ABI method.\n   * @returns The signature, e.g. `my_method(unit64,string)bytes`\n   */\n  getSignature(): string {\n    const args = this.args\n      .map((arg) => {\n        if (argTypeIsTransaction(arg.type) || argTypeIsReference(arg.type)) return arg.type\n        return arg.type.name\n      })\n      .join(',')\n    const returns = this.returns.type === 'void' ? 'void' : this.returns.type.name\n    return `${this.name}(${args})${returns}`\n  }\n\n  /**\n   * Returns the method selector of this ABI method.\n   * @returns The 4-byte method selector\n   */\n  getSelector(): Uint8Array {\n    const hash = sha512.sha512_256.array(this.getSignature())\n    return new Uint8Array(hash.slice(0, 4))\n  }\n\n  /**\n   * Returns the ABI method object for a given method signature.\n   * @param signature The method signature\n   * e.g. `my_method(unit64,string)bytes`\n   * @returns The `ABIMethod`\n   */\n  static fromSignature(signature: string): ABIMethod {\n    const argsStart = signature.indexOf('(')\n    if (argsStart === -1) {\n      throw new Error(`Invalid method signature: ${signature}`)\n    }\n\n    let argsEnd = -1\n    let depth = 0\n    for (let i = argsStart; i < signature.length; i++) {\n      const char = signature[i]\n\n      if (char === '(') {\n        depth += 1\n      } else if (char === ')') {\n        if (depth === 0) {\n          // unpaired parenthesis\n          break\n        }\n\n        depth -= 1\n        if (depth === 0) {\n          argsEnd = i\n          break\n        }\n      }\n    }\n\n    if (argsEnd === -1) {\n      throw new Error(`Invalid method signature: ${signature}`)\n    }\n\n    const name = signature.slice(0, argsStart)\n    const args = parseTupleContent(signature.slice(argsStart + 1, argsEnd)).map((n: string) => {\n      if (argTypeIsTransaction(n as ABIMethodArgType) || argTypeIsReference(n as ABIMethodArgType)) {\n        return { type: n as ABIMethodArgType } satisfies ABIMethodArg\n      }\n      return { type: ABIType.from(n) } satisfies ABIMethodArg\n    })\n    const returnType = signature.slice(argsEnd + 1)\n    const returns = { type: returnType === 'void' ? ('void' as const) : ABIType.from(returnType) } satisfies ABIMethodReturn\n\n    return new ABIMethod({\n      name,\n      args,\n      returns,\n    })\n  }\n}\n\n/**\n * Returns the ABI method object for a given method name or signature and ARC-56 app spec.\n * @param methodNameOrSignature The method name or method signature to call if an ABI call is being emitted.\n * e.g. `my_method` or `my_method(unit64,string)bytes`\n * @param appSpec The app spec for the app\n * @returns The `ABIMethod`\n */\nexport function getABIMethod(methodNameOrSignature: string, appSpec: Arc56Contract): ABIMethod {\n  if (!methodNameOrSignature.includes('(')) {\n    const methods = appSpec.methods.filter((m) => m.name === methodNameOrSignature)\n    if (methods.length === 0) throw new Error(`Unable to find method ${methodNameOrSignature} in ${appSpec.name} app.`)\n    if (methods.length > 1) {\n      throw new Error(\n        `Received a call to method ${methodNameOrSignature} in contract ${\n          appSpec.name\n        }, but this resolved to multiple methods; please pass in an ABI signature instead: ${appSpec.methods\n          .map((m) => getArc56MethodSignature(m))\n          .join(', ')}`,\n      )\n    }\n    return arc56MethodToABIMethod(methods[0], appSpec)\n  } else {\n    const method = appSpec.methods.find((m) => getArc56MethodSignature(m) === methodNameOrSignature)\n    if (!method) throw new Error(`Unable to find method ${methodNameOrSignature} in ${appSpec.name} app.`)\n    return arc56MethodToABIMethod(method, appSpec)\n  }\n}\n\nexport function arc56MethodToABIMethod(method: Arc56Method, appSpec: Arc56Contract): ABIMethod {\n  if (typeof method.name !== 'string' || typeof method.returns !== 'object' || !Array.isArray(method.args)) {\n    throw new Error('Invalid ABIMethod parameters')\n  }\n\n  const args = method.args.map(({ type, name, desc, struct, defaultValue }) => {\n    const convertedDefaultValue: ABIDefaultValue | undefined = defaultValue\n      ? {\n          data: defaultValue.data,\n          source: defaultValue.source as DefaultValueSource,\n          type: defaultValue.type ? (isAVMType(defaultValue.type) ? defaultValue.type : ABIType.from(defaultValue.type)) : undefined,\n        }\n      : undefined\n\n    if (argTypeIsTransaction(type as ABIMethodArgType) || argTypeIsReference(type as ABIMethodArgType)) {\n      return {\n        type: type as ABIMethodArgType,\n        name,\n        description: desc,\n        defaultValue: convertedDefaultValue,\n      } satisfies ABIMethodArg\n    }\n\n    if (struct) {\n      return {\n        type: ABIStructType.fromStruct(struct, appSpec.structs),\n        name,\n        description: desc,\n        defaultValue: convertedDefaultValue,\n      } satisfies ABIMethodArg\n    }\n\n    return {\n      type: ABIType.from(type),\n      name,\n      description: desc,\n      defaultValue: convertedDefaultValue,\n    } satisfies ABIMethodArg\n  })\n\n  const returns = {\n    type:\n      method.returns.type === ('void' as const)\n        ? ('void' as const)\n        : method.returns.struct\n          ? ABIStructType.fromStruct(method.returns.struct, appSpec.structs)\n          : ABIType.from(method.returns.type),\n    desc: method.returns.desc,\n  }\n\n  return new ABIMethod({\n    name: method.name,\n    description: method.desc,\n    args,\n    returns,\n    events: method.events,\n    readonly: method.readonly,\n  })\n}\n\nexport function argTypeIsTransaction(type: ABIMethodArgType): type is ABITransactionType {\n  return (\n    typeof type === 'string' &&\n    (type === ABITransactionType.Txn ||\n      type === ABITransactionType.Payment ||\n      type === ABITransactionType.KeyRegistration ||\n      type === ABITransactionType.AssetConfig ||\n      type === ABITransactionType.AssetTransfer ||\n      type === ABITransactionType.AssetFreeze ||\n      type === ABITransactionType.AppCall)\n  )\n}\n\nexport function argTypeIsReference(type: ABIMethodArgType): type is ABIReferenceType {\n  return (\n    typeof type === 'string' &&\n    (type === ABIReferenceType.Account || type === ABIReferenceType.Application || type === ABIReferenceType.Asset)\n  )\n}\n\nexport function argTypeIsAbiType(type: ABIMethodArgType): type is ABIType {\n  return !argTypeIsTransaction(type) && !argTypeIsReference(type)\n}\n\nfunction getArc56MethodSignature(method: Arc56Method): string {\n  const args = method.args.map((arg) => arg.type).join(',')\n  const returns = method.returns.type\n  return `${method.name}(${args})${returns}`\n}\n\nexport function decodeAVMValue(avmType: AVMType, bytes: Uint8Array): ABIValue {\n  switch (avmType) {\n    case 'AVMString':\n      return Buffer.from(bytes).toString('utf-8')\n    case 'AVMBytes':\n      return bytes\n    case 'AVMUint64':\n      return ABIType.from('uint64').decode(bytes)\n  }\n}\n\nexport function encodeAVMValue(avmType: AVMType, value: ABIValue): Uint8Array {\n  switch (avmType) {\n    case 'AVMString':\n      return ABIType.from('string').encode(value)\n    case 'AVMBytes':\n      if (typeof value === 'string') return Buffer.from(value, 'utf-8')\n      if (typeof value !== 'object' || !(value instanceof Uint8Array))\n        throw new Error(`Expected bytes value for AVMBytes, but got ${value}`)\n      return value\n    case 'AVMUint64':\n      return ABIType.from('uint64').encode(value)\n  }\n}\n\nexport function isAVMType(type: unknown): type is AVMType {\n  return typeof type === 'string' && (type === 'AVMString' || type === 'AVMBytes' || type === 'AVMUint64')\n}\n\nexport function getABIDecodedValue(type: AVMType | ABIType | ABIReferenceType, bytes: Uint8Array): ABIValue {\n  if (type === ABIReferenceType.Asset || type === ABIReferenceType.Application) {\n    return new ABIUintType(64).decode(bytes)\n  } else if (type === ABIReferenceType.Account) {\n    return new ABIAddressType().decode(bytes)\n  } else if (isAVMType(type)) {\n    return decodeAVMValue(type, bytes)\n  }\n  return type.decode(bytes)\n}\n\nexport function getABIEncodedValue(type: AVMType | ABIType, value: ABIValue): Uint8Array {\n  return isAVMType(type) ? encodeAVMValue(type, value) : type.encode(value)\n}\n"],"mappings":"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"}
+{"version":3,"file":"abi-method.js","names":["sha512","parseTupleContent","ABIType","convertedDefaultValue: ABIDefaultValue | undefined","ABIStructType","ABIUintType","ABIAddressType"],"sources":["../../../../packages/abi/src/abi-method.ts"],"sourcesContent":["import sha512 from 'js-sha512'\nimport { ABIAddressType, ABIStructType, ABIType, ABIUintType, parseTupleContent } from './abi-type'\nimport { ABIValue } from './abi-value'\nimport { ARC28Event } from './arc28-event'\nimport { AVMType, Arc56Contract, Arc56Method } from './arc56-contract'\n\nexport enum ABITransactionType {\n  Txn = 'txn',\n  Payment = 'pay',\n  KeyRegistration = 'keyreg',\n  AssetConfig = 'acfg',\n  AssetTransfer = 'axfer',\n  AssetFreeze = 'afrz',\n  AppCall = 'appl',\n}\nexport enum ABIReferenceType {\n  Account = 'account',\n  Application = 'application',\n  Asset = 'asset',\n}\nexport type ABIMethodArgType = ABIType | ABITransactionType | ABIReferenceType\nexport type ABIMethodReturnType = ABIType | 'void'\n\nexport type ABIMethodArg = {\n  type: ABIMethodArgType\n  name?: string\n  description?: string\n  defaultValue?: ABIDefaultValue\n}\n\nexport type ABIMethodReturn = {\n  type: ABIMethodReturnType\n  description?: string\n}\n\nexport type ABIDefaultValue = {\n  /** Base64 encoded bytes, base64 ARC4 encoded uint64, or UTF-8 method selector */\n  data: string\n  /** Where the default value is coming from */\n  source: DefaultValueSource\n  /** How the data is encoded. This is the encoding for the data provided here, not the arg type */\n  type?: ABIType | AVMType\n}\n\nexport enum DefaultValueSource {\n  Box = 'box',\n  Global = 'global',\n  Local = 'local',\n  Literal = 'literal',\n  Method = 'method',\n}\n\n/** Represents an ABI method return value with parsed data. */\nexport type ABIReturn =\n  | {\n      /** The method that was called. */\n      method: ABIMethod\n      /** The raw return value as bytes.\n       *\n       * This is the value from the last app call log with the first 4 bytes (the ABI return prefix) omitted.\n       */\n      rawReturnValue: Uint8Array\n      /** The parsed ABI return value. */\n      returnValue: ABIValue\n      decodeError: undefined\n    }\n  | { rawReturnValue?: undefined; returnValue?: undefined; method: ABIMethod; decodeError?: Error }\n\n/** Decoded ARC-56 struct as a struct rather than a tuple. */\nexport type ABIStruct = {\n  [key: string]: ABIStruct | ABIValue\n}\n\nexport class ABIMethod {\n  readonly name: string\n  readonly description?: string\n  readonly args: ABIMethodArg[]\n  readonly returns: ABIMethodReturn\n  readonly events?: ARC28Event[]\n  readonly readonly?: boolean\n\n  constructor(params: {\n    name: string\n    description?: string\n    args: ABIMethodArg[]\n    returns: ABIMethodReturn\n    events?: ARC28Event[]\n    readonly?: boolean\n  }) {\n    this.name = params.name\n    this.description = params.description\n    this.args = params.args\n    this.returns = params.returns\n    this.events = params.events\n    this.readonly = params.readonly\n  }\n\n  /**\n   * Returns the signature of this ABI method.\n   * @returns The signature, e.g. `my_method(unit64,string)bytes`\n   */\n  getSignature(): string {\n    const args = this.args\n      .map((arg) => {\n        if (argTypeIsTransaction(arg.type) || argTypeIsReference(arg.type)) return arg.type\n        return arg.type.name\n      })\n      .join(',')\n    const returns = this.returns.type === 'void' ? 'void' : this.returns.type.name\n    return `${this.name}(${args})${returns}`\n  }\n\n  /**\n   * Returns the method selector of this ABI method.\n   * @returns The 4-byte method selector\n   */\n  getSelector(): Uint8Array {\n    const hash = sha512.sha512_256.array(this.getSignature())\n    return new Uint8Array(hash.slice(0, 4))\n  }\n\n  /**\n   * Returns the ABI method object for a given method signature.\n   * @param signature The method signature\n   * e.g. `my_method(unit64,string)bytes`\n   * @returns The `ABIMethod`\n   */\n  static fromSignature(signature: string): ABIMethod {\n    const argsStart = signature.indexOf('(')\n    if (argsStart === -1) {\n      throw new Error(`Invalid method signature: ${signature}`)\n    }\n\n    let argsEnd = -1\n    let depth = 0\n    for (let i = argsStart; i < signature.length; i++) {\n      const char = signature[i]\n\n      if (char === '(') {\n        depth += 1\n      } else if (char === ')') {\n        if (depth === 0) {\n          // unpaired parenthesis\n          break\n        }\n\n        depth -= 1\n        if (depth === 0) {\n          argsEnd = i\n          break\n        }\n      }\n    }\n\n    if (argsEnd === -1) {\n      throw new Error(`Invalid method signature: ${signature}`)\n    }\n\n    const name = signature.slice(0, argsStart)\n    const args = parseTupleContent(signature.slice(argsStart + 1, argsEnd)).map((n: string) => {\n      if (argTypeIsTransaction(n as ABIMethodArgType) || argTypeIsReference(n as ABIMethodArgType)) {\n        return { type: n as ABIMethodArgType } satisfies ABIMethodArg\n      }\n      return { type: ABIType.from(n) } satisfies ABIMethodArg\n    })\n    const returnType = signature.slice(argsEnd + 1)\n    const returns = { type: returnType === 'void' ? ('void' as const) : ABIType.from(returnType) } satisfies ABIMethodReturn\n\n    return new ABIMethod({\n      name,\n      args,\n      returns,\n    })\n  }\n}\n\n/**\n * Returns the ABI method object for a given method name or signature and ARC-56 app spec.\n * @param methodNameOrSignature The method name or method signature to call if an ABI call is being emitted.\n * e.g. `my_method` or `my_method(unit64,string)bytes`\n * @param appSpec The app spec for the app\n * @returns The `ABIMethod`\n */\nexport function getABIMethod(methodNameOrSignature: string, appSpec: Arc56Contract): ABIMethod {\n  if (!methodNameOrSignature.includes('(')) {\n    const methods = appSpec.methods.filter((m) => m.name === methodNameOrSignature)\n    if (methods.length === 0) throw new Error(`Unable to find method ${methodNameOrSignature} in ${appSpec.name} app.`)\n    if (methods.length > 1) {\n      throw new Error(\n        `Received a call to method ${methodNameOrSignature} in contract ${\n          appSpec.name\n        }, but this resolved to multiple methods; please pass in an ABI signature instead: ${appSpec.methods\n          .map((m) => getArc56MethodSignature(m))\n          .join(', ')}`,\n      )\n    }\n    return arc56MethodToABIMethod(methods[0], appSpec)\n  } else {\n    const method = appSpec.methods.find((m) => getArc56MethodSignature(m) === methodNameOrSignature)\n    if (!method) throw new Error(`Unable to find method ${methodNameOrSignature} in ${appSpec.name} app.`)\n    return arc56MethodToABIMethod(method, appSpec)\n  }\n}\n\nexport function arc56MethodToABIMethod(method: Arc56Method, appSpec: Arc56Contract): ABIMethod {\n  if (typeof method.name !== 'string' || typeof method.returns !== 'object' || !Array.isArray(method.args)) {\n    throw new Error('Invalid ABIMethod parameters')\n  }\n\n  const args = method.args.map(({ type, name, desc, struct, defaultValue }) => {\n    const convertedDefaultValue: ABIDefaultValue | undefined = defaultValue\n      ? {\n          data: defaultValue.data,\n          source: defaultValue.source as DefaultValueSource,\n          type: defaultValue.type ? (isAVMType(defaultValue.type) ? defaultValue.type : ABIType.from(defaultValue.type)) : undefined,\n        }\n      : undefined\n\n    if (argTypeIsTransaction(type as ABIMethodArgType) || argTypeIsReference(type as ABIMethodArgType)) {\n      return {\n        type: type as ABIMethodArgType,\n        name,\n        description: desc,\n        defaultValue: convertedDefaultValue,\n      } satisfies ABIMethodArg\n    }\n\n    if (struct) {\n      return {\n        type: ABIStructType.fromStruct(struct, appSpec.structs),\n        name,\n        description: desc,\n        defaultValue: convertedDefaultValue,\n      } satisfies ABIMethodArg\n    }\n\n    return {\n      type: ABIType.from(type),\n      name,\n      description: desc,\n      defaultValue: convertedDefaultValue,\n    } satisfies ABIMethodArg\n  })\n\n  const returns = {\n    type:\n      method.returns.type === ('void' as const)\n        ? ('void' as const)\n        : method.returns.struct\n          ? ABIStructType.fromStruct(method.returns.struct, appSpec.structs)\n          : ABIType.from(method.returns.type),\n    desc: method.returns.desc,\n  }\n\n  return new ABIMethod({\n    name: method.name,\n    description: method.desc,\n    args,\n    returns,\n    events: method.events,\n    readonly: method.readonly,\n  })\n}\n\nexport function argTypeIsTransaction(type: ABIMethodArgType): type is ABITransactionType {\n  return (\n    typeof type === 'string' &&\n    (type === ABITransactionType.Txn ||\n      type === ABITransactionType.Payment ||\n      type === ABITransactionType.KeyRegistration ||\n      type === ABITransactionType.AssetConfig ||\n      type === ABITransactionType.AssetTransfer ||\n      type === ABITransactionType.AssetFreeze ||\n      type === ABITransactionType.AppCall)\n  )\n}\n\nexport function argTypeIsReference(type: ABIMethodArgType): type is ABIReferenceType {\n  return (\n    typeof type === 'string' &&\n    (type === ABIReferenceType.Account || type === ABIReferenceType.Application || type === ABIReferenceType.Asset)\n  )\n}\n\nexport function argTypeIsAbiType(type: ABIMethodArgType): type is ABIType {\n  return !argTypeIsTransaction(type) && !argTypeIsReference(type)\n}\n\nfunction getArc56MethodSignature(method: Arc56Method): string {\n  const args = method.args.map((arg) => arg.type).join(',')\n  const returns = method.returns.type\n  return `${method.name}(${args})${returns}`\n}\n\nexport function decodeAVMValue(avmType: AVMType, bytes: Uint8Array): ABIValue {\n  switch (avmType) {\n    case 'AVMString':\n      return Buffer.from(bytes).toString('utf-8')\n    case 'AVMBytes':\n      return bytes\n    case 'AVMUint64':\n      return ABIType.from('uint64').decode(bytes)\n  }\n}\n\nexport function encodeAVMValue(avmType: AVMType, value: ABIValue): Uint8Array {\n  switch (avmType) {\n    case 'AVMString':\n      return ABIType.from('string').encode(value)\n    case 'AVMBytes':\n      if (typeof value === 'string') return Buffer.from(value, 'utf-8')\n      if (typeof value !== 'object' || !(value instanceof Uint8Array))\n        throw new Error(`Expected bytes value for AVMBytes, but got ${value}`)\n      return value\n    case 'AVMUint64':\n      return ABIType.from('uint64').encode(value)\n  }\n}\n\nexport function isAVMType(type: unknown): type is AVMType {\n  return typeof type === 'string' && (type === 'AVMString' || type === 'AVMBytes' || type === 'AVMUint64')\n}\n\nexport function getABIDecodedValue(type: AVMType | ABIType | ABIReferenceType, bytes: Uint8Array): ABIValue {\n  if (type === ABIReferenceType.Asset || type === ABIReferenceType.Application) {\n    return new ABIUintType(64).decode(bytes)\n  } else if (type === ABIReferenceType.Account) {\n    return new ABIAddressType().decode(bytes)\n  } else if (isAVMType(type)) {\n    return decodeAVMValue(type, bytes)\n  }\n  return type.decode(bytes)\n}\n\nexport function getABIEncodedValue(type: AVMType | ABIType, value: ABIValue): Uint8Array {\n  return isAVMType(type) ? encodeAVMValue(type, value) : type.encode(value)\n}\n"],"mappings":"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"}

package/packages/abi/src/abi-method.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"abi-method.mjs","names":["convertedDefaultValue: ABIDefaultValue | undefined"],"sources":["../../../../packages/abi/src/abi-method.ts"],"sourcesContent":["import sha512 from 'js-sha512'\nimport { ABIAddressType, ABIStructType, ABIType, ABIUintType, parseTupleContent } from './abi-type'\nimport { ABIValue } from './abi-value'\nimport { ARC28Event } from './arc28-event'\nimport { AVMType, Arc56Contract, Arc56Method } from './arc56-contract'\n\nexport enum ABITransactionType {\n  Txn = 'txn',\n  Payment = 'pay',\n  KeyRegistration = 'keyreg',\n  AssetConfig = 'acfg',\n  AssetTransfer = 'axfer',\n  AssetFreeze = 'afrz',\n  AppCall = 'appl',\n}\nexport enum ABIReferenceType {\n  Account = 'account',\n  Application = 'application',\n  Asset = 'asset',\n}\nexport type ABIMethodArgType = ABIType | ABITransactionType | ABIReferenceType\nexport type ABIMethodReturnType = ABIType | 'void'\n\nexport type ABIMethodArg = {\n  type: ABIMethodArgType\n  name?: string\n  description?: string\n  defaultValue?: ABIDefaultValue\n}\n\nexport type ABIMethodReturn = {\n  type: ABIMethodReturnType\n  description?: string\n}\n\nexport type ABIDefaultValue = {\n  /** Base64 encoded bytes, base64 ARC4 encoded uint64, or UTF-8 method selector */\n  data: string\n  /** Where the default value is coming from */\n  source: DefaultValueSource\n  /** How the data is encoded. This is the encoding for the data provided here, not the arg type */\n  type?: ABIType | AVMType\n}\n\nexport enum DefaultValueSource {\n  Box = 'box',\n  Global = 'global',\n  Local = 'local',\n  Literal = 'literal',\n  Method = 'method',\n}\n\n/** Represents an ABI method return value with parsed data. */\nexport type ABIReturn =\n  | {\n      /** The method that was called. */\n      method: ABIMethod\n      /** The raw return value as bytes.\n       *\n       * This is the value from the last app call log with the first 4 bytes (the ABI return prefix) omitted.\n       */\n      rawReturnValue: Uint8Array\n      /** The parsed ABI return value. */\n      returnValue: ABIValue\n      decodeError: undefined\n    }\n  | { rawReturnValue?: undefined; returnValue?: undefined; method: ABIMethod; decodeError: Error }\n\n/** Decoded ARC-56 struct as a struct rather than a tuple. */\nexport type ABIStruct = {\n  [key: string]: ABIStruct | ABIValue\n}\n\nexport class ABIMethod {\n  readonly name: string\n  readonly description?: string\n  readonly args: ABIMethodArg[]\n  readonly returns: ABIMethodReturn\n  readonly events?: ARC28Event[]\n  readonly readonly?: boolean\n\n  constructor(params: {\n    name: string\n    description?: string\n    args: ABIMethodArg[]\n    returns: ABIMethodReturn\n    events?: ARC28Event[]\n    readonly?: boolean\n  }) {\n    this.name = params.name\n    this.description = params.description\n    this.args = params.args\n    this.returns = params.returns\n    this.events = params.events\n    this.readonly = params.readonly\n  }\n\n  /**\n   * Returns the signature of this ABI method.\n   * @returns The signature, e.g. `my_method(unit64,string)bytes`\n   */\n  getSignature(): string {\n    const args = this.args\n      .map((arg) => {\n        if (argTypeIsTransaction(arg.type) || argTypeIsReference(arg.type)) return arg.type\n        return arg.type.name\n      })\n      .join(',')\n    const returns = this.returns.type === 'void' ? 'void' : this.returns.type.name\n    return `${this.name}(${args})${returns}`\n  }\n\n  /**\n   * Returns the method selector of this ABI method.\n   * @returns The 4-byte method selector\n   */\n  getSelector(): Uint8Array {\n    const hash = sha512.sha512_256.array(this.getSignature())\n    return new Uint8Array(hash.slice(0, 4))\n  }\n\n  /**\n   * Returns the ABI method object for a given method signature.\n   * @param signature The method signature\n   * e.g. `my_method(unit64,string)bytes`\n   * @returns The `ABIMethod`\n   */\n  static fromSignature(signature: string): ABIMethod {\n    const argsStart = signature.indexOf('(')\n    if (argsStart === -1) {\n      throw new Error(`Invalid method signature: ${signature}`)\n    }\n\n    let argsEnd = -1\n    let depth = 0\n    for (let i = argsStart; i < signature.length; i++) {\n      const char = signature[i]\n\n      if (char === '(') {\n        depth += 1\n      } else if (char === ')') {\n        if (depth === 0) {\n          // unpaired parenthesis\n          break\n        }\n\n        depth -= 1\n        if (depth === 0) {\n          argsEnd = i\n          break\n        }\n      }\n    }\n\n    if (argsEnd === -1) {\n      throw new Error(`Invalid method signature: ${signature}`)\n    }\n\n    const name = signature.slice(0, argsStart)\n    const args = parseTupleContent(signature.slice(argsStart + 1, argsEnd)).map((n: string) => {\n      if (argTypeIsTransaction(n as ABIMethodArgType) || argTypeIsReference(n as ABIMethodArgType)) {\n        return { type: n as ABIMethodArgType } satisfies ABIMethodArg\n      }\n      return { type: ABIType.from(n) } satisfies ABIMethodArg\n    })\n    const returnType = signature.slice(argsEnd + 1)\n    const returns = { type: returnType === 'void' ? ('void' as const) : ABIType.from(returnType) } satisfies ABIMethodReturn\n\n    return new ABIMethod({\n      name,\n      args,\n      returns,\n    })\n  }\n}\n\n/**\n * Returns the ABI method object for a given method name or signature and ARC-56 app spec.\n * @param methodNameOrSignature The method name or method signature to call if an ABI call is being emitted.\n * e.g. `my_method` or `my_method(unit64,string)bytes`\n * @param appSpec The app spec for the app\n * @returns The `ABIMethod`\n */\nexport function getABIMethod(methodNameOrSignature: string, appSpec: Arc56Contract): ABIMethod {\n  if (!methodNameOrSignature.includes('(')) {\n    const methods = appSpec.methods.filter((m) => m.name === methodNameOrSignature)\n    if (methods.length === 0) throw new Error(`Unable to find method ${methodNameOrSignature} in ${appSpec.name} app.`)\n    if (methods.length > 1) {\n      throw new Error(\n        `Received a call to method ${methodNameOrSignature} in contract ${\n          appSpec.name\n        }, but this resolved to multiple methods; please pass in an ABI signature instead: ${appSpec.methods\n          .map((m) => getArc56MethodSignature(m))\n          .join(', ')}`,\n      )\n    }\n    return arc56MethodToABIMethod(methods[0], appSpec)\n  } else {\n    const method = appSpec.methods.find((m) => getArc56MethodSignature(m) === methodNameOrSignature)\n    if (!method) throw new Error(`Unable to find method ${methodNameOrSignature} in ${appSpec.name} app.`)\n    return arc56MethodToABIMethod(method, appSpec)\n  }\n}\n\nexport function arc56MethodToABIMethod(method: Arc56Method, appSpec: Arc56Contract): ABIMethod {\n  if (typeof method.name !== 'string' || typeof method.returns !== 'object' || !Array.isArray(method.args)) {\n    throw new Error('Invalid ABIMethod parameters')\n  }\n\n  const args = method.args.map(({ type, name, desc, struct, defaultValue }) => {\n    const convertedDefaultValue: ABIDefaultValue | undefined = defaultValue\n      ? {\n          data: defaultValue.data,\n          source: defaultValue.source as DefaultValueSource,\n          type: defaultValue.type ? (isAVMType(defaultValue.type) ? defaultValue.type : ABIType.from(defaultValue.type)) : undefined,\n        }\n      : undefined\n\n    if (argTypeIsTransaction(type as ABIMethodArgType) || argTypeIsReference(type as ABIMethodArgType)) {\n      return {\n        type: type as ABIMethodArgType,\n        name,\n        description: desc,\n        defaultValue: convertedDefaultValue,\n      } satisfies ABIMethodArg\n    }\n\n    if (struct) {\n      return {\n        type: ABIStructType.fromStruct(struct, appSpec.structs),\n        name,\n        description: desc,\n        defaultValue: convertedDefaultValue,\n      } satisfies ABIMethodArg\n    }\n\n    return {\n      type: ABIType.from(type),\n      name,\n      description: desc,\n      defaultValue: convertedDefaultValue,\n    } satisfies ABIMethodArg\n  })\n\n  const returns = {\n    type:\n      method.returns.type === ('void' as const)\n        ? ('void' as const)\n        : method.returns.struct\n          ? ABIStructType.fromStruct(method.returns.struct, appSpec.structs)\n          : ABIType.from(method.returns.type),\n    desc: method.returns.desc,\n  }\n\n  return new ABIMethod({\n    name: method.name,\n    description: method.desc,\n    args,\n    returns,\n    events: method.events,\n    readonly: method.readonly,\n  })\n}\n\nexport function argTypeIsTransaction(type: ABIMethodArgType): type is ABITransactionType {\n  return (\n    typeof type === 'string' &&\n    (type === ABITransactionType.Txn ||\n      type === ABITransactionType.Payment ||\n      type === ABITransactionType.KeyRegistration ||\n      type === ABITransactionType.AssetConfig ||\n      type === ABITransactionType.AssetTransfer ||\n      type === ABITransactionType.AssetFreeze ||\n      type === ABITransactionType.AppCall)\n  )\n}\n\nexport function argTypeIsReference(type: ABIMethodArgType): type is ABIReferenceType {\n  return (\n    typeof type === 'string' &&\n    (type === ABIReferenceType.Account || type === ABIReferenceType.Application || type === ABIReferenceType.Asset)\n  )\n}\n\nexport function argTypeIsAbiType(type: ABIMethodArgType): type is ABIType {\n  return !argTypeIsTransaction(type) && !argTypeIsReference(type)\n}\n\nfunction getArc56MethodSignature(method: Arc56Method): string {\n  const args = method.args.map((arg) => arg.type).join(',')\n  const returns = method.returns.type\n  return `${method.name}(${args})${returns}`\n}\n\nexport function decodeAVMValue(avmType: AVMType, bytes: Uint8Array): ABIValue {\n  switch (avmType) {\n    case 'AVMString':\n      return Buffer.from(bytes).toString('utf-8')\n    case 'AVMBytes':\n      return bytes\n    case 'AVMUint64':\n      return ABIType.from('uint64').decode(bytes)\n  }\n}\n\nexport function encodeAVMValue(avmType: AVMType, value: ABIValue): Uint8Array {\n  switch (avmType) {\n    case 'AVMString':\n      return ABIType.from('string').encode(value)\n    case 'AVMBytes':\n      if (typeof value === 'string') return Buffer.from(value, 'utf-8')\n      if (typeof value !== 'object' || !(value instanceof Uint8Array))\n        throw new Error(`Expected bytes value for AVMBytes, but got ${value}`)\n      return value\n    case 'AVMUint64':\n      return ABIType.from('uint64').encode(value)\n  }\n}\n\nexport function isAVMType(type: unknown): type is AVMType {\n  return typeof type === 'string' && (type === 'AVMString' || type === 'AVMBytes' || type === 'AVMUint64')\n}\n\nexport function getABIDecodedValue(type: AVMType | ABIType | ABIReferenceType, bytes: Uint8Array): ABIValue {\n  if (type === ABIReferenceType.Asset || type === ABIReferenceType.Application) {\n    return new ABIUintType(64).decode(bytes)\n  } else if (type === ABIReferenceType.Account) {\n    return new ABIAddressType().decode(bytes)\n  } else if (isAVMType(type)) {\n    return decodeAVMValue(type, bytes)\n  }\n  return type.decode(bytes)\n}\n\nexport function getABIEncodedValue(type: AVMType | ABIType, value: ABIValue): Uint8Array {\n  return isAVMType(type) ? encodeAVMValue(type, value) : type.encode(value)\n}\n"],"mappings":"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"}
+{"version":3,"file":"abi-method.mjs","names":["convertedDefaultValue: ABIDefaultValue | undefined"],"sources":["../../../../packages/abi/src/abi-method.ts"],"sourcesContent":["import sha512 from 'js-sha512'\nimport { ABIAddressType, ABIStructType, ABIType, ABIUintType, parseTupleContent } from './abi-type'\nimport { ABIValue } from './abi-value'\nimport { ARC28Event } from './arc28-event'\nimport { AVMType, Arc56Contract, Arc56Method } from './arc56-contract'\n\nexport enum ABITransactionType {\n  Txn = 'txn',\n  Payment = 'pay',\n  KeyRegistration = 'keyreg',\n  AssetConfig = 'acfg',\n  AssetTransfer = 'axfer',\n  AssetFreeze = 'afrz',\n  AppCall = 'appl',\n}\nexport enum ABIReferenceType {\n  Account = 'account',\n  Application = 'application',\n  Asset = 'asset',\n}\nexport type ABIMethodArgType = ABIType | ABITransactionType | ABIReferenceType\nexport type ABIMethodReturnType = ABIType | 'void'\n\nexport type ABIMethodArg = {\n  type: ABIMethodArgType\n  name?: string\n  description?: string\n  defaultValue?: ABIDefaultValue\n}\n\nexport type ABIMethodReturn = {\n  type: ABIMethodReturnType\n  description?: string\n}\n\nexport type ABIDefaultValue = {\n  /** Base64 encoded bytes, base64 ARC4 encoded uint64, or UTF-8 method selector */\n  data: string\n  /** Where the default value is coming from */\n  source: DefaultValueSource\n  /** How the data is encoded. This is the encoding for the data provided here, not the arg type */\n  type?: ABIType | AVMType\n}\n\nexport enum DefaultValueSource {\n  Box = 'box',\n  Global = 'global',\n  Local = 'local',\n  Literal = 'literal',\n  Method = 'method',\n}\n\n/** Represents an ABI method return value with parsed data. */\nexport type ABIReturn =\n  | {\n      /** The method that was called. */\n      method: ABIMethod\n      /** The raw return value as bytes.\n       *\n       * This is the value from the last app call log with the first 4 bytes (the ABI return prefix) omitted.\n       */\n      rawReturnValue: Uint8Array\n      /** The parsed ABI return value. */\n      returnValue: ABIValue\n      decodeError: undefined\n    }\n  | { rawReturnValue?: undefined; returnValue?: undefined; method: ABIMethod; decodeError?: Error }\n\n/** Decoded ARC-56 struct as a struct rather than a tuple. */\nexport type ABIStruct = {\n  [key: string]: ABIStruct | ABIValue\n}\n\nexport class ABIMethod {\n  readonly name: string\n  readonly description?: string\n  readonly args: ABIMethodArg[]\n  readonly returns: ABIMethodReturn\n  readonly events?: ARC28Event[]\n  readonly readonly?: boolean\n\n  constructor(params: {\n    name: string\n    description?: string\n    args: ABIMethodArg[]\n    returns: ABIMethodReturn\n    events?: ARC28Event[]\n    readonly?: boolean\n  }) {\n    this.name = params.name\n    this.description = params.description\n    this.args = params.args\n    this.returns = params.returns\n    this.events = params.events\n    this.readonly = params.readonly\n  }\n\n  /**\n   * Returns the signature of this ABI method.\n   * @returns The signature, e.g. `my_method(unit64,string)bytes`\n   */\n  getSignature(): string {\n    const args = this.args\n      .map((arg) => {\n        if (argTypeIsTransaction(arg.type) || argTypeIsReference(arg.type)) return arg.type\n        return arg.type.name\n      })\n      .join(',')\n    const returns = this.returns.type === 'void' ? 'void' : this.returns.type.name\n    return `${this.name}(${args})${returns}`\n  }\n\n  /**\n   * Returns the method selector of this ABI method.\n   * @returns The 4-byte method selector\n   */\n  getSelector(): Uint8Array {\n    const hash = sha512.sha512_256.array(this.getSignature())\n    return new Uint8Array(hash.slice(0, 4))\n  }\n\n  /**\n   * Returns the ABI method object for a given method signature.\n   * @param signature The method signature\n   * e.g. `my_method(unit64,string)bytes`\n   * @returns The `ABIMethod`\n   */\n  static fromSignature(signature: string): ABIMethod {\n    const argsStart = signature.indexOf('(')\n    if (argsStart === -1) {\n      throw new Error(`Invalid method signature: ${signature}`)\n    }\n\n    let argsEnd = -1\n    let depth = 0\n    for (let i = argsStart; i < signature.length; i++) {\n      const char = signature[i]\n\n      if (char === '(') {\n        depth += 1\n      } else if (char === ')') {\n        if (depth === 0) {\n          // unpaired parenthesis\n          break\n        }\n\n        depth -= 1\n        if (depth === 0) {\n          argsEnd = i\n          break\n        }\n      }\n    }\n\n    if (argsEnd === -1) {\n      throw new Error(`Invalid method signature: ${signature}`)\n    }\n\n    const name = signature.slice(0, argsStart)\n    const args = parseTupleContent(signature.slice(argsStart + 1, argsEnd)).map((n: string) => {\n      if (argTypeIsTransaction(n as ABIMethodArgType) || argTypeIsReference(n as ABIMethodArgType)) {\n        return { type: n as ABIMethodArgType } satisfies ABIMethodArg\n      }\n      return { type: ABIType.from(n) } satisfies ABIMethodArg\n    })\n    const returnType = signature.slice(argsEnd + 1)\n    const returns = { type: returnType === 'void' ? ('void' as const) : ABIType.from(returnType) } satisfies ABIMethodReturn\n\n    return new ABIMethod({\n      name,\n      args,\n      returns,\n    })\n  }\n}\n\n/**\n * Returns the ABI method object for a given method name or signature and ARC-56 app spec.\n * @param methodNameOrSignature The method name or method signature to call if an ABI call is being emitted.\n * e.g. `my_method` or `my_method(unit64,string)bytes`\n * @param appSpec The app spec for the app\n * @returns The `ABIMethod`\n */\nexport function getABIMethod(methodNameOrSignature: string, appSpec: Arc56Contract): ABIMethod {\n  if (!methodNameOrSignature.includes('(')) {\n    const methods = appSpec.methods.filter((m) => m.name === methodNameOrSignature)\n    if (methods.length === 0) throw new Error(`Unable to find method ${methodNameOrSignature} in ${appSpec.name} app.`)\n    if (methods.length > 1) {\n      throw new Error(\n        `Received a call to method ${methodNameOrSignature} in contract ${\n          appSpec.name\n        }, but this resolved to multiple methods; please pass in an ABI signature instead: ${appSpec.methods\n          .map((m) => getArc56MethodSignature(m))\n          .join(', ')}`,\n      )\n    }\n    return arc56MethodToABIMethod(methods[0], appSpec)\n  } else {\n    const method = appSpec.methods.find((m) => getArc56MethodSignature(m) === methodNameOrSignature)\n    if (!method) throw new Error(`Unable to find method ${methodNameOrSignature} in ${appSpec.name} app.`)\n    return arc56MethodToABIMethod(method, appSpec)\n  }\n}\n\nexport function arc56MethodToABIMethod(method: Arc56Method, appSpec: Arc56Contract): ABIMethod {\n  if (typeof method.name !== 'string' || typeof method.returns !== 'object' || !Array.isArray(method.args)) {\n    throw new Error('Invalid ABIMethod parameters')\n  }\n\n  const args = method.args.map(({ type, name, desc, struct, defaultValue }) => {\n    const convertedDefaultValue: ABIDefaultValue | undefined = defaultValue\n      ? {\n          data: defaultValue.data,\n          source: defaultValue.source as DefaultValueSource,\n          type: defaultValue.type ? (isAVMType(defaultValue.type) ? defaultValue.type : ABIType.from(defaultValue.type)) : undefined,\n        }\n      : undefined\n\n    if (argTypeIsTransaction(type as ABIMethodArgType) || argTypeIsReference(type as ABIMethodArgType)) {\n      return {\n        type: type as ABIMethodArgType,\n        name,\n        description: desc,\n        defaultValue: convertedDefaultValue,\n      } satisfies ABIMethodArg\n    }\n\n    if (struct) {\n      return {\n        type: ABIStructType.fromStruct(struct, appSpec.structs),\n        name,\n        description: desc,\n        defaultValue: convertedDefaultValue,\n      } satisfies ABIMethodArg\n    }\n\n    return {\n      type: ABIType.from(type),\n      name,\n      description: desc,\n      defaultValue: convertedDefaultValue,\n    } satisfies ABIMethodArg\n  })\n\n  const returns = {\n    type:\n      method.returns.type === ('void' as const)\n        ? ('void' as const)\n        : method.returns.struct\n          ? ABIStructType.fromStruct(method.returns.struct, appSpec.structs)\n          : ABIType.from(method.returns.type),\n    desc: method.returns.desc,\n  }\n\n  return new ABIMethod({\n    name: method.name,\n    description: method.desc,\n    args,\n    returns,\n    events: method.events,\n    readonly: method.readonly,\n  })\n}\n\nexport function argTypeIsTransaction(type: ABIMethodArgType): type is ABITransactionType {\n  return (\n    typeof type === 'string' &&\n    (type === ABITransactionType.Txn ||\n      type === ABITransactionType.Payment ||\n      type === ABITransactionType.KeyRegistration ||\n      type === ABITransactionType.AssetConfig ||\n      type === ABITransactionType.AssetTransfer ||\n      type === ABITransactionType.AssetFreeze ||\n      type === ABITransactionType.AppCall)\n  )\n}\n\nexport function argTypeIsReference(type: ABIMethodArgType): type is ABIReferenceType {\n  return (\n    typeof type === 'string' &&\n    (type === ABIReferenceType.Account || type === ABIReferenceType.Application || type === ABIReferenceType.Asset)\n  )\n}\n\nexport function argTypeIsAbiType(type: ABIMethodArgType): type is ABIType {\n  return !argTypeIsTransaction(type) && !argTypeIsReference(type)\n}\n\nfunction getArc56MethodSignature(method: Arc56Method): string {\n  const args = method.args.map((arg) => arg.type).join(',')\n  const returns = method.returns.type\n  return `${method.name}(${args})${returns}`\n}\n\nexport function decodeAVMValue(avmType: AVMType, bytes: Uint8Array): ABIValue {\n  switch (avmType) {\n    case 'AVMString':\n      return Buffer.from(bytes).toString('utf-8')\n    case 'AVMBytes':\n      return bytes\n    case 'AVMUint64':\n      return ABIType.from('uint64').decode(bytes)\n  }\n}\n\nexport function encodeAVMValue(avmType: AVMType, value: ABIValue): Uint8Array {\n  switch (avmType) {\n    case 'AVMString':\n      return ABIType.from('string').encode(value)\n    case 'AVMBytes':\n      if (typeof value === 'string') return Buffer.from(value, 'utf-8')\n      if (typeof value !== 'object' || !(value instanceof Uint8Array))\n        throw new Error(`Expected bytes value for AVMBytes, but got ${value}`)\n      return value\n    case 'AVMUint64':\n      return ABIType.from('uint64').encode(value)\n  }\n}\n\nexport function isAVMType(type: unknown): type is AVMType {\n  return typeof type === 'string' && (type === 'AVMString' || type === 'AVMBytes' || type === 'AVMUint64')\n}\n\nexport function getABIDecodedValue(type: AVMType | ABIType | ABIReferenceType, bytes: Uint8Array): ABIValue {\n  if (type === ABIReferenceType.Asset || type === ABIReferenceType.Application) {\n    return new ABIUintType(64).decode(bytes)\n  } else if (type === ABIReferenceType.Account) {\n    return new ABIAddressType().decode(bytes)\n  } else if (isAVMType(type)) {\n    return decodeAVMValue(type, bytes)\n  }\n  return type.decode(bytes)\n}\n\nexport function getABIEncodedValue(type: AVMType | ABIType, value: ABIValue): Uint8Array {\n  return isAVMType(type) ? encodeAVMValue(type, value) : type.encode(value)\n}\n"],"mappings":"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"}

package/packages/algo25/src/index.d.ts

@@ -0,0 +1,40 @@
+//#region packages/algo25/src/index.d.ts
+declare const FAIL_TO_DECODE_MNEMONIC_ERROR_MSG = "failed to decode mnemonic";
+declare const NOT_IN_WORDS_LIST_ERROR_MSG = "the mnemonic contains a word that is not in the wordlist";
+/**
+ * mnemonicFromSeed converts a 32-byte key into a 25 word mnemonic. The generated mnemonic includes a checksum.
+ * Each word in the mnemonic represents 11 bits of data, and the last 11 bits are reserved for the checksum.
+ * @param seed - 32 bytes long seed
+ * @returns 25 words mnemonic
+ */
+declare function mnemonicFromSeed(seed: Uint8Array): string;
+/**
+ * seedFromMnemonic converts a mnemonic generated using this library into the source key used to create it.
+ * It returns an error if the passed mnemonic has an incorrect checksum, if the number of words is unexpected, or if one
+ * of the passed words is not found in the words list.
+ * @param mnemonic - 25 words mnemonic
+ * @returns 32 bytes long seed
+ */
+declare function seedFromMnemonic(mnemonic: string): Uint8Array;
+/**
+ * secretKeyToMnemonic takes an Algorand secret key and returns the corresponding mnemonic.
+ * @param sk - Algorand secret key
+ * @returns Secret key's associated mnemonic
+ */
+declare function secretKeyToMnemonic(sk: Uint8Array): string;
+/**
+ * mnemonicToMasterDerivationKey takes a mnemonic string and returns the corresponding master derivation key.
+ * @param mn - 25 words Algorand mnemonic
+ * @returns Uint8Array
+ * @throws error if fails to decode the mnemonic
+ */
+declare function mnemonicToMasterDerivationKey(mn: string): Uint8Array;
+/**
+ * masterDerivationKeyToMnemonic takes a master derivation key and returns the corresponding mnemonic.
+ * @param mdk - Uint8Array
+ * @returns string mnemonic
+ */
+declare function masterDerivationKeyToMnemonic(mdk: Uint8Array): string;
+//#endregion
+export { FAIL_TO_DECODE_MNEMONIC_ERROR_MSG, NOT_IN_WORDS_LIST_ERROR_MSG, masterDerivationKeyToMnemonic, mnemonicFromSeed, mnemonicToMasterDerivationKey, secretKeyToMnemonic, seedFromMnemonic };
+//# sourceMappingURL=index.d.ts.map

package/packages/algo25/src/index.js

@@ -4,6 +4,7 @@ const require_english = require('./english.js');
 //#region packages/algo25/src/index.ts
 const FAIL_TO_DECODE_MNEMONIC_ERROR_MSG = "failed to decode mnemonic";
 const NOT_IN_WORDS_LIST_ERROR_MSG = "the mnemonic contains a word that is not in the wordlist";
+const SEED_BTYES_LENGTH = 32;
 function toUint11Array(buffer8) {
 	const buffer11 = [];
 	let acc = 0;
@@ -30,6 +31,18 @@ function applyWords(nums) {
 function computeChecksum(seed) {
 	return applyWords(toUint11Array(require_crypto.hash(seed)))[0];
 }
+/**
+* mnemonicFromSeed converts a 32-byte key into a 25 word mnemonic. The generated mnemonic includes a checksum.
+* Each word in the mnemonic represents 11 bits of data, and the last 11 bits are reserved for the checksum.
+* @param seed - 32 bytes long seed
+* @returns 25 words mnemonic
+*/
+function mnemonicFromSeed(seed) {
+	if (seed.length !== SEED_BTYES_LENGTH) throw new RangeError(`Seed length must be ${SEED_BTYES_LENGTH}`);
+	const words = applyWords(toUint11Array(seed));
+	const checksumWord = computeChecksum(seed);
+	return `${words.join(" ")} ${checksumWord}`;
+}
 function toUint8Array(buffer11) {
 	const buffer8 = [];
 	let acc = 0;
@@ -69,7 +82,38 @@ function seedFromMnemonic(mnemonic) {
 	if (computeChecksum(uint8Array) === checksum) return uint8Array;
 	throw new Error(FAIL_TO_DECODE_MNEMONIC_ERROR_MSG);
 }
+/**
+* secretKeyToMnemonic takes an Algorand secret key and returns the corresponding mnemonic.
+* @param sk - Algorand secret key
+* @returns Secret key's associated mnemonic
+*/
+function secretKeyToMnemonic(sk) {
+	return mnemonicFromSeed(sk.slice(0, SEED_BTYES_LENGTH));
+}
+/**
+* mnemonicToMasterDerivationKey takes a mnemonic string and returns the corresponding master derivation key.
+* @param mn - 25 words Algorand mnemonic
+* @returns Uint8Array
+* @throws error if fails to decode the mnemonic
+*/
+function mnemonicToMasterDerivationKey(mn) {
+	return seedFromMnemonic(mn);
+}
+/**
+* masterDerivationKeyToMnemonic takes a master derivation key and returns the corresponding mnemonic.
+* @param mdk - Uint8Array
+* @returns string mnemonic
+*/
+function masterDerivationKeyToMnemonic(mdk) {
+	return mnemonicFromSeed(mdk);
+}
 
 //#endregion
+exports.FAIL_TO_DECODE_MNEMONIC_ERROR_MSG = FAIL_TO_DECODE_MNEMONIC_ERROR_MSG;
+exports.NOT_IN_WORDS_LIST_ERROR_MSG = NOT_IN_WORDS_LIST_ERROR_MSG;
+exports.masterDerivationKeyToMnemonic = masterDerivationKeyToMnemonic;
+exports.mnemonicFromSeed = mnemonicFromSeed;
+exports.mnemonicToMasterDerivationKey = mnemonicToMasterDerivationKey;
+exports.secretKeyToMnemonic = secretKeyToMnemonic;
 exports.seedFromMnemonic = seedFromMnemonic;
 //# sourceMappingURL=index.js.map

package/packages/algo25/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["buffer11: number[]","english","hash","buffer8: number[]"],"sources":["../../../../packages/algo25/src/index.ts"],"sourcesContent":["import english from './english.js'\nimport { hash } from '@algorandfoundation/algokit-common'\nexport const FAIL_TO_DECODE_MNEMONIC_ERROR_MSG = 'failed to decode mnemonic'\nexport const NOT_IN_WORDS_LIST_ERROR_MSG = 'the mnemonic contains a word that is not in the wordlist'\n\nconst SEED_BTYES_LENGTH = 32\n\n// https://stackoverflow.com/a/51452614\nfunction toUint11Array(buffer8: Uint8Array | number[]): number[] {\n  const buffer11: number[] = []\n  let acc = 0\n  let accBits = 0\n  function add(octet: number) {\n    acc |= octet << accBits\n    accBits += 8\n    if (accBits >= 11) {\n      buffer11.push(acc & 0x7ff)\n      acc >>= 11\n      accBits -= 11\n    }\n  }\n  function flush() {\n    if (accBits) {\n      buffer11.push(acc)\n    }\n  }\n\n  buffer8.forEach(add)\n  flush()\n  return buffer11\n}\n\nfunction applyWords(nums: number[]): string[] {\n  return nums.map((n) => english[n])\n}\n\nfunction computeChecksum(seed: Uint8Array): string {\n  const hashBuffer = hash(seed)\n  const uint11Hash = toUint11Array(hashBuffer)\n  const words = applyWords(uint11Hash)\n\n  return words[0]\n}\n\n/**\n * mnemonicFromSeed converts a 32-byte key into a 25 word mnemonic. The generated mnemonic includes a checksum.\n * Each word in the mnemonic represents 11 bits of data, and the last 11 bits are reserved for the checksum.\n * @param seed - 32 bytes long seed\n * @returns 25 words mnemonic\n */\nexport function mnemonicFromSeed(seed: Uint8Array) {\n  // Sanity length check\n  if (seed.length !== SEED_BTYES_LENGTH) {\n    throw new RangeError(`Seed length must be ${SEED_BTYES_LENGTH}`)\n  }\n\n  const uint11Array = toUint11Array(seed)\n  const words = applyWords(uint11Array)\n  const checksumWord = computeChecksum(seed)\n\n  return `${words.join(' ')} ${checksumWord}`\n}\n\n// from Uint11Array\n// https://stackoverflow.com/a/51452614\nfunction toUint8Array(buffer11: number[]): Uint8Array {\n  const buffer8: number[] = []\n  let acc = 0\n  let accBits = 0\n  function add(ui11: number) {\n    acc |= ui11 << accBits\n    accBits += 11\n    while (accBits >= 8) {\n      buffer8.push(acc & 0xff)\n      acc >>= 8\n      accBits -= 8\n    }\n  }\n  function flush() {\n    if (accBits) {\n      buffer8.push(acc)\n    }\n  }\n\n  buffer11.forEach(add)\n  flush()\n  return new Uint8Array(buffer8)\n}\n\n/**\n * seedFromMnemonic converts a mnemonic generated using this library into the source key used to create it.\n * It returns an error if the passed mnemonic has an incorrect checksum, if the number of words is unexpected, or if one\n * of the passed words is not found in the words list.\n * @param mnemonic - 25 words mnemonic\n * @returns 32 bytes long seed\n */\nexport function seedFromMnemonic(mnemonic: string) {\n  const words = mnemonic.split(' ')\n  const key = words.slice(0, 24)\n\n  // Check that all words are in list\n  for (const w of key) {\n    if (english.indexOf(w) === -1) throw new Error(NOT_IN_WORDS_LIST_ERROR_MSG)\n  }\n\n  const checksum = words[words.length - 1]\n  const uint11Array = key.map((word) => english.indexOf(word))\n\n  // Convert the key to uint8Array\n  let uint8Array = toUint8Array(uint11Array)\n\n  // We need to chop the last byte -\n  // the short explanation - Since 256 is not divisible by 11, we have an extra 0x0 byte.\n  // The longer explanation - When splitting the 256 bits to chunks of 11, we get 23 words and a left over of 3 bits.\n  // This left gets padded with another 8 bits to the create the 24th word.\n  // While converting back to byte array, our new 264 bits array is divisible by 8 but the last byte is just the padding.\n\n  // check that we have 33 bytes long array as expected\n  if (uint8Array.length !== 33) throw new Error(FAIL_TO_DECODE_MNEMONIC_ERROR_MSG)\n\n  // check that the last byte is actually 0x0\n  if (uint8Array[uint8Array.length - 1] !== 0x0) throw new Error(FAIL_TO_DECODE_MNEMONIC_ERROR_MSG)\n\n  // chop it !\n  uint8Array = uint8Array.slice(0, uint8Array.length - 1)\n\n  // compute checksum\n  const cs = computeChecksum(uint8Array)\n\n  // success!\n  if (cs === checksum) return uint8Array\n\n  throw new Error(FAIL_TO_DECODE_MNEMONIC_ERROR_MSG)\n}\n\n/**\n * secretKeyToMnemonic takes an Algorand secret key and returns the corresponding mnemonic.\n * @param sk - Algorand secret key\n * @returns Secret key's associated mnemonic\n */\nexport function secretKeyToMnemonic(sk: Uint8Array) {\n  // get the seed from the sk\n  const seed = sk.slice(0, SEED_BTYES_LENGTH)\n  return mnemonicFromSeed(seed)\n}\n\n/**\n * mnemonicToMasterDerivationKey takes a mnemonic string and returns the corresponding master derivation key.\n * @param mn - 25 words Algorand mnemonic\n * @returns Uint8Array\n * @throws error if fails to decode the mnemonic\n */\nexport function mnemonicToMasterDerivationKey(mn: string) {\n  return seedFromMnemonic(mn)\n}\n\n/**\n * masterDerivationKeyToMnemonic takes a master derivation key and returns the corresponding mnemonic.\n * @param mdk - Uint8Array\n * @returns string mnemonic\n */\nexport function masterDerivationKeyToMnemonic(mdk: Uint8Array) {\n  return mnemonicFromSeed(mdk)\n}\n"],"mappings":";;;;AAEA,MAAa,oCAAoC;AACjD,MAAa,8BAA8B;AAK3C,SAAS,cAAc,SAA0C;CAC/D,MAAMA,WAAqB,EAAE;CAC7B,IAAI,MAAM;CACV,IAAI,UAAU;CACd,SAAS,IAAI,OAAe;AAC1B,SAAO,SAAS;AAChB,aAAW;AACX,MAAI,WAAW,IAAI;AACjB,YAAS,KAAK,MAAM,KAAM;AAC1B,WAAQ;AACR,cAAW;;;CAGf,SAAS,QAAQ;AACf,MAAI,QACF,UAAS,KAAK,IAAI;;AAItB,SAAQ,QAAQ,IAAI;AACpB,QAAO;AACP,QAAO;;AAGT,SAAS,WAAW,MAA0B;AAC5C,QAAO,KAAK,KAAK,MAAMC,wBAAQ,GAAG;;AAGpC,SAAS,gBAAgB,MAA0B;AAKjD,QAFc,WADK,cADAC,oBAAK,KAAK,CACe,CACR,CAEvB;;AAwBf,SAAS,aAAa,UAAgC;CACpD,MAAMC,UAAoB,EAAE;CAC5B,IAAI,MAAM;CACV,IAAI,UAAU;CACd,SAAS,IAAI,MAAc;AACzB,SAAO,QAAQ;AACf,aAAW;AACX,SAAO,WAAW,GAAG;AACnB,WAAQ,KAAK,MAAM,IAAK;AACxB,WAAQ;AACR,cAAW;;;CAGf,SAAS,QAAQ;AACf,MAAI,QACF,SAAQ,KAAK,IAAI;;AAIrB,UAAS,QAAQ,IAAI;AACrB,QAAO;AACP,QAAO,IAAI,WAAW,QAAQ;;;;;;;;;AAUhC,SAAgB,iBAAiB,UAAkB;CACjD,MAAM,QAAQ,SAAS,MAAM,IAAI;CACjC,MAAM,MAAM,MAAM,MAAM,GAAG,GAAG;AAG9B,MAAK,MAAM,KAAK,IACd,KAAIF,wBAAQ,QAAQ,EAAE,KAAK,GAAI,OAAM,IAAI,MAAM,4BAA4B;CAG7E,MAAM,WAAW,MAAM,MAAM,SAAS;CAItC,IAAI,aAAa,aAHG,IAAI,KAAK,SAASA,wBAAQ,QAAQ,KAAK,CAAC,CAGlB;AAS1C,KAAI,WAAW,WAAW,GAAI,OAAM,IAAI,MAAM,kCAAkC;AAGhF,KAAI,WAAW,WAAW,SAAS,OAAO,EAAK,OAAM,IAAI,MAAM,kCAAkC;AAGjG,cAAa,WAAW,MAAM,GAAG,WAAW,SAAS,EAAE;AAMvD,KAHW,gBAAgB,WAAW,KAG3B,SAAU,QAAO;AAE5B,OAAM,IAAI,MAAM,kCAAkC"}
+{"version":3,"file":"index.js","names":["buffer11: number[]","english","hash","buffer8: number[]"],"sources":["../../../../packages/algo25/src/index.ts"],"sourcesContent":["import english from './english.js'\nimport { hash } from '@algorandfoundation/algokit-common'\nexport const FAIL_TO_DECODE_MNEMONIC_ERROR_MSG = 'failed to decode mnemonic'\nexport const NOT_IN_WORDS_LIST_ERROR_MSG = 'the mnemonic contains a word that is not in the wordlist'\n\nconst SEED_BTYES_LENGTH = 32\n\n// https://stackoverflow.com/a/51452614\nfunction toUint11Array(buffer8: Uint8Array | number[]): number[] {\n  const buffer11: number[] = []\n  let acc = 0\n  let accBits = 0\n  function add(octet: number) {\n    acc |= octet << accBits\n    accBits += 8\n    if (accBits >= 11) {\n      buffer11.push(acc & 0x7ff)\n      acc >>= 11\n      accBits -= 11\n    }\n  }\n  function flush() {\n    if (accBits) {\n      buffer11.push(acc)\n    }\n  }\n\n  buffer8.forEach(add)\n  flush()\n  return buffer11\n}\n\nfunction applyWords(nums: number[]): string[] {\n  return nums.map((n) => english[n])\n}\n\nfunction computeChecksum(seed: Uint8Array): string {\n  const hashBuffer = hash(seed)\n  const uint11Hash = toUint11Array(hashBuffer)\n  const words = applyWords(uint11Hash)\n\n  return words[0]\n}\n\n/**\n * mnemonicFromSeed converts a 32-byte key into a 25 word mnemonic. The generated mnemonic includes a checksum.\n * Each word in the mnemonic represents 11 bits of data, and the last 11 bits are reserved for the checksum.\n * @param seed - 32 bytes long seed\n * @returns 25 words mnemonic\n */\nexport function mnemonicFromSeed(seed: Uint8Array) {\n  // Sanity length check\n  if (seed.length !== SEED_BTYES_LENGTH) {\n    throw new RangeError(`Seed length must be ${SEED_BTYES_LENGTH}`)\n  }\n\n  const uint11Array = toUint11Array(seed)\n  const words = applyWords(uint11Array)\n  const checksumWord = computeChecksum(seed)\n\n  return `${words.join(' ')} ${checksumWord}`\n}\n\n// from Uint11Array\n// https://stackoverflow.com/a/51452614\nfunction toUint8Array(buffer11: number[]): Uint8Array {\n  const buffer8: number[] = []\n  let acc = 0\n  let accBits = 0\n  function add(ui11: number) {\n    acc |= ui11 << accBits\n    accBits += 11\n    while (accBits >= 8) {\n      buffer8.push(acc & 0xff)\n      acc >>= 8\n      accBits -= 8\n    }\n  }\n  function flush() {\n    if (accBits) {\n      buffer8.push(acc)\n    }\n  }\n\n  buffer11.forEach(add)\n  flush()\n  return new Uint8Array(buffer8)\n}\n\n/**\n * seedFromMnemonic converts a mnemonic generated using this library into the source key used to create it.\n * It returns an error if the passed mnemonic has an incorrect checksum, if the number of words is unexpected, or if one\n * of the passed words is not found in the words list.\n * @param mnemonic - 25 words mnemonic\n * @returns 32 bytes long seed\n */\nexport function seedFromMnemonic(mnemonic: string) {\n  const words = mnemonic.split(' ')\n  const key = words.slice(0, 24)\n\n  // Check that all words are in list\n  for (const w of key) {\n    if (english.indexOf(w) === -1) throw new Error(NOT_IN_WORDS_LIST_ERROR_MSG)\n  }\n\n  const checksum = words[words.length - 1]\n  const uint11Array = key.map((word) => english.indexOf(word))\n\n  // Convert the key to uint8Array\n  let uint8Array = toUint8Array(uint11Array)\n\n  // We need to chop the last byte -\n  // the short explanation - Since 256 is not divisible by 11, we have an extra 0x0 byte.\n  // The longer explanation - When splitting the 256 bits to chunks of 11, we get 23 words and a left over of 3 bits.\n  // This left gets padded with another 8 bits to the create the 24th word.\n  // While converting back to byte array, our new 264 bits array is divisible by 8 but the last byte is just the padding.\n\n  // check that we have 33 bytes long array as expected\n  if (uint8Array.length !== 33) throw new Error(FAIL_TO_DECODE_MNEMONIC_ERROR_MSG)\n\n  // check that the last byte is actually 0x0\n  if (uint8Array[uint8Array.length - 1] !== 0x0) throw new Error(FAIL_TO_DECODE_MNEMONIC_ERROR_MSG)\n\n  // chop it !\n  uint8Array = uint8Array.slice(0, uint8Array.length - 1)\n\n  // compute checksum\n  const cs = computeChecksum(uint8Array)\n\n  // success!\n  if (cs === checksum) return uint8Array\n\n  throw new Error(FAIL_TO_DECODE_MNEMONIC_ERROR_MSG)\n}\n\n/**\n * secretKeyToMnemonic takes an Algorand secret key and returns the corresponding mnemonic.\n * @param sk - Algorand secret key\n * @returns Secret key's associated mnemonic\n */\nexport function secretKeyToMnemonic(sk: Uint8Array) {\n  // get the seed from the sk\n  const seed = sk.slice(0, SEED_BTYES_LENGTH)\n  return mnemonicFromSeed(seed)\n}\n\n/**\n * mnemonicToMasterDerivationKey takes a mnemonic string and returns the corresponding master derivation key.\n * @param mn - 25 words Algorand mnemonic\n * @returns Uint8Array\n * @throws error if fails to decode the mnemonic\n */\nexport function mnemonicToMasterDerivationKey(mn: string) {\n  return seedFromMnemonic(mn)\n}\n\n/**\n * masterDerivationKeyToMnemonic takes a master derivation key and returns the corresponding mnemonic.\n * @param mdk - Uint8Array\n * @returns string mnemonic\n */\nexport function masterDerivationKeyToMnemonic(mdk: Uint8Array) {\n  return mnemonicFromSeed(mdk)\n}\n"],"mappings":";;;;AAEA,MAAa,oCAAoC;AACjD,MAAa,8BAA8B;AAE3C,MAAM,oBAAoB;AAG1B,SAAS,cAAc,SAA0C;CAC/D,MAAMA,WAAqB,EAAE;CAC7B,IAAI,MAAM;CACV,IAAI,UAAU;CACd,SAAS,IAAI,OAAe;AAC1B,SAAO,SAAS;AAChB,aAAW;AACX,MAAI,WAAW,IAAI;AACjB,YAAS,KAAK,MAAM,KAAM;AAC1B,WAAQ;AACR,cAAW;;;CAGf,SAAS,QAAQ;AACf,MAAI,QACF,UAAS,KAAK,IAAI;;AAItB,SAAQ,QAAQ,IAAI;AACpB,QAAO;AACP,QAAO;;AAGT,SAAS,WAAW,MAA0B;AAC5C,QAAO,KAAK,KAAK,MAAMC,wBAAQ,GAAG;;AAGpC,SAAS,gBAAgB,MAA0B;AAKjD,QAFc,WADK,cADAC,oBAAK,KAAK,CACe,CACR,CAEvB;;;;;;;;AASf,SAAgB,iBAAiB,MAAkB;AAEjD,KAAI,KAAK,WAAW,kBAClB,OAAM,IAAI,WAAW,uBAAuB,oBAAoB;CAIlE,MAAM,QAAQ,WADM,cAAc,KAAK,CACF;CACrC,MAAM,eAAe,gBAAgB,KAAK;AAE1C,QAAO,GAAG,MAAM,KAAK,IAAI,CAAC,GAAG;;AAK/B,SAAS,aAAa,UAAgC;CACpD,MAAMC,UAAoB,EAAE;CAC5B,IAAI,MAAM;CACV,IAAI,UAAU;CACd,SAAS,IAAI,MAAc;AACzB,SAAO,QAAQ;AACf,aAAW;AACX,SAAO,WAAW,GAAG;AACnB,WAAQ,KAAK,MAAM,IAAK;AACxB,WAAQ;AACR,cAAW;;;CAGf,SAAS,QAAQ;AACf,MAAI,QACF,SAAQ,KAAK,IAAI;;AAIrB,UAAS,QAAQ,IAAI;AACrB,QAAO;AACP,QAAO,IAAI,WAAW,QAAQ;;;;;;;;;AAUhC,SAAgB,iBAAiB,UAAkB;CACjD,MAAM,QAAQ,SAAS,MAAM,IAAI;CACjC,MAAM,MAAM,MAAM,MAAM,GAAG,GAAG;AAG9B,MAAK,MAAM,KAAK,IACd,KAAIF,wBAAQ,QAAQ,EAAE,KAAK,GAAI,OAAM,IAAI,MAAM,4BAA4B;CAG7E,MAAM,WAAW,MAAM,MAAM,SAAS;CAItC,IAAI,aAAa,aAHG,IAAI,KAAK,SAASA,wBAAQ,QAAQ,KAAK,CAAC,CAGlB;AAS1C,KAAI,WAAW,WAAW,GAAI,OAAM,IAAI,MAAM,kCAAkC;AAGhF,KAAI,WAAW,WAAW,SAAS,OAAO,EAAK,OAAM,IAAI,MAAM,kCAAkC;AAGjG,cAAa,WAAW,MAAM,GAAG,WAAW,SAAS,EAAE;AAMvD,KAHW,gBAAgB,WAAW,KAG3B,SAAU,QAAO;AAE5B,OAAM,IAAI,MAAM,kCAAkC;;;;;;;AAQpD,SAAgB,oBAAoB,IAAgB;AAGlD,QAAO,iBADM,GAAG,MAAM,GAAG,kBAAkB,CACd;;;;;;;;AAS/B,SAAgB,8BAA8B,IAAY;AACxD,QAAO,iBAAiB,GAAG;;;;;;;AAQ7B,SAAgB,8BAA8B,KAAiB;AAC7D,QAAO,iBAAiB,IAAI"}

package/packages/algo25/src/index.mjs

@@ -4,6 +4,7 @@ import english_default from "./english.mjs";
 //#region packages/algo25/src/index.ts
 const FAIL_TO_DECODE_MNEMONIC_ERROR_MSG = "failed to decode mnemonic";
 const NOT_IN_WORDS_LIST_ERROR_MSG = "the mnemonic contains a word that is not in the wordlist";
+const SEED_BTYES_LENGTH = 32;
 function toUint11Array(buffer8) {
 	const buffer11 = [];
 	let acc = 0;
@@ -30,6 +31,18 @@ function applyWords(nums) {
 function computeChecksum(seed) {
 	return applyWords(toUint11Array(hash(seed)))[0];
 }
+/**
+* mnemonicFromSeed converts a 32-byte key into a 25 word mnemonic. The generated mnemonic includes a checksum.
+* Each word in the mnemonic represents 11 bits of data, and the last 11 bits are reserved for the checksum.
+* @param seed - 32 bytes long seed
+* @returns 25 words mnemonic
+*/
+function mnemonicFromSeed(seed) {
+	if (seed.length !== SEED_BTYES_LENGTH) throw new RangeError(`Seed length must be ${SEED_BTYES_LENGTH}`);
+	const words = applyWords(toUint11Array(seed));
+	const checksumWord = computeChecksum(seed);
+	return `${words.join(" ")} ${checksumWord}`;
+}
 function toUint8Array(buffer11) {
 	const buffer8 = [];
 	let acc = 0;
@@ -69,7 +82,32 @@ function seedFromMnemonic(mnemonic) {
 	if (computeChecksum(uint8Array) === checksum) return uint8Array;
 	throw new Error(FAIL_TO_DECODE_MNEMONIC_ERROR_MSG);
 }
+/**
+* secretKeyToMnemonic takes an Algorand secret key and returns the corresponding mnemonic.
+* @param sk - Algorand secret key
+* @returns Secret key's associated mnemonic
+*/
+function secretKeyToMnemonic(sk) {
+	return mnemonicFromSeed(sk.slice(0, SEED_BTYES_LENGTH));
+}
+/**
+* mnemonicToMasterDerivationKey takes a mnemonic string and returns the corresponding master derivation key.
+* @param mn - 25 words Algorand mnemonic
+* @returns Uint8Array
+* @throws error if fails to decode the mnemonic
+*/
+function mnemonicToMasterDerivationKey(mn) {
+	return seedFromMnemonic(mn);
+}
+/**
+* masterDerivationKeyToMnemonic takes a master derivation key and returns the corresponding mnemonic.
+* @param mdk - Uint8Array
+* @returns string mnemonic
+*/
+function masterDerivationKeyToMnemonic(mdk) {
+	return mnemonicFromSeed(mdk);
+}
 
 //#endregion
-export { seedFromMnemonic };
+export { FAIL_TO_DECODE_MNEMONIC_ERROR_MSG, NOT_IN_WORDS_LIST_ERROR_MSG, masterDerivationKeyToMnemonic, mnemonicFromSeed, mnemonicToMasterDerivationKey, secretKeyToMnemonic, seedFromMnemonic };
 //# sourceMappingURL=index.mjs.map

package/packages/algo25/src/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["buffer11: number[]","english","buffer8: number[]"],"sources":["../../../../packages/algo25/src/index.ts"],"sourcesContent":["import english from './english.js'\nimport { hash } from '@algorandfoundation/algokit-common'\nexport const FAIL_TO_DECODE_MNEMONIC_ERROR_MSG = 'failed to decode mnemonic'\nexport const NOT_IN_WORDS_LIST_ERROR_MSG = 'the mnemonic contains a word that is not in the wordlist'\n\nconst SEED_BTYES_LENGTH = 32\n\n// https://stackoverflow.com/a/51452614\nfunction toUint11Array(buffer8: Uint8Array | number[]): number[] {\n  const buffer11: number[] = []\n  let acc = 0\n  let accBits = 0\n  function add(octet: number) {\n    acc |= octet << accBits\n    accBits += 8\n    if (accBits >= 11) {\n      buffer11.push(acc & 0x7ff)\n      acc >>= 11\n      accBits -= 11\n    }\n  }\n  function flush() {\n    if (accBits) {\n      buffer11.push(acc)\n    }\n  }\n\n  buffer8.forEach(add)\n  flush()\n  return buffer11\n}\n\nfunction applyWords(nums: number[]): string[] {\n  return nums.map((n) => english[n])\n}\n\nfunction computeChecksum(seed: Uint8Array): string {\n  const hashBuffer = hash(seed)\n  const uint11Hash = toUint11Array(hashBuffer)\n  const words = applyWords(uint11Hash)\n\n  return words[0]\n}\n\n/**\n * mnemonicFromSeed converts a 32-byte key into a 25 word mnemonic. The generated mnemonic includes a checksum.\n * Each word in the mnemonic represents 11 bits of data, and the last 11 bits are reserved for the checksum.\n * @param seed - 32 bytes long seed\n * @returns 25 words mnemonic\n */\nexport function mnemonicFromSeed(seed: Uint8Array) {\n  // Sanity length check\n  if (seed.length !== SEED_BTYES_LENGTH) {\n    throw new RangeError(`Seed length must be ${SEED_BTYES_LENGTH}`)\n  }\n\n  const uint11Array = toUint11Array(seed)\n  const words = applyWords(uint11Array)\n  const checksumWord = computeChecksum(seed)\n\n  return `${words.join(' ')} ${checksumWord}`\n}\n\n// from Uint11Array\n// https://stackoverflow.com/a/51452614\nfunction toUint8Array(buffer11: number[]): Uint8Array {\n  const buffer8: number[] = []\n  let acc = 0\n  let accBits = 0\n  function add(ui11: number) {\n    acc |= ui11 << accBits\n    accBits += 11\n    while (accBits >= 8) {\n      buffer8.push(acc & 0xff)\n      acc >>= 8\n      accBits -= 8\n    }\n  }\n  function flush() {\n    if (accBits) {\n      buffer8.push(acc)\n    }\n  }\n\n  buffer11.forEach(add)\n  flush()\n  return new Uint8Array(buffer8)\n}\n\n/**\n * seedFromMnemonic converts a mnemonic generated using this library into the source key used to create it.\n * It returns an error if the passed mnemonic has an incorrect checksum, if the number of words is unexpected, or if one\n * of the passed words is not found in the words list.\n * @param mnemonic - 25 words mnemonic\n * @returns 32 bytes long seed\n */\nexport function seedFromMnemonic(mnemonic: string) {\n  const words = mnemonic.split(' ')\n  const key = words.slice(0, 24)\n\n  // Check that all words are in list\n  for (const w of key) {\n    if (english.indexOf(w) === -1) throw new Error(NOT_IN_WORDS_LIST_ERROR_MSG)\n  }\n\n  const checksum = words[words.length - 1]\n  const uint11Array = key.map((word) => english.indexOf(word))\n\n  // Convert the key to uint8Array\n  let uint8Array = toUint8Array(uint11Array)\n\n  // We need to chop the last byte -\n  // the short explanation - Since 256 is not divisible by 11, we have an extra 0x0 byte.\n  // The longer explanation - When splitting the 256 bits to chunks of 11, we get 23 words and a left over of 3 bits.\n  // This left gets padded with another 8 bits to the create the 24th word.\n  // While converting back to byte array, our new 264 bits array is divisible by 8 but the last byte is just the padding.\n\n  // check that we have 33 bytes long array as expected\n  if (uint8Array.length !== 33) throw new Error(FAIL_TO_DECODE_MNEMONIC_ERROR_MSG)\n\n  // check that the last byte is actually 0x0\n  if (uint8Array[uint8Array.length - 1] !== 0x0) throw new Error(FAIL_TO_DECODE_MNEMONIC_ERROR_MSG)\n\n  // chop it !\n  uint8Array = uint8Array.slice(0, uint8Array.length - 1)\n\n  // compute checksum\n  const cs = computeChecksum(uint8Array)\n\n  // success!\n  if (cs === checksum) return uint8Array\n\n  throw new Error(FAIL_TO_DECODE_MNEMONIC_ERROR_MSG)\n}\n\n/**\n * secretKeyToMnemonic takes an Algorand secret key and returns the corresponding mnemonic.\n * @param sk - Algorand secret key\n * @returns Secret key's associated mnemonic\n */\nexport function secretKeyToMnemonic(sk: Uint8Array) {\n  // get the seed from the sk\n  const seed = sk.slice(0, SEED_BTYES_LENGTH)\n  return mnemonicFromSeed(seed)\n}\n\n/**\n * mnemonicToMasterDerivationKey takes a mnemonic string and returns the corresponding master derivation key.\n * @param mn - 25 words Algorand mnemonic\n * @returns Uint8Array\n * @throws error if fails to decode the mnemonic\n */\nexport function mnemonicToMasterDerivationKey(mn: string) {\n  return seedFromMnemonic(mn)\n}\n\n/**\n * masterDerivationKeyToMnemonic takes a master derivation key and returns the corresponding mnemonic.\n * @param mdk - Uint8Array\n * @returns string mnemonic\n */\nexport function masterDerivationKeyToMnemonic(mdk: Uint8Array) {\n  return mnemonicFromSeed(mdk)\n}\n"],"mappings":";;;;AAEA,MAAa,oCAAoC;AACjD,MAAa,8BAA8B;AAK3C,SAAS,cAAc,SAA0C;CAC/D,MAAMA,WAAqB,EAAE;CAC7B,IAAI,MAAM;CACV,IAAI,UAAU;CACd,SAAS,IAAI,OAAe;AAC1B,SAAO,SAAS;AAChB,aAAW;AACX,MAAI,WAAW,IAAI;AACjB,YAAS,KAAK,MAAM,KAAM;AAC1B,WAAQ;AACR,cAAW;;;CAGf,SAAS,QAAQ;AACf,MAAI,QACF,UAAS,KAAK,IAAI;;AAItB,SAAQ,QAAQ,IAAI;AACpB,QAAO;AACP,QAAO;;AAGT,SAAS,WAAW,MAA0B;AAC5C,QAAO,KAAK,KAAK,MAAMC,gBAAQ,GAAG;;AAGpC,SAAS,gBAAgB,MAA0B;AAKjD,QAFc,WADK,cADA,KAAK,KAAK,CACe,CACR,CAEvB;;AAwBf,SAAS,aAAa,UAAgC;CACpD,MAAMC,UAAoB,EAAE;CAC5B,IAAI,MAAM;CACV,IAAI,UAAU;CACd,SAAS,IAAI,MAAc;AACzB,SAAO,QAAQ;AACf,aAAW;AACX,SAAO,WAAW,GAAG;AACnB,WAAQ,KAAK,MAAM,IAAK;AACxB,WAAQ;AACR,cAAW;;;CAGf,SAAS,QAAQ;AACf,MAAI,QACF,SAAQ,KAAK,IAAI;;AAIrB,UAAS,QAAQ,IAAI;AACrB,QAAO;AACP,QAAO,IAAI,WAAW,QAAQ;;;;;;;;;AAUhC,SAAgB,iBAAiB,UAAkB;CACjD,MAAM,QAAQ,SAAS,MAAM,IAAI;CACjC,MAAM,MAAM,MAAM,MAAM,GAAG,GAAG;AAG9B,MAAK,MAAM,KAAK,IACd,KAAID,gBAAQ,QAAQ,EAAE,KAAK,GAAI,OAAM,IAAI,MAAM,4BAA4B;CAG7E,MAAM,WAAW,MAAM,MAAM,SAAS;CAItC,IAAI,aAAa,aAHG,IAAI,KAAK,SAASA,gBAAQ,QAAQ,KAAK,CAAC,CAGlB;AAS1C,KAAI,WAAW,WAAW,GAAI,OAAM,IAAI,MAAM,kCAAkC;AAGhF,KAAI,WAAW,WAAW,SAAS,OAAO,EAAK,OAAM,IAAI,MAAM,kCAAkC;AAGjG,cAAa,WAAW,MAAM,GAAG,WAAW,SAAS,EAAE;AAMvD,KAHW,gBAAgB,WAAW,KAG3B,SAAU,QAAO;AAE5B,OAAM,IAAI,MAAM,kCAAkC"}
+{"version":3,"file":"index.mjs","names":["buffer11: number[]","english","buffer8: number[]"],"sources":["../../../../packages/algo25/src/index.ts"],"sourcesContent":["import english from './english.js'\nimport { hash } from '@algorandfoundation/algokit-common'\nexport const FAIL_TO_DECODE_MNEMONIC_ERROR_MSG = 'failed to decode mnemonic'\nexport const NOT_IN_WORDS_LIST_ERROR_MSG = 'the mnemonic contains a word that is not in the wordlist'\n\nconst SEED_BTYES_LENGTH = 32\n\n// https://stackoverflow.com/a/51452614\nfunction toUint11Array(buffer8: Uint8Array | number[]): number[] {\n  const buffer11: number[] = []\n  let acc = 0\n  let accBits = 0\n  function add(octet: number) {\n    acc |= octet << accBits\n    accBits += 8\n    if (accBits >= 11) {\n      buffer11.push(acc & 0x7ff)\n      acc >>= 11\n      accBits -= 11\n    }\n  }\n  function flush() {\n    if (accBits) {\n      buffer11.push(acc)\n    }\n  }\n\n  buffer8.forEach(add)\n  flush()\n  return buffer11\n}\n\nfunction applyWords(nums: number[]): string[] {\n  return nums.map((n) => english[n])\n}\n\nfunction computeChecksum(seed: Uint8Array): string {\n  const hashBuffer = hash(seed)\n  const uint11Hash = toUint11Array(hashBuffer)\n  const words = applyWords(uint11Hash)\n\n  return words[0]\n}\n\n/**\n * mnemonicFromSeed converts a 32-byte key into a 25 word mnemonic. The generated mnemonic includes a checksum.\n * Each word in the mnemonic represents 11 bits of data, and the last 11 bits are reserved for the checksum.\n * @param seed - 32 bytes long seed\n * @returns 25 words mnemonic\n */\nexport function mnemonicFromSeed(seed: Uint8Array) {\n  // Sanity length check\n  if (seed.length !== SEED_BTYES_LENGTH) {\n    throw new RangeError(`Seed length must be ${SEED_BTYES_LENGTH}`)\n  }\n\n  const uint11Array = toUint11Array(seed)\n  const words = applyWords(uint11Array)\n  const checksumWord = computeChecksum(seed)\n\n  return `${words.join(' ')} ${checksumWord}`\n}\n\n// from Uint11Array\n// https://stackoverflow.com/a/51452614\nfunction toUint8Array(buffer11: number[]): Uint8Array {\n  const buffer8: number[] = []\n  let acc = 0\n  let accBits = 0\n  function add(ui11: number) {\n    acc |= ui11 << accBits\n    accBits += 11\n    while (accBits >= 8) {\n      buffer8.push(acc & 0xff)\n      acc >>= 8\n      accBits -= 8\n    }\n  }\n  function flush() {\n    if (accBits) {\n      buffer8.push(acc)\n    }\n  }\n\n  buffer11.forEach(add)\n  flush()\n  return new Uint8Array(buffer8)\n}\n\n/**\n * seedFromMnemonic converts a mnemonic generated using this library into the source key used to create it.\n * It returns an error if the passed mnemonic has an incorrect checksum, if the number of words is unexpected, or if one\n * of the passed words is not found in the words list.\n * @param mnemonic - 25 words mnemonic\n * @returns 32 bytes long seed\n */\nexport function seedFromMnemonic(mnemonic: string) {\n  const words = mnemonic.split(' ')\n  const key = words.slice(0, 24)\n\n  // Check that all words are in list\n  for (const w of key) {\n    if (english.indexOf(w) === -1) throw new Error(NOT_IN_WORDS_LIST_ERROR_MSG)\n  }\n\n  const checksum = words[words.length - 1]\n  const uint11Array = key.map((word) => english.indexOf(word))\n\n  // Convert the key to uint8Array\n  let uint8Array = toUint8Array(uint11Array)\n\n  // We need to chop the last byte -\n  // the short explanation - Since 256 is not divisible by 11, we have an extra 0x0 byte.\n  // The longer explanation - When splitting the 256 bits to chunks of 11, we get 23 words and a left over of 3 bits.\n  // This left gets padded with another 8 bits to the create the 24th word.\n  // While converting back to byte array, our new 264 bits array is divisible by 8 but the last byte is just the padding.\n\n  // check that we have 33 bytes long array as expected\n  if (uint8Array.length !== 33) throw new Error(FAIL_TO_DECODE_MNEMONIC_ERROR_MSG)\n\n  // check that the last byte is actually 0x0\n  if (uint8Array[uint8Array.length - 1] !== 0x0) throw new Error(FAIL_TO_DECODE_MNEMONIC_ERROR_MSG)\n\n  // chop it !\n  uint8Array = uint8Array.slice(0, uint8Array.length - 1)\n\n  // compute checksum\n  const cs = computeChecksum(uint8Array)\n\n  // success!\n  if (cs === checksum) return uint8Array\n\n  throw new Error(FAIL_TO_DECODE_MNEMONIC_ERROR_MSG)\n}\n\n/**\n * secretKeyToMnemonic takes an Algorand secret key and returns the corresponding mnemonic.\n * @param sk - Algorand secret key\n * @returns Secret key's associated mnemonic\n */\nexport function secretKeyToMnemonic(sk: Uint8Array) {\n  // get the seed from the sk\n  const seed = sk.slice(0, SEED_BTYES_LENGTH)\n  return mnemonicFromSeed(seed)\n}\n\n/**\n * mnemonicToMasterDerivationKey takes a mnemonic string and returns the corresponding master derivation key.\n * @param mn - 25 words Algorand mnemonic\n * @returns Uint8Array\n * @throws error if fails to decode the mnemonic\n */\nexport function mnemonicToMasterDerivationKey(mn: string) {\n  return seedFromMnemonic(mn)\n}\n\n/**\n * masterDerivationKeyToMnemonic takes a master derivation key and returns the corresponding mnemonic.\n * @param mdk - Uint8Array\n * @returns string mnemonic\n */\nexport function masterDerivationKeyToMnemonic(mdk: Uint8Array) {\n  return mnemonicFromSeed(mdk)\n}\n"],"mappings":";;;;AAEA,MAAa,oCAAoC;AACjD,MAAa,8BAA8B;AAE3C,MAAM,oBAAoB;AAG1B,SAAS,cAAc,SAA0C;CAC/D,MAAMA,WAAqB,EAAE;CAC7B,IAAI,MAAM;CACV,IAAI,UAAU;CACd,SAAS,IAAI,OAAe;AAC1B,SAAO,SAAS;AAChB,aAAW;AACX,MAAI,WAAW,IAAI;AACjB,YAAS,KAAK,MAAM,KAAM;AAC1B,WAAQ;AACR,cAAW;;;CAGf,SAAS,QAAQ;AACf,MAAI,QACF,UAAS,KAAK,IAAI;;AAItB,SAAQ,QAAQ,IAAI;AACpB,QAAO;AACP,QAAO;;AAGT,SAAS,WAAW,MAA0B;AAC5C,QAAO,KAAK,KAAK,MAAMC,gBAAQ,GAAG;;AAGpC,SAAS,gBAAgB,MAA0B;AAKjD,QAFc,WADK,cADA,KAAK,KAAK,CACe,CACR,CAEvB;;;;;;;;AASf,SAAgB,iBAAiB,MAAkB;AAEjD,KAAI,KAAK,WAAW,kBAClB,OAAM,IAAI,WAAW,uBAAuB,oBAAoB;CAIlE,MAAM,QAAQ,WADM,cAAc,KAAK,CACF;CACrC,MAAM,eAAe,gBAAgB,KAAK;AAE1C,QAAO,GAAG,MAAM,KAAK,IAAI,CAAC,GAAG;;AAK/B,SAAS,aAAa,UAAgC;CACpD,MAAMC,UAAoB,EAAE;CAC5B,IAAI,MAAM;CACV,IAAI,UAAU;CACd,SAAS,IAAI,MAAc;AACzB,SAAO,QAAQ;AACf,aAAW;AACX,SAAO,WAAW,GAAG;AACnB,WAAQ,KAAK,MAAM,IAAK;AACxB,WAAQ;AACR,cAAW;;;CAGf,SAAS,QAAQ;AACf,MAAI,QACF,SAAQ,KAAK,IAAI;;AAIrB,UAAS,QAAQ,IAAI;AACrB,QAAO;AACP,QAAO,IAAI,WAAW,QAAQ;;;;;;;;;AAUhC,SAAgB,iBAAiB,UAAkB;CACjD,MAAM,QAAQ,SAAS,MAAM,IAAI;CACjC,MAAM,MAAM,MAAM,MAAM,GAAG,GAAG;AAG9B,MAAK,MAAM,KAAK,IACd,KAAID,gBAAQ,QAAQ,EAAE,KAAK,GAAI,OAAM,IAAI,MAAM,4BAA4B;CAG7E,MAAM,WAAW,MAAM,MAAM,SAAS;CAItC,IAAI,aAAa,aAHG,IAAI,KAAK,SAASA,gBAAQ,QAAQ,KAAK,CAAC,CAGlB;AAS1C,KAAI,WAAW,WAAW,GAAI,OAAM,IAAI,MAAM,kCAAkC;AAGhF,KAAI,WAAW,WAAW,SAAS,OAAO,EAAK,OAAM,IAAI,MAAM,kCAAkC;AAGjG,cAAa,WAAW,MAAM,GAAG,WAAW,SAAS,EAAE;AAMvD,KAHW,gBAAgB,WAAW,KAG3B,SAAU,QAAO;AAE5B,OAAM,IAAI,MAAM,kCAAkC;;;;;;;AAQpD,SAAgB,oBAAoB,IAAgB;AAGlD,QAAO,iBADM,GAAG,MAAM,GAAG,kBAAkB,CACd;;;;;;;;AAS/B,SAAgB,8BAA8B,IAAY;AACxD,QAAO,iBAAiB,GAAG;;;;;;;AAQ7B,SAAgB,8BAA8B,KAAiB;AAC7D,QAAO,iBAAiB,IAAI"}

package/transactions/method-call.js

@@ -85,9 +85,9 @@ const isAbiValue = (x) => {
 * Populate reference arrays from processed ABI method call arguments
 */
 function populateMethodArgsIntoReferenceArrays(sender, appId, method, methodArgs, accountReferences, appReferences, assetReferences) {
-	const accounts = accountReferences ?? [];
-	const assets = assetReferences ?? [];
-	const apps = appReferences ?? [];
+	const accounts = [...accountReferences ?? []];
+	const assets = [...assetReferences ?? []];
+	const apps = [...appReferences ?? []];
 	methodArgs.forEach((arg, i) => {
 		const argType = method.args[i].type;
 		if (require_abi_method.argTypeIsReference(argType)) switch (argType) {
@@ -245,9 +245,9 @@ const buildAppCreateMethodCall = async (params, appManager, suggestedParams, def
 			extraProgramPages,
 			args: common.args,
 			...hasAccessReferences ? { accessReferences: params.accessReferences } : {
-				accountReferences: params.accountReferences?.map((a) => require_address.getAddress(a)),
-				appReferences: params.appReferences,
-				assetReferences: params.assetReferences,
+				accountReferences: common.accountReferences,
+				appReferences: common.appReferences,
+				assetReferences: common.assetReferences,
 				boxReferences: params.boxReferences?.map(require_app_manager.AppManager.getBoxReference)
 			},
 			rejectVersion: params.rejectVersion
@@ -278,9 +278,9 @@ const buildAppUpdateMethodCall = async (params, appManager, suggestedParams, def
 			clearStateProgram,
 			args: common.args,
 			...hasAccessReferences ? { accessReferences: params.accessReferences } : {
-				accountReferences: params.accountReferences?.map((a) => require_address.getAddress(a)),
-				appReferences: params.appReferences,
-				assetReferences: params.assetReferences,
+				accountReferences: common.accountReferences,
+				appReferences: common.appReferences,
+				assetReferences: common.assetReferences,
 				boxReferences: params.boxReferences?.map(require_app_manager.AppManager.getBoxReference)
 			},
 			rejectVersion: params.rejectVersion
@@ -307,9 +307,9 @@ const buildAppCallMethodCall = async (params, suggestedParams, defaultValidityWi
 			onComplete: params.onComplete ?? require_app_call.OnApplicationComplete.NoOp,
 			args: common.args,
 			...hasAccessReferences ? { accessReferences: params.accessReferences } : {
-				accountReferences: params.accountReferences?.map((a) => require_address.getAddress(a)),
-				appReferences: params.appReferences,
-				assetReferences: params.assetReferences,
+				accountReferences: common.accountReferences,
+				appReferences: common.appReferences,
+				assetReferences: common.assetReferences,
 				boxReferences: params.boxReferences?.map(require_app_manager.AppManager.getBoxReference)
 			},
 			rejectVersion: params.rejectVersion