feat: add FileUpdateTransaction (#220)

* feat: add FileUpdateTransaction

Signed-off-by: dosi <[email protected]>

* test: add FileUpdateTransaction integration tests

Signed-off-by: dosi <[email protected]>

* test: add FileUpdateTransaction unit tests

Signed-off-by: dosi <[email protected]>

* docs: add token update example

Signed-off-by: dosi <[email protected]>

* docs: update README with FileUpdateTransaction

Signed-off-by: dosi <[email protected]>

* chore: add FileUpdateTransaction to __init__.py

Signed-off-by: dosi <[email protected]>

---------

Signed-off-by: dosi <[email protected]>

Author: Dosik13

examples/README.md

@@ -50,6 +50,7 @@ You can choose either syntax or even mix both styles in your projects.
   - [Creating a File](#creating-a-file)
   - [Querying File Info](#querying-file-info)
   - [Querying File Contents](#querying-file-contents)
+  - [Updating a File](#updating-a-file)
   - [Deleting a File](#deleting-a-file)
 - [Miscellaneous Queries](#miscellaneous-queries)
   - [Querying Transaction Record](#querying-transaction-record)
@@ -186,8 +187,8 @@ transaction = TokenMintTransaction(
     amount=amount,  # lowest denomination, must be positive and not zero
 ).freeze_with(client)
 
-transaction.sign(operator_key)  
-transaction.sign(supply_key)  
+transaction.sign(operator_key)
+transaction.sign(supply_key)
 transaction.execute(client)
 ```
 #### Method Chaining:
@@ -198,8 +199,8 @@ transaction = (
     .set_amount(amount) # lowest denomination, must be positive and not zero
     .freeze_with(client)
 )
-transaction.sign(operator_key)  
-transaction.sign(admin_key)  
+transaction.sign(operator_key)
+transaction.sign(admin_key)
 transaction.execute(client)
 ```
 
@@ -212,8 +213,8 @@ transaction = TokenMintTransaction(
     metadata=metadata  # Bytes for non-fungible tokens (NFTs)
 ).freeze_with(client)
 
-transaction.sign(operator_key)  
-transaction.sign(supply_key)  
+transaction.sign(operator_key)
+transaction.sign(supply_key)
 transaction.execute(client)
 ```
 #### Method Chaining:
@@ -224,8 +225,8 @@ transaction = (
     .set_metadata(metadata)  # Bytes for non-fungible tokens (NFTs)
     .freeze_with(client)
 )
-transaction.sign(operator_key)  
-transaction.sign(admin_key)  
+transaction.sign(operator_key)
+transaction.sign(admin_key)
 transaction.execute(client)
 ```
 
@@ -286,8 +287,8 @@ transaction = (
 transaction = TransferTransaction(
     token_transfers={
         token_id: {
-            operator_id: -amount,  
-            recipient_id: amount   
+            operator_id: -amount,
+            recipient_id: amount
         }
     }
 ).freeze_with(client)
@@ -560,7 +561,7 @@ transaction.execute(client)
     transaction = (
         TokenUpdateNftsTransaction()
         .set_token_id(nft_token_id)
-        .set_serial_numbers(serial_numbers) 
+        .set_serial_numbers(serial_numbers)
         .set_metadata(new_metadata)
         .freeze_with(client)
         .sign(metadata_key)
@@ -628,7 +629,7 @@ transaction = TokenUpdateTransaction(
     token_id=token_id,
     token_params=TokenUpdateParams(
         token_name="UpdateToken",
-        token_symbol="UPD", 
+        token_symbol="UPD",
         token_memo="Updated memo",
         metadata="Updated metadata",
         treasury_account_id=new_account_id
@@ -751,7 +752,7 @@ transaction.execute(client)
     transaction = (
         TransferTransaction()
         .add_hbar_transfer(operator_id, -100000000)  # send 1 HBAR (in tinybars)
-        .add_hbar_transfer(recipient_id, 100000000)  
+        .add_hbar_transfer(recipient_id, 100000000)
         .freeze_with(client)
     )
 
@@ -776,7 +777,7 @@ transaction.execute(client)
     transaction.execute(client)
 ```
 #### Method Chaining:
-``` 
+```
 transaction = (
     TopicCreateTransaction()
     .set_memo("My Super Topic Memo")
@@ -904,10 +905,10 @@ query.subscribe(client)
 ```
 query = (
     TopicMessageQuery()
-    .set_topic_id(topic_id) 
-    .set_start_time(datetime.now(timezone.utc)) 
-    .set_chunking_enabled(True) 
-    .set_limit(0) 
+    .set_topic_id(topic_id)
+    .set_start_time(datetime.now(timezone.utc))
+    .set_chunking_enabled(True)
+    .set_limit(0)
     )
 
 query.subscribe(client)
@@ -984,6 +985,39 @@ print(str(file_contents)) # decode bytes to string
 
 ```
 
+### Updating a File
+
+#### Pythonic Syntax:
+```
+transaction = FileUpdateTransaction(
+    file_id=file_id,
+    keys=[new_file_public_key],
+    contents=b"New File Contents",
+    file_memo="Updated file memo"
+).freeze_with(client)
+
+transaction.sign(current_file_private_key)
+transaction.sign(new_file_private_key)
+transaction.execute(client)
+```
+
+#### Method Chaining:
+```
+    transaction = (
+        FileUpdateTransaction()
+        .set_file_id(file_id)
+        .set_keys([new_file_public_key])
+        .set_contents(b"New File Contents")
+        .set_file_memo("Updated file memo")
+        .freeze_with(client)
+        .sign(current_file_private_key)
+        .sign(new_file_private_key)
+    )
+
+    transaction.execute(client)
+
+```
+
 ### Deleting a File
 
 #### Pythonic Syntax:
@@ -1040,4 +1074,4 @@ print(f"Transaction Fee: {record.transaction_fee}")
 print(f"Transaction Hash: {record.transaction_hash}")
 print(f"Transaction Memo: {record.transaction_memo}")
 print(f"Transaction Account ID: {record.receipt.account_id}")
-```
+```

examples/file_update.py

@@ -0,0 +1,101 @@
+import os
+import sys
+
+from dotenv import load_dotenv
+
+from hiero_sdk_python import AccountId, Client, Network, PrivateKey
+from hiero_sdk_python.file.file_create_transaction import FileCreateTransaction
+from hiero_sdk_python.file.file_info_query import FileInfoQuery
+from hiero_sdk_python.file.file_update_transaction import FileUpdateTransaction
+from hiero_sdk_python.response_code import ResponseCode
+
+load_dotenv()
+
+
+def setup_client():
+    """Initialize and set up the client with operator account"""
+    network = Network(network="testnet")
+    client = Client(network)
+
+    operator_id = AccountId.from_string(os.getenv("OPERATOR_ID"))
+    operator_key = PrivateKey.from_string(os.getenv("OPERATOR_KEY"))
+    client.set_operator(operator_id, operator_key)
+
+    return client
+
+
+def create_file(client):
+    """Create a test file"""
+    file_private_key = PrivateKey.generate_ed25519()
+
+    receipt = (
+        FileCreateTransaction()
+        .set_keys(file_private_key.public_key())
+        .set_contents(b"Hello, this is a test file for querying!")
+        .set_file_memo("Test file for query")
+        .freeze_with(client)
+        .sign(file_private_key)
+        .execute(client)
+    )
+
+    if receipt.status != ResponseCode.SUCCESS:
+        print(f"File creation failed with status: {ResponseCode(receipt.status).name}")
+        sys.exit(1)
+
+    file_id = receipt.file_id
+    print(f"\nFile created with ID: {file_id}")
+
+    return file_id, file_private_key
+
+
+def query_file_info(client, file_id):
+    info = FileInfoQuery().set_file_id(file_id).execute(client)
+
+    print(info)
+
+
+def file_update():
+    """
+    Demonstrates querying file info by:
+    1. Setting up client with operator account
+    2. Creating a test file
+    3. Querying the file info
+    4. Updating the file info
+    5. Querying the file info again
+    """
+    client = setup_client()
+
+    # Create a test file first
+    file_id, file_private_key = create_file(client)
+
+    print("File info before update:")
+    # Query the file info
+    query_file_info(client, file_id)
+
+    # Generate a new private key that will add to the existing key
+    new_private_key = PrivateKey.generate_ed25519()
+
+    # Update the file
+    receipt = (
+        FileUpdateTransaction()
+        .set_file_id(file_id)
+        .set_keys([file_private_key.public_key(), new_private_key.public_key()])
+        .set_contents(b"Updated contents!")
+        .set_file_memo("Updated memo!")
+        .freeze_with(client)
+        .sign(new_private_key)
+        .sign(file_private_key)
+        .execute(client)
+    )
+
+    if receipt.status != ResponseCode.SUCCESS:
+        print(f"File update failed with status: {ResponseCode(receipt.status).name}")
+        sys.exit(1)
+
+    print("File info after update:")
+    # Query the file info again
+    query_file_info(client, file_id)
+
+
+if __name__ == "__main__":
+    file_update()

src/hiero_sdk_python/__init__.py

@@ -85,6 +85,7 @@
 from .file.file_info_query import FileInfoQuery
 from .file.file_info import FileInfo
 from .file.file_contents_query import FileContentsQuery
+from .file.file_update_transaction import FileUpdateTransaction
 from .file.file_delete_transaction import FileDeleteTransaction
 
 __all__ = [
@@ -171,5 +172,6 @@
     "FileInfoQuery",
     "FileInfo",
     "FileContentsQuery",
+    "FileUpdateTransaction",
     "FileDeleteTransaction",
 ]