Merge branch '2.0' into feat/dyn-secret-manager

.github/workflows/bindings-python-publish.yml

@@ -11,7 +11,7 @@ jobs:
     strategy:
       matrix:
         os: [macos-latest, ubuntu-latest, windows-latest]
-        python-version: ["3.8", "3.9", "3.10", "3.11"]
+        python-version: ["3.10", "3.11"]
 
     steps:
       - uses: actions/checkout@v3
@@ -105,11 +105,7 @@ jobs:
       matrix:
         os: [ubuntu-latest]
         docker-container:
-          [
-            "python:3.9.12-slim-bullseye",
-            "python:3.10.10-slim-bullseye",
-            "python:3.11.1-slim-bullseye",
-          ]
+          ["python:3.10.10-slim-bullseye", "python:3.11.1-slim-bullseye"]
 
     steps:
       - name: Checkout

.github/workflows/bindings-python.yml

@@ -45,7 +45,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.9"]
+        python-version: ["3.10"]
 
     steps:
       - name: Checkout the Source Code
@@ -67,7 +67,6 @@ jobs:
         working-directory: bindings/python
         run: tox -e format
 
-
   test:
     name: Linter & Tests
     needs: lint
@@ -78,7 +77,7 @@ jobs:
       matrix:
         # os: [windows-latest, macos-latest, ubuntu-latest]
         os: [windows-latest, ubuntu-latest]
-        python-version: ["3.9"]
+        python-version: ["3.10"]
 
     steps:
       - name: Checkout the Source Code
@@ -125,4 +124,4 @@ jobs:
       # TODO temporarily disabled https://github.com/iotaledger/iota-sdk/issues/647
       # - name: Run tests
       #   working-directory: bindings/python
-      #   run: tox
+      #   run: tox

bindings/python/README.md

@@ -17,7 +17,7 @@ Python binding to the [iota-sdk library](/README.md).
 
 ## Requirements
 
