Merge branch '2.0' into indexer-delegation-anchor

.github/workflows/bindings-python.yml

@@ -77,7 +77,7 @@ jobs:
       matrix:
         # os: [windows-latest, macos-latest, ubuntu-latest]
         os: [windows-latest, ubuntu-latest]
-        python-version: ["3.10"]
+        python-version: ["3.10", "3.11", "3.12"]
 
     steps:
       - name: Checkout the Source Code

bindings/python/iota_sdk/types/address.py

@@ -16,12 +16,14 @@ class AddressType(IntEnum):
         NFT (16): Nft address.
         IMPLICIT_ACCOUNT_CREATION (24): Implicit Account Creation address.
         RESTRICTED (40): Address with restricted capabilities.
+        ANCHOR (48): Anchor address.
     """
     ED25519 = 0
     ACCOUNT = 8
     NFT = 16
     IMPLICIT_ACCOUNT_CREATION = 24
     RESTRICTED = 40
+    ANCHOR = 48
 
 
 @json
@@ -88,7 +90,8 @@ def from_dict(addr_dict: dict):
         """
         Creates an implicit account creation address from a dictionary representation.
         """
-        return ImplicitAccountCreationAddress(Ed25519Address(addr_dict['pubKeyHash']))
+        return ImplicitAccountCreationAddress(
+            Ed25519Address(addr_dict['pubKeyHash']))
 
 
 @json
@@ -112,6 +115,20 @@ def with_allowed_capabilities(self, capabilities: bytes):
         self.allowed_capabilities = '0x' + capabilities.hex()
 
 
+@json
+@dataclass
+class AnchorAddress:
+    """Represents an Anchor address.
+    Attributes:
+        anchor_id: The hex encoded anchor id.
+    """
+    anchor_id: HexStr
+    type: int = field(
+        default_factory=lambda: int(
+            AddressType.ANCHOR),
+        init=False)
+
+
 @json
 @dataclass
 class AddressWithUnspentOutputs():
@@ -124,7 +141,7 @@ class AddressWithUnspentOutputs():
 
 
 Address: TypeAlias = Union[Ed25519Address, AccountAddress,
-                           NFTAddress, ImplicitAccountCreationAddress, RestrictedAddress]
+                           NFTAddress, ImplicitAccountCreationAddress, RestrictedAddress, AnchorAddress]
 
 
 def deserialize_address(d: Dict[str, Any]) -> Address:
@@ -145,6 +162,8 @@ def deserialize_address(d: Dict[str, Any]) -> Address:
         return ImplicitAccountCreationAddress.from_dict(d)
     if address_type == AddressType.RESTRICTED:
         return RestrictedAddress.from_dict(d)
+    if address_type == AddressType.ANCHOR:
+        return AnchorAddress.from_dict(d)
     raise Exception(f'invalid address type: {address_type}')
 
 

bindings/python/iota_sdk/types/output.py

@@ -10,7 +10,7 @@
 from iota_sdk.types.feature import deserialize_features, SenderFeature, IssuerFeature, MetadataFeature, TagFeature
 from iota_sdk.types.native_token import NativeToken
 from iota_sdk.types.token_scheme import SimpleTokenScheme
-from iota_sdk.types.unlock_condition import deserialize_unlock_conditions, AddressUnlockCondition, StorageDepositReturnUnlockCondition, TimelockUnlockCondition, ExpirationUnlockCondition, ImmutableAccountAddressUnlockCondition
+from iota_sdk.types.unlock_condition import deserialize_unlock_conditions, AddressUnlockCondition, StateControllerAddressUnlockCondition, GovernorAddressUnlockCondition, StorageDepositReturnUnlockCondition, TimelockUnlockCondition, ExpirationUnlockCondition, ImmutableAccountAddressUnlockCondition
 
 
 class OutputType(IntEnum):
@@ -22,12 +22,14 @@ class OutputType(IntEnum):
         Foundry (2): A foundry output.
         Nft (3): An NFT output.
         Delegation (4): A delegation output.
+        Anchor (5): An anchor output.
     """
     Basic = 0
     Account = 1
     Foundry = 2
     Nft = 3
     Delegation = 4
+    Anchor = 5
 
 
 @json
@@ -123,6 +125,63 @@ class AccountOutput:
         init=False)
 
 
