documented public datastore interfaces