@did-btcr2/api 0.5.0 → 0.8.0

package/dist/cjs/index.js

@@ -1242,14 +1242,14 @@ var CasApi = class {
   }
 };
 
-// src/kms.ts
-var import_kms = require("@did-btcr2/kms");
+// src/key-manager.ts
+var import_key_manager = require("@did-btcr2/key-manager");
 var KeyManagerApi = class {
   /** The backing KeyManager instance. */
   kms;
   /** Create a new KeyManagerApi, optionally backed by a custom KeyManager. */
   constructor(kms) {
-    this.kms = kms ?? new import_kms.Kms();
+    this.kms = kms ?? new import_key_manager.LocalKeyManager();
   }
   /** Generate a new key directly in the KMS. */
   generateKey(options) {
@@ -1269,13 +1269,17 @@ var KeyManagerApi = class {
   }
   /**
    * Export a Schnorr keypair from the KMS.
-   * Only supported when the backing KMS is the built-in {@link Kms} class.
-   * @throws {Error} If the backing KMS does not support key export.
+   * Routes through the KeyManager's declared capability (`canExport`) rather
+   * than an `instanceof LocalKeyManager` check, so third-party adapters can
+   * opt in to export support without coupling to a specific implementation.
+   * External adapters (AWS, Vault, HSM) typically advertise `canExport: false`.
+   * @throws {Error} If the backing KeyManager does not advertise canExport=true,
+   *   or omits the optional `exportKey` method.
    */
   export(id) {
-    if (!(this.kms instanceof import_kms.Kms)) {
+    if (!this.kms.canExport || !this.kms.exportKey) {
       throw new Error(
-        "Key export is not supported by the current KeyManager implementation. Export is only available with the built-in Kms class."
+        "Key export is not supported by the current KeyManager implementation. The adapter must advertise `canExport: true` and provide an `exportKey` method."
       );
     }
     return this.kms.exportKey(id);
@@ -1292,13 +1296,13 @@ var KeyManagerApi = class {
    * Sign data via the KMS.
    * @param data The data to sign (must be non-empty).
    * @param id Optional key identifier; uses the active key if omitted.
-   * @param options Signing options (scheme defaults to 'schnorr').
+   * @param options Signing options. Defaults: `scheme: 'bip340'`.
    */
   sign(data, id, options) {
     assertBytes(data, "data");
     return this.kms.sign(data, id, options);
   }
-  /** Verify a signature via the KMS. */
+  /** Verify a signature via the KMS. Defaults: `scheme: 'bip340'`. */
   verify(signature, data, id, options) {
     return this.kms.verify(signature, data, id, options);
   }
@@ -1892,8 +1896,16 @@ var DidMethodApi = class {
     }
   }
   /**
-   * Update an existing DID document. If a Bitcoin connection is configured on
-   * the API, it is injected automatically.
+   * Update an existing DID document by driving the sans-I/O {@link Updater} state
+   * machine (from @did-btcr2/method). This method handles the I/O side:
+   * - Signing: supplies the {@link Signer} to `NeedSigningKey`.
+   * - Broadcast: establishes a beacon via {@link BeaconFactory} and calls
+   *   `broadcastSignal()` with the bitcoin connection configured on the API.
+   *
+   * For multi-party aggregation of SMT/CAS beacons, the caller should drive the
+   * Updater directly and delegate `NeedBroadcast` to the aggregation runner
+   * rather than using this high-level method.
+   *
    * @param params The update parameters.
    * @returns The signed update.
    */
@@ -1903,19 +1915,64 @@ var DidMethodApi = class {
     sourceVersionId,
     verificationMethodId,
     beaconId,
-    signingMaterial,
+    signer,
     bitcoin
   }) {
-    const btcConnection = bitcoin ?? this.#btc?.connection ?? void 0;
-    return await import_method2.DidBtcr2.update({
+    const btcConnection = bitcoin ?? this.#btc?.connection;
+    if (!btcConnection) {
+      throw new import_common3.UpdateError(
+        "Bitcoin connection required for update. Pass a configured `bitcoin` parameter or configure a BitcoinApi on the DidBtcr2Api instance.",
+        import_common3.INVALID_DID_UPDATE,
+        { beaconId }
+      );
+    }
+    this.#log.debug("Updating DID", sourceDocument.id, { beaconId, verificationMethodId });
+    const updater = import_method2.DidBtcr2.update({
       sourceDocument,
       patches,
       sourceVersionId,
       verificationMethodId,
-      beaconId,
-      signingMaterial,
-      bitcoin: btcConnection
+      beaconId
     });
+    let state = updater.advance();
+    while (state.status === "action-required") {
+      for (const need of state.needs) {
+        switch (need.kind) {
+          case "NeedSigningKey": {
+            this.#log.debug("Providing signer for", need.verificationMethodId);
+            updater.provide(need, signer);
+            break;
+          }
+          case "NeedFunding": {
+            this.#log.debug("Checking funding for beacon address %s", need.beaconAddress);
+            const utxos = await btcConnection.rest.address.getUtxos(need.beaconAddress);
+            if (!utxos.length) {
+              throw new import_common3.UpdateError(
+                `Beacon address ${need.beaconAddress} is unfunded. Send BTC to this address before broadcasting the update.`,
+                import_common3.INVALID_DID_UPDATE,
+                { beaconAddress: need.beaconAddress }
+              );
+            }
+            this.#log.debug("Beacon address funded (%d UTXOs)", utxos.length);
+            updater.provide(need);
+            break;
+          }
+          case "NeedBroadcast": {
+            this.#log.debug(
+              "Broadcasting signed update via %s beacon",
+              need.beaconService.type
+            );
+            const beacon = import_method2.BeaconFactory.establish(need.beaconService);
+            await beacon.broadcastSignal(need.signedUpdate, signer, btcConnection);
+            updater.provide(need);
+            break;
+          }
+        }
+      }
+      state = updater.advance();
+    }
+    this.#log.debug("DID update complete", sourceDocument.id);
+    return state.result.signedUpdate;
   }
   /**
    * Get the signing method from a DID document by method ID.
@@ -1937,8 +1994,9 @@ var DidMethodApi = class {
    *   .buildUpdate(currentDoc)
    *   .patch({ op: 'add', path: '/service/1', value: newService })
    *   .version(2)
-   *   .signer('#initialKey')
+   *   .verificationMethodId('#initialKey')
    *   .beacon('#beacon-0')
+   *   .signer(new LocalSigner(secretKey))
    *   .execute();
    * ```
    */
@@ -1963,7 +2021,7 @@ var UpdateBuilder = class {
   #sourceVersionId;
   #verificationMethodId;
   #beaconId;
-  #signingMaterial;
+  #signer;
   #bitcoin;
   /** @internal */
   constructor(methodApi, sourceDocument) {
@@ -1985,8 +2043,8 @@ var UpdateBuilder = class {
     this.#sourceVersionId = id;
     return this;
   }
-  /** Set the verification method ID used for signing. */
-  signer(methodId) {
+  /** Set the verification method ID used for signing the update. */
+  verificationMethodId(methodId) {
     this.#verificationMethodId = methodId;
     return this;
   }
@@ -1995,37 +2053,48 @@ var UpdateBuilder = class {
     this.#beaconId = beaconId;
     return this;
   }
-  /** Set the signing material (secret key bytes or hex). */
-  signingMaterial(material) {
-    this.#signingMaterial = material;
+  /**
+   * Set the {@link Signer} that produces the update's BIP-340 Schnorr proof
+   * and the beacon transaction's ECDSA input signature. Use `LocalSigner`
+   * for in-process secret keys, `KeyManagerSigner` for KMS-managed keys
+   * (AWS, Vault, HSM, etc.), or any custom adapter implementing the `Signer`
+   * interface.
+   */
+  signer(s) {
+    this.#signer = s;
     return this;
   }
   /** Override the Bitcoin connection for this update. */
-  withBitcoin(connection) {
+  bitcoin(connection) {
     this.#bitcoin = connection;
     return this;
   }
   /**
    * Execute the update.
-   * @throws {Error} If required fields (version, signer, beacon) are missing.
+   * @throws {Error} If required fields (version, verificationMethodId, beacon, signer) are missing.
    */
   async execute() {
     if (this.#sourceVersionId === void 0) {
       throw new Error("UpdateBuilder: sourceVersionId is required. Call .version(id) before .execute().");
     }
     if (!this.#verificationMethodId) {
-      throw new Error("UpdateBuilder: verificationMethodId is required. Call .signer(id) before .execute().");
+      throw new Error(
+        "UpdateBuilder: verificationMethodId is required. Call .verificationMethodId(id) before .execute()."
+      );
     }
     if (!this.#beaconId) {
       throw new Error("UpdateBuilder: beaconId is required. Call .beacon(id) before .execute().");
     }
+    if (!this.#signer) {
+      throw new Error("UpdateBuilder: signer is required. Call .signer(s) before .execute().");
+    }
     return this.#methodApi.update({
       sourceDocument: this.#sourceDocument,
       patches: this.#patches,
       sourceVersionId: this.#sourceVersionId,
       verificationMethodId: this.#verificationMethodId,
       beaconId: this.#beaconId,
-      signingMaterial: this.#signingMaterial,
+      signer: this.#signer,
       bitcoin: this.#bitcoin
     });
   }
@@ -2198,6 +2267,7 @@ var DidBtcr2Api = class {
     patches,
     verificationMethodId,
     beaconId,
+    signer,
     sourceDocument,
     sourceVersionId
   }) {
@@ -2238,7 +2308,8 @@ var DidBtcr2Api = class {
       patches,
       sourceVersionId: versionId,
       verificationMethodId,
-      beaconId
+      beaconId,
+      signer
     });
   }
   /**

package/dist/esm/api.js

@@ -4,7 +4,7 @@ import { CasApi, DEFAULT_CAS_GATEWAY } from './cas.js';
 import { CryptoApi } from './crypto.js';
 import { DidApi } from './did.js';
 import { assertString, NOOP_LOGGER } from './helpers.js';
-import { KeyManagerApi } from './kms.js';
+import { KeyManagerApi } from './key-manager.js';
 import { DidMethodApi } from './method.js';
 /**
  * Main DidBtcr2Api facade — the primary entry point for the SDK.
@@ -171,7 +171,7 @@ export class DidBtcr2Api {
      * @param params The update parameters.
      * @returns The signed update.
      */
-    async updateDid({ did, patches, verificationMethodId, beaconId, sourceDocument, sourceVersionId, }) {
+    async updateDid({ did, patches, verificationMethodId, beaconId, signer, sourceDocument, sourceVersionId, }) {
         this.#assertNotDisposed();
         assertString(did, 'did');
         let doc = sourceDocument;
@@ -204,6 +204,7 @@ export class DidBtcr2Api {
             sourceVersionId: versionId,
             verificationMethodId,
             beaconId,
+            signer,
         });
     }
     /**

package/dist/esm/api.js.map

@@ -1 +1 @@
-{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/api.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/api.ts"],"names":[],"mappings":"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"}

package/dist/esm/index.js

@@ -6,7 +6,7 @@ export * from './types.js';
 export * from './helpers.js';
 export * from './bitcoin.js';
 export * from './cas.js';
-export * from './kms.js';
+export * from './key-manager.js';
 export * from './crypto.js';
 export * from './did.js';
 export * from './method.js';

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,sBAAsB;AACtB,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAyBpD,gBAAgB;AAChB,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,sBAAsB;AACtB,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAyBpD,gBAAgB;AAChB,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC"}

package/dist/esm/{kms.js → key-manager.js}

@@ -1,11 +1,16 @@
-import { Kms, } from '@did-btcr2/kms';
+import { LocalKeyManager, } from '@did-btcr2/key-manager';
 import { assertBytes } from './helpers.js';
 /**
  * Key management operations sub-facade.
  *
- * Wraps a {@link KeyManager} interface. By default uses the built-in
- * {@link Kms} implementation; a custom implementation can be injected
- * via {@link ApiConfig}.
+ * Wraps any {@link KeyManager} interface implementation. By default uses the
+ * bundled {@link LocalKeyManager} (in-process reference implementation); a
+ * custom implementation (AWS KMS, GCP KMS, HashiCorp Vault, HSM, etc.) can
+ * be injected via {@link ApiConfig}.
+ *
+ * The field is named `kms` because that's the category label callers use
+ * conversationally ("plug in your KMS"); the actual contract is the
+ * {@link KeyManager} interface.
  * @public
  */
 export class KeyManagerApi {
@@ -13,7 +18,7 @@ export class KeyManagerApi {
     kms;
     /** Create a new KeyManagerApi, optionally backed by a custom KeyManager. */
     constructor(kms) {
-        this.kms = kms ?? new Kms();
+        this.kms = kms ?? new LocalKeyManager();
     }
     /** Generate a new key directly in the KMS. */
     generateKey(options) {
@@ -33,13 +38,17 @@ export class KeyManagerApi {
     }
     /**
      * Export a Schnorr keypair from the KMS.
-     * Only supported when the backing KMS is the built-in {@link Kms} class.
-     * @throws {Error} If the backing KMS does not support key export.
+     * Routes through the KeyManager's declared capability (`canExport`) rather
+     * than an `instanceof LocalKeyManager` check, so third-party adapters can
+     * opt in to export support without coupling to a specific implementation.
+     * External adapters (AWS, Vault, HSM) typically advertise `canExport: false`.
+     * @throws {Error} If the backing KeyManager does not advertise canExport=true,
+     *   or omits the optional `exportKey` method.
      */
     export(id) {
-        if (!(this.kms instanceof Kms)) {
+        if (!this.kms.canExport || !this.kms.exportKey) {
             throw new Error('Key export is not supported by the current KeyManager implementation. '
-                + 'Export is only available with the built-in Kms class.');
+                + 'The adapter must advertise `canExport: true` and provide an `exportKey` method.');
         }
         return this.kms.exportKey(id);
     }
@@ -55,13 +64,13 @@ export class KeyManagerApi {
      * Sign data via the KMS.
      * @param data The data to sign (must be non-empty).
      * @param id Optional key identifier; uses the active key if omitted.
-     * @param options Signing options (scheme defaults to 'schnorr').
+     * @param options Signing options. Defaults: `scheme: 'bip340'`.
      */
     sign(data, id, options) {
         assertBytes(data, 'data');
         return this.kms.sign(data, id, options);
     }
-    /** Verify a signature via the KMS. */
+    /** Verify a signature via the KMS. Defaults: `scheme: 'bip340'`. */
     verify(signature, data, id, options) {
         return this.kms.verify(signature, data, id, options);
     }
@@ -70,4 +79,4 @@ export class KeyManagerApi {
         return this.kms.digest(data);
     }
 }
-//# sourceMappingURL=kms.js.map
+//# sourceMappingURL=key-manager.js.map

package/dist/esm/key-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-manager.js","sourceRoot":"","sources":["../../src/key-manager.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,eAAe,GAGhB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,aAAa;IACxB,uCAAuC;IAC9B,GAAG,CAAa;IAEzB,4EAA4E;IAC5E,YAAY,GAAgB;QAC1B,IAAI,CAAC,GAAG,GAAG,GAAG,IAAI,IAAI,eAAe,EAAE,CAAC;IAC1C,CAAC;IAED,8CAA8C;IAC9C,WAAW,CAAC,OAA4B;QACtC,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,4CAA4C;IAC5C,SAAS,CAAC,EAAiB;QACzB,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,qDAAqD;IACrD,YAAY,CAAC,EAAkB;QAC7B,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,6CAA6C;IAC7C,MAAM,CAAC,EAAkB,EAAE,OAA0B;QACnD,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAiB;QACtB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;YAC/C,MAAM,IAAI,KAAK,CACb,wEAAwE;kBACtE,iFAAiF,CACpF,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,wCAAwC;IACxC,QAAQ;QACN,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;IAC7B,CAAC;IAED,iCAAiC;IACjC,SAAS,CAAC,EAAiB,EAAE,UAA+B,EAAE;QAC5D,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAED;;;;;OAKG;IACH,IAAI,CAAC,IAAW,EAAE,EAAkB,EAAE,OAAqB;QACzD,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,oEAAoE;IACpE,MAAM,CAAC,SAAyB,EAAE,IAAW,EAAE,EAAkB,EAAE,OAAuB;QACxF,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;IAED,gCAAgC;IAChC,MAAM,CAAC,IAAgB;QACrB,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;CACF"}

package/dist/esm/method.js

@@ -1,5 +1,5 @@
-import { decode as decodeHash, IdentifierTypes, NotImplementedError } from '@did-btcr2/common';
-import { BeaconSignalDiscovery, DidBtcr2 } from '@did-btcr2/method';
+import { decode as decodeHash, IdentifierTypes, INVALID_DID_UPDATE, NotImplementedError, UpdateError } from '@did-btcr2/common';
+import { BeaconFactory, BeaconSignalDiscovery, DidBtcr2 } from '@did-btcr2/method';
 import { assertBytes, assertCompressedPubkey, assertString, NOOP_LOGGER } from './helpers.js';
 /**
  * DID method operations sub-facade: create, resolve, update, deactivate.
@@ -125,22 +125,72 @@ export class DidMethodApi {
         }
     }
     /**
-     * Update an existing DID document. If a Bitcoin connection is configured on
-     * the API, it is injected automatically.
+     * Update an existing DID document by driving the sans-I/O {@link Updater} state
+     * machine (from @did-btcr2/method). This method handles the I/O side:
+     * - Signing: supplies the {@link Signer} to `NeedSigningKey`.
+     * - Broadcast: establishes a beacon via {@link BeaconFactory} and calls
+     *   `broadcastSignal()` with the bitcoin connection configured on the API.
+     *
+     * For multi-party aggregation of SMT/CAS beacons, the caller should drive the
+     * Updater directly and delegate `NeedBroadcast` to the aggregation runner
+     * rather than using this high-level method.
+     *
      * @param params The update parameters.
      * @returns The signed update.
      */
-    async update({ sourceDocument, patches, sourceVersionId, verificationMethodId, beaconId, signingMaterial, bitcoin, }) {
-        const btcConnection = bitcoin ?? this.#btc?.connection ?? undefined;
-        return await DidBtcr2.update({
+    async update({ sourceDocument, patches, sourceVersionId, verificationMethodId, beaconId, signer, bitcoin, }) {
+        // Bitcoin connection resolution order: per-call `bitcoin` param wins over the
+        // BitcoinApi injected at DidBtcr2Api construction time. One of the two must
+        // be present; this can't be encoded in the type system, so it's a runtime check.
+        const btcConnection = bitcoin ?? this.#btc?.connection;
+        if (!btcConnection) {
+            throw new UpdateError('Bitcoin connection required for update. Pass a configured `bitcoin` parameter '
+                + 'or configure a BitcoinApi on the DidBtcr2Api instance.', INVALID_DID_UPDATE, { beaconId });
+        }
+        this.#log.debug('Updating DID', sourceDocument.id, { beaconId, verificationMethodId });
+        // Factory validates and returns a sans-I/O state machine
+        const updater = DidBtcr2.update({
             sourceDocument,
             patches,
             sourceVersionId,
             verificationMethodId,
             beaconId,
-            signingMaterial,
-            bitcoin: btcConnection,
         });
+        // Drive the state machine. All I/O (signing delegation, Bitcoin broadcast)
+        // happens inside the need-handlers below — the Updater itself is pure.
+        let state = updater.advance();
+        while (state.status === 'action-required') {
+            for (const need of state.needs) {
+                switch (need.kind) {
+                    case 'NeedSigningKey': {
+                        this.#log.debug('Providing signer for', need.verificationMethodId);
+                        updater.provide(need, signer);
+                        break;
+                    }
+                    case 'NeedFunding': {
+                        this.#log.debug('Checking funding for beacon address %s', need.beaconAddress);
+                        const utxos = await btcConnection.rest.address.getUtxos(need.beaconAddress);
+                        if (!utxos.length) {
+                            throw new UpdateError(`Beacon address ${need.beaconAddress} is unfunded. `
+                                + 'Send BTC to this address before broadcasting the update.', INVALID_DID_UPDATE, { beaconAddress: need.beaconAddress });
+                        }
+                        this.#log.debug('Beacon address funded (%d UTXOs)', utxos.length);
+                        updater.provide(need);
+                        break;
+                    }
+                    case 'NeedBroadcast': {
+                        this.#log.debug('Broadcasting signed update via %s beacon', need.beaconService.type);
+                        const beacon = BeaconFactory.establish(need.beaconService);
+                        await beacon.broadcastSignal(need.signedUpdate, signer, btcConnection);
+                        updater.provide(need);
+                        break;
+                    }
+                }
+            }
+            state = updater.advance();
+        }
+        this.#log.debug('DID update complete', sourceDocument.id);
+        return state.result.signedUpdate;
     }
     /**
      * Get the signing method from a DID document by method ID.
@@ -162,8 +212,9 @@ export class DidMethodApi {
      *   .buildUpdate(currentDoc)
      *   .patch({ op: 'add', path: '/service/1', value: newService })
      *   .version(2)
-     *   .signer('#initialKey')
+     *   .verificationMethodId('#initialKey')
      *   .beacon('#beacon-0')
+     *   .signer(new LocalSigner(secretKey))
      *   .execute();
      * ```
      */
@@ -192,7 +243,7 @@ export class UpdateBuilder {
     #sourceVersionId;
     #verificationMethodId;
     #beaconId;
-    #signingMaterial;
+    #signer;
     #bitcoin;
     /** @internal */
     constructor(methodApi, sourceDocument) {
@@ -214,8 +265,8 @@ export class UpdateBuilder {
         this.#sourceVersionId = id;
         return this;
     }
-    /** Set the verification method ID used for signing. */
-    signer(methodId) {
+    /** Set the verification method ID used for signing the update. */
+    verificationMethodId(methodId) {
         this.#verificationMethodId = methodId;
         return this;
     }
@@ -224,37 +275,47 @@ export class UpdateBuilder {
         this.#beaconId = beaconId;
         return this;
     }
-    /** Set the signing material (secret key bytes or hex). */
-    signingMaterial(material) {
-        this.#signingMaterial = material;
+    /**
+     * Set the {@link Signer} that produces the update's BIP-340 Schnorr proof
+     * and the beacon transaction's ECDSA input signature. Use `LocalSigner`
+     * for in-process secret keys, `KeyManagerSigner` for KMS-managed keys
+     * (AWS, Vault, HSM, etc.), or any custom adapter implementing the `Signer`
+     * interface.
+     */
+    signer(s) {
+        this.#signer = s;
         return this;
     }
     /** Override the Bitcoin connection for this update. */
-    withBitcoin(connection) {
+    bitcoin(connection) {
         this.#bitcoin = connection;
         return this;
     }
     /**
      * Execute the update.
-     * @throws {Error} If required fields (version, signer, beacon) are missing.
+     * @throws {Error} If required fields (version, verificationMethodId, beacon, signer) are missing.
      */
     async execute() {
         if (this.#sourceVersionId === undefined) {
             throw new Error('UpdateBuilder: sourceVersionId is required. Call .version(id) before .execute().');
         }
         if (!this.#verificationMethodId) {
-            throw new Error('UpdateBuilder: verificationMethodId is required. Call .signer(id) before .execute().');
+            throw new Error('UpdateBuilder: verificationMethodId is required. '
+                + 'Call .verificationMethodId(id) before .execute().');
         }
         if (!this.#beaconId) {
             throw new Error('UpdateBuilder: beaconId is required. Call .beacon(id) before .execute().');
         }
+        if (!this.#signer) {
+            throw new Error('UpdateBuilder: signer is required. Call .signer(s) before .execute().');
+        }
         return this.#methodApi.update({
             sourceDocument: this.#sourceDocument,
             patches: this.#patches,
             sourceVersionId: this.#sourceVersionId,
             verificationMethodId: this.#verificationMethodId,
             beaconId: this.#beaconId,
-            signingMaterial: this.#signingMaterial,
+            signer: this.#signer,
             bitcoin: this.#bitcoin,
         });
     }

package/dist/esm/method.js.map

@@ -1 +1 @@
-{"version":3,"file":"method.js","sourceRoot":"","sources":["../../src/method.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"method.js","sourceRoot":"","sources":["../../src/method.ts"],"names":[],"mappings":"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"}

package/dist/types/api.d.ts

@@ -1,14 +1,15 @@
 import type { NetworkName } from '@did-btcr2/bitcoin';
 import type { DocumentBytes, KeyBytes, PatchOperation } from '@did-btcr2/common';
 import type { SignedBTCR2Update } from '@did-btcr2/cryptosuite';
-import type { KeyIdentifier } from '@did-btcr2/kms';
+import type { Signer } from '@did-btcr2/keypair';
+import type { KeyIdentifier } from '@did-btcr2/key-manager';
 import type { Btcr2DidDocument, DidCreateOptions, ResolutionOptions } from '@did-btcr2/method';
 import type { DidResolutionResult } from '@web5/dids';
 import { BitcoinApi } from './bitcoin.js';
 import { CasApi } from './cas.js';
 import { CryptoApi } from './crypto.js';
 import { DidApi } from './did.js';
-import { KeyManagerApi } from './kms.js';
+import { KeyManagerApi } from './key-manager.js';
 import { DidMethodApi } from './method.js';
 import type { ApiConfig, ResolutionResult } from './types.js';
 /**
@@ -99,11 +100,12 @@ export declare class DidBtcr2Api {
      * @param params The update parameters.
      * @returns The signed update.
      */
-    updateDid({ did, patches, verificationMethodId, beaconId, sourceDocument, sourceVersionId, }: {
+    updateDid({ did, patches, verificationMethodId, beaconId, signer, sourceDocument, sourceVersionId, }: {
         did: string;
         patches: PatchOperation[];
         verificationMethodId: string;
         beaconId: string;
+        signer: Signer;
         sourceDocument?: Btcr2DidDocument;
         sourceVersionId?: number;
     }): Promise<SignedBTCR2Update>;