Skip to content

currency.md

Latest commit

 

History

History
42 lines (30 loc) · 1.47 KB

currency.md

File metadata and controls

42 lines (30 loc) · 1.47 KB
Raw

Currency Handling

The project uses payments_rs::currency::CurrencyAmount for all currency conversions.

Database Storage

  • All money amounts are stored as u64 in smallest currency units (cents for fiat, millisats for BTC)
  • This includes: cost plan amounts, custom pricing costs (cpu_cost, memory_cost, ip4_cost, ip6_cost, disk cost), fees, payment amounts

Admin API

The admin API accepts and returns amounts as u64 in smallest currency units.

Method Description
CurrencyAmount::from_u64(Currency, u64) Construct from smallest units directly
CurrencyAmount::from_f32(Currency, f32) Construct from human-readable value
.value() Returns u64 smallest units
.value_f32() Returns f32 human-readable value

Currency Decimal Places

Currency Decimal places Note
EUR, USD, GBP, CAD, CHF, AUD 2 100 cents = 1 unit
JPY 0 No subdivisions
BTC — Uses millisats (1000 millisats = 1 satoshi)

Example

use payments_rs::currency::{Currency, CurrencyAmount};

// Working with smallest units (preferred for API)
let amount = CurrencyAmount::from_u64(Currency::EUR, 1099); // €10.99 = 1099 cents
assert_eq!(amount.value(), 1099);       // 1099 cents
assert_eq!(amount.value_f32(), 10.99); // €10.99

// Converting human-readable to smallest units
let amount = CurrencyAmount::from_f32(Currency::EUR, 10.99); // €10.99
assert_eq!(amount.value(), 1099); // 1099 cents