Create javadocs and improve overall comment quality and quantity

[AlexJF]

Source code is lacking javadoc comments and explanatory comments on the particularly challenging sections (e.g. ODAGs, canonicality checking, canonicality calculation).

We should improve upon this to improve code quality and to be able to eventually generate javadocs to support the rest of the documentation.