docs(prose): antd v0.7.1 — anvil prereq, daemon flags, chunk external-signer flow

docs/cli/command-reference.md

@@ -3,8 +3,8 @@
 <!-- verification:
   source_repo: ant-client
   source_ref: main
-  source_commit: 91d5f18e3fbf5125fc6b5bbc46bb0a1fe6356ae8
-  verified_date: 2026-05-13
+  source_commit: 3df6764298b10dcc51287f43b1b5742a25785bff
+  verified_date: 2026-05-16
   verification_mode: current-merged-truth
 -->
 
@@ -212,16 +212,22 @@ SECRET_KEY=0x<hex_private_key> ant wallet balance
 
 ### `ant node daemon start`
 
-Launches the node daemon as a detached background process.
+Launches the node daemon as a detached background process. By default it binds to a random free port on `127.0.0.1` and writes the chosen port to `daemon.port` for SDK discovery.
 
 **Parameters:**
 
-This command has no command-specific parameters.
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `--port <PORT>` | integer | No | Pin the HTTP port. `0` is equivalent to the default (OS-assigned). |
+| `--listen-addr <IP>` | IP address | No | Bind address. Defaults to `127.0.0.1`. Binding to a non-loopback address (e.g. `0.0.0.0`) exposes node management without authentication — only do this when the network path is controlled. |
 
 **Example:**
 
 ```bash
 ant node daemon start
+
+# Pin port and bind on all interfaces (e.g. inside a container):
+ant node daemon start --listen-addr 0.0.0.0 --port 8765
 ```
 
 ### `ant node daemon stop`

docs/guides/set-up-a-local-network.md

@@ -3,15 +3,15 @@
 <!-- verification:
   source_repo: ant-sdk
   source_ref: main
-  source_commit: 529280c32c024c92b68436abb6ace956c8da66ba
-  verified_date: 2026-05-11
+  source_commit: e0dfa2c384ea17f49490d3d5110c3d226ac5233b
+  verified_date: 2026-05-16
   verification_mode: current-merged-truth
 -->
 <!-- verification:
   source_repo: ant-node
   source_ref: main
-  source_commit: 8b68b2d7f4662faf67ed7812dc6cb37de0c74a8b
-  verified_date: 2026-05-13
+  source_commit: f38fdcacbeb3318e4524f4534e2d5bd87dcca467
+  verified_date: 2026-05-16
   verification_mode: current-merged-truth
 -->
 
@@ -24,6 +24,12 @@ This is the best place to test uploads before you move to Arbitrum Sepolia or Ar
 - Rust toolchain
 - Python 3.10+
 - `protoc` (Protocol Buffers compiler) available on your machine
+- Foundry (provides `anvil`) — required by `ant-devnet` for the local EVM testnet. Install with:
+  ```bash
+  curl -sL https://foundry.paradigm.xyz | bash
+  ~/.foundry/bin/foundryup
+  ```
+  The installer adds `~/.foundry/bin` to your shell profile (`~/.bashrc`, `~/.zshrc`, or equivalent). Open a new terminal, or run `source ~/.bashrc` (or `source ~/.zshrc`), before running `ant dev start` so `anvil` is on `PATH`.
 - A local checkout of `ant-sdk`
 - A local checkout of `ant-node`
 

docs/guides/test-your-application.md

@@ -3,22 +3,22 @@
 <!-- verification:
   source_repo: ant-sdk
   source_ref: main
-  source_commit: 529280c32c024c92b68436abb6ace956c8da66ba
-  verified_date: 2026-05-11
+  source_commit: e0dfa2c384ea17f49490d3d5110c3d226ac5233b
+  verified_date: 2026-05-16
   verification_mode: current-merged-truth
 -->
 <!-- verification:
   source_repo: ant-client
   source_ref: main
-  source_commit: 91d5f18e3fbf5125fc6b5bbc46bb0a1fe6356ae8
-  verified_date: 2026-05-13
+  source_commit: 3df6764298b10dcc51287f43b1b5742a25785bff
+  verified_date: 2026-05-16
   verification_mode: current-merged-truth
 -->
 <!-- verification:
   source_repo: ant-node
   source_ref: main
