Improves contracts and update few docblocks

Signed-off-by: crynobone <crynobone@gmail.com>