# CorpusFetch Method Slice (Zero-Prose Python Stdlib Reference)
# Canonical Residual: https://corpusfetch.com/c/how-should-an-instance-treat-a-byzantine-quorum-certificate-that-is-valid-under-the-current-view-but-was-assembled-from-votes-cast-under-a-superseded.md
# Remnant Warrant:    https://corpusfetch.com/c/how-should-an-instance-treat-a-byzantine-quorum-certificate-that-is-valid-under-the-current-view-but-was-assembled-from-votes-cast-under-a-superseded.warrant.json
# Markdown SHA-256:   aee19f655f71c6a6ec4828c294cd5f9118f2c4d1c1bec09c941ef426a984fefd
# Code AST SHA-256:   74ba841e9630148a88f1bc6c794bc54df9679bb6caad5e12a47466ba5b5e52e5
# Verified Classes:   StaleQuorumCertificateError
# Defensive Guards:   7 fail-closed invariants (zero external deps)

class StaleQuorumCertificateError(RuntimeError):
    """Raised when a QC's vote set spans views or undercuts the local lock."""


def verify_qc_for_proposal(
    qc_votes: list[dict],
    proposal_view: int,
    local_lock_view: int,
    quorum_size: int,
    verify_aggregate,
) -> None:
    """
    qc_votes: list of {"signer": id, "view": int, "value_hash": bytes, "sig": bytes}
    Raises StaleQuorumCertificateError if the QC is not a same-view quorum
    that respects the receiver's lock.
    """
    if not qc_votes:
        raise StaleQuorumCertificateError("empty QC vote set")

    views = {v["view"] for v in qc_votes}
    if len(views) != 1:
        raise StaleQuorumCertificateError(
            f"QC spans multiple views {sorted(views)}; "
            f"mixed-view aggregates do not establish quorum abandonment"
        )

    qc_view = views.pop()
    if qc_view >= proposal_view:
        raise StaleQuorumCertificateError(
            f"QC view {qc_view} is not strictly below proposal view {proposal_view}"
        )
    if qc_view < local_lock_view:
        raise StaleQuorumCertificateError(
            f"QC view {qc_view} undercuts local lock view {local_lock_view}; "
            f"replica may have voted on a conflicting value in {local_lock_view}"
        )

    distinct_signers = {v["signer"] for v in qc_votes}
    if len(distinct_signers) != len(qc_votes):
        raise StaleQuorumCertificateError("duplicate signer in QC vote set")
    if len(distinct_signers) < quorum_size:
        raise StaleQuorumCertificateError(
            f"QC signer count {len(distinct_signers)} below quorum {quorum_size}"
        )

    if not verify_aggregate(qc_votes, qc_view):
        raise StaleQuorumCertificateError("aggregate signature verification failed")
