feat: Added subscribeTopic method to TopicClient

[manishdait]

This PR introduces subscribeTopic() method to the TopicClient interface, which help to subscribe and listen to the messages received by the specific Hedera Topic.

Key Changes:

• Added getConsensusServiceAddress to NetworkSettings to store the HCS gRPC API inorder to set the mirrorNodeAddress in Client because is because TopicMessageQuery uses the gRPC protocol.

Method Added:

• subscribeTopic(topicId, consumer)
• subscribeTopic(topicId, consumer, limit)
• subscribeTopic(topicId, consumer, startTime, endTime)
• subscribeTopic(topicId, consumer, limit, startTime, endTime)

Closes: #193

[Copilot]

Pull Request Overview

This PR adds subscription functionality to the TopicClient interface, allowing users to subscribe to Hedera topics and listen for incoming messages. The implementation supports various subscription patterns including unlimited subscriptions, limited message counts, and time-bounded subscriptions.

• Introduces subscribeTopic() method with four overloaded variants for different subscription scenarios
• Adds getConsensusServiceAddress() to NetworkSettings to provide gRPC endpoints for mirror node connectivity
• Updates configuration classes to support the new consensus service address field

Reviewed Changes

Copilot reviewed 19 out of 19 changed files in this pull request and generated 10 comments.

Show a summary per file

File	Description
TopicClient.java	Added four overloaded subscribeTopic methods to the interface
TopicClientImpl.java	Implemented subscription methods with parameter validation
NetworkSettings.java	Added getConsensusServiceAddress method to interface
HieroConfig.java	Added consensus service address support and updated client creation
HieroContext.java	Added getMirrorNodeEndPoint method
TopicMessageRequest.java	Added factory methods for different subscription parameter combinations
TopicMessageResult.java	Updated to include SubscriptionHandle
ProtocolLayerClientImpl.java	Updated to return subscription handle from query execution

[Ndacyayisenga-droid]

@manishdait Could you investigate the cause of the build failure? It doesn't appear to be test-related. And tests were fixed so they should pass

[manishdait]

@manishdait Could you investigate the cause of the build failure? It doesn't appear to be test-related. And tests were fixed so they should pass

Hi @Ndacyayisenga-droid,

I have added the missing methodS to EnvBasedHieroConfig and NetworkSettingsBasedHieroConfig which is causing the the build failures and have also updated the test for topicSubscribe() method and added consensusServiceAddress for SoloNetworkTestConfig