[#10] prepare_multisig_transfer now returns raw trytes.

Author: todofixthis

iota/multisig/api.py

@@ -195,14 +195,15 @@ def prepare_multisig_transfer(
       Dict containing the following values::
 
          {
-           'bundle': ProposedBundle,
-             Finalized bundle.  The input transactions are not signed.
+           'trytes': List[TransactionTrytes],
+             Finalized bundle, as trytes.
+             The input transactions are not signed.
          }
 
       In order to authorize the spending of IOTAs from the multisig
       input, you must generate the correct private keys and invoke the
-      bundle's :py:meth:`iota.transaction.ProposedBundle.sign_input_at`
-      method for each key.
+      :py:meth:`iota.crypto.types.PrivateKey.sign_input_at` method for
+      each key, in the correct order.
 
       Once the correct signatures are applied, you can then perform
       proof of work (``attachToTangle``) and broadcast the bundle using

iota/multisig/commands/prepare_multisig_transfer.py

@@ -117,7 +117,7 @@ def _execute(self, request):
 
     # Return the bundle with inputs unsigned.
     return {
-      'bundle': bundle,
+      'trytes': bundle.as_tryte_strings(),
     }
 
 

test/multisig/commands/prepare_multisig_transfer_test.py

@@ -564,7 +564,14 @@ def test_happy_path(self):
           ),
       )
 
-    bundle = pmt_result['bundle'] # type: Bundle
+    # The command returns the raw trytes.  This is useful in a
+    # real-world scenario because trytes are easier to transfer between
+    # each entity that needs to apply their signature.
+    #
+    # However, for purposes of this test, we will convert the trytes
+    # back into a bundle so that we can inspect the end result more
+    # easily.
+    bundle = Bundle.from_tryte_strings(pmt_result['trytes'])
 
     #
     # This bundle looks almost identical to what you would expect from
@@ -635,14 +642,8 @@ def test_unspent_inputs_with_change_address(self):
         changeAddress = Address(self.trytes_3),
       )
 
-    bundle = pmt_result['bundle'] # type: Bundle
+    bundle = Bundle.from_tryte_strings(pmt_result['trytes'])
 
-    #
-    # This bundle looks almost identical to what you would expect from
-    # :py:meth:`iota.api.Iota.prepare_transfer`, except:
-    # - There are 4 inputs (to hold all of the signature fragments).
-    # - The inputs are unsigned.
-    #
     self.assertEqual(len(bundle), 6)
 
     # Spend Transaction