# Module @truffle/codec

# Truffle Codec

This module provides low-level decoding and encoding functionality for Solidity and the Solidity ABI. Many parts of this module are intended primarily for internal use by Truffle and so remain largely undocumented, but some of its types are also output by @truffle/decoder, which provides a higher-level interface to much of this module's functionality.

## If you're here from Truffle Decoder or Truffle Encoder

If you're coming here from [[@truffle/decoder]] or [[@truffle/encoder]], you probably just want to know about the parts that are relevant to you. These are:

- The "data" category (specifically [[Format]])
- The "output" and "enumerations" categories ([[CalldataDecoding]], [[LogDecoding]], et al., see below)
- The "errors" category (specifically [[UnknownUserDefinedTypeError]])

Note that the data category is largely scarce in documentation, although that's because it's largely self-explanatory.

If you're not just here from Truffle Decoder or Encoder, but are actually interested in the lower-level workings, read on.

## How this module differs from Truffle Decoder and Encoder

Unlike Truffle Decoder and Encoder, this library makes no network connections and avoids dependencies that do. Instead, its decoding functionality is generator-based; calling one of the decoding functions returns a generator. This generator's `next()` function may return a finished result, or it may return a request for more information. It is up to the caller to fulfill these requests -- say, by making a network connection of its own. This is how @truffle/decoder and @truffle/encoder work; @truffle/codec makes requests, while Decoder and Encoder fulfill them by looking up the necessary information on the blockchain.

This library also provides additional functionality beyond what's used by Truffle Decoder and Encoder. In particular, this library also exists to support Truffle Debugger, and so it provides decoding functionality not just for transactions, logs, and state variables, but also for Solidity variables during transaction execution, including circularity detection for memroy structures. It includes functionality for decoding Solidity's internal function pointers, which the debugger uses, but which Truffle Decoder currently does not (although this is planned for the future).

There is also functionality for decoding return values and revert messages that goes beyond what's currently available in @truffle/decoder; this may get a better interface in the future.

## How to use

You should probably use [[@truffle/decoder]] or [[@truffle/encoder]] instead, if your use case doesn't preclude it. This module has little documentation, where it has any at all, and it's likely that parts of its interface may change (particularly regarding allocation). That said, if you truly need the functionality here, Truffle Decoder and Truffle Encoder can perhaps serve as something of a reference implementation (and perhaps Truffle Debugger as well, though that code is much harder to read or copy).

- Defined in codec/lib/index.ts:1

### Index

### Namespaces - Data

Format

### Namespaces - ABI data location

AbiData
Topic

### Namespaces - Solidity data location

AstConstant
MappingKey
Memory
Special
Stack
Storage

### Namespaces - Other

Ast
Basic
Bytes
Compilations
Compiler
Contexts
Conversion
Evm
Export
Pointer
Wrap

### Classes - Exception

NoProjectInfoError

### Classes - Other

RepeatCompilationIdError
UnknownUserDefinedTypeError

### Interfaces - Output

BlockhashedMulticallInfo
CallInterpretationInfo
DeadlinedMulticallInfo
StateVariable
TryAggregateInfo

### Interfaces - Other

AbiArgument
AccessListForAddress
AddressWrapRequest
AddressWrapResponse
AnonymousDecoding
BytecodeDecoding
CodeRequest
ConstructorDecoding
DecimalWrapRequest
DecimalWrapResponse
EmptyFailureDecoding
EventDecoding
FunctionDecoding
IntegerWrapRequest
IntegerWrapResponse
LogOptions
MessageDecoding
Options
RawReturnDecoding
ReturnDecoding
RevertMessageDecoding
SelfDestructDecoding
StorageRequest
UnknownBytecodeDecoding
UnknownCallDecoding
UnknownCreationDecoding

### Type Aliases - Inputs

BlockSpecifier

### Type Aliases - Other

AccessList
CalldataDecoding
ContractKind
DecoderRequest
DecodingMode
ExtrasAllowed
Location
LogDecoding
Mutability
PaddingMode
PaddingType
ReturndataDecoding
Visibility
WrapRequest
WrapResponse

### Functions - ABIfication

abifyCalldataDecoding
abifyLogDecoding
abifyReturndataDecoding

### Functions - Other

decodeCalldata
decodeEvent
decodeReturndata
decodeRevert
decodeVariable

Generated using TypeDoc