Federation Meta Info Shared with Fedi

When you connect to a Federation, Fedi gets several pieces of information about the Federation from a Metadata configuration file. This file is hosted by the Federation Guardians, and is signed by the Guardians' keys. This ensures that the information is accurate and hasn't been tampered with.

The following meta fields are interpretable by the Fedi app (note the fedi: prefix on all fields) to provide additional functionality that affects the user experience:

• fedi:meta_external_url: A URL to a file containing overrides for meta fields (will be deprecated in the future... behaves exactly the same as meta_override_url)
• fedi:default_currency: 3-letter ISO 4217 currency code
• fedi:tos_url: A URL presented to the user before joining the federation
• fedi:federation_icon_url: A URL to a JPG or PNG file used as the federation icon
• fedi:popup_end_timestamp: A Unix timestamp after which the app will disable access to the federation
• fedi:invite_codes_disabled: Boolean value that blocks access to the federation invite code
• fedi:new_members_disabled: Boolean value that prevents new members from joining the federation
• fedi:social_recovery_disabled: Boolean value that disables the social backup & recovery features
• fedi:offline_wallet_disabled: Boolean value that disables offline ecash generation features
• fedi:onchain_deposits_disabled: Boolean value that disables the onchain deposit features
• fedi:max_invoice_msats: Number value in millisats that prevents users from generating invoices higher than the specified amount
• fedi:max_balance_msats: Number value in millisats that prevents users from having a balance higher than the specified amount
• fedi:fedimods: Stringified JSON array of objects representing the default FediMods shown to users upon joining the federation
• fedi:default_group_chats: Stringified JSON array of strings representing the IDs of any chat groups that all users will join automatically upon creating their username

Fedi displays this information in the app. If any of these are missing or invalid, make sure to contact your Federation Guardians to update the metadata file, or submit a bug report in Fedi to let us know.