Files
DECNET/decnet/rpki/base.py
anti f2b3393669 chore: relicense to AGPL-3.0-or-later and add SPDX headers
Replaces LICENSE (GPLv3 -> AGPLv3) and prepends
`SPDX-License-Identifier: AGPL-3.0-or-later` to every source file
across decnet/, decnet_web/, tests/, scripts/, and tools/.

Rationale: closes the GPLv3 ASP loophole so any party operating a
modified DECNET as a network service must offer their modified
source. Personal copyright (Samuel Paschuan) + inbound=outbound
contributions make a future unilateral relicense infeasible.

- LICENSE: full AGPL-3.0 text (gnu.org/licenses/agpl-3.0.txt)
- COPYRIGHT: project copyright notice
- tools/add_spdx_headers.py: idempotent header injector
  (shebang- and PEP 263-aware)

Touches 1565 source files (.py, .ts, .tsx, .js, .jsx, .css, .sh).
No behavior change; comments only.
2026-05-22 21:04:16 -04:00

40 lines
1.1 KiB
Python

# SPDX-License-Identifier: AGPL-3.0-or-later
"""RPKI validator protocol.
Concrete validators (:mod:`decnet.rpki.ripestat`, future offline providers)
implement this. Callers must go through
:func:`~decnet.rpki.factory.get_validator`; never import a concrete
validator class directly.
"""
from __future__ import annotations
from abc import ABC, abstractmethod
from dataclasses import dataclass
from datetime import datetime
from typing import Literal, Optional
RpkiStatus = Literal["valid", "invalid", "not-found", "unknown"]
@dataclass(frozen=True)
class RpkiResult:
"""Outcome of a single RPKI validity check."""
status: RpkiStatus
prefix: Optional[str] = None # announced prefix the validator resolved for this IP
validated_at: Optional[datetime] = None
class Validator(ABC):
"""Abstract RPKI validator."""
#: Short tag written to ``Attacker.rpki_source`` (e.g. ``'ripestat'``).
name: str
@abstractmethod
def validate(self, ip: str, asn: int) -> RpkiResult:
"""Return RPKI validity for (ip, asn). Never raises."""
def refresh(self) -> None:
"""No-op for online validators; offline providers may override."""