Shimmer-Transaction-Python

This repository contains an example script demonstrating how to execute a native token transaction on the Shimmer network using the IOTA SDK. The script is written in Python and includes detailed comments to guide users through each step of the process.

Prerequisites

Before running the script, ensure you have the following installed:

• Python 3.7 or higher
• IOTA SDK
• A Shimmer Stronghold file and password

Setup

1. Clone this repository to your local machine:

   git clone https://github.com/lodist/Shimmer-Transaction-Python.git
   cd Shimmer-Transaction-Python

2. Install the required Python packages:

   pip install iota-sdk

3. Update the script with your configuration:

   • Replace /path/to/your/wallet.stronghold with the path to your Stronghold file.
   • Replace your_stronghold_password with your Stronghold password.
   • Replace 0xYourTokenID with the actual token ID you want to send.

Usage

To run the script, use the following command:

python shimmer_transact.py 'recipient_address'

Replace 'recipient_address' with the address to which you want to send the tokens.

Script Explanation

The script performs the following steps:

Imports necessary libraries: Imports modules from the IOTA SDK and other necessary libraries for logging.

Configuration parameters: Sets up the configuration parameters, including node URL, account alias, Stronghold path, and password.

Initialize the Stronghold secret manager: Manages the Stronghold file and its password.

Create client options: Specifies the node URL for connecting to the Shimmer network.

Initialize the Wallet instance: Configures the wallet with client options, coin type, and secret manager.

Access or create an account: Tries to access an existing account by alias, or creates a new one if it doesn't exist.

python Copy code try: # Try to access the existing account account = wallet.get_account(account_alias) print(f"Accessed existing account with alias '{account_alias}'") except Exception as e: # If accessing the account fails, it likely doesn't exist, so create it print(f"Account '{account_alias}' not found. Creating a new account...") account = wallet.create_account(account_alias) print(f"New account created with alias '{account_alias}'") Sync the account: Syncs the account with the Shimmer node to update its state.

Check balance: Retrieves and prints the balance, including any native tokens.

Prepare and send a transaction: Sets the Stronghold password, prepares the transaction by specifying the recipient address, token ID, and amount, sends the transaction, and waits for it to be included in a block.

Sync again: Syncs the account again to update the balance.

Contributing

Contributions are welcome! If you have any improvements or suggestions, feel free to fork the repository, make your changes, and submit a pull request.

License

This script is open-source and can be used by anyone under the MIT License.