@bsv/overlay-discovery-services 0.1.0

package/LICENSE.txt

@@ -0,0 +1,28 @@
+Open BSV License version 4
+
+Copyright (c) 2023 BSV Blockchain Association ("Bitcoin Association")
+ 
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+ 
+1 - The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+2 - The Software, and any software that is derived from the Software or parts thereof,
+can only be used on the Bitcoin SV blockchains. The Bitcoin SV blockchains are defined,
+for purposes of this license, as the Bitcoin blockchain containing block height #556767
+with the hash "000000000000000001d956714215d96ffc00e0afda4cd0a96c96f8d802b1662b" and
+that contains the longest persistent chain of blocks accepted by this Software and which are valid under the rules set forth in the Bitcoin white paper (S. Nakamoto, Bitcoin: A Peer-to-Peer Electronic Cash System, posted online October 2008) and the latest version of this Software available in this repository or another repository designated by Bitcoin Association,
+as well as the test blockchains that contain the longest persistent chains of blocks accepted by this Software and which are valid under the rules set forth in the Bitcoin whitepaper (S. Nakamoto, Bitcoin: A Peer-to-Peer Electronic Cash System, posted online October 2008) and the latest version of this Software available in this repository, or another repository designated by Bitcoin Association
+ 
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,13 @@
+# Overlay Discovery Services
+
+BSV BLOCKCHAIN | Overlay Discovery Services
+
+This package contains the Service Host Interconnect and Service Lookup Availability systems.
+
+It also contains SHIP/SLAP token advertiser implementations.
+
+For questions, bug reports, or feature requests, please open an issue on GitHub.
+
+## License
+
+The license for the code in this repository is the Open BSV License. Refer to [LICENSE.txt](./LICENSE.txt) for the license text.

package/dist/cjs/mod.js

@@ -0,0 +1,28 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./src/SHIP/SHIPLookupService.js"), exports);
+__exportStar(require("./src/SHIP/SHIPStorage.js"), exports);
+__exportStar(require("./src/SHIP/SHIPTopicManager.js"), exports);
+__exportStar(require("./src/SLAP/SLAPLookupService.js"), exports);
+__exportStar(require("./src/SLAP/SLAPStorage.js"), exports);
+__exportStar(require("./src/SLAP/SLAPTopicManager.js"), exports);
+__exportStar(require("./src/LegacyNinjaAdvertiser.js"), exports);
+__exportStar(require("./src/utils/isValidDomain.js"), exports);
+__exportStar(require("./src/utils/isValidServiceName.js"), exports);
+__exportStar(require("./src/utils/verifyToken.js"), exports);
+__exportStar(require("./src/types.js"), exports);
+//# sourceMappingURL=mod.js.map

package/dist/cjs/mod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../mod.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kEAA+C;AAC/C,4DAAyC;AACzC,iEAA8C;AAE9C,kEAA+C;AAC/C,4DAAyC;AACzC,iEAA8C;AAE9C,iEAA8C;AAE9C,+DAA4C;AAC5C,oEAAiD;AACjD,6DAA0C;AAE1C,iDAA8B"}

