# 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 .asset import Asset
from .base import DEFAULT_XDR_MAX_DEPTH
from .claimable_balance_entry_ext import ClaimableBalanceEntryExt
from .claimable_balance_id import ClaimableBalanceID
from .claimant import Claimant
from .int64 import Int64
__all__ = ["ClaimableBalanceEntry"]
[docs]
class ClaimableBalanceEntry:
"""
XDR Source Code::
struct ClaimableBalanceEntry
{
// Unique identifier for this ClaimableBalanceEntry
ClaimableBalanceID balanceID;
// List of claimants with associated predicate
Claimant claimants<10>;
// Any asset including native
Asset asset;
// Amount of asset
int64 amount;
// reserved for future use
union switch (int v)
{
case 0:
void;
case 1:
ClaimableBalanceEntryExtensionV1 v1;
}
ext;
};
"""
def __init__(
self,
balance_id: ClaimableBalanceID,
claimants: list[Claimant],
asset: Asset,
amount: Int64,
ext: ClaimableBalanceEntryExt,
) -> None:
_expect_max_length = 10
if claimants and len(claimants) > _expect_max_length:
raise ValueError(
f"The maximum length of `claimants` should be {_expect_max_length}, but got {len(claimants)}."
)
self.balance_id = balance_id
self.claimants = claimants
self.asset = asset
self.amount = amount
self.ext = ext
def pack(self, packer: Packer) -> None:
self.balance_id.pack(packer)
packer.pack_uint(len(self.claimants))
for claimants_item in self.claimants:
claimants_item.pack(packer)
self.asset.pack(packer)
self.amount.pack(packer)
self.ext.pack(packer)
@classmethod
def unpack(
cls, unpacker: Unpacker, depth_limit: int = DEFAULT_XDR_MAX_DEPTH
) -> ClaimableBalanceEntry:
if depth_limit <= 0:
raise ValueError("Maximum decoding depth reached")
balance_id = ClaimableBalanceID.unpack(unpacker, depth_limit - 1)
length = unpacker.unpack_uint()
_remaining = len(unpacker.get_buffer()) - unpacker.get_position()
if _remaining < length:
raise ValueError(
f"claimants length {length} exceeds remaining input length {_remaining}"
)
claimants = []
for _ in range(length):
claimants.append(Claimant.unpack(unpacker, depth_limit - 1))
asset = Asset.unpack(unpacker, depth_limit - 1)
amount = Int64.unpack(unpacker, depth_limit - 1)
ext = ClaimableBalanceEntryExt.unpack(unpacker, depth_limit - 1)
return cls(
balance_id=balance_id,
claimants=claimants,
asset=asset,
amount=amount,
ext=ext,
)
def to_xdr_bytes(self) -> bytes:
packer = Packer()
self.pack(packer)
return packer.get_buffer()
@classmethod
def from_xdr_bytes(cls, xdr: bytes) -> ClaimableBalanceEntry:
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) -> ClaimableBalanceEntry:
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) -> ClaimableBalanceEntry:
return cls.from_json_dict(json.loads(json_str))
def to_json_dict(self) -> dict:
return {
"balance_id": self.balance_id.to_json_dict(),
"claimants": [item.to_json_dict() for item in self.claimants],
"asset": self.asset.to_json_dict(),
"amount": self.amount.to_json_dict(),
"ext": self.ext.to_json_dict(),
}
@classmethod
def from_json_dict(cls, json_dict: dict) -> ClaimableBalanceEntry:
balance_id = ClaimableBalanceID.from_json_dict(json_dict["balance_id"])
claimants = [Claimant.from_json_dict(item) for item in json_dict["claimants"]]
asset = Asset.from_json_dict(json_dict["asset"])
amount = Int64.from_json_dict(json_dict["amount"])
ext = ClaimableBalanceEntryExt.from_json_dict(json_dict["ext"])
return cls(
balance_id=balance_id,
claimants=claimants,
asset=asset,
amount=amount,
ext=ext,
)
def __hash__(self):
return hash(
(
self.balance_id,
self.claimants,
self.asset,
self.amount,
self.ext,
)
)
def __eq__(self, other: object):
if not isinstance(other, self.__class__):
return NotImplemented
return (
self.balance_id == other.balance_id
and self.claimants == other.claimants
and self.asset == other.asset
and self.amount == other.amount
and self.ext == other.ext
)
def __repr__(self):
out = [
f"balance_id={self.balance_id}",
f"claimants={self.claimants}",
f"asset={self.asset}",
f"amount={self.amount}",
f"ext={self.ext}",
]
return f"<ClaimableBalanceEntry [{', '.join(out)}]>"