@did-btcr2/api 0.4.0 → 0.7.0

package/dist/cjs/index.js

@@ -34,12 +34,15 @@ __export(index_exports, {
   CasApi: () => CasApi,
   CryptoApi: () => CryptoApi,
   CryptosuiteApi: () => CryptosuiteApi,
+  DEFAULT_CAS_GATEWAY: () => DEFAULT_CAS_GATEWAY,
+  DEFAULT_CAS_TIMEOUT_MS: () => DEFAULT_CAS_TIMEOUT_MS,
   DataIntegrityProofApi: () => DataIntegrityProofApi,
   DidApi: () => DidApi,
   DidBtcr2Api: () => DidBtcr2Api,
   DidDocument: () => import_method4.DidDocument,
   DidDocumentBuilder: () => import_method4.DidDocumentBuilder,
   DidMethodApi: () => DidMethodApi,
+  HttpGatewayCasExecutor: () => HttpGatewayCasExecutor,
   Identifier: () => import_method4.Identifier,
   IdentifierTypes: () => import_common4.IdentifierTypes,
   IpfsCasExecutor: () => IpfsCasExecutor,
@@ -1129,6 +1132,7 @@ var sha512 = from2({
 });
 
 // src/cas.ts
+var DEFAULT_CAS_GATEWAY = "https://ipfs.io";
 var IpfsCasExecutor = class {
   #helia;
   constructor(helia) {
@@ -1150,18 +1154,47 @@ var IpfsCasExecutor = class {
     return btoa(String.fromCharCode(...digest.bytes.slice(2))).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
   }
 };
+var HttpGatewayCasExecutor = class {
+  #gatewayUrl;
+  constructor(gatewayUrl) {
+    this.#gatewayUrl = gatewayUrl.replace(/\/+$/, "");
+  }
+  async retrieve(hash) {
+    const hashBytes = (0, import_common.decode)(hash, "base64urlnopad");
+    const cid = CID.create(1, code, create(sha256.code, hashBytes));
+    try {
+      const res = await fetch(`${this.#gatewayUrl}/ipfs/${cid.toString()}?format=raw`, {
+        headers: { Accept: "application/vnd.ipld.raw" }
+      });
+      if (!res.ok) return null;
+      return new Uint8Array(await res.arrayBuffer());
+    } catch {
+      return null;
+    }
+  }
+  async publish() {
+    throw new Error(
+      "HttpGatewayCasExecutor is read-only. Publishing requires a full IPFS node (use IpfsCasExecutor with Helia)."
+    );
+  }
+};
+var DEFAULT_CAS_TIMEOUT_MS = 3e4;
 var CasApi = class {
   #executor;
+  #timeoutMs;
   constructor(config) {
     if (config.executor) {
       this.#executor = config.executor;
     } else if (config.helia) {
       this.#executor = new IpfsCasExecutor(config.helia);
+    } else if (config.gateway) {
+      this.#executor = new HttpGatewayCasExecutor(config.gateway);
     } else {
       throw new Error(
-        "CAS configuration requires either an executor or a Helia instance. Example: createApi({ cas: { helia: await createHelia() } })"
+        "CAS configuration requires an executor, Helia instance, or gateway URL. Example: createApi({ cas: { gateway: 'https://ipfs.io' } })"
       );
     }
+    this.#timeoutMs = config.timeoutMs ?? DEFAULT_CAS_TIMEOUT_MS;
   }
   /**
    * Retrieve a JSON object from the CAS by its SHA-256 hash bytes.
@@ -1170,7 +1203,7 @@ var CasApi = class {
    */
   async retrieve(hashBytes) {
     const hash = (0, import_common.encode)(hashBytes, "base64urlnopad");
-    const bytes = await this.#executor.retrieve(hash);
+    const bytes = await this.#withTimeout(this.#executor.retrieve(hash));
     if (!bytes) return null;
     return JSON.parse(new TextDecoder().decode(bytes));
   }
@@ -1183,18 +1216,40 @@ var CasApi = class {
    */
   async publish(object) {
     const bytes = new TextEncoder().encode((0, import_common.canonicalize)(object));
-    return await this.#executor.publish(bytes);
+    return await this.#withTimeout(this.#executor.publish(bytes));
+  }
+  /**
+   * Wraps a promise with a timeout. If `#timeoutMs` is 0, no timeout is applied.
+   */
+  #withTimeout(promise) {
+    if (!this.#timeoutMs) return promise;
+    return new Promise((resolve, reject) => {
+      const timer = setTimeout(
+        () => reject(new Error(`CAS operation timed out after ${this.#timeoutMs}ms`)),
+        this.#timeoutMs
+      );
+      promise.then(
+        (val) => {
+          clearTimeout(timer);
+          resolve(val);
+        },
+        (err) => {
+          clearTimeout(timer);
+          reject(err);
+        }
+      );
+    });
   }
 };
 
-// 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) {
@@ -1214,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);
@@ -1237,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);
   }
@@ -1837,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.
    */
@@ -1848,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.
@@ -1882,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();
    * ```
    */
@@ -1908,7 +2021,7 @@ var UpdateBuilder = class {
   #sourceVersionId;
   #verificationMethodId;
   #beaconId;
-  #signingMaterial;
+  #signer;
   #bitcoin;
   /** @internal */
   constructor(methodApi, sourceDocument) {
@@ -1930,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;
   }
@@ -1940,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
     });
   }
@@ -2019,18 +2143,16 @@ var DidBtcr2Api = class {
   }
   /**
    * CAS API sub-facade (lazily initialized).
-   * Only available when `cas` config was provided to the constructor.
-   * @throws {Error} If the instance has been disposed or no CAS config was provided.
+   *
+   * When no `cas` config was provided to the constructor, defaults to a
+   * read-only {@link HttpGatewayCasExecutor} backed by the public IPFS
+   * gateway (`https://ipfs.io`). Override via `createApi({ cas: { ... } })`.
+   * @throws {Error} If the instance has been disposed.
    */
   get cas() {
     this.#assertNotDisposed();
     if (!this.#cas) {
-      if (!this.#casConfig) {
-        throw new Error(
-          "CAS not configured. Pass a cas config to createApi(), e.g.: createApi({ cas: { helia: await createHelia() } })"
-        );
-      }
-      this.#cas = new CasApi(this.#casConfig);
+      this.#cas = new CasApi(this.#casConfig ?? { gateway: DEFAULT_CAS_GATEWAY });
     }
     return this.#cas;
   }
@@ -2043,7 +2165,7 @@ var DidBtcr2Api = class {
     if (!this.#btcr2) {
       this.#btcr2 = new DidMethodApi(
         this.#btcConfig ? this.btc : void 0,
-        this.#casConfig ? this.cas : void 0,
+        this.cas,
         this.#log
       );
     }
@@ -2145,6 +2267,7 @@ var DidBtcr2Api = class {
     patches,
     verificationMethodId,
     beaconId,
+    signer,
     sourceDocument,
     sourceVersionId
   }) {
@@ -2185,7 +2308,8 @@ var DidBtcr2Api = class {
       patches,
       sourceVersionId: versionId,
       verificationMethodId,
-      beaconId
+      beaconId,
+      signer
     });
   }
   /**
@@ -2218,12 +2342,15 @@ function createApi(config) {
   CasApi,
   CryptoApi,
   CryptosuiteApi,
+  DEFAULT_CAS_GATEWAY,
+  DEFAULT_CAS_TIMEOUT_MS,
   DataIntegrityProofApi,
   DidApi,
   DidBtcr2Api,
   DidDocument,
   DidDocumentBuilder,
   DidMethodApi,
+  HttpGatewayCasExecutor,
   Identifier,
   IdentifierTypes,
   IpfsCasExecutor,

package/dist/esm/api.js

@@ -1,10 +1,10 @@
 import { SchnorrKeyPair } from '@did-btcr2/keypair';
 import { BitcoinApi } from './bitcoin.js';
-import { CasApi } from './cas.js';
+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.
@@ -53,17 +53,16 @@ export class DidBtcr2Api {
     }
     /**
      * CAS API sub-facade (lazily initialized).
-     * Only available when `cas` config was provided to the constructor.
-     * @throws {Error} If the instance has been disposed or no CAS config was provided.
+     *
+     * When no `cas` config was provided to the constructor, defaults to a
+     * read-only {@link HttpGatewayCasExecutor} backed by the public IPFS
+     * gateway (`https://ipfs.io`). Override via `createApi({ cas: { ... } })`.
+     * @throws {Error} If the instance has been disposed.
      */
     get cas() {
         this.#assertNotDisposed();
         if (!this.#cas) {
-            if (!this.#casConfig) {
-                throw new Error('CAS not configured. Pass a cas config to createApi(), e.g.: '
-                    + 'createApi({ cas: { helia: await createHelia() } })');
-            }
-            this.#cas = new CasApi(this.#casConfig);
+            this.#cas = new CasApi(this.#casConfig ?? { gateway: DEFAULT_CAS_GATEWAY });
         }
         return this.#cas;
     }
