handler in examples is now done
complete api in readme