Skip to content

manual review needed for docs/core-concepts/payment-model.md #81

Description

@JimCollinson

The 2026-07-29 upstream sweep found drift on two records on this page that need a human decision before the page is stamped or rewritten. Both verification blocks are left byte-identical to base on the sweep branch.

Records

  • docs/core-concepts/payment-model.md:10ant-client, 81848a09..6f0c9572
  • docs/core-concepts/payment-model.md:17ant-node, c3ffe5a7..f4c8cd56

Verification blocks (unchanged on the sweep branch)

<!-- verification:
  source_repo: ant-client
  source_ref: main
  source_commit: 81848a0900fa9972e9af2d323bf3b49bf8d382aa
  verified_date: 2026-07-28
  verification_mode: current-merged-truth
-->
<!-- verification:
  source_repo: ant-node
  source_ref: main
  source_commit: c3ffe5a7592bf3d5fa2fdfb2f87d9ddc7ecaaecf
  verified_date: 2026-07-28
  verification_mode: current-merged-truth
-->

Upstream change

ant-client (ant-core/src/data/client/merkle.rs, file.rs, error.rs) and ant-node (src/payment/verifier.rs, src/replication/config.rs) implement a coordinated merkle-batch-payment change:

  • Merkle batches now settle at the same 3x median multiplier the single-node path already applies. Previously a chunk stored in a merkle batch earned one-third of what the single-node path pays for the identical chunk.
  • Cost estimation now bills the padded (power-of-two) leaf count that the payment path actually pays: for example a 65-chunk merkle batch pays for 128 leaves.
  • ant-node gains enforcement of the 3x parity from a fixed instant (MERKLE_PARITY_ENFORCED_FROM_UNIX = 1785855600, 2026-08-04 15:00 UTC). The rollout is client-first: released clients pay 3x immediately, nodes begin requiring it at that instant.

Why this is ambiguous rather than a straightforward prose update

This is a live, mid-rollout pricing change, not a settled surface. The decision is recorded in ant-node docs/adr/ADR-0008-storage-economics-and-payment-protocol.md at Status: Proposed, which states it "still needs the economic owner's sign-off before the client is published," and the node-side enforcement is future-dated. The page today makes no claim about merkle cost granularity or the merkle settlement multiplier, so no existing sentence is wrong. Whether to document a 3x merkle cost as current behavior, and how to frame the pending node enforcement, is a human call: writing it now risks documenting pricing that could change before release.

A reviewer should decide whether to add a merkle-cost note to the "Cost estimation" / "Payment modes" sections now (current-merged-truth) or wait for the client release and economic sign-off. The two records overlap on the same merkle-payment claim, so they are tracked together.

Fingerprint: docs/core-concepts/payment-model.md:10|ant-client|81848a0900fa9972e9af2d323bf3b49bf8d382aa..6f0c957289371cc0b0e766f2c580adc8ecb69074

Fingerprint: docs/core-concepts/payment-model.md:17|ant-node|c3ffe5a7592bf3d5fa2fdfb2f87d9ddc7ecaaecf..f4c8cd56a85790031666254c333aa053fe56e6cd

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions