Skip to content

docs: add warning about public gateways and batch errors#797

Open
EchinopsisMonstrose wants to merge 1 commit intomasterfrom
fix/720-public-gateway-warning
Open

docs: add warning about public gateways and batch errors#797
EchinopsisMonstrose wants to merge 1 commit intomasterfrom
fix/720-public-gateway-warning

Conversation

@EchinopsisMonstrose
Copy link
Copy Markdown
Collaborator

Summary

Added a warning section to the Postage Stamp Batches documentation explaining:

  • Public gateways cannot access user's postage batches (stored only on their own node)
  • Why users get 'get batch ... storage not found' errors when trying to upload through public gateways
  • Direction to use own node's API endpoint for uploads

Motivation

Common source of user confusion: attempting to upload through public gateway endpoints and receiving batch lookup errors. This warning prevents that frustration.

Fixes

Closes #720

Test plan

  • Verify the warning appears prominently in stamp batch documentation
  • Confirm the message is clear about why public gateways can't handle uploads with batches

Added a warning section explaining that public gateways cannot access
postage batches stored on user nodes. This clarifies common 'get batch
storage not found' errors when users attempt uploads through public gateways.

Users are directed to use their own node's API endpoint for uploads.

Fixes #720

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
@netlify
Copy link
Copy Markdown

netlify Bot commented Apr 30, 2026

Deploy Preview for test-twitter-preview-testing-3 ready!

Name Link
🔨 Latest commit 2329fca
🔍 Latest deploy log https://app.netlify.com/projects/test-twitter-preview-testing-3/deploys/69f31a1488a7b400082b491a
😎 Deploy Preview https://deploy-preview-797--test-twitter-preview-testing-3.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

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.

Add warning about public gateways and "get batch....storage not found" error

1 participant