formalized the api for v0.0.4