Update Documentation Files

Author: sraptis-scy

README.md

@@ -221,12 +221,29 @@ val customWallet = EudiWallet(context, config) {
     withTransactionLogger(myTransactionLogger)
     // custom document status resolver
     withDocumentStatusResolver(myDocumentStatusResolver)
+    // custom wallet key manager
+    withWalletKeyManager(myWalletKeyManager)
 }
 ```
 
 See the [CustomizeSecureArea.md](CustomizeSecureArea.md) for more information on how to use the
 wallet-core library with custom SecureArea implementations.
 
+
+#### WalletKeyManager Configuration
+This interface is responsible for managing Attestation Keys used during Attestation Based Client Authentication with OpenId4Vci.
+The library provides `SecureAreaWalletKeyManager`, an extensible SecureArea based implementation of this interface.
+If no configuration is provided for a custom `WalletKeyManager` the default implementation of the library will be used based on `AndroidKeystoreSecureArea`.
+You can provide your custom `WalletKeyManager` by configuring the `EudiWallet` instance:
+```kotlin
+val customWallet = EudiWallet(context, config) {
+    // rest of configurations
+    // ......................
+    // custom wallet key manager
+    withWalletKeyManager(myWalletKeyManager)
+}
+```
+
 #### Configure EudiWallet for Attestation Based Client Authentication(WIA) and Wallet Unit Attestation(WUA) with a Wallet Provider
 The wallet-core supports Wallet Instance Attestation (WIA) that attests the integrity of the app & Wallet Unit Attestation (WUA) that attests the security of keys stored in the Wallet Unit.
 You can optionally configure your wallet with this capability by implementing the core's `WalletAttestationsProvider` interface which bridges your wallet-specific Wallet Provider to the core.
@@ -259,6 +276,7 @@ val walletAttestationsProvider = object : WalletAttestationsProvider {
     }
 }
 ```
