@bsv/overlay 2.0.3 → 2.0.4

package/README.md

@@ -23,123 +23,243 @@ The Overlay Services Engine enables dynamic tracking and management of UTXO-base
 
 ## Getting Started
 
-### Choose the Right Package
-
-Most application developers should start with the higher-level deployment tools:
-
-- [`@bsv/overlay-express`](https://github.com/bsv-blockchain/overlay-express): opinionated Express wrapper for running overlay nodes with HTTP routes, health checks, storage configuration, SHIP/SLAP discovery, and GASP synchronization.
-- [`@bsv/lars`](https://github.com/bsv-blockchain/lars): local runtime for BSV application projects that use `deployment-info.json`.
-- [`@bsv/cars-cli`](https://github.com/bsv-blockchain/cars-cli): cloud deployment workflow for the same `deployment-info.json` project structure.
-
-Use this package, `@bsv/overlay`, when you need direct control over the Overlay Services Engine itself, such as custom storage, custom broadcasting, or a non-Express host.
-
 ### Installation
 
-For direct engine integration, install the engine with the current BSV TypeScript SDK:
+You'll usually want to wrap the Engine within an HTTP server. To get set up with Express, create a new project and install everything you'll need:
 
 ```
-npm i @bsv/overlay @bsv/sdk knex
+npm i express body-parser @bsv/sdk @bsv/overlay hello-services knex
 ```
 
 ### Basic Usage
 
-Create an `Engine` with topic managers, lookup services, a storage implementation, and a chain tracker. The example below uses minimal in-memory stubs so the shape is clear. Production services should use durable storage, a real chain tracker, and a broadcaster appropriate for the target network.
-
-```ts
-import {
-  Engine,
-  type AdmittanceInstructions,
-  type LookupFormula,
-  type LookupQuestion,
-  type Output,
-  type Storage,
-  type TopicManager,
-  type LookupService
-} from '@bsv/overlay'
-
-const topicManager: TopicManager = {
-  async identifyAdmissibleOutputs (): Promise<AdmittanceInstructions> {
-    return {
-      outputsToAdmit: [],
-      coinsToRetain: []
-    }
-  },
-  async getDocumentation () {
-    return 'Admits outputs for the example topic.'
-  },
-  async getMetaData () {
-    return {
-      name: 'Example Topic Manager',
-      shortDescription: 'Example topic manager',
-      iconURL: '',
-      version: '1.0.0',
-      informationURL: ''
+In your server's main file, you can set everything up. Create a new Engine to run the overlay services you want, then expose some routes over HTTP. For example:
+
+```js
+const express = require('express')
+const bodyparser = require('body-parser')
+const { Engine, KnexStorage, HelloTopicManager, HelloLookupService, HelloStorageEngine } = require('@bsv/overlay')
+import { WhatsOnChain, NodejsHttpClient, ARC, ArcConfig, MerklePath } from '@bsv/sdk'
+// Populate a Knexfile with your database credentials
+const knex = require('knex')(require('../knexfile.js'))
+const app = express()
+app.use(bodyparser.json({ limit: '1gb', type: 'application/json' }))
+
+const engine = new Engine(
+    {
+      hello: new HelloTopicManager(),
+    },
+    {
+      hello: new HelloLookupService({
+        storageEngine: new HelloStorageEngine({
+          knex
+        })
+      }),
+    },
+    new KnexStorageEngine({
+      knex
+    }),
+    new CombinatorialChainTracker([
+      new WhatsOnChain(
+        NODE_ENV === 'production' ? 'main' : 'test',
+        {
+          httpClient: new NodejsHttpClient(https)
+        })
+    ]),
+    HOSTING_DOMAIN as string,
+    SHIP_TRACKERS,
+    SLAP_TRACKERS,
+    new ARC('https://arc.taal.com', arcConfig)
+  )
+
+// This allows the API to be used everywhere when CORS is enforced
+app.use((req, res, next) => {
+  res.header('Access-Control-Allow-Origin', '*')
+  res.header('Access-Control-Allow-Headers', '*')
+  res.header('Access-Control-Allow-Methods', '*')
+  res.header('Access-Control-Expose-Headers', '*')
+  res.header('Access-Control-Allow-Private-Network', 'true')
+  if (req.method === 'OPTIONS') {
+    res.sendStatus(200)
+  } else {
+    next()
+  }
+})
+
+// Serve a static documentstion site, if you have one.
+app.use(express.static('public'))
+
+// List hosted topic managers and lookup services
+app.get(`/listTopicManagers`, async (req, res) => {
+  try {
+    const result = await engine.listTopicManagers()
+    return res.status(200).json(result)
+  } catch (error) {
+    return res.status(400).json({
+      status: 'error',
+      code: error.code,
+      description: error.message
+    })
+  }
+})
+app.get(`/listLookupServiceProviders`, async (req, res) => {
+  try {
+    const result = await engine.listLookupServiceProviders()
+    return res.status(200).json(result)
+  } catch (error) {
+    return res.status(400).json({
+      status: 'error',
+      code: error.code,
+      description: error.message
+    })
+  }
+})
+
+// Host documentation for the services
+app.get(`/getDocumentationForTopicManager`, async (req, res) => {
+  try {
+    const result = await engine.getDocumentationForTopicManger(req.query.manager)
+    return res.status(200).json(result)
+  } catch (error) {
+    return res.status(400).json({
+      status: 'error',
+      code: error.code,
+      description: error.message
+    })
+  }
+})
+app.get(`/getDocumentationForLookupServiceProvider`, async (req, res) => {
+  try {
+    const result = await engine.getDocumentationForLookupServiceProvider(req.query.lookupServices)
+    return res.status(200).json(result)
+  } catch (error) {
+    return res.status(400).json({
+      status: 'error',
+      code: error.code,
+      description: error.message
+    })
+  }
+})
+
+// Submit transactions and facilitate lookup requests
+app.post(`/submit`, async (req, res) => {
+  try {
+    // Parse out the topics and construct the tagged BEEF
+    const topics = JSON.parse(req.headers['x-topics'] as string)
+    const taggedBEEF: TaggedBEEF = {
+      beef: Array.from(req.body as number[]),
+      topics
     }
+
+    // Using a callback function, we can just return once our steak is ready
+    // instead of having to wait for all the broadcasts to occur.
+    await engine.submit(taggedBEEF, (steak: STEAK) => {
+      return res.status(200).json(steak)
+    })
+  } catch (error) {
+    return res.status(400).json({
+      status: 'error',
+      code: error.code,
+      description: error.message
+    })
+  }
+})
+app.post(`/lookup`, async (req, res) => {
+  try {
+    const result = await engine.lookup(req.body)
+    return res.status(200).json(result)
+  } catch (error) {
+    return res.status(400).json({
+      status: 'error',
+      code: error.code,
+      description: error.message
+    })
   }
-}
-
-const lookupService: LookupService = {
-  async outputAdmittedByTopic (): Promise<void> {},
-  async outputSpent (): Promise<void> {},
-  async outputEvicted (): Promise<void> {},
-  async lookup (_question: LookupQuestion): Promise<LookupFormula> {
-    return {
-      type: 'formula',
-      outpoints: []
+})
+
+app.post('/arc-ingest', (req, res) => {
+  (async () => {
+    try {
+      const merklePath = MerklePath.fromHex(req.body.merklePath)
+      await engine.handleNewMerkleProof(req.body.txid, merklePath, req.body.blockHeight)
+      return res.status(200).json({ status: 'success', message: 'transaction status updated' })
+    } catch (error) {
+      console.error(error)
+      return res.status(400).json({
+        status: 'error',
+        message: error instanceof Error ? error.message : 'An unknown error occurred'
+      })
     }
-  },
-  async getDocumentation () {
-    return 'Looks up outputs admitted by the example topic.'
-  },
-  async getMetaData () {
-    return {
-      name: 'Example Lookup Service',
-      shortDescription: 'Example lookup service',
-      iconURL: '',
-      version: '1.0.0',
-      informationURL: ''
+  })().catch(() => {
+    res.status(500).json({
+      status: 'error',
+      message: 'Unexpected error'
+    })
+  })
+})
+
+app.post('/requestSyncResponse', (req, res) => {
+  (async () => {
+    try {
+      const topic = req.headers['x-bsv-topic'] as string
+      const response = await engine.provideForeignSyncResponse(req.body, topic)
+      return res.status(200).json(response)
+    } catch (error) {
+      console.error(error)
+      return res.status(400).json({
+        status: 'error',
+        message: error instanceof Error ? error.message : 'An unknown error occurred'
+      })
     }
-  }
-}
-
-const storage: Storage = {
-  async findOutput (): Promise<Output | null> { return null },
-  async findOutputsForTransaction (): Promise<Output[]> { return [] },
-  async findOutputsForTopic (): Promise<Output[]> { return [] },
-  async findUTXOHistory (): Promise<Output[]> { return [] },
-  async insertOutput (): Promise<void> {},
-  async updateConsumedBy (): Promise<void> {},
-  async updateTransactionBEEF (): Promise<void> {},
-  async deleteOutput (): Promise<void> {},
-  async startGASPSync (): Promise<void> {},
-  async updateLastInteraction (): Promise<void> {},
-  async getLastInteraction (): Promise<Date | null> { return null },
-  async getSyncState (): Promise<unknown> { return undefined },
-  async setSyncState (): Promise<void> {}
-}
-
-const engine = new Engine(
-  { tm_example: topicManager },
-  { ls_example: lookupService },
-  storage,
-  'scripts only',
-  'https://example-overlay.example',
-  [],
-  [],
-  undefined,
-  undefined,
-  { tm_example: false }
-)
-
-const topics = await engine.listTopicManagers()
-const services = await engine.listLookupServiceProviders()
+  })().catch(() => {
+    res.status(500).json({
+      status: 'error',
+      message: 'Unexpected error'
+    })
+  })
+})
+
+app.post('/requestForeignGASPNode', (req, res) => {
+  (async () => {
+    try {
+      console.log(req.body)
+      const { graphID, txid, outputIndex, metadata } = req.body
+      const response = await engine.provideForeignGASPNode(graphID, txid, outputIndex)
+      return res.status(200).json(response)
+    } catch (error) {
+      console.error(error)
+      return res.status(400).json({
+        status: 'error',
+        message: error instanceof Error ? error.message : 'An unknown error occurred'
+      })
+    }
+  })().catch(() => {
+    res.status(500).json({
+      status: 'error',
+      message: 'Unexpected error'
+    })
+  })
+})
+
+// 404, all other routes are not found.
+app.use((req, res) => {
+  console.log('404', req.url)
+  res.status(404).json({
+    status: 'error',
+    code: 'ERR_ROUTE_NOT_FOUND',
+    description: 'Route not found.'
+  })
+})
+
+// Start your Engines!
+  app.listen(8080, () => {
+    console.log('BSV Overlay Services Engine is listening on port', 8080)
+  })
 ```
 
-For deployable HTTP examples, use [`@bsv/overlay-express`](https://github.com/bsv-blockchain/overlay-express) and [`overlay-express-examples`](https://github.com/bsv-blockchain/overlay-express-examples). For local and cloud application runtime workflows, use LARS and CARS with the BRC-102 `deployment-info.json` project structure.
-
-For lower-level engine examples, check out the [full documentation](#documentation).
+For more detailed tutorials and examples, check out the [full documentation](#documentation).
 
-The Overlay Services Engine is also richly documented with code-level annotations. This should show up well within editors like VSCode.
+The Overlay Services Engine is also richly documented with code-level annotations. This should show up well within editors like VSCode. 
 
 <!-- ## Documentation
 
@@ -151,10 +271,10 @@ The Overlay Services Engine is also richly documented with code-level annotation
 - History management and state tracking
 - Lookup Services
 - Storage engine abstractions
-- Examples, HTTP wrapper, and docs through `@bsv/overlay-express`
-- ARC callback handling through overlay hosts
-- Distributed overlay availability advertisements with SHIP and SLAP
-- Federated transaction synchronization with GASP
+- [WIP] Examples, HTTP wrapper and Docs
+- [WIP] Arc Proof Acquisition
+- [WIP] Distributed Overlay Availability Advertisements
+- [WIP] Federated Transaction Synchronization
 
 ## Contribution Guidelines
 

package/dist/cjs/mod.js

@@ -33,10 +33,15 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.KnexStorageMigrations = exports.KnexStorage = exports.Engine = void 0;
+exports.KnexStorageMigrations = exports.KnexStorage = exports.extractMerkleProofMetadata = exports.computeTac = exports.computeBasmRoot = exports.BASM_ZERO_HASH = exports.Engine = void 0;
 // Fundamentals
 var Engine_js_1 = require("./src/Engine.js");
 Object.defineProperty(exports, "Engine", { enumerable: true, get: function () { return Engine_js_1.Engine; } });
+var BASM_js_1 = require("./src/BASM.js");
+Object.defineProperty(exports, "BASM_ZERO_HASH", { enumerable: true, get: function () { return BASM_js_1.BASM_ZERO_HASH; } });
+Object.defineProperty(exports, "computeBasmRoot", { enumerable: true, get: function () { return BASM_js_1.computeBasmRoot; } });
+Object.defineProperty(exports, "computeTac", { enumerable: true, get: function () { return BASM_js_1.computeTac; } });
+Object.defineProperty(exports, "extractMerkleProofMetadata", { enumerable: true, get: function () { return BASM_js_1.extractMerkleProofMetadata; } });
 // The Knex storage system
 var KnexStorage_js_1 = require("./src/storage/knex/KnexStorage.js");
 Object.defineProperty(exports, "KnexStorage", { enumerable: true, get: function () { return KnexStorage_js_1.KnexStorage; } });

package/dist/cjs/mod.js.map

@@ -1 +1 @@
-{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../mod.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,eAAe;AACf,6CAAwC;AAA/B,mGAAA,MAAM,OAAA;AAYf,0BAA0B;AAC1B,oEAA+D;AAAtD,6GAAA,WAAW,OAAA;AACpB,8FAA6E"}
+{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../mod.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,eAAe;AACf,6CAAwC;AAA/B,mGAAA,MAAM,OAAA;AAWf,yCAKsB;AAJpB,yGAAA,cAAc,OAAA;AACd,0GAAA,eAAe,OAAA;AACf,qGAAA,UAAU,OAAA;AACV,qHAAA,0BAA0B,OAAA;AAqB5B,0BAA0B;AAC1B,oEAA+D;AAAtD,6GAAA,WAAW,OAAA;AACpB,8FAA6E"}

package/dist/cjs/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bsv/overlay",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "type": "commonjs",
   "description": "BSV Blockchain Overlay Services Engine",
   "files": [
@@ -23,7 +23,8 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/bsv-blockchain/overlay-services.git"
+    "url": "git+https://github.com/bsv-blockchain/ts-stack.git",
+    "directory": "packages/overlays/overlay"
   },
   "keywords": [
     "BSV",
@@ -35,21 +36,22 @@
   "author": "BSV Association",
   "license": "SEE LICENSE IN LICENSE.txt",
   "bugs": {
-    "url": "https://github.com/bitcoin-sv/overlay-services/issues"
+    "url": "https://github.com/bsv-blockchain/ts-stack/issues"
   },
-  "homepage": "https://github.com/bitcoin-sv/overlay-services#readme",
+  "homepage": "https://github.com/bsv-blockchain/ts-stack/tree/main/packages/overlays/overlay#readme",
   "devDependencies": {
-    "@types/jest": "^29.5.12",
-    "jest": "^29.7.0",
-    "ts-jest": "^29.1.1",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^25.9.3",
+    "jest": "^30.4.2",
+    "ts-jest": "^29.4.11",
     "ts-standard": "^12.0.2",
     "ts2md": "^0.2.0",
     "tsconfig-to-dual-package": "^1.2.0",
-    "typescript": "^5.2.2"
+    "typescript": "^6.0.3"
   },
   "dependencies": {
-    "@bsv/gasp": "^1.2.2",
-    "@bsv/sdk": "^2.0.14",
-    "knex": "^3.1.0"
+    "@bsv/gasp": "^1.2.3",
+    "@bsv/sdk": "^2.1.4",
+    "knex": "^3.2.10"
   }
 }

package/dist/cjs/src/BASM.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BASM_ZERO_HASH = void 0;
+exports.computeBasmRoot = computeBasmRoot;
+exports.computeTac = computeTac;
+exports.extractMerkleProofMetadata = extractMerkleProofMetadata;
+const node_crypto_1 = require("node:crypto");
+exports.BASM_ZERO_HASH = '0000000000000000000000000000000000000000000000000000000000000000';
+function sha256d(buffer) {
+    const first = (0, node_crypto_1.createHash)('sha256').update(buffer).digest();
+    return (0, node_crypto_1.createHash)('sha256').update(first).digest();
+}
+function assertHashHex(hash, label) {
+    if (!/^[0-9a-fA-F]{64}$/.test(hash)) {
+        throw new Error(`${label} must be 32 bytes of hex`);
+    }
+}
+function displayHexToInternal(hash) {
+    assertHashHex(hash, 'hash');
+    return Buffer.from(hash, 'hex').reverse();
+}
+function internalToDisplayHex(hash) {
+    return Buffer.from(hash).reverse().toString('hex');
+}
+function normalizeAdmittedTxids(admitted) {
+    return admitted
+        .map((item, originalIndex) => {
+        if (typeof item === 'string') {
+            return { txid: item, blockIndex: originalIndex };
+        }
+        return item;
+    })
+        .sort((a, b) => a.blockIndex - b.blockIndex)
+        .map(item => item.txid.toLowerCase());
+}
+/**
+ * Computes a BRC-136 BASM root from admitted topic txids.
+ *
+ * The API accepts normal display-order txid hex because that is what the BSV
+ * TypeScript stack exposes at its public boundaries. Hashing is performed on
+ * internal byte order as required by the BRC, and the returned root is display
+ * order for JSON/wire compatibility.
+ */
+function computeBasmRoot(admitted) {
+    const txids = normalizeAdmittedTxids(admitted);
+    if (txids.length === 0) {
+        return exports.BASM_ZERO_HASH;
+    }
+    let layer = txids.map(txid => displayHexToInternal(txid));
+    if (layer.length === 1) {
+        return internalToDisplayHex(layer[0]);
+    }
+    while (layer.length > 1) {
+        const next = [];
+        for (let i = 0; i < layer.length; i += 2) {
+            const left = layer[i];
+            const right = i + 1 < layer.length ? layer[i + 1] : left;
+            next.push(sha256d(Buffer.concat([left, right])));
+        }
+        layer = next;
+    }
+    return internalToDisplayHex(layer[0]);
+}
+/**
+ * Computes the BRC-136 cumulative Topic Anchor Chain hash:
+ * SHA256d(prevTac || blockHash || basmRoot), with all inputs reversed to
+ * internal byte order before hashing and the output returned as display hex.
+ */
+function computeTac(prevTac, blockHash, basmRoot) {
+    const input = Buffer.concat([
+        displayHexToInternal(prevTac.toLowerCase()),
+        displayHexToInternal(blockHash.toLowerCase()),
+        displayHexToInternal(basmRoot.toLowerCase())
+    ]);
+    return internalToDisplayHex(sha256d(input));
+}
+function extractMerkleProofMetadata(txid, proof) {
+    var _a;
+    if (proof === undefined) {
+        return undefined;
+    }
+    const leaf = (_a = proof.path[0]) === null || _a === void 0 ? void 0 : _a.find(candidate => candidate.hash === txid);
+    if (leaf === undefined) {
+        return undefined;
+    }
+    return {
+        blockHeight: proof.blockHeight,
+        blockIndex: leaf.offset,
+        merkleRoot: proof.computeRoot(txid)
+    };
+}
+//# sourceMappingURL=BASM.js.map

package/dist/cjs/src/BASM.js.map

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

package/dist/cjs/src/BASMRemote.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BASMRemote = void 0;
+class BASMRemote {
+    constructor(endpoint, topic, fetchImpl = fetch.bind(globalThis)) {
+        this.endpoint = endpoint;
+        this.topic = topic;
+        this.fetchImpl = fetchImpl;
+    }
+    async requestTopicAnchorTip() {
+        return await this.post('/requestTopicAnchorTip', {});
+    }
+    async requestTopicAnchorRange(fromHeight, toHeight) {
+        return await this.post('/requestTopicAnchorRange', { fromHeight, toHeight });
+    }
+    async requestAdmittedList(blockHeight, blockHash) {
+        return await this.post('/requestAdmittedList', { blockHeight, blockHash });
+    }
+    async requestCompoundMerklePath(blockHeight, txids) {
+        return await this.post('/requestCompoundMerklePath', { blockHeight, txids });
+    }
+    async requestRawTransactions(txids) {
+        return await this.post('/requestRawTransactions', { txids });
+    }
+    async post(path, body) {
+        const response = await this.fetchImpl(new URL(path, this.endpoint).toString(), {
+            method: 'POST',
+            headers: {
+                Accept: 'application/json',
+                'Content-Type': 'application/json',
+                'x-bsv-topic': this.topic
+            },
+            body: JSON.stringify(body)
+        });
+        const text = await response.text();
+        if (!response.ok) {
+            throw new Error(`BASM peer ${this.endpoint} returned ${response.status}: ${text}`);
+        }
+        return (text.length === 0 ? {} : JSON.parse(text));
+    }
+}
+exports.BASMRemote = BASMRemote;
+//# sourceMappingURL=BASMRemote.js.map

package/dist/cjs/src/BASMRemote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BASMRemote.js","sourceRoot":"","sources":["../../../src/BASMRemote.ts"],"names":[],"mappings":";;;AAQA,MAAa,UAAU;IACrB,YACmB,QAAgB,EAChB,KAAa,EACb,YAA0B,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC;QAFhD,aAAQ,GAAR,QAAQ,CAAQ;QAChB,UAAK,GAAL,KAAK,CAAQ;QACb,cAAS,GAAT,SAAS,CAAuC;IAC/D,CAAC;IAEL,KAAK,CAAC,qBAAqB;QACzB,OAAO,MAAM,IAAI,CAAC,IAAI,CAAiB,wBAAwB,EAAE,EAAE,CAAC,CAAA;IACtE,CAAC;IAED,KAAK,CAAC,uBAAuB,CAAC,UAAkB,EAAE,QAAgB;QAChE,OAAO,MAAM,IAAI,CAAC,IAAI,CAA2B,0BAA0B,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAA;IACxG,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,WAAmB,EAAE,SAAkB;QAC/D,OAAO,MAAM,IAAI,CAAC,IAAI,CAAuB,sBAAsB,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAA;IAClG,CAAC;IAED,KAAK,CAAC,yBAAyB,CAAC,WAAmB,EAAE,KAAe;QAClE,OAAO,MAAM,IAAI,CAAC,IAAI,CAA6B,4BAA4B,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAA;IAC1G,CAAC;IAED,KAAK,CAAC,sBAAsB,CAAC,KAAe;QAC1C,OAAO,MAAM,IAAI,CAAC,IAAI,CAAyB,yBAAyB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;IACtF,CAAC;IAEO,KAAK,CAAC,IAAI,CAAI,IAAY,EAAE,IAAa;QAC/C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,EAAE;YAC7E,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,MAAM,EAAE,kBAAkB;gBAC1B,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,IAAI,CAAC,KAAK;aAC1B;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAA;QAEF,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;QAClC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,aAAa,IAAI,CAAC,QAAQ,aAAa,QAAQ,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC,CAAA;QACpF,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAM,CAAA;IACzD,CAAC;CACF;AA7CD,gCA6CC"}