@optimystic/db-p2p 0.2.3 → 0.3.0

package/dist/src/dispute/arbitrator-selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arbitrator-selection.d.ts","sourceRoot":"","sources":["../../../src/dispute/arbitrator-selection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAuB,KAAK,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAEnF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAChC,QAAQ,EAAE,SAAS,EAAE,EACrB,YAAY,EAAE,UAAU,EACxB,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,EAC3B,KAAK,EAAE,MAAM,GACX,MAAM,EAAE,CAaV"}

package/dist/src/dispute/arbitrator-selection.js

@@ -0,0 +1,22 @@
+import { sortPeersByDistance } from '../routing/responsibility.js';
+/**
+ * Select arbitrators for a dispute using XOR-distance from the block ID.
+ * Selects the next K peers beyond the original cluster (positions K+1 through 2K).
+ * This ensures independence (arbitrators are not in the original cluster)
+ * and determinism (all parties agree on who arbitrates).
+ */
+export function selectArbitrators(allPeers, blockIdBytes, excludePeerIds, count) {
+    // Sort all peers by XOR distance to the block ID
+    const sorted = sortPeersByDistance(allPeers, blockIdBytes);
+    // Skip peers in the original cluster (and self), select the next K
+    const arbitrators = [];
+    for (const peer of sorted) {
+        if (arbitrators.length >= count)
+            break;
+        if (excludePeerIds.has(peer.id.toString()))
+            continue;
+        arbitrators.push(peer.id);
+    }
+    return arbitrators;
+}
+//# sourceMappingURL=arbitrator-selection.js.map

package/dist/src/dispute/arbitrator-selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arbitrator-selection.js","sourceRoot":"","sources":["../../../src/dispute/arbitrator-selection.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAkB,MAAM,8BAA8B,CAAC;AAEnF;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAChC,QAAqB,EACrB,YAAwB,EACxB,cAA2B,EAC3B,KAAa;IAEb,iDAAiD;IACjD,MAAM,MAAM,GAAG,mBAAmB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAE3D,mEAAmE;IACnE,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,WAAW,CAAC,MAAM,IAAI,KAAK;YAAE,MAAM;QACvC,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC;YAAE,SAAS;QACrD,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,WAAW,CAAC;AACpB,CAAC"}

package/dist/src/dispute/client.d.ts

