Merge branch 'master' into DCKW-775-SDK-developer-only-has-to-provide…

…-a-single-cloud-wallet-key

docs/cloud-wallet.md

@@ -106,6 +106,33 @@ const document = {
 await wallet.addDocument(document);
 ```
 
+### Issuing Credentials to Cloud Wallet
+
+You can issue credentials directly to a cloud wallet using the Truvera Workspace/API. The credential will be automatically distributed to the holder's cloud wallet through the DIDComm protocol, eliminating the need for direct API calls or manual credential handling.
+
+#### Important Requirement
+
+For the DIDComm automatic distribution to work properly, the **subject ID of the credential must be set to the holder's DID** when issuing the credential. This enables the system to route the credential to the correct wallet.
+
+#### Receiving Credentials in Cloud Wallet
+
+After a credential has been issued to a holder's DID, the cloud wallet only needs to fetch and process DIDComm messages to receive it:
+
+```ts
+import {createDIDProvider} from '@docknetwork/wallet-sdk-core/lib/did-provider';
+import {createMessageProvider} from '@docknetwork/wallet-sdk-core/lib/message-provider';
+
+const didProvider = createDIDProvider({ wallet });
+
+const messageProvider = createMessageProvider({
+  wallet,
+  didProvider,
+});
+
+// This will process the messages for all the DIDs in the wallet
+await messageProvider.fetchMessages();
+await messageProvider.processDIDCommMessages();
+```
 
 ### Full Example