Skip to content

docs: how an agent funds Walrus storage (WAL or sponsored) [BEDU-602]#334

Open
reemsabawi-mystenlabs wants to merge 3 commits into
MystenLabs:devfrom
reemsabawi-mystenlabs:reemsabawi/bedu-602-docs-how-an-agent-funds-walrus-storage-wal-vs-sponsored
Open

docs: how an agent funds Walrus storage (WAL or sponsored) [BEDU-602]#334
reemsabawi-mystenlabs wants to merge 3 commits into
MystenLabs:devfrom
reemsabawi-mystenlabs:reemsabawi/bedu-602-docs-how-an-agent-funds-walrus-storage-wal-vs-sponsored

Conversation

@reemsabawi-mystenlabs

@reemsabawi-mystenlabs reemsabawi-mystenlabs commented Jun 25, 2026

Copy link
Copy Markdown
Contributor

Description

Adds a developer guide on how an autonomous agent funds Walrus storage: holding WAL directly versus sponsored storage (BEDU-602, Stage A / storage resource & payment).
New page (docs/fundamentals/architecture/funding-storage.md)

  • Explains that a Walrus write consumes 2 tokens, WAL for storage and SUI for gas, so "sponsored" is ambiguous until you say which half is covered.
  • Covers Model A (agent holds WAL directly): CLI and TS SDK, acquiring WAL, ownership of the Blob object, and lifecycle/expiry responsibilities.
  • Covers Model B (sponsored): publisher (pays WAL and SUI; send-object-to for ownership; no public Mainnet publisher), Sui sponsored transactions (gas only), pre-funding via transferable WAL or storage resources, the upload-relay-is-not-a-sponsor clarification, and protocol subsidies (network-level, not per-agent).
  • Maps the models to Walrus Memory: public relayer as sponsored, self-hosting as self-funded.
  • Adds a decision table and an operational checklist; added to the Fundamentals > Architecture sidebar group.
    Grounded in existing docs (Walrus system-overview/storage-costs, network-reference, operator-guide/upload-relay, TypeScript SDK) and MemWal how-storage-works. Written to the Sui documentation style guide.

Test plan

  • Local docs preview (mint dev in docs/) renders the page with working <Note>/<Warning> components and the decision table.
  • The page appears under Fundamentals > Architecture in the sidebar.
  • Internal links to how-storage-works, public-relayer, and self-hosting resolve.

Release notes

Docs-only change; no user-facing storage node, aggregator, publisher, or CLI impact.

  • Storage node:
  • Aggregator:
  • Publisher:
  • CLI:

@jessiemongeon1

jessiemongeon1 commented Jun 25, 2026

Copy link
Copy Markdown
Contributor

Style Guide Audit

Audited 2 file(s) against the Sui Documentation Style Guide.

1 violation(s) found. All must be fixed before merge.

docs/fundamentals/architecture/funding-storage.md (1 violation(s))

1 violation(s) (1 regex, 0 claude)

  • Line 1 — Frontmatter needs keywords
    • Current: (missing or placeholder)
    • Fix: Add relevant keywords

Automated audit using the Sui Documentation Style Guide.

@reemsabawi-mystenlabs reemsabawi-mystenlabs marked this pull request as draft June 25, 2026 22:21
@reemsabawi-mystenlabs reemsabawi-mystenlabs marked this pull request as ready for review June 25, 2026 22:21
@ducnmm ducnmm force-pushed the reemsabawi/bedu-602-docs-how-an-agent-funds-walrus-storage-wal-vs-sponsored branch from 834bb2f to 25244e8 Compare June 26, 2026 07:50
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.

2 participants