npm - @algorandfoundation/algokit-utils - Versions diffs - 10.0.0-alpha.2 → 10.0.0-alpha.21 - Mend

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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (462) hide show

package/packages/abi/src/abi-type.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"abi-type.mjs","names":["childTypes: ABIType[]","bitSize: number","precision: number","encodedBytes: Uint8Array","typeStrings: string[]","heads: Uint8Array[]","tails: Uint8Array[]","values: ABIValue[]","childType: ABIType","length: number","structName: string","structFields: ABIStructField[]","dynamicSegments: Segment[]","valuePartitions: (Uint8Array \| null)[]","result: Uint8Array[]","tupleStrings: string[]"],"sources":["../../../../packages/abi/src/abi-type.ts"],"sourcesContent":["import {\n Address,\n BOOL_FALSE_BYTE,\n BOOL_TRUE_BYTE,\n LENGTH_ENCODE_BYTE_SIZE,\n PUBLIC_KEY_BYTE_LENGTH,\n concatArrays,\n} from '@algorandfoundation/algokit-common'\nimport type { ABIStructValue, ABIValue } from './abi-value'\nimport { StructField } from './arc56-contract'\nimport { bigIntToBytes, bytesToBigInt } from './bigint'\n\nconst STATIC_ARRAY_REGEX = /^([a-z\\d[\\](),]+)\\[(0\|[1-9][\\d])]$/\nconst UFIXED_REGEX = /^ufixed([1-9][\\d])x([1-9][\\d])$/\nconst MAX_LEN = 2 * 16 - 1\n\n/*\n Information about a single field in a struct\n /\nexport type ABIStructField = {\n /* The name of the struct field /\n name: string\n /* The type of the struct field's value /\n type: ABIType \| ABIStructField[]\n}\n\ninterface Segment {\n left: number\n right: number\n}\n\n/\n Represents an Algorand ABI type for encoding and decoding values as defined in [ARC-0004](https://arc.algorand.foundation/ARCs/arc-0004#types).\n \n This is the abstract base class for all ABI types.\n /\nexport abstract class ABIType {\n /\n Returns the ARC-4 type name string representation.\n * @returns The ARC-4 type string\n /\n abstract get name(): string\n\n /\n Returns a user-friendly display name for this type.\n * @returns The display name for this type\n /\n get displayName(): string {\n return this.name\n }\n\n /\n Returns the ARC-4 type name string representation.\n * @returns The ARC-4 type string\n /\n toString(): string {\n return this.name\n }\n\n /\n Checks if this ABI type is equal to another.\n * @param other The other ABI type to compare with\n * @returns True if the types are equal, false otherwise\n /\n abstract equals(other: ABIType): boolean\n\n /\n Checks if this ABI type is dynamic (variable-length).\n * @returns True if the type is dynamic, false otherwise\n /\n abstract isDynamic(): boolean\n\n /\n Gets the byte length of the encoded type for static types.\n * @returns The number of bytes needed to encode this type\n * @throws Error if the type is dynamic\n /\n abstract byteLen(): number\n\n /\n Encodes a value according to this ABI type.\n * @param value The value to encode\n * @returns The encoded bytes\n /\n abstract encode(value: ABIValue): Uint8Array\n\n /\n Decodes bytes according to this ABI type.\n * @param bytes The bytes to decode\n * @returns The decoded value\n /\n abstract decode(bytes: Uint8Array): ABIValue\n\n /\n Creates an ABI type from an ARC-4 type string.\n * @param str The ARC-4 type string (e.g., \"uint256\", \"bool\", \"(uint8,address)\")\n * @returns The corresponding ABI type\n /\n static from(str: string): ABIType {\n if (str.endsWith('[]')) {\n const childType = ABIType.from(str.slice(0, str.length - 2))\n return new ABIArrayDynamicType(childType)\n }\n if (str.endsWith(']')) {\n const stringMatches = str.match(STATIC_ARRAY_REGEX)\n if (!stringMatches \|\| stringMatches.length !== 3) {\n throw new Error(`Malformed static array string: ${str}`)\n }\n const arrayLengthStr = stringMatches[2]\n const arrayLength = parseInt(arrayLengthStr, 10)\n if (arrayLength > MAX_LEN) {\n throw new Error(`Array length exceeds limit ${MAX_LEN}`)\n }\n const childType = ABIType.from(stringMatches[1])\n return new ABIArrayStaticType(childType, arrayLength)\n }\n if (str.startsWith('uint')) {\n const digitsOnly = (s: string) => [...s].every((c) => '0123456789'.includes(c))\n const typeSizeStr = str.slice(4, str.length)\n if (!digitsOnly(typeSizeStr)) {\n throw new Error(`Malformed uint string: ${typeSizeStr}`)\n }\n const bitSize = parseInt(typeSizeStr, 10)\n if (bitSize > MAX_LEN) {\n throw new Error(`Malformed uint string: ${bitSize}`)\n }\n return new ABIUintType(bitSize)\n }\n if (str === 'byte') {\n return new ABIByteType()\n }\n if (str.startsWith('ufixed')) {\n const stringMatches = str.match(UFIXED_REGEX)\n if (!stringMatches \|\| stringMatches.length !== 3) {\n throw new Error(`Malformed ufixed type: ${str}`)\n }\n const bitSize = parseInt(stringMatches[1], 10)\n const precision = parseInt(stringMatches[2], 10)\n return new ABIUfixedType(bitSize, precision)\n }\n if (str === 'bool') {\n return new ABIBoolType()\n }\n if (str === 'address') {\n return new ABIAddressType()\n }\n if (str === 'string') {\n return new ABIStringType()\n }\n if (str.length >= 2 && str[0] === '(' && str[str.length - 1] === ')') {\n const tupleContent = parseTupleContent(str.slice(1, str.length - 1))\n const childTypes: ABIType[] = []\n for (let i = 0; i < tupleContent.length; i++) {\n const ti = ABIType.from(tupleContent[i])\n childTypes.push(ti)\n }\n return new ABITupleType(childTypes)\n }\n throw new Error(`Cannot convert a string ${str} to an ABI type`)\n }\n}\n\n// ============================================================================\n// Primitive Types\n// ============================================================================\n\n/\n An unsigned integer ABI type of a specific bit size.\n /\nexport class ABIUintType extends ABIType {\n /\n Creates a new unsigned integer type.\n * @param bitSize The bit size (must be a multiple of 8, between 8 and 512)\n /\n constructor(public readonly bitSize: number) {\n super()\n if (bitSize % 8 !== 0 \|\| bitSize < 8 \|\| bitSize > 512) {\n throw new Error(`Unsupported uint type bitSize: ${bitSize}`)\n }\n }\n\n get name(): string {\n return `uint${this.bitSize}`\n }\n\n equals(other: ABIType): boolean {\n return other instanceof ABIUintType && this.bitSize === other.bitSize\n }\n\n isDynamic(): boolean {\n return false\n }\n\n byteLen(): number {\n return this.bitSize / 8\n }\n\n encode(value: ABIValue): Uint8Array {\n if (typeof value !== 'bigint' && typeof value !== 'number') {\n throw new Error(`Cannot encode value as ${this.name}: ${value}`)\n }\n\n if (value >= BigInt(2 * this.bitSize) \|\| value < BigInt(0)) {\n throw new Error(`${value} is not a non-negative int or too big to fit in size ${this.name}`)\n }\n if (typeof value === 'number' && !Number.isSafeInteger(value)) {\n throw new Error(`${value} should be converted into a BigInt before it is encoded`)\n }\n return bigIntToBytes(value, this.bitSize / 8)\n }\n\n decode(bytes: Uint8Array): ABIValue {\n if (bytes.length !== this.bitSize / 8) {\n throw new Error(`Byte string must correspond to a ${this.name}`)\n }\n const value = bytesToBigInt(bytes)\n return this.bitSize < 53 ? Number(value) : value\n }\n}\n\n/*\n A fixed-point number ABI type of a specific bit size and precision.\n /\nexport class ABIUfixedType extends ABIType {\n /\n Creates a new fixed-point type.\n * @param bitSize The bit size (must be a multiple of 8, between 8 and 512)\n * @param precision The decimal precision (must be between 1 and 160)\n /\n constructor(\n public readonly bitSize: number,\n public readonly precision: number,\n ) {\n super()\n if (bitSize % 8 !== 0 \|\| bitSize < 8 \|\| bitSize > 512) {\n throw new Error(`Unsupported ufixed type bitSize: ${bitSize}`)\n }\n if (precision > 160 \|\| precision < 1) {\n throw new Error(`Unsupported ufixed type precision: ${precision}`)\n }\n }\n\n get name(): string {\n return `ufixed${this.bitSize}x${this.precision}`\n }\n\n equals(other: ABIType): boolean {\n return other instanceof ABIUfixedType && this.bitSize === other.bitSize && this.precision === other.precision\n }\n\n isDynamic(): boolean {\n return false\n }\n\n byteLen(): number {\n return this.bitSize / 8\n }\n\n encode(value: ABIValue): Uint8Array {\n if (typeof value !== 'bigint' && typeof value !== 'number') {\n throw new Error(`Cannot encode value as ${this.name}: ${value}`)\n }\n if (value >= BigInt(2 * this.bitSize) \|\| value < BigInt(0)) {\n throw new Error(`${value} is not a non-negative int or too big to fit in size ${this.name}`)\n }\n if (typeof value === 'number' && !Number.isSafeInteger(value)) {\n throw new Error(`${value} should be converted into a BigInt before it is encoded`)\n }\n return bigIntToBytes(value, this.bitSize / 8)\n }\n\n decode(bytes: Uint8Array): ABIValue {\n if (bytes.length !== this.bitSize / 8) {\n throw new Error(`Byte string must correspond to a ${this.name}`)\n }\n const value = bytesToBigInt(bytes)\n return this.bitSize < 53 ? Number(value) : value\n }\n}\n\n/*\n An Algorand address ABI type.\n /\nexport class ABIAddressType extends ABIType {\n get name(): string {\n return 'address'\n }\n\n equals(other: ABIType): boolean {\n return other instanceof ABIAddressType\n }\n\n isDynamic(): boolean {\n return false\n }\n\n byteLen(): number {\n return PUBLIC_KEY_BYTE_LENGTH\n }\n\n encode(value: ABIValue): Uint8Array {\n if (typeof value === 'string') {\n return Address.fromString(value).publicKey\n }\n\n if (value instanceof Address) {\n return value.publicKey\n }\n\n throw new Error(`Cannot encode value as address: ${value}`)\n }\n\n decode(bytes: Uint8Array): ABIValue {\n return new Address(bytes)\n }\n}\n\n/\n A boolean ABI type.\n /\nexport class ABIBoolType extends ABIType {\n get name(): string {\n return 'bool'\n }\n\n equals(other: ABIType): boolean {\n return other instanceof ABIBoolType\n }\n\n isDynamic(): boolean {\n return false\n }\n\n byteLen(): number {\n return 1\n }\n\n encode(value: ABIValue): Uint8Array {\n if (typeof value !== 'boolean') {\n throw new Error(`Cannot encode value as bool: ${value}`)\n }\n\n return value ? new Uint8Array([0x80]) : new Uint8Array([0x00])\n }\n\n decode(bytes: Uint8Array): ABIValue {\n if (bytes.length !== 1) {\n throw new Error(`Expected 1 byte for bool, got ${bytes.length}`)\n }\n\n return (bytes[0] & 0x80) !== 0\n }\n}\n\n/\n A single byte ABI type.\n /\nexport class ABIByteType extends ABIType {\n get name(): string {\n return 'byte'\n }\n\n equals(other: ABIType): boolean {\n return other instanceof ABIByteType\n }\n\n isDynamic(): boolean {\n return false\n }\n\n byteLen(): number {\n return 1\n }\n\n encode(value: ABIValue): Uint8Array {\n if (typeof value !== 'number' && typeof value !== 'bigint') {\n throw new Error(`Cannot encode value as byte: ${value}`)\n }\n const numberValue = typeof value === 'bigint' ? Number(value) : value\n if (value < 0 \|\| value > 255) {\n throw new Error(`Byte value must be between 0 and 255, got ${numberValue}`)\n }\n\n return new Uint8Array([numberValue])\n }\n\n decode(bytes: Uint8Array): ABIValue {\n if (bytes.length !== 1) {\n throw new Error(`Expected 1 byte for byte type, got ${bytes.length}`)\n }\n\n return bytes[0]\n }\n}\n\n/\n A dynamic-length string ABI type.\n /\nexport class ABIStringType extends ABIType {\n get name(): string {\n return 'string'\n }\n\n equals(other: ABIType): boolean {\n return other instanceof ABIStringType\n }\n\n isDynamic(): boolean {\n return true\n }\n\n byteLen(): number {\n throw new Error(`Failed to get size, string is a dynamic type`)\n }\n\n encode(value: ABIValue): Uint8Array {\n if (typeof value !== 'string' && !(value instanceof Uint8Array)) {\n throw new Error(`Cannot encode value as string: ${value}`)\n }\n\n let encodedBytes: Uint8Array\n if (typeof value === 'string') {\n encodedBytes = new TextEncoder().encode(value)\n } else {\n encodedBytes = value\n }\n const encodedLength = bigIntToBytes(encodedBytes.length, LENGTH_ENCODE_BYTE_SIZE)\n const mergedBytes = new Uint8Array(encodedBytes.length + LENGTH_ENCODE_BYTE_SIZE)\n mergedBytes.set(encodedLength)\n mergedBytes.set(encodedBytes, LENGTH_ENCODE_BYTE_SIZE)\n return mergedBytes\n }\n\n decode(bytes: Uint8Array): ABIValue {\n if (bytes.length < LENGTH_ENCODE_BYTE_SIZE) {\n throw new Error(\n `Byte string is too short to be decoded. Actual length is ${bytes.length}, but expected at least ${LENGTH_ENCODE_BYTE_SIZE}`,\n )\n }\n const view = new DataView(bytes.buffer, bytes.byteOffset, LENGTH_ENCODE_BYTE_SIZE)\n const byteLength = view.getUint16(0)\n const byteValue = bytes.slice(LENGTH_ENCODE_BYTE_SIZE, bytes.length)\n if (byteLength !== byteValue.length) {\n throw new Error(`String length bytes do not match the actual length of string. Expected ${byteLength}, got ${byteValue.length}`)\n }\n return new TextDecoder('utf-8').decode(byteValue)\n }\n}\n\n// ============================================================================\n// Collection Types\n// ============================================================================\n\n/\n A tuple ABI type containing other ABI types.\n /\nexport class ABITupleType extends ABIType {\n /\n Creates a new tuple type.\n * @param childTypes The types of the tuple elements\n /\n constructor(public readonly childTypes: ABIType[]) {\n super()\n if (childTypes.length > MAX_LEN) {\n throw new Error(`Tuple has too many child types: ${childTypes.length}`)\n }\n }\n\n get name(): string {\n const typeStrings: string[] = []\n for (let i = 0; i < this.childTypes.length; i++) {\n typeStrings[i] = this.childTypes[i].name\n }\n return `(${typeStrings.join(',')})`\n }\n\n equals(other: ABIType): boolean {\n if (!(other instanceof ABITupleType)) return false\n if (this.childTypes.length !== other.childTypes.length) return false\n return this.childTypes.every((t, i) => t.equals(other.childTypes[i]))\n }\n\n isDynamic(): boolean {\n return this.childTypes.some((c) => c.isDynamic())\n }\n\n byteLen(): number {\n let size = 0\n let i = 0\n while (i < this.childTypes.length) {\n const childType = this.childTypes[i]\n if (childType instanceof ABIBoolType) {\n const sequenceEndIndex = findBoolSequenceEnd(this.childTypes, i)\n const boolCount = sequenceEndIndex - i + 1\n size += Math.ceil(boolCount / 8)\n i = sequenceEndIndex + 1\n } else {\n size += childType.byteLen()\n i++\n }\n }\n return size\n }\n\n encode(value: ABIValue): Uint8Array {\n if (!Array.isArray(value) && !(value instanceof Uint8Array)) {\n throw new Error(`Cannot encode value as ${this.toString()}: ${value}`)\n }\n\n const values = Array.from(value)\n\n if (this.childTypes.length !== values.length) {\n throw new Error('Mismatch lengths between the values and types')\n }\n\n const heads: Uint8Array[] = []\n const tails: Uint8Array[] = []\n const isDynamicIndex = new Map<number, boolean>()\n let abiTypesCursor = 0\n\n while (abiTypesCursor < this.childTypes.length) {\n const childType = this.childTypes[abiTypesCursor]\n\n if (childType.isDynamic()) {\n isDynamicIndex.set(heads.length, true)\n heads.push(new Uint8Array(2)) // Placeholder for dynamic offset\n tails.push(childType.encode(values[abiTypesCursor]))\n } else {\n if (childType instanceof ABIBoolType) {\n const boolSequenceEndIndex = findBoolSequenceEnd(this.childTypes, abiTypesCursor)\n const boolValues = values.slice(abiTypesCursor, boolSequenceEndIndex + 1)\n const compressedBool = compressBools(boolValues)\n heads.push(new Uint8Array([compressedBool]))\n abiTypesCursor = boolSequenceEndIndex\n } else {\n heads.push(childType.encode(values[abiTypesCursor]))\n }\n isDynamicIndex.set(abiTypesCursor, false)\n tails.push(new Uint8Array(0))\n }\n abiTypesCursor += 1\n }\n\n const headLength = heads.reduce((sum, head) => sum + head.length, 0)\n let tailLength = 0\n\n for (let i = 0; i < heads.length; i++) {\n if (isDynamicIndex.get(i)) {\n const headValue = headLength + tailLength\n if (headValue > 0xffff) {\n throw new Error(`Value ${headValue} cannot fit in u16`)\n }\n heads[i] = new Uint8Array([(headValue >> 8) & 0xff, headValue & 0xff])\n }\n tailLength += tails[i].length\n }\n\n const totalLength = heads.reduce((sum, head) => sum + head.length, 0) + tails.reduce((sum, tail) => sum + tail.length, 0)\n const result = new Uint8Array(totalLength)\n let offset = 0\n\n for (const head of heads) {\n result.set(head, offset)\n offset += head.length\n }\n\n for (const tail of tails) {\n result.set(tail, offset)\n offset += tail.length\n }\n\n return result\n }\n\n decode(bytes: Uint8Array): ABIValue[] {\n const valuePartitions = extractValues(this.childTypes, bytes)\n const values: ABIValue[] = []\n\n for (let i = 0; i < this.childTypes.length; i++) {\n const childType = this.childTypes[i]\n const valuePartition = valuePartitions[i]\n const childValue = childType.decode(valuePartition)\n values.push(childValue)\n }\n\n return values\n }\n}\n\n/\n A static-length array ABI type.\n /\nexport class ABIArrayStaticType extends ABIType {\n /\n Creates a new static array type.\n * @param childType The type of the array elements\n * @param length The fixed length of the array\n /\n constructor(\n public readonly childType: ABIType,\n public readonly length: number,\n ) {\n super()\n if (length < 0 \|\| length > MAX_LEN) {\n throw new Error(`Invalid static array length: ${length}`)\n }\n }\n\n get name(): string {\n return `${this.childType.name}[${this.length}]`\n }\n\n equals(other: ABIType): boolean {\n return other instanceof ABIArrayStaticType && this.childType.equals(other.childType) && this.length === other.length\n }\n\n isDynamic(): boolean {\n return this.childType.isDynamic()\n }\n\n byteLen(): number {\n if (this.childType instanceof ABIBoolType) {\n return Math.ceil(this.length / 8)\n }\n return this.childType.byteLen() this.length\n }\n\n /*\n Converts this static array type to an equivalent tuple type.\n * @returns The equivalent tuple type\n /\n toABITupleType(): ABITupleType {\n return new ABITupleType(Array(this.length).fill(this.childType))\n }\n\n encode(value: ABIValue): Uint8Array {\n if (!Array.isArray(value) && !(value instanceof Uint8Array)) {\n throw new Error(`Cannot encode value as ${this.name}: ${value}`)\n }\n if (value.length !== this.length) {\n throw new Error(`Value array does not match static array length. Expected ${this.length}, got ${value.length}`)\n }\n const convertedTuple = this.toABITupleType()\n return convertedTuple.encode(value)\n }\n\n decode(bytes: Uint8Array): ABIValue[] \| Uint8Array {\n const convertedTuple = this.toABITupleType()\n const decoded = convertedTuple.decode(bytes)\n\n // Convert byte arrays to Uint8Array\n if (this.childType instanceof ABIByteType && Array.isArray(decoded)) {\n return new Uint8Array(decoded as number[])\n }\n\n return decoded\n }\n}\n\n/\n A dynamic-length array ABI type.\n /\nexport class ABIArrayDynamicType extends ABIType {\n /\n Creates a new dynamic array type.\n * @param childType The type of the array elements\n /\n constructor(public readonly childType: ABIType) {\n super()\n }\n\n get name(): string {\n return `${this.childType.name}[]`\n }\n\n equals(other: ABIType): boolean {\n return other instanceof ABIArrayDynamicType && this.childType.equals(other.childType)\n }\n\n isDynamic(): boolean {\n return true\n }\n\n byteLen(): number {\n throw new Error(`Failed to get size, dynamic array is a dynamic type`)\n }\n\n /\n Converts this dynamic array type to an equivalent tuple type of a given length.\n * @param length The number of elements\n * @returns The equivalent tuple type\n /\n toABITupleType(length: number): ABITupleType {\n return new ABITupleType(Array(length).fill(this.childType))\n }\n\n encode(value: ABIValue): Uint8Array {\n if (!Array.isArray(value) && !(value instanceof Uint8Array)) {\n throw new Error(`Cannot encode value as ${this.name}: ${value}`)\n }\n const convertedTuple = this.toABITupleType(value.length)\n const encodedTuple = convertedTuple.encode(value)\n const encodedLength = bigIntToBytes(convertedTuple.childTypes.length, LENGTH_ENCODE_BYTE_SIZE)\n return concatArrays(encodedLength, encodedTuple)\n }\n\n decode(bytes: Uint8Array): ABIValue[] \| Uint8Array {\n const view = new DataView(bytes.buffer, 0, LENGTH_ENCODE_BYTE_SIZE)\n const byteLength = view.getUint16(0)\n const convertedTuple = this.toABITupleType(byteLength)\n const decoded = convertedTuple.decode(bytes.slice(LENGTH_ENCODE_BYTE_SIZE, bytes.length))\n\n // Convert byte arrays to Uint8Array\n if (this.childType instanceof ABIByteType && Array.isArray(decoded)) {\n return new Uint8Array(decoded as number[])\n }\n\n return decoded\n }\n}\n\n/\n A struct ABI type with named fields.\n /\nexport class ABIStructType extends ABIType {\n /\n Creates a new struct type.\n * @param structName The name of the struct\n * @param structFields The fields of the struct\n /\n constructor(\n public readonly structName: string,\n public readonly structFields: ABIStructField[],\n ) {\n super()\n }\n\n get name(): string {\n const tupleType = this.toABITupleType()\n return tupleType.name\n }\n\n get displayName(): string {\n return this.structName\n }\n\n equals(other: ABIType): boolean {\n if (!(other instanceof ABIStructType)) return false\n if (this.structName !== other.structName) return false\n if (this.structFields.length !== other.structFields.length) return false\n return this.structFields.every((f, i) => {\n const otherField = other.structFields[i]\n if (f.name !== otherField.name) return false\n if (Array.isArray(f.type) && Array.isArray(otherField.type)) {\n return JSON.stringify(f.type) === JSON.stringify(otherField.type)\n }\n if (f.type instanceof ABIType && otherField.type instanceof ABIType) {\n return f.type.equals(otherField.type)\n }\n return false\n })\n }\n\n isDynamic(): boolean {\n const tupleType = this.toABITupleType()\n return tupleType.isDynamic()\n }\n\n byteLen(): number {\n const tupleType = this.toABITupleType()\n return tupleType.byteLen()\n }\n\n /\n Converts this struct type to an equivalent tuple type.\n * @returns The equivalent tuple type\n /\n toABITupleType(): ABITupleType {\n const getABITupleTypeFromABIStructFields = (fields: ABIStructField[]): ABITupleType => {\n const childTypes = fields.map((field) =>\n Array.isArray(field.type)\n ? getABITupleTypeFromABIStructFields(field.type)\n : field.type instanceof ABIStructType\n ? field.type.toABITupleType()\n : field.type,\n )\n return new ABITupleType(childTypes)\n }\n\n return getABITupleTypeFromABIStructFields(this.structFields)\n }\n\n /\n Creates an ABIStructType from struct name and struct definitions.\n * @param structName The name of the struct\n * @param structs A record of struct definitions\n * @returns The struct type\n */\n static fromStruct(structName: string, structs: Record<string, StructField[]>): ABIStructType {\n const getStructFieldType = (structFieldType: string \| StructField[]): ABIType \| ABIStructField[] => {\n // When the input is an array of struct fields\n if (Array.isArray(structFieldType)) {\n return structFieldType.map((structField) => ({\n name: structField.name,\n type: getStructFieldType(structField.type),\n }))\n }\n\n // When the input is a name of another struct\n if (structs[structFieldType]) {\n return ABIStructType.fromStruct(structFieldType, structs)\n }\n\n // When the input in an ABI type name\n return ABIType.from(structFieldType)\n }\n\n if (!structs[structName]) throw new Error('Struct not found')\n\n const fields = structs[structName]\n return new ABIStructType(\n structName,\n fields.map((f) => ({\n name: f.name,\n type: getStructFieldType(f.type),\n })),\n )\n }\n\n encode(value: ABIValue): Uint8Array {\n if (typeof value !== 'object' \|\| Array.isArray(value) \|\| value instanceof Uint8Array \|\| value instanceof Address) {\n throw new Error(`Cannot encode value as ${this.name}: ${value}`)\n }\n\n const tupleType = this.toABITupleType()\n const tupleValue = this.getTupleValueFromStructValue(value)\n return tupleType.encode(tupleValue)\n }\n\n decode(bytes: Uint8Array): ABIStructValue {\n const tupleType = this.toABITupleType()\n const tupleValue = tupleType.decode(bytes)\n return this.getStructValueFromTupleValue(tupleValue)\n }\n\n private getTupleValueFromStructValue(structValue: ABIStructValue): ABIValue[] {\n const getTupleValueFromStructFields = (structFields: ABIStructField[], values: ABIValue[]): ABIValue[] => {\n return structFields.map(({ type }, index) => {\n // if type is an array of fields, treat as unnamed struct\n if (Array.isArray(type)) {\n const value = values[index] as ABIStructValue\n return getTupleValueFromStructFields(type, Object.values(value))\n }\n // if type is struct, treat as struct\n if (type instanceof ABIStructType) {\n const value = values[index] as ABIStructValue\n return getTupleValueFromStructFields(type.structFields, Object.values(value))\n }\n return values[index]\n })\n }\n\n return getTupleValueFromStructFields(this.structFields, Object.values(structValue))\n }\n\n private getStructValueFromTupleValue(tupleValue: ABIValue[]): ABIStructValue {\n const getStructFieldValues = (structFields: ABIStructField[], values: ABIValue[]): ABIStructValue => {\n return Object.fromEntries(\n structFields.map(({ name, type }, index) => {\n // When the type is an array of fields, the value must be tuple\n if (Array.isArray(type)) {\n const value = values[index] as ABIValue[]\n return [name, getStructFieldValues(type, value)]\n }\n // When the type is a struct, the value must be tuple\n if (type instanceof ABIStructType) {\n const value = values[index] as ABIValue[]\n return [name, getStructFieldValues(type.structFields, value)]\n }\n return [name, values[index]]\n }),\n )\n }\n\n return getStructFieldValues(this.structFields, tupleValue)\n }\n}\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\nfunction compressBools(values: ABIValue[]): number {\n if (values.length > 8) {\n throw new Error(`Expected no more than 8 bool values, received ${values.length}`)\n }\n\n let result = 0\n for (let i = 0; i < values.length; i++) {\n if (typeof values[i] !== 'boolean') {\n throw new Error('Expected all values to be boolean')\n }\n if (values[i]) {\n result \|= 1 << (7 - i)\n }\n }\n\n return result\n}\n\nfunction findBoolSequenceEnd(abiTypes: ABIType[], currentIndex: number): number {\n let cursor = currentIndex\n while (cursor < abiTypes.length) {\n if (abiTypes[cursor] instanceof ABIBoolType) {\n if (cursor - currentIndex + 1 === 8 \|\| cursor === abiTypes.length - 1) {\n return cursor\n }\n cursor++\n } else {\n return cursor - 1\n }\n }\n return cursor - 1\n}\n\nfunction extractValues(abiTypes: ABIType[], bytes: Uint8Array): Uint8Array[] {\n const dynamicSegments: Segment[] = []\n const valuePartitions: (Uint8Array \| null)[] = []\n let bytesCursor = 0\n let abiTypesCursor = 0\n\n while (abiTypesCursor < abiTypes.length) {\n const childType = abiTypes[abiTypesCursor]\n\n if (childType.isDynamic()) {\n if (bytes.length - bytesCursor < LENGTH_ENCODE_BYTE_SIZE) {\n throw new Error('Byte array is too short to be decoded')\n }\n\n const dynamicIndex = (bytes[bytesCursor] << 8) \| bytes[bytesCursor + 1]\n\n if (dynamicSegments.length > 0) {\n const lastSegment = dynamicSegments[dynamicSegments.length - 1]\n if (dynamicIndex < lastSegment.left) {\n throw new Error('Dynamic index segment miscalculation: left is greater than right index')\n }\n lastSegment.right = dynamicIndex\n }\n\n dynamicSegments.push({ left: dynamicIndex, right: 0 })\n valuePartitions.push(null)\n bytesCursor += LENGTH_ENCODE_BYTE_SIZE\n } else {\n if (childType instanceof ABIBoolType) {\n const boolSequenceEndIndex = findBoolSequenceEnd(abiTypes, abiTypesCursor)\n for (let j = 0; j <= boolSequenceEndIndex - abiTypesCursor; j++) {\n const boolMask = BOOL_TRUE_BYTE >> j\n if ((bytes[bytesCursor] & boolMask) > 0) {\n valuePartitions.push(new Uint8Array([BOOL_TRUE_BYTE]))\n } else {\n valuePartitions.push(new Uint8Array([BOOL_FALSE_BYTE]))\n }\n }\n abiTypesCursor = boolSequenceEndIndex\n bytesCursor += 1\n } else {\n const childTypeSize = childType.byteLen()\n if (bytesCursor + childTypeSize > bytes.length) {\n throw new Error(\n `Index out of bounds, trying to access bytes[${bytesCursor}..${bytesCursor + childTypeSize}] but slice has length ${bytes.length}`,\n )\n }\n valuePartitions.push(bytes.slice(bytesCursor, bytesCursor + childTypeSize))\n bytesCursor += childTypeSize\n }\n }\n\n if (abiTypesCursor !== abiTypes.length - 1 && bytesCursor >= bytes.length) {\n throw new Error('Input bytes not enough to decode')\n }\n abiTypesCursor += 1\n }\n\n if (dynamicSegments.length > 0) {\n const lastSegment = dynamicSegments[dynamicSegments.length - 1]\n lastSegment.right = bytes.length\n } else if (bytesCursor < bytes.length) {\n throw new Error('Input bytes not fully consumed')\n }\n\n for (let i = 0; i < dynamicSegments.length; i++) {\n const segment = dynamicSegments[i]\n if (segment.left > segment.right) {\n throw new Error('Dynamic segment should display a [l, r] space with l <= r')\n }\n if (i !== dynamicSegments.length - 1 && segment.right !== dynamicSegments[i + 1].left) {\n throw new Error('Dynamic segments should be consecutive')\n }\n }\n\n let segmentIndex = 0\n for (let i = 0; i < abiTypes.length; i++) {\n const childType = abiTypes[i]\n if (childType.isDynamic()) {\n valuePartitions[i] = bytes.slice(dynamicSegments[segmentIndex].left, dynamicSegments[segmentIndex].right)\n segmentIndex += 1\n }\n }\n\n const result: Uint8Array[] = []\n for (let i = 0; i < valuePartitions.length; i++) {\n const partition = valuePartitions[i]\n if (partition === null) {\n throw new Error(`Value partition at index ${i} is None`)\n }\n result.push(partition)\n }\n\n return result\n}\n\nexport function parseTupleContent(content: string): string[] {\n if (content === '') {\n return []\n }\n\n if (content.startsWith(',')) {\n throw new Error('The content should not start with comma')\n }\n if (content.endsWith(',')) {\n throw new Error('The content should not end with comma')\n }\n if (content.includes(',,')) {\n throw new Error('The content should not have consecutive commas')\n }\n\n const tupleStrings: string[] = []\n let depth = 0\n let word = ''\n\n for (const ch of content) {\n word += ch\n if (ch === '(') {\n depth += 1\n } else if (ch === ')') {\n depth -= 1\n } else if (ch === ',' && depth === 0) {\n word = word.slice(0, -1) // Remove the comma\n tupleStrings.push(word)\n word = ''\n }\n }\n\n if (word !== '') {\n tupleStrings.push(word)\n }\n\n if (depth !== 0) {\n throw new Error('The content has mismatched parentheses')\n }\n\n return tupleStrings\n}\n"],"mappings":"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"}
1	+ {"version":3,"file":"abi-type.mjs","names":["childTypes: ABIType[]","bitSize: number","precision: number","encodedBytes: Uint8Array","typeStrings: string[]","heads: Uint8Array[]","tails: Uint8Array[]","values: ABIValue[]","childType: ABIType","length: number","structName: string","structFields: ABIStructField[]","dynamicSegments: Segment[]","valuePartitions: (Uint8Array \| null)[]","result: Uint8Array[]","tupleStrings: string[]"],"sources":["../../../../packages/abi/src/abi-type.ts"],"sourcesContent":["import {\n Address,\n BOOL_FALSE_BYTE,\n BOOL_TRUE_BYTE,\n LENGTH_ENCODE_BYTE_SIZE,\n PUBLIC_KEY_BYTE_LENGTH,\n concatArrays,\n} from '@algorandfoundation/algokit-common'\nimport type { ABIStructValue, ABIValue } from './abi-value'\nimport { StructField } from './arc56-contract'\nimport { bigIntToBytes, bytesToBigInt } from './bigint'\n\nconst STATIC_ARRAY_REGEX = /^([a-z\\d[\\](),]+)\\[(0\|[1-9][\\d])]$/\nconst UFIXED_REGEX = /^ufixed([1-9][\\d])x([1-9][\\d])$/\nconst MAX_LEN = 2 * 16 - 1\n\n/*\n Information about a single field in a struct\n /\nexport type ABIStructField = {\n /* The name of the struct field /\n name: string\n /* The type of the struct field's value /\n type: ABIType \| ABIStructField[]\n}\n\ninterface Segment {\n left: number\n right: number\n}\n\n/\n Represents an Algorand ABI type for encoding and decoding values as defined in [ARC-0004](https://arc.algorand.foundation/ARCs/arc-0004#types).\n \n This is the abstract base class for all ABI types.\n /\nexport abstract class ABIType {\n /\n Returns the ARC-4 type name string representation.\n * @returns The ARC-4 type string\n /\n abstract get name(): string\n\n /\n Returns a user-friendly display name for this type.\n * @returns The display name for this type\n /\n get displayName(): string {\n return this.name\n }\n\n /\n Returns the ARC-4 type name string representation.\n * @returns The ARC-4 type string\n /\n toString(): string {\n return this.name\n }\n\n /\n Checks if this ABI type is equal to another.\n * @param other The other ABI type to compare with\n * @returns True if the types are equal, false otherwise\n /\n abstract equals(other: ABIType): boolean\n\n /\n Checks if this ABI type is dynamic (variable-length).\n * @returns True if the type is dynamic, false otherwise\n /\n abstract isDynamic(): boolean\n\n /\n Gets the byte length of the encoded type for static types.\n * @returns The number of bytes needed to encode this type\n * @throws Error if the type is dynamic\n /\n abstract byteLen(): number\n\n /\n Encodes a value according to this ABI type.\n * @param value The value to encode\n * @returns The encoded bytes\n /\n abstract encode(value: ABIValue): Uint8Array\n\n /\n Decodes bytes according to this ABI type.\n * @param bytes The bytes to decode\n * @returns The decoded value\n /\n abstract decode(bytes: Uint8Array): ABIValue\n\n /\n Creates an ABI type from an ARC-4 type string.\n * @param str The ARC-4 type string (e.g., \"uint256\", \"bool\", \"(uint8,address)\")\n * @returns The corresponding ABI type\n /\n static from(str: string): ABIType {\n if (str.endsWith('[]')) {\n const childType = ABIType.from(str.slice(0, str.length - 2))\n return new ABIArrayDynamicType(childType)\n }\n if (str.endsWith(']')) {\n const stringMatches = str.match(STATIC_ARRAY_REGEX)\n if (!stringMatches \|\| stringMatches.length !== 3) {\n throw new Error(`Malformed static array string: ${str}`)\n }\n const arrayLengthStr = stringMatches[2]\n const arrayLength = parseInt(arrayLengthStr, 10)\n if (arrayLength > MAX_LEN) {\n throw new Error(`Array length exceeds limit ${MAX_LEN}`)\n }\n const childType = ABIType.from(stringMatches[1])\n return new ABIArrayStaticType(childType, arrayLength)\n }\n if (str.startsWith('uint')) {\n const digitsOnly = (s: string) => [...s].every((c) => '0123456789'.includes(c))\n const typeSizeStr = str.slice(4, str.length)\n if (!digitsOnly(typeSizeStr)) {\n throw new Error(`Malformed uint string: ${typeSizeStr}`)\n }\n const bitSize = parseInt(typeSizeStr, 10)\n if (bitSize > MAX_LEN) {\n throw new Error(`Malformed uint string: ${bitSize}`)\n }\n return new ABIUintType(bitSize)\n }\n if (str === 'byte') {\n return new ABIByteType()\n }\n if (str.startsWith('ufixed')) {\n const stringMatches = str.match(UFIXED_REGEX)\n if (!stringMatches \|\| stringMatches.length !== 3) {\n throw new Error(`Malformed ufixed type: ${str}`)\n }\n const bitSize = parseInt(stringMatches[1], 10)\n const precision = parseInt(stringMatches[2], 10)\n return new ABIUfixedType(bitSize, precision)\n }\n if (str === 'bool') {\n return new ABIBoolType()\n }\n if (str === 'address') {\n return new ABIAddressType()\n }\n if (str === 'string') {\n return new ABIStringType()\n }\n if (str.length >= 2 && str[0] === '(' && str[str.length - 1] === ')') {\n const tupleContent = parseTupleContent(str.slice(1, str.length - 1))\n const childTypes: ABIType[] = []\n for (let i = 0; i < tupleContent.length; i++) {\n const ti = ABIType.from(tupleContent[i])\n childTypes.push(ti)\n }\n return new ABITupleType(childTypes)\n }\n throw new Error(`Cannot convert a string ${str} to an ABI type`)\n }\n}\n\n// ============================================================================\n// Primitive Types\n// ============================================================================\n\n/\n An unsigned integer ABI type of a specific bit size.\n /\nexport class ABIUintType extends ABIType {\n /\n Creates a new unsigned integer type.\n * @param bitSize The bit size (must be a multiple of 8, between 8 and 512)\n /\n constructor(public readonly bitSize: number) {\n super()\n if (bitSize % 8 !== 0 \|\| bitSize < 8 \|\| bitSize > 512) {\n throw new Error(`Unsupported uint type bitSize: ${bitSize}`)\n }\n }\n\n get name(): string {\n return `uint${this.bitSize}`\n }\n\n equals(other: ABIType): boolean {\n return other instanceof ABIUintType && this.bitSize === other.bitSize\n }\n\n isDynamic(): boolean {\n return false\n }\n\n byteLen(): number {\n return this.bitSize / 8\n }\n\n encode(value: ABIValue): Uint8Array {\n if (typeof value !== 'bigint' && typeof value !== 'number') {\n throw new Error(`Cannot encode value as ${this.name}: ${value}`)\n }\n\n if (value >= BigInt(2 * this.bitSize) \|\| value < BigInt(0)) {\n throw new Error(`${value} is not a non-negative int or too big to fit in size ${this.name}`)\n }\n if (typeof value === 'number' && !Number.isSafeInteger(value)) {\n throw new Error(`${value} should be converted into a BigInt before it is encoded`)\n }\n return bigIntToBytes(value, this.bitSize / 8)\n }\n\n decode(bytes: Uint8Array): ABIValue {\n if (bytes.length !== this.bitSize / 8) {\n throw new Error(`Byte string must correspond to a ${this.name}`)\n }\n const value = bytesToBigInt(bytes)\n return this.bitSize < 53 ? Number(value) : value\n }\n}\n\n/*\n A fixed-point number ABI type of a specific bit size and precision.\n /\nexport class ABIUfixedType extends ABIType {\n /\n Creates a new fixed-point type.\n * @param bitSize The bit size (must be a multiple of 8, between 8 and 512)\n * @param precision The decimal precision (must be between 1 and 160)\n /\n constructor(\n public readonly bitSize: number,\n public readonly precision: number,\n ) {\n super()\n if (bitSize % 8 !== 0 \|\| bitSize < 8 \|\| bitSize > 512) {\n throw new Error(`Unsupported ufixed type bitSize: ${bitSize}`)\n }\n if (precision > 160 \|\| precision < 1) {\n throw new Error(`Unsupported ufixed type precision: ${precision}`)\n }\n }\n\n get name(): string {\n return `ufixed${this.bitSize}x${this.precision}`\n }\n\n equals(other: ABIType): boolean {\n return other instanceof ABIUfixedType && this.bitSize === other.bitSize && this.precision === other.precision\n }\n\n isDynamic(): boolean {\n return false\n }\n\n byteLen(): number {\n return this.bitSize / 8\n }\n\n encode(value: ABIValue): Uint8Array {\n if (typeof value !== 'bigint' && typeof value !== 'number') {\n throw new Error(`Cannot encode value as ${this.name}: ${value}`)\n }\n if (value >= BigInt(2 * this.bitSize) \|\| value < BigInt(0)) {\n throw new Error(`${value} is not a non-negative int or too big to fit in size ${this.name}`)\n }\n if (typeof value === 'number' && !Number.isSafeInteger(value)) {\n throw new Error(`${value} should be converted into a BigInt before it is encoded`)\n }\n return bigIntToBytes(value, this.bitSize / 8)\n }\n\n decode(bytes: Uint8Array): ABIValue {\n if (bytes.length !== this.bitSize / 8) {\n throw new Error(`Byte string must correspond to a ${this.name}`)\n }\n const value = bytesToBigInt(bytes)\n return this.bitSize < 53 ? Number(value) : value\n }\n}\n\n/*\n An Algorand address ABI type.\n /\nexport class ABIAddressType extends ABIType {\n get name(): string {\n return 'address'\n }\n\n equals(other: ABIType): boolean {\n return other instanceof ABIAddressType\n }\n\n isDynamic(): boolean {\n return false\n }\n\n byteLen(): number {\n return PUBLIC_KEY_BYTE_LENGTH\n }\n\n encode(value: ABIValue): Uint8Array {\n if (typeof value === 'string') {\n return Address.fromString(value).publicKey\n }\n\n if (value instanceof Address) {\n return value.publicKey\n }\n\n if (value instanceof Uint8Array && value.length === 32) {\n return value\n }\n\n throw new Error(`Cannot encode value as address: ${value}`)\n }\n\n decode(bytes: Uint8Array): string {\n return new Address(bytes).toString()\n }\n}\n\n/\n A boolean ABI type.\n /\nexport class ABIBoolType extends ABIType {\n get name(): string {\n return 'bool'\n }\n\n equals(other: ABIType): boolean {\n return other instanceof ABIBoolType\n }\n\n isDynamic(): boolean {\n return false\n }\n\n byteLen(): number {\n return 1\n }\n\n encode(value: ABIValue): Uint8Array {\n if (typeof value !== 'boolean') {\n throw new Error(`Cannot encode value as bool: ${value}`)\n }\n\n return value ? new Uint8Array([0x80]) : new Uint8Array([0x00])\n }\n\n decode(bytes: Uint8Array): ABIValue {\n if (bytes.length !== 1) {\n throw new Error(`Expected 1 byte for bool, got ${bytes.length}`)\n }\n\n return (bytes[0] & 0x80) !== 0\n }\n}\n\n/\n A single byte ABI type.\n /\nexport class ABIByteType extends ABIType {\n get name(): string {\n return 'byte'\n }\n\n equals(other: ABIType): boolean {\n return other instanceof ABIByteType\n }\n\n isDynamic(): boolean {\n return false\n }\n\n byteLen(): number {\n return 1\n }\n\n encode(value: ABIValue): Uint8Array {\n if (typeof value !== 'number' && typeof value !== 'bigint') {\n throw new Error(`Cannot encode value as byte: ${value}`)\n }\n const numberValue = typeof value === 'bigint' ? Number(value) : value\n if (value < 0 \|\| value > 255) {\n throw new Error(`Byte value must be between 0 and 255, got ${numberValue}`)\n }\n\n return new Uint8Array([numberValue])\n }\n\n decode(bytes: Uint8Array): ABIValue {\n if (bytes.length !== 1) {\n throw new Error(`Expected 1 byte for byte type, got ${bytes.length}`)\n }\n\n return bytes[0]\n }\n}\n\n/\n A dynamic-length string ABI type.\n /\nexport class ABIStringType extends ABIType {\n get name(): string {\n return 'string'\n }\n\n equals(other: ABIType): boolean {\n return other instanceof ABIStringType\n }\n\n isDynamic(): boolean {\n return true\n }\n\n byteLen(): number {\n throw new Error(`Failed to get size, string is a dynamic type`)\n }\n\n encode(value: ABIValue): Uint8Array {\n if (typeof value !== 'string' && !(value instanceof Uint8Array)) {\n throw new Error(`Cannot encode value as string: ${value}`)\n }\n\n let encodedBytes: Uint8Array\n if (typeof value === 'string') {\n encodedBytes = new TextEncoder().encode(value)\n } else {\n encodedBytes = value\n }\n const encodedLength = bigIntToBytes(encodedBytes.length, LENGTH_ENCODE_BYTE_SIZE)\n const mergedBytes = new Uint8Array(encodedBytes.length + LENGTH_ENCODE_BYTE_SIZE)\n mergedBytes.set(encodedLength)\n mergedBytes.set(encodedBytes, LENGTH_ENCODE_BYTE_SIZE)\n return mergedBytes\n }\n\n decode(bytes: Uint8Array): ABIValue {\n if (bytes.length < LENGTH_ENCODE_BYTE_SIZE) {\n throw new Error(\n `Byte string is too short to be decoded. Actual length is ${bytes.length}, but expected at least ${LENGTH_ENCODE_BYTE_SIZE}`,\n )\n }\n const view = new DataView(bytes.buffer, bytes.byteOffset, LENGTH_ENCODE_BYTE_SIZE)\n const byteLength = view.getUint16(0)\n const byteValue = bytes.slice(LENGTH_ENCODE_BYTE_SIZE, bytes.length)\n if (byteLength !== byteValue.length) {\n throw new Error(`String length bytes do not match the actual length of string. Expected ${byteLength}, got ${byteValue.length}`)\n }\n return new TextDecoder('utf-8').decode(byteValue)\n }\n}\n\n// ============================================================================\n// Collection Types\n// ============================================================================\n\n/\n A tuple ABI type containing other ABI types.\n /\nexport class ABITupleType extends ABIType {\n /\n Creates a new tuple type.\n * @param childTypes The types of the tuple elements\n /\n constructor(public readonly childTypes: ABIType[]) {\n super()\n if (childTypes.length > MAX_LEN) {\n throw new Error(`Tuple has too many child types: ${childTypes.length}`)\n }\n }\n\n get name(): string {\n const typeStrings: string[] = []\n for (let i = 0; i < this.childTypes.length; i++) {\n typeStrings[i] = this.childTypes[i].name\n }\n return `(${typeStrings.join(',')})`\n }\n\n equals(other: ABIType): boolean {\n if (!(other instanceof ABITupleType)) return false\n if (this.childTypes.length !== other.childTypes.length) return false\n return this.childTypes.every((t, i) => t.equals(other.childTypes[i]))\n }\n\n isDynamic(): boolean {\n return this.childTypes.some((c) => c.isDynamic())\n }\n\n byteLen(): number {\n let size = 0\n let i = 0\n while (i < this.childTypes.length) {\n const childType = this.childTypes[i]\n if (childType instanceof ABIBoolType) {\n const sequenceEndIndex = findBoolSequenceEnd(this.childTypes, i)\n const boolCount = sequenceEndIndex - i + 1\n size += Math.ceil(boolCount / 8)\n i = sequenceEndIndex + 1\n } else {\n size += childType.byteLen()\n i++\n }\n }\n return size\n }\n\n encode(value: ABIValue): Uint8Array {\n if (!Array.isArray(value) && !(value instanceof Uint8Array)) {\n throw new Error(`Cannot encode value as ${this.toString()}: ${value}`)\n }\n\n const values = Array.from(value)\n\n if (this.childTypes.length !== values.length) {\n throw new Error('Mismatch lengths between the values and types')\n }\n\n const heads: Uint8Array[] = []\n const tails: Uint8Array[] = []\n const isDynamicIndex = new Map<number, boolean>()\n let abiTypesCursor = 0\n\n while (abiTypesCursor < this.childTypes.length) {\n const childType = this.childTypes[abiTypesCursor]\n\n if (childType.isDynamic()) {\n isDynamicIndex.set(heads.length, true)\n heads.push(new Uint8Array(2)) // Placeholder for dynamic offset\n tails.push(childType.encode(values[abiTypesCursor]))\n } else {\n if (childType instanceof ABIBoolType) {\n const boolSequenceEndIndex = findBoolSequenceEnd(this.childTypes, abiTypesCursor)\n const boolValues = values.slice(abiTypesCursor, boolSequenceEndIndex + 1)\n const compressedBool = compressBools(boolValues)\n heads.push(new Uint8Array([compressedBool]))\n abiTypesCursor = boolSequenceEndIndex\n } else {\n heads.push(childType.encode(values[abiTypesCursor]))\n }\n isDynamicIndex.set(abiTypesCursor, false)\n tails.push(new Uint8Array(0))\n }\n abiTypesCursor += 1\n }\n\n const headLength = heads.reduce((sum, head) => sum + head.length, 0)\n let tailLength = 0\n\n for (let i = 0; i < heads.length; i++) {\n if (isDynamicIndex.get(i)) {\n const headValue = headLength + tailLength\n if (headValue > 0xffff) {\n throw new Error(`Value ${headValue} cannot fit in u16`)\n }\n heads[i] = new Uint8Array([(headValue >> 8) & 0xff, headValue & 0xff])\n }\n tailLength += tails[i].length\n }\n\n const totalLength = heads.reduce((sum, head) => sum + head.length, 0) + tails.reduce((sum, tail) => sum + tail.length, 0)\n const result = new Uint8Array(totalLength)\n let offset = 0\n\n for (const head of heads) {\n result.set(head, offset)\n offset += head.length\n }\n\n for (const tail of tails) {\n result.set(tail, offset)\n offset += tail.length\n }\n\n return result\n }\n\n decode(bytes: Uint8Array): ABIValue[] {\n const valuePartitions = extractValues(this.childTypes, bytes)\n const values: ABIValue[] = []\n\n for (let i = 0; i < this.childTypes.length; i++) {\n const childType = this.childTypes[i]\n const valuePartition = valuePartitions[i]\n const childValue = childType.decode(valuePartition)\n values.push(childValue)\n }\n\n return values\n }\n}\n\n/\n A static-length array ABI type.\n /\nexport class ABIArrayStaticType extends ABIType {\n /\n Creates a new static array type.\n * @param childType The type of the array elements\n * @param length The fixed length of the array\n /\n constructor(\n public readonly childType: ABIType,\n public readonly length: number,\n ) {\n super()\n if (length < 0 \|\| length > MAX_LEN) {\n throw new Error(`Invalid static array length: ${length}`)\n }\n }\n\n get name(): string {\n return `${this.childType.name}[${this.length}]`\n }\n\n equals(other: ABIType): boolean {\n return other instanceof ABIArrayStaticType && this.childType.equals(other.childType) && this.length === other.length\n }\n\n isDynamic(): boolean {\n return this.childType.isDynamic()\n }\n\n byteLen(): number {\n if (this.childType instanceof ABIBoolType) {\n return Math.ceil(this.length / 8)\n }\n return this.childType.byteLen() this.length\n }\n\n /*\n Converts this static array type to an equivalent tuple type.\n * @returns The equivalent tuple type\n /\n toABITupleType(): ABITupleType {\n return new ABITupleType(Array(this.length).fill(this.childType))\n }\n\n encode(value: ABIValue): Uint8Array {\n if (!Array.isArray(value) && !(value instanceof Uint8Array)) {\n throw new Error(`Cannot encode value as ${this.name}: ${value}`)\n }\n if (value.length !== this.length) {\n throw new Error(`Value array does not match static array length. Expected ${this.length}, got ${value.length}`)\n }\n const convertedTuple = this.toABITupleType()\n return convertedTuple.encode(value)\n }\n\n decode(bytes: Uint8Array): ABIValue[] \| Uint8Array {\n const convertedTuple = this.toABITupleType()\n const decoded = convertedTuple.decode(bytes)\n\n // Convert byte arrays to Uint8Array\n if (this.childType instanceof ABIByteType && Array.isArray(decoded)) {\n return new Uint8Array(decoded as number[])\n }\n\n return decoded\n }\n}\n\n/\n A dynamic-length array ABI type.\n /\nexport class ABIArrayDynamicType extends ABIType {\n /\n Creates a new dynamic array type.\n * @param childType The type of the array elements\n /\n constructor(public readonly childType: ABIType) {\n super()\n }\n\n get name(): string {\n return `${this.childType.name}[]`\n }\n\n equals(other: ABIType): boolean {\n return other instanceof ABIArrayDynamicType && this.childType.equals(other.childType)\n }\n\n isDynamic(): boolean {\n return true\n }\n\n byteLen(): number {\n throw new Error(`Failed to get size, dynamic array is a dynamic type`)\n }\n\n /\n Converts this dynamic array type to an equivalent tuple type of a given length.\n * @param length The number of elements\n * @returns The equivalent tuple type\n /\n toABITupleType(length: number): ABITupleType {\n return new ABITupleType(Array(length).fill(this.childType))\n }\n\n encode(value: ABIValue): Uint8Array {\n if (!Array.isArray(value) && !(value instanceof Uint8Array)) {\n throw new Error(`Cannot encode value as ${this.name}: ${value}`)\n }\n const convertedTuple = this.toABITupleType(value.length)\n const encodedTuple = convertedTuple.encode(value)\n const encodedLength = bigIntToBytes(convertedTuple.childTypes.length, LENGTH_ENCODE_BYTE_SIZE)\n return concatArrays(encodedLength, encodedTuple)\n }\n\n decode(bytes: Uint8Array): ABIValue[] \| Uint8Array {\n const view = new DataView(bytes.buffer, 0, LENGTH_ENCODE_BYTE_SIZE)\n const byteLength = view.getUint16(0)\n const convertedTuple = this.toABITupleType(byteLength)\n const decoded = convertedTuple.decode(bytes.slice(LENGTH_ENCODE_BYTE_SIZE, bytes.length))\n\n // Convert byte arrays to Uint8Array\n if (this.childType instanceof ABIByteType && Array.isArray(decoded)) {\n return new Uint8Array(decoded as number[])\n }\n\n return decoded\n }\n}\n\n/\n A struct ABI type with named fields.\n /\nexport class ABIStructType extends ABIType {\n /\n Creates a new struct type.\n * @param structName The name of the struct\n * @param structFields The fields of the struct\n /\n constructor(\n public readonly structName: string,\n public readonly structFields: ABIStructField[],\n ) {\n super()\n }\n\n get name(): string {\n const tupleType = this.toABITupleType()\n return tupleType.name\n }\n\n get displayName(): string {\n return this.structName\n }\n\n equals(other: ABIType): boolean {\n if (!(other instanceof ABIStructType)) return false\n if (this.structName !== other.structName) return false\n if (this.structFields.length !== other.structFields.length) return false\n return this.structFields.every((f, i) => {\n const otherField = other.structFields[i]\n if (f.name !== otherField.name) return false\n if (Array.isArray(f.type) && Array.isArray(otherField.type)) {\n return JSON.stringify(f.type) === JSON.stringify(otherField.type)\n }\n if (f.type instanceof ABIType && otherField.type instanceof ABIType) {\n return f.type.equals(otherField.type)\n }\n return false\n })\n }\n\n isDynamic(): boolean {\n const tupleType = this.toABITupleType()\n return tupleType.isDynamic()\n }\n\n byteLen(): number {\n const tupleType = this.toABITupleType()\n return tupleType.byteLen()\n }\n\n /\n Converts this struct type to an equivalent tuple type.\n * @returns The equivalent tuple type\n /\n toABITupleType(): ABITupleType {\n const getABITupleTypeFromABIStructFields = (fields: ABIStructField[]): ABITupleType => {\n const childTypes = fields.map((field) =>\n Array.isArray(field.type)\n ? getABITupleTypeFromABIStructFields(field.type)\n : field.type instanceof ABIStructType\n ? field.type.toABITupleType()\n : field.type,\n )\n return new ABITupleType(childTypes)\n }\n\n return getABITupleTypeFromABIStructFields(this.structFields)\n }\n\n /\n Creates an ABIStructType from struct name and struct definitions.\n * @param structName The name of the struct\n * @param structs A record of struct definitions\n * @returns The struct type\n */\n static fromStruct(structName: string, structs: Record<string, StructField[]>): ABIStructType {\n const getStructFieldType = (structFieldType: string \| StructField[]): ABIType \| ABIStructField[] => {\n // When the input is an array of struct fields\n if (Array.isArray(structFieldType)) {\n return structFieldType.map((structField) => ({\n name: structField.name,\n type: getStructFieldType(structField.type),\n }))\n }\n\n // When the input is a name of another struct\n if (structs[structFieldType]) {\n return ABIStructType.fromStruct(structFieldType, structs)\n }\n\n // When the input in an ABI type name\n return ABIType.from(structFieldType)\n }\n\n if (!structs[structName]) throw new Error('Struct not found')\n\n const fields = structs[structName]\n return new ABIStructType(\n structName,\n fields.map((f) => ({\n name: f.name,\n type: getStructFieldType(f.type),\n })),\n )\n }\n\n encode(value: ABIValue): Uint8Array {\n if (value instanceof Uint8Array \|\| value instanceof Address \|\| typeof value !== 'object') {\n throw new Error(`Cannot encode value as ${this.name}: ${value}`)\n }\n\n const tupleType = this.toABITupleType()\n if (Array.isArray(value)) {\n return tupleType.encode(value)\n }\n\n const tupleValue = this.getTupleValueFromStructValue(value)\n return tupleType.encode(tupleValue)\n }\n\n decode(bytes: Uint8Array): ABIStructValue {\n const tupleType = this.toABITupleType()\n const tupleValue = tupleType.decode(bytes)\n return this.getStructValueFromTupleValue(tupleValue)\n }\n\n private getTupleValueFromStructValue(structValue: ABIStructValue): ABIValue[] {\n const getTupleValueFromStructFields = (structFields: ABIStructField[], values: ABIValue[]): ABIValue[] => {\n return structFields.map(({ type }, index) => {\n // if type is an array of fields, treat as unnamed struct\n if (Array.isArray(type)) {\n const value = values[index] as ABIStructValue\n return getTupleValueFromStructFields(type, Object.values(value))\n }\n // if type is struct, treat as struct\n if (type instanceof ABIStructType) {\n const value = values[index] as ABIStructValue\n return getTupleValueFromStructFields(type.structFields, Object.values(value))\n }\n return values[index]\n })\n }\n\n return getTupleValueFromStructFields(this.structFields, Object.values(structValue))\n }\n\n private getStructValueFromTupleValue(tupleValue: ABIValue[]): ABIStructValue {\n const getStructFieldValues = (structFields: ABIStructField[], values: ABIValue[]): ABIStructValue => {\n return Object.fromEntries(\n structFields.map(({ name, type }, index) => {\n // When the type is an array of fields, the value must be tuple\n if (Array.isArray(type)) {\n const value = values[index] as ABIValue[]\n return [name, getStructFieldValues(type, value)]\n }\n // When the type is a struct, the value must be tuple\n if (type instanceof ABIStructType) {\n const value = values[index] as ABIValue[]\n return [name, getStructFieldValues(type.structFields, value)]\n }\n return [name, values[index]]\n }),\n )\n }\n\n return getStructFieldValues(this.structFields, tupleValue)\n }\n}\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\nfunction compressBools(values: ABIValue[]): number {\n if (values.length > 8) {\n throw new Error(`Expected no more than 8 bool values, received ${values.length}`)\n }\n\n let result = 0\n for (let i = 0; i < values.length; i++) {\n if (typeof values[i] !== 'boolean') {\n throw new Error('Expected all values to be boolean')\n }\n if (values[i]) {\n result \|= 1 << (7 - i)\n }\n }\n\n return result\n}\n\nfunction findBoolSequenceEnd(abiTypes: ABIType[], currentIndex: number): number {\n let cursor = currentIndex\n while (cursor < abiTypes.length) {\n if (abiTypes[cursor] instanceof ABIBoolType) {\n if (cursor - currentIndex + 1 === 8 \|\| cursor === abiTypes.length - 1) {\n return cursor\n }\n cursor++\n } else {\n return cursor - 1\n }\n }\n return cursor - 1\n}\n\nfunction extractValues(abiTypes: ABIType[], bytes: Uint8Array): Uint8Array[] {\n const dynamicSegments: Segment[] = []\n const valuePartitions: (Uint8Array \| null)[] = []\n let bytesCursor = 0\n let abiTypesCursor = 0\n\n while (abiTypesCursor < abiTypes.length) {\n const childType = abiTypes[abiTypesCursor]\n\n if (childType.isDynamic()) {\n if (bytes.length - bytesCursor < LENGTH_ENCODE_BYTE_SIZE) {\n throw new Error('Byte array is too short to be decoded')\n }\n\n const dynamicIndex = (bytes[bytesCursor] << 8) \| bytes[bytesCursor + 1]\n\n if (dynamicSegments.length > 0) {\n const lastSegment = dynamicSegments[dynamicSegments.length - 1]\n if (dynamicIndex < lastSegment.left) {\n throw new Error('Dynamic index segment miscalculation: left is greater than right index')\n }\n lastSegment.right = dynamicIndex\n }\n\n dynamicSegments.push({ left: dynamicIndex, right: 0 })\n valuePartitions.push(null)\n bytesCursor += LENGTH_ENCODE_BYTE_SIZE\n } else {\n if (childType instanceof ABIBoolType) {\n const boolSequenceEndIndex = findBoolSequenceEnd(abiTypes, abiTypesCursor)\n for (let j = 0; j <= boolSequenceEndIndex - abiTypesCursor; j++) {\n const boolMask = BOOL_TRUE_BYTE >> j\n if ((bytes[bytesCursor] & boolMask) > 0) {\n valuePartitions.push(new Uint8Array([BOOL_TRUE_BYTE]))\n } else {\n valuePartitions.push(new Uint8Array([BOOL_FALSE_BYTE]))\n }\n }\n abiTypesCursor = boolSequenceEndIndex\n bytesCursor += 1\n } else {\n const childTypeSize = childType.byteLen()\n if (bytesCursor + childTypeSize > bytes.length) {\n throw new Error(\n `Index out of bounds, trying to access bytes[${bytesCursor}..${bytesCursor + childTypeSize}] but slice has length ${bytes.length}`,\n )\n }\n valuePartitions.push(bytes.slice(bytesCursor, bytesCursor + childTypeSize))\n bytesCursor += childTypeSize\n }\n }\n\n if (abiTypesCursor !== abiTypes.length - 1 && bytesCursor >= bytes.length) {\n throw new Error('Input bytes not enough to decode')\n }\n abiTypesCursor += 1\n }\n\n if (dynamicSegments.length > 0) {\n const lastSegment = dynamicSegments[dynamicSegments.length - 1]\n lastSegment.right = bytes.length\n } else if (bytesCursor < bytes.length) {\n throw new Error('Input bytes not fully consumed')\n }\n\n for (let i = 0; i < dynamicSegments.length; i++) {\n const segment = dynamicSegments[i]\n if (segment.left > segment.right) {\n throw new Error('Dynamic segment should display a [l, r] space with l <= r')\n }\n if (i !== dynamicSegments.length - 1 && segment.right !== dynamicSegments[i + 1].left) {\n throw new Error('Dynamic segments should be consecutive')\n }\n }\n\n let segmentIndex = 0\n for (let i = 0; i < abiTypes.length; i++) {\n const childType = abiTypes[i]\n if (childType.isDynamic()) {\n valuePartitions[i] = bytes.slice(dynamicSegments[segmentIndex].left, dynamicSegments[segmentIndex].right)\n segmentIndex += 1\n }\n }\n\n const result: Uint8Array[] = []\n for (let i = 0; i < valuePartitions.length; i++) {\n const partition = valuePartitions[i]\n if (partition === null) {\n throw new Error(`Value partition at index ${i} is None`)\n }\n result.push(partition)\n }\n\n return result\n}\n\nexport function parseTupleContent(content: string): string[] {\n if (content === '') {\n return []\n }\n\n if (content.startsWith(',')) {\n throw new Error('The content should not start with comma')\n }\n if (content.endsWith(',')) {\n throw new Error('The content should not end with comma')\n }\n if (content.includes(',,')) {\n throw new Error('The content should not have consecutive commas')\n }\n\n const tupleStrings: string[] = []\n let depth = 0\n let word = ''\n\n for (const ch of content) {\n word += ch\n if (ch === '(') {\n depth += 1\n } else if (ch === ')') {\n depth -= 1\n } else if (ch === ',' && depth === 0) {\n word = word.slice(0, -1) // Remove the comma\n tupleStrings.push(word)\n word = ''\n }\n }\n\n if (word !== '') {\n tupleStrings.push(word)\n }\n\n if (depth !== 0) {\n throw new Error('The content has mismatched parentheses')\n }\n\n return tupleStrings\n}\n"],"mappings":";;;;;;AAYA,MAAM,qBAAqB;AAC3B,MAAM,eAAe;AACrB,MAAM,UAAU,KAAK,KAAK;;;;;;AAsB1B,IAAsB,UAAtB,MAAsB,QAAQ;;;;;CAW5B,IAAI,cAAsB;AACxB,SAAO,KAAK;;;;;;CAOd,WAAmB;AACjB,SAAO,KAAK;;;;;;;CA0Cd,OAAO,KAAK,KAAsB;AAChC,MAAI,IAAI,SAAS,KAAK,CAEpB,QAAO,IAAI,oBADO,QAAQ,KAAK,IAAI,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC,CACnB;AAE3C,MAAI,IAAI,SAAS,IAAI,EAAE;GACrB,MAAM,gBAAgB,IAAI,MAAM,mBAAmB;AACnD,OAAI,CAAC,iBAAiB,cAAc,WAAW,EAC7C,OAAM,IAAI,MAAM,kCAAkC,MAAM;GAE1D,MAAM,iBAAiB,cAAc;GACrC,MAAM,cAAc,SAAS,gBAAgB,GAAG;AAChD,OAAI,cAAc,QAChB,OAAM,IAAI,MAAM,8BAA8B,UAAU;AAG1D,UAAO,IAAI,mBADO,QAAQ,KAAK,cAAc,GAAG,EACP,YAAY;;AAEvD,MAAI,IAAI,WAAW,OAAO,EAAE;GAC1B,MAAM,cAAc,MAAc,CAAC,GAAG,EAAE,CAAC,OAAO,MAAM,aAAa,SAAS,EAAE,CAAC;GAC/E,MAAM,cAAc,IAAI,MAAM,GAAG,IAAI,OAAO;AAC5C,OAAI,CAAC,WAAW,YAAY,CAC1B,OAAM,IAAI,MAAM,0BAA0B,cAAc;GAE1D,MAAM,UAAU,SAAS,aAAa,GAAG;AACzC,OAAI,UAAU,QACZ,OAAM,IAAI,MAAM,0BAA0B,UAAU;AAEtD,UAAO,IAAI,YAAY,QAAQ;;AAEjC,MAAI,QAAQ,OACV,QAAO,IAAI,aAAa;AAE1B,MAAI,IAAI,WAAW,SAAS,EAAE;GAC5B,MAAM,gBAAgB,IAAI,MAAM,aAAa;AAC7C,OAAI,CAAC,iBAAiB,cAAc,WAAW,EAC7C,OAAM,IAAI,MAAM,0BAA0B,MAAM;AAIlD,UAAO,IAAI,cAFK,SAAS,cAAc,IAAI,GAAG,EAC5B,SAAS,cAAc,IAAI,GAAG,CACJ;;AAE9C,MAAI,QAAQ,OACV,QAAO,IAAI,aAAa;AAE1B,MAAI,QAAQ,UACV,QAAO,IAAI,gBAAgB;AAE7B,MAAI,QAAQ,SACV,QAAO,IAAI,eAAe;AAE5B,MAAI,IAAI,UAAU,KAAK,IAAI,OAAO,OAAO,IAAI,IAAI,SAAS,OAAO,KAAK;GACpE,MAAM,eAAe,kBAAkB,IAAI,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;GACpE,MAAMA,aAAwB,EAAE;AAChC,QAAK,IAAI,IAAI,GAAG,IAAI,aAAa,QAAQ,KAAK;IAC5C,MAAM,KAAK,QAAQ,KAAK,aAAa,GAAG;AACxC,eAAW,KAAK,GAAG;;AAErB,UAAO,IAAI,aAAa,WAAW;;AAErC,QAAM,IAAI,MAAM,2BAA2B,IAAI,iBAAiB;;;;;;AAWpE,IAAa,cAAb,MAAa,oBAAoB,QAAQ;;;;;CAKvC,YAAY,AAAgBC,SAAiB;AAC3C,SAAO;EADmB;AAE1B,MAAI,UAAU,MAAM,KAAK,UAAU,KAAK,UAAU,IAChD,OAAM,IAAI,MAAM,kCAAkC,UAAU;;CAIhE,IAAI,OAAe;AACjB,SAAO,OAAO,KAAK;;CAGrB,OAAO,OAAyB;AAC9B,SAAO,iBAAiB,eAAe,KAAK,YAAY,MAAM;;CAGhE,YAAqB;AACnB,SAAO;;CAGT,UAAkB;AAChB,SAAO,KAAK,UAAU;;CAGxB,OAAO,OAA6B;AAClC,MAAI,OAAO,UAAU,YAAY,OAAO,UAAU,SAChD,OAAM,IAAI,MAAM,0BAA0B,KAAK,KAAK,IAAI,QAAQ;AAGlE,MAAI,SAAS,OAAO,KAAK,KAAK,QAAQ,IAAI,QAAQ,OAAO,EAAE,CACzD,OAAM,IAAI,MAAM,GAAG,MAAM,uDAAuD,KAAK,OAAO;AAE9F,MAAI,OAAO,UAAU,YAAY,CAAC,OAAO,cAAc,MAAM,CAC3D,OAAM,IAAI,MAAM,GAAG,MAAM,yDAAyD;AAEpF,SAAO,cAAc,OAAO,KAAK,UAAU,EAAE;;CAG/C,OAAO,OAA6B;AAClC,MAAI,MAAM,WAAW,KAAK,UAAU,EAClC,OAAM,IAAI,MAAM,oCAAoC,KAAK,OAAO;EAElE,MAAM,QAAQ,cAAc,MAAM;AAClC,SAAO,KAAK,UAAU,KAAK,OAAO,MAAM,GAAG;;;;;;AAO/C,IAAa,gBAAb,MAAa,sBAAsB,QAAQ;;;;;;CAMzC,YACE,AAAgBA,SAChB,AAAgBC,WAChB;AACA,SAAO;EAHS;EACA;AAGhB,MAAI,UAAU,MAAM,KAAK,UAAU,KAAK,UAAU,IAChD,OAAM,IAAI,MAAM,oCAAoC,UAAU;AAEhE,MAAI,YAAY,OAAO,YAAY,EACjC,OAAM,IAAI,MAAM,sCAAsC,YAAY;;CAItE,IAAI,OAAe;AACjB,SAAO,SAAS,KAAK,QAAQ,GAAG,KAAK;;CAGvC,OAAO,OAAyB;AAC9B,SAAO,iBAAiB,iBAAiB,KAAK,YAAY,MAAM,WAAW,KAAK,cAAc,MAAM;;CAGtG,YAAqB;AACnB,SAAO;;CAGT,UAAkB;AAChB,SAAO,KAAK,UAAU;;CAGxB,OAAO,OAA6B;AAClC,MAAI,OAAO,UAAU,YAAY,OAAO,UAAU,SAChD,OAAM,IAAI,MAAM,0BAA0B,KAAK,KAAK,IAAI,QAAQ;AAElE,MAAI,SAAS,OAAO,KAAK,KAAK,QAAQ,IAAI,QAAQ,OAAO,EAAE,CACzD,OAAM,IAAI,MAAM,GAAG,MAAM,uDAAuD,KAAK,OAAO;AAE9F,MAAI,OAAO,UAAU,YAAY,CAAC,OAAO,cAAc,MAAM,CAC3D,OAAM,IAAI,MAAM,GAAG,MAAM,yDAAyD;AAEpF,SAAO,cAAc,OAAO,KAAK,UAAU,EAAE;;CAG/C,OAAO,OAA6B;AAClC,MAAI,MAAM,WAAW,KAAK,UAAU,EAClC,OAAM,IAAI,MAAM,oCAAoC,KAAK,OAAO;EAElE,MAAM,QAAQ,cAAc,MAAM;AAClC,SAAO,KAAK,UAAU,KAAK,OAAO,MAAM,GAAG;;;;;;AAO/C,IAAa,iBAAb,MAAa,uBAAuB,QAAQ;CAC1C,IAAI,OAAe;AACjB,SAAO;;CAGT,OAAO,OAAyB;AAC9B,SAAO,iBAAiB;;CAG1B,YAAqB;AACnB,SAAO;;CAGT,UAAkB;AAChB,SAAO;;CAGT,OAAO,OAA6B;AAClC,MAAI,OAAO,UAAU,SACnB,QAAO,QAAQ,WAAW,MAAM,CAAC;AAGnC,MAAI,iBAAiB,QACnB,QAAO,MAAM;AAGf,MAAI,iBAAiB,cAAc,MAAM,WAAW,GAClD,QAAO;AAGT,QAAM,IAAI,MAAM,mCAAmC,QAAQ;;CAG7D,OAAO,OAA2B;AAChC,SAAO,IAAI,QAAQ,MAAM,CAAC,UAAU;;;;;;AAOxC,IAAa,cAAb,MAAa,oBAAoB,QAAQ;CACvC,IAAI,OAAe;AACjB,SAAO;;CAGT,OAAO,OAAyB;AAC9B,SAAO,iBAAiB;;CAG1B,YAAqB;AACnB,SAAO;;CAGT,UAAkB;AAChB,SAAO;;CAGT,OAAO,OAA6B;AAClC,MAAI,OAAO,UAAU,UACnB,OAAM,IAAI,MAAM,gCAAgC,QAAQ;AAG1D,SAAO,QAAQ,IAAI,WAAW,CAAC,IAAK,CAAC,GAAG,IAAI,WAAW,CAAC,EAAK,CAAC;;CAGhE,OAAO,OAA6B;AAClC,MAAI,MAAM,WAAW,EACnB,OAAM,IAAI,MAAM,iCAAiC,MAAM,SAAS;AAGlE,UAAQ,MAAM,KAAK,SAAU;;;;;;AAOjC,IAAa,cAAb,MAAa,oBAAoB,QAAQ;CACvC,IAAI,OAAe;AACjB,SAAO;;CAGT,OAAO,OAAyB;AAC9B,SAAO,iBAAiB;;CAG1B,YAAqB;AACnB,SAAO;;CAGT,UAAkB;AAChB,SAAO;;CAGT,OAAO,OAA6B;AAClC,MAAI,OAAO,UAAU,YAAY,OAAO,UAAU,SAChD,OAAM,IAAI,MAAM,gCAAgC,QAAQ;EAE1D,MAAM,cAAc,OAAO,UAAU,WAAW,OAAO,MAAM,GAAG;AAChE,MAAI,QAAQ,KAAK,QAAQ,IACvB,OAAM,IAAI,MAAM,6CAA6C,cAAc;AAG7E,SAAO,IAAI,WAAW,CAAC,YAAY,CAAC;;CAGtC,OAAO,OAA6B;AAClC,MAAI,MAAM,WAAW,EACnB,OAAM,IAAI,MAAM,sCAAsC,MAAM,SAAS;AAGvE,SAAO,MAAM;;;;;;AAOjB,IAAa,gBAAb,MAAa,sBAAsB,QAAQ;CACzC,IAAI,OAAe;AACjB,SAAO;;CAGT,OAAO,OAAyB;AAC9B,SAAO,iBAAiB;;CAG1B,YAAqB;AACnB,SAAO;;CAGT,UAAkB;AAChB,QAAM,IAAI,MAAM,+CAA+C;;CAGjE,OAAO,OAA6B;AAClC,MAAI,OAAO,UAAU,YAAY,EAAE,iBAAiB,YAClD,OAAM,IAAI,MAAM,kCAAkC,QAAQ;EAG5D,IAAIC;AACJ,MAAI,OAAO,UAAU,SACnB,gBAAe,IAAI,aAAa,CAAC,OAAO,MAAM;MAE9C,gBAAe;EAEjB,MAAM,gBAAgB,cAAc,aAAa,QAAQ,wBAAwB;EACjF,MAAM,cAAc,IAAI,WAAW,aAAa,SAAS,wBAAwB;AACjF,cAAY,IAAI,cAAc;AAC9B,cAAY,IAAI,cAAc,wBAAwB;AACtD,SAAO;;CAGT,OAAO,OAA6B;AAClC,MAAI,MAAM,SAAS,wBACjB,OAAM,IAAI,MACR,4DAA4D,MAAM,OAAO,0BAA0B,0BACpG;EAGH,MAAM,aADO,IAAI,SAAS,MAAM,QAAQ,MAAM,YAAY,wBAAwB,CAC1D,UAAU,EAAE;EACpC,MAAM,YAAY,MAAM,MAAM,yBAAyB,MAAM,OAAO;AACpE,MAAI,eAAe,UAAU,OAC3B,OAAM,IAAI,MAAM,0EAA0E,WAAW,QAAQ,UAAU,SAAS;AAElI,SAAO,IAAI,YAAY,QAAQ,CAAC,OAAO,UAAU;;;;;;AAWrD,IAAa,eAAb,MAAa,qBAAqB,QAAQ;;;;;CAKxC,YAAY,AAAgBH,YAAuB;AACjD,SAAO;EADmB;AAE1B,MAAI,WAAW,SAAS,QACtB,OAAM,IAAI,MAAM,mCAAmC,WAAW,SAAS;;CAI3E,IAAI,OAAe;EACjB,MAAMI,cAAwB,EAAE;AAChC,OAAK,IAAI,IAAI,GAAG,IAAI,KAAK,WAAW,QAAQ,IAC1C,aAAY,KAAK,KAAK,WAAW,GAAG;AAEtC,SAAO,IAAI,YAAY,KAAK,IAAI,CAAC;;CAGnC,OAAO,OAAyB;AAC9B,MAAI,EAAE,iBAAiB,cAAe,QAAO;AAC7C,MAAI,KAAK,WAAW,WAAW,MAAM,WAAW,OAAQ,QAAO;AAC/D,SAAO,KAAK,WAAW,OAAO,GAAG,MAAM,EAAE,OAAO,MAAM,WAAW,GAAG,CAAC;;CAGvE,YAAqB;AACnB,SAAO,KAAK,WAAW,MAAM,MAAM,EAAE,WAAW,CAAC;;CAGnD,UAAkB;EAChB,IAAI,OAAO;EACX,IAAI,IAAI;AACR,SAAO,IAAI,KAAK,WAAW,QAAQ;GACjC,MAAM,YAAY,KAAK,WAAW;AAClC,OAAI,qBAAqB,aAAa;IACpC,MAAM,mBAAmB,oBAAoB,KAAK,YAAY,EAAE;IAChE,MAAM,YAAY,mBAAmB,IAAI;AACzC,YAAQ,KAAK,KAAK,YAAY,EAAE;AAChC,QAAI,mBAAmB;UAClB;AACL,YAAQ,UAAU,SAAS;AAC3B;;;AAGJ,SAAO;;CAGT,OAAO,OAA6B;AAClC,MAAI,CAAC,MAAM,QAAQ,MAAM,IAAI,EAAE,iBAAiB,YAC9C,OAAM,IAAI,MAAM,0BAA0B,KAAK,UAAU,CAAC,IAAI,QAAQ;EAGxE,MAAM,SAAS,MAAM,KAAK,MAAM;AAEhC,MAAI,KAAK,WAAW,WAAW,OAAO,OACpC,OAAM,IAAI,MAAM,gDAAgD;EAGlE,MAAMC,QAAsB,EAAE;EAC9B,MAAMC,QAAsB,EAAE;EAC9B,MAAM,iCAAiB,IAAI,KAAsB;EACjD,IAAI,iBAAiB;AAErB,SAAO,iBAAiB,KAAK,WAAW,QAAQ;GAC9C,MAAM,YAAY,KAAK,WAAW;AAElC,OAAI,UAAU,WAAW,EAAE;AACzB,mBAAe,IAAI,MAAM,QAAQ,KAAK;AACtC,UAAM,KAAK,IAAI,WAAW,EAAE,CAAC;AAC7B,UAAM,KAAK,UAAU,OAAO,OAAO,gBAAgB,CAAC;UAC/C;AACL,QAAI,qBAAqB,aAAa;KACpC,MAAM,uBAAuB,oBAAoB,KAAK,YAAY,eAAe;KAEjF,MAAM,iBAAiB,cADJ,OAAO,MAAM,gBAAgB,uBAAuB,EAAE,CACzB;AAChD,WAAM,KAAK,IAAI,WAAW,CAAC,eAAe,CAAC,CAAC;AAC5C,sBAAiB;UAEjB,OAAM,KAAK,UAAU,OAAO,OAAO,gBAAgB,CAAC;AAEtD,mBAAe,IAAI,gBAAgB,MAAM;AACzC,UAAM,KAAK,IAAI,WAAW,EAAE,CAAC;;AAE/B,qBAAkB;;EAGpB,MAAM,aAAa,MAAM,QAAQ,KAAK,SAAS,MAAM,KAAK,QAAQ,EAAE;EACpE,IAAI,aAAa;AAEjB,OAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;AACrC,OAAI,eAAe,IAAI,EAAE,EAAE;IACzB,MAAM,YAAY,aAAa;AAC/B,QAAI,YAAY,MACd,OAAM,IAAI,MAAM,SAAS,UAAU,oBAAoB;AAEzD,UAAM,KAAK,IAAI,WAAW,CAAE,aAAa,IAAK,KAAM,YAAY,IAAK,CAAC;;AAExE,iBAAc,MAAM,GAAG;;EAGzB,MAAM,cAAc,MAAM,QAAQ,KAAK,SAAS,MAAM,KAAK,QAAQ,EAAE,GAAG,MAAM,QAAQ,KAAK,SAAS,MAAM,KAAK,QAAQ,EAAE;EACzH,MAAM,SAAS,IAAI,WAAW,YAAY;EAC1C,IAAI,SAAS;AAEb,OAAK,MAAM,QAAQ,OAAO;AACxB,UAAO,IAAI,MAAM,OAAO;AACxB,aAAU,KAAK;;AAGjB,OAAK,MAAM,QAAQ,OAAO;AACxB,UAAO,IAAI,MAAM,OAAO;AACxB,aAAU,KAAK;;AAGjB,SAAO;;CAGT,OAAO,OAA+B;EACpC,MAAM,kBAAkB,cAAc,KAAK,YAAY,MAAM;EAC7D,MAAMC,SAAqB,EAAE;AAE7B,OAAK,IAAI,IAAI,GAAG,IAAI,KAAK,WAAW,QAAQ,KAAK;GAC/C,MAAM,YAAY,KAAK,WAAW;GAClC,MAAM,iBAAiB,gBAAgB;GACvC,MAAM,aAAa,UAAU,OAAO,eAAe;AACnD,UAAO,KAAK,WAAW;;AAGzB,SAAO;;;;;;AAOX,IAAa,qBAAb,MAAa,2BAA2B,QAAQ;;;;;;CAM9C,YACE,AAAgBC,WAChB,AAAgBC,QAChB;AACA,SAAO;EAHS;EACA;AAGhB,MAAI,SAAS,KAAK,SAAS,QACzB,OAAM,IAAI,MAAM,gCAAgC,SAAS;;CAI7D,IAAI,OAAe;AACjB,SAAO,GAAG,KAAK,UAAU,KAAK,GAAG,KAAK,OAAO;;CAG/C,OAAO,OAAyB;AAC9B,SAAO,iBAAiB,sBAAsB,KAAK,UAAU,OAAO,MAAM,UAAU,IAAI,KAAK,WAAW,MAAM;;CAGhH,YAAqB;AACnB,SAAO,KAAK,UAAU,WAAW;;CAGnC,UAAkB;AAChB,MAAI,KAAK,qBAAqB,YAC5B,QAAO,KAAK,KAAK,KAAK,SAAS,EAAE;AAEnC,SAAO,KAAK,UAAU,SAAS,GAAG,KAAK;;;;;;CAOzC,iBAA+B;AAC7B,SAAO,IAAI,aAAa,MAAM,KAAK,OAAO,CAAC,KAAK,KAAK,UAAU,CAAC;;CAGlE,OAAO,OAA6B;AAClC,MAAI,CAAC,MAAM,QAAQ,MAAM,IAAI,EAAE,iBAAiB,YAC9C,OAAM,IAAI,MAAM,0BAA0B,KAAK,KAAK,IAAI,QAAQ;AAElE,MAAI,MAAM,WAAW,KAAK,OACxB,OAAM,IAAI,MAAM,4DAA4D,KAAK,OAAO,QAAQ,MAAM,SAAS;AAGjH,SADuB,KAAK,gBAAgB,CACtB,OAAO,MAAM;;CAGrC,OAAO,OAA4C;EAEjD,MAAM,UADiB,KAAK,gBAAgB,CACb,OAAO,MAAM;AAG5C,MAAI,KAAK,qBAAqB,eAAe,MAAM,QAAQ,QAAQ,CACjE,QAAO,IAAI,WAAW,QAAoB;AAG5C,SAAO;;;;;;AAOX,IAAa,sBAAb,MAAa,4BAA4B,QAAQ;;;;;CAK/C,YAAY,AAAgBD,WAAoB;AAC9C,SAAO;EADmB;;CAI5B,IAAI,OAAe;AACjB,SAAO,GAAG,KAAK,UAAU,KAAK;;CAGhC,OAAO,OAAyB;AAC9B,SAAO,iBAAiB,uBAAuB,KAAK,UAAU,OAAO,MAAM,UAAU;;CAGvF,YAAqB;AACnB,SAAO;;CAGT,UAAkB;AAChB,QAAM,IAAI,MAAM,sDAAsD;;;;;;;CAQxE,eAAe,QAA8B;AAC3C,SAAO,IAAI,aAAa,MAAM,OAAO,CAAC,KAAK,KAAK,UAAU,CAAC;;CAG7D,OAAO,OAA6B;AAClC,MAAI,CAAC,MAAM,QAAQ,MAAM,IAAI,EAAE,iBAAiB,YAC9C,OAAM,IAAI,MAAM,0BAA0B,KAAK,KAAK,IAAI,QAAQ;EAElE,MAAM,iBAAiB,KAAK,eAAe,MAAM,OAAO;EACxD,MAAM,eAAe,eAAe,OAAO,MAAM;AAEjD,SAAO,aADe,cAAc,eAAe,WAAW,QAAQ,wBAAwB,EAC3D,aAAa;;CAGlD,OAAO,OAA4C;EAEjD,MAAM,aADO,IAAI,SAAS,MAAM,QAAQ,GAAG,wBAAwB,CAC3C,UAAU,EAAE;EAEpC,MAAM,UADiB,KAAK,eAAe,WAAW,CACvB,OAAO,MAAM,MAAM,yBAAyB,MAAM,OAAO,CAAC;AAGzF,MAAI,KAAK,qBAAqB,eAAe,MAAM,QAAQ,QAAQ,CACjE,QAAO,IAAI,WAAW,QAAoB;AAG5C,SAAO;;;;;;AAOX,IAAa,gBAAb,MAAa,sBAAsB,QAAQ;;;;;;CAMzC,YACE,AAAgBE,YAChB,AAAgBC,cAChB;AACA,SAAO;EAHS;EACA;;CAKlB,IAAI,OAAe;AAEjB,SADkB,KAAK,gBAAgB,CACtB;;CAGnB,IAAI,cAAsB;AACxB,SAAO,KAAK;;CAGd,OAAO,OAAyB;AAC9B,MAAI,EAAE,iBAAiB,eAAgB,QAAO;AAC9C,MAAI,KAAK,eAAe,MAAM,WAAY,QAAO;AACjD,MAAI,KAAK,aAAa,WAAW,MAAM,aAAa,OAAQ,QAAO;AACnE,SAAO,KAAK,aAAa,OAAO,GAAG,MAAM;GACvC,MAAM,aAAa,MAAM,aAAa;AACtC,OAAI,EAAE,SAAS,WAAW,KAAM,QAAO;AACvC,OAAI,MAAM,QAAQ,EAAE,KAAK,IAAI,MAAM,QAAQ,WAAW,KAAK,CACzD,QAAO,KAAK,UAAU,EAAE,KAAK,KAAK,KAAK,UAAU,WAAW,KAAK;AAEnE,OAAI,EAAE,gBAAgB,WAAW,WAAW,gBAAgB,QAC1D,QAAO,EAAE,KAAK,OAAO,WAAW,KAAK;AAEvC,UAAO;IACP;;CAGJ,YAAqB;AAEnB,SADkB,KAAK,gBAAgB,CACtB,WAAW;;CAG9B,UAAkB;AAEhB,SADkB,KAAK,gBAAgB,CACtB,SAAS;;;;;;CAO5B,iBAA+B;EAC7B,MAAM,sCAAsC,WAA2C;AAQrF,UAAO,IAAI,aAPQ,OAAO,KAAK,UAC7B,MAAM,QAAQ,MAAM,KAAK,GACrB,mCAAmC,MAAM,KAAK,GAC9C,MAAM,gBAAgB,gBACpB,MAAM,KAAK,gBAAgB,GAC3B,MAAM,KACb,CACkC;;AAGrC,SAAO,mCAAmC,KAAK,aAAa;;;;;;;;CAS9D,OAAO,WAAW,YAAoB,SAAuD;EAC3F,MAAM,sBAAsB,oBAAwE;AAElG,OAAI,MAAM,QAAQ,gBAAgB,CAChC,QAAO,gBAAgB,KAAK,iBAAiB;IAC3C,MAAM,YAAY;IAClB,MAAM,mBAAmB,YAAY,KAAK;IAC3C,EAAE;AAIL,OAAI,QAAQ,iBACV,QAAO,cAAc,WAAW,iBAAiB,QAAQ;AAI3D,UAAO,QAAQ,KAAK,gBAAgB;;AAGtC,MAAI,CAAC,QAAQ,YAAa,OAAM,IAAI,MAAM,mBAAmB;EAE7D,MAAM,SAAS,QAAQ;AACvB,SAAO,IAAI,cACT,YACA,OAAO,KAAK,OAAO;GACjB,MAAM,EAAE;GACR,MAAM,mBAAmB,EAAE,KAAK;GACjC,EAAE,CACJ;;CAGH,OAAO,OAA6B;AAClC,MAAI,iBAAiB,cAAc,iBAAiB,WAAW,OAAO,UAAU,SAC9E,OAAM,IAAI,MAAM,0BAA0B,KAAK,KAAK,IAAI,QAAQ;EAGlE,MAAM,YAAY,KAAK,gBAAgB;AACvC,MAAI,MAAM,QAAQ,MAAM,CACtB,QAAO,UAAU,OAAO,MAAM;EAGhC,MAAM,aAAa,KAAK,6BAA6B,MAAM;AAC3D,SAAO,UAAU,OAAO,WAAW;;CAGrC,OAAO,OAAmC;EAExC,MAAM,aADY,KAAK,gBAAgB,CACV,OAAO,MAAM;AAC1C,SAAO,KAAK,6BAA6B,WAAW;;CAGtD,AAAQ,6BAA6B,aAAyC;EAC5E,MAAM,iCAAiC,cAAgC,WAAmC;AACxG,UAAO,aAAa,KAAK,EAAE,QAAQ,UAAU;AAE3C,QAAI,MAAM,QAAQ,KAAK,EAAE;KACvB,MAAM,QAAQ,OAAO;AACrB,YAAO,8BAA8B,MAAM,OAAO,OAAO,MAAM,CAAC;;AAGlE,QAAI,gBAAgB,eAAe;KACjC,MAAM,QAAQ,OAAO;AACrB,YAAO,8BAA8B,KAAK,cAAc,OAAO,OAAO,MAAM,CAAC;;AAE/E,WAAO,OAAO;KACd;;AAGJ,SAAO,8BAA8B,KAAK,cAAc,OAAO,OAAO,YAAY,CAAC;;CAGrF,AAAQ,6BAA6B,YAAwC;EAC3E,MAAM,wBAAwB,cAAgC,WAAuC;AACnG,UAAO,OAAO,YACZ,aAAa,KAAK,EAAE,MAAM,QAAQ,UAAU;AAE1C,QAAI,MAAM,QAAQ,KAAK,EAAE;KACvB,MAAM,QAAQ,OAAO;AACrB,YAAO,CAAC,MAAM,qBAAqB,MAAM,MAAM,CAAC;;AAGlD,QAAI,gBAAgB,eAAe;KACjC,MAAM,QAAQ,OAAO;AACrB,YAAO,CAAC,MAAM,qBAAqB,KAAK,cAAc,MAAM,CAAC;;AAE/D,WAAO,CAAC,MAAM,OAAO,OAAO;KAC5B,CACH;;AAGH,SAAO,qBAAqB,KAAK,cAAc,WAAW;;;AAQ9D,SAAS,cAAc,QAA4B;AACjD,KAAI,OAAO,SAAS,EAClB,OAAM,IAAI,MAAM,iDAAiD,OAAO,SAAS;CAGnF,IAAI,SAAS;AACb,MAAK,IAAI,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK;AACtC,MAAI,OAAO,OAAO,OAAO,UACvB,OAAM,IAAI,MAAM,oCAAoC;AAEtD,MAAI,OAAO,GACT,WAAU,KAAM,IAAI;;AAIxB,QAAO;;AAGT,SAAS,oBAAoB,UAAqB,cAA8B;CAC9E,IAAI,SAAS;AACb,QAAO,SAAS,SAAS,OACvB,KAAI,SAAS,mBAAmB,aAAa;AAC3C,MAAI,SAAS,eAAe,MAAM,KAAK,WAAW,SAAS,SAAS,EAClE,QAAO;AAET;OAEA,QAAO,SAAS;AAGpB,QAAO,SAAS;;AAGlB,SAAS,cAAc,UAAqB,OAAiC;CAC3E,MAAMC,kBAA6B,EAAE;CACrC,MAAMC,kBAAyC,EAAE;CACjD,IAAI,cAAc;CAClB,IAAI,iBAAiB;AAErB,QAAO,iBAAiB,SAAS,QAAQ;EACvC,MAAM,YAAY,SAAS;AAE3B,MAAI,UAAU,WAAW,EAAE;AACzB,OAAI,MAAM,SAAS,cAAc,wBAC/B,OAAM,IAAI,MAAM,wCAAwC;GAG1D,MAAM,eAAgB,MAAM,gBAAgB,IAAK,MAAM,cAAc;AAErE,OAAI,gBAAgB,SAAS,GAAG;IAC9B,MAAM,cAAc,gBAAgB,gBAAgB,SAAS;AAC7D,QAAI,eAAe,YAAY,KAC7B,OAAM,IAAI,MAAM,yEAAyE;AAE3F,gBAAY,QAAQ;;AAGtB,mBAAgB,KAAK;IAAE,MAAM;IAAc,OAAO;IAAG,CAAC;AACtD,mBAAgB,KAAK,KAAK;AAC1B,kBAAe;aAEX,qBAAqB,aAAa;GACpC,MAAM,uBAAuB,oBAAoB,UAAU,eAAe;AAC1E,QAAK,IAAI,IAAI,GAAG,KAAK,uBAAuB,gBAAgB,KAAK;IAC/D,MAAM,WAAW,kBAAkB;AACnC,SAAK,MAAM,eAAe,YAAY,EACpC,iBAAgB,KAAK,IAAI,WAAW,CAAC,eAAe,CAAC,CAAC;QAEtD,iBAAgB,KAAK,IAAI,WAAW,CAAC,gBAAgB,CAAC,CAAC;;AAG3D,oBAAiB;AACjB,kBAAe;SACV;GACL,MAAM,gBAAgB,UAAU,SAAS;AACzC,OAAI,cAAc,gBAAgB,MAAM,OACtC,OAAM,IAAI,MACR,+CAA+C,YAAY,IAAI,cAAc,cAAc,yBAAyB,MAAM,SAC3H;AAEH,mBAAgB,KAAK,MAAM,MAAM,aAAa,cAAc,cAAc,CAAC;AAC3E,kBAAe;;AAInB,MAAI,mBAAmB,SAAS,SAAS,KAAK,eAAe,MAAM,OACjE,OAAM,IAAI,MAAM,mCAAmC;AAErD,oBAAkB;;AAGpB,KAAI,gBAAgB,SAAS,GAAG;EAC9B,MAAM,cAAc,gBAAgB,gBAAgB,SAAS;AAC7D,cAAY,QAAQ,MAAM;YACjB,cAAc,MAAM,OAC7B,OAAM,IAAI,MAAM,iCAAiC;AAGnD,MAAK,IAAI,IAAI,GAAG,IAAI,gBAAgB,QAAQ,KAAK;EAC/C,MAAM,UAAU,gBAAgB;AAChC,MAAI,QAAQ,OAAO,QAAQ,MACzB,OAAM,IAAI,MAAM,4DAA4D;AAE9E,MAAI,MAAM,gBAAgB,SAAS,KAAK,QAAQ,UAAU,gBAAgB,IAAI,GAAG,KAC/E,OAAM,IAAI,MAAM,yCAAyC;;CAI7D,IAAI,eAAe;AACnB,MAAK,IAAI,IAAI,GAAG,IAAI,SAAS,QAAQ,IAEnC,KADkB,SAAS,GACb,WAAW,EAAE;AACzB,kBAAgB,KAAK,MAAM,MAAM,gBAAgB,cAAc,MAAM,gBAAgB,cAAc,MAAM;AACzG,kBAAgB;;CAIpB,MAAMC,SAAuB,EAAE;AAC/B,MAAK,IAAI,IAAI,GAAG,IAAI,gBAAgB,QAAQ,KAAK;EAC/C,MAAM,YAAY,gBAAgB;AAClC,MAAI,cAAc,KAChB,OAAM,IAAI,MAAM,4BAA4B,EAAE,UAAU;AAE1D,SAAO,KAAK,UAAU;;AAGxB,QAAO;;AAGT,SAAgB,kBAAkB,SAA2B;AAC3D,KAAI,YAAY,GACd,QAAO,EAAE;AAGX,KAAI,QAAQ,WAAW,IAAI,CACzB,OAAM,IAAI,MAAM,0CAA0C;AAE5D,KAAI,QAAQ,SAAS,IAAI,CACvB,OAAM,IAAI,MAAM,wCAAwC;AAE1D,KAAI,QAAQ,SAAS,KAAK,CACxB,OAAM,IAAI,MAAM,iDAAiD;CAGnE,MAAMC,eAAyB,EAAE;CACjC,IAAI,QAAQ;CACZ,IAAI,OAAO;AAEX,MAAK,MAAM,MAAM,SAAS;AACxB,UAAQ;AACR,MAAI,OAAO,IACT,UAAS;WACA,OAAO,IAChB,UAAS;WACA,OAAO,OAAO,UAAU,GAAG;AACpC,UAAO,KAAK,MAAM,GAAG,GAAG;AACxB,gBAAa,KAAK,KAAK;AACvB,UAAO;;;AAIX,KAAI,SAAS,GACX,cAAa,KAAK,KAAK;AAGzB,KAAI,UAAU,EACZ,OAAM,IAAI,MAAM,yCAAyC;AAG3D,QAAO"}

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

@@ -1,6 +1,7 @@
 const require_abi_type = require('./abi-type.js');
 //#region packages/abi/src/arc56-contract.ts
+/** ARC-56 spec */
 /** Storage Helper Functions */
 /**
 * Resolves a storage type string (ABI type, AVM type, or struct name) into an ABIType or AVMType

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

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

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

@@ -1,6 +1,7 @@
 import { ABIStructType, ABIType } from "./abi-type.mjs";
 //#region packages/abi/src/arc56-contract.ts
+/** ARC-56 spec */
 /** Storage Helper Functions */
 /**
 * Resolves a storage type string (ABI type, AVM type, or struct name) into an ABIType or AVMType

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

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

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

@@ -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 CHANGED Viewed

@@ -1,9 +1,10 @@
-const require_crypto = require('../../common/src/crypto.js');
 const require_english = require('./english.js');
+const require_crypto = require('../../common/src/crypto.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