Skip to main content

Module remark

Module remark 

Source
Expand description

REMARK wire encoding + on-chain admission helpers.

Traces to: SPEC §16.

§Role

Evidence and appeal payloads travel on-chain inside CLVM REMARK conditions. This module owns the serialisation format, the magic prefixes that namespace DIG slashing payloads against foreign REMARK apps sharing the same on-chain namespace, and the parser that the consensus / mempool layer invokes on every block.

§Scope (incremental)

Opens Phase 6 REMARK Admission. Module grows one DSL at a time. First commit lands DSL-102 — the evidence-side wire encoder + parser. Future DSLs extend this surface:

  • DSL-103: slashing_evidence_remark_puzzle_reveal_v1
  • DSL-104/105: admission preconditions (coin match / mismatch)
  • DSL-106..108: mempool policy (expiry, dupe, caps)
  • DSL-109: payload cap
  • DSL-110..120: full appeal-side parity

§Submodules

Further submodules (evidence_puzzle, appeal_wire, appeal_puzzle, admission, policy) land with their DSL-NNN requirements.

Re-exports§

pub use admissions::BlockAdmissionReport;
pub use admissions::process_block_admissions;
pub use appeal_wire::encode_slash_appeal_remark_payload_v1;
pub use appeal_wire::parse_slash_appeals_from_conditions;
pub use appeal_wire::slash_appeal_remark_puzzle_hash_v1;
pub use appeal_wire::slash_appeal_remark_puzzle_reveal_v1;
pub use evidence_wire::encode_slashing_evidence_remark_payload_v1;
pub use evidence_wire::parse_slashing_evidence_from_conditions;
pub use evidence_wire::slashing_evidence_remark_puzzle_hash_v1;
pub use evidence_wire::slashing_evidence_remark_puzzle_reveal_v1;
pub use policy::enforce_block_level_appeal_caps;
pub use policy::enforce_block_level_slashing_caps;
pub use policy::enforce_slash_appeal_mempool_dedup_policy;
pub use policy::enforce_slash_appeal_mempool_policy;
pub use policy::enforce_slash_appeal_payload_cap;
pub use policy::enforce_slash_appeal_remark_admission;
pub use policy::enforce_slash_appeal_terminal_status_policy;
pub use policy::enforce_slash_appeal_variant_policy;
pub use policy::enforce_slash_appeal_window_policy;
pub use policy::enforce_slashing_evidence_mempool_dedup_policy;
pub use policy::enforce_slashing_evidence_mempool_policy;
pub use policy::enforce_slashing_evidence_payload_cap;
pub use policy::enforce_slashing_evidence_remark_admission;

Modules§

admissions
Block-level admission dispatcher.
appeal_wire
Appeal REMARK wire: encoder + parser (appeal-side analogue of crate::remark::evidence_wire).
evidence_wire
Evidence REMARK wire: encoder + parser.
policy
REMARK admission-policy enforcement.