@atomicfinance/bitcoin-dlc-provider 4.2.8 → 4.3.0

package/.yalc/@node-dlc/messaging/dist/messages/OracleAnnouncement.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OracleAnnouncement = void 0;
+const bufio_1 = require("@node-dlc/bufio");
+const bip_schnorr_1 = require("bip-schnorr");
+const MessageType_1 = require("../MessageType");
+const getTlv_1 = require("../serialize/getTlv");
+const OracleEvent_1 = require("./OracleEvent");
+/**
+ * Oracle announcement that describe an event and the way that an oracle will
+ * attest to it. Updated to be rust-dlc compliant.
+ *
+ * In order to make it possible to hold oracles accountable in cases where
+ * they do not release a signature for an event outcome, there needs to be
+ * a proof that an oracle has committed to a given outcome. This proof is
+ * given in a so-called oracle announcement, which contains an oracle event
+ * together with the oracle public key and a signature over its serialization,
+ * which must be valid with respect to the specified public key.
+ *
+ * This also makes it possible for users to obtain oracle event information
+ * from an un-trusted peer while being guaranteed that it originates from a
+ * given oracle.
+ */
+class OracleAnnouncement {
+    constructor() {
+        /**
+         * The type for oracle_announcement message. oracle_announcement = 55332
+         */
+        this.type = OracleAnnouncement.type;
+    }
+    /**
+     * Creates an OracleAnnouncement from JSON data
+     * @param json JSON object representing oracle announcement
+     */
+    // eslint-disable-next-line @typescript-eslint/explicit-module-boundary-types, @typescript-eslint/no-explicit-any
+    static fromJSON(json) {
+        const instance = new OracleAnnouncement();
+        // Handle different field name variations
+        instance.announcementSig = Buffer.from(json.announcementSignature ||
+            json.announcementSig ||
+            json.announcement_signature, 'hex');
+        instance.oraclePubkey = Buffer.from(json.oraclePublicKey || json.oraclePubkey || json.oracle_public_key, 'hex');
+        instance.oracleEvent = OracleEvent_1.OracleEvent.fromJSON(json.oracleEvent || json.oracle_event);
+        return instance;
+    }
+    /**
+     * Deserializes an oracle_announcement message
+     * @param buf
+     */
+    static deserialize(buf) {
+        const instance = new OracleAnnouncement();
+        const reader = new bufio_1.BufferReader(buf);
+        reader.readBigSize(); // read type
+        instance.length = reader.readBigSize();
+        instance.announcementSig = reader.readBytes(64);
+        instance.oraclePubkey = reader.readBytes(32);
+        instance.oracleEvent = OracleEvent_1.OracleEvent.deserialize((0, getTlv_1.getTlv)(reader));
+        return instance;
+    }
+    /**
+     * Validates the oracle announcement according to rust-dlc specification.
+     * This includes validating the oracle event and verifying the announcement signature.
+     * @throws Will throw an error if validation fails
+     */
+    validate() {
+        // Validate oracle event first
+        this.oracleEvent.validate();
+        // Validate oracle public key format (32 bytes for x-only)
+        if (!this.oraclePubkey || this.oraclePubkey.length !== 32) {
+            throw new Error('Oracle public key must be 32 bytes (x-only format)');
+        }
+        // Validate announcement signature format (64 bytes for Schnorr)
+        if (!this.announcementSig || this.announcementSig.length !== 64) {
+            throw new Error('Announcement signature must be 64 bytes (Schnorr format)');
+        }
+        // Verify announcement signature over the oracle event
+        try {
+            const msg = bip_schnorr_1.math.taggedHash('DLC/oracle/announcement/v0', this.oracleEvent.serialize());
+            (0, bip_schnorr_1.verify)(this.oraclePubkey, msg, this.announcementSig);
+        }
+        catch (error) {
+            throw new Error(`Invalid announcement signature: ${error.message}`);
+        }
+    }
+    /**
+     * Returns the nonces from the oracle event.
+     * This is useful for finding matching oracle announcements.
+     */
+    getNonces() {
+        return this.oracleEvent.oracleNonces;
+    }
+    /**
+     * Returns the event maturity epoch from the oracle event.
+     */
+    getEventMaturityEpoch() {
+        return this.oracleEvent.eventMaturityEpoch;
+    }
+    /**
+     * Returns the event ID from the oracle event.
+     */
+    getEventId() {
+        return this.oracleEvent.eventId;
+    }
+    /**
+     * Converts oracle_announcement to JSON (canonical rust-dlc format)
+     */
+    toJSON() {
+        return {
+            announcementSignature: this.announcementSig.toString('hex'),
+            oraclePublicKey: this.oraclePubkey.toString('hex'),
+            oracleEvent: this.oracleEvent.toJSON(),
+        };
+    }
+    /**
+     * Serializes the oracle_announcement message into a Buffer
+     */
+    serialize() {
+        const writer = new bufio_1.BufferWriter();
+        writer.writeBigSize(this.type);
+        const dataWriter = new bufio_1.BufferWriter();
+        dataWriter.writeBytes(this.announcementSig);
+        dataWriter.writeBytes(this.oraclePubkey);
+        dataWriter.writeBytes(this.oracleEvent.serialize());
+        writer.writeBigSize(dataWriter.size);
+        writer.writeBytes(dataWriter.toBuffer());
+        return writer.toBuffer();
+    }
+}
+exports.OracleAnnouncement = OracleAnnouncement;
+OracleAnnouncement.type = MessageType_1.MessageType.OracleAnnouncement;
+//# sourceMappingURL=OracleAnnouncement.js.map

