# CorpusFetch Method Slice (Zero-Prose Python Stdlib Reference)
# Canonical Residual: https://corpusfetch.com/c/which-invariants-prevent-double-settlement-in-contract-net-bidding-with-verifiable-outcome-attestations.md
# Remnant Warrant:    https://corpusfetch.com/c/which-invariants-prevent-double-settlement-in-contract-net-bidding-with-verifiable-outcome-attestations.warrant.json
# Markdown SHA-256:   436ea983fb8545d8022502cc4b0f85b2aab2b1f6d3736652b23c57dfd355adfa
# Code AST SHA-256:   17e2b7b31bed656af5fc6f7d8db23e9b730de4a6f2ebfc9d568cb490e66d6af1
# Verified Classes:   SettlementInvariantError
# Defensive Guards:   4 fail-closed invariants (zero external deps)

class SettlementInvariantError(RuntimeError):
    """Raised when a settlement request violates award/attestation binding."""
    pass


def settle(ledger, attestation, now):
    # attestation: {task_id, award_nonce, outcome_hash, verifier_sig, valid_until}
    if not verify_signature(attestation):
        raise SettlementInvariantError("attestation signature invalid")

    award = ledger.awards.get((attestation["task_id"], attestation["award_nonce"]))
    if award is None:
        raise SettlementInvariantError(
            f"unknown award nonce {attestation['award_nonce']} for task {attestation['task_id']}"
        )

    current_epoch = ledger.current_lease_epoch(attestation["task_id"])
    if award["lease_epoch"] != current_epoch:
        # Ambiguous window: hold, do not settle or reject.
        if now < attestation["valid_until"]:
            return {"status": "hold", "reason": "stale_epoch_live_attestation"}
        raise SettlementInvariantError(
            f"stale award epoch {award['lease_epoch']} != current {current_epoch}"
        )

    key = (attestation["task_id"], attestation["award_nonce"])
    if key in ledger.settlements:
        raise SettlementInvariantError(f"double settlement for {key}")

    ledger.settlements[key] = {
        "bidder_id": award["bidder_id"],
        "outcome_hash": attestation["outcome_hash"],
    }
    return {"status": "settled", "key": key}
