fix: example scripts and README update (#154)

* fixed example scripts and readme

Signed-off-by: nadinedelia <nadine.loepfe@swirldslabs.com>

* added commas

Signed-off-by: nadinedelia <nadine.loepfe@swirldslabs.com>

---------

Signed-off-by: nadinedelia <nadine.loepfe@swirldslabs.com>

Author: nadineloepfe

CHANGELOG.md

@@ -4,7 +4,18 @@ All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](https://semver.org).  
 This changelog is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
-## [Unreleased]
+## [0.1.3]
+### Added
+- a lot of Transactions
+
+### Changed
+- Example scripts updated
+- README updated
+
+### Removed
+
+
+## [0.1.1]
 ### Added
 - RELEASE.md
 - CONTRIBUTING.md

README.md

@@ -55,7 +55,7 @@ Other installation methods can be found [here](https://docs.astral.sh/uv/getting
 2. Clone this repository:
 
 ```bash
-git clone https://github.com/hiero-ledger/hiero_sdk_python.git
+git clone https://github.com/hiero-ledger/hiero-sdk-python.git
 cd hiero-sdk-python
 ```
 
@@ -95,8 +95,8 @@ Create a .env file in the root of your project with the following (replace with
 
 ```
 OPERATOR_ID=0.0.1234xx
-OPERATOR_KEY=302e020100300506032b657004220420...
-ADMIN_KEY=302a300506032b65700321009308ecfdf...
+OPERATOR_KEY=af20e47d590300506032b657004220420...
+ADMIN_KEY=af20e47d59032b65700321009308ecfdf...
 SUPPLY_KEY =302a300506032b6570032100c5e4af5..."
 FREEZE_KEY=302a300306072b65700321009308ecfdf...
 RECIPIENT_ID=0.0.789xx

examples/token_associate.py

@@ -7,36 +7,92 @@
     AccountId,
     PrivateKey,
     Network,
-    TokenId,
+    Hbar,
+    AccountCreateTransaction,
+    TokenCreateTransaction,
     TokenAssociateTransaction,
 )
 
+# Load environment variables from .env file
 load_dotenv()
 
-def associate_token():
-    network = Network(network='testnet')
-    client = Client(network)
 
-    recipient_id = AccountId.from_string(os.getenv('OPERATOR_ID'))
-    recipient_key = PrivateKey.from_string_ed25519(os.getenv('OPERATOR_KEY'))
-    token_id = TokenId.from_string('TOKEN_ID')  # Update as needed
+def create_and_associate_token():
+    """
+    A full example that creates an account, creates a token,
+    and associates the token with the new account.
+    """
+    # 1. Setup Client
+    # =================================================================
+    print("Connecting to Hedera testnet...")
+    client = Client(Network(network='testnet'))
 
-    client.set_operator(recipient_id, recipient_key)
+    try:
+        operator_id = AccountId.from_string(os.getenv('OPERATOR_ID'))
+        operator_key = PrivateKey.from_string_ed25519(os.getenv('OPERATOR_KEY'))
+        client.set_operator(operator_id, operator_key)
+    except (TypeError, ValueError):
+        print("❌ Error: Please check OPERATOR_ID and OPERATOR_KEY in your .env file.")
+        sys.exit(1)
 
-    transaction = (
-        TokenAssociateTransaction()
-        .set_account_id(recipient_id)
-        .add_token_id(token_id)
-        .freeze_with(client)
-        .sign(recipient_key)
-    )
+    print(f"Using operator account: {operator_id}")
+
+    # 2. Create a new account to associate the token with
+    # =================================================================
+    print("\nSTEP 1: Creating a new account...")
+    recipient_key = PrivateKey.generate_ed25519()
+    recipient_public_key = recipient_key.public_key()
 
     try:
-        receipt = transaction.execute(client)
-        print("Token association successful.")
+        tx = (
+            AccountCreateTransaction()
+            .set_key(recipient_public_key)
+            .set_initial_balance(Hbar.from_tinybars(100_000_000)) # 1 Hbar
+        )
+        receipt = tx.execute(client)
+        recipient_id = receipt.accountId
+        print(f"✅ Success! Created new account with ID: {recipient_id}")
     except Exception as e:
-        print(f"Token association failed: {str(e)}")
+        print(f"❌ Error creating new account: {e}")
         sys.exit(1)
 
+
+    # 3. Create a new token
+    # =================================================================
+    print("\nSTEP 2: Creating a new fungible token...")
+    try:
+        tx = (
+            TokenCreateTransaction()
+            .set_token_name("My Associable Token")
+            .set_token_symbol("MAT")
+            .set_initial_supply(1_000_000)
+            .set_treasury_account_id(operator_id)
+        )
+        receipt = tx.execute(client)
+        token_id = receipt.tokenId
+        print(f"✅ Success! Created token with ID: {token_id}")
+    except Exception as e:
+        print(f"❌ Error creating token: {e}")
+        sys.exit(1)
+
+    # 4. Associate the token with the new account
+    # =================================================================
+    print(f"\nSTEP 3: Associating token {token_id} with account {recipient_id}...")
+    try:
+        # Note: The operator pays for this transaction, but the recipient must sign it.
+        tx = (
+            TokenAssociateTransaction()
+            .set_account_id(recipient_id)
+            .add_token_id(token_id)
+            .freeze_with(client)  # Freeze against the client (operator)
+            .sign(recipient_key)  # The recipient *must* sign to approve the association
+        )
+        receipt = tx.execute(client)
+        print(f"✅ Success! Token association complete.")
+    except Exception as e:
+        print(f"❌ Error associating token: {e}")
+        sys.exit(1)
+
+
 if __name__ == "__main__":
-    associate_token()
+    create_and_associate_token()

examples/token_create_fungible_finite.py

@@ -1,20 +1,16 @@
 """
 This is a simple example of how to create a finite fungible token using setting methods.
-
 It:
 1. Loads environment variables.
 2. Sets up a client and creates a token with the given parameters.
 3. Executes the token creation and prints the result.
-
 Required environment variables:
 - OPERATOR_ID, OPERATOR_KEY (mandatory)
 - ADMIN_KEY, SUPPLY_KEY, FREEZE_KEY, PAUSE_KEY (optional)
-
 Dependencies:
 - dotenv
 - hiero_sdk_python
 """
-
 # Adapt imports and paths as appropriate
 import os
 import sys
@@ -25,33 +21,34 @@
     PrivateKey,
     TokenCreateTransaction,
     Network,
-    TokenType,
-    SupplyType
-    )
-
+)
+from hiero_sdk_python.tokens.token_type import TokenType
+from hiero_sdk_python.tokens.supply_type import SupplyType
 # Load environment variables from .env file
 load_dotenv()
-
 def create_token_fungible_finite():
     """Function to create a finite fungible token."""
-
     # Network Setup
     network = Network(network='testnet')
     client = Client(network)
 
-    # Operator credentials (must be present)
     operator_id = AccountId.from_string(os.getenv('OPERATOR_ID'))
     operator_key = PrivateKey.from_string_ed25519(os.getenv('OPERATOR_KEY'))
 
-    # Optional Token Keys
-    admin_key = PrivateKey.from_string_ed25519(os.getenv('ADMIN_KEY'))# Optional
-    supply_key = PrivateKey.from_string_ed25519(os.getenv('SUPPLY_KEY'))# Optional
-    freeze_key = PrivateKey.from_string_ed25519(os.getenv('FREEZE_KEY'))# Optional
-    pause_key = PrivateKey.from_string_ed25519(os.getenv('PAUSE_KEY'))# Optional
-
+    def parse_optional_key(key_str):
+        if not key_str or key_str.startswith('<') or key_str.endswith('>'):
+            return None
+        try:
+            return PrivateKey.from_string_ed25519(key_str)
+        except:
+            return None
+    
+    admin_key = parse_optional_key(os.getenv('ADMIN_KEY'))
+    supply_key = parse_optional_key(os.getenv('SUPPLY_KEY'))
+    freeze_key = parse_optional_key(os.getenv('FREEZE_KEY'))
+    pause_key = parse_optional_key(os.getenv('PAUSE_KEY'))
     # Set the operator for the client
     client.set_operator(operator_id, operator_key)
-
     # Create the token creation transaction
     # In this example, we set up a default empty token create transaction, then set the values
     transaction = (
@@ -64,34 +61,33 @@ def create_token_fungible_finite():
         .set_token_type(TokenType.FUNGIBLE_COMMON)
         .set_supply_type(SupplyType.FINITE)
         .set_max_supply(100)
-        .set_admin_key(admin_key) # Optional
-        .set_supply_key(supply_key) # Optional
-        .set_freeze_key(freeze_key) # Optional
-        .set_pause_key(pause_key) # Optional
         .freeze_with(client) # Freeze the transaction. Returns self so we can sign.
     )
-
+    
+    # Add optional keys only if they exist
+    if admin_key:
+        transaction.set_admin_key(admin_key)
+    if supply_key:
+        transaction.set_supply_key(supply_key)
+    if freeze_key:
+        transaction.set_freeze_key(freeze_key)
+    if pause_key:
+        transaction.set_pause_key(pause_key)
     # Required signature by treasury (operator)
     transaction.sign(operator_key)
-
     # Sign with adminKey if provided
     if admin_key:
         transaction.sign(admin_key)
-
     try:
-
         # Execute the transaction and get the receipt
         receipt = transaction.execute(client)
-
         if receipt and receipt.tokenId:
             print(f"Finite fungible token created with ID: {receipt.tokenId}")
         else:
             print("Finite fungible token creation failed: Token ID not returned in receipt.")
             sys.exit(1)
-
     except Exception as e:
         print(f"Token creation failed: {str(e)}")
         sys.exit(1)
-
 if __name__ == "__main__":
-    create_token_fungible_finite()
+    create_token_fungible_finite()