@btc-vision/bitcoin 6.5.5 → 7.0.0-alpha.0

package/build/block.js

@@ -1,99 +1,190 @@
-import { BufferReader, BufferWriter, reverseBuffer, varuint } from './bufferutils.js';
 import * as bcrypto from './crypto.js';
+import { BinaryReader, BinaryWriter, varuint, equals, fromHex, alloc, compare, toHex, reverse } from './io/index.js';
 import { fastMerkleRoot } from './merkle.js';
 import { Transaction } from './transaction.js';
-import * as types from './types.js';
-const { typeforce } = types;
 const errorMerkleNoTxes = new TypeError('Cannot compute merkle root for zero transactions');
 const errorWitnessNotSegwit = new TypeError('Cannot compute witness commit for non-segwit block');
+const WITNESS_COMMIT_PREFIX = fromHex('6a24aa21a9ed');
+/**
+ * Represents a Bitcoin block with header fields and optional transactions.
+ *
+ * @example
+ * ```typescript
+ * import { Block, fromHex } from '@btc-vision/bitcoin';
+ *
+ * // Parse a block from hex
+ * const block = Block.fromHex('0100000000000000...');
+ *
+ * // Access block properties
+ * console.log(block.version);
+ * console.log(block.getId());
+ * console.log(block.timestamp);
+ *
+ * // Check proof of work
+ * if (block.checkProofOfWork()) {
+ *     console.log('Valid PoW');
+ * }
+ * ```
+ */
 export class Block {
-    constructor() {
-        this.version = 1;
-        this.prevHash = undefined;
-        this.merkleRoot = undefined;
-        this.timestamp = 0;
-        this.witnessCommit = undefined;
-        this.bits = 0;
-        this.nonce = 0;
-        this.transactions = undefined;
-    }
+    /** Block version number */
+    version = 1;
+    /** Hash of the previous block (32 bytes) */
+    prevHash = undefined;
+    /** Merkle root of the transactions (32 bytes) */
+    merkleRoot = undefined;
+    /** Block timestamp (Unix time) */
+    timestamp = 0;
+    /** Witness commitment for SegWit blocks (32 bytes) */
+    witnessCommit = undefined;
+    /** Compact representation of the target threshold */
+    bits = 0;
+    /** Nonce used for proof of work */
+    nonce = 0;
+    /** Array of transactions included in the block */
+    transactions = undefined;
+    /**
+     * Parses a Block from a Uint8Array.
+     * @param buffer - The raw block data (minimum 80 bytes for header only)
+     * @returns Parsed Block instance
+     * @throws Error if buffer is too small
+     */
     static fromBuffer(buffer) {
         if (buffer.length < 80)
             throw new Error('Buffer too small (< 80 bytes)');
-        const bufferReader = new BufferReader(buffer);
+        const reader = new BinaryReader(buffer);
         const block = new Block();
-        block.version = bufferReader.readInt32();
-        block.prevHash = bufferReader.readSlice(32);
-        block.merkleRoot = bufferReader.readSlice(32);
-        block.timestamp = bufferReader.readUInt32();
-        block.bits = bufferReader.readUInt32();
-        block.nonce = bufferReader.readUInt32();
+        block.version = reader.readInt32LE();
+        block.prevHash = reader.readBytes(32);
+        block.merkleRoot = reader.readBytes(32);
+        block.timestamp = reader.readUInt32LE();
+        block.bits = reader.readUInt32LE();
+        block.nonce = reader.readUInt32LE();
         if (buffer.length === 80)
             return block;
         const readTransaction = () => {
-            const tx = Transaction.fromBuffer(bufferReader.buffer.subarray(bufferReader.offset), true);
-            bufferReader.offset += tx.byteLength();
+            const tx = Transaction.fromBuffer(reader.data.subarray(reader.offset), true);
+            reader.offset += tx.byteLength();
             return tx;
         };
-        const nTransactions = bufferReader.readVarInt();
+        const nTransactions = reader.readVarInt();
         block.transactions = [];
         for (let i = 0; i < nTransactions; ++i) {
             const tx = readTransaction();
             block.transactions.push(tx);
         }
         const witnessCommit = block.getWitnessCommit();
+        // This Block contains a witness commit
         if (witnessCommit)
             block.witnessCommit = witnessCommit;
         return block;
     }
+    /**
+     * Parses a Block from a hex string.
+     * @param hex - Hexadecimal representation of the block
+     * @returns Parsed Block instance
+     */
     static fromHex(hex) {
-        return Block.fromBuffer(Buffer.from(hex, 'hex'));
+        return Block.fromBuffer(fromHex(hex));
     }
+    /**
+     * Calculates the target threshold from the compact bits representation.
+     * @param bits - Compact bits value from block header
+     * @returns 32-byte target threshold
+     */
     static calculateTarget(bits) {
         const exponent = ((bits & 0xff000000) >> 24) - 3;
         const mantissa = bits & 0x007fffff;
-        const target = Buffer.alloc(32, 0);
-        target.writeUIntBE(mantissa, 29 - exponent, 3);
+        const target = alloc(32);
+        // Write mantissa as big-endian at the computed offset
+        const offset = 29 - exponent;
+        target[offset] = (mantissa >> 16) & 0xff;
+        target[offset + 1] = (mantissa >> 8) & 0xff;
+        target[offset + 2] = mantissa & 0xff;
         return target;
     }
+    /**
+     * Calculates the merkle root for a list of transactions.
+     * @param transactions - Array of transactions
+     * @param forWitness - If true, calculate witness merkle root (for SegWit)
+     * @returns 32-byte merkle root hash
+     * @throws TypeError if transactions is empty or not an array
+     */
     static calculateMerkleRoot(transactions, forWitness) {
-        typeforce([{ getHash: types.Function }], transactions);
+        if (!Array.isArray(transactions)) {
+            throw new TypeError('Expected an array of transactions');
+        }
         if (transactions.length === 0)
             throw errorMerkleNoTxes;
         if (forWitness && !txesHaveWitnessCommit(transactions))
             throw errorWitnessNotSegwit;
         const hashes = transactions.map((transaction) => transaction.getHash(forWitness));
         const rootHash = fastMerkleRoot(hashes, bcrypto.hash256);
-        return forWitness
-            ? bcrypto.hash256(Buffer.concat([rootHash, transactions[0].ins[0].witness[0]]))
-            : rootHash;
+        if (forWitness) {
+            const witness = transactions[0].ins[0].witness[0];
+            const combined = new Uint8Array(rootHash.length + witness.length);
+            combined.set(rootHash);
+            combined.set(witness, rootHash.length);
+            return bcrypto.hash256(combined);
+        }
+        return rootHash;
     }
+    /**
+     * Extracts the witness commitment from the coinbase transaction.
+     * @returns 32-byte witness commitment or null if not found
+     */
     getWitnessCommit() {
-        if (!txesHaveWitnessCommit(this.transactions))
+        if (!this.transactions || !txesHaveWitnessCommit(this.transactions))
             return null;
-        const witnessCommits = this.transactions[0].outs.filter((out) => out.script.subarray(0, 6).equals(Buffer.from('6a24aa21a9ed', 'hex'))).map((out) => out.script.subarray(6, 38));
+        // The merkle root for the witness data is in an OP_RETURN output.
+        // There is no rule for the index of the output, so use filter to find it.
+        // The root is prepended with 0xaa21a9ed so check for 0x6a24aa21a9ed
+        // If multiple commits are found, the output with highest index is assumed.
+        const witnessCommits = this.transactions[0].outs
+            .filter((out) => equals(out.script.subarray(0, 6), WITNESS_COMMIT_PREFIX))
+            .map((out) => out.script.subarray(6, 38));
         if (witnessCommits.length === 0)
             return null;
+        // Use the commit with the highest output (should only be one though)
         const result = witnessCommits[witnessCommits.length - 1];
-        if (!(result instanceof Buffer && result.length === 32))
+        if (!(result instanceof Uint8Array && result.length === 32))
             return null;
         return result;
     }
+    /**
+     * Checks if this block has a witness commitment.
+     * @returns True if the block has a witness commitment
+     */
     hasWitnessCommit() {
-        if (this.witnessCommit instanceof Buffer && this.witnessCommit.length === 32)
+        if (this.witnessCommit instanceof Uint8Array && this.witnessCommit.length === 32)
             return true;
         if (this.getWitnessCommit() !== null)
             return true;
         return false;
     }
+    /**
+     * Checks if any transaction in this block has witness data.
+     * @returns True if any transaction has witness data
+     */
     hasWitness() {
-        return anyTxHasWitness(this.transactions);
+        return this.transactions ? anyTxHasWitness(this.transactions) : false;
     }
+    /**
+     * Calculates the weight of this block.
+     * Weight = (base size * 3) + total size
+     * @returns Block weight in weight units
+     */
     weight() {
         const base = this.byteLength(false, false);
         const total = this.byteLength(false, true);
         return base * 3 + total;
     }
+    /**
+     * Calculates the serialized byte length of this block.
+     * @param headersOnly - If true, return only header size (80 bytes)
+     * @param allowWitness - If true, include witness data in calculation
+     * @returns Byte length of the serialized block
+     */
     byteLength(headersOnly, allowWitness = true) {
         if (headersOnly || !this.transactions)
             return 80;
@@ -101,81 +192,122 @@ export class Block {
             varuint.encodingLength(this.transactions.length) +
             this.transactions.reduce((a, x) => a + x.byteLength(allowWitness), 0));
     }
+    /**
+     * Computes the double-SHA256 hash of the block header.
+     * @returns 32-byte block hash
+     */
     getHash() {
         return bcrypto.hash256(this.toBuffer(true));
     }
+    /**
+     * Returns the block ID (hash in reversed hex format, as displayed in block explorers).
+     * @returns Block ID as hex string
+     */
     getId() {
-        return reverseBuffer(this.getHash()).toString('hex');
+        return toHex(reverse(this.getHash()));
     }
+    /**
+     * Converts the block timestamp to a Date object.
+     * @returns UTC date of the block
+     */
     getUTCDate() {
-        const date = new Date(0);
+        const date = new Date(0); // epoch
         date.setUTCSeconds(this.timestamp);
         return date;
     }
+    /**
+     * Serializes the block to a Uint8Array.
+     * @param headersOnly - If true, only serialize the 80-byte header
+     * @returns Serialized block data
+     */
     toBuffer(headersOnly) {
-        const buffer = Buffer.allocUnsafe(this.byteLength(headersOnly));
-        const bufferWriter = new BufferWriter(buffer);
-        bufferWriter.writeInt32(this.version);
-        bufferWriter.writeSlice(this.prevHash);
-        bufferWriter.writeSlice(this.merkleRoot);
-        bufferWriter.writeUInt32(this.timestamp);
-        bufferWriter.writeUInt32(this.bits);
-        bufferWriter.writeUInt32(this.nonce);
+        if (!this.prevHash)
+            throw new TypeError('Block prevHash is required');
+        if (!this.merkleRoot)
+            throw new TypeError('Block merkleRoot is required');
+        const buffer = new Uint8Array(this.byteLength(headersOnly));
+        const writer = new BinaryWriter(buffer);
+        writer.writeInt32LE(this.version);
+        writer.writeBytes(this.prevHash);
+        writer.writeBytes(this.merkleRoot);
+        writer.writeUInt32LE(this.timestamp);
+        writer.writeUInt32LE(this.bits);
+        writer.writeUInt32LE(this.nonce);
         if (headersOnly || !this.transactions)
             return buffer;
-        const encoded = varuint.encode(this.transactions.length, buffer, bufferWriter.offset);
-        bufferWriter.offset += encoded.bytes;
+        writer.writeVarInt(this.transactions.length);
         this.transactions.forEach((tx) => {
-            const txSize = tx.byteLength();
-            tx.toBuffer(buffer, bufferWriter.offset);
-            bufferWriter.offset += txSize;
+            const txSize = tx.byteLength(); // TODO: extract from toBuffer?
+            tx.toBuffer(buffer.subarray(writer.offset));
+            writer.offset += txSize;
         });
         return buffer;
     }
+    /**
+     * Serializes the block to a hex string.
+     * @param headersOnly - If true, only serialize the 80-byte header
+     * @returns Hex string representation of the block
+     */
     toHex(headersOnly) {
-        return this.toBuffer(headersOnly).toString('hex');
+        return toHex(this.toBuffer(headersOnly));
     }
+    /**
+     * Validates the merkle root and witness commitment (if present).
+     * @returns True if the transaction roots are valid
+     */
     checkTxRoots() {
+        // If the Block has segwit transactions but no witness commit,
+        // there's no way it can be valid, so fail the check.
         const hasWitnessCommit = this.hasWitnessCommit();
         if (!hasWitnessCommit && this.hasWitness())
             return false;
-        return this.__checkMerkleRoot() && (hasWitnessCommit ? this.__checkWitnessCommit() : true);
+        return this.#checkMerkleRoot() && (hasWitnessCommit ? this.#checkWitnessCommit() : true);
     }
+    /**
+     * Validates that the block hash meets the target threshold (proof of work).
+     * @returns True if the block's proof of work is valid
+     */
     checkProofOfWork() {
-        const hash = reverseBuffer(this.getHash());
+        const hash = reverse(this.getHash());
         const target = Block.calculateTarget(this.bits);
-        return hash.compare(target) <= 0;
+        return compare(hash, target) <= 0;
     }
-    __checkMerkleRoot() {
+    #checkMerkleRoot() {
         if (!this.transactions)
             throw errorMerkleNoTxes;
+        if (!this.merkleRoot)
+            throw new TypeError('Block merkleRoot is required');
         const actualMerkleRoot = Block.calculateMerkleRoot(this.transactions);
-        return this.merkleRoot.compare(actualMerkleRoot) === 0;
+        return compare(this.merkleRoot, actualMerkleRoot) === 0;
     }
-    __checkWitnessCommit() {
+    #checkWitnessCommit() {
         if (!this.transactions)
             throw errorMerkleNoTxes;
         if (!this.hasWitnessCommit())
             throw errorWitnessNotSegwit;
+        if (!this.witnessCommit)
+            throw errorWitnessNotSegwit;
         const actualWitnessCommit = Block.calculateMerkleRoot(this.transactions, true);
-        return this.witnessCommit.compare(actualWitnessCommit) === 0;
+        return compare(this.witnessCommit, actualWitnessCommit) === 0;
     }
 }
