Source code for stellar_sdk.xdr.transaction_meta_v4
# This is an automatically generated file.
# DO NOT EDIT or your changes may be overwritten
from __future__ import annotations
import base64
import json
from xdrlib3 import Packer, Unpacker
from .base import DEFAULT_XDR_MAX_DEPTH
from .diagnostic_event import DiagnosticEvent
from .extension_point import ExtensionPoint
from .ledger_entry_changes import LedgerEntryChanges
from .operation_meta_v2 import OperationMetaV2
from .soroban_transaction_meta_v2 import SorobanTransactionMetaV2
from .transaction_event import TransactionEvent
__all__ = ["TransactionMetaV4"]
[docs]
class TransactionMetaV4:
"""
XDR Source Code::
struct TransactionMetaV4
{
ExtensionPoint ext;
LedgerEntryChanges txChangesBefore; // tx level changes before operations
// are applied if any
OperationMetaV2 operations<>; // meta for each operation
LedgerEntryChanges txChangesAfter; // tx level changes after operations are
// applied if any
SorobanTransactionMetaV2* sorobanMeta; // Soroban-specific meta (only for
// Soroban transactions).
TransactionEvent events<>; // Used for transaction-level events (like fee payment)
DiagnosticEvent diagnosticEvents<>; // Used for all diagnostic information
};
"""
def __init__(
self,
ext: ExtensionPoint,
tx_changes_before: LedgerEntryChanges,
operations: list[OperationMetaV2],
tx_changes_after: LedgerEntryChanges,
soroban_meta: SorobanTransactionMetaV2 | None,
events: list[TransactionEvent],
diagnostic_events: list[DiagnosticEvent],
) -> None:
_expect_max_length = 4294967295
if operations and len(operations) > _expect_max_length:
raise ValueError(
f"The maximum length of `operations` should be {_expect_max_length}, but got {len(operations)}."
)
_expect_max_length = 4294967295
if events and len(events) > _expect_max_length:
raise ValueError(
f"The maximum length of `events` should be {_expect_max_length}, but got {len(events)}."
)
_expect_max_length = 4294967295
if diagnostic_events and len(diagnostic_events) > _expect_max_length:
raise ValueError(
f"The maximum length of `diagnostic_events` should be {_expect_max_length}, but got {len(diagnostic_events)}."
)
self.ext = ext
self.tx_changes_before = tx_changes_before
self.operations = operations
self.tx_changes_after = tx_changes_after
self.soroban_meta = soroban_meta
self.events = events
self.diagnostic_events = diagnostic_events
def pack(self, packer: Packer) -> None:
self.ext.pack(packer)
self.tx_changes_before.pack(packer)
packer.pack_uint(len(self.operations))
for operations_item in self.operations:
operations_item.pack(packer)
self.tx_changes_after.pack(packer)
if self.soroban_meta is None:
packer.pack_uint(0)
else:
packer.pack_uint(1)
self.soroban_meta.pack(packer)
packer.pack_uint(len(self.events))
for events_item in self.events:
events_item.pack(packer)
packer.pack_uint(len(self.diagnostic_events))
for diagnostic_events_item in self.diagnostic_events:
diagnostic_events_item.pack(packer)
@classmethod
def unpack(
cls, unpacker: Unpacker, depth_limit: int = DEFAULT_XDR_MAX_DEPTH
) -> TransactionMetaV4:
if depth_limit <= 0:
raise ValueError("Maximum decoding depth reached")
ext = ExtensionPoint.unpack(unpacker, depth_limit - 1)
tx_changes_before = LedgerEntryChanges.unpack(unpacker, depth_limit - 1)
length = unpacker.unpack_uint()
_remaining = len(unpacker.get_buffer()) - unpacker.get_position()
if _remaining < length:
raise ValueError(
f"operations length {length} exceeds remaining input length {_remaining}"
)
operations = []
for _ in range(length):
operations.append(OperationMetaV2.unpack(unpacker, depth_limit - 1))
tx_changes_after = LedgerEntryChanges.unpack(unpacker, depth_limit - 1)
soroban_meta = (
SorobanTransactionMetaV2.unpack(unpacker, depth_limit - 1)
if unpacker.unpack_uint()
else None
)
length = unpacker.unpack_uint()
_remaining = len(unpacker.get_buffer()) - unpacker.get_position()
if _remaining < length:
raise ValueError(
f"events length {length} exceeds remaining input length {_remaining}"
)
events = []
for _ in range(length):
events.append(TransactionEvent.unpack(unpacker, depth_limit - 1))
length = unpacker.unpack_uint()
_remaining = len(unpacker.get_buffer()) - unpacker.get_position()
if _remaining < length:
raise ValueError(
f"diagnostic_events length {length} exceeds remaining input length {_remaining}"
)
diagnostic_events = []
for _ in range(length):
diagnostic_events.append(DiagnosticEvent.unpack(unpacker, depth_limit - 1))
return cls(
ext=ext,
tx_changes_before=tx_changes_before,
operations=operations,
tx_changes_after=tx_changes_after,
soroban_meta=soroban_meta,
events=events,
diagnostic_events=diagnostic_events,
)
def to_xdr_bytes(self) -> bytes:
packer = Packer()
self.pack(packer)
return packer.get_buffer()
@classmethod
def from_xdr_bytes(cls, xdr: bytes) -> TransactionMetaV4:
unpacker = Unpacker(xdr)
result = cls.unpack(unpacker)
remaining = len(xdr) - unpacker.get_position()
if remaining != 0:
raise ValueError(f"Unexpected trailing {remaining} bytes in XDR data")
return result
def to_xdr(self) -> str:
xdr_bytes = self.to_xdr_bytes()
return base64.b64encode(xdr_bytes).decode()
@classmethod
def from_xdr(cls, xdr: str) -> TransactionMetaV4:
xdr_bytes = base64.b64decode(xdr.encode())
return cls.from_xdr_bytes(xdr_bytes)
def to_json(self) -> str:
return json.dumps(self.to_json_dict())
@classmethod
def from_json(cls, json_str: str) -> TransactionMetaV4:
return cls.from_json_dict(json.loads(json_str))
def to_json_dict(self) -> dict:
return {
"ext": self.ext.to_json_dict(),
"tx_changes_before": self.tx_changes_before.to_json_dict(),
"operations": [item.to_json_dict() for item in self.operations],
"tx_changes_after": self.tx_changes_after.to_json_dict(),
"soroban_meta": self.soroban_meta.to_json_dict()
if self.soroban_meta is not None
else None,
"events": [item.to_json_dict() for item in self.events],
"diagnostic_events": [
item.to_json_dict() for item in self.diagnostic_events
],
}
@classmethod
def from_json_dict(cls, json_dict: dict) -> TransactionMetaV4:
ext = ExtensionPoint.from_json_dict(json_dict["ext"])
tx_changes_before = LedgerEntryChanges.from_json_dict(
json_dict["tx_changes_before"]
)
operations = [
OperationMetaV2.from_json_dict(item) for item in json_dict["operations"]
]
tx_changes_after = LedgerEntryChanges.from_json_dict(
json_dict["tx_changes_after"]
)
soroban_meta = (
SorobanTransactionMetaV2.from_json_dict(json_dict["soroban_meta"])
if json_dict["soroban_meta"] is not None
else None
)
events = [TransactionEvent.from_json_dict(item) for item in json_dict["events"]]
diagnostic_events = [
DiagnosticEvent.from_json_dict(item)
for item in json_dict["diagnostic_events"]
]
return cls(
ext=ext,
tx_changes_before=tx_changes_before,
operations=operations,
tx_changes_after=tx_changes_after,
soroban_meta=soroban_meta,
events=events,
diagnostic_events=diagnostic_events,
)
def __hash__(self):
return hash(
(
self.ext,
self.tx_changes_before,
self.operations,
self.tx_changes_after,
self.soroban_meta,
self.events,
self.diagnostic_events,
)
)
def __eq__(self, other: object):
if not isinstance(other, self.__class__):
return NotImplemented
return (
self.ext == other.ext
and self.tx_changes_before == other.tx_changes_before
and self.operations == other.operations
and self.tx_changes_after == other.tx_changes_after
and self.soroban_meta == other.soroban_meta
and self.events == other.events
and self.diagnostic_events == other.diagnostic_events
)
def __repr__(self):
out = [
f"ext={self.ext}",
f"tx_changes_before={self.tx_changes_before}",
f"operations={self.operations}",
f"tx_changes_after={self.tx_changes_after}",
f"soroban_meta={self.soroban_meta}",
f"events={self.events}",
f"diagnostic_events={self.diagnostic_events}",
]
return f"<TransactionMetaV4 [{', '.join(out)}]>"