symbol-sdk-python 3.2.2__py3-none-any.whl → 3.3.0__py3-none-any.whl

{symbol_sdk_python-3.2.2.dist-info → symbol_sdk_python-3.3.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: symbol-sdk-python
-Version: 3.2.2
+Version: 3.3.0
 Summary: Symbol SDK
 Home-page: https://github.com/symbol/symbol/tree/main/sdk/python
 License: MIT
@@ -9,19 +9,21 @@ Author: Symbol Contributors
 Author-email: contributors@symbol.dev
 Maintainer: Symbol Contributors
 Maintainer-email: contributors@symbol.dev
-Requires-Python: >=3.9,<4.0
+Requires-Python: >=3.9.2,<4.0.0
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
-Requires-Dist: cryptography (>=42.0.2,<42.1.0)
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.9
+Requires-Dist: cryptography (>=46.0.1,<46.1.0)
 Requires-Dist: mnemonic (>=0.20,<1.0)
-Requires-Dist: pillow (>=10.3.0,<10.4.0)
-Requires-Dist: pynacl (>=1.5.0,<1.6.0)
+Requires-Dist: pillow (>=11.3.0,<11.4.0)
+Requires-Dist: pynacl (>=1.6.0,<1.7.0)
 Requires-Dist: pyyaml (>=6.0.1,<6.1.0)
 Requires-Dist: pyzbar (>=0.1.9,<0.2.0)
-Requires-Dist: qrcode (>=7.4.2,<7.5.0)
+Requires-Dist: qrcode (>=8.0,<9.0)
 Requires-Dist: ripemd-hash (>=1.0.1,<1.1.0)
 Requires-Dist: safe-pysha3 (>=1.0.4,<1.1.0)
 Project-URL: Repository, https://github.com/symbol/symbol/tree/main/sdk/python
@@ -31,12 +33,12 @@ Description-Content-Type: text/markdown
 
 [![lint][sdk-python-lint]][sdk-python-job] [![test][sdk-python-test]][sdk-python-job] [![vectors][sdk-python-vectors]][sdk-python-job] [![][sdk-python-cov]][sdk-python-cov-link] [![][sdk-python-package]][sdk-python-package-link]
 
-[sdk-python-job]: https://jenkins.symboldev.com/blue/organizations/jenkins/Symbol%2Fgenerated%2Fsymbol%2Fpython/activity?branch=dev
-[sdk-python-lint]: https://jenkins.symboldev.com/buildStatus/icon?job=Symbol%2Fgenerated%2Fsymbol%2Fpython%2Fdev%2F&config=sdk-python-lint
-[sdk-python-build]: https://jenkins.symboldev.com/buildStatus/icon?job=Symbol%2Fgenerated%2Fsymbol%2Fpython%2Fdev%2F&config=sdk-python-build
-[sdk-python-test]: https://jenkins.symboldev.com/buildStatus/icon?job=Symbol%2Fgenerated%2Fsymbol%2Fpython%2Fdev%2F&config=sdk-python-test
-[sdk-python-examples]: https://jenkins.symboldev.com/buildStatus/icon?job=Symbol%2Fgenerated%2Fsymbol%2Fpython%2Fdev%2F&config=sdk-python-examples
-[sdk-python-vectors]: https://jenkins.symboldev.com/buildStatus/icon?job=Symbol%2Fgenerated%2Fsymbol%2Fpython%2Fdev%2F&config=sdk-python-vectors
+[sdk-python-job]: https://jenkins.symbolsyndicate.us/blue/organizations/jenkins/Symbol%2Fgenerated%2Fsymbol%2Fpython/activity?branch=dev
+[sdk-python-lint]: https://jenkins.symbolsyndicate.us/buildStatus/icon?job=Symbol%2Fgenerated%2Fsymbol%2Fpython%2Fdev%2F&config=sdk-python-lint
+[sdk-python-build]: https://jenkins.symbolsyndicate.us/buildStatus/icon?job=Symbol%2Fgenerated%2Fsymbol%2Fpython%2Fdev%2F&config=sdk-python-build
+[sdk-python-test]: https://jenkins.symbolsyndicate.us/buildStatus/icon?job=Symbol%2Fgenerated%2Fsymbol%2Fpython%2Fdev%2F&config=sdk-python-test
+[sdk-python-examples]: https://jenkins.symbolsyndicate.us/buildStatus/icon?job=Symbol%2Fgenerated%2Fsymbol%2Fpython%2Fdev%2F&config=sdk-python-examples
+[sdk-python-vectors]: https://jenkins.symbolsyndicate.us/buildStatus/icon?job=Symbol%2Fgenerated%2Fsymbol%2Fpython%2Fdev%2F&config=sdk-python-vectors
 [sdk-python-cov]: https://codecov.io/gh/symbol/symbol/branch/dev/graph/badge.svg?token=SSYYBMK0M7&flag=sdk-python
 [sdk-python-cov-link]: https://codecov.io/gh/symbol/symbol/tree/dev/sdk/python
 [sdk-python-package]: https://img.shields.io/pypi/v/symbol-sdk-python
@@ -62,9 +64,9 @@ facade = SymbolFacade('testnet')
 _NEM_
 ```python
 from symbolchain.CryptoTypes import PrivateKey
-from symbolchain.facade.SymbolFacade import SymbolFacade
+from symbolchain.facade.NemFacade import NemFacade
 
-facade = SymbolFacade('testnet')
+facade = NemFacade('testnet')
 ````
 
 Second, describe the transaction using a Python dictionary. For example, a transfer transaction can be described as follows:
@@ -103,7 +105,7 @@ Third, sign the transaction and attach the signature:
 private_key = PrivateKey('EDB671EB741BD676969D8A035271D1EE5E75DF33278083D877F23615EB839FEC')
 signature = facade.sign_transaction(facade.KeyPair(private_key), transaction)
 
-json_payload = facade.transactionFactory.attachSignature(transaction, signature)
+json_payload = facade.transaction_factory.attach_signature(transaction, signature)
 ```
 
 Finally, send the payload to the desired network using the specified node endpoint:

{symbol_sdk_python-3.2.2.dist-info → symbol_sdk_python-3.3.0.dist-info}/RECORD

@@ -1,16 +1,16 @@
 symbolchain/AccountDescriptorRepository.py,sha256=XCIIt6XvxqClQL0R7_-xyFBhb0q9bIUbNTr5-YS5f1o,2508
 symbolchain/ArrayHelpers.py,sha256=Iu5QqlWW5j_6Qd0oTFO41MfDH_mKwQLT7XeD2frU2mw,3728
-symbolchain/BaseValue.py,sha256=AGtUYscbQk-w_rGbd9SS2gh3vnTYhCCwpXBt-9bA4u0,1482
+symbolchain/BaseValue.py,sha256=vc56rclpJtxYIL6Mvo6KWwnA0pUfhtsB71NSEjobQtc,1636
 symbolchain/Bip32.py,sha256=L8Fs0XTERGWSPX972KUn-AOPwAS2gZMdVTKAq4HOGa8,1787
 symbolchain/BlockchainSettings.py,sha256=uRHHxi0gW_U9LFUhoDpNMTe2CobLNJQwE9ZMy2o1aX8,723
 symbolchain/BufferReader.py,sha256=Bcg59ZkUzhgKIo2-B1q7jwtU5x-W5_TuuaOqPnXM1ug,883
 symbolchain/BufferWriter.py,sha256=JpZkzcxUbbDkGU4Sz-oMhL6dgZ_ovhBVduVB51PEWa4,639
-symbolchain/ByteArray.py,sha256=u5FyC6tSxWLXDpT-_Pd3fIYftde1aAK1x5dikROJ0-0,1059
+symbolchain/ByteArray.py,sha256=fVII_BDew55qTU0dQIZWYvWWT_vxfCW_IJzcPglCHr8,1173
 symbolchain/Cipher.py,sha256=CtNKjLJJPTTI4TV4Q_-bkloGSr20wjzHmaLMAbKp03g,2158
 symbolchain/CodeWordsEncoder.py,sha256=YydhdbhxTvjXYUp1OkJj7XjTz3WfKVSGi8VIUzGTTHA,1233
 symbolchain/CryptoTypes.py,sha256=9rMQyYF0xBU5W1vo07fgDqfP4dR3E_Hv5Ec1ozKanUs,1844
 symbolchain/DiceMnemonicGenerator.py,sha256=F8QU90PQzp-qzNqnnxHowVtG_-rNiqWDALSsi-8I_og,1848
-symbolchain/Network.py,sha256=LCMIkYo5yTlV-8_gqIjOZTSGeCBJuBZ7YisJJ1G36z4,3368
+symbolchain/Network.py,sha256=6FK2qOGYsGz7qMEpu7hCcvjvnl6tQKjdMTVx9PwTjOI,3398
 symbolchain/NetworkTimestamp.py,sha256=M3T2HFYJT5v9B_tkGn2FkjW6C9hueXmdTjyWWSr9rXw,1595
 symbolchain/NodeDescriptorRepository.py,sha256=DVqhj_D6KWgaYiJC3jKv2ne-AJTvpJrKruhiRmGgtQE,1019
 symbolchain/Ordered.py,sha256=--tQ_aZpXhZYcsRLgMjUNHPYlAH7BMfuss2CSxMvNhY,397
@@ -25,12 +25,12 @@ symbolchain/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 symbolchain/external/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 symbolchain/external/ed25519.py,sha256=xpq-UOQ3CNCZp4V2uaHsWeyEfXezCfWe44NKsecZCqU,7833
 symbolchain/facade/BatchOperations.py,sha256=SQR6fXTi1mI7H7ubJsqYEabWQzzVXhbD8BkzgIpoCII,2983
-symbolchain/facade/NemFacade.py,sha256=oOvU8hJRNjZAFaoETueyw_R0K-S6AvlNV3pB7ltVOfY,4166
-symbolchain/facade/SymbolFacade.py,sha256=Yz7hIGanNY8iFLeIelRB8-M44gmlvbdc0pB_ouGkNg0,6527
+symbolchain/facade/NemFacade.py,sha256=qCaFie17Q1R4wRQqiedKEywJH8yq_CjY_-b9dLgiZQk,4226
+symbolchain/facade/SymbolFacade.py,sha256=jUlaHJqWxamJhAnNv367Ja__lf2IM4nNIgIumzcyEd4,7220
 symbolchain/facade/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 symbolchain/impl/CipherHelpers.py,sha256=KSYH95oie-PxFfGAYfnqHOC1RWIrdxC7Vp6Go-o469Q,2152
 symbolchain/impl/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-symbolchain/nc/__init__.py,sha256=vosYIQt3McpoGpspAl3YoV3_vrpNO-ddiTDmyqk0u-c,106403
+symbolchain/nc/__init__.py,sha256=ROTctT787pDzqlnJkavy5vAmVe_JLUwj5e9GprFklXM,121192
 symbolchain/nem/KeyPair.py,sha256=34VwU7EdroB0nnzTCdTEUAK_DMrcDYzo3JKdniXQMG4,3712
 symbolchain/nem/MessageEncoder.py,sha256=EGm4mtmyXUXQb-R49Xmrl3w40ye_LbZQ8r5aJusH0WE,2699
 symbolchain/nem/Network.py,sha256=vD7YEqJHyUPK14UAGBT29cX9Cjvq1uHDfeiYudaxgAw,1746
@@ -38,7 +38,7 @@ symbolchain/nem/SharedKey.py,sha256=owBUV_XNo1wCby0b4Amz1Bl6uzTeQmiSFy7UcWFo00I,
 symbolchain/nem/TransactionFactory.py,sha256=IaKsLdTmW8ZU9s5kaUcaGl7P91awR8BMDfX_zWTAO04,4170
 symbolchain/nem/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 symbolchain/ripemd160.py,sha256=u2uv8wJY5FY8tll_EfiGE5o65Ri6E-8HbynvJUPBJa8,429
-symbolchain/sc/__init__.py,sha256=axRbsZf_j33DLTJ2TvIKg6aAxVG5xo1I2w51lzO2h9M,286967
+symbolchain/sc/__init__.py,sha256=Po_ezk7y9Rr_xESvHExyq420FRro5un2KvSnojVf3hg,317964
 symbolchain/symbol/IdGenerator.py,sha256=4CWW5EekbmULDDukscs73ZFN_U179hAacK3luL7Q0TA,1696
 symbolchain/symbol/KeyPair.py,sha256=CkQh7oOeVRbjKewTfln0t1PZckcTuIXb2roY1zZjVrc,1506
 symbolchain/symbol/Merkle.py,sha256=FrCwnveXEoXEx7xFP4UC_htjAVuVeUNbvnh8YDdy3z0,7243
@@ -49,6 +49,6 @@ symbolchain/symbol/SharedKey.py,sha256=Bg1qYW_iMNYKtokep5S1m9b7GfywM5OGaCrVUdt01
 symbolchain/symbol/TransactionFactory.py,sha256=65N6UHDwrzNyHnpxkw-RmjuC32Znto1B9TH5OgcD1Oo,3957
 symbolchain/symbol/VotingKeysGenerator.py,sha256=tuJ6yl2CqqQ9uupAw3z-GJIW20WOsblcLQb2_fPUCDE,1686
 symbolchain/symbol/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-symbol_sdk_python-3.2.2.dist-info/METADATA,sha256=H3eZti6Yn4oq90_uE111bCzAPZkgrfnU2VWN9f1Spzg,5584
-symbol_sdk_python-3.2.2.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
-symbol_sdk_python-3.2.2.dist-info/RECORD,,
+symbol_sdk_python-3.3.0.dist-info/METADATA,sha256=wywxCNiAGcO_Ox2xEqfS7zfoSUJQgL5AVJFQ-3yznME,5709
+symbol_sdk_python-3.3.0.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
+symbol_sdk_python-3.3.0.dist-info/RECORD,,

{symbol_sdk_python-3.2.2.dist-info → symbol_sdk_python-3.3.0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 1.6.1
+Generator: poetry-core 1.9.1
 Root-Is-Purelib: true
 Tag: py3-none-any

symbolchain/BaseValue.py

@@ -49,3 +49,7 @@ class BaseValue(Ordered):
 			unsigned_value = self.value + upper_bound_plus_one
 
 		return f'0x{unsigned_value:0{self.size * 2}X}'
+
+	def to_json(self):
+		"""Returns representation of this object that can be stored in JSON."""
+		return str(self.value) if 8 <= self.size else self.value

symbolchain/ByteArray.py

@@ -37,3 +37,7 @@ class ByteArray(Ordered):
 
 	def __str__(self):
 		return hexlify(self.bytes).decode('utf8').upper()
+
+	def to_json(self):
+		"""Returns representation of this object that can be stored in JSON."""
+		return str(self)

symbolchain/Network.py

@@ -9,7 +9,7 @@ class Network:
 	"""Represents a network."""
 
 	def __init__(self, name, identifier, datetime_converter, address_class, network_timestamp_class):
-		# pylint: disable=too-many-arguments
+		# pylint: disable=too-many-arguments,too-many-positional-arguments
 
 		"""Creates a new network with the specified properties."""
 		self.name = name

symbolchain/facade/NemFacade.py

@@ -93,16 +93,18 @@ class NemFacade:
 		return Hash256(sha3.keccak_256(non_verifiable_transaction.serialize()).digest())
 
 	@staticmethod
-	def sign_transaction(key_pair, transaction):
-		"""Signs a NEM transaction."""
+	def extract_signing_payload(transaction):
+		"""Gets the payload to sign given a NEM transaction."""
 		non_verifiable_transaction = TransactionFactory.to_non_verifiable_transaction(transaction)
-		return key_pair.sign(non_verifiable_transaction.serialize())
+		return non_verifiable_transaction.serialize()
 
-	@staticmethod
-	def verify_transaction(transaction, signature):
+	def sign_transaction(self, key_pair, transaction):
+		"""Signs a NEM transaction."""
+		return key_pair.sign(self.extract_signing_payload(transaction))
+
+	def verify_transaction(self, transaction, signature):
 		"""Verifies a NEM transaction."""
-		non_verifiable_transaction = TransactionFactory.to_non_verifiable_transaction(transaction)
-		return Verifier(transaction.signer_public_key).verify(non_verifiable_transaction.serialize(), signature)
+		return Verifier(transaction.signer_public_key).verify(self.extract_signing_payload(transaction), signature)
 
 	def bip32_path(self, account_id):
 		"""Creates a network compatible BIP32 path for the specified account."""

symbolchain/facade/SymbolFacade.py

@@ -19,13 +19,17 @@ TRANSACTION_HEADER_SIZE = sum(field[1] for field in [
 	('reserved2', 4)
 ])
 
-AGGREGATE_HASHED_SIZE = sum(field[1] for field in [
+PRE_V3_AGGREGATE_HASHED_SIZE = sum(field[1] for field in [
 	('version_network_type', 4),
 	('max_fee', 8),
 	('deadline', 8),
 	('transactions_hash', Hash256.SIZE)
 ])
 
+AGGREGATE_HASHED_SIZE = PRE_V3_AGGREGATE_HASHED_SIZE + sum(field[1] for field in [
+	('payload_size', 4)
+])
+
 
 # region SymbolPublicAccount / SymbolAccount
 
@@ -59,6 +63,10 @@ class SymbolAccount(SymbolPublicAccount):
 		"""Cosigns a Symbol transaction."""
 		return self._facade.cosign_transaction(self.key_pair, transaction, detached)
 
+	def cosign_transaction_hash(self, transaction_hash, detached=False):
+		"""Cosigns a Symbol transaction hash."""
+		return self._facade.cosign_transaction_hash(self.key_pair, transaction_hash, detached)
+
 # endregion
 
 
@@ -116,22 +124,23 @@ class SymbolFacade:
 		hasher.update(self._transaction_data_buffer(transaction.serialize()))
 		return Hash256(hasher.digest())
 
-	def sign_transaction(self, key_pair, transaction):
-		"""Signs a Symbol transaction."""
+	def extract_signing_payload(self, transaction):
+		"""Gets the payload to sign given a Symbol transaction."""
 		sign_buffer = self.network.generation_hash_seed.bytes
 		sign_buffer += self._transaction_data_buffer(transaction.serialize())
-		return key_pair.sign(sign_buffer)
+		return sign_buffer
+
+	def sign_transaction(self, key_pair, transaction):
+		"""Signs a Symbol transaction."""
+		return key_pair.sign(self.extract_signing_payload(transaction))
 
 	def verify_transaction(self, transaction, signature):
 		"""Verifies a Symbol transaction."""
-		verify_buffer = self.network.generation_hash_seed.bytes
-		verify_buffer += self._transaction_data_buffer(transaction.serialize())
-		return Verifier(transaction.signer_public_key).verify(verify_buffer, signature)
-
-	def cosign_transaction(self, key_pair, transaction, detached=False):
-		"""Cosigns a Symbol transaction."""
-		transaction_hash = self.hash_transaction(transaction)
+		return Verifier(transaction.signer_public_key).verify(self.extract_signing_payload(transaction), signature)
 
+	@staticmethod
+	def cosign_transaction_hash(key_pair, transaction_hash, detached=False):
+		"""Cosigns a Symbol transaction hash."""
 		cosignature = sc.DetachedCosignature() if detached else sc.Cosignature()
 		if detached:
 			cosignature.parent_hash = sc.Hash256(transaction_hash.bytes)
@@ -141,6 +150,11 @@ class SymbolFacade:
 		cosignature.signature = sc.Signature(key_pair.sign(transaction_hash.bytes).bytes)
 		return cosignature
 
+	def cosign_transaction(self, key_pair, transaction, detached=False):
+		"""Cosigns a Symbol transaction."""
+		transaction_hash = self.hash_transaction(transaction)
+		return self.cosign_transaction_hash(key_pair, transaction_hash, detached)
+
 	@staticmethod
 	def hash_embedded_transactions(embedded_transactions):
 		"""Hashes embedded transactions of an aggregate."""
@@ -171,6 +185,7 @@ class SymbolFacade:
 		data_buffer_start = TRANSACTION_HEADER_SIZE
 		data_buffer_end = len(transaction_buffer)
 		if SymbolFacade._is_aggregate_transaction(transaction_buffer):
-			data_buffer_end = TRANSACTION_HEADER_SIZE + AGGREGATE_HASHED_SIZE
+			version = transaction_buffer[TRANSACTION_HEADER_SIZE]
+			data_buffer_end = TRANSACTION_HEADER_SIZE + (AGGREGATE_HASHED_SIZE if version >= 3 else PRE_V3_AGGREGATE_HASHED_SIZE)
 
 		return transaction_buffer[data_buffer_start:data_buffer_end]