more level interface with binary support
fix tests
document new interface
2.0.0