fix: validation and handling of unsafe integers

[petertonysmith94]

• Closes Handle large number values gracefully #3490

Release notes

In this release, we:

• Improved validation and handling of unsafe integers in BigNumberCoder

Summary

• Any number bigger than Number.MAX_SAFE_INTEGER, encoded using the BigNumber coder, could lead to malformed data. We should ensure that the numbers of MAX_SAFE_INTEGER are encoded correctly and throw an error when attempting to handle a number more than this value.

Checklist

• All changes are covered by tests (or not applicable)
• All changes are documented (or not applicable)
• I reviewed the entire PR myself (preferably, on GH UI)
• I described all Breaking Changes (or there's none)

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
fuels-template	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Dec 23, 2024 10:01am
ts-docs	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Dec 23, 2024 10:01am
ts-docs-api	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Dec 23, 2024 10:01am

[codspeed-hq]

CodSpeed Performance Report

Merging #3491 will degrade performances by 20.27%

_{Comparing ps/fix/issue-with-big-numbers (b68944c) with master (41c72fb)}

Summary

❌ 1 regressions
✅ 17 untouched benchmarks

⚠️ Please fix the performance issues or acknowledge them on CodSpeed.

Benchmarks breakdown

	Benchmark	master	ps/fix/issue-with-big-numbers	Change
❌	should successfully conduct a custom transfer between wallets (x20 times)	50.3 ms	63.1 ms	-20.27%

[danielbate]

Suggested change

	new FuelError(ErrorCode.ENCODE_ERROR, 'Invalid u64 type - number value is too large.')
	new FuelError(ErrorCode.ENCODE_ERROR, 'Invalid u64 type - too large. Number can only safely handle up to 53 bits').

JW if it needs more detail

[github-actions]

Coverage Report:

Lines	Branches	Functions	Statements
76.33%(+0%)	69.88%(+0.04%)	74.2%(+0%)	76.34%(+0%)

Changed Files:

Coverage values did not change👌.