-- [Python 3.9+](https://www.python.org)
+- [Python 3.10+](https://www.python.org)
 - [pip ^21.x](https://pypi.org/project/pip)
 - `Rust` and `Cargo` to compile the binding. Install
   them [here](https://doc.rust-lang.org/cargo/getting-started/installation.html).

bindings/python/iota_sdk/__init__.py

@@ -30,6 +30,7 @@
 from .types.output import *
 from .types.output_data import *
 from .types.output_id import *
+from .types.output_metadata import *
 from .types.output_params import *
 from .types.payload import *
 from .types.send_params import *

bindings/python/iota_sdk/client/_high_level_api.py

@@ -6,7 +6,7 @@
 from abc import ABCMeta, abstractmethod
 from iota_sdk.types.block import Block
 from iota_sdk.types.common import CoinType, HexStr, json
-from iota_sdk.types.output import OutputWithMetadata
+from iota_sdk.types.output_metadata import OutputWithMetadata
 from iota_sdk.types.output_id import OutputId
 
 

bindings/python/iota_sdk/client/_node_core_api.py

@@ -1,14 +1,14 @@
 # Copyright 2023 IOTA Stiftung
 # SPDX-License-Identifier: Apache-2.0
 
-from typing import List, Union
+from typing import List, Optional, Union
 from abc import ABCMeta, abstractmethod
 from dacite import from_dict
 
 from iota_sdk.types.block import Block, BlockMetadata
 from iota_sdk.types.common import HexStr
 from iota_sdk.types.node_info import NodeInfo, NodeInfoWrapper
-from iota_sdk.types.output import OutputWithMetadata, OutputMetadata
+from iota_sdk.types.output_metadata import OutputWithMetadata, OutputMetadata
 from iota_sdk.types.output_id import OutputId
 
 
@@ -149,7 +149,7 @@ def get_included_block_metadata(
         }))
 
     def call_plugin_route(self, base_plugin_path: str, method: str,
-                          endpoint: str, query_params: [str] = None, request: str = None):
+                          endpoint: str, query_params: Optional[List[str]] = None, request: Optional[str] = None):
         """Extension method which provides request methods for plugins.
 
         Args:

bindings/python/iota_sdk/client/client.py

@@ -18,7 +18,7 @@
 from iota_sdk.types.feature import Feature
 from iota_sdk.types.native_token import NativeToken
 from iota_sdk.types.network_info import NetworkInfo
-from iota_sdk.types.output import AccountOutput, BasicOutput, FoundryOutput, NftOutput, output_from_dict
+from iota_sdk.types.output import AccountOutput, BasicOutput, FoundryOutput, NftOutput, deserialize_output
 from iota_sdk.types.payload import Payload, TransactionPayload
 from iota_sdk.types.token_scheme import SimpleTokenScheme
 from iota_sdk.types.unlock_condition import UnlockCondition
@@ -197,7 +197,7 @@ def build_account_output(self,
         if mana:
             mana = str(mana)
 
-        return output_from_dict(self._call_method('buildAccountOutput', {
+        return deserialize_output(self._call_method('buildAccountOutput', {
             'accountId': account_id,
             'unlockConditions': unlock_conditions,
             'amount': amount,
@@ -245,7 +245,7 @@ def build_basic_output(self,
         if mana:
             mana = str(mana)
 
-        return output_from_dict(self._call_method('buildBasicOutput', {
+        return deserialize_output(self._call_method('buildBasicOutput', {
             'unlockConditions': unlock_conditions,
             'amount': amount,
             'mana': mana,
@@ -292,7 +292,7 @@ def build_foundry_output(self,
         if amount:
             amount = str(amount)
 
-        return output_from_dict(self._call_method('buildFoundryOutput', {
+        return deserialize_output(self._call_method('buildFoundryOutput', {
             'serialNumber': serial_number,
             'tokenScheme': token_scheme.to_dict(),
             'unlockConditions': unlock_conditions,
@@ -344,7 +344,7 @@ def build_nft_output(self,
         if mana:
             mana = str(mana)
 
-        return output_from_dict(self._call_method('buildNftOutput', {
+        return deserialize_output(self._call_method('buildNftOutput', {
             'nftId': nft_id,
             'unlockConditions': unlock_conditions,
             'amount': amount,

bindings/python/iota_sdk/types/address.py

@@ -2,10 +2,8 @@
 # SPDX-License-Identifier: Apache-2.0
 
 from enum import IntEnum
-
 from dataclasses import dataclass, field
-
-
+from typing import Any, Dict, List, TypeAlias, Union
 from iota_sdk.types.common import HexStr, json
 
 
@@ -69,19 +67,6 @@ class NFTAddress(Address):
     type: int = field(default_factory=lambda: int(AddressType.NFT), init=False)
 
 
-@json
-@dataclass
-# pylint: disable=function-redefined
-# TODO: Change name
-class AccountAddress():
-    """An Address of the Account.
-    """
-    address: str
-    key_index: int
-    internal: bool
-    used: bool
-
-
 @json
 @dataclass
 class AddressWithUnspentOutputs():
@@ -91,3 +76,34 @@ class AddressWithUnspentOutputs():
     key_index: int
     internal: bool
     output_ids: bool
+
+
+AddressUnion: TypeAlias = Union[Ed25519Address, AccountAddress, NFTAddress]
+
+
+def deserialize_address(d: Dict[str, Any]) -> AddressUnion:
+    """
+    Takes a dictionary as input and returns an instance of a specific class based on the value of the 'type' key in the dictionary.
+
+    Arguments:
+    * `d`: A dictionary that is expected to have a key called 'type' which specifies the type of the returned value.
+    """
+    address_type = d['type']
+    if address_type == AddressType.ED25519:
+        return Ed25519Address.from_dict(d)
+    if address_type == AddressType.ACCOUNT:
+        return AccountAddress.from_dict(d)
+    if address_type == AddressType.NFT:
+        return NFTAddress.from_dict(d)
+    raise Exception(f'invalid address type: {address_type}')
+
+
+def deserialize_addresses(
+        dicts: List[Dict[str, Any]]) -> List[AddressUnion]:
+    """
+    Takes a list of dictionaries as input and returns a list with specific instances of a classes based on the value of the 'type' key in the dictionary.
+
+    Arguments:
+    * `dicts`: A list of dictionaries that are expected to have a key called 'type' which specifies the type of the returned value.
+    """
+    return list(map(deserialize_address, dicts))

bindings/python/iota_sdk/types/context_input.py

@@ -4,6 +4,7 @@
 from __future__ import annotations
 from dataclasses import dataclass, field
 from enum import IntEnum
+from typing import Any, Dict, List, TypeAlias, Union
 from iota_sdk.types.common import HexStr, json
 
 
@@ -70,3 +71,35 @@ class RewardContextInput(ContextInput):
         default_factory=lambda: int(
             ContextInputType.Reward),
         init=False)
+
+
+ContextInputUnion: TypeAlias = Union[CommitmentContextInput,
+                                     BlockIssuanceCreditContextInput, RewardContextInput]
+
+
+def deserialize_context_input(d: Dict[str, Any]) -> ContextInputUnion:
+    """
+    Takes a dictionary as input and returns an instance of a specific class based on the value of the 'type' key in the dictionary.
+
+    Arguments:
+    * `d`: A dictionary that is expected to have a key called 'type' which specifies the type of the returned value.
+    """
+    context_input_type = dict['type']
+    if context_input_type == ContextInputType.Commitment:
+        return CommitmentContextInput.from_dict(d)
+    if context_input_type == ContextInputType.BlockIssuanceCredit:
+        return BlockIssuanceCreditContextInput.from_dict(d)
+    if context_input_type == ContextInputType.Reward:
+        return RewardContextInput.from_dict(d)
+    raise Exception(f'invalid context input type: {context_input_type}')
+
+
+def deserialize_context_inputs(
+        dicts: List[Dict[str, Any]]) -> List[ContextInputUnion]:
+    """
+    Takes a list of dictionaries as input and returns a list with specific instances of a classes based on the value of the 'type' key in the dictionary.
+
+    Arguments:
+    * `dicts`: A list of dictionaries that are expected to have a key called 'type' which specifies the type of the returned value.
+    """
+    return list(map(deserialize_context_input, dicts))

bindings/python/iota_sdk/types/essence.py

@@ -3,17 +3,15 @@
 
 from __future__ import annotations
 from enum import IntEnum
-from typing import TYPE_CHECKING, Optional, List, Union
+from typing import TYPE_CHECKING, Optional, List
 
 from dataclasses import dataclass, field
 
 from iota_sdk.types.common import HexStr, json, SlotIndex
 from iota_sdk.types.mana import ManaAllotment
-# TODO: Add missing output types in #1174
-# pylint: disable=no-name-in-module
-from iota_sdk.types.output import BasicOutput, AccountOutput, FoundryOutput, NftOutput, DelegationOutput
 from iota_sdk.types.input import UtxoInput
-from iota_sdk.types.context_input import CommitmentContextInput, BlockIssuanceCreditContextInput, RewardContextInput
+from iota_sdk.types.context_input import ContextInputUnion
+from iota_sdk.types.output import OutputUnion
 
 # Required to prevent circular import
 if TYPE_CHECKING:
@@ -57,10 +55,8 @@ class RegularTransactionEssence(TransactionEssence):
     creation_slot: SlotIndex
     inputs: List[UtxoInput]
     inputs_commitment: HexStr
-    outputs: List[Union[BasicOutput, AccountOutput,
-                        FoundryOutput, NftOutput, DelegationOutput]]
-    context_inputs: Optional[List[Union[CommitmentContextInput,
-                                        BlockIssuanceCreditContextInput, RewardContextInput]]] = None
+    outputs: List[OutputUnion]
+    context_inputs: Optional[List[ContextInputUnion]] = None
     allotments: Optional[List[ManaAllotment]] = None
     payload: Optional[Payload] = None
     type: int = field(

bindings/python/iota_sdk/types/feature.py

@@ -2,10 +2,10 @@
 # SPDX-License-Identifier: Apache-2.0
 
 from enum import IntEnum
-from typing import List, Union
+from typing import Dict, List, TypeAlias, Union, Any
 from dataclasses import dataclass, field
-
-from iota_sdk.types.address import Ed25519Address, AccountAddress, NFTAddress
+from dataclasses_json import config
+from iota_sdk.types.address import AddressUnion, deserialize_address
 from iota_sdk.types.common import EpochIndex, HexStr, json, SlotIndex
 
 
@@ -43,7 +43,10 @@ class SenderFeature(Feature):
     Attributes:
         address: A given sender address.
     """
-    address: Union[Ed25519Address, AccountAddress, NFTAddress]
+    address: AddressUnion = field(
+        metadata=config(
+            decoder=deserialize_address
+        ))
     type: int = field(
         default_factory=lambda: int(
             FeatureType.Sender),
@@ -57,7 +60,10 @@ class IssuerFeature(Feature):
     Attributes:
         address: A given issuer address.
     """
-    address: Union[Ed25519Address, AccountAddress, NFTAddress]
+    address: AddressUnion = field(
+        metadata=config(
+            decoder=deserialize_address
+        ))
     type: int = field(
         default_factory=lambda: int(
             FeatureType.Issuer),
@@ -91,7 +97,7 @@ class TagFeature(Feature):
 
 @json
 @dataclass
-class BlockIssuer(Feature):
+class BlockIssuerFeature(Feature):
     """Contains the public keys to verify block signatures and allows for unbonding the issuer deposit.
     Attributes:
         expiry_slot: The slot index at which the Block Issuer Feature expires and can be removed.
@@ -124,3 +130,40 @@ class StakingFeature(Feature):
         default_factory=lambda: int(
             FeatureType.Staking),
         init=False)
+
+
+FeatureUnion: TypeAlias = Union[SenderFeature, IssuerFeature,
+                                MetadataFeature, TagFeature, BlockIssuerFeature, StakingFeature]
+
+
+def deserialize_feature(d: Dict[str, Any]) -> FeatureUnion:
+    """
+    Takes a dictionary as input and returns an instance of a specific class based on the value of the 'type' key in the dictionary.
+
+    Arguments:
+    * `d`: A dictionary that is expected to have a key called 'type' which specifies the type of the returned value.
+    """
+    feature_type = d['type']
+    if feature_type == FeatureType.Sender:
+        return SenderFeature.from_dict(d)
+    if feature_type == FeatureType.Issuer:
+        return IssuerFeature.from_dict(d)
+    if feature_type == FeatureType.Metadata:
+        return MetadataFeature.from_dict(d)
+    if feature_type == FeatureType.Tag:
+        return TagFeature.from_dict(d)
+    if feature_type == FeatureType.BlockIssuer:
+        return BlockIssuerFeature.from_dict(d)
+    if feature_type == FeatureType.Staking:
+        return StakingFeature.from_dict(d)
+    raise Exception(f'invalid feature type: {feature_type}')
+
+
+def deserialize_features(dicts: List[Dict[str, Any]]) -> List[FeatureUnion]:
+    """
+    Takes a list of dictionaries as input and returns a list with specific instances of a classes based on the value of the 'type' key in the dictionary.
+
+    Arguments:
+    * `dicts`: A list of dictionaries that are expected to have a key called 'type' which specifies the type of the returned value.
+    """
+    return list(map(deserialize_feature, dicts))