Further chain improvements (#1420)

* Further chain improvements

* add setters to the interface

* doc comments

* swap everything to ref as we dont need to maintain binary compat

* Revert "swap everything to ref as we dont need to maintain binary compat"

This reverts commit 16454f4.

* make them ref readonly so you cant reassign

Author: Khitiara