VaultMath

Git Source

Title: VaultMath

Author: Quantillon Labs - Nicolas Bellengé - @chewbaccoin

Mathematical operations library for Quantillon Protocol

This library provides essential mathematical utilities:

• Percentage calculations for fees and yield distributions
• Min/max value selection for safe boundaries
• Decimal scaling utilities for different token precisions

Note: security-contact: team@quantillon.money

Constants

BASIS_POINTS

Precision for percentage calculations (10000 = 100%)

uint256 public constant BASIS_POINTS = 10000

PRECISION

High precision scalar (18 decimals)

uint256 public constant PRECISION = 1e18

MAX_PERCENTAGE

Maximum allowed percentage (10000%)

uint256 public constant MAX_PERCENTAGE = 1000000

Functions

version

Returns the semantic version of this linked library.

On-chain version of the standalone deployed library; bump per semver on any change. See deployments/{chainId}/versions.json for deployed-address provenance.

Notes:

• security: No security implications - returns a compile-time constant.

• validation: No input validation required.

• state-changes: None - pure function.

• events: None.

• errors: None.

• reentrancy: Not applicable - pure function.

• access: Public - anyone can read the version.

• oracle: No oracle dependencies.

function version() external pure returns (string memory);

Returns

mulDiv

Multiply two numbers and divide by a third with rounding

Used by percentageOf for fee calculations

Notes:

• security: Prevents division by zero and multiplication overflow

• validation: Validates c != 0, checks for multiplication overflow

• state-changes: No state changes - pure function

• events: No events emitted

• errors: Throws "Division by zero" if c is 0, "Multiplication overflow" if overflow

• reentrancy: Not applicable - pure function

• access: Internal function - no access restrictions

• oracle: No oracle dependencies

function mulDiv(uint256 a, uint256 b, uint256 c) internal pure returns (uint256 result);

Parameters

Returns

percentageOf

Calculate percentage of a value

Used for fee calculations across all contracts

Notes:

• security: Prevents percentage overflow and division by zero

• validation: Validates percentage <= MAX_PERCENTAGE

• state-changes: No state changes - pure function

• events: No events emitted

• errors: Throws "Percentage too high" if percentage > MAX_PERCENTAGE

• reentrancy: Not applicable - pure function

• access: Internal function - no access restrictions

• oracle: No oracle dependencies

function percentageOf(uint256 value, uint256 percentage) internal pure returns (uint256);

Parameters

Returns

scaleDecimals

Scale a value between different decimal precisions with proper rounding

Used for converting between token precisions (e.g., USDC 6 decimals to 18 decimals)

Notes:

• security: Pure; no overflow for typical decimals

• validation: fromDecimals/toDecimals are uint8

• state-changes: None

• events: None

• errors: None

• reentrancy: No external calls

• access: Internal library

• oracle: None

function scaleDecimals(uint256 value, uint8 fromDecimals, uint8 toDecimals)
    internal
    pure
    returns (uint256 scaledValue);

Parameters

Returns