ade_codec

Owns Cardano-canonical CBOR ingress — the only place in the workspace that turns raw bytes into typed semantic values, with wire-byte preservation for every hash-bearing structure. Owns the standalone opcert byte authority, the canonical Conway-tx preserved-byte splitter, the canonical block-envelope encoder cbor::envelope::encode_block_envelope, and the single workspace tag-24 CBOR-in-CBOR wire-envelope authority cbor::tag24::{wrap_tag24, unwrap_tag24}. Exposes the shared canonical CBOR read/write primitives (read_map_header, read_array_header, canonical_width, ContainerEncoding, IntWidth) the BLUE codecs in ade_ledger (incl. the native Mithril MemPack/state decoders) + ade_network build on. Owns the POSITION-BLIND header prev_hash codec shelley::block::decode_prev_hash (CN-WIRE-09) and the era-parameterized pointer-address decoder address::pointer::{Ptr, PointerDecodeError}. (No ade_codec type change since cdcd9397 — 13.)

PreservedCbor<T>, RawCbor, BlockEnvelope, ByronDecodedBlock, CodecContext, CodecError, ContainerEncoding, IntWidth, era-tagged block/tx wrappers, OpCertCodecError, TxComponents<'a>, TagEnvelopeError (closed), address::pointer::Ptr + address::pointer::PointerDecodeError (closed). 13 public types.

All canonical Cardano CBOR. unwrap_tag24 is the single workspace authority that strips a tag-24 (0xd8 0x18) envelope (zero-copy borrow, fail-closed). shelley::block::decode_prev_hash decodes the header prev_hash POSITION-BLIND. address::pointer::decode_pointer_address(addr_bytes, era) decodes a pointer address's variable-length (slot, txIx, certIx) tail (era-parameterized; the retirement era gate lives in ade_ledger::stake_ref).

(1) Construct PreservedCbor outside ade_codec. (2) Re-encode wire bytes when computing hashes. (3) Use any forbidden BLUE pattern. (4) Depend on any workspace crate except ade_types. (5)–(11) per-construct prohibitions (Conway cert/withdrawals/governance, opcert, tx_components, single block-envelope encoder). (12, CN-WIRE-08) cbor::tag24 — wrap_tag24/unwrap_tag24 defined exactly once; fail-closed; no second/hand-rolled tag-24 parse anywhere. (13, CN-WIRE-09) shelley::block::decode_prev_hash — POSITION-BLIND; the position-aware coupling lives in ade_ledger::block_validity::header_position. (14) address::pointer — BYTE REPRESENTATION ONLY; MUST NOT resolve a credential, apply the Conway pointer-retirement era gate, or attribute stake; a malformed / under-length tail fails closed (PointerDecodeError), never a fabricated coordinate.

ade_ledger (heavy; incl. the reduced-view stake_ref/pointer_resolve + the native mithril_utxo_materialize/ledgerdb_* decoders), ade_plutus, ade_testkit, ade_network, ade_runtime, ade_core_interop, ade_node.

ade_types. std-only; dev-deps serde_json, toml.

ade_codec::cbor::envelope::{decode_block_envelope, encode_block_envelope}, ade_codec::{wrap_tag24, unwrap_tag24, TagEnvelopeError}, the cbor::{read_*, write_*_canonical, canonical_width, ContainerEncoding, IntWidth} primitives, ade_codec::traits::AdeEncode, per-era decode_*_block (incl. conway::decode_conway_block), ade_codec::shelley::{opcert::*, tx_components::split_conway_tx_components, block::decode_prev_hash}, ade_codec::address::{decode_address, pointer::{decode_pointer_address, Ptr, PointerDecodeError}}.

cbor/ (incl. envelope.rs, tag24.rs), byron/, shelley/ (incl. block.rs, cert.rs, opcert.rs, tx_components.rs), allegra/, mary/, alonzo/, babbage/, conway/, address/ (incl. pointer.rs), preserved.rs, traits.rs, primitives.rs, error.rs.