amounts 0.0.5 → 0.0.7

data/lib/generators/amount/active_record/templates/presets/all.fragment

@@ -0,0 +1,494 @@
+  # Registry overview:
+  # Major Fiat Currencies:
+  # - This preset is a curated basket of widely used fiat currencies for general product and treasury workflows.
+  # - Minor-unit precision follows ISO-4217-style currency fractions: most entries use 2 decimals, while JPY uses 0.
+  # - Display symbols are English-oriented defaults inspired by CLDR conventions and may need localization in real applications.
+  # - Source: Unicode CLDR currency symbols and localization notes: https://cldr.unicode.org/translation/currency-names-and-symbols/currency-names
+  # 
+  # Precious And Industrial Metals:
+  # - This preset is a curated basket of metals commonly tracked in treasury, vault, and commodities workflows.
+  # - Display-unit conversion factors use standard mass relationships such as troy-ounce to gram and kilogram to pound.
+  # - Storage decimals here are preset defaults chosen for application headroom; they are not exchange-mandated market standards.
+  # - Source: NIST precious-metals conversion guidance: https://www.nist.gov/pml/weights-and-measures/laws-and-regulations/precious-metals-conversion
+  # - Source: NIST metric and customary conversion guidance: https://www.nist.gov/pml/weights-and-measures/common-conversion-factors-ii
+  # 
+  # Large-Cap Crypto Assets:
+  # - This preset is a curated basket of prominent crypto assets intended for developer-facing ledgers and wallet-style products.
+  # - It is not a literal mirror of any single market-cap top-20 list; the basket favors assets with broadly understood denomination conventions and common integration relevance.
+  # - Where an asset is multichain, the preset documents the denomination convention the initializer assumes.
+  # - Source: Large-cap market snapshot used as a selection input on April 24, 2026: https://coinmarketcap.com/historical/20260424/
+
+  # USD: United States dollar.
+  # Fact: Uses 2 decimal places for cents.
+  # Preset default: Uses "$" as the default display symbol in an English-oriented UI.
+  # Preset default: Renders as a prefix amount, for example "$12.34".
+  # Source: Currency symbol conventions: https://cldr.unicode.org/translation/currency-names-and-symbols/currency-names
+  Amount.register :USD,
+    decimals: 2,
+    display_symbol: "$",
+    display_position: :prefix,
+    ui_decimals: 2
+
+  # EUR: Euro.
+  # Fact: Uses 2 decimal places for cents.
+  # Preset default: Uses the euro sign as the default display symbol.
+  # Preset default: Renders as a prefix amount for a compact English-oriented default.
+  # Source: Currency symbol conventions: https://cldr.unicode.org/translation/currency-names-and-symbols/currency-names
+  Amount.register :EUR,
+    decimals: 2,
+    display_symbol: "€",
+    display_position: :prefix,
+    ui_decimals: 2
+
+  # GBP: British pound sterling.
+  # Fact: Uses 2 decimal places for pence.
+  # Preset default: Uses the pound sign as the default display symbol.
+  # Preset default: Renders as a prefix amount.
+  # Source: Currency symbol conventions: https://cldr.unicode.org/translation/currency-names-and-symbols/currency-names
+  Amount.register :GBP,
+    decimals: 2,
+    display_symbol: "£",
+    display_position: :prefix,
+    ui_decimals: 2
+
+  # JPY: Japanese yen.
+  # Fact: Uses 0 decimal places under standard minor-unit conventions.
+  # Preset default: Uses the yen sign as the default display symbol.
+  # Preset default: Renders as a prefix amount with no fractional UI digits.
+  # Source: Currency symbol conventions: https://cldr.unicode.org/translation/currency-names-and-symbols/currency-names
+  Amount.register :JPY,
+    decimals: 0,
+    display_symbol: "¥",
+    display_position: :prefix,
+    ui_decimals: 0
+
+  # CHF: Swiss franc.
+  # Fact: Uses 2 decimal places for rappen/centimes.
+  # Preset default: Uses the ISO code as the display symbol to avoid locale ambiguity.
+  # Preset default: Renders as a suffix amount, for example "12.34 CHF".
+  # Source: Currency symbol conventions: https://cldr.unicode.org/translation/currency-names-and-symbols/currency-names
+  Amount.register :CHF,
+    decimals: 2,
+    display_symbol: "CHF",
+    display_position: :suffix,
+    ui_decimals: 2
+
+  # CAD: Canadian dollar.
+  # Fact: Uses 2 decimal places for cents.
+  # Preset default: Uses "CA$" instead of plain "$" to avoid collision with USD.
+  # Source: Currency symbol conventions: https://cldr.unicode.org/translation/currency-names-and-symbols/currency-names
+  Amount.register :CAD,
+    decimals: 2,
+    display_symbol: "CA$",
+    display_position: :prefix,
+    ui_decimals: 2
+
+  # AUD: Australian dollar.
+  # Fact: Uses 2 decimal places for cents.
+  # Preset default: Uses "A$" instead of plain "$" to avoid collision with USD.
+  # Source: Currency symbol conventions: https://cldr.unicode.org/translation/currency-names-and-symbols/currency-names
+  Amount.register :AUD,
+    decimals: 2,
+    display_symbol: "A$",
+    display_position: :prefix,
+    ui_decimals: 2
+
+  # NZD: New Zealand dollar.
+  # Fact: Uses 2 decimal places for cents.
+  # Preset default: Uses "NZ$" instead of plain "$" to avoid collision with USD.
+  # Source: Currency symbol conventions: https://cldr.unicode.org/translation/currency-names-and-symbols/currency-names
+  Amount.register :NZD,
+    decimals: 2,
+    display_symbol: "NZ$",
+    display_position: :prefix,
+    ui_decimals: 2
+
+  # SGD: Singapore dollar.
+  # Fact: Uses 2 decimal places for cents.
+  # Preset default: Uses "S$" instead of plain "$" to avoid collision with USD.
+  # Source: Currency symbol conventions: https://cldr.unicode.org/translation/currency-names-and-symbols/currency-names
+  Amount.register :SGD,
+    decimals: 2,
+    display_symbol: "S$",
+    display_position: :prefix,
+    ui_decimals: 2
+
+  # HKD: Hong Kong dollar.
+  # Fact: Uses 2 decimal places for cents.
+  # Preset default: Uses "HK$" instead of plain "$" to avoid collision with USD.
+  # Source: Currency symbol conventions: https://cldr.unicode.org/translation/currency-names-and-symbols/currency-names
+  Amount.register :HKD,
+    decimals: 2,
+    display_symbol: "HK$",
+    display_position: :prefix,
+    ui_decimals: 2
+
+  # CNY: Chinese yuan renminbi.
+  # Fact: Uses 2 decimal places for jiao/fen display.
+  # Preset default: Uses "CN¥" to avoid confusion with other yen/yuan symbols in multi-currency UIs.
+  # Source: Currency symbol conventions: https://cldr.unicode.org/translation/currency-names-and-symbols/currency-names
+  Amount.register :CNY,
+    decimals: 2,
+    display_symbol: "CN¥",
+    display_position: :prefix,
+    ui_decimals: 2
+
+  # INR: Indian rupee.
+  # Fact: Uses 2 decimal places for paise.
+  # Preset default: Uses the rupee sign as the default display symbol.
+  # Preset default: Renders as a prefix amount.
+  # Source: Currency symbol conventions: https://cldr.unicode.org/translation/currency-names-and-symbols/currency-names
+  Amount.register :INR,
+    decimals: 2,
+    display_symbol: "₹",
+    display_position: :prefix,
+    ui_decimals: 2
+
+  # MXN: Mexican peso.
+  # Fact: Uses 2 decimal places for centavos.
+  # Preset default: Uses "MX$" instead of plain "$" to avoid collision with USD.
+  # Source: Currency symbol conventions: https://cldr.unicode.org/translation/currency-names-and-symbols/currency-names
+  Amount.register :MXN,
+    decimals: 2,
+    display_symbol: "MX$",
+    display_position: :prefix,
+    ui_decimals: 2
+
+  # BRL: Brazilian real.
+  # Fact: Uses 2 decimal places for centavos.
+  # Preset default: Uses the common Brazilian real symbol "R$".
+  # Source: Currency symbol conventions: https://cldr.unicode.org/translation/currency-names-and-symbols/currency-names
+  Amount.register :BRL,
+    decimals: 2,
+    display_symbol: "R$",
+    display_position: :prefix,
+    ui_decimals: 2
+
+  # AED: United Arab Emirates dirham.
+  # Fact: Uses 2 decimal places for fils.
+  # Preset default: Uses the ISO code as the display symbol for an unambiguous English-oriented default.
+  # Preset default: Renders as a suffix amount.
+  # Source: Currency symbol conventions: https://cldr.unicode.org/translation/currency-names-and-symbols/currency-names
+  Amount.register :AED,
+    decimals: 2,
+    display_symbol: "AED",
+    display_position: :suffix,
+    ui_decimals: 2
+
+  # GOLD: Gold measured with troy-ounce display defaults.
+  # Fact: The alternate gram display uses 1 troy ounce = 31.1035 grams.
+  # Fact: The alternate kilogram display uses 1 troy ounce = 0.0311035 kilograms.
+  # Preset default: Uses 8 storage decimals as a high-precision preset default rather than a market mandate.
+  # Preset default: Defaults to troy-ounce display because that is common for bullion pricing.
+  # Source: NIST precious-metals conversion guidance: https://www.nist.gov/pml/weights-and-measures/laws-and-regulations/precious-metals-conversion
+  Amount.register :GOLD,
+    decimals: 8,
+    display_symbol: "oz t",
+    display_position: :suffix,
+    ui_decimals: 4,
+    display_units: {
+      oz_t: { scale: 1, symbol: "oz t", ui_decimals: 4 },
+      gram: { scale: "31.1035", symbol: "g", ui_decimals: 2 },
+      kg:   { scale: "0.0311035", symbol: "kg", ui_decimals: 5 }
+    },
+    default_display: :oz_t
+
+  # SILVER: Silver measured with troy-ounce display defaults.
+  # Fact: The alternate gram display uses 1 troy ounce = 31.1035 grams.
+  # Fact: The alternate kilogram display uses 1 troy ounce = 0.0311035 kilograms.
+  # Preset default: Uses 8 storage decimals as a high-precision preset default.
+  # Preset default: Defaults to troy-ounce display for consistency with common bullion quoting.
+  # Source: NIST precious-metals conversion guidance: https://www.nist.gov/pml/weights-and-measures/laws-and-regulations/precious-metals-conversion
+  Amount.register :SILVER,
+    decimals: 8,
+    display_symbol: "oz t",
+    display_position: :suffix,
+    ui_decimals: 4,
+    display_units: {
+      oz_t: { scale: 1, symbol: "oz t", ui_decimals: 4 },
+      gram: { scale: "31.1035", symbol: "g", ui_decimals: 2 },
+      kg:   { scale: "0.0311035", symbol: "kg", ui_decimals: 5 }
+    },
+    default_display: :oz_t
+
+  # PLATINUM: Platinum measured with troy-ounce display defaults.
+  # Fact: The alternate gram display uses 1 troy ounce = 31.1035 grams.
+  # Fact: The alternate kilogram display uses 1 troy ounce = 0.0311035 kilograms.
+  # Preset default: Uses 8 storage decimals as a high-precision preset default.
+  # Preset default: Defaults to troy-ounce display for commodity-style pricing.
+  # Source: NIST precious-metals conversion guidance: https://www.nist.gov/pml/weights-and-measures/laws-and-regulations/precious-metals-conversion
+  Amount.register :PLATINUM,
+    decimals: 8,
+    display_symbol: "oz t",
+    display_position: :suffix,
+    ui_decimals: 4,
+    display_units: {
+      oz_t: { scale: 1, symbol: "oz t", ui_decimals: 4 },
+      gram: { scale: "31.1035", symbol: "g", ui_decimals: 2 },
+      kg:   { scale: "0.0311035", symbol: "kg", ui_decimals: 5 }
+    },
+    default_display: :oz_t
+
+  # PALLADIUM: Palladium measured with troy-ounce display defaults.
+  # Fact: The alternate gram display uses 1 troy ounce = 31.1035 grams.
+  # Fact: The alternate kilogram display uses 1 troy ounce = 0.0311035 kilograms.
+  # Preset default: Uses 8 storage decimals as a high-precision preset default.
+  # Preset default: Defaults to troy-ounce display for commodity-style pricing.
+  # Source: NIST precious-metals conversion guidance: https://www.nist.gov/pml/weights-and-measures/laws-and-regulations/precious-metals-conversion
+  Amount.register :PALLADIUM,
+    decimals: 8,
+    display_symbol: "oz t",
+    display_position: :suffix,
+    ui_decimals: 4,
+    display_units: {
+      oz_t: { scale: 1, symbol: "oz t", ui_decimals: 4 },
+      gram: { scale: "31.1035", symbol: "g", ui_decimals: 2 },
+      kg:   { scale: "0.0311035", symbol: "kg", ui_decimals: 5 }
+    },
+    default_display: :oz_t
+
+  # COPPER: Copper measured with metric-mass defaults.
+  # Fact: The tonne display uses 1 kg = 0.001 t.
+  # Fact: The pound display uses 1 kg = 2.2046226218 lb.
+  # Preset default: Uses kilograms as the default display unit for industrial inventory and warehouse-style workflows.
+  # Preset default: Uses 6 storage decimals as a high-precision preset default.
+  # Source: NIST metric and customary conversion guidance: https://www.nist.gov/pml/weights-and-measures/common-conversion-factors-ii
+  Amount.register :COPPER,
+    decimals: 6,
+    display_symbol: "kg",
+    display_position: :suffix,
+    ui_decimals: 3,
+    display_units: {
+      kg:    { scale: 1, symbol: "kg", ui_decimals: 3 },
+      tonne: { scale: "0.001", symbol: "t", ui_decimals: 6 },
+      lb:    { scale: "2.2046226218", symbol: "lb", ui_decimals: 2 }
+    },
+    default_display: :kg
+
+  # ALUMINUM: Aluminum measured with metric-mass defaults.
+  # Fact: The tonne display uses 1 kg = 0.001 t.
+  # Fact: The pound display uses 1 kg = 2.2046226218 lb.
+  # Preset default: Uses kilograms as the default display unit.
+  # Preset default: Uses 6 storage decimals as a high-precision preset default.
+  # Source: NIST metric and customary conversion guidance: https://www.nist.gov/pml/weights-and-measures/common-conversion-factors-ii
+  Amount.register :ALUMINUM,
+    decimals: 6,
+    display_symbol: "kg",
+    display_position: :suffix,
+    ui_decimals: 3,
+    display_units: {
+      kg:    { scale: 1, symbol: "kg", ui_decimals: 3 },
+      tonne: { scale: "0.001", symbol: "t", ui_decimals: 6 },
+      lb:    { scale: "2.2046226218", symbol: "lb", ui_decimals: 2 }
+    },
+    default_display: :kg
+
+  # NICKEL: Nickel measured with metric-mass defaults.
+  # Fact: The tonne display uses 1 kg = 0.001 t.
+  # Fact: The pound display uses 1 kg = 2.2046226218 lb.
+  # Preset default: Uses kilograms as the default display unit.
+  # Preset default: Uses 6 storage decimals as a high-precision preset default.
+  # Source: NIST metric and customary conversion guidance: https://www.nist.gov/pml/weights-and-measures/common-conversion-factors-ii
+  Amount.register :NICKEL,
+    decimals: 6,
+    display_symbol: "kg",
+    display_position: :suffix,
+    ui_decimals: 3,
+    display_units: {
+      kg:    { scale: 1, symbol: "kg", ui_decimals: 3 },
+      tonne: { scale: "0.001", symbol: "t", ui_decimals: 6 },
+      lb:    { scale: "2.2046226218", symbol: "lb", ui_decimals: 2 }
+    },
+    default_display: :kg
+
+  # ZINC: Zinc measured with metric-mass defaults.
+  # Fact: The tonne display uses 1 kg = 0.001 t.
+  # Fact: The pound display uses 1 kg = 2.2046226218 lb.
+  # Preset default: Uses kilograms as the default display unit.
+  # Preset default: Uses 6 storage decimals as a high-precision preset default.
+  # Source: NIST metric and customary conversion guidance: https://www.nist.gov/pml/weights-and-measures/common-conversion-factors-ii
+  Amount.register :ZINC,
+    decimals: 6,
+    display_symbol: "kg",
+    display_position: :suffix,
+    ui_decimals: 3,
+    display_units: {
+      kg:    { scale: 1, symbol: "kg", ui_decimals: 3 },
+      tonne: { scale: "0.001", symbol: "t", ui_decimals: 6 },
+      lb:    { scale: "2.2046226218", symbol: "lb", ui_decimals: 2 }
+    },
+    default_display: :kg
+
+  # BTC: Bitcoin.
+  # Fact: Uses 8 decimal places under the satoshi convention.
+  # Fact: The smallest commonly referenced unit is 1 satoshi = 0.00000001 BTC.
+  # Preset default: Adds mBTC and satoshi display units for wallet and fee-oriented UIs.
+  # Preset default: Uses a suffix symbol to avoid fiat-style ambiguity.
+  # Source: Bitcoin developer docs: https://developer.bitcoin.org/
+  Amount.register :BTC,
+    decimals: 8,
+    display_symbol: "BTC",
+    display_position: :suffix,
+    ui_decimals: 8,
+    display_units: {
+      btc:     { scale: 1, symbol: "BTC", ui_decimals: 8 },
+      mbtc:    { scale: "1000", symbol: "mBTC", ui_decimals: 5 },
+      satoshi: { scale: "100000000", symbol: "sat", ui_decimals: 0 }
+    },
+    default_display: :btc
+
+  # ETH: Ether.
+  # Fact: Uses 18 decimal places because 1 ETH = 10^18 wei.
+  # Fact: The gwei display unit uses 1 ETH = 10^9 gwei.
+  # Preset default: Adds gwei and wei display units because fee and gas tooling often surfaces those denominations.
+  # Preset default: Uses a suffix symbol to avoid fiat-style ambiguity.
+  # Source: Ethereum denomination docs: https://ethereum.org/en/developers/docs/intro-to-ether/
+  Amount.register :ETH,
+    decimals: 18,
+    display_symbol: "ETH",
+    display_position: :suffix,
+    ui_decimals: 6,
+    display_units: {
+      eth:  { scale: 1, symbol: "ETH", ui_decimals: 6 },
+      gwei: { scale: "1000000000", symbol: "gwei", ui_decimals: 0 },
+      wei:  { scale: "1000000000000000000", symbol: "wei", ui_decimals: 0 }
+    },
+    default_display: :eth
+
+  # USDT: Tether USDt.
+  # Fact: This preset assumes the widely used 6-decimal denomination used by the common ERC-20-style representation of USDT.
+  # Fact: USDT is multichain in practice, so chain-specific integrations should verify decimals against the concrete deployment they use.
+  # Preset default: Uses "$" as a stablecoin-style display default in English-oriented UIs.
+  # Source: Tether overview and supported-protocol context: https://tether.to/en/how-it-works
+  Amount.register :USDT,
+    decimals: 6,
+    display_symbol: "$",
+    display_position: :prefix,
+    ui_decimals: 2
+
+  # XRP: XRP.
+  # Fact: Uses 6 decimal places because XRP is precise to the nearest drop.
+  # Fact: The XRPL documents 1 drop = 0.000001 XRP.
+  # Preset default: Uses a suffix symbol to avoid fiat-style ambiguity.
+  # Source: XRPL currency formats: https://xrpl.org/currency-formats.html
+  Amount.register :XRP,
+    decimals: 6,
+    display_symbol: "XRP",
+    display_position: :suffix,
+    ui_decimals: 4
+
+  # BNB: BNB.
+  # Fact: Uses 18 decimal places under the wei-style denomination used across BNB EVM infrastructure.
+  # Preset default: Uses a suffix symbol to avoid fiat-style ambiguity.
+  # Source: BNB Chain denomination note: https://docs.bnbchain.org/bnb-greenfield/getting-started/general-faqs/
+  Amount.register :BNB,
+    decimals: 18,
+    display_symbol: "BNB",
+    display_position: :suffix,
+    ui_decimals: 4
+
+  # USDC: USD Coin.
+  # Fact: This preset uses the widely deployed 6-decimal denomination for USDC integrations.
+  # Preset default: Uses "$" as a stablecoin-style display default in English-oriented UIs.
+  # Source: Circle USDC overview: https://www.circle.com/usdc
+  Amount.register :USDC,
+    decimals: 6,
+    display_symbol: "$",
+    display_position: :prefix,
+    ui_decimals: 2
+
+  # SOL: Solana.
+  # Fact: Uses 9 decimal places because 1 SOL = 1,000,000,000 lamports.
+  # Preset default: Adds a lamport display unit because low-level Solana tooling often surfaces lamports directly.
+  # Source: Solana account structure docs: https://solana.com/docs/core/accounts/account-structure
+  Amount.register :SOL,
+    decimals: 9,
+    display_symbol: "SOL",
+    display_position: :suffix,
+    ui_decimals: 4,
+    display_units: {
+      sol:     { scale: 1, symbol: "SOL", ui_decimals: 4 },
+      lamport: { scale: "1000000000", symbol: "lamports", ui_decimals: 0 }
+    },
+    default_display: :sol
+
+  # TRX: TRON.
+  # Fact: Uses 6 decimal places because 1 TRX = 1,000,000 SUN.
+  # Preset default: Uses a suffix symbol to avoid fiat-style ambiguity.
+  # Source: TRON TRX docs: https://developers.tron.network/v3.7/docs/trx
+  Amount.register :TRX,
+    decimals: 6,
+    display_symbol: "TRX",
+    display_position: :suffix,
+    ui_decimals: 4
+
+  # DOGE: Dogecoin.
+  # Fact: Uses the 8-decimal Bitcoin-family denomination convention.
+  # Preset default: Uses a suffix symbol to avoid fiat-style ambiguity.
+  # Preset default: Uses 4 UI decimals by default to keep ordinary wallet-style values readable.
+  # Source: Dogecoin project site: https://dogecoin.com/
+  Amount.register :DOGE,
+    decimals: 8,
+    display_symbol: "DOGE",
+    display_position: :suffix,
+    ui_decimals: 4
+
+  # BCH: Bitcoin Cash.
+  # Fact: Uses the 8-decimal Bitcoin-family denomination convention.
+  # Preset default: Uses a suffix symbol to avoid fiat-style ambiguity.
+  # Source: Bitcoin Cash project site: https://bitcoincash.org/
+  Amount.register :BCH,
+    decimals: 8,
+    display_symbol: "BCH",
+    display_position: :suffix,
+    ui_decimals: 6
+
+  # ADA: Cardano.
+  # Fact: Uses 6 decimal places because 1 ADA = 1,000,000 lovelace.
+  # Preset default: Uses a suffix symbol to avoid fiat-style ambiguity.
+  # Source: Cardano developer docs: https://developers.cardano.org/docs/build/native-tokens/minting/
+  Amount.register :ADA,
+    decimals: 6,
+    display_symbol: "ADA",
+    display_position: :suffix,
+    ui_decimals: 4
+
+  # LINK: Chainlink.
+  # Fact: Uses the common ERC-20 18-decimal denomination convention for LINK.
+  # Preset default: Uses a suffix symbol to avoid fiat-style ambiguity.
+  # Source: Chainlink developer docs hub: https://docs.chain.link/
+  Amount.register :LINK,
+    decimals: 18,
+    display_symbol: "LINK",
+    display_position: :suffix,
+    ui_decimals: 4
+
+  # XLM: Stellar lumens.
+  # Fact: Uses 7 decimal places because 1 XLM = 10,000,000 stroops.
+  # Preset default: Uses a suffix symbol to avoid fiat-style ambiguity.
+  # Source: Stellar docs using stroops: https://developers.stellar.org/docs/tools/cli/stellar-cli
+  Amount.register :XLM,
+    decimals: 7,
+    display_symbol: "XLM",
+    display_position: :suffix,
+    ui_decimals: 4
+
+  # DAI: Dai stablecoin.
+  # Fact: Uses 18 decimal places according to the Dai token contract documentation.
+  # Preset default: Uses "$" as a stablecoin-style display default in English-oriented UIs.
+  # Source: Maker Dai detailed docs: https://docs.makerdao.com/smart-contract-modules/dai-module/dai-detailed-documentation
+  Amount.register :DAI,
+    decimals: 18,
+    display_symbol: "$",
+    display_position: :prefix,
+    ui_decimals: 2
+
+  # LTC: Litecoin.
+  # Fact: Uses the 8-decimal Bitcoin-family denomination convention.
+  # Preset default: Uses a suffix symbol to avoid fiat-style ambiguity.
+  # Source: Litecoin project site: https://litecoin.org/
+  Amount.register :LTC,
+    decimals: 8,
+    display_symbol: "LTC",
+    display_position: :suffix,
+    ui_decimals: 6