package/dist/cjs/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@bsv/overlay-discovery-services",
+  "version": "0.1.0",
+  "type": "commonjs",
+  "description": "BSV Blockchain Overlay Services Engine",
+  "files": [
+    "dist",
+    "src",
+    "docs",
+    "mod.ts",
+    "LICENSE.txt"
+  ],
+  "scripts": {
+    "test": "npm run build && jest",
+    "test:watch": "npm run build && jest --watch",
+    "test:coverage": "npm run build && jest --coverage",
+    "lint": "ts-standard --fix src/**/*.ts",
+    "build": "tsc -b && tsconfig-to-dual-package tsconfig.cjs.json",
+    "dev": "tsc -b -w",
+    "prepublish": "npm run build",
+    "doc": "ts2md --inputFilename=mod.ts --outputFilename=API.md --filenameSubstring=API --firstHeadingLevel=1",
+    "generate-service-docs": "node ./dist/cjs/src/utils/generateDocs.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bitcoin-sv/overlay-discovery-services.git"
+  },
+  "keywords": [
+    "BSV",
+    "Blockchain",
+    "Overlay",
+    "Bitcoin",
+    "SV"
+  ],
+  "author": "BSV Association",
+  "license": "SEE LICENSE IN LICENSE.txt",
+  "bugs": {
+    "url": "https://github.com/bitcoin-sv/overlay-discovery-services/issues"
+  },
+  "homepage": "https://github.com/bitcoin-sv/overlay-discovery-services#readme",
+  "devDependencies": {
+    "@types/jest": "^29.5.12",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.1",
+    "ts-standard": "^12.0.2",
+    "ts2md": "^0.2.0",
+    "tsconfig-to-dual-package": "^1.2.0",
+    "typescript": "^5.2.2"
+  },
+  "dependencies": {
+    "@bsv/overlay": "^0.1.15",
+    "@bsv/sdk": "^1.2.3",
+    "mongodb": "^6.11.0",
+    "ninja-base": "^0.3.67",
+    "pushdrop": "^0.1.64",
+    "sendover": "^1.3.27",
+    "uhrp-url": "^0.1.10"
+  }
+}

package/dist/cjs/src/LegacyNinjaAdvertiser.js

