docs: add validation error behavior documentation to builder

[crStiv]

Document that trust_light_block validates blocks before insertion and
does not modify the light store on validation failure. Also document
the validate method's checks for better API clarity.

---

Note

Document validation behavior for trusting a light block and detail the validate method’s checks in the light client builder.

^{Written by Cursor Bugbot for commit ae31988. This will update automatically on new commits. Configure here.}