Currency

Currency

Currency — FinKore specification text, requirements, and related reading.

On this page

Status

FinKore Core 2.0.4 stable.

Purpose

This document defines currency identity and compatibility for Money values that use ISO 4217 identifiers in Core 2.0.

Requirements

  • MONEY-CURRENCY-001 — A currency identifier MUST be non-empty and unambiguous within its declared context.
  • MONEY-CURRENCY-002 — Currency identifiers SHOULD use ISO 4217 alphabetic codes when representing currencies covered by ISO 4217.
  • MONEY-CURRENCY-003 — Within this document's normative scope, two Money values MUST be considered currency-compatible only when they use the same ISO 4217 currency identifier.
  • MONEY-CURRENCY-004 — Operations that require currency compatibility MUST fail with FINKORE_MONEY_CURRENCY_MISMATCH when currencies are incompatible. Conversion is a separate explicit operation outside this specification.
  • MONEY-CURRENCY-005 — Currency metadata MUST NOT be treated as an exchange rate.

The uppercase rule for ISO 4217 identifiers is SPEC-CURRENCY-002 in Specification Conventions.

Invariants

A Money operation other than explicit conversion does not change currency; see MONEY-ARITHMETIC-002 through MONEY-ARITHMETIC-005.

Examples

EUR and EUR are compatible. EUR and USD are not compatible.

Invalid Examples

  • Treating all dollar-named currencies as compatible.
  • Relabeling 10 USD as 10 EUR without conversion.

Errors

The applicable failure conditions are defined in Money Errors.

Open Questions

  • Should a future FinKore specification define a namespace for application-defined or non-ISO currency identifiers?

Non-Goals

This document does not define exchange rates, redenomination, currency availability dates, or display symbols. Application-defined currencies, crypto assets, tokens, loyalty points, internal credits, and other non-ISO identifiers are outside the normative scope of Core 2.0; this exclusion does not prohibit a composing application from supporting them.

Back to the top ↑