Change the default returning type of 'to_cbor' to bytes (#232)

Change the default returning type of 'to_cbor' to bytes and add 'to_cbor_hex' that returns cbor hex.

Author: cffls

docs/requirements.txt

@@ -21,7 +21,9 @@ ecpy==1.2.5 ; python_version >= "3.7" and python_version < "4.0"
 exceptiongroup==1.1.1 ; python_version >= "3.7" and python_version < "3.11"
 execnet==1.9.0 ; python_version >= "3.7" and python_version < "4.0"
 flake8==5.0.4 ; python_version >= "3.7" and python_version < "4.0"
-flask==2.2.3 ; python_version >= "3.7" and python_version < "4.0"
+flask==2.2.4 ; python_version >= "3.7" and python_version < "4.0"
+frozendict==2.3.8 ; python_version >= "3.7" and python_version < "4.0"
+frozenlist==1.3.3 ; python_version >= "3.7" and python_version < "4.0"
 idna==3.4 ; python_version >= "3.7" and python_version < "4"
 imagesize==1.4.1 ; python_version >= "3.7" and python_version < "4.0"
 importlib-metadata==4.2.0 ; python_version >= "3.7" and python_version < "3.10"
@@ -37,7 +39,7 @@ mypy==1.2.0 ; python_version >= "3.7" and python_version < "4.0"
 oscrypto==1.3.0 ; python_version >= "3.7" and python_version < "4.0"
 packaging==23.1 ; python_version >= "3.7" and python_version < "4.0"
 pathspec==0.11.1 ; python_version >= "3.7" and python_version < "4.0"
-platformdirs==3.2.0 ; python_version >= "3.7" and python_version < "4.0"
+platformdirs==3.3.0 ; python_version >= "3.7" and python_version < "4.0"
 pluggy==1.0.0 ; python_version >= "3.7" and python_version < "4.0"
 pprintpp==0.4.0 ; python_version >= "3.7" and python_version < "4.0"
 py==1.11.0 ; python_version >= "3.7" and python_version < "4.0"
@@ -52,7 +54,7 @@ pytest==7.3.1 ; python_version >= "3.7" and python_version < "4.0"
 pytz==2023.3 ; python_version >= "3.7" and python_version < "3.9"
 requests==2.28.2 ; python_version >= "3.7" and python_version < "4"
 retry==0.9.2 ; python_version >= "3.7" and python_version < "4.0"
-setuptools==67.7.1 ; python_version >= "3.7" and python_version < "4.0"
+setuptools==67.7.2 ; python_version >= "3.7" and python_version < "4.0"
 six==1.16.0 ; python_version >= "3.7" and python_version < "4.0"
 snowballstemmer==2.2.0 ; python_version >= "3.7" and python_version < "4.0"
 sphinx-copybutton==0.5.2 ; python_version >= "3.7" and python_version < "4.0"

docs/source/guides/plutus.rst

@@ -24,7 +24,7 @@ To calculate the hash of a datum, we can leverage the helper class `PlutusData`.
 Empty datum::
 
     >>> empty_datum = PlutusData()
-    >>> empty_datum.to_cbor()
+    >>> empty_datum.to_cbor_hex()
     'd87980'
 
 Sample datum with int, bytes, List and hashmap inputs::
@@ -39,7 +39,7 @@ Sample datum with int, bytes, List and hashmap inputs::
     ...     d: dict
 
     >>> datum = MyDatum(123, b"1234", IndefiniteList([4, 5, 6]), {1: b"1", 2: b"2"})
-    >>> datum.to_cbor()
+    >>> datum.to_cbor_hex()
     'd87a9f187b43333231ff'
 
 You can also wrap `PlutusData` within `PlutusData`::
@@ -55,7 +55,7 @@ You can also wrap `PlutusData` within `PlutusData`::
     >>> deadline = 1643235300000
     >>> other_datum = MyDatum(123, b"1234", IndefiniteList([4, 5, 6]), {1: b"1", 2: b"2"})
     >>> include_datum = InclusionDatum(key_hash, deadline, other_datum)
-    >>> include_datum.to_cbor()
+    >>> include_datum.to_cbor_hex()
     'd87a9f581cc2ff616e11299d9094ce0a7eb5b7284b705147a822f4ffbd471f971a1b0000017e9874d2a0d8668218829f187b44313233349f040506ffa2014131024132ffff'
 
 `PlutusData` supports conversion from/to JSON format, which
@@ -67,7 +67,7 @@ Similarly, redeemer can be serialized like following::
 
     >>> data = MyDatum(123, b"234", IndefiniteList([]), {1: b"1", 2: b"2"})
     >>> redeemer = Redeemer(data, ExecutionUnits(1000000, 1000000))
-    >>> redeemer.to_cbor()
+    >>> redeemer.to_cbor_hex()
     '840000d8668218829f187b433233349fffa2014131024132ff821a000f42401a000f4240'
 
 -----------------------
@@ -178,7 +178,7 @@ Note that we will just use the datatype defined in the contract, as it also uses
 Build, sign and submit the transaction:
 
    >>> signed_tx = builder.build_and_sign([payment_skey], giver_address)
-   >>> context.submit_tx(signed_tx.to_cbor())
+   >>> context.submit_tx(signed_tx.to_cbor_hex())
 
 Step 6
 
@@ -219,7 +219,7 @@ Now lets try to resubmit this::
 
     >>> signed_tx = builder.build_and_sign([payment_skey_2], taker_address)
 
-    >>> context.submit_tx(signed_tx.to_cbor())
+    >>> context.submit_tx(signed_tx.to_cbor_hex())
 
 The funds locked in script address is successfully retrieved to the taker address.
 

docs/source/guides/serialization.rst

@@ -34,7 +34,7 @@ Examples::
     ...     outputs=[output1, output2],
     ...     fee=fee
     ... )