package/.yalc/@node-dlc/messaging/dist/messages/OracleAnnouncement.js.map

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

package/.yalc/@node-dlc/messaging/dist/messages/OracleAnnouncementV0.d.ts

@@ -0,0 +1,47 @@
+/// <reference types="node" />
+import { MessageType } from '../MessageType';
+import { IDlcMessage } from './DlcMessage';
+import { IOracleEventV0JSON, OracleEventV0 } from './OracleEventV0';
+/**
+ * In order to make it possible to hold oracles accountable in cases where
+ * they do not release a signature for an event outcome, there needs to be
+ * a proof that an oracle has committed to a given outcome. This proof is
+ * given in a so-called oracle announcement, which contains an oracle event
+ * together with the oracle public key and a signature over its serialization,
+ * which must be valid with respect to the specified public key.
+ *
+ * This also makes it possible for users to obtain oracle event information
+ * from an un-trusted peer while being guaranteed that it originates from a
+ * given oracle.
+ */
+export declare class OracleAnnouncementV0 implements IDlcMessage {
+    static type: MessageType;
+    /**
+     * Deserializes an oracle_announcement_v0 message
+     * @param buf
+     */
+    static deserialize(buf: Buffer): OracleAnnouncementV0;
+    /**
+     * The type for oracle_announcement_v0 message. oracle_announcement_v0 = 55332
+     */
+    type: MessageType;
+    length: bigint;
+    announcementSig: Buffer;
+    oraclePubkey: Buffer;
+    oracleEvent: OracleEventV0;
+    validate(): void;
+    /**
+     * Converts oracle_announcement_v0 to JSON
+     */
+    toJSON(): OracleAnnouncementV0JSON;
+    /**
+     * Serializes the oracle_announcement_v0 message into a Buffer
+     */
+    serialize(): Buffer;
+}
+export interface OracleAnnouncementV0JSON {
+    type: number;
+    announcementSig: string;
+    oraclePubkey: string;
+    oracleEvent: IOracleEventV0JSON;
+}