+/**
+ * Checks if the coinbase transaction has witness data (required for witness commitment).
+ * @param transactions - Array of transactions
+ * @returns True if coinbase has witness data
+ */
 function txesHaveWitnessCommit(transactions) {
-    return (transactions instanceof Array &&
-        transactions[0] &&
-        transactions[0].ins &&
-        transactions[0].ins instanceof Array &&
-        transactions[0].ins[0] &&
-        transactions[0].ins[0].witness &&
-        transactions[0].ins[0].witness instanceof Array &&
-        transactions[0].ins[0].witness.length > 0);
+    const coinbase = transactions[0];
+    if (!coinbase?.ins?.[0]?.witness)
+        return false;
+    return coinbase.ins[0].witness.length > 0;
 }
+/**
+ * Checks if any transaction in the array has witness data.
+ * @param transactions - Array of transactions
+ * @returns True if any transaction has witness data
+ */
 function anyTxHasWitness(transactions) {
-    return (transactions instanceof Array &&
-        transactions.some((tx) => typeof tx === 'object' &&
-            tx.ins instanceof Array &&
-            tx.ins.some((input) => typeof input === 'object' &&
-                input.witness instanceof Array &&
-                input.witness.length > 0)));
+    return transactions.some((tx) => tx.ins?.some((input) => input.witness && input.witness.length > 0));
 }
