assetlist.schema.json

{
    "$schema": "https://json-schema.org/draft/2019-09/schema",
    "title": "AssetList",
    "type": "object",
    "required": [
        "chain_name",
        "assets"
    ],
    "properties": {
        "$schema": {
            "type": "string",
            "minLength": 1,
            "pattern": "^(\\.\\./)+assetlist\\.schema\\.json$"
        },
        "chain_name": {
            "type": "string",
            "minLength": 1,
            "pattern": "[a-z0-9]+",
            "examples": [
                "polygon"
            ]
        },
        "assets": {
            "type": "array",
            "default": [],
            "items": {
                "type": "object",
                "description": "An asset on this chain.",
                "additionalProperties": false,
                "required": [
                    "asset_type"
                ],
                "anyOf": [
                    {
                      "properties": {
                        "asset_type": { "const": "cosmos" }
                      },
                      "required": ["denom"]
                    },
                    {
                      "properties": {
                        "asset_type": { "const": "erc20" }
                      },
                      "required": ["erc20_contract_address"]
                    },
                    {
                      "properties": {
                        "asset_type": { "const": "evm_native" }
                      },
                      "required": ["evm_native_asset_name"]
                    }
                ],
                "properties": {
                    "asset_type": {
                        "type": "string",
                        "enum": ["cosmos", "evm_native", "erc20"] 
                    },
                    "evm_native_asset_name": {
                        "type": "string",
                        "minLength": 8,
                        "pattern": "[a-zA-Z]-native",
                        "description": "Required for evm_native asset types. A unique identifier for this asset. A native asset's ID should have the suffix -native. e.g. ethereum-native for ethereum."
                    },
                    "denom": {
                        "type": "string",
                        "minLength": 1,
                        "description": "Required for cosmos asset types. The denomination of the token." 
                    },
                    "erc20_contract_address": {
                        "type": "string",
                        "minLength": 1,
                        "pattern": "0x[a-zA-Z0-9]*$",
                        "description": "Required for erc20 asset types. The ERC20 contract address of the asset."
                    },
                    "name": {
                        "type": "string",
                        "minLength": 1,
                        "description": "[OPTIONAL] The name of the asset."
                    },
                    "decimals": {
                        "type": "integer",
                        "description": "[OPTIONAL] The decimals value of the asset."
                    },
                    "symbol": {
                        "type": "string",
                        "minLength": 1,
                        "description": "[OPTIONAL] The symbol of the asset."
                    },
                    "logo_uri": {
                        "type": "string",
                        "format": "uri-reference",
                        "minLength": 1,
                        "description": "[OPTIONAL] The logo URI of the asset."
                    },
                    "coingecko_id": {
                        "type": "string",
                        "minLength": 1,
                        "description": "[OPTIONAL] The coingecko ID of the asset."
                    },
                    "axelar_symbol": {
                        "type": "string",
                        "description": "[OPTIONAL] The axelar symbol of the asset."
                    },
                    "axelar_denom": {
                        "type": "string",
                        "description": "[OPTIONAL] The axelar denom of the asset."
                    },
                    "axelar_name": {
                        "type": "string",
                        "description": "[OPTIONAL] The axelar name of the asset."
                    },
                    "go_fast_enabled": {
                        "type": "boolean",
                        "default": false,
                        "description": "[OPTIONAL] If this asset is fast transferable via Skip Go Fast."
                    },
                    "recommended_symbol": {
                        "type": "string",
                        "description": "[OPTIONAL] The recommended symbol for this asset."
                    }
                }
            }
        }
    }
}