@@ -74,7 +73,7 @@ export class DidBtcr2Api {
     get btcr2() {
         this.#assertNotDisposed();
         if (!this.#btcr2) {
-            this.#btcr2 = new DidMethodApi(this.#btcConfig ? this.btc : undefined, this.#casConfig ? this.cas : undefined, this.#log);
+            this.#btcr2 = new DidMethodApi(this.#btcConfig ? this.btc : undefined, this.cas, this.#log);
         }
         return this.#btcr2;
     }
@@ -172,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;
@@ -205,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":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAIpD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAkB,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C;;;;;;GAMG;AACH,MAAM,OAAO,WAAW;IACtB,wEAAwE;IAC/D,MAAM,CAAY;IAC3B,mEAAmE;IAC1D,GAAG,CAAS;IACrB,iCAAiC;IACxB,GAAG,CAAgB;IAE5B,UAAU,CAAoB;IAC9B,IAAI,CAAc;IAClB,UAAU,CAAa;IACvB,IAAI,CAAU;IACd,MAAM,CAAgB;IACtB,IAAI,CAAS;IACb,SAAS,GAAG,KAAK,CAAC;IAElB,YAAY,MAAkB;QAC5B,IAAI,CAAC,UAAU,GAAG,MAAM,EAAE,GAAG,CAAC;QAC9B,IAAI,CAAC,UAAU,GAAG,MAAM,EAAE,GAAG,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,MAAM,EAAE,MAAM,IAAI,WAAW,CAAC;QAC1C,IAAI,CAAC,GAAG,GAAG,IAAI,aAAa,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC1C,IAAI,CAAC,GAAG,GAAG,IAAI,MAAM,EAAE,CAAC;QACxB,IAAI,CAAC,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;IAChC,CAAC;IAED;;;;OAIG;IACH,IAAI,GAAG;QACL,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1B,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;gBACrB,MAAM,IAAI,KAAK,CACb,kEAAkE;sBAChE,8CAA8C,CACjD,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,IAAI,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED;;;;OAIG;IACH,IAAI,GAAG;QACL,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1B,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;gBACrB,MAAM,IAAI,KAAK,CACb,8DAA8D;sBAC5D,oDAAoD,CACvD,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,IAAI,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED;;;OAGG;IACH,IAAI,KAAK;QACP,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1B,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,IAAI,CAAC,MAAM,GAAG,IAAI,YAAY,CAC5B,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EACtC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EACtC,IAAI,CAAC,IAAI,CACV,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED;;;;;;OAMG;IACH,SAAS,CACP,IAAkC,EAClC,YAAsC,EACtC,OAA0C;QAE1C,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1B,OAAO,IAAI,KAAK,eAAe;YAC7B,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,YAAwB,EAAE,OAAO,CAAC;YACnE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,YAA6B,EAAE,OAAO,CAAC,CAAC;IACxE,CAAC;IAED;;;;;;OAMG;IACH,WAAW,CAAC,OAAwD;QAClE,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1B,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC7D,MAAM,EAAE,GAAG,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,IAAI,EAAE,CAAC,CAAC;QAC7E,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;IACxB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,UAAU,CAAC,GAAW,EAAE,OAA2B;QACvD,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1B,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,aAAa,CAAC,GAAW,EAAE,OAA2B;QAC1D,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1B,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YACnD,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;gBACpB,OAAO;oBACL,EAAE,EAAS,IAAI;oBACf,QAAQ,EAAG,GAAG,CAAC,WAA+B;oBAC9C,QAAQ,EAAG,GAAG,CAAC,mBAAmB;oBAClC,GAAG;iBACJ,CAAC;YACJ,CAAC;YACD,OAAO;gBACL,EAAE,EAAa,KAAK;gBACpB,KAAK,EAAU,GAAG,CAAC,qBAAqB,EAAE,KAAK,IAAI,SAAS;gBAC5D,YAAY,EAAG,GAAG,CAAC,qBAAqB,EAAE,YAAkC;gBAC5E,GAAG;aACJ,CAAC;QACJ,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,OAAO;gBACL,EAAE,EAAa,KAAK;gBACpB,KAAK,EAAU,eAAe;gBAC9B,YAAY,EAAG,GAAG,CAAC,OAAO;gBAC1B,GAAG,EAAY;oBACb,WAAW,EAAc,IAAI;oBAC7B,mBAAmB,EAAM,EAAE;oBAC3B,qBAAqB,EAAI,EAAE,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,GAAG,CAAC,OAAO,EAAE;iBAC7C;aACpC,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,SAAS,CAAC,EACd,GAAG,EACH,OAAO,EACP,oBAAoB,EACpB,QAAQ,EACR,cAAc,EACd,eAAe,GAQhB;QACC,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1B,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAEzB,IAAI,GAAG,GAAG,cAAc,CAAC;QACzB,IAAI,SAAS,GAAG,eAAe,CAAC;QAEhC,IAAI,CAAC,GAAG,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YACpC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YAC9C,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;gBAC5B,MAAM,IAAI,GAAG,UAAU,CAAC,qBAAqB,CAAC;gBAC9C,MAAM,MAAM,GAAG,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;gBACrD,MAAM,KAAK,GAAG,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChE,MAAM,IAAI,KAAK,CACb,yBAAyB,GAAG,cAAc,MAAM,GAAG,KAAK,EAAE,EAC1D,EAAE,KAAK,EAAE,IAAI,EAAE,CAChB,CAAC;YACJ,CAAC;YACD,GAAG,GAAG,GAAG,IAAI,UAAU,CAAC,WAA+B,CAAC;YAExD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC5B,MAAM,YAAY,GAAG,UAAU,CAAC,mBAAmB,EAAE,SAAS,CAAC;gBAC/D,IAAI,YAAY,KAAK,SAAS,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;oBACxD,MAAM,IAAI,KAAK,CACb,qBAAqB,GAAG,oDAAoD;0BAC1E,qCAAqC,CACxC,CAAC;gBACJ,CAAC;gBACD,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;gBACpC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC7B,MAAM,IAAI,KAAK,CACb,qBAAqB,GAAG,sCAAsC,MAAM,CAAC,YAAY,CAAC,GAAG,CACtF,CAAC;gBACJ,CAAC;gBACD,SAAS,GAAG,MAAM,CAAC;YACrB,CAAC;QACH,CAAC;QAED,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;YAC7B,cAAc,EAAM,GAAG;YACvB,OAAO;YACP,eAAe,EAAK,SAAS;YAC7B,oBAAoB;YACpB,QAAQ;SACT,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,OAAO;QACL,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACxB,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;IACxB,CAAC;IAED,kBAAkB;QAChB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,wEAAwE,CAAC,CAAC;QAC5F,CAAC;IACH,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,MAAkB;IAC1C,OAAO,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;AACjC,CAAC"}
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/api.ts"],"names":[],"mappings":"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"}

