BaseAddress

class cometa.address.base_address.BaseAddress(ptr)[source]

Bases: object

Represents a Cardano base address.

Base addresses contain both a payment credential and a stake credential, making them the most common address type for receiving funds and staking.

The payment credential controls spending, while the stake credential determines where staking rewards are directed.

__init__(ptr)[source]
Return type:

None

__enter__()[source]
Return type:

BaseAddress

__exit__(exc_type, exc_val, exc_tb)[source]
Return type:

None

__repr__()[source]

Return repr(self).

Return type:

str

classmethod from_credentials(network_id, payment, stake)[source]

Creates a base address from payment and stake credentials.

Parameters:
  • network_id (NetworkId) – The network (mainnet or testnet).

  • payment (Credential) – The payment credential controlling spending.

  • stake (Credential) – The stake credential controlling staking rewards.

Returns:

A new BaseAddress instance.

Raises:

CardanoError – If address creation fails.

Return type:

BaseAddress

Example

>>> payment = Credential.from_key_hash("00" * 28)
>>> stake = Credential.from_key_hash("11" * 28)
>>> addr = BaseAddress.from_credentials(NetworkId.MAINNET, payment, stake)
classmethod from_address(address)[source]

Creates a BaseAddress from a generic Address.

Parameters:

address (Address) – A generic Address that must be a base address.

Returns:

A new BaseAddress instance.

Raises:

CardanoError – If the address is not a base address.

Return type:

BaseAddress

classmethod from_bech32(bech32_string)[source]

Creates a BaseAddress from a Bech32-encoded string.

Parameters:

bech32_string (str) – The Bech32-encoded address string.

Returns:

A new BaseAddress instance.

Raises:

CardanoError – If parsing fails.

Return type:

BaseAddress

Example

>>> addr = BaseAddress.from_bech32("addr1...")
classmethod from_bytes(data)[source]

Creates a BaseAddress from raw bytes.

Parameters:

data (bytes | bytearray) – The serialized address bytes.

Returns:

A new BaseAddress instance.

Raises:

CardanoError – If parsing fails.

Return type:

BaseAddress

property payment_credential: Credential

Returns the payment credential.

property stake_credential: Credential

Returns the stake credential.

property network_id: NetworkId

Returns the network ID.

to_address()[source]

Converts this BaseAddress to a generic Address.

Returns:

A generic Address instance.

Return type:

Address

to_bytes()[source]

Returns the serialized byte representation.

Return type:

bytes

to_bech32()[source]

Returns the Bech32-encoded string representation.

Return type:

str

__str__()[source]

Returns the Bech32 string representation.

Return type:

str

__bytes__()[source]

Returns the serialized bytes.

Return type:

bytes

__hash__()[source]

Returns a Python hash for use in sets and dicts.

Return type:

int

__eq__(other)[source]

Checks equality with another BaseAddress.

Parameters:

other (object)

Return type:

bool