Expand description
§Ledger Object Field Retrieval Module (by slot)
Typed accessors for reading fields from a ledger object that has been cached into a slot (via
cache_le). get_field and get_field_optional are generic over
any type implementing crate::fields::decoder::FromLedger — see crate::fields::decoder
for how a type opts into that.
Functions§
- get_
blob_ field - Retrieves a
Blob<N>field from the ledger object cached inslot, writing the host’s bytes directly into the returnedBlob<N>’s own storage. See the comment above this function for whyBlob<N>gets a dedicated accessor instead of usingget_field. - get_
blob_ field_ optional - Optional variant of
get_blob_field: returnsOk(None)if the field is not present, otherwise behaves identically (including the direct-write zero-copy behavior). Implemented in terms ofget_blob_fielditself rather than duplicating its body —Error::FieldNotFoundround-trips exactly throughError::from_code/.code()(both are justFIELD_NOT_FOUND), so translating that one error case intoNoneis all this needs to do. - get_
field - Retrieves a field from the ledger object cached in
slotusing an SField constant. - get_
field_ optional - Retrieves an optionally present field from the ledger object cached in
slot.