package/dist/esm/cas.js

@@ -3,6 +3,8 @@ import { CID } from 'multiformats/cid';
 import * as raw from 'multiformats/codecs/raw';
 import { create as createDigest } from 'multiformats/hashes/digest';
 import { sha256 } from 'multiformats/hashes/sha2';
+/** Default IPFS HTTP gateway used for CAS reads when no CAS config is provided. */
+export const DEFAULT_CAS_GATEWAY = 'https://ipfs.io';
 /**
  * Default {@link CasExecutor} backed by IPFS via Helia.
  *
@@ -35,6 +37,45 @@ export class IpfsCasExecutor {
             .replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
     }
 }
+/**
+ * Read-only {@link CasExecutor} backed by an IPFS HTTP gateway.
+ *
+ * Converts the base64url SHA-256 hash to a CIDv1 (raw codec) and fetches
+ * the raw block via the
+ * {@link https://specs.ipfs.tech/http-gateways/trustless-gateway/ | Trustless Gateway}
+ * protocol.
+ *
+ * Publishing is not supported — use {@link IpfsCasExecutor} with a Helia
+ * instance for writes.
+ * @public
+ */
+export class HttpGatewayCasExecutor {
+    #gatewayUrl;
+    constructor(gatewayUrl) {
+        this.#gatewayUrl = gatewayUrl.replace(/\/+$/, '');
+    }
+    async retrieve(hash) {
+        const hashBytes = decodeHash(hash, 'base64urlnopad');
+        const cid = CID.create(1, raw.code, createDigest(sha256.code, hashBytes));
+        try {
+            const res = await fetch(`${this.#gatewayUrl}/ipfs/${cid.toString()}?format=raw`, {
+                headers: { Accept: 'application/vnd.ipld.raw' },
+            });
+            if (!res.ok)
+                return null;
+            return new Uint8Array(await res.arrayBuffer());
+        }
+        catch {
+            return null;
+        }
+    }
+    async publish() {
+        throw new Error('HttpGatewayCasExecutor is read-only. '
+            + 'Publishing requires a full IPFS node (use IpfsCasExecutor with Helia).');
+    }
+}
+/** Default timeout (ms) for CAS operations. */
+export const DEFAULT_CAS_TIMEOUT_MS = 30_000;
 /**
  * Content-Addressed Storage API sub-facade.
  *
@@ -50,6 +91,7 @@ export class IpfsCasExecutor {
  */
 export class CasApi {
     #executor;
+    #timeoutMs;
     constructor(config) {
         if (config.executor) {
             this.#executor = config.executor;
@@ -57,10 +99,14 @@ export class CasApi {
         else if (config.helia) {
             this.#executor = new IpfsCasExecutor(config.helia);
         }
+        else if (config.gateway) {
+            this.#executor = new HttpGatewayCasExecutor(config.gateway);
+        }
         else {
-            throw new Error('CAS configuration requires either an executor or a Helia instance. '
-                + 'Example: createApi({ cas: { helia: await createHelia() } })');
+            throw new Error('CAS configuration requires an executor, Helia instance, or gateway URL. '
+                + 'Example: createApi({ cas: { gateway: \'https://ipfs.io\' } })');
         }
+        this.#timeoutMs = config.timeoutMs ?? DEFAULT_CAS_TIMEOUT_MS;
     }
     /**
      * Retrieve a JSON object from the CAS by its SHA-256 hash bytes.
@@ -69,7 +115,7 @@ export class CasApi {
      */
     async retrieve(hashBytes) {
         const hash = encodeHash(hashBytes, 'base64urlnopad');
-        const bytes = await this.#executor.retrieve(hash);
+        const bytes = await this.#withTimeout(this.#executor.retrieve(hash));
         if (!bytes)
             return null;
         return JSON.parse(new TextDecoder().decode(bytes));
@@ -83,7 +129,18 @@ export class CasApi {
      */
     async publish(object) {
         const bytes = new TextEncoder().encode(canonicalize(object));
-        return await this.#executor.publish(bytes);
+        return await this.#withTimeout(this.#executor.publish(bytes));
+    }
+    /**
+     * Wraps a promise with a timeout. If `#timeoutMs` is 0, no timeout is applied.
+     */
+    #withTimeout(promise) {
+        if (!this.#timeoutMs)
+            return promise;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => reject(new Error(`CAS operation timed out after ${this.#timeoutMs}ms`)), this.#timeoutMs);
+            promise.then((val) => { clearTimeout(timer); resolve(val); }, (err) => { clearTimeout(timer); reject(err); });
+        });
     }
 }
 //# sourceMappingURL=cas.js.map

package/dist/esm/cas.js.map

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