add explicit passing on version string
update publicly available functions
update readme and add license