data/lib/generators/amount/active_record/templates/presets/crypto.fragment

@@ -0,0 +1,180 @@
+  # Registry overview:
+  # Large-Cap Crypto Assets:
+  # - This preset is a curated basket of prominent crypto assets intended for developer-facing ledgers and wallet-style products.
+  # - It is not a literal mirror of any single market-cap top-20 list; the basket favors assets with broadly understood denomination conventions and common integration relevance.
+  # - Where an asset is multichain, the preset documents the denomination convention the initializer assumes.
+  # - Source: Large-cap market snapshot used as a selection input on April 24, 2026: https://coinmarketcap.com/historical/20260424/
+
+  # BTC: Bitcoin.
+  # Fact: Uses 8 decimal places under the satoshi convention.
+  # Fact: The smallest commonly referenced unit is 1 satoshi = 0.00000001 BTC.
+  # Preset default: Adds mBTC and satoshi display units for wallet and fee-oriented UIs.
+  # Preset default: Uses a suffix symbol to avoid fiat-style ambiguity.
+  # Source: Bitcoin developer docs: https://developer.bitcoin.org/
+  Amount.register :BTC,
+    decimals: 8,
+    display_symbol: "BTC",
+    display_position: :suffix,
+    ui_decimals: 8,
+    display_units: {
+      btc:     { scale: 1, symbol: "BTC", ui_decimals: 8 },
+      mbtc:    { scale: "1000", symbol: "mBTC", ui_decimals: 5 },
+      satoshi: { scale: "100000000", symbol: "sat", ui_decimals: 0 }
+    },
+    default_display: :btc
+
+  # ETH: Ether.
+  # Fact: Uses 18 decimal places because 1 ETH = 10^18 wei.
+  # Fact: The gwei display unit uses 1 ETH = 10^9 gwei.
+  # Preset default: Adds gwei and wei display units because fee and gas tooling often surfaces those denominations.
+  # Preset default: Uses a suffix symbol to avoid fiat-style ambiguity.
+  # Source: Ethereum denomination docs: https://ethereum.org/en/developers/docs/intro-to-ether/
+  Amount.register :ETH,
+    decimals: 18,
+    display_symbol: "ETH",
+    display_position: :suffix,
+    ui_decimals: 6,
+    display_units: {
+      eth:  { scale: 1, symbol: "ETH", ui_decimals: 6 },
+      gwei: { scale: "1000000000", symbol: "gwei", ui_decimals: 0 },
+      wei:  { scale: "1000000000000000000", symbol: "wei", ui_decimals: 0 }
+    },
+    default_display: :eth
+
+  # USDT: Tether USDt.
+  # Fact: This preset assumes the widely used 6-decimal denomination used by the common ERC-20-style representation of USDT.
+  # Fact: USDT is multichain in practice, so chain-specific integrations should verify decimals against the concrete deployment they use.
+  # Preset default: Uses "$" as a stablecoin-style display default in English-oriented UIs.
+  # Source: Tether overview and supported-protocol context: https://tether.to/en/how-it-works
+  Amount.register :USDT,
+    decimals: 6,
+    display_symbol: "$",
+    display_position: :prefix,
+    ui_decimals: 2
+
+  # XRP: XRP.
+  # Fact: Uses 6 decimal places because XRP is precise to the nearest drop.
+  # Fact: The XRPL documents 1 drop = 0.000001 XRP.
+  # Preset default: Uses a suffix symbol to avoid fiat-style ambiguity.
+  # Source: XRPL currency formats: https://xrpl.org/currency-formats.html
+  Amount.register :XRP,
+    decimals: 6,
+    display_symbol: "XRP",
+    display_position: :suffix,
+    ui_decimals: 4
+
+  # BNB: BNB.
+  # Fact: Uses 18 decimal places under the wei-style denomination used across BNB EVM infrastructure.
+  # Preset default: Uses a suffix symbol to avoid fiat-style ambiguity.
+  # Source: BNB Chain denomination note: https://docs.bnbchain.org/bnb-greenfield/getting-started/general-faqs/
+  Amount.register :BNB,
+    decimals: 18,
+    display_symbol: "BNB",
+    display_position: :suffix,
+    ui_decimals: 4
+
+  # USDC: USD Coin.
+  # Fact: This preset uses the widely deployed 6-decimal denomination for USDC integrations.
+  # Preset default: Uses "$" as a stablecoin-style display default in English-oriented UIs.
+  # Source: Circle USDC overview: https://www.circle.com/usdc
+  Amount.register :USDC,
+    decimals: 6,
+    display_symbol: "$",
+    display_position: :prefix,
+    ui_decimals: 2
+
+  # SOL: Solana.
+  # Fact: Uses 9 decimal places because 1 SOL = 1,000,000,000 lamports.
+  # Preset default: Adds a lamport display unit because low-level Solana tooling often surfaces lamports directly.
+  # Source: Solana account structure docs: https://solana.com/docs/core/accounts/account-structure
+  Amount.register :SOL,
+    decimals: 9,
+    display_symbol: "SOL",
+    display_position: :suffix,
+    ui_decimals: 4,
+    display_units: {
+      sol:     { scale: 1, symbol: "SOL", ui_decimals: 4 },
+      lamport: { scale: "1000000000", symbol: "lamports", ui_decimals: 0 }
+    },
+    default_display: :sol
+
+  # TRX: TRON.
+  # Fact: Uses 6 decimal places because 1 TRX = 1,000,000 SUN.
+  # Preset default: Uses a suffix symbol to avoid fiat-style ambiguity.
+  # Source: TRON TRX docs: https://developers.tron.network/v3.7/docs/trx
+  Amount.register :TRX,
+    decimals: 6,
+    display_symbol: "TRX",
+    display_position: :suffix,
+    ui_decimals: 4
+
+  # DOGE: Dogecoin.
+  # Fact: Uses the 8-decimal Bitcoin-family denomination convention.
+  # Preset default: Uses a suffix symbol to avoid fiat-style ambiguity.
+  # Preset default: Uses 4 UI decimals by default to keep ordinary wallet-style values readable.
+  # Source: Dogecoin project site: https://dogecoin.com/
+  Amount.register :DOGE,
+    decimals: 8,
+    display_symbol: "DOGE",
+    display_position: :suffix,
+    ui_decimals: 4
+
+  # BCH: Bitcoin Cash.
+  # Fact: Uses the 8-decimal Bitcoin-family denomination convention.
+  # Preset default: Uses a suffix symbol to avoid fiat-style ambiguity.
+  # Source: Bitcoin Cash project site: https://bitcoincash.org/
+  Amount.register :BCH,
+    decimals: 8,
+    display_symbol: "BCH",
+    display_position: :suffix,
+    ui_decimals: 6
+
+  # ADA: Cardano.
+  # Fact: Uses 6 decimal places because 1 ADA = 1,000,000 lovelace.
+  # Preset default: Uses a suffix symbol to avoid fiat-style ambiguity.
+  # Source: Cardano developer docs: https://developers.cardano.org/docs/build/native-tokens/minting/
+  Amount.register :ADA,
+    decimals: 6,
+    display_symbol: "ADA",
+    display_position: :suffix,
+    ui_decimals: 4
+
+  # LINK: Chainlink.
+  # Fact: Uses the common ERC-20 18-decimal denomination convention for LINK.
+  # Preset default: Uses a suffix symbol to avoid fiat-style ambiguity.
+  # Source: Chainlink developer docs hub: https://docs.chain.link/
+  Amount.register :LINK,
+    decimals: 18,
+    display_symbol: "LINK",
+    display_position: :suffix,
+    ui_decimals: 4
+
+  # XLM: Stellar lumens.
+  # Fact: Uses 7 decimal places because 1 XLM = 10,000,000 stroops.
+  # Preset default: Uses a suffix symbol to avoid fiat-style ambiguity.
+  # Source: Stellar docs using stroops: https://developers.stellar.org/docs/tools/cli/stellar-cli
+  Amount.register :XLM,
+    decimals: 7,
+    display_symbol: "XLM",
+    display_position: :suffix,
+    ui_decimals: 4
+
+  # DAI: Dai stablecoin.
+  # Fact: Uses 18 decimal places according to the Dai token contract documentation.
+  # Preset default: Uses "$" as a stablecoin-style display default in English-oriented UIs.
+  # Source: Maker Dai detailed docs: https://docs.makerdao.com/smart-contract-modules/dai-module/dai-detailed-documentation
+  Amount.register :DAI,
+    decimals: 18,
+    display_symbol: "$",
+    display_position: :prefix,
+    ui_decimals: 2
+
+  # LTC: Litecoin.
+  # Fact: Uses the 8-decimal Bitcoin-family denomination convention.
+  # Preset default: Uses a suffix symbol to avoid fiat-style ambiguity.
+  # Source: Litecoin project site: https://litecoin.org/
+  Amount.register :LTC,
+    decimals: 8,
+    display_symbol: "LTC",
+    display_position: :suffix,
+    ui_decimals: 6