SSeev PlusDocs
Stellar Anchor

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.toml
import { 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

FieldValuePurpose
TRANSFER_SERVERhttps://<your-anchor-domain>SEP-6 programmatic deposit/withdrawal API
WEB_AUTH_ENDPOINThttps://<your-anchor-domain>/authSEP-10 authentication
KYC_SERVERhttps://<your-anchor-domain>SEP-12 KYC API
TRANSFER_SERVER_SEP0024https://<your-anchor-domain>SEP-24 interactive flows
ANCHOR_QUOTE_SERVERhttps://<your-anchor-domain>SEP-38 quotes
SIGNING_KEYG...Public key for verifying SEP-10 challenges and callbacks
NETWORK_PASSPHRASETest SDF Network ; September 2015Stellar 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 callbacks

Why it matters

Without SEP-1, no wallet can find your anchor. The typical wallet flow starts with:

  1. User enters the anchor's domain (e.g. <your-anchor-domain>)
  2. Wallet fetches /.well-known/stellar.toml
  3. Wallet reads the available SEPs and supported assets
  4. 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"

On this page