full spec for get_all_blocks