From 7386ed2afc8c6b7b7ebdb696995ddc81e36814b5 Mon Sep 17 00:00:00 2001 From: Claude Date: Wed, 29 Jul 2026 08:57:40 +0000 Subject: [PATCH] Sweep 2026-07-29: refresh ant-client and ant-node verification SHAs Metadata-only stamp refresh for the daily upstream sweep. ant-client (81848a09 -> 6f0c9572) and ant-node (c3ffe5a7 -> f4c8cd56) advanced in a coordinated merkle-batch-payment rework. Only source_commit and verified_date lines in the affected verification blocks and the verified_commits maps in skills/start/version.json and skills/start/SKILL.md frontmatter are updated; no rendered prose changes. The merkle 3x settlement parity, padded-leaf cost billing, and the external-signer MerkleBatchTooLarge limit are developer-facing and mid-rollout (ADR-0008 Proposed, node enforcement future-dated), so payment-model.md, use-external-signers-for-upload-payments.md, and library-reference.md are deferred to manual-review issues and left byte-identical to base. Co-Authored-By: Claude Opus 4.8 Claude-Session: https://claude.ai/code/session_013GjkG3iAW4LfCC3vQtBKZL --- docs/architecture/system-overview.md | 8 +- docs/cli/command-reference.md | 4 +- docs/cli/use-the-cli.md | 4 +- docs/core-concepts/data-types.md | 4 +- .../keys-addresses-and-datamaps.md | 4 +- docs/core-concepts/overview.md | 4 +- docs/guides/build-read-only-features.md | 4 +- docs/guides/deploy-to-mainnet.md | 4 +- docs/guides/overview.md | 8 +- docs/guides/prepare-a-wallet-for-uploads.md | 4 +- docs/guides/set-up-a-local-network.md | 4 +- docs/guides/test-your-application.md | 8 +- docs/index.md | 4 +- docs/reference/glossary.md | 8 +- docs/reference/source-repositories.md | 8 +- docs/rust/README.md | 4 +- docs/rust/build-directly-in-rust.md | 4 +- docs/rust/embed-a-node-in-your-application.md | 4 +- docs/sdk/start-the-local-daemon.md | 4 +- planning/sweeps/2026-07-29.md | 106 ++++++++++++++++++ skills/start/SKILL.md | 6 +- skills/start/version.json | 4 +- 22 files changed, 159 insertions(+), 53 deletions(-) create mode 100644 planning/sweeps/2026-07-29.md diff --git a/docs/architecture/system-overview.md b/docs/architecture/system-overview.md index c259065..0d65be6 100644 --- a/docs/architecture/system-overview.md +++ b/docs/architecture/system-overview.md @@ -10,15 +10,15 @@ diff --git a/docs/cli/use-the-cli.md b/docs/cli/use-the-cli.md index 098b4e3..c8390b9 100644 --- a/docs/cli/use-the-cli.md +++ b/docs/cli/use-the-cli.md @@ -3,8 +3,8 @@ diff --git a/docs/core-concepts/data-types.md b/docs/core-concepts/data-types.md index 41599dc..d7762de 100644 --- a/docs/core-concepts/data-types.md +++ b/docs/core-concepts/data-types.md @@ -10,8 +10,8 @@ diff --git a/docs/guides/deploy-to-mainnet.md b/docs/guides/deploy-to-mainnet.md index 8f3d94a..f296924 100644 --- a/docs/guides/deploy-to-mainnet.md +++ b/docs/guides/deploy-to-mainnet.md @@ -10,8 +10,8 @@ diff --git a/docs/guides/overview.md b/docs/guides/overview.md index 9627a8d..112ef8f 100644 --- a/docs/guides/overview.md +++ b/docs/guides/overview.md @@ -10,15 +10,15 @@ diff --git a/docs/guides/prepare-a-wallet-for-uploads.md b/docs/guides/prepare-a-wallet-for-uploads.md index a714bfb..bff2846 100644 --- a/docs/guides/prepare-a-wallet-for-uploads.md +++ b/docs/guides/prepare-a-wallet-for-uploads.md @@ -10,8 +10,8 @@ diff --git a/docs/guides/set-up-a-local-network.md b/docs/guides/set-up-a-local-network.md index dbf4cc5..03352b0 100644 --- a/docs/guides/set-up-a-local-network.md +++ b/docs/guides/set-up-a-local-network.md @@ -10,8 +10,8 @@ diff --git a/docs/guides/test-your-application.md b/docs/guides/test-your-application.md index 9cd728c..90ddb74 100644 --- a/docs/guides/test-your-application.md +++ b/docs/guides/test-your-application.md @@ -10,15 +10,15 @@ diff --git a/docs/index.md b/docs/index.md index ec9efbd..30fcd2e 100644 --- a/docs/index.md +++ b/docs/index.md @@ -10,8 +10,8 @@ diff --git a/docs/rust/embed-a-node-in-your-application.md b/docs/rust/embed-a-node-in-your-application.md index 8d7199c..d77a4e3 100644 --- a/docs/rust/embed-a-node-in-your-application.md +++ b/docs/rust/embed-a-node-in-your-application.md @@ -3,8 +3,8 @@ diff --git a/docs/sdk/start-the-local-daemon.md b/docs/sdk/start-the-local-daemon.md index 3db786f..30d3a05 100644 --- a/docs/sdk/start-the-local-daemon.md +++ b/docs/sdk/start-the-local-daemon.md @@ -10,8 +10,8 @@ diff --git a/planning/sweeps/2026-07-29.md b/planning/sweeps/2026-07-29.md new file mode 100644 index 0000000..331b8b2 --- /dev/null +++ b/planning/sweeps/2026-07-29.md @@ -0,0 +1,106 @@ +# Sweep — 2026-07-29 + +## Branch + +`claude/sweep-2026-07-29` + +## Repos bumped + +| Repo | Recorded SHA | Head SHA | +|------|-------------|----------| +| ant-client | 81848a09 | 6f0c9572 | +| ant-node | c3ffe5a7 | f4c8cd56 | + +## Classification + +Both repos advanced by one merge in the same coordinated merkle-batch-payment +rework (`chrisoneil/bump-saorsa-core-0.26.3`, ant-client PR #162 and ant-node +PR #189). The internal refactors are stamped here; the developer-facing pricing +and external-signer surfaces are deferred to manual-review issues. + +- **ant-client** (`81848a09 → 6f0c9572`): reworks `ant-core/src/data/client/merkle.rs`, + `file.rs`, `mod.rs`, and `error.rs`. Merkle batches now settle at the 3x + median multiplier the single-node path already used, cost estimation bills the + padded (power-of-two) leaf count that the payment path really pays, batch + partitioning rebalances singleton remainders so every sub-batch is a buildable + tree, and external-signer merkle preparation refuses batches larger than one + tree (`MerkleBatchTooLarge`, 256-leaf limit). +- **ant-node** (`c3ffe5a7 → f4c8cd56`): reworks `src/payment/verifier.rs`, + `src/replication/config.rs`, and `src/storage/lmdb.rs`, and adds ADR-0007 + (Windows LMDB map-headroom cap) and ADR-0008 (storage economics and payment + protocol, Status: Proposed). Nodes gain enforcement of the 3x merkle + settlement parity from a fixed instant (`MERKLE_PARITY_ENFORCED_FROM_UNIX`, + 2026-08-04 15:00 UTC) and an LMDB map-headroom cap on Windows. + +The pricing decision (raise merkle settlement to 3x) is recorded in ADR-0008 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. +Because that is a mid-rollout, sign-off-pending pricing change rather than a +settled current-merged surface, the pages that document the merkle payment cost +model and the external-signer merkle flow are held back for human review rather +than stamped or rewritten in this run. Every other affected page describes only +surfaces that are unchanged at the pinned head (payment-mode names, the 64-chunk +merkle threshold, CLI `--merkle`/`--no-merkle` flags, the generic Merkle batch +payment glossary entry, `NodeConfig` fields, and high-level architecture and +storage descriptions), so those pages are metadata-only. + +## Pages stamped (metadata-only) + +Every stamped `` block on these pages had only its +`source_commit` and `verified_date` lines refreshed. Non-drifted blocks on the +same pages (for example the `ant-sdk`, `evmlib`, `ant-protocol`, and +`self_encryption` blocks) were left byte-identical. No rendered prose changed. + +ant-client: + +- docs/architecture/system-overview.md +- docs/cli/command-reference.md +- docs/cli/use-the-cli.md +- docs/core-concepts/data-types.md +- docs/core-concepts/keys-addresses-and-datamaps.md +- docs/core-concepts/overview.md +- docs/guides/build-read-only-features.md +- docs/guides/deploy-to-mainnet.md +- docs/guides/overview.md +- docs/guides/prepare-a-wallet-for-uploads.md +- docs/guides/test-your-application.md +- docs/index.md +- docs/reference/glossary.md +- docs/reference/source-repositories.md +- docs/rust/README.md +- docs/rust/build-directly-in-rust.md + +ant-node: + +- docs/architecture/system-overview.md +- docs/guides/overview.md +- docs/guides/set-up-a-local-network.md +- docs/guides/test-your-application.md +- docs/reference/glossary.md +- docs/reference/source-repositories.md +- docs/rust/embed-a-node-in-your-application.md +- docs/sdk/start-the-local-daemon.md + +## Pages deferred to manual review (not stamped) + +The drifted verification blocks on these pages are left byte-identical to base; +one `upstream-sweep-manual-review` issue tracks each. + +- docs/core-concepts/payment-model.md — ant-client and ant-node records: merkle + 3x settlement parity, padded-leaf cost billing, and future node enforcement. +- docs/sdk/how-to-guides/use-external-signers-for-upload-payments.md — + ant-client record: the `MerkleBatchTooLarge` 256-address limit on external + merkle batch preparation. +- docs/rust/library-reference.md — ant-client record: the documented merkle + external-payment helpers (`prepare_merkle_batch_external`, + `finalize_merkle_batch`) and `PaymentMode` now sit behind the reworked + padded-leaf billing and the new batch-size limit. + +## Skill + +`skills/start/version.json` and `skills/start/SKILL.md` frontmatter had their +`ant-client` and `ant-node` `verified_commits` values refreshed, and the +`SKILL.md` frontmatter `verified_date` was updated. The `SKILL.md` body already +treats merkle-versus-wave-batch response shapes as volatile and directs the +reader to the live reference, so no body claim drifted; `version`, +`published_date`, and `CHANGELOG.md` are unchanged (metadata-only sweep). diff --git a/skills/start/SKILL.md b/skills/start/SKILL.md index 2594c97..7447c38 100644 --- a/skills/start/SKILL.md +++ b/skills/start/SKILL.md @@ -29,12 +29,12 @@ keywords: - read-only # Verification block. Re-verify before changing stable claims or examples. -verified_date: "2026-07-28" +verified_date: "2026-07-29" verification_mode: current-merged-truth verified_commits: ant-sdk: 09da0f4c94fb15d928b5e9f1d4a9ae484176c995 - ant-client: 81848a0900fa9972e9af2d323bf3b49bf8d382aa - ant-node: c3ffe5a7592bf3d5fa2fdfb2f87d9ddc7ecaaecf + ant-client: 6f0c957289371cc0b0e766f2c580adc8ecb69074 + ant-node: f4c8cd56a85790031666254c333aa053fe56e6cd ant-protocol: 0cc5faed154d380c925aea2d093d4084f91cd0b3 self_encryption: 0deb040084f94bea2ebb53bda20fa23464bbcfe0 evmlib: 933138710747c887e1962d9ebe26bed4a93e6ead diff --git a/skills/start/version.json b/skills/start/version.json index 1a2bc52..06f43da 100644 --- a/skills/start/version.json +++ b/skills/start/version.json @@ -9,8 +9,8 @@ "verification_mode": "current-merged-truth", "verified_commits": { "ant-sdk": "09da0f4c94fb15d928b5e9f1d4a9ae484176c995", - "ant-client": "81848a0900fa9972e9af2d323bf3b49bf8d382aa", - "ant-node": "c3ffe5a7592bf3d5fa2fdfb2f87d9ddc7ecaaecf", + "ant-client": "6f0c957289371cc0b0e766f2c580adc8ecb69074", + "ant-node": "f4c8cd56a85790031666254c333aa053fe56e6cd", "ant-protocol": "0cc5faed154d380c925aea2d093d4084f91cd0b3", "self_encryption": "0deb040084f94bea2ebb53bda20fa23464bbcfe0", "evmlib": "933138710747c887e1962d9ebe26bed4a93e6ead"