-    >>> cbor_hex = tx_body.to_cbor()
+    >>> cbor_hex = tx_body.to_cbor_hex()
     a50081825820732bfd67e66be8e8288349fcaaa2294973ef6271cc189a239bb431275401b8e500018282581d60f6532850e1bccee9c72a9113ad98bcc5dbb30d2ac960262444f6e5f41b000000174876e80082581d60f6532850e1bccee9c72a9113ad98bcc5dbb30d2ac960262444f6e5f41b000000ba43b4b7f7021a000288090d800e80
 
     >>> restored_tx_body = TransactionBody.from_cbor(cbor_hex)

docs/source/guides/transaction.rst

@@ -178,5 +178,5 @@ Transaction submission
 Once we have a signed transaction, it could be submitted to the network. The easiest way to do so is through a chain
 context::
 
-    >>> context.submit_tx(signed_tx.to_cbor())
+    >>> context.submit_tx(signed_tx.to_cbor_hex())
 

examples/full_stack/server.py

@@ -65,7 +65,7 @@ def home_page():
 @app.route("/build_tx", methods=["POST"])
 def build_tx():
     tx = build_transaction(request.json)
-    cbor_hex = tx.to_cbor()
+    cbor_hex = tx.to_cbor_hex()
     print(cbor_hex)
     return {"tx": cbor_hex}
 
@@ -75,7 +75,7 @@ def submit_tx():
     tx = compose_tx_and_witness(request.json)
     tx_id = tx.transaction_body.hash().hex()
     print(f"Transaction: \n {tx}")
-    print(f"Transaction cbor: {tx.to_cbor()}")
+    print(f"Transaction cbor: {tx.to_cbor_hex()}")
     print(f"Transaction ID: {tx_id}")
     chain_context.submit_tx(tx)
     return {"tx_id": tx_id}

examples/native_token.py

@@ -168,7 +168,7 @@ def load_or_create_key_pair(base_dir, base_name):
 
 print("############### Transaction created ###############")
 print(signed_tx)
-print(signed_tx.to_cbor())
+print(signed_tx.to_cbor_hex())
 
 # Submit signed transaction to the network
 print("############### Submitting transaction ###############")

examples/plutus/forty_two/forty_two.py

@@ -41,7 +41,7 @@ def wait_for_tx(tx_id):
 def submit_tx(tx):
     print("############### Transaction created ###############")
     print(tx)
-    print(tx.to_cbor())
+    print(tx.to_cbor_hex())
     print("############### Submitting transaction ###############")
     chain_context.submit_tx(tx)
     wait_for_tx(str(tx.id))

integration-test/test/base.py

@@ -67,7 +67,7 @@ def fund(self, source_address, source_key, target_address, amount=5000000):
 
         print("############### Transaction created ###############")
         print(signed_tx)
-        print(signed_tx.to_cbor())
+        print(signed_tx.to_cbor_hex())
         print("############### Submitting transaction ###############")
         self.chain_context.submit_tx(signed_tx)
         self.assert_output(target_address, target_output=output)

integration-test/test/test_certificate.py

@@ -31,7 +31,7 @@ def test_stake_delegation(self):
 
             print("############### Transaction created ###############")
             print(signed_tx)
-            print(signed_tx.to_cbor())
+            print(signed_tx.to_cbor_hex())
             print("############### Submitting transaction ###############")
             self.chain_context.submit_tx(signed_tx)
 
@@ -58,7 +58,7 @@ def test_stake_delegation(self):
 
             print("############### Transaction created ###############")
             print(signed_tx)
-            print(signed_tx.to_cbor())
+            print(signed_tx.to_cbor_hex())
             print("############### Submitting transaction ###############")
             self.chain_context.submit_tx(signed_tx)
 
@@ -84,6 +84,6 @@ def test_stake_delegation(self):
 
         print("############### Transaction created ###############")
         print(signed_tx)
-        print(signed_tx.to_cbor())
+        print(signed_tx.to_cbor_hex())
         print("############### Submitting transaction ###############")
         self.chain_context.submit_tx(signed_tx)

integration-test/test/test_min_utxo.py

@@ -98,7 +98,7 @@ class MyPlutusData(PlutusData):
 
         print("############### Transaction created ###############")
         print(signed_tx)
-        print(signed_tx.to_cbor())
+        print(signed_tx.to_cbor_hex())
 
         # Submit signed transaction to the network
         print("############### Submitting transaction ###############")