feat: add warning for invalid precision in BN format method

.changeset/warn-precision-validation

@@ -0,0 +1,6 @@
+---
+"@fuel-ts/math": patch
+---
+
+Added warning when precision is less than minPrecision in BN.format method.
+This maintains backward compatibility while alerting users to potential issues.

packages/math/src/bn.test.ts

@@ -541,4 +541,27 @@ describe('Math - BN', () => {
   it('should return significant figures even if it exceeds the precision', () => {
     expect(bn('4000000').format({ precision: 1 })).toEqual('0.004');
   });
+
+  it('should warn when precision is less than minPrecision', () => {
+    const consoleWarnSpy = jest.spyOn(console, 'warn').mockImplementation();
+
+    // Test case where precision < minPrecision
+    bn(123).format({ precision: 2, minPrecision: 4 });
+
+    expect(consoleWarnSpy).toHaveBeenCalledWith(
+      'Warning: precision (2) is less than minPrecision (4). ' +
+      'This may lead to unexpected behavior. Consider setting precision >= minPrecision.'
+    );
+
+    // Test case where precision = minPrecision (should not warn)
+    consoleWarnSpy.mockClear();
+    bn(123).format({ precision: 4, minPrecision: 4 });
+    expect(consoleWarnSpy).not.toHaveBeenCalled();
+
+    // Test case where precision > minPrecision (should not warn)
+    bn(123).format({ precision: 6, minPrecision: 4 });
+    expect(consoleWarnSpy).not.toHaveBeenCalled();
+
+    consoleWarnSpy.mockRestore();
+  });
 });

packages/math/src/bn.ts

@@ -117,8 +117,15 @@ export class BN extends BnJs implements BNInputOverrides, BNHiddenTypes, BNHelpe
       return this.toString().replace(/\B(?=(\d{3})+(?!\d))/g, ',');
     }
 
-    // Adjust precision and minPrecision
-    // TODO: This really should throw an error because you can't have a precision less than the minPrecision but this would be a breaking change
+    // Warn if precision is less than minPrecision
+    if (initialPrecision < initialMinPrecision) {
+      console.warn(
+        `Warning: precision (${initialPrecision}) is less than minPrecision (${initialMinPrecision}). ` +
+        'This may lead to unexpected behavior. Consider setting precision >= minPrecision.'
+      );
+    }
+
+    // Adjust precision and minPrecision to maintain backward compatibility
     const minPrecision =
       initialMinPrecision > initialPrecision ? initialPrecision : initialMinPrecision;
     const precision =