Documentation for `B256`

[petertonysmith94]

Summary

Reference docs

• We could rename these to B256 from Bits256to better align with the wider ecosystem.
• Currently we display how use getRandomB256 however I believe we should use actual addresses for a better showcase of their use cases.
• We're missing how to use these addresses with an actual contract.
• We're also missing how these can be used in Sway programs.

[cypherpepe]

1. Using Real Addresses:

   • Which real addresses do you recommend using in the documentation examples? Should these be test data, pre-defined addresses, or perhaps specific examples from existing projects?
   • What specific use cases involving real addresses would you like to see in the examples? Should we demonstrate their use in real transactions, or is it sufficient to show how they can be created and manipulated?

2. Integration with Contracts:

   • Should we add an example that shows how B256 can be used in contract calls to demonstrate interaction with contracts?
   • What level of detail do you expect for this example? Is a basic example sufficient, or should we include a more complex one, demonstrating interactions with other contracts or systems?

3. Using B256 in Sway Programs:

   • What specific scenarios involving B256 in Sway would you like to see documented? For instance, is it enough to show how to create and use a B256 variable, or do you need a more complex example?
   • Would you like to see examples of using B256 in specific contexts, such as cryptographic functions, hashing, or interactions with other Sway components?