package/.yalc/@node-dlc/messaging/dist/messages/OracleAnnouncementV0.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OracleAnnouncementV0 = void 0;
+const bufio_1 = require("@node-dlc/bufio");
+const bip_schnorr_1 = require("bip-schnorr");
+const MessageType_1 = require("../MessageType");
+const getTlv_1 = require("../serialize/getTlv");
+const OracleEventV0_1 = require("./OracleEventV0");
+/**
+ * In order to make it possible to hold oracles accountable in cases where
+ * they do not release a signature for an event outcome, there needs to be
+ * a proof that an oracle has committed to a given outcome. This proof is
+ * given in a so-called oracle announcement, which contains an oracle event
+ * together with the oracle public key and a signature over its serialization,
+ * which must be valid with respect to the specified public key.
+ *
+ * This also makes it possible for users to obtain oracle event information
+ * from an un-trusted peer while being guaranteed that it originates from a
+ * given oracle.
+ */
+class OracleAnnouncementV0 {
+    constructor() {
+        /**
+         * The type for oracle_announcement_v0 message. oracle_announcement_v0 = 55332
+         */
+        this.type = OracleAnnouncementV0.type;
+    }
+    /**
+     * Deserializes an oracle_announcement_v0 message
+     * @param buf
+     */
+    static deserialize(buf) {
+        const instance = new OracleAnnouncementV0();
+        const reader = new bufio_1.BufferReader(buf);
+        reader.readBigSize(); // read type
+        instance.length = reader.readBigSize();
+        instance.announcementSig = reader.readBytes(64);
+        instance.oraclePubkey = reader.readBytes(32);
+        instance.oracleEvent = OracleEventV0_1.OracleEventV0.deserialize((0, getTlv_1.getTlv)(reader));
+        return instance;
+    }
+    validate() {
+        this.oracleEvent.validate();
+        // Verify announcement sig
+        const msg = bip_schnorr_1.math.taggedHash('DLC/oracle/announcement/v0', this.oracleEvent.serialize());
+        (0, bip_schnorr_1.verify)(this.oraclePubkey, msg, this.announcementSig);
+    }
+    /**
+     * Converts oracle_announcement_v0 to JSON
+     */
+    toJSON() {
+        return {
+            type: this.type,
+            announcementSig: this.announcementSig.toString('hex'),
+            oraclePubkey: this.oraclePubkey.toString('hex'),
+            oracleEvent: this.oracleEvent.toJSON(),
+        };
+    }
+    /**
+     * Serializes the oracle_announcement_v0 message into a Buffer
+     */
+    serialize() {
+        const writer = new bufio_1.BufferWriter();
+        writer.writeBigSize(this.type);
+        const dataWriter = new bufio_1.BufferWriter();
+        dataWriter.writeBytes(this.announcementSig);
+        dataWriter.writeBytes(this.oraclePubkey);
+        dataWriter.writeBytes(this.oracleEvent.serialize());
+        writer.writeBigSize(dataWriter.size);
+        writer.writeBytes(dataWriter.toBuffer());
+        return writer.toBuffer();
+    }
+}
+exports.OracleAnnouncementV0 = OracleAnnouncementV0;
+OracleAnnouncementV0.type = MessageType_1.MessageType.OracleAnnouncementV0;
+//# sourceMappingURL=OracleAnnouncementV0.js.map

package/.yalc/@node-dlc/messaging/dist/messages/OracleAnnouncementV0.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OracleAnnouncementV0.js","sourceRoot":"","sources":["../../lib/messages/OracleAnnouncementV0.ts"],"names":[],"mappings":";;;AAAA,2CAA6D;AAC7D,6CAA2C;AAE3C,gDAA6C;AAC7C,gDAA6C;AAE7C,mDAAoE;AAEpE;;;;;;;;;;;GAWG;AACH,MAAa,oBAAoB;IAAjC;QAoBE;;WAEG;QACI,SAAI,GAAG,oBAAoB,CAAC,IAAI,CAAC;IAkD1C,CAAC;IAtEC;;;OAGG;IACI,MAAM,CAAC,WAAW,CAAC,GAAW;QACnC,MAAM,QAAQ,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC5C,MAAM,MAAM,GAAG,IAAI,oBAAY,CAAC,GAAG,CAAC,CAAC;QAErC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,YAAY;QAClC,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QACvC,QAAQ,CAAC,eAAe,GAAG,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAChD,QAAQ,CAAC,YAAY,GAAG,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAC7C,QAAQ,CAAC,WAAW,GAAG,6BAAa,CAAC,WAAW,CAAC,IAAA,eAAM,EAAC,MAAM,CAAC,CAAC,CAAC;QAEjE,OAAO,QAAQ,CAAC;IAClB,CAAC;IAeM,QAAQ;QACb,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;QAE5B,0BAA0B;QAC1B,MAAM,GAAG,GAAG,kBAAI,CAAC,UAAU,CACzB,4BAA4B,EAC5B,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,CAC7B,CAAC;QACF,IAAA,oBAAM,EAAC,IAAI,CAAC,YAAY,EAAE,GAAG,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;IACvD,CAAC;IAED;;OAEG;IACI,MAAM;QACX,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,eAAe,EAAE,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC;YACrD,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC;YAC/C,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE;SACvC,CAAC;IACJ,CAAC;IAED;;OAEG;IACI,SAAS;QACd,MAAM,MAAM,GAAG,IAAI,oBAAY,EAAE,CAAC;QAClC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE/B,MAAM,UAAU,GAAG,IAAI,oBAAY,EAAE,CAAC;QACtC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC5C,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACzC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC,CAAC;QAEpD,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;QAEzC,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC;;AAxEH,oDAyEC;AAxEe,yBAAI,GAAG,yBAAW,CAAC,oBAAoB,CAAC"}

package/.yalc/@node-dlc/messaging/dist/messages/OracleAttestation.d.ts

@@ -0,0 +1,68 @@
+/// <reference types="node" />
+import { MessageType } from '../MessageType';
+import { IDlcMessage } from './DlcMessage';
+import { OracleAnnouncement } from './OracleAnnouncement';
+/**
+ * Oracle attestation providing signatures over an outcome value.
+ * This represents the oracle's actual attestation to a specific outcome.
+ * Updated to match rust-dlc specification with 2-byte count prefixes.
+ *
+ * An attestation from an oracle providing signatures over an outcome value.
+ * This is what the oracle publishes when they want to attest to a specific outcome.
+ */
+export declare class OracleAttestation implements IDlcMessage {
+    static type: MessageType;
+    /**
+     * Deserializes an oracle_attestation message
+     * @param buf
+     */
+    static deserialize(buf: Buffer): OracleAttestation;
+    /**
+     * The type for oracle_attestation message. oracle_attestation = 55400
+     */
+    type: MessageType;
+    length: bigint;
+    /** The identifier of the announcement. */
+    eventId: string;
+    /** The public key of the oracle (32 bytes, x-only). */
+    oraclePubkey: Buffer;
+    /** The signatures over the event outcome (64 bytes each, Schnorr format). */
+    signatures: Buffer[];
+    /** The set of strings representing the outcome value. */
+    outcomes: string[];
+    /**
+     * Validates the oracle attestation according to rust-dlc specification.
+     * This includes validating signatures and ensuring consistency with announcement.
+     * @param announcement The corresponding oracle announcement for validation (optional)
+     * @throws Will throw an error if validation fails
+     */
+    validate(announcement?: OracleAnnouncement): void;
+    /**
+     * Validates the attestation against the corresponding oracle announcement.
+     * This ensures the attestation is consistent with the original announcement.
+     * @param announcement The oracle announcement to validate against
+     * @throws Will throw an error if validation fails
+     */
+    private validateAgainstAnnouncement;
+    /**
+     * Returns the nonces used by the oracle to sign the event outcome.
+     * This is used for finding the matching oracle announcement.
+     * The nonce is extracted from the first 32 bytes of each signature.
+     */
+    getNonces(): Buffer[];
+    /**
+     * Converts oracle_attestation to JSON
+     */
+    toJSON(): OracleAttestationJSON;
+    /**
+     * Serializes the oracle_attestation message into a Buffer
+     */
+    serialize(): Buffer;
+}
+export interface OracleAttestationJSON {
+    type: number;
+    eventId: string;
+    oraclePubkey: string;
+    signatures: string[];
+    outcomes: string[];
+}