@@ -0,0 +1,235 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LegacyNinjaAdvertiser = void 0;
+const pushdrop_1 = __importDefault(require("pushdrop"));
+const ninja_base_1 = require("ninja-base");
+const sdk_ts_1 = require("@babbage/sdk-ts");
+const sdk_1 = require("@bsv/sdk");
+const sendover_1 = require("sendover");
+const toBEEF_js_1 = require("@babbage/sdk-ts/out/src/utils/toBEEF.js");
+const AD_TOKEN_VALUE = 1;
+// TODO: Add 'implements Advertiser' back, once Advertiser can be properly imported from Overlay Services.
+/**
+ * Implements the Advertiser interface for managing SHIP and SLAP advertisements using a Ninja.
+ */
+class LegacyNinjaAdvertiser {
+    /**
+     * Constructs a new NinjaAdvertiser instance.
+     * @param privateKey - The private key used for signing transactions.
+     * @param dojoURL - The URL of the dojo server for the Ninja.
+     * @param hostingDomain - The base server URL for the NinjaAdvertiser.
+     */
+    constructor(privateKey, dojoURL, hostingDomain) {
+        this.privateKey = privateKey;
+        this.dojoURL = dojoURL;
+        this.hostingDomain = hostingDomain;
+        this.ninja = new ninja_base_1.Ninja({
+            privateKey,
+            config: {
+                dojoURL
+            }
+        });
+    }
+    /**
+     * Sets the Engine instance to be used by this NinjaAdvertiser. This method allows for late
+     * binding of the Engine, thus avoiding circular dependencies during instantiation. The Engine
+     * provides necessary context with the relevant topic managers and lookup services,
+     * as well as the lookup function used for querying advertisements.
+     *
+     * @param engine The Engine instance to be associated with this NinjaAdvertiser. The Engine should
+     * be fully initialized before being passed to this method to ensure all functionalities are available.
+     */
+    setLookupEngine(engine) {
+        this.engine = engine;
+    }
+    /**
+     * Utility function to create multiple advertisements in a single transaction.
+     * @param privateKey The private key used to sign the transaction.
+     * @param adsData Array of advertisement details.
+     * @param ninja Ninja instance for transaction processing.
+     * @param note A note attached to the transaction.
+     * @returns A promise that resolves to an array of TaggedBEEF objects.
+     * @throws Will throw an error if the locking key is invalid.
+     */
+    async createAdvertisements(adsData) {
+        const identityKey = sdk_1.PublicKey.fromPrivateKey(new sdk_1.PrivateKey(this.privateKey, 'hex')).toString();
+        const outputs = await Promise.all(adsData.map(async (ad) => {
+            // Derive a locking private key using BRC-42 derivation scheme
+            const derivedPrivateKey = (0, sendover_1.getPaymentPrivateKey)({
+                recipientPrivateKey: this.privateKey,
+                senderPublicKey: identityKey,
+                invoiceNumber: `2-${ad.protocol}-1`,
+                returnType: 'hex'
+            });
+            const lockingScript = await pushdrop_1.default.create({
+                fields: [
+                    Buffer.from(ad.protocol),
+                    Buffer.from(identityKey, 'hex'),
+                    Buffer.from(this.hostingDomain),
+                    Buffer.from(ad.topicOrServiceName)
+                ],
+                key: derivedPrivateKey
+            });
+            return {
+                satoshis: AD_TOKEN_VALUE,
+                script: lockingScript
+            };
+        }));
+        const tx = await this.ninja.getTransactionWithOutputs({
+            outputs,
+            note: 'SHIP/SLAP Advertisement Issuance',
+            autoProcess: true
+        });
+        const beef = (0, sdk_ts_1.toBEEFfromEnvelope)({
+            rawTx: tx.rawTx,
+            inputs: tx.inputs,
+            txid: tx.txid
+        }).beef;
+        return {
+            beef,
+            topics: [...new Set(adsData.map(ad => ad.protocol === 'SHIP' ? 'tm_ship' : 'tm_slap'))]
+        };
+    }
+    /**
+     * Finds all SHIP advertisements for a given topic.
+     * @param topic - The topic name to search for.
+     * @returns A promise that resolves to an array of SHIP advertisements.
+     */
+    async findAllAdvertisements(protocol) {
+        if (this.engine === undefined) {
+            throw new Error('Advertiser must be configured with an overlay services engine for advertisement lookup.');
+        }
+        const advertisements = [];
+        const lookupAnswer = await this.engine.lookup({
+            service: protocol === 'SHIP' ? 'ls_ship' : 'ls_slap',
+            query: 'findAll'
+        });
+        // Lookup will currently always return type output-list
+        if (lookupAnswer.type === 'output-list') {
+            lookupAnswer.outputs.forEach(output => {
+                try {
+                    // Parse out the advertisements using the provided parser
+                    const tx = sdk_1.Transaction.fromBEEF(output.beef);
+                    const advertisement = this.parseAdvertisement(tx.outputs[output.outputIndex].lockingScript);
+                    if (advertisement !== undefined && advertisement !== null && advertisement.protocol === protocol) {
+                        advertisements.push({
+                            ...advertisement,
+                            beef: output.beef,
+                            outputIndex: output.outputIndex
+                        });
+                    }
+                }
+                catch (error) {
+                    console.error('Failed to parse advertisement output:', error);
+                }
+            });
+        }
+        return advertisements;
+    }
+    /**
+     * Revokes an existing advertisement.
+     * @param advertisements - The advertisements to revoke, either SHIP or SLAP.
+     * @returns A promise that resolves to the revoked advertisement as TaggedBEEF.
+     */
+    async revokeAdvertisements(advertisements) {
+        if (advertisements.length === 0) {
+            throw new Error('Must provide advertisements to revoke!');
+        }
+        const inputsByTxid = {};
+        for (const advertisement of advertisements) {
+            if (advertisement.beef === undefined || advertisement.outputIndex === undefined) {
+                throw new Error('Advertisement to revoke must contain tagged beef!');
+            }
+            // Parse the transaction and UTXO to spend
+            const advertisementTx = sdk_1.Transaction.fromBEEF(advertisement.beef);
+            const adTxid = advertisementTx.id('hex');
+            const outputToRedeem = advertisementTx.outputs[advertisement.outputIndex];
+            const identityKey = sdk_1.PublicKey.fromPrivateKey(new sdk_1.PrivateKey(this.privateKey, 'hex')).toString();
+            // Derive a unlocking private key using BRC-42 derivation scheme
+            const derivedPrivateKey = (0, sendover_1.getPaymentPrivateKey)({
+                recipientPrivateKey: this.privateKey,
+                senderPublicKey: identityKey,
+                invoiceNumber: `2-${advertisement.protocol}-1`,
+                returnType: 'hex'
+            });
+            const unlockingScript = await pushdrop_1.default.redeem({
+                key: derivedPrivateKey,
+                prevTxId: adTxid,
+                outputIndex: advertisement.outputIndex,
+                lockingScript: outputToRedeem.lockingScript.toHex(),
+                outputAmount: outputToRedeem.satoshis
+            });
+            const constructedRedeem = {
+                index: advertisement.outputIndex,
+                unlockingScript
+            };
+            // Group outputs by their transaction ID
+            if (inputsByTxid[adTxid] === undefined) {
+                inputsByTxid[adTxid] = {
+                    ...(0, toBEEF_js_1.toEnvelopeFromBEEF)(advertisementTx),
+                    rawTx: advertisementTx.toHex(),
+                    outputsToRedeem: [constructedRedeem]
+                };
+            }
+            else {
+                inputsByTxid[adTxid].outputsToRedeem.push(constructedRedeem);
+            }
+        }
+        // Create a new transaction that spends the SHIP or SLAP advertisement issuance token
+        const revokeTx = await this.ninja.getTransactionWithOutputs({
+            inputs: inputsByTxid,
+            outputs: [],
+            labels: [],
+            note: 'Revoked SHIP/SLAP advertisements',
+            autoProcess: true
+        });
+        const beef = (0, sdk_ts_1.toBEEFfromEnvelope)({
+            rawTx: revokeTx.rawTx,
+            inputs: revokeTx.inputs,
+            txid: revokeTx.txid
+        }).beef;
+        return {
+            beef,
+            topics: [...new Set(advertisements.map(ad => ad.protocol === 'SHIP' ? 'tm_ship' : 'tm_slap'))]
+        };
+    }
+    /**
+     * Parses an advertisement from the provided output script.
+     * @param outputScript - The output script to parse.
+     * @returns An Advertisement object if the script matches the expected format, otherwise throws an error.
+     */
+    parseAdvertisement(outputScript) {
+        try {
+            const result = pushdrop_1.default.decode({
+                script: outputScript.toHex(),
+                fieldFormat: 'buffer'
+            });
+            if (result.fields.length < 4) {
+                throw new Error('Invalid SHIP/SLAP advertisement!');
+            }
+            const protocol = result.fields[0].toString();
+            if (protocol !== 'SHIP' && protocol !== 'SLAP') {
+                throw new Error('Invalid protocol type!');
+            }
+            const identityKey = result.fields[1].toString('hex');
+            const domain = result.fields[2].toString();
+            const topicOrService = result.fields[3].toString();
+            // Construct a unified Advertisement object
+            return {
+                protocol: protocol,
+                identityKey,
+                domain,
+                topicOrService
+            };
+        }
+        catch (error) {
+            console.error('Error parsing advertisement:', error);
+            throw new Error('Error parsing advertisement!');
+        }
+    }
+}
+exports.LegacyNinjaAdvertiser = LegacyNinjaAdvertiser;
+//# sourceMappingURL=LegacyNinjaAdvertiser.js.map

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

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

