Document the sBTC PoX Contract

[netrome]

Definition of done

The documentation contains a chapter explaining which functions the new PoX contract should contain, their purpose and who calls them.

Note: This should focus on the public interface and anything critical to the sBTC design. Implementation details may be omitted.

[netrome]

Open question: I know sBTC Mini is broken down to many contracts. I don't know if we'll do the same with the final PoX contract. If so, it could be good to document the public interface but also provide an explanation of the sub-contracts as sub-chapters.

[MarvinJanssen]

It would be more runtime cost efficient to keep the contracts split, but let's discuss that on docs.

[netrome]

It would be more runtime cost efficient to keep the contracts split, but let's discuss that on docs.

Let's aim for a similar structure. I think it is easier to understand a collection of small focused contracts for a reader rather than one single massive contract too.

I guess only the asset contract and PoX will be externally facing in sBTC though, so let's focus on those for starters.

[MarvinJanssen]

I agree.