symbol-sdk-python 3.2.0__tar.gz → 3.2.2__tar.gz

{symbol_sdk_python-3.2.0 → symbol_sdk_python-3.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: symbol-sdk-python
-Version: 3.2.0
+Version: 3.2.2
 Summary: Symbol SDK
 Home-page: https://github.com/symbol/symbol/tree/main/sdk/python
 License: MIT

{symbol_sdk_python-3.2.0 → symbol_sdk_python-3.2.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = 'symbol-sdk-python'
-version = '3.2.0'
+version = '3.2.2'
 description = 'Symbol SDK'
 authors = ['Symbol Contributors <contributors@symbol.dev>']
 maintainers = ['Symbol Contributors <contributors@symbol.dev>']

{symbol_sdk_python-3.2.0 → symbol_sdk_python-3.2.2}/symbolchain/facade/NemFacade.py

@@ -4,11 +4,43 @@ import sha3
 
 from ..CryptoTypes import Hash256, PrivateKey, PublicKey
 from ..nem.KeyPair import KeyPair, Verifier
+from ..nem.MessageEncoder import MessageEncoder
 from ..nem.Network import Address, Network
 from ..nem.SharedKey import SharedKey
 from ..nem.TransactionFactory import TransactionFactory
 from ..Network import NetworkLocator
 
+# region NemPublicAccount / NemAccount
+
+
+class NemPublicAccount:
+	"""NEM public account."""
+
+	def __init__(self, facade, public_key):
+		"""Creates a NEM public account."""
+		self._facade = facade
+		self.public_key = public_key
+		self.address = self._facade.network.public_key_to_address(self.public_key)
+
+
+class NemAccount(NemPublicAccount):
+	"""NEM account."""
+
+	def __init__(self, facade, key_pair):
+		"""Creates a NEM account."""
+		super().__init__(facade, key_pair.public_key)
+		self.key_pair = key_pair
+
+	def message_encoder(self):
+		"""Creates a message encoder that can be used for encrypting and encoding messages between two parties."""
+		return MessageEncoder(self.key_pair)
+
+	def sign_transaction(self, transaction):
+		"""Signs a NEM transaction."""
+		return self._facade.sign_transaction(self.key_pair, transaction)
+
+# endregion
+
 
 class NemFacade:
 	"""Facade used to interact with NEM blockchain."""
@@ -46,6 +78,14 @@ class NemFacade:
 		"""Creates a network timestamp representing the current time."""
 		return self.network.from_datetime(datetime.now(timezone.utc))
 
+	def create_public_account(self, public_key):
+		"""Creates a NEM public account from a public key."""
+		return NemPublicAccount(self, public_key)
+
+	def create_account(self, private_key):
+		"""Creates a NEM account from a private key."""
+		return NemAccount(self, KeyPair(private_key))
+
 	@staticmethod
 	def hash_transaction(transaction):
 		"""Hashes a NEM transaction."""

{symbol_sdk_python-3.2.0 → symbol_sdk_python-3.2.2}/symbolchain/facade/SymbolFacade.py

@@ -6,6 +6,7 @@ from ..CryptoTypes import Hash256, PublicKey, Signature
 from ..Network import NetworkLocator
 from ..symbol.KeyPair import KeyPair, Verifier
 from ..symbol.Merkle import MerkleHashBuilder
+from ..symbol.MessageEncoder import MessageEncoder
 from ..symbol.Network import Address, Network
 from ..symbol.SharedKey import SharedKey
 from ..symbol.TransactionFactory import TransactionFactory
@@ -26,6 +27,41 @@ AGGREGATE_HASHED_SIZE = sum(field[1] for field in [
 ])
 
 
+# region SymbolPublicAccount / SymbolAccount
+
+class SymbolPublicAccount:
+	"""Symbol public account."""
+
+	def __init__(self, facade, public_key):
+		"""Creates a Symbol public account."""
+		self._facade = facade
+		self.public_key = public_key
+		self.address = self._facade.network.public_key_to_address(self.public_key)
+
+
+class SymbolAccount(SymbolPublicAccount):
+	"""Symbol account."""
+
+	def __init__(self, facade, key_pair):
+		"""Creates a Symbol account."""
+		super().__init__(facade, key_pair.public_key)
+		self.key_pair = key_pair
+
+	def message_encoder(self):
+		"""Creates a message encoder that can be used for encrypting and encoding messages between two parties."""
+		return MessageEncoder(self.key_pair)
+
+	def sign_transaction(self, transaction):
+		"""Signs a Symbol transaction."""
+		return self._facade.sign_transaction(self.key_pair, transaction)
+
+	def cosign_transaction(self, transaction, detached=False):
+		"""Cosigns a Symbol transaction."""
+		return self._facade.cosign_transaction(self.key_pair, transaction, detached)
+
+# endregion
+
+
 class SymbolFacade:
 	"""Facade used to interact with Symbol blockchain."""
 
@@ -63,6 +99,14 @@ class SymbolFacade:
 		"""Creates a network timestamp representing the current time."""
 		return self.network.from_datetime(datetime.now(timezone.utc))
 
+	def create_public_account(self, public_key):
+		"""Creates a Symbol public account from a public key."""
+		return SymbolPublicAccount(self, public_key)
+
+	def create_account(self, private_key):
+		"""Creates a Symbol account from a private key."""
+		return SymbolAccount(self, KeyPair(private_key))
+
 	def hash_transaction(self, transaction):
 		"""Hashes a Symbol transaction."""
 		hasher = hashlib.sha3_256()

{symbol_sdk_python-3.2.0 → symbol_sdk_python-3.2.2}/symbolchain/nem/MessageEncoder.py

@@ -17,6 +17,12 @@ class MessageEncoder:
 
 		self.key_pair = key_pair
 
+	@property
+	def public_key(self):
+		"""Public key used for message encoding."""
+
+		return self.key_pair.public_key
+
 	def try_decode(self, recipient_public_key, encoded_message: Message):
 		"""Tries to decode encoded message, returns tuple:
 		* True, message - if message has been decoded and decrypted

{symbol_sdk_python-3.2.0 → symbol_sdk_python-3.2.2}/symbolchain/nem/TransactionFactory.py

@@ -39,6 +39,11 @@ class TransactionFactory:
 
 		return transaction
 
+	@staticmethod
+	def deserialize(payload):
+		"""Deserializes a transaction from a binary payload."""
+		return nc.TransactionFactory.deserialize(payload)
+
 	@staticmethod
 	def to_non_verifiable_transaction(transaction):
 		"""Converts a transaction to a non-verifiable transaction."""

{symbol_sdk_python-3.2.0 → symbol_sdk_python-3.2.2}/symbolchain/ripemd160.py

@@ -5,6 +5,7 @@ if 'ripemd160' not in hashlib.algorithms_guaranteed:
 
 
 def _factory():
+	# pylint: disable=possibly-used-before-assignment
 	return hashlib.new('ripemd160') if 'ripemd160' in hashlib.algorithms_guaranteed else ripemd160_impl.new()
 
 

{symbol_sdk_python-3.2.0 → symbol_sdk_python-3.2.2}/symbolchain/symbol/MessageEncoder.py

@@ -20,6 +20,12 @@ class MessageEncoder:
 
 		self.key_pair = key_pair
 
+	@property
+	def public_key(self):
+		"""Public key used for message encoding."""
+
+		return self.key_pair.public_key
+
 	def try_decode(self, recipient_public_key, encoded_message):
 		"""Tries to decode encoded message, returns tuple:
 		* True, message - if message has been decoded and decrypted

{symbol_sdk_python-3.2.0 → symbol_sdk_python-3.2.2}/symbolchain/symbol/Metadata.py

@@ -1,3 +1,17 @@
+import hashlib
+
+
+def metadata_generate_key(seed):
+	"""Generates a metadata key from a string."""
+
+	hash_result = hashlib.sha3_256(seed.encode('utf8')).digest()
+
+	key_bytes = bytearray(hash_result[:8])
+	key_bytes[7] |= 0x80  # set high bit to match SDK V2 implementation
+
+	return int.from_bytes(key_bytes, 'little')
+
+
 def metadata_update_value(old_value, new_value):
 	"""Creates a metadata payload for updating old value to new value."""
 

{symbol_sdk_python-3.2.0 → symbol_sdk_python-3.2.2}/symbolchain/symbol/Network.py

@@ -1,12 +1,14 @@
 import base64
 import datetime
 import hashlib
+from binascii import unhexlify
 
 from ..ByteArray import ByteArray
 from ..CryptoTypes import Hash256
 from ..Network import Network as BasicNetwork
 from ..NetworkTimestamp import NetworkTimestamp as BasicNetworkTimestamp
 from ..NetworkTimestamp import NetworkTimestampDatetimeConverter
+from ..sc import NamespaceId
 
 
 class NetworkTimestamp(BasicNetworkTimestamp):
@@ -36,12 +38,32 @@ class Address(ByteArray):
 
 		super().__init__(self.SIZE, raw_bytes, Address)
 
+	def to_namespace_id(self):
+		"""Attempts to convert this address into a namespace id."""
+
+		if not self.bytes[0] & 0x01:
+			return None
+
+		return NamespaceId(int.from_bytes(self.bytes[1:9], 'little'))
+
 	def __str__(self):
 		return base64.b32encode(self.bytes + bytes(0)).decode('utf8')[0:-1]
 
 	def __repr__(self):
 		return f'Address(\'{str(self)}\')'
 
+	@staticmethod
+	def from_decoded_address_hex_string(hex_string):
+		"""Creates an address from a decoded address hex string (typically from REST)."""
+
+		return Address(unhexlify(hex_string))
+
+	@staticmethod
+	def from_namespace_id(namespace_id, network_identifier):
+		"""Creates an address from a namespace id."""
+
+		return Address(bytes([network_identifier + 1]) + namespace_id.value.to_bytes(8, 'little') + bytes([0] * (Address.SIZE - 9)))
+
 
 class Network(BasicNetwork):
 	"""Represents a Symbol network."""

{symbol_sdk_python-3.2.0 → symbol_sdk_python-3.2.2}/symbolchain/symbol/TransactionFactory.py

@@ -55,6 +55,16 @@ class TransactionFactory:
 		"""
 		return self._create_and_extend(transaction_descriptor, autosort, sc.EmbeddedTransactionFactory)
 
+	@staticmethod
+	def deserialize(payload):
+		"""Deserializes a transaction from a binary payload."""
+		return sc.TransactionFactory.deserialize(payload)
+
+	@staticmethod
+	def deserialize_embedded(payload):
+		"""Deserializes an embedded transaction from a binary payload."""
+		return sc.EmbeddedTransactionFactory.deserialize(payload)
+
 	@staticmethod
 	def attach_signature(transaction, signature):
 		"""Attaches a signature to a transaction."""