@did-btcr2/api 0.3.1 → 0.4.0

package/src/method.ts

@@ -1,12 +1,12 @@
-import { BitcoinConnection } from '@did-btcr2/bitcoin';
+import type { BitcoinConnection } from '@did-btcr2/bitcoin';
 import type { DocumentBytes, HexString, KeyBytes, PatchOperation } from '@did-btcr2/common';
-import { IdentifierTypes, NotImplementedError } from '@did-btcr2/common';
-import { SignedBTCR2Update } from '@did-btcr2/cryptosuite';
+import { decode as decodeHash, IdentifierTypes, NotImplementedError } from '@did-btcr2/common';
+import type { SignedBTCR2Update } from '@did-btcr2/cryptosuite';
 import type { Btcr2DidDocument, CASAnnouncement, DidCreateOptions, NeedCASAnnouncement, NeedGenesisDocument, NeedSignedUpdate, ResolutionOptions } from '@did-btcr2/method';
 import { BeaconSignalDiscovery, DidBtcr2 } from '@did-btcr2/method';
 import type { DidResolutionResult, DidVerificationMethod } from '@web5/dids';
-import { BitcoinApi } from './bitcoin.js';
-import { CasApi } from './cas.js';
+import type { BitcoinApi } from './bitcoin.js';
+import type { CasApi } from './cas.js';
 import { assertBytes, assertCompressedPubkey, assertString, NOOP_LOGGER } from './helpers.js';
 import type { Logger } from './types.js';
 
@@ -53,7 +53,7 @@ export class DidMethodApi {
   }
 
   /**
-   * Resolve a DID by driving the sans-I/O {@link Resolver} state machine.
+   * Resolve a DID by driving the sans-I/O `Resolver` state machine (from @did-btcr2/method).
    * If a Bitcoin connection is configured on the API, it is used automatically
    * to fetch beacon signals. Sidecar data flows through `options.sidecar`.
    * @param did The DID to resolve.
@@ -96,7 +96,7 @@ export class DidMethodApi {
                 );
               }
               this.#log.debug('Fetching genesis document from CAS: %s', need.genesisHash);
-              const doc = await this.#cas.retrieve(need.genesisHash);
+              const doc = await this.#cas.retrieve(decodeHash(need.genesisHash, 'hex'));
               if(!doc) {
                 throw new Error(
                   `Genesis document not found in CAS (hash: ${need.genesisHash}).`
@@ -114,7 +114,7 @@ export class DidMethodApi {
                 );
               }
               this.#log.debug('Fetching CAS announcement from CAS: %s', need.announcementHash);
-              const announcement = await this.#cas.retrieve(need.announcementHash);
+              const announcement = await this.#cas.retrieve(decodeHash(need.announcementHash, 'hex'));
               if(!announcement) {
                 throw new Error(
                   `CAS announcement not found in CAS (hash: ${need.announcementHash}).`
@@ -132,7 +132,7 @@ export class DidMethodApi {
                 );
               }
               this.#log.debug('Fetching signed update from CAS: %s', need.updateHash);
-              const update = await this.#cas.retrieve(need.updateHash);
+              const update = await this.#cas.retrieve(decodeHash(need.updateHash, 'hex'));
               if(!update) {
                 throw new Error(
                   `Signed update not found in CAS (hash: ${need.updateHash}).`

package/dist/cjs/api.js

@@ -1,240 +0,0 @@
-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();
-    }
-    /**
-     * 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.
-     */
-    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;
-    }
-    /**
-     * 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;
-    }
-    /**
-     * 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;
-    }
-    /**
-     * Whether this API instance has been disposed.
-     */
-    get disposed() {
-        return this.#disposed;
-    }
-    /**
-     * 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);
-    }
-    /**
-     * 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.
-     */
-    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 };
-    }
-    /**
-     * 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 resolveDid(did, options) {
-        this.#assertNotDisposed();
-        return await this.btcr2.resolve(did, options);
-    }
-    /**
-     * 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 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: 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 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: versionId,
-            verificationMethodId,
-            beaconId,
-        });
-    }
-    /**
-     * 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.');
-        }
-    }
-}
-/**
- * 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);
-}
-//# sourceMappingURL=api.js.map

package/dist/cjs/api.js.map

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

package/dist/cjs/bitcoin.js

@@ -1,110 +0,0 @@
-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

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

package/dist/cjs/cas.js

@@ -1,90 +0,0 @@
-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

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