docs: add a testnet funding (friendbot) guide (closes #136) - #413
Merged
Spagero763 merged 1 commit intoAug 13, 2026
Merged
Conversation
…col#136) docs/testnet-funding.md covers creating and funding a testnet account three ways - browser, `stellar keys generate/fund`, and the plain HTTP endpoint - plus what friendbot actually does (creates the account AND grants 10,000 XLM) and why a previously funded account can vanish (testnet resets). Deliberately does not restate freighter-setup.md, which already walks through browser funding; that section is linked instead, and this guide picks up the cases it does not cover - CLI identities for deploy/demo work, scripted funding, and verification. The section worth having is Tributary-specific: a split's RECIPIENTS are ordinary accounts, so paying a split fails when a recipient was never funded, non-XLM tokens additionally need a per-recipient trustline that friendbot does not create, and nested split ids are not accounts and need no funding at all. That maps directly onto the trustline warnings the dashboard already shows. Linked from the README twice: the two-minute quickstart step and the docs list. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
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
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.
Closes #136.
Adds
docs/testnet-funding.md, linked from the README in two places (the two-minute quickstart step, and the docs list).Does not duplicate
freighter-setup.mdThat guide already walks through browser funding, so this one links to it rather than restating it, and covers what it doesn't:
stellar keys generate alice --network testnet --fundandstellar keys fund alice --network testnet, matching the commandsdocs/deploy.mdalready uses. Anything deploying or invoking from a terminal needs a funded CLI identity, which is separate from the browser wallet.curl https://friendbot.stellar.org/?addr=…) for scripts and CI, and thatop_already_existsis a success, not a failure.The Tributary-specific section
The part I think earns the page: a split's recipients are ordinary accounts.
trustlineWarningTitle/trustlineWarningItemmessages the dashboard already shows.G…addresses do.Plus a loop to mint several funded test recipients at once.
Verification
Docs-only. Every relative link in the new file resolves (checked programmatically), including the
freighter-setup.md#3-fund-your-account-friendbotanchor. No Rust or app code touched, so thecargo/npm run buildgates are unaffected.🤖 Generated with Claude Code