Public metadata for the Balancer protocol.

Categories are used to tag sets of pools in the Balancer API and frontend.

To add a new tag, update the tag json with an object using the following schema:

type Category = {
    id: string; // If it's a points category, prepend id with `points_`, see existing categories for examples.
    name: string;
    description: string;
    value?: string; // Arbitrary value that may be used by the frontend to provide more context, e.g. points multiples for points categories.
    url?: string; // A link you want to associate with the tag.
    icon?: string; // Icon to be used in frontend to represent the category. Should be a relative path, see existing categories for examples.
    pools: string[]; // A list of pool IDs that should receive the tag.
};

To add an icon to be used for a tag, add a new file to the /icons directory with the ID of the category as its name, e.g. my_category_id.svg. Then add the icon property to the category object in index.json.

Tags are generic pool <> metadata associations that are ingested by the API. We use these categories for specific use cases like 3rd party point programs. To add a new point program category there are a couple of things to pay attention to.

1. The id should include points, preferably as a prepend, e.g. id: "points_protocol_name".
2. If the points program has a multiple, you can use the value attribute to specify that multiple. If the multiple is 5x then value: "5".