-  source_commit: 8b68b2d7f4662faf67ed7812dc6cb37de0c74a8b
-  verified_date: 2026-05-13
+  source_commit: f38fdcacbeb3318e4524f4534e2d5bd87dcca467
+  verified_date: 2026-05-16
   verification_mode: current-merged-truth
 -->
 
@@ -160,6 +160,14 @@ jobs:
           repository: WithAutonomi/ant-node
           path: ant-node
 
+      - name: Install Foundry
+        run: |
+          curl -sL https://foundry.paradigm.xyz | bash
+          ~/.foundry/bin/foundryup
+          echo "$HOME/.foundry/bin" >> $GITHUB_PATH
+        # ant-devnet requires anvil for the local EVM testnet; appending
+        # to $GITHUB_PATH puts it on PATH for every subsequent step.
+
       - name: Install ant-dev
         run: pip install -e ant-sdk/ant-dev/
 

docs/sdk/how-to-guides/use-external-signers-for-upload-payments.md

@@ -3,15 +3,15 @@
 <!-- verification:
   source_repo: ant-sdk
   source_ref: main
-  source_commit: 529280c32c024c92b68436abb6ace956c8da66ba
-  verified_date: 2026-05-11
+  source_commit: e0dfa2c384ea17f49490d3d5110c3d226ac5233b
+  verified_date: 2026-05-16
   verification_mode: current-merged-truth
 -->
 <!-- verification:
   source_repo: ant-client
   source_ref: main
-  source_commit: 91d5f18e3fbf5125fc6b5bbc46bb0a1fe6356ae8
-  verified_date: 2026-05-13
+  source_commit: 3df6764298b10dcc51287f43b1b5742a25785bff
+  verified_date: 2026-05-16
   verification_mode: current-merged-truth
 -->
 <!-- verification:
@@ -57,6 +57,46 @@ Use `EVM_PAYMENT_VAULT_ADDRESS` for both wave-batch and Merkle uploads in the ex
 
 ### 2. Prepare the upload
 
+For a single chunk (up to 4 MiB of raw bytes), call `POST /v1/chunks/prepare`. This is the simplest external-signer flow — one chunk, one payment:
+
+```bash
+CHUNK_B64=$(printf 'Hello, Autonomi!' | base64)
+
+curl -X POST http://localhost:8082/v1/chunks/prepare \
+  -H "Content-Type: application/json" \
+  -d "{\"data\":\"$CHUNK_B64\"}"
+```
+
+When the chunk is already stored on the network, the response returns `already_stored: true` with the existing address and no `upload_id`. There is nothing more to do: no payment to make and no finalize call to issue. Otherwise the response returns the wave-batch payment shape:
+
+```json
+{
+  "address": "<64_hex_chunk_address>",
+  "already_stored": false,
+  "upload_id": "<hex_id>",
+  "payment_type": "wave_batch",
+  "payments": [
+    { "quote_hash": "0x...", "rewards_address": "0x...", "amount": "<atto_tokens>" }
+  ],
+  "total_amount": "<atto_tokens>",
+  "payment_vault_address": "0x...",
+  "payment_token_address": "0x...",
+  "rpc_url": "https://your-rpc-endpoint"
+}
+```
+
+After the external signer calls `payForQuotes()` with the returned `payments`, finalize with `POST /v1/chunks/finalize`:
+
+```bash
+curl -X POST http://localhost:8082/v1/chunks/finalize \
+  -H "Content-Type: application/json" \
+  -d '{"upload_id":"<hex_id>","tx_hashes":{"0xquote_hash":"0xtx_hash"}}'
+```
+
+The finalize response returns the network address of the stored chunk. Requires antd 0.7.0 or later.
+
+For multi-chunk uploads (arbitrary files or in-memory data larger than one chunk), use the data or file prepare/finalize endpoints described below.
+
 For in-memory data, call `POST /v1/data/prepare`.
 
 ```bash

docs/sdk/reference/language-bindings/go.md

@@ -3,8 +3,8 @@
 <!-- verification:
   source_repo: ant-sdk
   source_ref: main
-  source_commit: 529280c32c024c92b68436abb6ace956c8da66ba
-  verified_date: 2026-05-11
+  source_commit: e0dfa2c384ea17f49490d3d5110c3d226ac5233b
+  verified_date: 2026-05-16
   verification_mode: current-merged-truth
 -->
 
@@ -89,8 +89,11 @@ func main() {
 | `WalletBalance` | `antd.WalletBalance` |
 | `PrepareUploadResult` | `antd.PrepareUploadResult` |
 | `FinalizeUploadResult` | `antd.FinalizeUploadResult` |
+| `PrepareChunkResult` | `antd.PrepareChunkResult` |
 | Raw data | `[]byte` |
 
+`PrepareChunkResult` is returned by `PrepareChunkUpload`. When `AlreadyStored` is `true`, only `Address` and `AlreadyStored` are populated and there is no payment to make or finalize call to issue. Otherwise, `UploadID`, `Payments`, and `TotalAmount` describe the external-signer payment required before calling `FinalizeChunkUpload`. Requires antd 0.7.0 or later.
+
 ## Error handling
 
 ```go