+//# sourceMappingURL=block.js.map

package/build/block.js.map

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

package/build/branded.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Branded type definitions for type-safe primitives.
+ *
+ * @packageDocumentation
+ */
+declare const __brand: unique symbol;
+type Brand<T, B extends string> = T & {
+    readonly [__brand]: B;
+};
+export type Bytes32 = Brand<Uint8Array, 'Bytes32'>;
+export type Bytes20 = Brand<Uint8Array, 'Bytes20'>;
+export type PublicKey = Brand<Uint8Array, 'PublicKey'>;
+export type XOnlyPublicKey = Brand<Uint8Array, 'XOnlyPublicKey'>;
+export type Satoshi = Brand<bigint, 'Satoshi'>;
+export type PrivateKey = Brand<Uint8Array, 'PrivateKey'>;
+export type Signature = Brand<Uint8Array, 'Signature'>;
+export type SchnorrSignature = Brand<Uint8Array, 'SchnorrSignature'>;
+export type Script = Brand<Uint8Array, 'Script'>;
+export {};
+//# sourceMappingURL=branded.d.ts.map

package/build/branded.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branded.d.ts","sourceRoot":"","sources":["../src/branded.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,CAAC,MAAM,OAAO,EAAE,OAAO,MAAM,CAAC;AACrC,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,IAAI,CAAC,GAAG;IAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;CAAE,CAAC;AAEhE,MAAM,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;AACnD,MAAM,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;AACnD,MAAM,MAAM,SAAS,GAAG,KAAK,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;AACvD,MAAM,MAAM,cAAc,GAAG,KAAK,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;AACjE,MAAM,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAC/C,MAAM,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;AACzD,MAAM,MAAM,SAAS,GAAG,KAAK,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;AACvD,MAAM,MAAM,gBAAgB,GAAG,KAAK,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC;AACrE,MAAM,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC"}