@@ -0,0 +1,17 @@
+import type { PeerId, IPeerNetwork } from '@optimystic/db-core';
+import { ProtocolClient } from '../protocol-client.js';
+import type { DisputeChallenge, DisputeResolution, ArbitrationVote } from './types.js';
+/**
+ * Client for the dispute protocol. Sends challenges to arbitrators
+ * and broadcasts resolutions.
+ */
+export declare class DisputeClient extends ProtocolClient {
+    private readonly protocol;
+    constructor(peerId: PeerId, peerNetwork: IPeerNetwork, protocolPrefix?: string);
+    static create(peerId: PeerId, peerNetwork: IPeerNetwork, protocolPrefix?: string): DisputeClient;
+    /** Send a challenge to an arbitrator and get their vote */
+    sendChallenge(challenge: DisputeChallenge, timeoutMs?: number): Promise<ArbitrationVote>;
+    /** Send a resolution to a peer (broadcast) */
+    sendResolution(resolution: DisputeResolution): Promise<void>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/src/dispute/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/dispute/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,eAAe,EAAkB,MAAM,YAAY,CAAC;AAEvG;;;GAGG;AACH,qBAAa,aAAc,SAAQ,cAAc;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,CAAC,EAAE,MAAM;IAK9E,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,aAAa;IAIhG,2DAA2D;IACrD,aAAa,CAAC,SAAS,EAAE,gBAAgB,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAW9F,8CAA8C;IACxC,cAAc,CAAC,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;CAOlE"}

package/dist/src/dispute/client.js

@@ -0,0 +1,28 @@
+import { ProtocolClient } from '../protocol-client.js';
+/**
+ * Client for the dispute protocol. Sends challenges to arbitrators
+ * and broadcasts resolutions.
+ */
+export class DisputeClient extends ProtocolClient {
+    protocol;
+    constructor(peerId, peerNetwork, protocolPrefix) {
+        super(peerId, peerNetwork);
+        this.protocol = (protocolPrefix ?? '/db-p2p') + '/dispute/1.0.0';
+    }
+    static create(peerId, peerNetwork, protocolPrefix) {
+        return new DisputeClient(peerId, peerNetwork, protocolPrefix);
+    }
+    /** Send a challenge to an arbitrator and get their vote */
+    async sendChallenge(challenge, timeoutMs) {
+        const message = { type: 'challenge', challenge };
+        const signal = timeoutMs ? AbortSignal.timeout(timeoutMs) : undefined;
+        const response = await this.processMessage(message, this.protocol, { signal });
+        return response.vote;
+    }
+    /** Send a resolution to a peer (broadcast) */
+    async sendResolution(resolution) {
+        const message = { type: 'resolution', resolution };
+        await this.processMessage(message, this.protocol);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/src/dispute/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/dispute/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD;;;GAGG;AACH,MAAM,OAAO,aAAc,SAAQ,cAAc;IAC/B,QAAQ,CAAS;IAElC,YAAY,MAAc,EAAE,WAAyB,EAAE,cAAuB;QAC7E,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAC3B,IAAI,CAAC,QAAQ,GAAG,CAAC,cAAc,IAAI,SAAS,CAAC,GAAG,gBAAgB,CAAC;IAClE,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,MAAc,EAAE,WAAyB,EAAE,cAAuB;QAC/E,OAAO,IAAI,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC;IAC/D,CAAC;IAED,2DAA2D;IAC3D,KAAK,CAAC,aAAa,CAAC,SAA2B,EAAE,SAAkB;QAClE,MAAM,OAAO,GAAmB,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;QACjE,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACtE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,cAAc,CACzC,OAAO,EACP,IAAI,CAAC,QAAQ,EACb,EAAE,MAAM,EAAE,CACV,CAAC;QACF,OAAO,QAAQ,CAAC,IAAI,CAAC;IACtB,CAAC;IAED,8CAA8C;IAC9C,KAAK,CAAC,cAAc,CAAC,UAA6B;QACjD,MAAM,OAAO,GAAmB,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;QACnE,MAAM,IAAI,CAAC,cAAc,CACxB,OAAO,EACP,IAAI,CAAC,QAAQ,CACb,CAAC;IACH,CAAC;CACD"}

package/dist/src/dispute/dispute-service.d.ts

@@ -0,0 +1,81 @@
+import type { ClusterRecord, ITransactionValidator } from '@optimystic/db-core';
+import type { PeerId, PrivateKey } from '@libp2p/interface';
+import type { ValidationEvidence, DisputeChallenge, ArbitrationVote, DisputeResolution, DisputeConfig, DisputeStatus } from './types.js';
+import { EngineHealthMonitor } from './engine-health-monitor.js';
+import type { IPeerReputation } from '../reputation/types.js';
+import type { IPeerNetwork } from '@optimystic/db-core';
+import type { DisputeClient } from './client.js';
+/** Callback to create a DisputeClient for a given peer */
+export type CreateDisputeClient = (peerId: PeerId) => DisputeClient;
+/** Callback to re-execute a transaction and produce validation evidence */
+export type RevalidateTransaction = (record: ClusterRecord) => Promise<ValidationEvidence | undefined>;
+export interface DisputeServiceInit {
+    peerId: PeerId;
+    privateKey: PrivateKey;
+    peerNetwork: IPeerNetwork;
+    createDisputeClient: CreateDisputeClient;
+    reputation?: IPeerReputation;
+    validator?: ITransactionValidator;
+    revalidate?: RevalidateTransaction;
+    config?: Partial<DisputeConfig>;
+    /** Select arbitrators for a dispute (next K peers beyond the original cluster) */
+    selectArbitrators: (blockId: string, excludePeers: string[], count: number) => Promise<PeerId[]>;
+}
+/**
+ * Manages the dispute escalation protocol.
+ *
+ * When a transaction proceeds despite minority rejections, the overridden
+ * minority can escalate to independent arbitrators. The service coordinates
+ * challenge initiation, arbitration vote collection, and resolution.
+ */
+export declare class DisputeService {
+    private readonly peerId;
+    private readonly privateKey;
+    private readonly createDisputeClient;
+    private readonly reputation?;
+    private readonly revalidate?;
+    private readonly config;
+    private readonly engineHealth;
+    private readonly selectArbitrators;
+    /** Active disputes initiated by this node */
+    private activeDisputes;
+    /** Resolved disputes (disputeId -> resolution) */
+    private resolvedDisputes;
+    /** Track which transactions we've already disputed (prevent spam) */
+    private disputedTransactions;
+    constructor(init: DisputeServiceInit);
+    /** Get the engine health monitor */
+    getEngineHealth(): EngineHealthMonitor;
+    /** Check if disputes are enabled */
+    isEnabled(): boolean;
+    /** Get the dispute status for a transaction, if any */
+    getDisputeStatus(messageHash: string): DisputeStatus | undefined;
+    /**
+     * Initiate a dispute when this node's rejection was overridden.
+     * Called by ClusterMember when it detects a disputed commit.
+     */
+    initiateDispute(record: ClusterRecord, evidence: ValidationEvidence): Promise<DisputeResolution | undefined>;
+    /**
+     * Handle an incoming dispute challenge (when this node is selected as arbitrator).
+     * Re-executes the transaction and returns a vote.
+     */
+    handleChallenge(challenge: DisputeChallenge): Promise<ArbitrationVote>;
+    /**
+     * Handle an incoming dispute resolution (broadcast from the dispute initiator).
+     */
+    handleResolution(resolution: DisputeResolution): void;
+    /** Collect votes from arbitrators with a timeout */
+    private collectVotes;
+    /** Determine dispute resolution from collected votes */
+    resolveDispute(challenge: DisputeChallenge, votes: ArbitrationVote[]): DisputeResolution;
+    /** Apply reputation effects based on dispute resolution */
+    private applyReputationEffects;
+    /** Broadcast resolution to all interested parties */
+    private broadcastResolution;
+    private makeVote;
+    private computeDisputeId;
+    private signDispute;
+    private verifyDisputeSignature;
+    private findChallengeForDispute;
+}
+//# sourceMappingURL=dispute-service.d.ts.map

package/dist/src/dispute/dispute-service.d.ts.map

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

package/dist/src/dispute/dispute-service.js

@@ -0,0 +1,365 @@
+import { sha256 } from 'multiformats/hashes/sha2';
+import { base58btc } from 'multiformats/bases/base58';
+import { toString as uint8ArrayToString, fromString as uint8ArrayFromString } from 'uint8arrays';
+import { publicKeyFromRaw } from '@libp2p/crypto/keys';
+import { DEFAULT_DISPUTE_CONFIG } from './types.js';
+import { EngineHealthMonitor } from './engine-health-monitor.js';
+import { PenaltyReason } from '../reputation/types.js';
+import { createLogger } from '../logger.js';
+const log = createLogger('dispute');
+/**
+ * Manages the dispute escalation protocol.
+ *
+ * When a transaction proceeds despite minority rejections, the overridden
+ * minority can escalate to independent arbitrators. The service coordinates
+ * challenge initiation, arbitration vote collection, and resolution.
+ */
+export class DisputeService {
+    peerId;
+    privateKey;
+    createDisputeClient;
+    reputation;
+    revalidate;
+    config;
+    engineHealth;
+    selectArbitrators;
+    /** Active disputes initiated by this node */
+    activeDisputes = new Map();
+    /** Resolved disputes (disputeId -> resolution) */
+    resolvedDisputes = new Map();
+    /** Track which transactions we've already disputed (prevent spam) */
+    disputedTransactions = new Set();
+    constructor(init) {
+        this.peerId = init.peerId;
+        this.privateKey = init.privateKey;
+        this.createDisputeClient = init.createDisputeClient;
+        this.reputation = init.reputation;
+        this.revalidate = init.revalidate;
+        this.config = { ...DEFAULT_DISPUTE_CONFIG, ...init.config };
+        this.engineHealth = new EngineHealthMonitor(this.config);
+        this.selectArbitrators = init.selectArbitrators;
+    }
+    /** Get the engine health monitor */
+    getEngineHealth() {
+        return this.engineHealth;
+    }
+    /** Check if disputes are enabled */
+    isEnabled() {
+        return this.config.disputeEnabled;
+    }
+    /** Get the dispute status for a transaction, if any */
+    getDisputeStatus(messageHash) {
+        // Check if there's an active dispute for this transaction
+        for (const [, challenge] of this.activeDisputes) {
+            if (challenge.originalMessageHash === messageHash) {
+                return 'committed-disputed';
+            }
+        }
+        // Check resolved disputes
+        for (const [, resolution] of this.resolvedDisputes) {
+            const challenge = this.findChallengeForDispute(resolution.disputeId);
+            if (challenge && challenge.originalMessageHash === messageHash) {
+                if (resolution.outcome === 'challenger-wins')
+                    return 'committed-invalidated';
+                if (resolution.outcome === 'majority-wins')
+                    return 'committed-validated';
+                return 'committed-disputed'; // inconclusive
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Initiate a dispute when this node's rejection was overridden.
+     * Called by ClusterMember when it detects a disputed commit.
+     */
+    async initiateDispute(record, evidence) {
+        if (!this.config.disputeEnabled) {
+            log('dispute-disabled', { messageHash: record.messageHash });
+            return undefined;
+        }
+        // One dispute per transaction
+        if (this.disputedTransactions.has(record.messageHash)) {
+            log('dispute-already-initiated', { messageHash: record.messageHash });
+            return undefined;
+        }
+        // Don't dispute if our engine is unhealthy
+        if (this.engineHealth.isUnhealthy()) {
+            log('dispute-skipped-unhealthy', { messageHash: record.messageHash });
+            return undefined;
+        }
+        this.disputedTransactions.add(record.messageHash);
+        const timestamp = Date.now();
+        const disputeId = await this.computeDisputeId(record.messageHash, this.peerId.toString(), timestamp);
+        const signature = await this.signDispute(disputeId);
+        const defaultTtl = record.message.expiration
+            ? (record.message.expiration - Date.now()) * 2
+            : this.config.disputeArbitrationTimeoutMs * 2;
+        const expiration = timestamp + Math.max(defaultTtl, this.config.disputeArbitrationTimeoutMs);
+        const challenge = {
+            disputeId,
+            originalMessageHash: record.messageHash,
+            originalRecord: record,
+            challengerPeerId: this.peerId.toString(),
+            challengerEvidence: evidence,
+            signature,
+            timestamp,
+            expiration,
+        };
+        this.activeDisputes.set(disputeId, challenge);
+        log('dispute-initiated', { disputeId, messageHash: record.messageHash });
+        // Select arbitrators and collect votes
+        const blockIds = record.coordinatingBlockIds ?? [];
+        const blockId = blockIds[0] ?? record.messageHash;
+        const originalPeers = Object.keys(record.peers);
+        const arbitratorCount = this.config.arbitratorCount ?? originalPeers.length;
+        let arbitrators;
+        try {
+            arbitrators = await this.selectArbitrators(blockId, originalPeers, arbitratorCount);
+        }
+        catch (err) {
+            log('dispute-arbitrator-selection-failed', { disputeId, error: err instanceof Error ? err.message : String(err) });
+            this.activeDisputes.delete(disputeId);
+            return undefined;
+        }
+        if (arbitrators.length === 0) {
+            log('dispute-no-arbitrators', { disputeId });
+            this.activeDisputes.delete(disputeId);
+            return undefined;
+        }
+        // Send challenge to all arbitrators and collect votes
+        const votes = await this.collectVotes(challenge, arbitrators);
+        const resolution = this.resolveDispute(challenge, votes);
+        this.activeDisputes.delete(disputeId);
+        this.resolvedDisputes.set(disputeId, resolution);
+        // Apply reputation effects
+        this.applyReputationEffects(resolution, record);
+        // Broadcast resolution
+        await this.broadcastResolution(resolution, arbitrators, originalPeers);
+        log('dispute-resolved', {
+            disputeId,
+            outcome: resolution.outcome,
+            votes: votes.length,
+            affectedPeers: resolution.affectedPeers.length,
+        });
+        return resolution;
+    }
+    /**
+     * Handle an incoming dispute challenge (when this node is selected as arbitrator).
+     * Re-executes the transaction and returns a vote.
+     */
+    async handleChallenge(challenge) {
+        log('dispute-handle-challenge', { disputeId: challenge.disputeId });
+        // Verify the challenge signature
+        const validSignature = await this.verifyDisputeSignature(challenge.disputeId, challenge.signature, challenge.originalRecord.peers[challenge.challengerPeerId]?.publicKey);
+        if (!validSignature) {
+            log('dispute-invalid-challenge-signature', { disputeId: challenge.disputeId });
+            return this.makeVote(challenge.disputeId, 'inconclusive', {
+                computedHash: '',
+                engineId: 'unknown',
+                schemaHash: '',
+                blockStateHashes: {},
+            });
+        }
+        // Re-execute the transaction to produce our own evidence
+        let evidence;
+        if (this.revalidate) {
+            try {
+                evidence = await this.revalidate(challenge.originalRecord);
+            }
+            catch (err) {
+                log('dispute-revalidation-failed', {
+                    disputeId: challenge.disputeId,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+        if (!evidence) {
+            // Can't re-execute — vote inconclusive
+            return this.makeVote(challenge.disputeId, 'inconclusive', {
+                computedHash: '',
+                engineId: 'unknown',
+                schemaHash: '',
+                blockStateHashes: {},
+            });
+        }
+        // Compare our evidence with the challenger's
+        let vote;
+        if (evidence.computedHash === challenge.challengerEvidence.computedHash) {
+            // Our re-execution matches the challenger — the challenger is right
+            vote = 'agree-with-challenger';
+        }
+        else {
+            // Our re-execution differs from the challenger — the majority is likely right
+            vote = 'agree-with-majority';
+        }
+        return this.makeVote(challenge.disputeId, vote, evidence);
+    }
+    /**
+     * Handle an incoming dispute resolution (broadcast from the dispute initiator).
+     */
+    handleResolution(resolution) {
+        this.resolvedDisputes.set(resolution.disputeId, resolution);
+        log('dispute-resolution-received', {
+            disputeId: resolution.disputeId,
+            outcome: resolution.outcome,
+        });
+        // If we were penalized and the challenger won, check engine health
+        const ourId = this.peerId.toString();
+        const ourPenalty = resolution.affectedPeers.find(p => p.peerId === ourId);
+        if (ourPenalty && ourPenalty.reason === 'false-approval') {
+            this.engineHealth.recordDisputeLoss();
+        }
+    }
+    /** Collect votes from arbitrators with a timeout */
+    async collectVotes(challenge, arbitrators) {
+        const timeoutMs = this.config.disputeArbitrationTimeoutMs;
+        const votes = [];
+        const votePromises = arbitrators.map(async (arbitratorPeerId) => {
+            try {
+                const client = this.createDisputeClient(arbitratorPeerId);
+                const vote = await client.sendChallenge(challenge, timeoutMs);
+                return vote;
+            }
+            catch (err) {
+                log('dispute-vote-collection-failed', {
+                    disputeId: challenge.disputeId,
+                    arbitrator: arbitratorPeerId.toString(),
+                    error: err instanceof Error ? err.message : String(err),
+                });
+                return undefined;
+            }
+        });
+        const results = await Promise.allSettled(votePromises);
+        for (const result of results) {
+            if (result.status === 'fulfilled' && result.value) {
+                votes.push(result.value);
+            }
+        }
+        return votes;
+    }
+    /** Determine dispute resolution from collected votes */
+    resolveDispute(challenge, votes) {
+        const challengerVotes = votes.filter(v => v.vote === 'agree-with-challenger').length;
+        const majorityVotes = votes.filter(v => v.vote === 'agree-with-majority').length;
+        const totalDecisive = challengerVotes + majorityVotes;
+        // Need super-majority of decisive votes (>2/3)
+        const superMajorityThreshold = Math.ceil(totalDecisive * 2 / 3);
+        let outcome;
+        const affectedPeers = [];
+        if (totalDecisive === 0) {
+            outcome = 'inconclusive';
+        }
+        else if (challengerVotes >= superMajorityThreshold) {
+            outcome = 'challenger-wins';
+            // Penalize majority peers who approved the transaction
+            const originalRecord = challenge.originalRecord;
+            for (const [peerId, signature] of Object.entries(originalRecord.promises)) {
+                if (signature.type === 'approve' && peerId !== challenge.challengerPeerId) {
+                    affectedPeers.push({ peerId, reason: 'false-approval' });
+                }
+            }
+        }
+        else if (majorityVotes >= superMajorityThreshold) {
+            outcome = 'majority-wins';
+            // Penalize the challenger
+            affectedPeers.push({ peerId: challenge.challengerPeerId, reason: 'dispute-lost' });
+        }
+        else {
+            outcome = 'inconclusive';
+        }
+        return {
+            disputeId: challenge.disputeId,
+            outcome,
+            votes,
+            affectedPeers,
+            timestamp: Date.now(),
+        };
+    }
+    /** Apply reputation effects based on dispute resolution */
+    applyReputationEffects(resolution, record) {
+        if (!this.reputation)
+            return;
+        for (const affected of resolution.affectedPeers) {
+            if (affected.reason === 'false-approval') {
+                // Weight: 40 as specified in ticket
+                this.reputation.reportPeer(affected.peerId, PenaltyReason.FalseApproval, `dispute:false-approval:${resolution.disputeId}`);
+            }
+            else if (affected.reason === 'dispute-lost') {
+                // Weight: 30 as specified in ticket
+                this.reputation.reportPeer(affected.peerId, PenaltyReason.DisputeLost, `dispute:dispute-lost:${resolution.disputeId}`);
+            }
+        }
+        // If challenger wins, track engine health for majority peers
+        if (resolution.outcome === 'challenger-wins') {
+            const ourId = this.peerId.toString();
+            if (resolution.affectedPeers.some(p => p.peerId === ourId)) {
+                this.engineHealth.recordDisputeLoss();
+            }
+        }
+    }
+    /** Broadcast resolution to all interested parties */
+    async broadcastResolution(resolution, arbitrators, originalPeers) {
+        const allTargets = new Set();
+        for (const arb of arbitrators)
+            allTargets.add(arb.toString());
+        for (const peer of originalPeers)
+            allTargets.add(peer);
+        // Don't send to self
+        allTargets.delete(this.peerId.toString());
+        const promises = Array.from(allTargets).map(async (peerIdStr) => {
+            try {
+                const { peerIdFromString } = await import('@libp2p/peer-id');
+                const client = this.createDisputeClient(peerIdFromString(peerIdStr));
+                await client.sendResolution(resolution);
+            }
+            catch (err) {
+                log('dispute-broadcast-failed', {
+                    disputeId: resolution.disputeId,
+                    peer: peerIdStr,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        });
+        await Promise.allSettled(promises);
+    }
+    async makeVote(disputeId, vote, evidence) {
+        const payload = `${disputeId}:${vote}:${evidence.computedHash}`;
+        const payloadBytes = new TextEncoder().encode(payload);
+        const sigBytes = await this.privateKey.sign(payloadBytes);
+        return {
+            disputeId,
+            arbitratorPeerId: this.peerId.toString(),
+            vote,
+            evidence,
+            signature: uint8ArrayToString(sigBytes, 'base64url'),
+        };
+    }
+    async computeDisputeId(messageHash, peerId, timestamp) {
+        const input = `${messageHash}+${peerId}+${timestamp}`;
+        const inputBytes = new TextEncoder().encode(input);
+        const hashBytes = await sha256.digest(inputBytes);
+        return base58btc.encode(hashBytes.digest);
+    }
+    async signDispute(disputeId) {
+        const payload = new TextEncoder().encode(disputeId);
+        const sigBytes = await this.privateKey.sign(payload);
+        return uint8ArrayToString(sigBytes, 'base64url');
+    }
+    async verifyDisputeSignature(disputeId, signature, publicKey) {
+        if (!publicKey?.length)
+            return false;
+        try {
+            const pubKey = publicKeyFromRaw(publicKey);
+            const payload = new TextEncoder().encode(disputeId);
+            const sigBytes = uint8ArrayFromString(signature, 'base64url');
+            return pubKey.verify(payload, sigBytes);
+        }
+        catch {
+            return false;
+        }
+    }
+    findChallengeForDispute(disputeId) {
+        return this.activeDisputes.get(disputeId);
+    }
+}
+//# sourceMappingURL=dispute-service.js.map

package/dist/src/dispute/dispute-service.js.map

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

package/dist/src/dispute/engine-health-monitor.d.ts

@@ -0,0 +1,22 @@
+import type { EngineHealthState, DisputeConfig } from './types.js';
+/**
+ * Tracks local engine health based on dispute outcomes.
+ * When the node repeatedly loses disputes (its validations are wrong),
+ * it flags itself as unhealthy and stops participating in promise voting.
+ */
+export declare class EngineHealthMonitor {
+    private state;
+    private readonly threshold;
+    private readonly windowMs;
+    constructor(config?: Partial<DisputeConfig>);
+    /** Record a dispute loss (our validation was wrong) */
+    recordDisputeLoss(): void;
+    /** Check if the engine is currently unhealthy */
+    isUnhealthy(): boolean;
+    /** Get the current health state */
+    getState(): Readonly<EngineHealthState>;
+    /** Reset health state (for testing or admin recovery) */
+    reset(): void;
+    private pruneOldLosses;
+}
+//# sourceMappingURL=engine-health-monitor.d.ts.map

package/dist/src/dispute/engine-health-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-health-monitor.d.ts","sourceRoot":"","sources":["../../../src/dispute/engine-health-monitor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAMnE;;;;GAIG;AACH,qBAAa,mBAAmB;IAC/B,OAAO,CAAC,KAAK,CAIX;IAEF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC;IAK3C,uDAAuD;IACvD,iBAAiB,IAAI,IAAI;IAuBzB,iDAAiD;IACjD,WAAW,IAAI,OAAO;IActB,mCAAmC;IACnC,QAAQ,IAAI,QAAQ,CAAC,iBAAiB,CAAC;IAKvC,yDAAyD;IACzD,KAAK,IAAI,IAAI;IAQb,OAAO,CAAC,cAAc;CAKtB"}