feat!: represent small values as single bytes

[danielbate]

• Closes Representation of small values as single bytes #1398

Status

Test Suites: 250 passed, 250 total
Tests:       17 skipped, 1422 passed, 1439 total

New Test Scenarios

New isolated tests are being done at:

• packages/fuel-gauge/src/small-bytes.test.ts

Failing tests

• @nedsalk apps/docs-snippets/src/guide/contracts/configurable-constants.test.ts
• @danielbate apps/docs-snippets/src/guide/scripts/script-with-configurable.test.ts
• apps/docs-snippets/src/guide/types/options.test.ts
• apps/docs-snippets/src/guide/types/tuples.test.ts
• @nedsalk apps/docs-snippets/src/guide/types/vector.test.ts

• @nedsalk packages/abi-coder/test/interface.test.ts

• @nedsalk packages/fuel-gauge/src/advanced-logging.test.ts
• @danielbate packages/fuel-gauge/src/configurable-contract.test.ts
• packages/fuel-gauge/src/contract.test.ts
• packages/fuel-gauge/src/coverage-contract.test.ts
• @danielbate packages/fuel-gauge/src/predicate/predicate-configurables.test.ts
• @Torres-ssf packages/fuel-gauge/src/predicate/predicate-with-contract.test.ts
• @danielbate packages/fuel-gauge/src/script-with-configurable.test.ts
• packages/fuel-gauge/src/script-with-vectors.test.ts
• packages/fuel-gauge/src/vector-types.test.ts
• @nedsalk packages/fuel-gauge/src/vectors.test.ts

Internal Docs

This is the summary of the new encoding/decoding scheme:

fuels-ts/packages/abi-coder/src/coders/abstract-coder.ts

Lines 9 to 47 in de19b90

	/**
	* These options relates only to:
	* - NumberCoder (u8, u16, u32)
	* - BooleanCoder
	*
	* 1) isSmallBytes (default=false)
	*
	* Describes how many bytes it will ocuppy:
	*
	* false — occupies 8 bytes (default), and should be used when underneath:
	* • standalone
	* • tuple
	* • struct
	*
	* true — occupies 1 byte, and should be used when underneath:
	* • array
	* • vector
	* • enum
	*
	*
	* 2) isRightPadded (default=false)
	*
	* Used only when `isSmallBytes` is FALSE.
	*
	* Describes how the padding should happen:
	*
	* false —— left padded (default), and should be used when underneath:
	* • standalone
	* • array
	* • vector
	* • enum
	* • only one function argument
	*
	* true —— right padded, and should be used when underneath:
	* • struct
	* • tuple
	* • multiple function arguments
	*
	*/

[github-actions]

Coverage report

St.❔	Category	Percentage	Covered / Total
🟢	Statements	86.47% (+0.07% 🔼)	5830/6742
🟡	Branches	70.52% (+0.41% 🔼)	885/1255
🟡	Functions	77.23% (+0.07% 🔼)	963/1247
🟢	Lines	86.44% (+0.07% 🔼)	5580/6455

Show files with reduced coverage 🔻

St.❔	File	Statements	Branches	Functions	Lines
🟢	... / utilities.ts	97.44% (-1.05% 🔻)	88.89% (-5.23% 🔻)	93.33% (+1.67% 🔼)	97.1% (-1.29% 🔻)
🟢	... / abi-coder.ts	92.5%	84% (-2.96% 🔻)	87.5%	92.41% (+0.1% 🔼)

Test suite run success

1422 tests passing in 250 suites.

Report generated by 🧪jest coverage report action from 82b53fa

[arboleya]

Warning

This PR should not be merged yet.
Please, don't resolve this conversation.

[danielbate]

Closing as this work is included in #1407 so the source of truth review should be there