Skip to content

docs: add a testnet funding (friendbot) guide (closes #136) - #413

Merged
Spagero763 merged 1 commit into
tributary-protocol:mainfrom
dchaudhari7177:docs/testnet-funding-guide
Aug 13, 2026
Merged

docs: add a testnet funding (friendbot) guide (closes #136)#413
Spagero763 merged 1 commit into
tributary-protocol:mainfrom
dchaudhari7177:docs/testnet-funding-guide

Conversation

@dchaudhari7177

Copy link
Copy Markdown
Contributor

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.md

That guide already walks through browser funding, so this one links to it rather than restating it, and covers what it doesn't:

  • What Friendbot actually does — creates the account and grants 10,000 XLM. An address with no account doesn't exist, which is why "account not found" is the usual first error.
  • Testnet resets wipe accounts and deployed contracts, so a previously funded account can legitimately vanish.
  • Stellar CLI identitiesstellar keys generate alice --network testnet --fund and stellar keys fund alice --network testnet, matching the commands docs/deploy.md already uses. Anything deploying or invoking from a terminal needs a funded CLI identity, which is separate from the browser wallet.
  • Plain HTTP (curl https://friendbot.stellar.org/?addr=…) for scripts and CI, and that op_already_exists is a success, not a failure.
  • Verifying a funded account, and a troubleshooting table.

The Tributary-specific section

The part I think earns the page: a split's recipients are ordinary accounts.

  • Paying a split fails if a recipient was never funded — even when the payer is funded.
  • For non-XLM tokens each recipient needs a trustline, which Friendbot does not create. This maps directly onto the trustlineWarningTitle / trustlineWarningItem messages the dashboard already shows.
  • Nested split ids are not accounts and need no funding — only leaf 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-friendbot anchor. No Rust or app code touched, so the cargo / npm run build gates are unaffected.

🤖 Generated with Claude Code

…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>
@Spagero763
Spagero763 merged commit 17aad8a into tributary-protocol:main Aug 13, 2026
5 checks passed
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 a testnet funding (friendbot) guide

3 participants