Skip to content

docs: correct the n-bound rationale — no USDC was ever at risk#24

Merged
VickyXAI merged 1 commit into
mainfrom
docs/correct-n-bound-rationale
Jul 16, 2026
Merged

docs: correct the n-bound rationale — no USDC was ever at risk#24
VickyXAI merged 1 commit into
mainfrom
docs/correct-n-bound-rationale

Conversation

@VickyXAI

Copy link
Copy Markdown
Contributor

0.7.2 shipped a claim that isn't true. Correcting the record.

What was wrong

The changelog said an out-of-range n "took payment, then 400'd at the provider and lost the prepaid USDC."

BlockRun's gateways settle on successsettlePaymentWithRetry runs after the upstream call — so a request that dies at the provider settles nothing and costs the caller nothing. I inherited the claim from a reviewer and from the t2i schema's own comment, and repeated it without checking the settle ordering.

That's the same mistake the SDK's "API error after payment" wording keeps producing: it reads as funds gone on failures that took nothing, and it has now misled two reviewers and me (fixed in BlockRunAI/blockrun-llm#25).

What stays

The n bound. It saves a pointless signed round-trip, a facilitator verify, and an upstream call, and answers 400 locally instead of surfacing the provider's error late. It just was never about losing money — and a changelog that cries wolf about funds is worse than one that says nothing.

Scope

Docs and comments only; no behavior change. 277 tests pass.

PyPI renders README.md rather than CHANGELOG.md, so the published 0.7.2 description never carried the claim — no republish needed. The corrected text ships with the next release.

Related

0.7.2 shipped saying an out-of-range `n` "took payment, then 400'd at the
provider and lost the prepaid USDC". That is wrong.

BlockRun's gateways settle on success: settlePaymentWithRetry runs after the
upstream call, so a request that dies at the provider settles nothing and costs
the caller nothing. I inherited the claim from the reviewer and from the t2i
schema's own comment, and repeated it without checking the settle ordering —
the same mistake the SDK's "API error after payment" wording keeps producing
(fixed in blockrun-llm#25).

The bound stays. It saves a pointless signed round-trip, a facilitator verify,
and an upstream call, and answers 400 locally instead of surfacing the
provider's error late. It just was never about losing money, and a changelog
that cries wolf about funds is worse than one that says nothing.

Docs + comments only; no behavior change. PyPI renders README.md rather than
CHANGELOG.md, so the published 0.7.2 description never carried the claim and
this needs no republish.
@VickyXAI
VickyXAI merged commit 5686ab3 into main Jul 16, 2026
@VickyXAI
VickyXAI deleted the docs/correct-n-bound-rationale branch July 16, 2026 05:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant