@did-btcr2/api 0.2.1 → 0.3.0

package/dist/cjs/api.js

@@ -1,179 +1,239 @@
-import { BitcoinCoreRpcClient, BitcoinRestClient } from '@did-btcr2/bitcoin';
-import { DEFAULT_BLOCK_CONFIRMATIONS, DEFAULT_REST_CONFIG, DEFAULT_RPC_CONFIG, IdentifierTypes, NotImplementedError } from '@did-btcr2/common';
-import { SchnorrMultikey } from '@did-btcr2/cryptosuite';
-import { SchnorrKeyPair, Secp256k1SecretKey } from '@did-btcr2/keypair';
-import { DidBtcr2, DidDocument, DidDocumentBuilder, Identifier } from '@did-btcr2/method';
-export { DidDocument, DidDocumentBuilder, Identifier, IdentifierTypes };
-/* =========================
- * Sub-facade: KeyPair
- * ========================= */
-export class KeyPairApi {
-    /** Generate a new Schnorr keypair (secp256k1). */
-    static generate() {
-        return new SchnorrKeyPair();
-    }
-    /** Import from secret key bytes or bigint. */
-    static fromSecret(ent) {
-        const sk = new Secp256k1SecretKey(ent);
-        return new SchnorrKeyPair({ secretKey: sk });
+import { SchnorrKeyPair } from '@did-btcr2/keypair';
+import { BitcoinApi } from './bitcoin.js';
+import { CasApi } 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 { DidMethodApi } from './method.js';
+/**
+ * Main DidBtcr2Api facade — the primary entry point for the SDK.
+ *
+ * Exposes sub-facades for Bitcoin, DID Method, KeyPair, Crypto, and
+ * KeyManager operations. Created via the {@link createApi} factory.
+ * @public
+ */
+export class DidBtcr2Api {
+    /** Cryptographic operations (keypair, multikey, cryptosuite, proof). */
+    crypto;
+    /** DID identifier operations (encode, decode, generate, parse). */
+    did;
+    /** Key management operations. */
+    kms;
+    #btcConfig;
+    #btc;
+    #casConfig;
+    #cas;
+    #btcr2;
+    #log;
+    #disposed = false;
+    constructor(config) {
+        this.#btcConfig = config?.btc;
+        this.#casConfig = config?.cas;
+        this.#log = config?.logger ?? NOOP_LOGGER;
+        this.kms = new KeyManagerApi(config?.kms);
+        this.did = new DidApi();
+        this.crypto = new CryptoApi();
     }
-}
-export class MultikeyApi {
     /**
-     * Create a Schnorr Multikey wrapper (includes verificationMethod, sign/verify).
-     * If secret is present, the multikey can sign.
+     * Bitcoin API sub-facade (lazily initialized).
+     * Only available when `btc` config was provided to the constructor.
+     * @throws {Error} If the instance has been disposed or no Bitcoin config was provided.
      */
-    static create(params) {
-        return new SchnorrMultikey(params);
-    }
-    /** Produce a DID Verification Method JSON from a multikey. */
-    static toVerificationMethod(mk) {
-        return mk.toVerificationMethod();
+    get btc() {
+        this.#assertNotDisposed();
+        if (!this.#btc) {
+            if (!this.#btcConfig) {
+                throw new Error('Bitcoin not configured. Pass a btc config to createApi(), e.g.: '
+                    + 'createApi({ btc: { network: \'regtest\' } })');
+            }
+            this.#btc = new BitcoinApi(this.#btcConfig);
+        }
+        return this.#btc;
     }
-    /** Sign bytes via the multikey (requires secret). */
-    static async sign(mk, data) {
-        return mk.sign(data);
-    }
-    /** Verify signature via multikey. */
-    static async verify(mk, data, signature) {
-        return mk.verify(data, signature);
-    }
-}
-/* =========================
- * Sub-facade: Crypto
- * ========================= */
-export class CryptoApi {
-    static keyPairApi = new KeyPairApi();
-    static multikeyApi = new MultikeyApi();
-}
-/* =========================
- * Sub-facade: Bitcoin
- * ========================= */
-export class BitcoinApi {
-    rest;
-    rpc;
-    defaultConfirmations;
-    constructor(cfg) {
-        const restCfg = {
-            host: cfg?.rest?.host ?? DEFAULT_REST_CONFIG.host,
-            ...cfg?.rest
-        };
-        const rpcCfg = {
-            ...DEFAULT_RPC_CONFIG,
-            ...cfg?.rpc
-        };
-        this.rest = new BitcoinRestClient(restCfg);
-        this.rpc = new BitcoinCoreRpcClient(rpcCfg);
-        this.defaultConfirmations = cfg?.defaultConfirmations ?? DEFAULT_BLOCK_CONFIRMATIONS;
-    }
-    /** Fetch a transaction by txid via REST. */
-    async getTransaction(txid) {
-        return await this.rest.transaction.get(txid);
+    /**
+     * 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.
+     */
+    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);
+        }
+        return this.#cas;
     }
-    /** Broadcast a raw tx (hex) via REST. */
-    async send(rawTxHex) {
-        return await this.rest.transaction.send(rawTxHex);
+    /**
+     * DID Method API sub-facade (lazily initialized with bitcoin + CAS wiring).
+     * @throws {Error} If the instance has been disposed.
+     */
+    get btcr2() {
+        this.#assertNotDisposed();
+        if (!this.#btcr2) {
+            this.#btcr2 = new DidMethodApi(this.#btcConfig ? this.btc : undefined, this.#casConfig ? this.cas : undefined, this.#log);
+        }
+        return this.#btcr2;
     }
-    /** Get UTXOs for an address via REST. */
-    async getUtxos(address) {
-        return await this.rest.address.getUtxos(address);
+    /**
+     * Whether this API instance has been disposed.
+     */
+    get disposed() {
+        return this.#disposed;
     }
-    /** Get a block by hash or height via REST. */
-    async getBlock(params) {
-        return await this.rest.block.get({ blockhash: params.hash, height: params.height });
+    /**
+     * Create a DID using either deterministic (KEY) or external (EXTERNAL) mode.
+     * @param type The creation mode.
+     * @param genesisBytes Public key bytes (deterministic) or document bytes (external).
+     * @param options Creation options (idType is set for you).
+     * @returns The created DID identifier string.
+     */
+    createDid(type, genesisBytes, options) {
+        this.#assertNotDisposed();
+        return type === 'deterministic'
+            ? this.btcr2.createDeterministic(genesisBytes, options)
+            : this.btcr2.createExternal(genesisBytes, options);
     }
-}
-/* =========================
- * Sub-facade: KeyManager
- * ========================= */
-// export class KeyManagerApi {
-//   readonly impl: IMethodKeyManager;
-//   constructor(params?: ApiKeyManagerConfig) {
-//     this.impl = new MethodKeyManager(params);
-//   }
-//   setActive(keyUri: string) {
-//     this.impl.activeKeyUri = keyUri;
-//   }
-//   export(keyUri: string) {
-//     return this.impl.export(keyUri);
-//   }
-//   import(mk: SchnorrMultikey, opts?: { importKey?: boolean; active?: boolean }) {
-//     return this.impl.import(mk, opts);
-//   }
-//   sign(keyUri: string, hash: HashBytes): Promise<SignatureBytes> {
-//     return this.impl.sign(keyUri, hash);
-//   }
-// }
-/* =========================
- * Sub-facade: DID / CRUD
- * ========================= */
-export class DidApi {
     /**
-     * Create a deterministic DID from a public key (bytes).
+     * Generate a new DID, create the keypair, and import it into the KMS.
+     * @param options Optional settings.
+     * @param options.setActive Whether to set the imported key as active in the KMS (default `true`).
+     * @param options.network Network for the generated DID (default `'regtest'`).
+     * @returns The generated DID string and KMS key identifier.
      */
-    async createDeterministic({ genesisBytes, options }) {
-        return DidBtcr2.create(genesisBytes, options);
+    generateDid(options) {
+        this.#assertNotDisposed();
+        const { keyPair, did } = this.did.generate(options?.network);
+        const kp = SchnorrKeyPair.fromJSON(keyPair);
+        const keyId = this.kms.import(kp, { setActive: options?.setActive ?? true });
+        return { did, keyId };
     }
     /**
-     * Create from an intermediate DID document (external genesis).
+     * Resolve a DID, automatically injecting the configured Bitcoin connection.
+     * @param did The DID to resolve.
+     * @param options Optional resolution options.
+     * @returns The resolution result.
      */
-    async createExternal({ genesisBytes, options }) {
-        return DidBtcr2.create(genesisBytes, options);
+    async resolveDid(did, options) {
+        this.#assertNotDisposed();
+        return await this.btcr2.resolve(did, options);
     }
     /**
-     * Resolve DID document from DID (did:btcr2:...).
+     * Resolve a DID and return a discriminated result instead of throwing.
+     * Useful when resolution failure is an expected outcome (e.g. checking
+     * whether a DID exists before creating it).
+     * @param did The DID to resolve.
+     * @param options Optional resolution options.
+     * @returns A {@link ResolutionResult} with `ok: true` on success or
+     *          `ok: false` with error details on failure.
      */
-    async resolve(did, options) {
-        return await DidBtcr2.resolve(did, options);
+    async tryResolveDid(did, options) {
+        this.#assertNotDisposed();
+        assertString(did, 'did');
+        try {
+            const raw = await this.btcr2.resolve(did, options);
+            if (raw.didDocument) {
+                return {
+                    ok: true,
+                    document: raw.didDocument,
+                    metadata: raw.didDocumentMetadata,
+                    raw,
+                };
+            }
+            return {
+                ok: false,
+                error: raw.didResolutionMetadata?.error ?? 'unknown',
+                errorMessage: raw.didResolutionMetadata?.errorMessage,
+                raw,
+            };
+        }
+        catch (err) {
+            return {
+                ok: false,
+                error: 'internalError',
+                errorMessage: err.message,
+                raw: {
+                    didDocument: null,
+                    didDocumentMetadata: {},
+                    didResolutionMetadata: { error: 'internalError', errorMessage: err.message },
+                },
+            };
+        }
     }
     /**
-     * Update a DID Document using a JSON Patch, signed as capabilityInvocation.
-     * You provide the prior DID Document (to pick VM), a JSON Patch, and a signer multikey.
-     * This delegates to MethodUpdate (which follows the cryptosuite rules internally).
+     * Update a DID document: resolve the current state, apply patches, sign, and announce.
+     * Automatically injects the configured Bitcoin connection.
+     *
+     * If `sourceDocument` and `sourceVersionId` are both provided, resolution
+     * is skipped. Otherwise the DID is resolved first to obtain them.
+     * @param params The update parameters.
+     * @returns The signed update.
      */
-    async update({ sourceDocument, patches, sourceVersionId, verificationMethodId, beaconId, signingMaterial, bitcoin, }) {
-        // The Update class exposes the algorithm that creates a DID Update Payload and proof;
-        // keep this wrapper narrow so testing can mock MethodUpdate directly.
-        return await DidBtcr2.update({
-            sourceDocument,
+    async updateDid({ did, patches, verificationMethodId, beaconId, sourceDocument, sourceVersionId, }) {
+        this.#assertNotDisposed();
+        assertString(did, 'did');
+        let doc = sourceDocument;
+        let versionId = sourceVersionId;
+        if (!doc || versionId === undefined) {
+            const resolution = await this.resolveDid(did);
+            if (!resolution.didDocument) {
+                const meta = resolution.didResolutionMetadata;
+                const detail = meta?.error ? `: ${meta.error}` : '.';
+                const extra = meta?.errorMessage ? ` ${meta.errorMessage}` : '';
+                throw new Error(`Failed to resolve DID ${did} for update${detail}${extra}`, { cause: meta });
+            }
+            doc = doc ?? resolution.didDocument;
+            if (versionId === undefined) {
+                const rawVersionId = resolution.didDocumentMetadata?.versionId;
+                if (rawVersionId === undefined || rawVersionId === null) {
+                    throw new Error(`Resolution of DID ${did} succeeded but returned no versionId in metadata. `
+                        + 'Provide sourceVersionId explicitly.');
+                }
+                const parsed = Number(rawVersionId);
+                if (!Number.isFinite(parsed)) {
+                    throw new Error(`Resolution of DID ${did} returned a non-numeric versionId: ${String(rawVersionId)}.`);
+                }
+                versionId = parsed;
+            }
+        }
+        return await this.btcr2.update({
+            sourceDocument: doc,
             patches,
-            sourceVersionId,
+            sourceVersionId: versionId,
             verificationMethodId,
             beaconId,
-            signingMaterial,
-            bitcoin,
-        });
-    }
-    /** Deactivate convenience: applies the standard `deactivated: true` patch. */
-    async deactivate() {
-        // This class is a stub in method right now; expose a narrow wrapper for future expansion.
-        // return DidBtcr2.deactivate({ identifier, patch }); // No-op holder; implement when core adds behavior.
-        throw new NotImplementedError('DidApi.deactivate is not implemented yet.', {
-            type: 'DID_API_METHOD_NOT_IMPLEMENTED',
-            name: 'NOT_IMPLEMENTED_ERROR'
         });
     }
-}
-/* =========================
- * Root facade
- * ========================= */
-export class DidBtcr2Api {
-    bitcoin;
-    did;
-    keys;
-    crypto;
-    // readonly keyManager: KeyManagerApi;
-    constructor(config) {
-        this.bitcoin = new BitcoinApi(config?.bitcoin);
-        this.did = new DidApi();
-        this.keys = new KeyPairApi();
-        this.crypto = new CryptoApi();
-        // this.keyManager = new KeyManagerApi(config?.keyManager);
+    /**
+     * Release internal references. After disposal, accessing `btc`, `btcr2`,
+     * or calling top-level methods will throw.
+     *
+     * Note: the underlying {@link BitcoinConnection} does not hold persistent
+     * connections, so this is primarily a guard against accidental reuse.
+     */
+    dispose() {
+        this.#btc = undefined;
+        this.#cas = undefined;
+        this.#btcr2 = undefined;
+        this.#btcConfig = undefined;
+        this.#casConfig = undefined;
+        this.#disposed = true;
+    }
+    #assertNotDisposed() {
+        if (this.#disposed) {
+            throw new Error('This DidBtcr2Api instance has been disposed and can no longer be used.');
+        }
     }
 }
-/* =========================
- * Factory
- * ========================= */
+/**
+ * Create a new {@link DidBtcr2Api} instance with the given configuration.
+ * @param config Optional configuration for the API.
+ * @returns The created DidBtcr2Api instance.
+ * @public
+ */
 export function createApi(config) {
     return new DidBtcr2Api(config);
 }

package/dist/cjs/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/cjs/bitcoin.js

@@ -0,0 +1,110 @@
+import { BitcoinConnection } from '@did-btcr2/bitcoin';
+import { assertString } from './helpers.js';
+/**
+ * Bitcoin network operations sub-facade.
+ * Always backed by a {@link BitcoinConnection} so it can be passed to
+ * resolve/update without extra configuration.
+ *
+ * Lazily initialized by {@link DidBtcr2Api} to avoid connection overhead
+ * when Bitcoin features are not used.
+ * @public
+ */
+export class BitcoinApi {
+    /** The underlying BitcoinConnection used for all operations. */
+    connection;
+    /** REST client for the active network. */
+    get rest() {
+        return this.connection.rest;
+    }
+    /**
+     * RPC client for the active network, or `undefined` if not configured.
+     * Use {@link requireRpc} when RPC is expected to be available.
+     */
+    get rpc() {
+        return this.connection.rpc;
+    }
+    /** Whether an RPC client is available for this network. */
+    get hasRpc() {
+        return this.connection.rpc !== undefined;
+    }
+    /**
+     * RPC client for the active network.
+     * @throws {Error} If RPC was not configured for this network.
+     */
+    requireRpc() {
+        const client = this.connection.rpc;
+        if (!client) {
+            throw new Error('RPC client not configured. Pass an rpc config when creating the BitcoinApi, e.g.: '
+                + '{ network: \'regtest\', rpc: { host: \'http://localhost:18443\', username: \'u\', password: \'p\' } }');
+        }
+        return client;
+    }
+    /**
+     * Create a BitcoinApi for a specific network with optional endpoint overrides.
+     * Uses BitcoinConnection.forNetwork() — no env vars consulted.
+     * @param cfg The network and optional REST/RPC overrides.
+     */
+    constructor(cfg) {
+        let executor = cfg.executor;
+        // Wrap the default fetch with a timeout if configured and no custom
+        // executor was provided.
+        if (!executor && cfg.timeoutMs !== undefined) {
+            const ms = cfg.timeoutMs;
+            executor = (req) => fetch(req.url, {
+                method: req.method,
+                headers: req.headers,
+                body: req.body,
+                signal: AbortSignal.timeout(ms),
+            });
+        }
+        this.connection = BitcoinConnection.forNetwork(cfg.network, {
+            rest: cfg.rest,
+            rpc: cfg.rpc,
+            executor,
+        });
+    }
+    /**
+     * Fetch a transaction by txid via REST.
+     * @param txid The transaction ID (64-character hex string).
+     * @returns The fetched transaction.
+     */
+    async getTransaction(txid) {
+        assertString(txid, 'txid');
+        return await this.rest.transaction.get(txid);
+    }
+    /**
+     * Broadcast a raw tx (hex) via REST.
+     * @param rawTxHex The raw transaction hex string.
+     */
+    async send(rawTxHex) {
+        assertString(rawTxHex, 'rawTxHex');
+        return await this.rest.transaction.send(rawTxHex);
+    }
+    /**
+     * Get UTXOs for an address via REST.
+     * @param address The Bitcoin address.
+     */
+    async getUtxos(address) {
+        assertString(address, 'address');
+        return await this.rest.address.getUtxos(address);
+    }
+    /**
+     * Get a block by hash or height via REST.
+     * @param params Block identifier — at least one of `hash` or `height` is required.
+     */
+    async getBlock(params) {
+        if (!params.hash && params.height === undefined) {
+            throw new Error('getBlock requires at least one of hash or height.');
+        }
+        return await this.rest.block.get({ blockhash: params.hash, height: params.height });
+    }
+    /** Convert BTC to satoshis (integer-safe string-split arithmetic). */
+    static btcToSats(btc) {
+        return BitcoinConnection.btcToSats(btc);
+    }
+    /** Convert satoshis to BTC (integer-safe string-split arithmetic). */
+    static satsToBtc(sats) {
+        return BitcoinConnection.satsToBtc(sats);
+    }
+}
+//# sourceMappingURL=bitcoin.js.map

package/dist/cjs/bitcoin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitcoin.js","sourceRoot":"","sources":["../../src/bitcoin.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EAIlB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C;;;;;;;;GAQG;AACH,MAAM,OAAO,UAAU;IACrB,gEAAgE;IACvD,UAAU,CAAoB;IAEvC,0CAA0C;IAC1C,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACH,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;IAC7B,CAAC;IAED,2DAA2D;IAC3D,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,KAAK,SAAS,CAAC;IAC3C,CAAC;IAED;;;OAGG;IACH,UAAU;QACR,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QACnC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CACb,oFAAoF;kBAClF,uGAAuG,CAC1G,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACH,YAAY,GAAqB;QAC/B,IAAI,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;QAC5B,oEAAoE;QACpE,yBAAyB;QACzB,IAAI,CAAC,QAAQ,IAAI,GAAG,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YAC7C,MAAM,EAAE,GAAG,GAAG,CAAC,SAAS,CAAC;YACzB,QAAQ,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE;gBACjC,MAAM,EAAI,GAAG,CAAC,MAAM;gBACpB,OAAO,EAAG,GAAG,CAAC,OAAO;gBACrB,IAAI,EAAM,GAAG,CAAC,IAAI;gBAClB,MAAM,EAAI,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;aAClC,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,UAAU,GAAG,iBAAiB,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE;YAC1D,IAAI,EAAG,GAAG,CAAC,IAAI;YACf,GAAG,EAAI,GAAG,CAAC,GAAG;YACd,QAAQ;SACT,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,cAAc,CAAC,IAAY;QAC/B,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC3B,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAC,QAAgB;QACzB,YAAY,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QACnC,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACpD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,QAAQ,CAAC,OAAe;QAC5B,YAAY,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QACjC,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACnD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,QAAQ,CAAC,MAA0C;QACvD,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;QACD,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACtF,CAAC;IAED,sEAAsE;IACtE,MAAM,CAAC,SAAS,CAAC,GAAW;QAC1B,OAAO,iBAAiB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC1C,CAAC;IAED,sEAAsE;IACtE,MAAM,CAAC,SAAS,CAAC,IAAY;QAC3B,OAAO,iBAAiB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;CACF"}

package/dist/cjs/cas.js

@@ -0,0 +1,90 @@
+import { canonicalize, decode as decodeHash } from '@did-btcr2/common';
+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';
+import { assertString } from './helpers.js';
+/**
+ * Default {@link CasExecutor} backed by IPFS via Helia.
+ *
+ * Stores/retrieves data as raw blocks (`0x55` codec) with SHA-256 hashing.
+ * The CID is deterministically derived from the content hash, so lookups
+ * by base64url SHA-256 hash translate directly to CID lookups.
+ * @public
+ */
+export class IpfsCasExecutor {
+    #helia;
+    constructor(helia) {
+        this.#helia = helia;
+    }
+    async retrieve(hash) {
+        const hashBytes = decodeHash(hash, 'base64url');
+        const cid = CID.create(1, raw.code, createDigest(sha256.code, hashBytes));
+        try {
+            return await this.#helia.blockstore.get(cid);
+        }
+        catch {
+            return null;
+        }
+    }
+    async publish(data) {
+        const digest = await sha256.digest(data);
+        const cid = CID.createV1(raw.code, digest);
+        await this.#helia.blockstore.put(cid, data);
+        // Return base64url-encoded hash (no padding)
+        return btoa(String.fromCharCode(...digest.bytes.slice(2)))
+            .replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
+    }
+}
+/**
+ * Content-Addressed Storage API sub-facade.
+ *
+ * Provides `publish` and `retrieve` for JSON objects using their
+ * JCS-canonicalized SHA-256 hash as the content address.
+ *
+ * By default uses IPFS (via Helia). Inject a custom {@link CasExecutor}
+ * to use a different CAS backend.
+ *
+ * Lazily initialized by {@link DidBtcr2Api} to avoid startup overhead
+ * when CAS features are not used.
+ * @public
+ */
+export class CasApi {
+    #executor;
+    constructor(config) {
+        if (config.executor) {
+            this.#executor = config.executor;
+        }
+        else if (config.helia) {
+            this.#executor = new IpfsCasExecutor(config.helia);
+        }
+        else {
+            throw new Error('CAS configuration requires either an executor or a Helia instance. '
+                + 'Example: createApi({ cas: { helia: await createHelia() } })');
+        }
+    }
+    /**
+     * Retrieve a JSON object from the CAS by its base64url SHA-256 hash.
+     * @param hash Base64url-encoded SHA-256 hash of the JCS-canonicalized object.
+     * @returns The parsed JSON object, or `null` if not found.
+     */
+    async retrieve(hash) {
+        assertString(hash, 'hash');
+        const bytes = await this.#executor.retrieve(hash);
+        if (!bytes)
+            return null;
+        return JSON.parse(new TextDecoder().decode(bytes));
+    }
+    /**
+     * Publish a JSON object to the CAS.
+     * The object is JCS-canonicalized before storage; the returned hash
+     * matches what {@link canonicalHash} would produce.
+     * @param object The JSON object to publish.
+     * @returns The base64url-encoded SHA-256 hash (content address).
+     */
+    async publish(object) {
+        const bytes = new TextEncoder().encode(canonicalize(object));
+        return await this.#executor.publish(bytes);
+    }
+}
+//# sourceMappingURL=cas.js.map

package/dist/cjs/cas.js.map

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