Skip to content

Rename "Validator faucet cap" UI label to "Validator liveness reward cap"#5249

Open
samsondav wants to merge 1 commit intocanton-network:mainfrom
Avro-Digital:sam-avro/issue-958-faucet-liveness-ui-labels
Open

Rename "Validator faucet cap" UI label to "Validator liveness reward cap"#5249
samsondav wants to merge 1 commit intocanton-network:mainfrom
Avro-Digital:sam-avro/issue-958-faucet-liveness-ui-labels

Conversation

@samsondav
Copy link
Copy Markdown

@samsondav samsondav commented Apr 27, 2026

Summary

Aligns user-facing terminology with the Canton Coin whitepaper, which uses "liveness rewards" rather than "faucet" for the per-round validator rewards. Fixes #958.

  • apps/sv/frontend: relabel the two optValidatorFaucetCap rows in the SV governance minting curve diff view ("Validator faucet cap" → "Validator liveness reward cap"). Adds a unit test pinning both new labels.
  • splice-amulet/ValidatorLicense.daml: fix the ValidatorLicense_ReportActive docstring to reference the current ValidatorLicense_RecordValidatorLivenessActivity choice (instead of the deprecated ReceiveFaucetCoupon) and to contrast enabled vs disabled wallets in parallel with the line above.

Scope

Per the original issue author's guidance ("No changes to Daml code; just UI for now"), this is intentionally minimal:

  • No on-chain ABI changes. The ValidatorLivenessActivityRecord template already exists alongside the deprecated ValidatorFaucetCoupon; the wallet OpenAPI already exposes both endpoint sets. Renaming FaucetState, optValidatorFaucetCap, optIssuancePerValidatorFaucetCoupon, etc. would break on-chain contract compatibility for fields still in active templates and is out of scope.
  • No public API renames. The Scan OpenAPI endpoints (/v0/validators/validator-faucets, /v0/top-validators-by-validator-faucets) are unchanged here. Adding a parallel "liveness" set (mirroring what was done for the wallet API) would be a reasonable follow-up but is a separate concern from a label rename.
  • No internal Scala/test renames. Many internal classes (e.g. ReceiveFaucetCouponTrigger, listValidatorFaucetCouponsOnDomain) still process the deprecated ValidatorFaucetCoupon template — their names accurately describe what they do. They can be revisited if/when the deprecated template is removed.

Test plan

  • Built the SV frontend test suite locally (vitest --run in apps/sv/frontend): 200/200 tests pass, including the new label-pinning assertion.
  • daml build on splice-amulet: succeeds (comment-only Daml change is a no-op).
  • Existing buildAmuletConfigChanges and buildAmuletRulesConfigFromChanges test suites pass; the test-fixture strings in buildAmuletRulesConfigFromChanges.test.ts ("Opt Validator Faucet Cap") are auto-generated synthetic labels mirroring the still-unchanged Daml field name and are intentionally left alone.

…cap"

Aligns user-facing terminology with the Canton Coin whitepaper, which
uses "liveness rewards" rather than "faucet" for these per-round
validator rewards. Per issue canton-network#958, scope is limited to user-visible
text and a stale Daml docstring; the underlying Daml templates and
ABI fields are kept as-is to preserve on-chain compatibility (the
new ValidatorLivenessActivityRecord template already exists alongside
the deprecated ValidatorFaucetCoupon).

- apps/sv/frontend: relabel the optValidatorFaucetCap config rows in
  the SV governance minting curve diff view, and add a unit-test
  assertion pinning the new initial-value and step labels.
- splice-amulet/ValidatorLicense.daml: fix the ValidatorLicense_ReportActive
  docstring to reference the current ValidatorLicense_RecordValidatorLivenessActivity
  choice (instead of the deprecated ReceiveFaucetCoupon) and to contrast
  enabled vs disabled wallets in parallel with the line above.

Fixes canton-network#958

Signed-off-by: Sam Davies <[email protected]>
@samsondav samsondav force-pushed the sam-avro/issue-958-faucet-liveness-ui-labels branch from e5131ee to 2f42ded Compare April 27, 2026 13:10
@samsondav samsondav force-pushed the sam-avro/issue-958-faucet-liveness-ui-labels branch from 2f42ded to cfd41b3 Compare May 4, 2026 15:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Validator Faucet Rewards -> Validator Liveness Rewards

5 participants