+
 So the configuration of the EudiWallet documented in the above section would now be:
 ```kotlin
 val wallet = EudiWallet(
@@ -270,6 +288,7 @@ val wallet = EudiWallet(
 
 **NOTE:** When Attestation Based Client Authentication is configured for OpendId4Vci, the `EudiWallet` must also be instantiated with a WalletProvider
 
+
 ### Manage documents
 
 The library provides a set of methods to work with documents.

docs/wallet-core/eu.europa.ec.eudi.wallet.issue.openid4vci/-deferred-issuance-stored-context-t-o/index.md

@@ -44,4 +44,4 @@ data class [DeferredIssuanceStoredContextTO](index.md)(val credentialIssuerId: [
 
 | Name | Summary |
 |---|---|
-| [toDeferredIssuanceStoredContext](to-deferred-issuance-stored-context.md) | [androidJvm]<br>fun [toDeferredIssuanceStoredContext](to-deferred-issuance-stored-context.md)(clock: [Clock](https://developer.android.com/reference/kotlin/java/time/Clock.html), recreatePopSigner: ([String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin-stdlib/kotlin/-string/index.html)) -&gt; Signer&lt;JWK&gt;?, recreateClientAttestationPodSigner: ([String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin-stdlib/kotlin/-string/index.html)) -&gt; Signer&lt;JWK&gt;?): DeferredIssuanceContext |
+| [toDeferredIssuanceStoredContext](to-deferred-issuance-stored-context.md) | [androidJvm]<br>fun [toDeferredIssuanceStoredContext](to-deferred-issuance-stored-context.md)(clock: [Clock](https://developer.android.com/reference/kotlin/java/time/Clock.html), recreatePopSigner: ([String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin-stdlib/kotlin/-string/index.html)) -&gt; Signer&lt;JWK&gt;?, walletKeyManager: [WalletKeyManager](../../eu.europa.ec.eudi.wallet.provider/-wallet-key-manager/index.md)): DeferredIssuanceContext |

docs/wallet-core/eu.europa.ec.eudi.wallet.issue.openid4vci/-deferred-issuance-stored-context-t-o/to-deferred-issuance-stored-context.md

@@ -3,4 +3,4 @@
 # toDeferredIssuanceStoredContext
 
 [androidJvm]\
-fun [toDeferredIssuanceStoredContext](to-deferred-issuance-stored-context.md)(clock: [Clock](https://developer.android.com/reference/kotlin/java/time/Clock.html), recreatePopSigner: ([String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin-stdlib/kotlin/-string/index.html)) -> Signer<JWK>?, recreateClientAttestationPodSigner: ([String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin-stdlib/kotlin/-string/index.html)) -> Signer<JWK>?): DeferredIssuanceContext
+fun [toDeferredIssuanceStoredContext](to-deferred-issuance-stored-context.md)(clock: [Clock](https://developer.android.com/reference/kotlin/java/time/Clock.html), recreatePopSigner: ([String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin-stdlib/kotlin/-string/index.html)) -> Signer<JWK>?, walletKeyManager: [WalletKeyManager](../../eu.europa.ec.eudi.wallet.provider/-wallet-key-manager/index.md)): DeferredIssuanceContext

docs/wallet-core/eu.europa.ec.eudi.wallet.provider/-default-wallet-key-manager/get-or-create-wallet-attestation-key.md

@@ -0,0 +1,23 @@
+//[wallet-core](../../../index.md)/[eu.europa.ec.eudi.wallet.provider](../index.md)/[DefaultWalletKeyManager](index.md)/[getOrCreateWalletAttestationKey](get-or-create-wallet-attestation-key.md)
+
+# getOrCreateWalletAttestationKey
+
+[androidJvm]\
+open suspend override fun [getOrCreateWalletAttestationKey](get-or-create-wallet-attestation-key.md)(authorizationServerUrl: [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin-stdlib/kotlin/-string/index.html), supportedAlgorithms: [List](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin-stdlib/kotlin.collections/-list/index.html)<Algorithm>): [Result](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin-stdlib/kotlin/-result/index.html)<[WalletAttestationKey](../-wallet-attestation-key/index.md)>
+
+Retrieves or creates a signing key to be used for Wallet Attestation (Client Authentication). The Wallet Attestation Keys must be distinct for different Authorization Servers but unique for a specific one, and should be stored for subsequent use with the same Authorization Server
+
+The implementation should ensure that the returned key is compatible with one of the [supportedAlgorithms](get-or-create-wallet-attestation-key.md) required by the Authorization Server.
+
+#### Return
+
+A [Result](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin-stdlib/kotlin/-result/index.html) containing the [WalletAttestationKey](../-wallet-attestation-key/index.md), which includes the public key info and a mechanism to sign data.
+
+#### Parameters
+
+androidJvm
+
+| | |
+|---|---|
+| authorizationServerUrl | The URL of the Authorization Server. |
+| supportedAlgorithms | A list of cryptographic algorithms supported by the Authorization Server. The returned key must use one of these algorithms. |

docs/wallet-core/eu.europa.ec.eudi.wallet.provider/-default-wallet-key-manager/get-wallet-attestation-key.md

@@ -3,21 +3,18 @@
 # getWalletAttestationKey
 
 [androidJvm]\
-open suspend override fun [getWalletAttestationKey](get-wallet-attestation-key.md)(authorizationServerUrl: [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin-stdlib/kotlin/-string/index.html), supportedAlgorithms: [List](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin-stdlib/kotlin.collections/-list/index.html)<Algorithm>): [Result](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin-stdlib/kotlin/-result/index.html)<[WalletAttestationKey](../-wallet-attestation-key/index.md)>
+open suspend override fun [getWalletAttestationKey](get-wallet-attestation-key.md)(keyAlias: [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin-stdlib/kotlin/-string/index.html)): [WalletAttestationKey](../-wallet-attestation-key/index.md)?
 
-Retrieves or creates a signing key to be used for Wallet Attestation (Client Authentication). The Wallet Attestation Keys must be distinct for different Authorization Servers but unique for a specific one, and should be stored for subsequent use with the same Authorization Server
-
-The implementation should ensure that the returned key is compatible with one of the [supportedAlgorithms](get-wallet-attestation-key.md) required by the Authorization Server.
+Retrieves the existing Wallet Attestation Key for the specified Authorization Server URL. If no key exists for the given Authorization Server, it returns null.
 
 #### Return
 
-A [Result](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin-stdlib/kotlin/-result/index.html) containing the [WalletAttestationKey](../-wallet-attestation-key/index.md), which includes the public key info and a mechanism to sign data.
+The existing [WalletAttestationKey](../-wallet-attestation-key/index.md) or null if not found.
 
 #### Parameters
 
 androidJvm
 
 | | |
 |---|---|
-| authorizationServerUrl | The URL of the Authorization Server. |
-| supportedAlgorithms | A list of cryptographic algorithms supported by the Authorization Server. The returned key must use one of these algorithms. |
+| keyAlias | The URL of the Authorization Server. |

docs/wallet-core/eu.europa.ec.eudi.wallet.provider/-default-wallet-key-manager/index.md

@@ -26,4 +26,5 @@ androidJvm
 
 | Name | Summary |
 |---|---|
-| [getWalletAttestationKey](get-wallet-attestation-key.md) | [androidJvm]<br>open suspend override fun [getWalletAttestationKey](get-wallet-attestation-key.md)(authorizationServerUrl: [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin-stdlib/kotlin/-string/index.html), supportedAlgorithms: [List](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin-stdlib/kotlin.collections/-list/index.html)&lt;Algorithm&gt;): [Result](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin-stdlib/kotlin/-result/index.html)&lt;[WalletAttestationKey](../-wallet-attestation-key/index.md)&gt;<br>Retrieves or creates a signing key to be used for Wallet Attestation (Client Authentication). The Wallet Attestation Keys must be distinct for different Authorization Servers but unique for a specific one, and should be stored for subsequent use with the same Authorization Server |
+| [getOrCreateWalletAttestationKey](get-or-create-wallet-attestation-key.md) | [androidJvm]<br>open suspend override fun [getOrCreateWalletAttestationKey](get-or-create-wallet-attestation-key.md)(authorizationServerUrl: [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin-stdlib/kotlin/-string/index.html), supportedAlgorithms: [List](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin-stdlib/kotlin.collections/-list/index.html)&lt;Algorithm&gt;): [Result](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin-stdlib/kotlin/-result/index.html)&lt;[WalletAttestationKey](../-wallet-attestation-key/index.md)&gt;<br>Retrieves or creates a signing key to be used for Wallet Attestation (Client Authentication). The Wallet Attestation Keys must be distinct for different Authorization Servers but unique for a specific one, and should be stored for subsequent use with the same Authorization Server |
+| [getWalletAttestationKey](get-wallet-attestation-key.md) | [androidJvm]<br>open suspend override fun [getWalletAttestationKey](get-wallet-attestation-key.md)(keyAlias: [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin-stdlib/kotlin/-string/index.html)): [WalletAttestationKey](../-wallet-attestation-key/index.md)?<br>Retrieves the existing Wallet Attestation Key for the specified Authorization Server URL. If no key exists for the given Authorization Server, it returns null. |

docs/wallet-core/eu.europa.ec.eudi.wallet.provider/-secure-area-wallet-key-manager/get-or-create-wallet-attestation-key.md

@@ -0,0 +1,23 @@
+//[wallet-core](../../../index.md)/[eu.europa.ec.eudi.wallet.provider](../index.md)/[SecureAreaWalletKeyManager](index.md)/[getOrCreateWalletAttestationKey](get-or-create-wallet-attestation-key.md)
+
+# getOrCreateWalletAttestationKey
+
+[androidJvm]\
+open suspend override fun [getOrCreateWalletAttestationKey](get-or-create-wallet-attestation-key.md)(authorizationServerUrl: [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin-stdlib/kotlin/-string/index.html), supportedAlgorithms: [List](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin-stdlib/kotlin.collections/-list/index.html)<Algorithm>): [Result](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin-stdlib/kotlin/-result/index.html)<[WalletAttestationKey](../-wallet-attestation-key/index.md)>
+
+Retrieves or creates a signing key to be used for Wallet Attestation (Client Authentication). The Wallet Attestation Keys must be distinct for different Authorization Servers but unique for a specific one, and should be stored for subsequent use with the same Authorization Server
+
+The implementation should ensure that the returned key is compatible with one of the [supportedAlgorithms](get-or-create-wallet-attestation-key.md) required by the Authorization Server.
+
+#### Return
+
+A [Result](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin-stdlib/kotlin/-result/index.html) containing the [WalletAttestationKey](../-wallet-attestation-key/index.md), which includes the public key info and a mechanism to sign data.
+
+#### Parameters
+
+androidJvm
+
+| | |
+|---|---|
+| authorizationServerUrl | The URL of the Authorization Server. |
+| supportedAlgorithms | A list of cryptographic algorithms supported by the Authorization Server. The returned key must use one of these algorithms. |

docs/wallet-core/eu.europa.ec.eudi.wallet.provider/-secure-area-wallet-key-manager/get-wallet-attestation-key.md

@@ -3,21 +3,18 @@
 # getWalletAttestationKey
 
 [androidJvm]\
-open suspend override fun [getWalletAttestationKey](get-wallet-attestation-key.md)(authorizationServerUrl: [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin-stdlib/kotlin/-string/index.html), supportedAlgorithms: [List](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin-stdlib/kotlin.collections/-list/index.html)<Algorithm>): [Result](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin-stdlib/kotlin/-result/index.html)<[WalletAttestationKey](../-wallet-attestation-key/index.md)>
+open suspend override fun [getWalletAttestationKey](get-wallet-attestation-key.md)(keyAlias: [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin-stdlib/kotlin/-string/index.html)): [WalletAttestationKey](../-wallet-attestation-key/index.md)?
 
-Retrieves or creates a signing key to be used for Wallet Attestation (Client Authentication). The Wallet Attestation Keys must be distinct for different Authorization Servers but unique for a specific one, and should be stored for subsequent use with the same Authorization Server
-
-The implementation should ensure that the returned key is compatible with one of the [supportedAlgorithms](get-wallet-attestation-key.md) required by the Authorization Server.
+Retrieves the existing Wallet Attestation Key for the specified Authorization Server URL. If no key exists for the given Authorization Server, it returns null.
 
 #### Return
 
-A [Result](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin-stdlib/kotlin/-result/index.html) containing the [WalletAttestationKey](../-wallet-attestation-key/index.md), which includes the public key info and a mechanism to sign data.
+The existing [WalletAttestationKey](../-wallet-attestation-key/index.md) or null if not found.
 
 #### Parameters
 
 androidJvm
 
 | | |
 |---|---|
-| authorizationServerUrl | The URL of the Authorization Server. |
-| supportedAlgorithms | A list of cryptographic algorithms supported by the Authorization Server. The returned key must use one of these algorithms. |
+| keyAlias | The URL of the Authorization Server. |

docs/wallet-core/eu.europa.ec.eudi.wallet.provider/-secure-area-wallet-key-manager/index.md

@@ -28,4 +28,5 @@ androidJvm
 
 | Name | Summary |
 |---|---|
-| [getWalletAttestationKey](get-wallet-attestation-key.md) | [androidJvm]<br>open suspend override fun [getWalletAttestationKey](get-wallet-attestation-key.md)(authorizationServerUrl: [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin-stdlib/kotlin/-string/index.html), supportedAlgorithms: [List](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin-stdlib/kotlin.collections/-list/index.html)&lt;Algorithm&gt;): [Result](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin-stdlib/kotlin/-result/index.html)&lt;[WalletAttestationKey](../-wallet-attestation-key/index.md)&gt;<br>Retrieves or creates a signing key to be used for Wallet Attestation (Client Authentication). The Wallet Attestation Keys must be distinct for different Authorization Servers but unique for a specific one, and should be stored for subsequent use with the same Authorization Server |
+| [getOrCreateWalletAttestationKey](get-or-create-wallet-attestation-key.md) | [androidJvm]<br>open suspend override fun [getOrCreateWalletAttestationKey](get-or-create-wallet-attestation-key.md)(authorizationServerUrl: [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin-stdlib/kotlin/-string/index.html), supportedAlgorithms: [List](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin-stdlib/kotlin.collections/-list/index.html)&lt;Algorithm&gt;): [Result](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin-stdlib/kotlin/-result/index.html)&lt;[WalletAttestationKey](../-wallet-attestation-key/index.md)&gt;<br>Retrieves or creates a signing key to be used for Wallet Attestation (Client Authentication). The Wallet Attestation Keys must be distinct for different Authorization Servers but unique for a specific one, and should be stored for subsequent use with the same Authorization Server |
+| [getWalletAttestationKey](get-wallet-attestation-key.md) | [androidJvm]<br>open suspend override fun [getWalletAttestationKey](get-wallet-attestation-key.md)(keyAlias: [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin-stdlib/kotlin/-string/index.html)): [WalletAttestationKey](../-wallet-attestation-key/index.md)?<br>Retrieves the existing Wallet Attestation Key for the specified Authorization Server URL. If no key exists for the given Authorization Server, it returns null. |

docs/wallet-core/eu.europa.ec.eudi.wallet.provider/-wallet-key-manager/get-or-create-wallet-attestation-key.md

@@ -0,0 +1,23 @@
+//[wallet-core](../../../index.md)/[eu.europa.ec.eudi.wallet.provider](../index.md)/[WalletKeyManager](index.md)/[getOrCreateWalletAttestationKey](get-or-create-wallet-attestation-key.md)
+
+# getOrCreateWalletAttestationKey
+
+[androidJvm]\
+abstract suspend fun [getOrCreateWalletAttestationKey](get-or-create-wallet-attestation-key.md)(authorizationServerUrl: [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin-stdlib/kotlin/-string/index.html), supportedAlgorithms: [List](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin-stdlib/kotlin.collections/-list/index.html)<Algorithm>): [Result](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin-stdlib/kotlin/-result/index.html)<[WalletAttestationKey](../-wallet-attestation-key/index.md)>
+
+Retrieves or creates a signing key to be used for Wallet Attestation (Client Authentication). The Wallet Attestation Keys must be distinct for different Authorization Servers but unique for a specific one, and should be stored for subsequent use with the same Authorization Server
+
+The implementation should ensure that the returned key is compatible with one of the [supportedAlgorithms](get-or-create-wallet-attestation-key.md) required by the Authorization Server.
+
+#### Return
+
+A [Result](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin-stdlib/kotlin/-result/index.html) containing the [WalletAttestationKey](../-wallet-attestation-key/index.md), which includes the public key info and a mechanism to sign data.
+
+#### Parameters
+
+androidJvm
+
+| | |
+|---|---|
+| authorizationServerUrl | The URL of the Authorization Server. |
+| supportedAlgorithms | A list of cryptographic algorithms supported by the Authorization Server. The returned key must use one of these algorithms. |