public class Utils
extends java.lang.Object
| Modifier and Type | Method and Description |
|---|---|
static java.util.List<TypeReference<Type>> |
convert(java.util.List<TypeReference<?>> input) |
static <T extends Type> |
extractParameterFromAnnotation(java.lang.annotation.Annotation[] parameterAnnotation) |
static java.lang.reflect.Constructor |
findStructConstructor(java.lang.Class classType) |
static TypeReference<DynamicArray> |
getDynamicArrayTypeReference(java.lang.Class parameter) |
static java.lang.String |
getStructType(java.lang.Class type) |
static java.lang.String |
getTypeName(java.lang.reflect.Type type)
Ports
Type.getTypeName(). |
static TypeReference |
getTypeReferenceForParameterizedField(java.lang.Class fieldType,
java.lang.Class elementType)
Builds the element TypeReference for an array-typed struct field declared via
@Parameterized on a constructor parameter. |
static java.util.List<java.lang.reflect.Field> |
staticStructNestedPublicFieldsFlatList(java.lang.Class<Type> classType)
Returns flat list of canonical fields in a static struct.
|
static java.util.List<java.lang.reflect.Field> |
staticStructsNestedFieldsFlatList(java.lang.Class<Type> classType)
Goes over a static structs and enumerates all of its fields and nested structs fields
recursively.
|
static <T,R extends Type<T>,E extends Type<T>> |
typeMap(java.util.List<java.util.List<T>> input,
java.lang.Class<E> outerDestType,
java.lang.Class<R> innerType) |
static <T,R extends Type<T>> |
typeMap(java.util.List<T> input,
java.lang.Class<R> destType) |
static void |
validateTypeReferenceDepth(TypeReference<?> root)
Validates a TypeReference graph before decoding by capping its depth at
MAX_TYPEREF_DEPTH. |
public static java.lang.String getTypeName(java.lang.reflect.Type type)
Type.getTypeName().public static java.lang.String getStructType(java.lang.Class type)
public static TypeReference<DynamicArray> getDynamicArrayTypeReference(java.lang.Class parameter)
public static TypeReference getTypeReferenceForParameterizedField(java.lang.Class fieldType, java.lang.Class elementType) throws java.lang.ClassNotFoundException
@Parameterized on a constructor parameter.
Limitation: this annotation-based constructor-reflection path represents
only one element-type level. Nested array fields (e.g. uint256[2][2] declared
as StaticArray2<StaticArray2<Uint256>>) are therefore not supported by the
current implementation and are rejected explicitly. Nested arrays remain supported
through runtime type references, for example by placing
TypeReference.makeTypeReference("uint256[2][2]") in the innerTypes
list of a runtime struct reference.
java.lang.ClassNotFoundExceptionpublic static <T extends Type> java.lang.Class<T> extractParameterFromAnnotation(java.lang.annotation.Annotation[] parameterAnnotation)
public static java.lang.reflect.Constructor findStructConstructor(java.lang.Class classType)
public static java.util.List<TypeReference<Type>> convert(java.util.List<TypeReference<?>> input)
public static <T,R extends Type<T>,E extends Type<T>> java.util.List<E> typeMap(java.util.List<java.util.List<T>> input, java.lang.Class<E> outerDestType, java.lang.Class<R> innerType)
public static <T,R extends Type<T>> java.util.List<R> typeMap(java.util.List<T> input, java.lang.Class<R> destType) throws TypeMappingException
TypeMappingExceptionpublic static java.util.List<java.lang.reflect.Field> staticStructNestedPublicFieldsFlatList(java.lang.Class<Type> classType)
classType - Static struct typepublic static java.util.List<java.lang.reflect.Field> staticStructsNestedFieldsFlatList(java.lang.Class<Type> classType)
classType - Static struct typepublic static void validateTypeReferenceDepth(TypeReference<?> root)
MAX_TYPEREF_DEPTH. A cycle keeps increasing the depth along the cyclic
path, so cycles are rejected by the same check; shared (diamond) nodes at legal
depths pass. Recursion is bounded by the cap itself, so this method cannot blow
the JVM stack on malicious input.
Called from DefaultFunctionReturnDecoder.build for each output
parameter (direct TypeDecoder entry points are not guarded); bounds
every downstream recursive
traversal of subTypeReference / innerTypes (in TypeDecoder.isDynamic,
Utils.getTypeName, decodeStaticStruct,
decodeDynamicStruct, etc.). All local state, no shared mutable
fields — safe for concurrent invocation on the same TypeReference.