add update for did

dids/src/main/kotlin/web5/sdk/dids/methods/dht/DidDht.kt

@@ -97,6 +97,22 @@ public class CreateDidDhtOptions(
   public val alsoKnownAses: Iterable<String>? = null,
 ) : CreateDidOptions
 
+/**
+ * Specifies options for updating a "did:dht" Decentralized Identifier (DID).
+ * Any options not specified will retain the value from the DID being updated, otherwise
+ * the values provided will be set in the DID document.
+ * For example if you wanted to update the services, pass in the full list of `services` you
+ * would like the updated DID Document to contain.
+ *
+ * @property verificationMethods A list of [Jwk]s to add to the DID Document mapped to their purposes
+ * as verification methods, and an optional controller for the verification method.
+ * @property services A list of [Service]s that will be set in the DID Document.
+ * @property publish Whether to publish the DID Document to the DHT after creation.
+ * @property controllers A list of controller DIDs that will be set in the DID Document.
+ * @property alsoKnownAses A list of also known as identifiers to be set in the DID Document.
+ */
+public typealias UpdateDidDhtOptions = CreateDidDhtOptions
+
 private const val PROPERTY_SEPARATOR = ";"
 private const val ARRAY_SEPARATOR = ","
 private val logger = KotlinLogging.logger {}
@@ -202,6 +218,54 @@ public sealed class DidDhtApi(configuration: DidDhtConfiguration) {
     return BearerDid(didUri, did, keyManager, didDocument)
   }
 
+  /**
+   * Updates an existing "did:dht" DID by applying the provided changes to the DID Document.
+   *
+   * @param bearerDid The existing "did:dht" DID to update.
+   * @param options Optional parameters ([UpdateDidDhtOptions]) to specify keys, services, and optional
+   * publishing during the update.
+   * @return The updated [BearerDid] instance.
+   */
+  public fun update(bearerDid: BearerDid, options: UpdateDidDhtOptions): BearerDid {
+    val existingDidDocument = bearerDid.document
+
+    val updatedServices = options.services ?: existingDidDocument.service
+    val updatedControllers = options.controllers ?: existingDidDocument.controller
+    val updatedAlsoKnownAses = options.alsoKnownAses ?: existingDidDocument.alsoKnownAs
+
+    val updatedVerificationMethods = existingDidDocument.verificationMethod?.toMutableList() ?: mutableListOf()
+    options.verificationMethods?.forEach { (publicKey, purposes, controller) ->
+      val verificationMethod = VerificationMethod.Builder()
+        .id("${existingDidDocument.id}#${publicKey.kid ?: publicKey.computeThumbprint()}")
+        .type("JsonWebKey")
+        .controller(controller ?: existingDidDocument.id)
+        .publicKeyJwk(publicKey)
+        .build()
+      updatedVerificationMethods.add(verificationMethod)
+    }
+
+    val updatedDidDocument = DidDocument(
+      existingDidDocument.id,
+      existingDidDocument.context,
+      alsoKnownAs = updatedAlsoKnownAses?.toList(),
+      controller = updatedControllers?.toList(),
+      verificationMethod = updatedVerificationMethods,
+      service = updatedServices?.toList(),
+      assertionMethod = existingDidDocument.assertionMethod,
+      authentication = existingDidDocument.authentication,
+      keyAgreement = existingDidDocument.keyAgreement,
+      capabilityDelegation = existingDidDocument.capabilityDelegation,
+      capabilityInvocation = existingDidDocument.capabilityInvocation
+    )
+
+    val updatedBearerDid = BearerDid(bearerDid.uri, bearerDid.did, bearerDid.keyManager, document = updatedDidDocument)
+
+    if (options.publish) {
+      publish(bearerDid.keyManager, updatedDidDocument)
+    }
+
+    return updatedBearerDid
+  }
   /**
    * Resolves a "did:dht" DID into a [DidResolutionResult], which contains the DID Document and possible related
    * metadata.

dids/src/test/kotlin/web5/sdk/dids/did/BearerDidTest.kt

@@ -8,13 +8,41 @@ import org.mockito.kotlin.spy
 import org.mockito.kotlin.verify
 import org.mockito.kotlin.whenever
 import web5.sdk.crypto.InMemoryKeyManager
+import web5.sdk.dids.didcore.DidDocument
+import web5.sdk.dids.didcore.Service
+import web5.sdk.dids.methods.dht.CreateDidDhtOptions
+import web5.sdk.dids.methods.dht.DidDht
+import web5.sdk.dids.methods.dht.UpdateDidDhtOptions
 import web5.sdk.dids.methods.jwk.DidJwk
 import kotlin.test.Test
+import kotlin.test.assertContains
 import kotlin.test.assertEquals
 import kotlin.test.assertNotNull
 
 class BearerDidTest {
 
+  @Test
+  fun `update service endpoint of existing did`() {
+    val keyManager = InMemoryKeyManager()
+    var myBearerDid = DidDht.create(keyManager, CreateDidDhtOptions(publish = true))
+
+    val existingBearerDid: BearerDid = myBearerDid
+
+    val serviceToUpdate = Service.Builder()
+      .id("pfi")
+      .type("PFI")
+      .serviceEndpoint(listOf("https://example.com/"))
+      .build()
+
+    val updatedBearerDid = DidDht.update(existingBearerDid,
+      UpdateDidDhtOptions(services = listOf(serviceToUpdate)))
+
+    DidDht.publish(updatedBearerDid.keyManager, updatedBearerDid.document)
+
+    assertEquals(1, updatedBearerDid.document.service?.size)
+    assertEquals(serviceToUpdate, updatedBearerDid.document.service?.first())
+  }
+
   @Test
   fun `getSigner should return a signer and verification method`() {
     val keyManager = spy(InMemoryKeyManager())