docs: Align fee tier examples between deployment-guide and architecture #68

New issue

Closed

opened 2026-04-09 03:23:47 +00:00 by PlasticDigits · 6 comments

PlasticDigits commented

2026-04-09 03:23:47 +00:00

(Migrated from gitlab.com)

Type

missing-implementation (documentation consistency)

Evidence

docs/deployment-guide.md §5a vs docs/architecture.md tier table — numeric/discount drift

Acceptance criteria

Single authoritative tier table; contradictions removed

Epic

#57

## Type **missing-implementation** (documentation consistency) ## Evidence - `docs/deployment-guide.md` §5a vs `docs/architecture.md` tier table — numeric/discount drift ## Acceptance criteria - [ ] Single authoritative tier table; contradictions removed ## Epic #57

PlasticDigits commented

2026-04-09 03:23:48 +00:00

(Migrated from gitlab.com)

marked this issue as related to #57

PlasticDigits commented

2026-04-13 04:10:41 +00:00

(Migrated from gitlab.com)

Single authoritative tier reference is docs/reference/fee-discount-tiers.md (correct add_tier JSON with min_cl8y_balance and governance_only). Architecture now summarizes and links there; deployment guide §5a defers to it. Integration tests use smartcontracts/tests/src/tier_fixtures.rs (STANDARD_PRODUCTION_TIERS) with updated fee assertions for tier 1/4 and router discount path. @brouie Please confirm tier numbers match intended mainnet economics.

Single authoritative tier reference is `docs/reference/fee-discount-tiers.md` (correct `add_tier` JSON with `min_cl8y_balance` and `governance_only`). Architecture now summarizes and links there; deployment guide §5a defers to it. Integration tests use `smartcontracts/tests/src/tier_fixtures.rs` (`STANDARD_PRODUCTION_TIERS`) with updated fee assertions for tier 1/4 and router discount path. @brouie Please confirm tier numbers match intended mainnet economics.

Brouie commented

2026-04-20 05:56:40 +00:00

(Migrated from gitlab.com)

@PlasticDigits Verified on current main. Acceptance criteria:

Single authoritative tier table; contradictions removed: docs/reference/fee-discount-tiers.md present as the authoritative source. architecture.md line 78 explicitly points to it ('The authoritative ladder, min_cl8y_balance wire values, and example terrad JSON are in docs/reference/fee-discount-tiers.md'). deployment-guide.md line 72 also defers to it ('Use the authoritative tier ladder... in docs/reference/fee-discount-tiers.md'). smartcontracts/tests/src/tier_fixtures.rs defines STANDARD_PRODUCTION_TIERS as the aligned integration test source.

Single source of truth established, no more drift between architecture and deployment guide. Closing.

@PlasticDigits Verified on current main. Acceptance criteria: - [x] Single authoritative tier table; contradictions removed: docs/reference/fee-discount-tiers.md present as the authoritative source. architecture.md line 78 explicitly points to it ('The authoritative ladder, min_cl8y_balance wire values, and example terrad JSON are in docs/reference/fee-discount-tiers.md'). deployment-guide.md line 72 also defers to it ('Use the authoritative tier ladder... in docs/reference/fee-discount-tiers.md'). smartcontracts/tests/src/tier_fixtures.rs defines STANDARD_PRODUCTION_TIERS as the aligned integration test source. Single source of truth established, no more drift between architecture and deployment guide. Closing.

Brouie (Migrated from gitlab.com) closed this issue

2026-04-20 05:56:43 +00:00

Brouie commented

2026-04-20 07:26:41 +00:00

(Migrated from gitlab.com)

mentioned in issue #100