sep-0001-toml.md

SEP-0001 - stellar.toml

This examples shows how to obtain the parsed data from a stellar.toml file. For more details see: SEP-0001.

The data can be parsed from a string or loaded and parsed from a given domain.

From string

To parse the data from a string you can use the default constructor of the StellarToml class.

String toml = '''
# Sample stellar.toml
VERSION="2.0.0"
# ...
''';

StellarToml stellarToml = StellarToml(toml);
GeneralInformation generalInformation = stellarToml.generalInformation;
print(generalInformation.version);

After parsing, the StellarToml class provides information for (if available): generalInformation, documentation, pointsOfContact, currencies and validators. See the sdk api docs for more details.

From domain

To load and parse the data from a domain you can use the fromDomain constructor of the StellarToml class. It automatically composes the needed url. In the following example the data is loaded from: https://soneso.com/.well-known/stellar.toml - only the domain "soneso.com" has to be provided:

StellarToml stellarToml = await StellarToml.fromDomain("soneso.com");
GeneralInformation generalInformation = stellarToml.generalInformation;
//...

After parsing, the StellarToml class provides information for (if available): generalInformation, documentation, pointsOfContact, currencies and validators. See the sdk api docs for more details.

Linked currency

Alternately to specifying a specific currency in it's content, stellar.toml can link out to a separate TOML file for a given currency by specifying toml="https://DOMAIN/.well-known/CURRENCY.toml" as the currency's only field.

VERSION="2.0.0"
#...
[[CURRENCIES]]
toml="https://soneso.com/.well-known/TESTC.toml"
#...

To load the data of this currency, you can use the static method: StellarToml.currencyFromUrl(String toml) - as shown in the example below:

StellarToml stellarToml = await StellarToml.fromDomain("soneso.com");
List<Currency> currencies = stellarToml.currencies;
for (Currency currency in currencies) {
  if (currency.toml != null) {
    Currency linkedCurrency = await StellarToml.currencyFromUrl(currency.toml);
    print(linkedCurrency.code);
  }
}