✨ added bridge functionalities

Author: PsicoThePato

CHANGELOG

@@ -1,5 +1,8 @@
 # Changelog
 
+## 0.1.36.3
+- Added `bridge` and `bridge_withdraw` commands
+
 ## 0.1.36.2
 - Fixed a problem with the garbage collector causing memory leaks
 

pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "communex"
-version = "0.1.36.2"
+version = "0.1.36.3"
 description = "A library for Commune network focused on simplicity"
 authors = ["agicommies <[email protected]>"]
 license = "MIT"

src/communex/cli/balance.py

@@ -297,3 +297,45 @@ def transfer_dao_funds(
 
     client = context.com_client()
     client.add_transfer_dao_treasury_proposal(keypair, cid, nano_amount, dest)
+
+
+@balance_app.command()
+def bridge(
+    ctx: Context,
+    key: str,
+    amount: float,
+):
+    context = make_custom_context(ctx)
+    client = context.com_client()
+
+    nano_amount = to_nano(amount)
+    keypair = context.load_key(key, None)
+
+    with context.progress_status(f"Bridging {amount} tokens..."):
+        try:
+            client.bridge(keypair, nano_amount)
+        except Exception as e:
+            context.error(f"Failed to bridge {amount} tokens: {e}")
+        else:
+            context.info(f"Bridged {amount}$j successfully")
+
+
+@balance_app.command()
+def bridge_withdraw(
+    ctx: Context,
+    key: str,
+    amount: float,
+):
+    context = make_custom_context(ctx)
+    client = context.com_client()
+
+    nano_amount = to_nano(amount)
+    keypair = context.load_key(key, None)
+
+    with context.progress_status(f"Withdrawing {amount} tokens..."):
+        try:
+            client.bridge_withdraw(keypair, nano_amount)
+        except Exception as e:
+            context.error(f"Failed to withdraw {amount} tokens: {e}")
+        else:
+            context.info(f"Withdrew {amount}$j successfully")

src/communex/client.py

@@ -1506,6 +1506,58 @@ def transfer_stake(
 
         return response
 
+    def bridge(
+        self,
+        key: Keypair,
+        amount: int,
+    ):
+        """
+        Bridge tokens from the Subspace network to the Torus network.
+
+        Args:
+            key: The keypair associated with the account that is bridging the tokens.
+            amount: The amount of tokens to bridge, in nanotokens.
+
+        Returns:
+            A receipt of the bridging transaction.
+
+        Raises:
+            InsufficientBalanceError: If the account does not have enough balance.
+            ChainTransactionError: If the transaction fails.
+        """
+
+        params = {"amount": amount}
+
+        response = self.compose_call("bridge", key=key, params=params)
+
+        return response
+
+    def bridge_withdraw(
+        self,
+        key: Keypair,
+        amount: int,
+    ):
+        """
+        Withdraw bridged tokens from the Torus network to the Subspace network.
+
+        Args:
+            key: The keypair associated with the account that is withdrawing the tokens.
+            amount: The amount of tokens to withdraw, in nanotokens.
+
+        Returns:
+            A receipt of the withdrawal transaction.
+
+        Raises:
+            InsufficientBalanceError: If the account does not have enough balance.
+            ChainTransactionError: If the transaction fails.
+        """
+
+        params = {"amount": amount}
+
+        response = self.compose_call("bridge_withdraw", key=key, params=params)
+
+        return response
+
     def multiunstake(
         self,
         key: Keypair,