Update protos to 0.61.0 (#451)

* chore: update protobufs to v0.61.0

Signed-off-by: Ricky Saechao <ricky@launchbadge.com>

* chore: update README.md docs for testing

Signed-off-by: Ricky Saechao <ricky@launchbadge.com>

---------

Signed-off-by: Ricky Saechao <ricky@launchbadge.com>

Author: RickyLB

Package.swift

@@ -115,7 +115,8 @@ let package = Package(
                 .product(name: "GRPC", package: "grpc-swift"),
             ],
             exclude: [
-                "Protos"
+                "Protos",
+                "update_protos.py",
             ]
         ),
         // weird name, but whatever, internal targets

README.md

@@ -1,8 +1,8 @@
 # Hiero Swift SDK
 
-The SDK for interacting with a Hiero based netwrok.
+The SDK for interacting with a Hiero based network.
 
-<sub>Maintained with ❤️ by <a href="https://launchbadge.com" target="_blank">LaunchBadge</a>, <a href="https://www.hashgraph.com/" target="_blank">Hashgraph</a>, and the Hedera community</sub>
+<sub>Maintained with ❤️ by <a href="https://launchbadge.com" target="_blank">LaunchBadge</a>, <a href="https://www.hashgraph.com/" target="_blank">Hashgraph</a>, and the Hiero community</sub>
 
 ## Usage
 
@@ -17,7 +17,7 @@ The SDK for interacting with a Hiero based netwrok.
 ```swift
 // Package.swift
 dependencies: [
-    .package(url: "https://github.com/hiero-project/hiero-sdk-swift.git", from: "1.0.0")
+    .package(url: "https://github.com/hiero-project/hiero-sdk-swift.git", from: "0.36.0")
 ]
 ```
 
@@ -40,44 +40,49 @@ let ab = try await AccountBalanceQuery()
 print("balance = \(ab.balance)")
 ```
 
-See [examples](./Examples) for more usage.
-
-## Development (HederaProtobufs)
+## Development (HieroProtobufs)
 
-HederaProtobufs is entirely generated. The protobufs repo will be migrated to Hiero [in near future](https://github.com/LFDT-Hiero/hiero/blob/main/transition.md).
+HieroProtobufs are entirely generated.
 
 ### Required Tooling
 
 protoc
 protoc-gen-swift (from https://github.com/apple/swift-protobuf)
 protoc-gen-grpc-swift (from https://github.com/grpc/grpc-swift)
 task (from https://github.com/go-task/task)
+openSSL 3.4 (from https://openssl-library.org/source/)
+
+### Fetch Submodule and Generate Swift Protobufs (HieroProtobufs)
 
-### Fetch Submodule (Hedera-Protobufs)
+Update [\protobufs](https://github.com/hiero-ledger/hiero-consensus-node.git) submodule to latest changes.
 
-Update [\protobuf](https://github.com/hashgraph/hedera-protobufs) submodule to latest changes.
 ```bash
-## Fetch the latest version of the services submodule
-## Note: Append "proto=<version>" to fetch a specific version
+# Fetch the latest version of the services submodule
+# and generate swift code for Hiero protobufs and gRPC.
+#
+# Note: Append "proto=vX.Y.Z" to fetch a specific version
 task submodule:fetch 
 
-## Update the submodule to the latest version
-task submodule:install
-
+# e.g. move submodule to v0.61.0 tag
+task submodule:fetch proto=v0.61.0
 ```
 
-### Generate services
+### Examples
+See [examples](./Examples) for more usage.
+
 ```bash
