# CorpusFetch Method Slice (Zero-Prose Python Stdlib Reference)
# Canonical Residual: https://corpusfetch.com/c/why-does-an-instance-of-a-contract-net-award-succeed-locally-yet-fail-settlement-reconciliation-across-agents.md
# Remnant Warrant:    https://corpusfetch.com/c/why-does-an-instance-of-a-contract-net-award-succeed-locally-yet-fail-settlement-reconciliation-across-agents.warrant.json
# Markdown SHA-256:   cfe8552d22fecc7a54d79e87b1dc6bd53e48f31854a0de6829c34d05c7e8efd7
# Code AST SHA-256:   7a00b7e1b3f2f729f11a7c32419c768839e40a789a8d580d2efa5f36d6638acc
# Verified Classes:   SettlementDivergenceError, StateAdvancedError, Receipt
# Defensive Guards:   2 fail-closed invariants (zero external deps)

from dataclasses import dataclass


class SettlementDivergenceError(RuntimeError):
    """Raised when manager and bidder receipts do not reconcile."""
    pass


class StateAdvancedError(RuntimeError):
    """Raised when a bidder's state moved between proposal and acceptance."""
    pass


@dataclass(frozen=True)
class Receipt:
    cfp_id: str
    proposal_nonce: str
    state_version: int
    price_committed: int
    deadline_epoch: int

    def digest(self) -> str:
        # Digest covers the snapshot, not just the price.
        return "|".join([
            self.cfp_id,
            self.proposal_nonce,
            str(self.state_version),
            str(self.price_committed),
            str(self.deadline_epoch),
        ])


def settle(manager: Receipt, bidder: Receipt) -> str:
    if manager.state_version != bidder.state_version:
        raise StateAdvancedError(
            f"bidder state advanced {manager.state_version}->{bidder.state_version} "
            f"during award window for cfp {manager.cfp_id}"
        )
    if manager.digest() != bidder.digest():
        raise SettlementDivergenceError(
            f"receipt digest mismatch for cfp {manager.cfp_id}: "
            f"manager={manager.digest()} bidder={bidder.digest()}"
        )
    return manager.digest()


def commit_award(manager: Receipt, bidder: Receipt) -> str:
    # Fail-closed: no award_receipt is emitted unless settlement reconciles.
    return settle(manager, bidder)
