Saltar al contenido principal

Archivo de Información Stellar (SEP-1)

Descripción general​

SEP-1 (Archivo de Información Stellar) permite que las wallets y otras aplicaciones Stellar descubran información sobre tu servicio de ancla. Al alojar un archivo stellar.toml en /.well-known/stellar.toml, permites que las aplicaciones encuentren automáticamente:

  • Información de tu organización
  • Activos y monedas que se soportan
  • Puntos finales de autenticación (SEP-10)
  • Puntos finales de SEP para SEP-6, SEP-24, SEP-31, SEP-38, SEP-45

Para más detalles, por favor consulta la especificación SEP-1.

Crear tu archivo stellar.toml​

Crea un archivo stellar.toml con la información de tu servicio. Aquí tienes un ejemplo mínimo para comenzar:

# dev.stellar.toml
ACCOUNTS = ["GD...G"]  # Your distribution account public keys
SIGNING_KEY = "GD...G"  # Your signing key (public key) for SEP-10 authentication
NETWORK_PASSPHRASE = "Test SDF Network ; September 2015"  # Use "Public Global Stellar Network ; September 2015" for mainnet

[DOCUMENTATION]
ORG_NAME = "Your organization"
ORG_URL = "https://your-website.com"
ORG_DESCRIPTION = "A description of your organization"
consejo

Para una lista completa de todos los atributos disponibles en stellar.toml, consulta la especificación SEP-1. Necesitarás añadir secciones adicionales como [[CURRENCIES]], TRANSFER_SERVER, TRANSFER_SERVER_SEP0024, WEB_AUTH_ENDPOINT, WEB_AUTH_FOR_CONTRACTS_ENDPOINT, DIRECT_PAYMENT_SERVER, etc., conforme configures los activos soportados y otros SEPs.

important

Producción vs. Desarrollo: Necesitarás archivos stellar.toml separados para testnet y mainnet:

  • Testnet: Usa NETWORK_PASSPHRASE = "Test SDF Network ; September 2015"
  • Mainnet: Usa NETWORK_PASSPHRASE = "Public Global Stellar Network ; September 2015"

Asegúrate de que tu archivo de producción incluya tus cuentas de distribución reales del Mainnet, claves de firma y las URLs del servicio de producción.

Configuración​

Para habilitar SEP-1, necesitas configurar cómo la Anchor Platform debe acceder a tu archivo stellar.toml. La plataforma soporta tres métodos:

TipoCaso de UsoDescripción
fileRecomendado para la mayoría de los casosLee desde un archivo local en el servidor
stringPruebas rápidas o configuraciones simplesProporciona el contenido TOML directamente en la configuración
urlAlojamiento externoObtiene el archivo desde una URL remota (útil para contenido dinámico)

Variables de Entorno​

Configura SEP-1 usando las siguientes variables de entorno:

  • SEP1_ENABLED: Setea a true para habilitar SEP-1
  • SEP1_TOML_TYPE: Uno de file, string, o url
  • SEP1_TOML_VALUE: El valor depende del tipo (ver ejemplos abajo)

Método 1: Archivo (Recomendado)​

Ideal para: despliegues en producción donde manejas el archivo en disco.

# dev.env
SEP1_ENABLED=true
SEP1_TOML_TYPE=file
SEP1_TOML_VALUE=/path/to/your/stellar.toml
consejo

Al usar Docker, monta tu archivo stellar.toml como un volumen y referencia la ruta dentro del contenedor. Por ejemplo:

# docker-compose.yaml
volumes:
  - ./config/stellar.toml:/config/stellar.toml:ro

Luego configura SEP1_TOML_VALUE=/config/stellar.toml en tu entorno.

Método 2: Cadena de texto​

Ideal para: pruebas rápidas, desarrollo, o cuando configures mediante variables de entorno.

# dev.env
SEP1_ENABLED=true
SEP1_TOML_TYPE=string
SEP1_TOML_VALUE="ACCOUNTS = [\"GD...G\"]
SIGNING_KEY = \"GD...G\"
NETWORK_PASSPHRASE = \"Test SDF Network ; September 2015\"
[DOCUMENTATION]
ORG_NAME = \"Your organization\"
ORG_URL = \"https://your-website.com\""
advertencia

Cuando uses el tipo string, asegúrate de que el contenido TOML esté correctamente escapado según el formato de tu archivo de entorno. Para configuraciones complejas, el tipo file es más fácil de manejar.

Método 3: URL​

Ideal para: contenido dinámico o cuando alojes el archivo externamente.

# dev.env
SEP1_ENABLED=true
SEP1_TOML_TYPE=url
SEP1_TOML_VALUE=https://example.com/stellar.toml
nota

Cuando uses el tipo url, la Anchor Platform obtendrá el archivo en cada solicitud. Asegúrate de que la URL sea accesible desde tu servidor de Anchor Platform y que devuelva contenido TOML válido.

Accediendo a tu archivo stellar.toml​

Una vez configurado y habilitado, la Anchor Platform sirve automáticamente tu archivo stellar.toml en el endpoint estándar SEP-1:

  • /.well-known/stellar.toml - El endpoint principal (servido con Content-Type: text/plain)
  • / - Redirige a /.well-known/stellar.toml cuando SEP-1 está habilitado

Probar tu configuración​

Después de iniciar la Anchor Platform, verifica tu configuración:

# Test the endpoint
curl http://localhost:8080/.well-known/stellar.toml

# Or test the redirect
curl -L http://localhost:8080/

Deberías ver el contenido de tu stellar.toml devuelto como texto plano.

Alternativa: Alojamiento externo​

También puedes alojar tu archivo stellar.toml usando un servidor de archivos estático como nginx o una CDN. Si eliges este enfoque:

  1. Aloja el archivo en https://your-domain.com/.well-known/stellar.toml
  2. Asegúrate de que sea accesible públicamente
  3. Asegúrate de que tu archivo stellar.toml incluya las URLs correctas apuntando a tus endpoints de Anchor Platform

El servicio SEP-1 de Anchor Platform es opcional si alojas el archivo externamente, pero ofrece una manera conveniente de gestionar todo en un solo lugar.