docs(prose): antd v0.7.1 — anvil prereq, daemon flags, chunk external-signer flow#45
Merged
JimCollinson merged 3 commits intoMay 18, 2026
Merged
Conversation
…-signer flow ant-sdk e0dfa2c: - Set up a Local Network, Test Your Application, Start the Local Daemon: add Foundry/anvil as a required prerequisite for `ant dev start` (ant-devnet now spawns anvil for the local EVM testnet and fails fast when it is absent). - Use External Signers: document new single-chunk external-signer flow via POST /v1/chunks/prepare and POST /v1/chunks/finalize (antd 0.7.0+). - Go SDK: add PrepareChunkResult to type mappings table and document PrepareChunkUpload / FinalizeChunkUpload methods. ant-client 3df6764: - CLI Command Reference: document --port and --listen-addr flags on `ant node daemon start` (previously undocumented). Skill 0.1.5-draft: - Update health response example version to "0.7.1". - Add POST /v1/chunks/prepare and POST /v1/chunks/finalize to the current shared daemon surfaces list.
…eview) Address PR #45 review: Medium — Foundry install instructions fail on fresh installs because `curl ... | bash` writes PATH changes to the shell profile and tells users to source it or open a new terminal before running `foundryup`. The `&& foundryup` chain runs foundryup before the PATH update takes effect, so it fails when foundryup is not yet on PATH. - docs/guides/set-up-a-local-network.md: split the install into two lines, invoke foundryup by full path (~/.foundry/bin/foundryup), and add a sentence explaining the shell-profile PATH update so the reader knows to open a new terminal or source the profile before running `ant dev start`. - docs/sdk/start-the-local-daemon.md: stop duplicating the broken inline command; link to the Set Up a Local Network page for the full install steps. - docs/guides/test-your-application.md: split the CI step into a multi-line `run` block and add `echo "$HOME/.foundry/bin" >> $GITHUB_PATH` so the `~/.foundry/bin` directory is on PATH for every subsequent GitHub Actions step. Without this, the later `ant dev start` step would fail the upstream `shutil.which("anvil")` check. Low — Go binding doc claimed only `Address` is populated when `AlreadyStored` is true; upstream `antd-go/models.go` doc comment at e0dfa2c says "the only populated fields are Address and AlreadyStored". Updated the page to match. Low — "skip payment and finalize" on the chunk-prepare flow is ambiguous (skip both, or skip payment and then call finalize?). Reworded to "There is nothing more to do: no payment to make and no finalize call to issue." https://claude.ai/code/session_019cz1M7pXuXFQykMZxfdXHm
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Upstream drift addressed
529280ce0dfa2c(chore(antd): release v0.7.1)91d5f183df6764(feat/dynamic-stream-decrypt-batch-size)Source artifacts inspected
antd/src/rest/mod.rs— new routesPOST /v1/chunks/prepare,POST /v1/chunks/finalizeantd/src/rest/chunks.rs— newchunk_prepareandchunk_finalizehandlersantd/src/types.rs— newPrepareChunkRequest,PrepareChunkResponse,FinalizeChunkRequest,FinalizeChunkResponsestructsantd-go/client.go— newPrepareChunkUploadandFinalizeChunkUploadmethodsantd-go/models.go— newPrepareChunkResultstructant-dev/src/ant_dev/cmd_start.py— anvil preflight check added;ant dev startexits ifanvilnot on PATHant-dev/src/ant_dev/cli.py—--presetflag added (defaultsmall);--languagechoices dynamicant-cli/src/commands/node/daemon.rs— newBindArgsstruct with--portand--listen-addrforant node daemon startandant node daemon runant-sdk/README.md,ant-client/README.md— Foundry prerequisite and flag docsDeveloper-facing changes
POST /v1/chunks/prepareandPOST /v1/chunks/finalize. These enable a single-chunk upload flow that bypasses the full data/file prepare path when the payload fits in one chunk (≤ 4 MiB).ant dev startnow requires Foundry/anvil to be on PATH. Runningant dev startwithout it exits immediately.ant node daemon startandant node daemon rungain--port <PORT>and--listen-addr <IP>flags for binding the daemon to a specific port or interface.PrepareChunkUpload/FinalizeChunkUploadmethods and thePrepareChunkResulttype to match the new REST endpoints.Files changed
docs/guides/set-up-a-local-network.mddocs/guides/test-your-application.mddocs/sdk/start-the-local-daemon.mddocs/cli/command-reference.md--portand--listen-addrforant node daemon startdocs/sdk/reference/language-bindings/go.mdPrepareChunkResulttype mapping and method docsdocs/sdk/how-to-guides/use-external-signers-for-upload-payments.md/v1/chunks/prepare+/v1/chunks/finalize)skills/start/SKILL.mdskills/start/version.jsonskills/start/CHANGELOG.md[0.1.5-draft]entryVerification
status: ok, no failurese0dfa2cvia grepantd-go/models.goandantd-go/client.goate0dfa2c--port/--listen-addrflags confirmed inant-cli/src/commands/node/daemon.rsat3df6764Reviewer note
antd/openapi.yamldoes not yet include the newPOST /v1/chunks/prepareandPOST /v1/chunks/finalizeendpoints despite them existing in the Rust source ate0dfa2c. The REST API reference page (docs/sdk/reference/rest-api.md) is generated from openapi.yaml and therefore does not cover these endpoints yet. Please confirm this is intentional before merging — if openapi.yaml is updated upstream,rest-api.mdwill need a follow-up sweep.Companion sweep PR: #44
Generated by Claude Code