[Nic-dorman]

Hermes' review of #335/#342 caught that Python and MCP promised a failed paid pointer write "was refused before anything was paid". The same false guarantee was in the other 13 SDKs and the shared docs. This PR fixes those, plus the wording fixes Hermes kept open on #339, #365 and #334. Docs, comments and README text only: no code or behaviour changes, and no antd/ changes.

Stacked on #367 (base nic/stack-integration-preview), because these files come from the fan-out PRs. Fixing them in place would have reset 35 approvals. This PR gets retargeted to main once #367 lands.

The facts the wording follows

• Create/update with the daemon wallet run in this order: refuse a pending prepared write (CONFLICT) and read the pointer (ALREADY_EXISTS / POINTER_FINAL), both before paying. Then pointer_put, which pays first and stores second.
  • So CONFLICT can mean the awaiting-payment refusal (unpaid) or an update that lost to a newer state while in flight (possibly paid). The code alone doesn't say which.
  • POINTER_FINAL is usually a pre-payment refusal, but a write that was in flight when the pointer became final keeps its payment.
• Transfer checks every peer first, so a shortfall can come before or after paying.
• The one safe retry is a finalize with retryable true, repeated with the same upload_id against the retained payment.

Changes (13 SDKs + docs; Python and MCP were already right after #335/#342)

• Per SDK (C++, C#, Dart, Elixir, Go, Java, JS, Kotlin, Lua, PHP, Ruby, Rust, Swift, Zig):
  • POINTER_FINAL and CONFLICT class docs;
  • the update and transfer method docs (C#, Kotlin, Java and PHP described a transfer shortfall as pre-payment; Elixir called CONFLICT pre-payment);
  • README error rows and example prints.
• Docs: docs/tutorial-pointers.md, llms.txt, llms-full.txt, skill.md, README.md, docs/quickstart-rust.md.
• Wording Hermes kept open on the reviews:
  • docs: pointers across README, skill.md, llms, quickstarts and a tutorial #339: skill.md shortfall row now names the retryable-finalize exception; Java is listed as ForkException; llms-full.txt documents include_signed_quotes / optional signed_quotes on pointer prepare.
  • docs: manifests across README, skill.md, llms, quickstarts and a tutorial #365: removed "except Go and Rust, which use the default URL" (both read ANTD_BASE_URL), and also from the identical pointers line and the Rust quickstart. The manifest gRPC 256 MiB line now names Dart and Elixir as exceptions.
  • feat(antd-php): pointer API (REST) #334: the PHP pointerTransfer docblock no longer implies a CLOSE_GROUP_SHORTFALL is pre-payment.

Deliberately unchanged (true as written)

• A create of an existing pointer is refused before paying.
• A pointer that is already final is refused before paying (the live tests' wording).
• The awaiting-payment CONFLICT is refused before paying.
• Manifest calls are free.
• Reads are free to retry.
• The daemon's InsufficientPeers → SERVICE_UNAVAILABLE comment ("Nothing was paid") stays. In ant-core 0.13.0, the only pointer source of it is pointer_write_group, which runs before quoting or paying. In finalize, worth_retrying catches it first.

Checks

• antd-py pytest: 584 passed.
• antd-go: go vet, go build and go test pass.
• antd-csharp: dotnet build succeeds with 0 warnings.
• php -l, ruby -c and zig fmt --check are clean on the edited files.
• git diff --check is clean.
• Every symbol the new docs link to exists.

Refs V2-1568.

🤖 Generated with Claude Code