-# cwd: `$REPO`
-protoc --swift_opt=Visibility=Public --swift_opt=FileNaming=PathToUnderscores --swift_out=./Sources/HieroProtobufs/Services --proto_path=./Sources/HieroProtobufs/Protos/services Sources/HieroProtobufs/Protos/services/*.proto
+# Run an example
+$  task example name=<example>
+
+# e.g CreateAccount
+$  task example name=CreateAccount
 
-# generate GRPC (if needed)
-protoc --grpc-swift_opt=Visibility=Public,Server=false --grpc-swift_out=./Sources/HieroProtobufs/Services --proto_path=./Sources/HieroProtobufs/Protos/services Sources/HieroProtobufs/Protos/services/*.proto
 ```
 
-###  Integration Tests
+### Testing
+See [HieroTests](./Tests/HieroTests) and [HieroE2ETests](./Tests/HieroE2ETests)
 
-Before running the integration tests, an operator key, operator account id, and a network name must be set in an `.env` file. 
+Before running the integration tests (e2e)– an operator key, operator account id, and a network name must be set in an `.env` file. Unit tests do not require `.env` to be executed.
 
 ```bash
 # Account that will pay query and transaction fees
@@ -87,18 +92,28 @@ TEST_OPERATOR_KEY=
 # Network names: `"localhost"`, `"testnet"`, `"previewnet"`, `"mainnet"`
 TEST_NETWORK_NAME=
 ```
+
 ```bash
-# Run tests
-$  swift test 
+# Run all unit and e2e tests
+$  swift test
+
+# Run specific tests
+$  swift test --filter <subclass>/<testMethod>
+
+# e.g. AccountCreateTransactionTests/testSerialize (unit test)
+$  swift test --filter AccountCreateTransactionTests/testSerialize
+
+# e.g. AccountCreate/testInitialBalanceAndKey (e2e test) 
+$  swift test --filter AccountCreate/testInitialBalanceAndKey
 ```
 
 The networks testnet, previewnet, and mainnet are the related and publicly available [Hedera networks](https://docs.hedera.com/hedera/networks).
 
+
 ### Local Environment Testing
 
-You can run tests through your localhost using the `hedera-local-node` service.
-For instructions on how to set up and run local node, follow the steps in the [git repository](https://github.com/hashgraph/hedera-local-node).
-The repo will be migrated to Hiero [in near future](https://github.com/LFDT-Hiero/hiero/blob/main/transition.md).
+You can run tests through your localhost using the `hiero-local-node` service.
+For instructions on how to set up and run local node, follow the steps in the [git repository](https://github.com/hiero-ledger/hiero-local-node).
 Once the local node is running in Docker, the appropriate `.env` values must be set:
 
 ```bash

Sources/Hiero/AnyTransaction.swift

@@ -76,6 +76,11 @@ internal enum ServicesTransactionDataList {
     case historyProofKeyPublication(
         [Com_Hedera_Hapi_Services_Auxiliary_History_HistoryProofKeyPublicationTransactionBody])
     case historyProofVote([Com_Hedera_Hapi_Services_Auxiliary_History_HistoryProofVoteTransactionBody])
+    case hintsPreprocessingVote([Com_Hedera_Hapi_Services_Auxiliary_Hints_HintsPreprocessingVoteTransactionBody])
+    case hintsKeyPublication([Com_Hedera_Hapi_Services_Auxiliary_Hints_HintsKeyPublicationTransactionBody])
+    case hintsPartialSignature([Com_Hedera_Hapi_Services_Auxiliary_Hints_HintsPartialSignatureTransactionBody])
+    case crsPublication([Com_Hedera_Hapi_Services_Auxiliary_Hints_CrsPublicationTransactionBody])
+    case atomicBatch([Proto_AtomicBatchTransactionBody])
 
     internal mutating func append(_ transaction: Proto_TransactionBody.OneOf_Data) throws {
         switch (self, transaction) {
@@ -275,6 +280,42 @@ internal enum ServicesTransactionDataList {
             array.append(data)
             self = .tokenCancelAirdrop(array)
 
+        case (.stateSignatureTransaction(var array), .stateSignatureTransaction(let data)):
+            array.append(data)
+            self = .stateSignatureTransaction(array)
+
+        case (.historyProofSignature(var array), .historyProofSignature(let data)):
+            array.append(data)
+            self = .historyProofSignature(array)
+
+        case (.historyProofKeyPublication(var array), .historyProofKeyPublication(let data)):
+            array.append(data)
+            self = .historyProofKeyPublication(array)
+
+        case (.historyProofVote(var array), .historyProofVote(let data)):
+            array.append(data)
+            self = .historyProofVote(array)
+
+        case (.hintsPreprocessingVote(var array), .hintsPreprocessingVote(let data)):
+            array.append(data)
+            self = .hintsPreprocessingVote(array)
+
+        case (.hintsKeyPublication(var array), .hintsKeyPublication(let data)):
+            array.append(data)
+            self = .hintsKeyPublication(array)
+
+        case (.hintsPartialSignature(var array), .hintsPartialSignature(let data)):
+            array.append(data)
+            self = .hintsPartialSignature(array)
+
+        case (.crsPublication(var array), .crsPublication(let data)):
+            array.append(data)
+            self = .crsPublication(array)
+
+        case (.atomicBatch(var array), .atomicBatch(let data)):
+            array.append(data)
+            self = .atomicBatch(array)
+
         default:
             throw HError.fromProtobuf("mismatched transaction types")
         }
@@ -348,11 +389,22 @@ extension ServicesTransactionDataList: TryFromProtobuf {
         case .tokenClaimAirdrop(let data): value = .tokenClaimAirdrop([data])
         case .stateSignatureTransaction:
             throw HError.fromProtobuf("Unsupported transaction `StateSignatureTransaction`")
+        case .hintsPreprocessingVote:
+            throw HError.fromProtobuf("Unsupported transaction `HintsPreprocessingVoteTransaction`")
+        case .hintsKeyPublication:
+            throw HError.fromProtobuf("Unsupported transaction `HintsKeyPublicationTransaction`")
+        case .hintsPartialSignature:
+            throw HError.fromProtobuf("Unsupported transaction `HintsPartialSignatureTransaction`")
         case .historyProofSignature:
-            throw HError.fromProtobuf("Unsupported transaction `HistoryAssemblySignatureTransaction`")
+            throw HError.fromProtobuf("Unsupported transaction `HistoryProofSignatureTransaction`")
         case .historyProofKeyPublication:
             throw HError.fromProtobuf("Unsupported transaction `HistoryProofKeyPublicationTransaction`")
-        case .historyProofVote: throw HError.fromProtobuf("Unsupported transaction `HistoryProofVoteTransaction`")
+        case .historyProofVote:
+            throw HError.fromProtobuf("Unsupported transaction `HistoryProofVoteTransaction`")
+        case .crsPublication:
+            throw HError.fromProtobuf("Unsupported transaction `CrsPublicationTransaction`")
+        case .atomicBatch:
+            throw HError.fromProtobuf("Unsupported transaction `AtomicBatchTransaction`")
         }
 
         for transaction in iter {

Sources/Hiero/FeeSchedule/RequestType.swift

@@ -254,6 +254,15 @@ public enum RequestType {
     /// State signature transaction
     case stateSignatureTransaction
 
+    /// Hints preprocessing vote transaction
+    case hintsPreprocessingVote
+
+    /// Hints key publication transaction
+    case hintsKeyPublication
+
+    /// Hints partial signature transaction
+    case hintsPartialSignature
+
     /// History assembly signature
     case historyAssemblySignature
 
@@ -263,6 +272,12 @@ public enum RequestType {
     /// History proof vote
     case historyProofVote
 
+    /// CRS publication transaction
+    case crsPublication
+
+    /// Atomic batch transaction
+    case atomicBatch
+
     // swiftlint:disable:next function_body_length
     internal init?(protobuf proto: Proto_HederaFunctionality) throws {
         switch proto {
@@ -349,9 +364,14 @@ public enum RequestType {
         case .tokenCancelAirdrop: self = .tokenCancelAirdrop
         case .tokenClaimAirdrop: self = .tokenClaimAirdrop
         case .stateSignatureTransaction: self = .stateSignatureTransaction
+        case .hintsPreprocessingVote: self = .hintsPreprocessingVote
+        case .hintsKeyPublication: self = .hintsKeyPublication
+        case .hintsPartialSignature: self = .hintsPartialSignature
         case .historyAssemblySignature: self = .historyAssemblySignature
         case .historyProofKeyPublication: self = .historyProofKeyPublication
         case .historyProofVote: self = .historyProofVote
+        case .crsPublication: self = .crsPublication
+        case .atomicBatch: self = .atomicBatch
         case .UNRECOGNIZED(let code):
             throw HError.fromProtobuf("unrecognized RequestType: `\(code)`")
         }
@@ -441,9 +461,14 @@ public enum RequestType {
         case .tokenCancelAirdrop: return .tokenCancelAirdrop
         case .tokenClaimAirdrop: return .tokenClaimAirdrop
         case .stateSignatureTransaction: return .stateSignatureTransaction
+        case .hintsPreprocessingVote: return .hintsPreprocessingVote
+        case .hintsKeyPublication: return .hintsKeyPublication
+        case .hintsPartialSignature: return .hintsPartialSignature
         case .historyAssemblySignature: return .historyAssemblySignature
         case .historyProofKeyPublication: return .historyProofKeyPublication
         case .historyProofVote: return .historyProofVote
+        case .crsPublication: return .crsPublication
+        case .atomicBatch: return .atomicBatch
         }
     }
 }

Sources/Hiero/Transaction/Transaction+FromProtobuf.swift

@@ -215,6 +215,15 @@ extension Transaction {
         case .stateSignatureTransaction(let code):
             throw HError.fromProtobuf("unrecognized: stateSignatureTransaction `\(code)`")
 
+        case .hintsPreprocessingVote(let code):
+            throw HError.fromProtobuf("unrecognized: hintsPreprocessingVote `\(code)`")
+
+        case .hintsKeyPublication(let code):
+            throw HError.fromProtobuf("unrecognized: hintsKeyPublication `\(code)`")
+
+        case .hintsPartialSignature(let code):
+            throw HError.fromProtobuf("unrecognized: hintsPartialSignature `\(code)`")
+
         case .historyProofSignature(let code):
             throw HError.fromProtobuf("unrecognized: historyProofSignature `\(code)`")
 
@@ -223,6 +232,12 @@ extension Transaction {
 
         case .historyProofVote(let code):
             throw HError.fromProtobuf("unrecognized: historyProofVote `\(code)`")
+
+        case .crsPublication(let code):
+            throw HError.fromProtobuf("unrecognized: crsPublication `\(code)`")
+
+        case .atomicBatch(let code):
+            throw HError.fromProtobuf("unrecognized: atomicBatch `\(code)`")
         }
     }
 }