package/build/branded.js

@@ -0,0 +1,7 @@
+/**
+ * Branded type definitions for type-safe primitives.
+ *
+ * @packageDocumentation
+ */
+export {};
+//# sourceMappingURL=branded.js.map

package/build/branded.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"branded.js","sourceRoot":"","sources":["../src/branded.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/build/crypto/crypto.d.ts

@@ -1 +1,2 @@
 export { createHash, createHmac, pbkdf2Sync, randomBytes } from 'crypto';
+//# sourceMappingURL=crypto.d.ts.map

package/build/crypto/crypto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.d.ts","sourceRoot":"","sources":["../../src/crypto/crypto.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC"}

package/build/crypto/crypto.js

@@ -1 +1,2 @@
 export { createHash, createHmac, pbkdf2Sync, randomBytes } from 'crypto';
+//# sourceMappingURL=crypto.js.map

package/build/crypto/crypto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.js","sourceRoot":"","sources":["../../src/crypto/crypto.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC"}

package/build/crypto.d.ts

@@ -1,13 +1,52 @@
-export declare function ripemd160(buffer: Buffer): Buffer;
-export declare function sha1(buffer: Buffer): Buffer;
-export declare function sha256(buffer: Buffer): Buffer;
-export declare function hash160(buffer: Buffer): Buffer;
-export declare function hash256(buffer: Buffer): Buffer;
+import type { Bytes32, Bytes20 } from './types.js';
+/**
+ * Computes RIPEMD-160 hash of the input.
+ * @param data - Input data
+ * @returns 20-byte hash (Bytes20)
+ */
+export declare function ripemd160(data: Uint8Array): Bytes20;
+/**
+ * Computes SHA-1 hash of the input.
+ * @param data - Input data
+ * @returns 20-byte hash (Bytes20)
+ */
+export declare function sha1(data: Uint8Array): Bytes20;
+/**
+ * Computes SHA-256 hash of the input.
+ * @param data - Input data
+ * @returns 32-byte hash (Bytes32)
+ */
+export declare function sha256(data: Uint8Array): Bytes32;
+/**
+ * Computes HASH160 (RIPEMD160(SHA256(data))) of the input.
+ * @param data - Input data
+ * @returns 20-byte hash (Bytes20)
+ */
+export declare function hash160(data: Uint8Array): Bytes20;
+/**
+ * Computes double SHA-256 hash of the input.
+ * @param data - Input data
+ * @returns 32-byte hash (Bytes32)
+ */
+export declare function hash256(data: Uint8Array): Bytes32;
+/**
+ * BIP340/Taproot tag names for tagged hashing.
+ */
 export declare const TAGS: readonly ["BIP0340/challenge", "BIP0340/aux", "BIP0340/nonce", "TapLeaf", "TapBranch", "TapSighash", "TapTweak", "KeyAgg list", "KeyAgg coefficient"];
 export type TaggedHashPrefix = (typeof TAGS)[number];
 type TaggedHashPrefixes = {
-    [key in TaggedHashPrefix]: Buffer;
+    [key in TaggedHashPrefix]: Uint8Array;
 };
+/**
+ * Precomputed tagged hash prefixes: SHA256(tag) || SHA256(tag)
+ */
 export declare const TAGGED_HASH_PREFIXES: TaggedHashPrefixes;
-export declare function taggedHash(prefix: TaggedHashPrefix, data: Buffer): Buffer;
+/**
+ * Computes a BIP340-style tagged hash.
+ * @param prefix - The tag name
+ * @param data - Input data
+ * @returns 32-byte hash (Bytes32)
+ */
+export declare function taggedHash(prefix: TaggedHashPrefix, data: Uint8Array): Bytes32;
 export {};
+//# sourceMappingURL=crypto.d.ts.map

package/build/crypto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.d.ts","sourceRoot":"","sources":["../src/crypto.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAE9C;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAEhD;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAEjD;AAED;;GAEG;AACH,eAAO,MAAM,IAAI,uJAUP,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,KAAK,kBAAkB,GAAG;KACrB,GAAG,IAAI,gBAAgB,GAAG,UAAU;CACxC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,kBAsDlC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAE9E"}