Add API + tests for Swarm

I'd suggest removing these comments from the list, it makes the code less comprehensive. You can probably add them before the actual list definition