docs/sdk/start-the-local-daemon.md

@@ -3,15 +3,15 @@
 <!-- verification:
   source_repo: ant-sdk
   source_ref: main
-  source_commit: 529280c32c024c92b68436abb6ace956c8da66ba
-  verified_date: 2026-05-11
+  source_commit: e0dfa2c384ea17f49490d3d5110c3d226ac5233b
+  verified_date: 2026-05-16
   verification_mode: current-merged-truth
 -->
 <!-- verification:
   source_repo: ant-node
   source_ref: main
-  source_commit: 8b68b2d7f4662faf67ed7812dc6cb37de0c74a8b
-  verified_date: 2026-05-13
+  source_commit: f38fdcacbeb3318e4524f4534e2d5bd87dcca467
+  verified_date: 2026-05-16
   verification_mode: current-merged-truth
 -->
 
@@ -27,7 +27,7 @@ Use `antd` when you want:
 
 - Rust toolchain and `protoc` (Protocol Buffers compiler) to build `antd` from source
 - For paid uploads on the default network: access to wallet and payment configuration. See [Prepare a Wallet for Uploads](../guides/prepare-a-wallet-for-uploads.md) and [Use External Signers for Upload Payments](how-to-guides/use-external-signers-for-upload-payments.md).
-- For a fully local devnet: Python 3.10+ and a sibling `ant-node` checkout if you plan to use `ant dev start`. See [Set Up a Local Network](../guides/set-up-a-local-network.md).
+- For a fully local devnet: Python 3.10+, Foundry (provides `anvil`), and a sibling `ant-node` checkout if you plan to use `ant dev start`. See [Set Up a Local Network](../guides/set-up-a-local-network.md) for Foundry install steps and the rest of the local-devnet setup.
 
 ## Steps
 

skills/start/CHANGELOG.md

@@ -4,6 +4,20 @@ All notable changes to this skill are recorded here.
 
 ## [Unreleased]
 
+## [0.1.5-draft] - 2026-05-16
+
+### Changed
+- Updated health check expected `version` field to `"0.7.1"` (antd release e0dfa2c).
+- Added `POST /v1/chunks/prepare` and `POST /v1/chunks/finalize` to the current shared daemon surfaces list (single-chunk external-signer flow, antd 0.7.0+).
+
+### Verified Against
+- ant-sdk: e0dfa2c384ea17f49490d3d5110c3d226ac5233b
+- ant-client: 3df6764298b10dcc51287f43b1b5742a25785bff
+- ant-node: f38fdcacbeb3318e4524f4534e2d5bd87dcca467
+- ant-protocol: cbaf710dc51c7e436120ced5d60f07b0aa14a8ee
+- self_encryption: 0deb040084f94bea2ebb53bda20fa23464bbcfe0
+- evmlib: 225acbb1af613193bcc8264b6ede4d7e4a7ac607
+
 ## [0.1.4-draft] - 2026-05-11
 
 ### Changed

skills/start/SKILL.md

@@ -8,7 +8,7 @@ description: |
   in Rust with `ant-core`, or expose Autonomi through an MCP-compatible client.
   Do not use for Autonomi 1.0, the MaidSafe-era network, `ant-quic`, or
   general EVM work that is not part of building on Autonomi.
