"""
synta.mtc — Merkle Tree Certificate (MTC) types, builders, and validators.
This module is implemented in Rust (``synta-mtc`` / ``synta-python-mtc``) and
registered as a submodule of the ``synta._mtc`` extension during ``import synta``.
It is available immediately after::
import synta
The module provides three categories of objects:
- **Parsed types** — immutable (frozen) classes constructed via ``from_der``
static methods: ``ProofNode``, ``Subtree``, ``SubtreeProof``,
``InclusionProof``, ``LogID``, ``CosignerID``, ``Checkpoint``,
``SubtreeSignature``, ``TbsCertificateLogEntry``, ``MerkleTreeCertEntry``,
``LandmarkID``, ``StandaloneCertificate``, ``LandmarkCertificate``.
- **TLS wire types** — ``HashAlgorithm``, ``MtcSignature``, ``MtcProof``
(encoded/decoded via TLS framing, not DER).
- **Builder types** — ``IssuanceLogBuilder``, ``MtcX509CertificateBuilder``,
``StandaloneCertificateBuilder``, ``LandmarkCertificateBuilder``.
- **Validation types** — ``RevokedRanges``, ``ValidationPolicy``,
``TrustAnchor``, ``CertificateValidator``.
- **Module-level functions** — ``extract_leaf_index``, ``extract_log_number``,
``build_mtc_ca_extension``, ``parse_mtc_ca_extension``.
See ``synta/mtc.pyi`` for the full API reference.
"""
# This file is a documentation and IDE-stub only. The live module object for
# ``synta.mtc`` is the Rust module registered in sys.modules["synta.mtc"]
# by synta-python's _mtc initialiser and exposed as an attribute on ``synta``
# via the sys.modules assignment in ``synta/__init__.py``.