Skip to content

Commit 358677e

Browse files
committed
compact denylist: make explicit different behaviours when finding invalid rules
1 parent aa5f89b commit 358677e

File tree

1 file changed

+7
-0
lines changed

1 file changed

+7
-0
lines changed

COMPACT_DENYLIST_FORMAT.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -266,6 +266,13 @@ A block item represents a rule to enable content-blocking:
266266
- `CID` elements represent a CID (either V0 or V1).
267267
- `CIDv0` are for us equivalent to baseb58btc-encoded sha256 multihashes although they are not the same thing (a CIDV0 carries implicit codec (dag-pb) and multibase information (b58btc). When we say a b58-encoded multihash needs to be extracted from the CID, this usually is a no-op in case of CIDv0s.
268268

269+
Implementations must decide what to do when processing a denylist and an invalid block-item rule is found:
270+
271+
- Prominently log the parsing error (always recommended)
272+
- Abort parsing and return a general error OR
273+
- Continue processing the list, discarding unrecognized rules
274+
275+
269276
##### `/ipfs/CID`
270277

271278
CID-rule: Blocks a specific multihash. If the CID is a V1, it blocks the

0 commit comments

Comments
 (0)