-version: 0.1.4-draft
+version: 0.1.5-draft
 license: MIT
 repository: https://github.com/WithAutonomi/autonomi-developer-docs
 homepage: https://docs.autonomi.com/developers
@@ -29,14 +29,14 @@ keywords:
   - read-only
 
 # Verification block. Re-verify before changing stable claims or examples.
-verified_date: "2026-05-13"
+verified_date: "2026-05-16"
 verification_mode: current-merged-truth
 verified_commits:
-  ant-sdk: 529280c32c024c92b68436abb6ace956c8da66ba
-  ant-client: 91d5f18e3fbf5125fc6b5bbc46bb0a1fe6356ae8
-  ant-node: 8b68b2d7f4662faf67ed7812dc6cb37de0c74a8b
-  ant-protocol: 93e63b8a41a97c37c24d1164a3ee5525e002ddcd
-  self_encryption: 5f9d1646231da7ca2ce60e84d010acfb6d9c29d0
+  ant-sdk: e0dfa2c384ea17f49490d3d5110c3d226ac5233b
+  ant-client: 3df6764298b10dcc51287f43b1b5742a25785bff
+  ant-node: f38fdcacbeb3318e4524f4534e2d5bd87dcca467
+  ant-protocol: cbaf710dc51c7e436120ced5d60f07b0aa14a8ee
+  self_encryption: 0deb040084f94bea2ebb53bda20fa23464bbcfe0
   evmlib: 225acbb1af613193bcc8264b6ede4d7e4a7ac607
 
 version_manifest_url: https://raw.githubusercontent.com/WithAutonomi/autonomi-developer-docs/main/skills/start/version.json
@@ -119,7 +119,7 @@ Expected shape:
 {
   "status": "ok",
   "network": "default",
-  "version": "0.6.1",
+  "version": "0.7.1",
   "evm_network": "arbitrum-one",
   "uptime_seconds": 12345,
   "build_commit": "529280c3",
@@ -159,6 +159,8 @@ Current shared daemon surfaces you can rely on at this commit:
 - `POST /v1/data/prepare`
 - `POST /v1/upload/prepare`
 - `POST /v1/upload/finalize`
+- `POST /v1/chunks/prepare`
+- `POST /v1/chunks/finalize`
 
 Golden public-data round trip:
 

skills/start/version.json

@@ -1,18 +1,18 @@
 {
   "skill": "start",
-  "version": "0.1.4-draft",
-  "published_date": "2026-05-11",
+  "version": "0.1.5-draft",
+  "published_date": "2026-05-16",
   "status": "draft",
   "canonical_skill_url": "https://raw.githubusercontent.com/WithAutonomi/autonomi-developer-docs/main/skills/start/SKILL.md",
   "canonical_docs_url": "https://docs.autonomi.com/developers",
   "repository": "https://github.com/WithAutonomi/autonomi-developer-docs",
   "verification_mode": "current-merged-truth",
   "verified_commits": {
-    "ant-sdk": "529280c32c024c92b68436abb6ace956c8da66ba",
-    "ant-client": "91d5f18e3fbf5125fc6b5bbc46bb0a1fe6356ae8",
-    "ant-node": "8b68b2d7f4662faf67ed7812dc6cb37de0c74a8b",
-    "ant-protocol": "93e63b8a41a97c37c24d1164a3ee5525e002ddcd",
-    "self_encryption": "5f9d1646231da7ca2ce60e84d010acfb6d9c29d0",
+    "ant-sdk": "e0dfa2c384ea17f49490d3d5110c3d226ac5233b",
+    "ant-client": "3df6764298b10dcc51287f43b1b5742a25785bff",
+    "ant-node": "f38fdcacbeb3318e4524f4534e2d5bd87dcca467",
+    "ant-protocol": "cbaf710dc51c7e436120ced5d60f07b0aa14a8ee",
+    "self_encryption": "0deb040084f94bea2ebb53bda20fa23464bbcfe0",
     "evmlib": "225acbb1af613193bcc8264b6ede4d7e4a7ac607"
   },
   "covers_paths": [