package/.yalc/@node-dlc/messaging/dist/messages/OracleAttestation.js

@@ -0,0 +1,239 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OracleAttestation = void 0;
+const bufio_1 = require("@node-dlc/bufio");
+const bip_schnorr_1 = require("bip-schnorr");
+const MessageType_1 = require("../MessageType");
+/**
+ * Oracle attestation providing signatures over an outcome value.
+ * This represents the oracle's actual attestation to a specific outcome.
+ * Updated to match rust-dlc specification with 2-byte count prefixes.
+ *
+ * An attestation from an oracle providing signatures over an outcome value.
+ * This is what the oracle publishes when they want to attest to a specific outcome.
+ */
+class OracleAttestation {
+    constructor() {
+        /**
+         * The type for oracle_attestation message. oracle_attestation = 55400
+         */
+        this.type = OracleAttestation.type;
+        /** The signatures over the event outcome (64 bytes each, Schnorr format). */
+        this.signatures = [];
+        /** The set of strings representing the outcome value. */
+        this.outcomes = [];
+    }
+    /**
+     * Deserializes an oracle_attestation message
+     * @param buf
+     */
+    static deserialize(buf) {
+        const instance = new OracleAttestation();
+        const reader = new bufio_1.BufferReader(buf);
+        reader.readBigSize(); // read type
+        instance.length = reader.readBigSize();
+        // Detect format: old rust-dlc 0.4.0 (no event_id) vs new rust-dlc (with event_id)
+        const currentPos = reader.position;
+        try {
+            // Try reading as new format (with event_id)
+            const eventIdLength = reader.readBigSize();
+            // If event ID length is reasonable (0-100 bytes), assume new format
+            if (eventIdLength >= BigInt('0') && eventIdLength <= BigInt('100')) {
+                if (eventIdLength === BigInt('0')) {
+                    instance.eventId = '';
+                }
+                else {
+                    const eventIdBuf = reader.readBytes(Number(eventIdLength));
+                    instance.eventId = eventIdBuf.toString();
+                }
+                instance.oraclePubkey = reader.readBytes(32);
+            }
+            else {
+                // Event ID length is unreasonable, probably old format without event_id
+                reader.position = currentPos;
+                instance.eventId = ''; // Default empty event ID for old format
+                instance.oraclePubkey = reader.readBytes(32);
+            }
+        }
+        catch (error) {
+            // If reading fails, assume old format without event_id
+            reader.position = currentPos;
+            instance.eventId = ''; // Default empty event ID for old format
+            instance.oraclePubkey = reader.readBytes(32);
+        }
+        const numSignatures = reader.readUInt16BE();
+        for (let i = 0; i < numSignatures; i++) {
+            const signature = reader.readBytes(64);
+            instance.signatures.push(signature);
+        }
+        // Handle both rust-dlc format (with u16 count prefix) and DLCSpecs format (no count prefix)
+        // Try to detect format by checking if next 2 bytes look like a reasonable outcome count
+        if (!reader.eof) {
+            const currentPos = reader.position;
+            try {
+                // Try reading as rust-dlc format (with u16 count prefix)
+                const numOutcomes = reader.readUInt16BE();
+                // Validate that this looks like a reasonable count
+                // If it's > 1000 or the remaining bytes can't accommodate this many outcomes,
+                // it's probably not a count prefix
+                const remainingBytes = reader.buffer.length - reader.position;
+                if (numOutcomes > 0 &&
+                    numOutcomes <= 1000 &&
+                    remainingBytes >= numOutcomes * 2) {
+                    // Looks like rust-dlc format with u16 count prefix
+                    for (let i = 0; i < numOutcomes; i++) {
+                        const outcomeLen = reader.readBigSize();
+                        const outcomeBuf = reader.readBytes(Number(outcomeLen));
+                        instance.outcomes.push(outcomeBuf.toString());
+                    }
+                }
+                else {
+                    // Reset and try DLCSpecs format (no count prefix)
+                    reader.position = currentPos;
+                    while (!reader.eof) {
+                        const outcomeLen = reader.readBigSize();
+                        const outcomeBuf = reader.readBytes(Number(outcomeLen));
+                        instance.outcomes.push(outcomeBuf.toString());
+                    }
+                }
+            }
+            catch (error) {
+                // If reading as rust-dlc format fails, reset and try DLCSpecs format
+                reader.position = currentPos;
+                while (!reader.eof) {
+                    const outcomeLen = reader.readBigSize();
+                    const outcomeBuf = reader.readBytes(Number(outcomeLen));
+                    instance.outcomes.push(outcomeBuf.toString());
+                }
+            }
+        }
+        return instance;
+    }
+    /**
+     * Validates the oracle attestation according to rust-dlc specification.
+     * This includes validating signatures and ensuring consistency with announcement.
+     * @param announcement The corresponding oracle announcement for validation (optional)
+     * @throws Will throw an error if validation fails
+     */
+    validate(announcement) {
+        // Basic structure validation
+        if (this.signatures.length !== this.outcomes.length) {
+            throw new Error('Number of signatures must match number of outcomes');
+        }
+        if (this.signatures.length === 0) {
+            throw new Error('Must have at least one signature and outcome');
+        }
+        // Validate event ID
+        if (!this.eventId || this.eventId.length === 0) {
+            throw new Error('Event ID cannot be empty');
+        }
+        // Validate oracle public key format
+        if (!this.oraclePubkey || this.oraclePubkey.length !== 32) {
+            throw new Error('Oracle public key must be 32 bytes (x-only format)');
+        }
+        // Validate signature formats
+        this.signatures.forEach((sig, index) => {
+            if (!sig || sig.length !== 64) {
+                throw new Error(`Signature at index ${index} must be 64 bytes (Schnorr format)`);
+            }
+        });
+        // Validate outcomes are not empty
+        this.outcomes.forEach((outcome, index) => {
+            if (!outcome || outcome.length === 0) {
+                throw new Error(`Outcome at index ${index} cannot be empty`);
+            }
+        });
+        // Verify signatures over outcomes using tagged hash
+        this.signatures.forEach((sig, index) => {
+            const outcome = this.outcomes[index];
+            try {
+                const msg = bip_schnorr_1.math.taggedHash('DLC/oracle/attestation/v0', outcome);
+                (0, bip_schnorr_1.verify)(this.oraclePubkey, msg, sig);
+            }
+            catch (error) {
+                throw new Error(`Invalid signature for outcome "${outcome}" at index ${index}: ${error.message}`);
+            }
+        });
+        // If announcement is provided, validate consistency
+        if (announcement) {
+            this.validateAgainstAnnouncement(announcement);
+        }
+    }
+    /**
+     * Validates the attestation against the corresponding oracle announcement.
+     * This ensures the attestation is consistent with the original announcement.
+     * @param announcement The oracle announcement to validate against
+     * @throws Will throw an error if validation fails
+     */
+    validateAgainstAnnouncement(announcement) {
+        // Validate oracle public key matches announcement
+        if (!this.oraclePubkey.equals(announcement.oraclePubkey)) {
+            throw new Error('Oracle public key must match announcement');
+        }
+        // Validate event ID matches
+        if (this.eventId !== announcement.getEventId()) {
+            throw new Error('Event ID must match announcement');
+        }
+        // Validate that the number of signatures matches the number of nonces in announcement
+        const announcementNonces = announcement.getNonces();
+        if (this.signatures.length !== announcementNonces.length) {
+            throw new Error('Number of signatures must match number of nonces in announcement');
+        }
+        // Extract nonces from signatures (first 32 bytes) and compare with announcement nonces
+        // This validates that the signatures were created using the committed nonces
+        this.signatures.forEach((sig, index) => {
+            const nonceFromSig = sig.slice(0, 32);
+            const expectedNonce = announcementNonces[index];
+            if (!nonceFromSig.equals(expectedNonce)) {
+                throw new Error(`Signature nonce mismatch at index ${index}: signature was not created with announced nonce`);
+            }
+        });
+    }
+    /**
+     * Returns the nonces used by the oracle to sign the event outcome.
+     * This is used for finding the matching oracle announcement.
+     * The nonce is extracted from the first 32 bytes of each signature.
+     */
+    getNonces() {
+        return this.signatures.map((sig) => sig.slice(0, 32));
+    }
+    /**
+     * Converts oracle_attestation to JSON
+     */
+    toJSON() {
+        return {
+            type: this.type,
+            eventId: this.eventId,
+            oraclePubkey: this.oraclePubkey.toString('hex'),
+            signatures: this.signatures.map((sig) => sig.toString('hex')),
+            outcomes: this.outcomes,
+        };
+    }
+    /**
+     * Serializes the oracle_attestation message into a Buffer
+     */
+    serialize() {
+        const writer = new bufio_1.BufferWriter();
+        writer.writeBigSize(this.type);
+        const dataWriter = new bufio_1.BufferWriter();
+        dataWriter.writeBigSize(this.eventId.length);
+        dataWriter.writeBytes(Buffer.from(this.eventId));
+        dataWriter.writeBytes(this.oraclePubkey);
+        dataWriter.writeUInt16BE(this.signatures.length);
+        for (const signature of this.signatures) {
+            dataWriter.writeBytes(signature);
+        }
+        // Write outcomes with u16 count prefix (matching rust-dlc format)
+        dataWriter.writeUInt16BE(this.outcomes.length);
+        for (const outcome of this.outcomes) {
+            dataWriter.writeBigSize(outcome.length);
+            dataWriter.writeBytes(Buffer.from(outcome));
+        }
+        writer.writeBigSize(dataWriter.size);
+        writer.writeBytes(dataWriter.toBuffer());
+        return writer.toBuffer();
+    }
+}
+exports.OracleAttestation = OracleAttestation;
+OracleAttestation.type = MessageType_1.MessageType.OracleAttestation;
+//# sourceMappingURL=OracleAttestation.js.map