+@json
+@dataclass
+class AnchorOutput:
+    """Describes an anchor output.
+    Attributes:
+        amount :
+            The base coin amount of the output.
+        mana :
+            Amount of stored Mana held by this output.
+        anchor_id :
+            The anchor ID if it's an anchor output.
+        state_index :
+            A counter that must increase by 1 every time the anchor is state transitioned.
+        unlock_conditions:
+            The conditions to unlock the output.
+        features :
+            Features that add utility to the output but do not impose unlocking conditions.
+        immutable_features :
+            Features that add utility to the output but do not impose unlocking conditions. These features need to be kept in future transitions of the UTXO state machine.
+        state_metadata :
+            Metadata that can only be changed by the state controller.
+        native_tokens :
+            Native tokens added to the new output.
+        type :
+            The type of output.
+    """
+    amount: int = field(metadata=config(
+        encoder=str
+    ))
+    mana: int = field(metadata=config(
+        encoder=str
+    ))
+    anchor_id: HexStr
+    state_index: int
+    unlock_conditions: List[Union[StateControllerAddressUnlockCondition,
+                                  GovernorAddressUnlockCondition]] = field(
+        metadata=config(
+            decoder=deserialize_unlock_conditions
+        ))
+    features: Optional[List[Union[SenderFeature,
+                            MetadataFeature]]] = field(default=None,
+                                                       metadata=config(
+                                                           decoder=deserialize_features
+                                                       ))
+    immutable_features: Optional[List[Union[IssuerFeature,
+                                            MetadataFeature]]] = field(default=None,
+                                                                       metadata=config(
+                                                                           decoder=deserialize_features
+                                                                       ))
+    state_metadata: Optional[HexStr] = None
+    native_tokens: Optional[List[NativeToken]] = None
+    type: int = field(
+        default_factory=lambda: int(
+            OutputType.Anchor),
+        init=False)
+
+
 @json
 @dataclass
 class FoundryOutput:
@@ -246,7 +305,7 @@ class DelegationOutput:
 
 
 Output: TypeAlias = Union[BasicOutput, AccountOutput,
-                          FoundryOutput, NftOutput, DelegationOutput]
+                          FoundryOutput, NftOutput, DelegationOutput, AnchorOutput]
 
 
 def deserialize_output(d: Dict[str, Any]) -> Output:
@@ -267,6 +326,8 @@ def deserialize_output(d: Dict[str, Any]) -> Output:
         return NftOutput.from_dict(d)
     if output_type == OutputType.Delegation:
         return DelegationOutput.from_dict(d)
+    if output_type == OutputType.Anchor:
+        return AnchorOutput.from_dict(d)
     raise Exception(f'invalid output type: {output_type}')
 
 

bindings/python/iota_sdk/types/unlock.py

@@ -4,7 +4,7 @@
 from __future__ import annotations
 from dataclasses import dataclass, field
 from enum import IntEnum
-from typing import Dict, List, Union, Any
+from typing import Dict, List, TypeAlias, Union, Any
 from iota_sdk.types.signature import Ed25519Signature
 from iota_sdk.types.common import json
 
@@ -17,11 +17,13 @@ class UnlockType(IntEnum):
         Reference (1): An unlock which must reference a previous unlock which unlocks also the input at the same index as this Reference Unlock.
         Account (2): An unlock which must reference a previous unlock which unlocks the account that the input is locked to.
         Nft (3): An unlock which must reference a previous unlock which unlocks the NFT that the input is locked to.
+        Anchor (4): An unlock which must reference a previous unlock which unlocks the anchor that the input is locked to.
     """
     Signature = 0
     Reference = 1
     Account = 2
     Nft = 3
+    Anchor = 4
 
 
 @json
@@ -77,8 +79,23 @@ class NftUnlock:
     type: int = field(default_factory=lambda: int(UnlockType.Nft), init=False)
 
 
-def deserialize_unlock(d: Dict[str, Any]) -> Union[SignatureUnlock,
-                                                   ReferenceUnlock, AccountUnlock, NftUnlock]:
+@json
+@dataclass
+class AnchorUnlock:
+    """An unlock which must reference a previous unlock which unlocks the anchor that the input is locked to.
+    """
+    reference: int
+    type: int = field(
+        default_factory=lambda: int(
+            UnlockType.Anchor),
+        init=False)
+
+
+Unlock: TypeAlias = Union[SignatureUnlock,
+                          ReferenceUnlock, AccountUnlock, NftUnlock, AnchorUnlock]
+
+
+def deserialize_unlock(d: Dict[str, Any]) -> Unlock:
     """
     Takes a dictionary as input and returns an instance of a specific class based on the value of the 'type' key in the dictionary.
 
@@ -94,11 +111,12 @@ def deserialize_unlock(d: Dict[str, Any]) -> Union[SignatureUnlock,
         return AccountUnlock.from_dict(d)
     if unlock_type == UnlockType.Nft:
         return NftUnlock.from_dict(d)
+    if unlock_type == UnlockType.Anchor:
+        return AnchorUnlock.from_dict(d)
     raise Exception(f'invalid unlock type: {unlock_type}')
 
 
-def deserialize_unlocks(dicts: List[Dict[str, Any]]) -> List[Union[SignatureUnlock,
-                                                                   ReferenceUnlock, AccountUnlock, NftUnlock]]:
+def deserialize_unlocks(dicts: List[Dict[str, Any]]) -> List[Unlock]:
     """
     Takes a list of dictionaries as input and returns a list with specific instances of classes based on the value of the 'type' key in the dictionary.
 

bindings/python/tox.ini

@@ -1,13 +1,13 @@
 [tox]
 # can't install from sdist because local pyo3 repo can't be included in the sdist
 skipsdist = true
-envlist = py{39,310,311}
+envlist = py{310,311,312}
 
 [gh-actions]
 python =
-    3.9: py39
     3.10: py310
     3.11: py311
+    3.12: py312
 
 [testenv]
 description = Run the unit tests under {basepython}