applications.abi

Attributes

ABIValue
ABIStruct
Arc56ReturnValueType
ABIType
ABIArgumentType

Classes

ABIReturn	Represents the return value from an ABI method call.
BoxABIValue	Represents an ABI value stored in a box.

Functions

get_arc56_value(→ Arc56ReturnValueType)	Gets the ARC-56 formatted return value from an ABI return.
get_abi_encoded_value(→ bytes)	Encodes a value according to its ABI type.
get_abi_decoded_value(→ ABIValue)	Decodes a value according to its ABI type.
get_abi_tuple_from_abi_struct(→ list[Any])	Converts an ABI struct to a tuple representation.
get_abi_tuple_type_from_abi_struct_definition(…)	Creates a TupleType from a struct definition.
get_abi_struct_from_abi_tuple(→ dict[str, Any])	Converts a decoded tuple to an ABI struct.

Module Contents

type algokit*utils.applications.abi.ABIValue *= bool | int | str | bytes | bytearray | list[‘ABIValue’] | tuple[‘ABIValue’] | dict[str, ‘ABIValue’]_

type algokit*utils.applications.abi.ABIStruct *= dict[str, list[dict[str, ‘ABIValue’]]]_

type algokit*utils.applications.abi.Arc56ReturnValueType *= ABIValue | ABIStruct | None_

type algokit*utils.applications.abi.ABIType *= algosdk.abi.ABIType_

type algokit*utils.applications.abi.ABIArgumentType *= algosdk.abi.ABIType | algosdk.abi.ABITransactionType | algosdk.abi.ABIReferenceType_

class algokit_utils.applications.abi.ABIReturn(result: algosdk.atomic_transaction_composer.ABIResult)

Represents the return value from an ABI method call.

Wraps the raw return value and decoded value along with any decode errors.

raw*value *: bytes | None_ = None

The raw return value from the method call

value : ABIValue | None = None

The decoded return value from the method call

method : algosdk.abi.method.Method | None = None

The ABI method definition

decode*error *: Exception | None_ = None

The exception that occurred during decoding, if any

tx*info *: dict[str, Any] | None_ = None

The transaction info for the method call from raw algosdk ABIResult

property is*success *: bool_

Returns True if the ABI call was successful (no decode error)

• Returns: True if no decode error occurred, False otherwise

get_arc56_value(method: algokit_utils.applications.app_spec.arc56.Method | algosdk.abi.method.Method, structs: dict[str, list[algokit_utils.applications.app_spec.arc56.StructField]]) → Arc56ReturnValueType

Gets the ARC-56 formatted return value.

• Parameters:
  • method – The ABI method definition
  • structs – Dictionary of struct definitions
• Returns: The decoded return value in ARC-56 format

algokit_utils.applications.abi.get_arc56_value(abi_return: ABIReturn, method: algokit_utils.applications.app_spec.arc56.Method | algosdk.abi.method.Method, structs: dict[str, list[algokit_utils.applications.app_spec.arc56.StructField]]) → Arc56ReturnValueType

Gets the ARC-56 formatted return value from an ABI return.

• Parameters:
  • abi_return – The ABI return value to decode
  • method – The ABI method definition
  • structs – Dictionary of struct definitions
• Raises: ValueError – If there was an error decoding the return value
• Returns: The decoded return value in ARC-56 format

algokit_utils.applications.abi.get_abi_encoded_value(value: Any, type_str: str, structs: dict[str, list[algokit_utils.applications.app_spec.arc56.StructField]]) → bytes

Encodes a value according to its ABI type.

• Parameters:
  • value – The value to encode
  • type_str – The ABI type string
  • structs – Dictionary of struct definitions
• Raises: ValueError – If the value cannot be encoded for the given type
• Returns: The ABI encoded bytes

algokit_utils.applications.abi.get_abi_decoded_value(value: bytes | int | str, type_str: str | ABIArgumentType, structs: dict[str, list[algokit_utils.applications.app_spec.arc56.StructField]]) → ABIValue

Decodes a value according to its ABI type.

• Parameters:
  • value – The value to decode
  • type_str – The ABI type string or type object
  • structs – Dictionary of struct definitions
• Returns: The decoded ABI value

algokit_utils.applications.abi.get_abi_tuple_from_abi_struct(struct_value: dict[str, Any], struct_fields: list[algokit_utils.applications.app_spec.arc56.StructField], structs: dict[str, list[algokit_utils.applications.app_spec.arc56.StructField]]) → list[Any]

Converts an ABI struct to a tuple representation.

• Parameters:
  • struct_value – The struct value as a dictionary
  • struct_fields – List of struct field definitions
  • structs – Dictionary of struct definitions
• Raises: ValueError – If a required field is missing from the struct
• Returns: The struct as a tuple

algokit_utils.applications.abi.get_abi_tuple_type_from_abi_struct_definition(struct_def: list[algokit_utils.applications.app_spec.arc56.StructField], structs: dict[str, list[algokit_utils.applications.app_spec.arc56.StructField]]) → algosdk.abi.TupleType

Creates a TupleType from a struct definition.

• Parameters:
  • struct_def – The struct field definitions
  • structs – Dictionary of struct definitions
• Raises: ValueError – If a field type is invalid
• Returns: The TupleType representing the struct

algokit_utils.applications.abi.get_abi_struct_from_abi_tuple(decoded_tuple: Any, struct_fields: list[algokit_utils.applications.app_spec.arc56.StructField], structs: dict[str, list[algokit_utils.applications.app_spec.arc56.StructField]]) → dict[str, Any]

Converts a decoded tuple to an ABI struct.

• Parameters:
  • decoded_tuple – The tuple to convert
  • struct_fields – List of struct field definitions
  • structs – Dictionary of struct definitions
• Returns: The tuple as a struct dictionary

class algokit_utils.applications.abi.BoxABIValue

Represents an ABI value stored in a box.

name : algokit_utils.models.state.BoxName

The name of the box

value : ABIValue

The ABI value stored in the box