package/dist/cjs/src/NinjaAdvertiser.js

@@ -0,0 +1,234 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NinjaAdvertiser = void 0;
+const pushdrop_1 = __importDefault(require("pushdrop"));
+const ninja_base_1 = require("ninja-base");
+const sdk_ts_1 = require("@babbage/sdk-ts");
+const sdk_1 = require("@bsv/sdk");
+const sendover_1 = require("sendover");
+const toBEEF_js_1 = require("@babbage/sdk-ts/out/src/utils/toBEEF.js");
+const AD_TOKEN_VALUE = 1;
+/**
+ * Implements the Advertiser interface for managing SHIP and SLAP advertisements using a Ninja.
+ */
+class NinjaAdvertiser {
+    /**
+     * Constructs a new NinjaAdvertiser instance.
+     * @param privateKey - The private key used for signing transactions.
+     * @param dojoURL - The URL of the dojo server for the Ninja.
+     * @param hostingDomain - The base server URL for the NinjaAdvertiser.
+     */
+    constructor(privateKey, dojoURL, hostingDomain) {
+        this.privateKey = privateKey;
+        this.dojoURL = dojoURL;
+        this.hostingDomain = hostingDomain;
+        this.ninja = new ninja_base_1.Ninja({
+            privateKey,
+            config: {
+                dojoURL
+            }
+        });
+    }
+    /**
+     * Sets the Engine instance to be used by this NinjaAdvertiser. This method allows for late
+     * binding of the Engine, thus avoiding circular dependencies during instantiation. The Engine
+     * provides necessary context with the relevant topic managers and lookup services,
+     * as well as the lookup function used for querying advertisements.
+     *
+     * @param engine The Engine instance to be associated with this NinjaAdvertiser. The Engine should
+     * be fully initialized before being passed to this method to ensure all functionalities are available.
+     */
+    setLookupEngine(engine) {
+        this.engine = engine;
+    }
+    /**
+     * Utility function to create multiple advertisements in a single transaction.
+     * @param privateKey The private key used to sign the transaction.
+     * @param adsData Array of advertisement details.
+     * @param ninja Ninja instance for transaction processing.
+     * @param note A note attached to the transaction.
+     * @returns A promise that resolves to an array of TaggedBEEF objects.
+     * @throws Will throw an error if the locking key is invalid.
+     */
+    async createAdvertisements(adsData) {
+        const identityKey = sdk_1.PublicKey.fromPrivateKey(new sdk_1.PrivateKey(this.privateKey, 'hex')).toString();
+        const outputs = await Promise.all(adsData.map(async (ad) => {
+            // Derive a locking private key using BRC-42 derivation scheme
+            const derivedPrivateKey = (0, sendover_1.getPaymentPrivateKey)({
+                recipientPrivateKey: this.privateKey,
+                senderPublicKey: identityKey,
+                invoiceNumber: `2-${ad.protocol}-1`,
+                returnType: 'hex'
+            });
+            const lockingScript = await pushdrop_1.default.create({
+                fields: [
+                    Buffer.from(ad.protocol),
+                    Buffer.from(identityKey, 'hex'),
+                    Buffer.from(this.hostingDomain),
+                    Buffer.from(ad.topicOrServiceName)
+                ],
+                key: derivedPrivateKey
+            });
+            return {
+                satoshis: AD_TOKEN_VALUE,
+                script: lockingScript
+            };
+        }));
+        const tx = await this.ninja.getTransactionWithOutputs({
+            outputs,
+            note: 'SHIP/SLAP Advertisement Issuance',
+            autoProcess: true
+        });
+        const beef = (0, sdk_ts_1.toBEEFfromEnvelope)({
+            rawTx: tx.rawTx,
+            inputs: tx.inputs,
+            txid: tx.txid
+        }).beef;
+        return {
+            beef,
+            topics: [...new Set(adsData.map(ad => ad.protocol === 'SHIP' ? 'tm_ship' : 'tm_slap'))]
+        };
+    }
+    /**
+     * Finds all SHIP advertisements for a given topic.
+     * @param topic - The topic name to search for.
+     * @returns A promise that resolves to an array of SHIP advertisements.
+     */
+    async findAllAdvertisements(protocol) {
+        if (this.engine === undefined) {
+            throw new Error('Advertiser must be configured with an overlay services engine for advertisement lookup.');
+        }
+        const advertisements = [];
+        const lookupAnswer = await this.engine.lookup({
+            service: protocol === 'SHIP' ? 'ls_ship' : 'ls_slap',
+            query: 'findAll'
+        });
+        // Lookup will currently always return type output-list
+        if (lookupAnswer.type === 'output-list') {
+            lookupAnswer.outputs.forEach(output => {
+                try {
+                    // Parse out the advertisements using the provided parser
+                    const tx = sdk_1.Transaction.fromBEEF(output.beef);
+                    const advertisement = this.parseAdvertisement(tx.outputs[output.outputIndex].lockingScript);
+                    if (advertisement !== undefined && advertisement !== null && advertisement.protocol === protocol) {
+                        advertisements.push({
+                            ...advertisement,
+                            beef: output.beef,
+                            outputIndex: output.outputIndex
+                        });
+                    }
+                }
+                catch (error) {
+                    console.error('Failed to parse advertisement output:', error);
+                }
+            });
+        }
+        return advertisements;
+    }
+    /**
+     * Revokes an existing advertisement.
+     * @param advertisements - The advertisements to revoke, either SHIP or SLAP.
+     * @returns A promise that resolves to the revoked advertisement as TaggedBEEF.
+     */
+    async revokeAdvertisements(advertisements) {
+        if (advertisements.length === 0) {
+            throw new Error('Must provide advertisements to revoke!');
+        }
+        const inputsByTxid = {};
+        for (const advertisement of advertisements) {
+            if (advertisement.beef === undefined || advertisement.outputIndex === undefined) {
+                throw new Error('Advertisement to revoke must contain tagged beef!');
+            }
+            // Parse the transaction and UTXO to spend
+            const advertisementTx = sdk_1.Transaction.fromBEEF(advertisement.beef);
+            const adTxid = advertisementTx.id('hex');
+            const outputToRedeem = advertisementTx.outputs[advertisement.outputIndex];
+            const identityKey = sdk_1.PublicKey.fromPrivateKey(new sdk_1.PrivateKey(this.privateKey, 'hex')).toString();
+            // Derive a unlocking private key using BRC-42 derivation scheme
+            const derivedPrivateKey = (0, sendover_1.getPaymentPrivateKey)({
+                recipientPrivateKey: this.privateKey,
+                senderPublicKey: identityKey,
+                invoiceNumber: `2-${advertisement.protocol}-1`,
+                returnType: 'hex'
+            });
+            const unlockingScript = await pushdrop_1.default.redeem({
+                key: derivedPrivateKey,
+                prevTxId: adTxid,
+                outputIndex: advertisement.outputIndex,
+                lockingScript: outputToRedeem.lockingScript.toHex(),
+                outputAmount: outputToRedeem.satoshis
+            });
+            const constructedRedeem = {
+                index: advertisement.outputIndex,
+                unlockingScript
+            };
+            // Group outputs by their transaction ID
+            if (inputsByTxid[adTxid] === undefined) {
+                inputsByTxid[adTxid] = {
+                    ...(0, toBEEF_js_1.toEnvelopeFromBEEF)(advertisementTx),
+                    rawTx: advertisementTx.toHex(),
+                    outputsToRedeem: [constructedRedeem]
+                };
+            }
+            else {
+                inputsByTxid[adTxid].outputsToRedeem.push(constructedRedeem);
+            }
+        }
+        // Create a new transaction that spends the SHIP or SLAP advertisement issuance token
+        const revokeTx = await this.ninja.getTransactionWithOutputs({
+            inputs: inputsByTxid,
+            outputs: [],
+            labels: [],
+            note: 'Revoked SHIP/SLAP advertisements',
+            autoProcess: true
+        });
+        const beef = (0, sdk_ts_1.toBEEFfromEnvelope)({
+            rawTx: revokeTx.rawTx,
+            inputs: revokeTx.inputs,
+            txid: revokeTx.txid
+        }).beef;
+        return {
+            beef,
+            topics: [...new Set(advertisements.map(ad => ad.protocol === 'SHIP' ? 'tm_ship' : 'tm_slap'))]
+        };
+    }
+    /**
+     * Parses an advertisement from the provided output script.
+     * @param outputScript - The output script to parse.
+     * @returns An Advertisement object if the script matches the expected format, otherwise throws an error.
+     */
+    parseAdvertisement(outputScript) {
+        try {
+            const result = pushdrop_1.default.decode({
+                script: outputScript.toHex(),
+                fieldFormat: 'buffer'
+            });
+            if (result.fields.length < 4) {
+                throw new Error('Invalid SHIP/SLAP advertisement!');
+            }
+            const protocol = result.fields[0].toString();
+            if (protocol !== 'SHIP' && protocol !== 'SLAP') {
+                throw new Error('Invalid protocol type!');
+            }
+            const identityKey = result.fields[1].toString('hex');
+            const domain = result.fields[2].toString();
+            const topicOrService = result.fields[3].toString();
+            // Construct a unified Advertisement object
+            return {
+                protocol: protocol,
+                identityKey,
+                domain,
+                topicOrService
+            };
+        }
+        catch (error) {
+            console.error('Error parsing advertisement:', error);
+            throw new Error('Error parsing advertisement!');
+        }
+    }
+}
+exports.NinjaAdvertiser = NinjaAdvertiser;
+//# sourceMappingURL=NinjaAdvertiser.js.map

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

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