Skip to main content

multiGetDynamicObjectFields

Access dynamic object fields on parent objects using their names and optional version bounds.

Each key can specify at most one of version, rootVersion, or atCheckpoint, with the same semantics as Query.object. Returns a list that is guaranteed to be the same length as keys. If a dynamic object field could not be found, its corresponding entry in the result is null.

multiGetDynamicObjectFields(
  keys: [NameKey!]!
): [DynamicField]!

Arguments​

multiGetDynamicObjectFields.keys ● [NameKey!]! non-null input​

Type​

DynamicField object​

Dynamic fields are heterogeneous fields that can be added to or removed from an object at runtime. Their names are arbitrary Move values that have copy, drop, and store.

There are two kinds of dynamic fields:

  • Dynamic fields can store any value that has store. Objects stored in this kind of field are wrapped and cannot be accessed directly by their ID.
  • Dynamic object fields can store only objects that have key and store. Their values remain accessible directly by their ID while attached.