first draft guide + tweaks to transaction_set_defs