package/.yalc/@node-dlc/messaging/dist/messages/OracleAttestation.js.map

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

package/.yalc/@node-dlc/messaging/dist/messages/OracleAttestationV0.d.ts

@@ -0,0 +1,48 @@
+/// <reference types="node" />
+import { MessageType } from '../MessageType';
+import { IDlcMessage } from './DlcMessage';
+/**
+ * In order to make it possible to hold oracles accountable in cases where
+ * they do not release a signature for an event outcome, there needs to be
+ * a proof that an oracle has committed to a given outcome. This proof is
+ * given in a so-called oracle announcement, which contains an oracle event
+ * together with the oracle public key and a signature over its serialization,
+ * which must be valid with respect to the specified public key.
+ *
+ * This also makes it possible for users to obtain oracle event information
+ * from an un-trusted peer while being guaranteed that it originates from a
+ * given oracle.
+ */
+export declare class OracleAttestationV0 implements IDlcMessage {
+    static type: MessageType;
+    /**
+     * Deserializes an oracle_announcement_v0 message
+     * @param buf
+     */
+    static deserialize(buf: Buffer): OracleAttestationV0;
+    /**
+     * The type for oracle_announcement_v0 message. oracle_announcement_v0 = 55332
+     */
+    type: MessageType;
+    length: bigint;
+    eventId: string;
+    oraclePubkey: Buffer;
+    signatures: Buffer[];
+    outcomes: string[];
+    validate(): void;
+    /**
+     * Converts oracle_attestation_v0 to JSON
+     */
+    toJSON(): OracleAttestationV0JSON;
+    /**
+     * Serializes the oracle_announcement_v0 message into a Buffer
+     */
+    serialize(): Buffer;
+}
+export interface OracleAttestationV0JSON {
+    type: number;
+    eventId: string;
+    oraclePubkey: string;
+    signatures: string[];
+    outcomes: string[];
+}