[Docs] AAT related comments & documentation improvements

Olshansk commented 5 months ago

This PR is the result of reviewing the codebase to answer AAT-related questions for the backend & infra teams at grove. As a result, the following changes were made:

Reformat (automatically) a handful of files using goimports-reviser
Update comments in some parts of the source code related to AATs
Update the documentation related to generating and using AATs
Build a reference upon which the foundation will update the official documentation at pokt-network/docs-v2

General quality-of-life improvements for documentation, comments and code health.

Olshansk commented 5 months ago

@adshmh

One extra suggestion: would be great if we could reference several of the files that are touched here in a list of docs/code to look at to learn how the relays and proofs work.

Would you be open to tackle this one yourself?

POKT-Discourse commented 5 months ago

This pull request has been mentioned on Pocket Network Forum. There might be relevant details there:

https://forum.pokt.network/t/block-sizes-claims-and-proofs-in-the-multi-gateway-era/5060/9

Olshansk commented 4 months ago

@msmania @kutoft @ezeike @nodiesBlade @commoddity @adshmh Wanted to bump this PR. PTAL when you have a chance.

pokt-network / pocket-core

[Docs] AAT related comments & documentation improvements #1598