contracts and documentation for palpal framework