Document how to host stellar.toml for separate testnet and mainnet environments
Nobody has claimed this yet.
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 75/100
- Issue type
- Documentation
- Clarity
- Clearly specified
- Activity status
- Active
- Domain
- documentation
Research direction
Find the SEP-1 guide in the Anchor Platform documentation and the asset-issuance docs. Look for existing mentions of stellar.toml and NETWORK_PASSPHRASE. Research how wallets and Frontier Lab handle testnet vs mainnet discovery. The task is to add a new section explaining the recommended hosting pattern (like a subdomain) or clarifying that a testnet file is not expected, and to update the relevant links.
Written by the indexing model from the issue text.
Description
New asset issuers ask how to run separate testnet and production stellar.toml files. The SEP-1 guide under Anchor Platform says the two files need different NETWORK_PASSPHRASE values, but a domain has only one /.well-known/stellar.toml, and nothing explains how to host both or whether a testnet file is expected at all.
Please add to the SEP-1 guidance, and link it from the asset-issuance docs:
- whether wallets, Lab and anchors look for a testnet
stellar.toml; - if yes, the recommended pattern (e.g. a
testnet.subdomain) and what differs per network; - if no, say so and describe how to test SEP-1 discovery before mainnet.
Surfaced by Frontier Lab's ecosystem crawl.
- Dominant language
- MDX
- Stars
- 138
- Forks
- 313
- Avg merge
- 2d 22h
- Merged PRs (30d)
- 39
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from stellar/stellar-docs
-
documentation
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
stellar/stellar-docs#2875 ·
-
Document the AGENTS.md generated by `stellar contract init` and an agent workflow using the CLI Opendev-rel documentation
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
stellar/stellar-docs#2872 ·
-
Add a fee-sponsorship decision guide linking fee-bumps, sponsored reserves and the Relayer page Opendocumentation
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
stellar/stellar-docs#2871 ·
-
Hubble data dictionary: num_subentries description and minimum balance formula are both incorrect Openanalytics bug documentation
Difficulty 2/5 1-3 hours Newbie friendliness 91/100
stellar/stellar-docs#2860 · 1 comment ·
-
raven
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
stellar/stellar-docs#2842 · 2 comments · 1 reaction ·
All issues in stellar/stellar-docs
Similar issues
-
Crush Open
Difficulty 1/5 Under an hour Newbie friendliness 85/100
catppuccin/catppuccin#3125 ·
-
Link Checker Report Openautomated issue report
Difficulty 1/5 Under an hour Newbie friendliness 95/100
-
Difficulty 1/5 Under an hour Newbie friendliness 90/100
VoltAgent/awesome-design-md#469 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 70/100
KhronosGroup/glTF#2648 ·
-
Difficulty 1/5 Under an hour Newbie friendliness 90/100
sccn/sccn.github.io#108 ·