Skip to main content

Key-Value Database

The SorobanDomains protocol has a contract that acts as a Database where domain owners can include data that is directly tied to their domains. This allows you to have stuff like a SEP-0001 Stellar TOML file url hosted wherever you want and just setting the url in the database tied to your domain.

The database is flexible and you can define any key your dApp/protocol needs but with time we will be defining standard keys. Here you can see them:

## SEP-1 TOML file url
TOML = Value::String(TOML_URL)

## Optional, could help in verifying the content hasn't been tempered
TOML_HASH = Value::Bytes(TOML_SHA256_HASH)

## Projects like xlm.sh could use this key, that way they don't need to look for the CID elsewhere
WEBSITE = Value::String(SITE_URL)
WEBSITE_IPFS = Value::Bytes(IPFS_CID)
WEBSITE_IPNS = Value::Bytes(IPNS_KEY)

Writing and reading data

If you're interacting with the database contract from your dApp, you can use the SDK explained here.

Writing fee

Writing a new value to the Database currently costs $PSD 100