The Python Console

Qsafe Wallet Python Console

The Qsafe Wallet Python Console is a powerful interactive tool that allows users to interact with the Qsafe Wallet programmatically. Similar to Electrum’s Python Console, it provides a way to automate tasks, access wallet data, and perform advanced operations through a Python interface. This console allows both developers and advanced users to take full control of their wallet and perform tasks that are not available through the graphical user interface (GUI).

Getting Started with the Qsafe Python Console

To begin using the Qsafe Wallet Python Console, you need to have Qsafe Wallet installed and running. Once the wallet is running, you can access the console by executing the following command:

qsafe_console.py

This will launch an interactive Python shell that connects directly to the Qsafe Wallet backend. From here, you can execute various Python commands to interact with your wallet.

Key Features of the Qsafe Python Console

1. Access Wallet Information

   • You can query details about your wallet, such as addresses, balances, and transaction history. For example:

     wallet.getbalance()
     wallet.listaddresses()

2. Generate and Manage Addresses

   • You can generate new addresses, view existing ones, and manage your wallet’s address pool.

     new_address = wallet.createnewaddress()
     print(new_address)

3. Perform Transactions

   • Send and receive funds directly through the console, specify transaction fees, and view transaction details.

     tx = wallet.payto(destination_address, amount)
     wallet.broadcast(tx)

4. Wallet Backup and Recovery

   • Backup your wallet to a secure file, and restore it from a backup using a seed phrase or private keys.

     wallet.restore()

5. Private Key Management

   • The console allows direct access to your wallet’s private keys. You can export and import keys for specific addresses, though this should be done with caution due to security concerns.

     private_key = wallet.getprivatekeys([address])

6. Advanced Scripting

   • The console can be used to write advanced scripts for wallet management. This is useful for automating recurring tasks, running batch operations, or interacting with third-party services.

7. Network and Server Management

   • You can interact with the Qsafe server and manage network settings from the console.

     wallet.set_server('new_server_address')
     wallet.get_servers()

Example Console Commands

Here are some common examples of how to use the Qsafe Python Console:

• Get Wallet Balance:

  balance = wallet.getbalance()
  print(f"Current Balance: {balance} QRN")

• Send Transaction: To send a transaction, specify the recipient’s address, amount to send, and fee:

  recipient = 'qrnA1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa'
  amount = 0.1  # QRN
  tx = wallet.payto(recipient, amount)
  wallet.broadcast(tx)
  print("Transaction Sent:", tx)

• Check Transaction History: You can retrieve the history of all transactions related to your wallet:

  history = wallet.get_transaction_history()
  for tx in history:
      print(f"Transaction ID: {tx['txid']}, Amount: {tx['amount']} QRN, Status: {tx['status']}")

• Create a New Address: Generate a new receiving address for your wallet:

  new_address = wallet.create_new_address()
  print(f"New Address: {new_address}")

Script Example: Automate Sending Payments

You can use the Qsafe Python Console to automate sending payments. Below is an example script that sends funds to a recipient and checks the status of the transaction.

# Define recipient and amount
recipient_address = 'qrnA1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa'
amount = 0.05  # QRN
fee = 0.0001  # QRN

# Create and send transaction
tx = wallet.create_transaction(recipient_address, amount, fee)
wallet.broadcast_transaction(tx)

# Check transaction status
tx_status = wallet.get_transaction_status(tx['txid'])
print(f"Transaction Status: {tx_status}")

Advanced Usage: Creating and Signing Custom Transactions

For users who want to interact with Qsafe Wallet at a deeper level, the Python console can be used to create and sign custom transactions manually. This can be useful for building multi-sig transactions, interacting with smart contracts, or performing operations with specific inputs and outputs.

Example of creating a custom transaction:

inputs = [{'txid': 'your_txid_here', 'vout': 0}]
outputs = [{'address': 'destination_address_here', 'value': 0.01}]
custom_tx = wallet.create_custom_transaction(inputs, outputs, fee=0.0001)
signed_tx = wallet.sign_transaction(custom_tx)
print(f"Signed Transaction: {signed_tx}")

Security Considerations

While the Python console is powerful, it’s important to handle sensitive information such as private keys with care:

• Private Keys: Never expose private keys in your scripts or commands. Always use wallet backups and recovery options for secure management.

• Backup Regularly: Make sure to back up your wallet regularly, especially before performing any significant operations, such as sending funds or modifying wallet settings.

• Use Secure Environments: Run the Qsafe Python Console in a secure, trusted environment to prevent unauthorized access to your wallet and private data.