finished implementation of API. All API components are simply tested in human-checkable dsTest.c