SEP-1: Stellar TOML

El archivo stellar.toml es un lugar común donde Internet puede encontrar información sobre la integración Stellar de una organización. Independientemente del tipo de transferencia que queramos usar (SEP-6 o SEP-24), necesitamos comenzar con SEP-1.

Para los anchors, nos interesa las CURRENCIES que emiten, las palabras clave TRANSFER_SERVER y/o TRANSFER_SERVER_SEP0024 que indican si el anchor admite SEP-6, SEP-24 o ambos, y el WEB_AUTH_ENDPOINT que permite a una billetera establecer una sesión de usuario autenticada.

BasicPay está interoperando con el anchor de prueba ubicado en testanchor.stellar.org y puedes ver su archivo toml aquí.

import { StellarTomlResolver } from "stellar-sdk";

// Fetches and returns the stellar.toml file hosted by a provided domain.
export async function fetchStellarToml(domain) {
  let stellarToml = await StellarTomlResolver.resolve(domain);
  return stellarToml;
}

Fuente: https://github.com/stellar/basic-payment-app/blob/main/src/lib/stellar/sep1.js

Hablando estrictamente, la función StellarTomlResolver del SDK de JavaScript es la única función que necesitamos para recuperar y usar la información proporcionada por el anchor (de hecho, incluso podríamos escribir nuestra propia función basada en fetch, y eludir el SDK por completo). Sin embargo, hemos creado varias funciones "auxiliares" para hacer que el resto de nuestras consultas sea un poco más verbal y claro sobre lo que buscamos del servidor anchor. ¡Asegúrate de revisar el archivo fuente sep1.js vinculado arriba!

Usando la información de stellar.toml para un activo con un home_domain, podemos mostrar al usuario algunas opciones (dependiendo de la infraestructura disponible). Comenzaremos con la autenticación SEP-10.