SEP-1: Stellar Info File (stellar.toml)
Discover SeevCash anchor capabilities, endpoints, and assets via the stellar.toml file.
SEP-1 defines how wallets discover your anchor. The stellar.toml file is the entry point for every Stellar integration — it tells wallets what services you offer, where the APIs live, and what assets are supported.
Fetching the TOML
curl https://<your-anchor-domain>/.well-known/stellar.tomlimport { Wallet } from '@stellar/typescript-wallet-sdk';
const wallet = Wallet.TestNet();
const anchor = wallet.anchor({ homeDomain: '<your-anchor-domain>' });
// The wallet SDK resolves the stellar.toml automatically
const toml = await anchor.getInfo();Every compliant wallet fetches this automatically when it encounters the SeevCash anchor.
Key fields
| Field | Value | Purpose |
|---|---|---|
TRANSFER_SERVER | https://<your-anchor-domain> | SEP-6 programmatic deposit/withdrawal API |
WEB_AUTH_ENDPOINT | https://<your-anchor-domain>/auth | SEP-10 authentication |
KYC_SERVER | https://<your-anchor-domain> | SEP-12 KYC API |
TRANSFER_SERVER_SEP0024 | https://<your-anchor-domain> | SEP-24 interactive flows |
ANCHOR_QUOTE_SERVER | https://<your-anchor-domain> | SEP-38 quotes |
SIGNING_KEY | G... | Public key for verifying SEP-10 challenges and callbacks |
NETWORK_PASSPHRASE | Test SDF Network ; September 2015 | Stellar network |
Currencies
The TOML declares which assets the anchor supports:
[[CURRENCIES]]
code = "USDC"
issuer = "GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5"
status = "live"
is_asset_anchored = true
anchor_asset_type = "fiat"
anchor_asset = "USD"
desc = "USD Coin issued by Circle"Using SEP-1 in your integration
# Discover all endpoints
curl -s https://<your-anchor-domain>/.well-known/stellar.toml | grep -E "TRANSFER_SERVER|WEB_AUTH|KYC_SERVER|SIGNING_KEY"import { Wallet } from '@stellar/typescript-wallet-sdk';
const wallet = Wallet.TestNet();
const anchor = wallet.anchor({ homeDomain: '<your-anchor-domain>' });
const toml = await anchor.getInfo();
console.log(toml.transferServer); // SEP-6 base URL
console.log(toml.webAuthEndpoint); // SEP-10 auth
console.log(toml.kycServer); // SEP-12
console.log(toml.anchorQuoteServer); // SEP-38
console.log(toml.signingKey); // For verifying callbacksWhy it matters
Without SEP-1, no wallet can find your anchor. The typical wallet flow starts with:
- User enters the anchor's domain (e.g.
<your-anchor-domain>) - Wallet fetches
/.well-known/stellar.toml - Wallet reads the available SEPs and supported assets
- Wallet proceeds with SEP-10 authentication using
WEB_AUTH_ENDPOINT
The stellar.toml must be served over HTTPS with proper CORS headers (Access-Control-Allow-Origin: *). Wallets will reject anchors that don't serve over HTTPS.
Organization info
The TOML also contains organization details that wallets display to users:
[DOCUMENTATION]
ORG_NAME = "SeevCash"
ORG_DBA = "SeevCash"
ORG_URL = "https://seevcash.com"
ORG_DESCRIPTION = "Fiat on/off-ramp for Stellar via Ghana Mobile Money"
ORG_OFFICIAL_EMAIL = "support@seevcash.com"Related
- Authentication (SEP-10) — Next step after discovery
- Stellar SEP-1 Specification