docs: add a section for numbers

[Dhaiwat10]

Closes #1555

[danielbate]

Do we think it's a good idea to introduce a BigInt example also, as those working with ethers made need assistance with conversions?

Additionally a sub paragraph on handling and differentiating big numbers I think would be beneficial. As you only need bn for u64.

[Dhaiwat10]

Do we think it's a good idea to introduce a BigInt example also, as those working with ethers made need assistance with conversions?

@danielbate as in, how does one convert a BigInt into a BN object? Or rather, how does one directly use an ethers-compatible BigInt with our SDK?

Additionally a sub paragraph on handling and differentiating big numbers I think would be beneficial. As you only need bn for u64.

Interesting. Did not know that. So, for the smaller types - we can directly pass in JavaScript numbers?

[danielbate]

as in, how does one convert a BigInt into a BN object? Or rather, how does one directly use an ethers-compatible BigInt with our SDK?

This may not even be possible, but BigInt and BN conversions so it can be used with both our SDK and ethers. If it's not possible, feel free to disregard.

Interesting. Did not know that. So, for the smaller types - we can directly pass in JavaScript numbers?

Yes exactly that, so if we look at the encode function for a NumberCoder which would be used when the ABI references a u8, u16 or u32:

fuels-ts/packages/abi-coder/src/coders/v0/number.ts

Line 45 in 59432a6

encode(value: number | string): Uint8Array {

The value to be encoded is expecting a number rather than a bn, so we can safely pass a JS compatible number.

[danielbate]

Nice one Dhai 💪🏻 Just one thought, may be irrelevant so approving.

[Dhaiwat10]

@Torres-ssf @danielbate thanks for the heads-up, investigating u256 support

[Dhaiwat10]

@danielbate @Torres-ssf you were right lads, we dont support u256. I've added a notice for it in the docs.

Should I also create an issue to add support for this type? @arboleya

[github-actions]

Coverage Report:

Lines	Branches	Functions	Statements
80.01%(+0%)	71.05%(+0%)	78%(+0%)	80.07%(+0%)

Changed Files:

Coverage values did not change👌.

[arboleya]

Should I also create an issue to add support for this type? @arboleya

Hmm, good catch. Let's also check if the Rust SDK has it.

There may be some reason it has never been added; it's worth investigating.

But yes, unless there's some strong reason behind it, feel free to create an issue. 👍

[arboleya]

✨

Removed all mentions of u256