@xyo-network/xl1-protocol 1.25.26 → 1.25.28

package/src/viewers/WindowedBlock.ts

@@ -6,13 +6,17 @@ import type { BlockViewerMethods } from './Block.ts'
 
 type ExtendableBlockViewerMethods = Omit<BlockViewerMethods, 'rate' | 'stepSizeRate' | 'timeDurationRate'>
 
+/** WindowedBlockViewerMethods interface. */
 export interface WindowedBlockViewerMethods extends ExtendableBlockViewerMethods {
   blocksByTransactionHashes(hashes: Hash[]): Promisable<HydratedBlockWithHashMeta[]>
 }
 
+/** Moniker identifier for the WindowedBlockViewer provider. */
 export const WindowedBlockViewerMoniker = 'WindowedBlockViewer' as const
+/** Type literal for the WindowedBlockViewer provider moniker. */
 export type WindowedBlockViewerMoniker = typeof WindowedBlockViewerMoniker
 
+/** Viewer interface for reading WindowedBlock data. */
 export interface WindowedBlockViewer<TMoniker extends ProviderMoniker = WindowedBlockViewerMoniker> extends WindowedBlockViewerMethods, Provider<TMoniker> {
   blockByTransactionHash(hash: Hash): Promisable<HydratedBlockWithHashMeta | null>
 }

package/src/viewers/XyoViewer.ts

@@ -16,6 +16,7 @@ import type { StepViewer } from './StepViewer.ts'
 import type { TimeSyncViewer } from './TimeSync.ts'
 import type { TransactionViewer, TransactionViewerMethods } from './Transaction.ts'
 
+/** XyoViewerMethods interface. */
 export interface XyoViewerMethods extends
   NetworkStakeStepRewardViewerMethods, BlockViewerMethods,
   Omit<TransactionViewerMethods, 'byHash'>, Omit<
@@ -28,13 +29,17 @@ export interface XyoViewerMethods extends
   accountBalanceHistory(address: Address, config?: ChainQualifiedConfig): Promisable<AccountBalanceHistoryItem[]>
 }
 
+/** XyoViewerMethodsV2 interface. */
 export interface XyoViewerMethodsV2 {
 
 }
 
+/** Moniker identifier for the XyoViewer provider. */
 export const XyoViewerMoniker = 'XyoViewer' as const
+/** Type literal for the XyoViewer provider moniker. */
 export type XyoViewerMoniker = typeof XyoViewerMoniker
 
+/** Viewer interface for reading Xyo data. */
 export interface XyoViewer extends Omit<BlockViewer, 'moniker'>, XyoViewerMethods,
   Omit<
     StakeViewerMethods, 'moniker' | 'minWithdrawalBlocks' | 'rewardsContract' | 'stakingTokenAddress' | 'active'
@@ -53,6 +58,7 @@ export interface XyoViewer extends Omit<BlockViewer, 'moniker'>, XyoViewerMethod
   transaction: TransactionViewer
 }
 
+/** XyoViewerV2 interface. */
 export interface XyoViewerV2 extends XyoViewerMethodsV2, Provider<XyoViewerMoniker> {
   account: {
     balance: AccountBalanceViewer

package/src/xl1/AttoXL1.ts

@@ -4,10 +4,16 @@ import {
 import { xl1MaxValue } from './xl1MaxValue.ts'
 import { XL1Places } from './XL1Units.ts'
 
+/** Maximum value for the AttoXL1 branded type. */
 export const AttoXL1MaxValue = xl1MaxValue(XL1Places.atto)
+/** AttoXL1 type. */
 export type AttoXL1 = bigint & { readonly _tag: 'AttoXL1' }
+/** Type guard that checks if a value is a valid AttoXL1. */
 export const isAttoXL1 = isXL1Factory<AttoXL1>(XL1Places.atto)
+/** Converts a value to AttoXL1, throwing if invalid. */
 export const asAttoXL1 = asXL1Factory<AttoXL1>(XL1Places.atto)
+/** Converts a bigint value to AttoXL1 without validation. */
 export const toAttoXL1 = toXL1Factory<AttoXL1>(XL1Places.atto)
 
+/** Shorthand alias for asAttoXL1. */
 export const AttoXL1 = asAttoXL1

package/src/xl1/FemtoXL1.ts

@@ -4,11 +4,17 @@ import {
 import { xl1MaxValue } from './xl1MaxValue.ts'
 import { XL1Places } from './XL1Units.ts'
 
+/** Maximum value for the FemtoXL1 branded type. */
 export const FemtoXL1MaxValue = xl1MaxValue(XL1Places.femto)
+/** FemtoXL1 type. */
 export type FemtoXL1 = bigint & { readonly _tag: 'FemtoXL1' }
+/** Type guard that checks if a value is a valid FemtoXL1. */
 export const isFemtoXL1 = isXL1Factory<FemtoXL1>(XL1Places.femto)
+/** Converts a value to FemtoXL1, throwing if invalid. */
 export const asFemtoXL1 = asXL1Factory<FemtoXL1>(XL1Places.femto)
 
+/** Converts a bigint value to FemtoXL1 without validation. */
 export const toFemtoXL1 = toXL1Factory<FemtoXL1>(XL1Places.femto)
 
+/** Shorthand alias for asFemtoXL1. */
 export const FemtoXL1 = asFemtoXL1

package/src/xl1/MicroXL1.ts

@@ -4,11 +4,17 @@ import {
 import { xl1MaxValue } from './xl1MaxValue.ts'
 import { XL1Places } from './XL1Units.ts'
 
+/** Maximum value for the MicroXL1 branded type. */
 export const MicroXL1MaxValue = xl1MaxValue(XL1Places.micro)
+/** MicroXL1 type. */
 export type MicroXL1 = bigint & { readonly _tag: 'MicroXL1' }
+/** Type guard that checks if a value is a valid MicroXL1. */
 export const isMicroXL1 = isXL1Factory<MicroXL1>(XL1Places.micro)
+/** Converts a value to MicroXL1, throwing if invalid. */
 export const asMicroXL1 = asXL1Factory<MicroXL1>(XL1Places.micro)
 
+/** Converts a bigint value to MicroXL1 without validation. */
 export const toMicroXL1 = toXL1Factory<MicroXL1>(XL1Places.micro)
 
+/** Shorthand alias for asMicroXL1. */
 export const MicroXL1 = asMicroXL1

package/src/xl1/MilliXL1.ts

@@ -4,11 +4,17 @@ import {
 import { xl1MaxValue } from './xl1MaxValue.ts'
 import { XL1Places } from './XL1Units.ts'
 
+/** Maximum value for the MilliXL1 branded type. */
 export const MilliXL1MaxValue = xl1MaxValue(XL1Places.milli)
+/** MilliXL1 type. */
 export type MilliXL1 = bigint & { readonly _tag: 'MilliXL1' }
+/** Type guard that checks if a value is a valid MilliXL1. */
 export const isMilliXL1 = isXL1Factory<MilliXL1>(XL1Places.milli)
+/** Converts a value to MilliXL1, throwing if invalid. */
 export const asMilliXL1 = asXL1Factory<MilliXL1>(XL1Places.milli)
 
+/** Converts a bigint value to MilliXL1 without validation. */
 export const toMilliXL1 = toXL1Factory<MilliXL1>(XL1Places.milli)
 
+/** Shorthand alias for asMilliXL1. */
 export const MilliXL1 = asMilliXL1

package/src/xl1/NanoXL1.ts

@@ -4,11 +4,17 @@ import {
 import { xl1MaxValue } from './xl1MaxValue.ts'
 import { XL1Places } from './XL1Units.ts'
 
+/** Maximum value for the NanoXL1 branded type. */
 export const NanoXL1MaxValue = xl1MaxValue(XL1Places.nano)
+/** NanoXL1 type. */
 export type NanoXL1 = bigint & { readonly _tag: 'NanoXL1' }
+/** Type guard that checks if a value is a valid NanoXL1. */
 export const isNanoXL1 = isXL1Factory<NanoXL1>(XL1Places.nano)
+/** Converts a value to NanoXL1, throwing if invalid. */
 export const asNanoXL1 = asXL1Factory<NanoXL1>(XL1Places.nano)
 
+/** Converts a bigint value to NanoXL1 without validation. */
 export const toNanoXL1 = toXL1Factory<NanoXL1>(XL1Places.nano)
 
+/** Shorthand alias for asNanoXL1. */
 export const NanoXL1 = asNanoXL1

package/src/xl1/PicoXL1.ts

@@ -4,11 +4,17 @@ import {
 import { xl1MaxValue } from './xl1MaxValue.ts'
 import { XL1Places } from './XL1Units.ts'
 
+/** PicoXL1MaxValue constant. */
 export const PicoXL1MaxValue = xl1MaxValue(XL1Places.pico)
+/** PicoXL1 type. */
 export type PicoXL1 = bigint & { readonly _tag: 'PicoXL1' }
+/** Type guard that checks if a value is a valid PicoXL1. */
 export const isPicoXL1 = isXL1Factory<PicoXL1>(XL1Places.pico)
+/** Converts a value to PicoXL1, throwing if invalid. */
 export const asPicoXL1 = asXL1Factory<PicoXL1>(XL1Places.pico)
 
+/** toPicoXL1 constant. */
 export const toPicoXL1 = toXL1Factory<PicoXL1>(XL1Places.pico)
 
+/** PicoXL1 constant. */
 export const PicoXL1 = asPicoXL1

package/src/xl1/XL1.ts

@@ -4,11 +4,17 @@ import {
 import { xl1MaxValue } from './xl1MaxValue.ts'
 import { XL1Places } from './XL1Units.ts'
 
+/** XL1MaxValue constant. */
 export const XL1MaxValue = xl1MaxValue(XL1Places.xl1)
+/** XL1 type. */
 export type XL1 = bigint & { readonly _tag: 'XL1' }
+/** Type guard that checks if a value is a valid XL1. */
 export const isXL1 = isXL1Factory<XL1>(XL1Places.xl1)
+/** Converts a value to XL1, throwing if invalid. */
 export const asXL1 = asXL1Factory<XL1>(XL1Places.xl1)
 
+/** toXL1 constant. */
 export const toXL1 = toXL1Factory<XL1>(XL1Places.xl1)
 
+/** XL1 constant. */
 export const XL1 = asXL1

package/src/xl1/XL1Units.ts

@@ -1,5 +1,6 @@
 type XL1Units = 'xl1' | 'milli' | 'micro' | 'nano' | 'pico' | 'femto' | 'atto'
 
+/** Decimal place definitions for each XL1 currency unit (atto=18, femto=15, etc.). */
 export const XL1Places: Record<XL1Units, bigint> = {
   xl1: 18n,
   milli: 15n,

package/src/xl1/isXL1Factory.ts

@@ -2,11 +2,13 @@ import { z } from 'zod'
 
 import { xl1MaxValue } from './xl1MaxValue.ts'
 
+/** Type guard that checks if a value is a valid XL1Factory. */
 export const isXL1Factory = <T extends bigint>(places: bigint) => (val: unknown): val is T => {
   if (typeof val !== 'bigint') return false
   return val >= 0n && val <= xl1MaxValue(places)
 }
 
+/** Creates a Zod schema factory for XL1 branded bigint types. */
 export const XL1ZodFactory = <T extends bigint>(places: bigint, name: string) => {
   const is = isXL1Factory<T>(places)
   const message = `Invalid value for ${name}, must be between 0 and ${xl1MaxValue(places)}`
@@ -19,6 +21,7 @@ export const XL1ZodFactory = <T extends bigint>(places: bigint, name: string) =>
   )
 }
 
+/** Creates a Zod transform factory that converts values between XL1 unit types. */
 export const XL1TransformZodFactory = <T extends bigint>(places: bigint, name: string) => {
   const is = isXL1Factory<T>(places)
   const message = `Invalid value for ${name}, must be between 0 and ${xl1MaxValue(places)}`
@@ -31,6 +34,7 @@ export const XL1TransformZodFactory = <T extends bigint>(places: bigint, name: s
   )
 }
 
+/** Converts a value to XL1Factory, throwing if invalid. */
 export const asXL1Factory = <T extends bigint>(places: bigint) => {
   const zod = XL1ZodFactory<T>(places, 'local')
   return (val: unknown): T => {
@@ -42,6 +46,7 @@ export const asXL1Factory = <T extends bigint>(places: bigint) => {
   }
 }
 
+/** Creates a factory function that converts bigint values to a specific XL1 branded type. */
 export const toXL1Factory = <T extends bigint>(places: bigint) => {
   const zod = XL1TransformZodFactory<T>(places, 'local')
   return (val: unknown): T | undefined => {

package/src/xl1/xl1MaxValue.ts

@@ -1 +1,2 @@
+/** Computes the maximum value for an XL1 unit given its decimal places. */
 export const xl1MaxValue = (places: bigint) => 10n ** (32n - places) - 1n

package/dist/neutral/amount/ShiftedBigInt.d.ts

@@ -1,16 +0,0 @@
-import type { ShiftedBigIntConfig } from './ShiftedBigIntConfig.ts';
-export declare class ShiftedBigInt {
-    static readonly defaultConfig: ShiftedBigIntConfig;
-    config: ShiftedBigIntConfig;
-    value: bigint;
-    constructor(value: bigint | ShiftedBigInt, config?: Partial<ShiftedBigIntConfig>);
-    get locale(): Intl.LocalesArgument;
-    get maxCharacters(): number;
-    get maxDecimal(): number;
-    get minDecimals(): number;
-    get places(): number;
-    toFullString(): string;
-    toShortString(): string;
-    toString(): string;
-}
-//# sourceMappingURL=ShiftedBigInt.d.ts.map

package/dist/neutral/amount/ShiftedBigInt.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ShiftedBigInt.d.ts","sourceRoot":"","sources":["../../../src/amount/ShiftedBigInt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAGnE,qBAAa,aAAa;IACxB,MAAM,CAAC,QAAQ,CAAC,aAAa,EAAE,mBAAmB,CAMjD;IAED,MAAM,EAAE,mBAAmB,CAAA;IAC3B,KAAK,EAAE,MAAM,CAAA;gBAGX,KAAK,EAAE,MAAM,GAAG,aAAa,EAC7B,MAAM,GAAE,OAAO,CAAC,mBAAmB,CAAM;IAQ3C,IAAI,MAAM,IAAI,IAAI,CAAC,eAAe,CAEjC;IAED,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,YAAY,IAAI,MAAM;IAWtB,aAAa,IAAI,MAAM;IAWvB,QAAQ,IAAI,MAAM;CAGnB"}

package/dist/neutral/amount/XL1Amount.d.ts

@@ -1,37 +0,0 @@
-import { AttoXL1, FemtoXL1, MicroXL1, MilliXL1, NanoXL1, PicoXL1, XL1 } from '../xl1/index.ts';
-import type { ShiftedBigIntConfig } from './ShiftedBigIntConfig.ts';
-export interface XL1AmountInstance {
-    value: AttoXL1;
-    to(places: bigint | number): bigint;
-    milli: MilliXL1;
-    micro: MicroXL1;
-    nano: NanoXL1;
-    pico: PicoXL1;
-    femto: FemtoXL1;
-    atto: AttoXL1;
-    xl1: XL1;
-    toString(places: number, config: Partial<ShiftedBigIntConfig>): string;
-}
-export declare class XL1Amount implements XL1AmountInstance {
-    value: AttoXL1;
-    private locale;
-    constructor(value: bigint, locale?: Intl.LocalesArgument);
-    static from(value: bigint, places?: bigint): XL1Amount;
-    static fromMilli(value: MilliXL1): XL1Amount;
-    static fromMicro(value: MicroXL1): XL1Amount;
-    static fromNano(value: NanoXL1): XL1Amount;
-    static fromPico(value: PicoXL1): XL1Amount;
-    static fromFemto(value: FemtoXL1): XL1Amount;
-    static fromAtto(value: AttoXL1): XL1Amount;
-    static fromXL1(value: XL1): XL1Amount;
-    to(places?: number | bigint): bigint;
-    get milli(): MilliXL1;
-    get micro(): MicroXL1;
-    get nano(): NanoXL1;
-    get pico(): PicoXL1;
-    get femto(): FemtoXL1;
-    get atto(): AttoXL1;
-    get xl1(): XL1;
-    toString(places?: number, config?: Partial<ShiftedBigIntConfig>): string;
-}
-//# sourceMappingURL=XL1Amount.d.ts.map

package/dist/neutral/amount/XL1Amount.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"XL1Amount.d.ts","sourceRoot":"","sources":["../../../src/amount/XL1Amount.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAE7D,MAAM,iBAAiB,CAAA;AAExB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAKnE,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,OAAO,CAAA;IAEd,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;IAEnC,KAAK,EAAE,QAAQ,CAAA;IAEf,KAAK,EAAE,QAAQ,CAAA;IAEf,IAAI,EAAE,OAAO,CAAA;IAEb,IAAI,EAAE,OAAO,CAAA;IAEb,KAAK,EAAE,QAAQ,CAAA;IAEf,IAAI,EAAE,OAAO,CAAA;IAEb,GAAG,EAAE,GAAG,CAAA;IAER,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,MAAM,CAAA;CACvE;AAED,qBAAa,SAAU,YAAW,iBAAiB;IACjD,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,CAAC,MAAM,CAAsB;gBAExB,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,IAAI,CAAC,eAAyB;IAKjE,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,MAAuB;IAK1D,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,QAAQ;IAIhC,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,QAAQ;IAIhC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO;IAI9B,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO;IAI9B,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,QAAQ;IAIhC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO;IAI9B,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;IAIzB,EAAE,CAAC,MAAM,GAAE,MAAM,GAAG,MAAuB;IAI3C,IAAI,KAAK,aAER;IAED,IAAI,KAAK,aAER;IAED,IAAI,IAAI,YAEP;IAED,IAAI,IAAI,YAEP;IAED,IAAI,KAAK,aAER;IAED,IAAI,IAAI,YAEP;IAED,IAAI,GAAG,QAEN;IAED,QAAQ,CAAC,MAAM,GAAE,MAA+B,EAAE,MAAM,GAAE,OAAO,CAAC,mBAAmB,CAAM,GAAG,MAAM;CAcrG"}

package/dist/neutral/amount/splitOnDecimal.d.ts

@@ -1,2 +0,0 @@
-export declare const splitOnDecimal: (value: bigint, places?: number) => [bigint, bigint];
-//# sourceMappingURL=splitOnDecimal.d.ts.map

package/dist/neutral/amount/splitOnDecimal.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"splitOnDecimal.d.ts","sourceRoot":"","sources":["../../../src/amount/splitOnDecimal.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,EAAE,eAAW,KAAG,CAAC,MAAM,EAAE,MAAM,CAI1E,CAAA"}

package/dist/neutral/amount/splitOnDecimalToString.d.ts

@@ -1,2 +0,0 @@
-export declare const splitOnDecimalToString: (value: bigint, places?: number, maxDecimal?: number, maxCharacters?: number, minDecimals?: number, locale?: Intl.LocalesArgument) => string;
-//# sourceMappingURL=splitOnDecimalToString.d.ts.map

package/dist/neutral/amount/splitOnDecimalToString.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"splitOnDecimalToString.d.ts","sourceRoot":"","sources":["../../../src/amount/splitOnDecimalToString.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,sBAAsB,GACjC,OAAO,MAAM,EACb,eAAW,EACX,mBAAmB,EACnB,sBAAiB,EACjB,oBAAe,EACf,SAAQ,IAAI,CAAC,eAAyB,KACrC,MA6BF,CAAA"}

package/src/amount/ShiftedBigInt.ts

@@ -1,71 +0,0 @@
-import type { ShiftedBigIntConfig } from './ShiftedBigIntConfig.ts'
-import { splitOnDecimalToString } from './splitOnDecimalToString.ts'
-
-export class ShiftedBigInt {
-  static readonly defaultConfig: ShiftedBigIntConfig = {
-    places: 18,
-    maxDecimal: 18,
-    maxCharacters: 9,
-    minDecimals: 1,
-    locale: 'en-US',
-  }
-
-  config: ShiftedBigIntConfig
-  value: bigint
-
-  constructor(
-    value: bigint | ShiftedBigInt,
-    config: Partial<ShiftedBigIntConfig> = {},
-  ) {
-    this.value = typeof value === 'bigint' ? value : value.value
-    this.config = {
-      ...ShiftedBigInt.defaultConfig, ...(typeof value === 'bigint' ? {} : value.config), ...config,
-    }
-  }
-
-  get locale(): Intl.LocalesArgument {
-    return this.config.locale ?? 'en-US'
-  }
-
-  get maxCharacters(): number {
-    return this.config.maxCharacters ?? 9
-  }
-
-  get maxDecimal(): number {
-    return this.config.maxDecimal ?? this.places
-  }
-
-  get minDecimals(): number {
-    return this.config.minDecimals ?? 1
-  }
-
-  get places(): number {
-    return this.config.places ?? 18
-  }
-
-  toFullString(): string {
-    return splitOnDecimalToString(
-      this.value,
-      this.places,
-      this.places,
-      Infinity,
-      this.places,
-      this.locale,
-    )
-  }
-
-  toShortString(): string {
-    return splitOnDecimalToString(
-      this.value,
-      this.places,
-      this.maxDecimal,
-      this.maxCharacters,
-      this.minDecimals,
-      this.locale,
-    )
-  }
-
-  toString(): string {
-    return this.toFullString()
-  }
-}

package/src/amount/XL1Amount.ts

@@ -1,124 +0,0 @@
-/* eslint-disable @typescript-eslint/member-ordering */
-import { assertEx } from '@xylabs/sdk-js'
-
-import {
-  AttoXL1, FemtoXL1, MicroXL1, MilliXL1, NanoXL1, PicoXL1, XL1,
-  XL1Places,
-} from '../xl1/index.ts'
-import { ShiftedBigInt } from './ShiftedBigInt.ts'
-import type { ShiftedBigIntConfig } from './ShiftedBigIntConfig.ts'
-
-const MAX_XL1_AMOUNT = 2n ** 256n - 1n
-const allowedPlaces = Object.values(XL1Places)
-
-export interface XL1AmountInstance {
-  value: AttoXL1
-
-  to(places: bigint | number): bigint
-
-  milli: MilliXL1
-
-  micro: MicroXL1
-
-  nano: NanoXL1
-
-  pico: PicoXL1
-
-  femto: FemtoXL1
-
-  atto: AttoXL1
-
-  xl1: XL1
-
-  toString(places: number, config: Partial<ShiftedBigIntConfig>): string
-}
-
-export class XL1Amount implements XL1AmountInstance {
-  value: AttoXL1
-  private locale: Intl.LocalesArgument
-
-  constructor(value: bigint, locale: Intl.LocalesArgument = 'en-US') {
-    this.locale = locale
-    this.value = AttoXL1(value > MAX_XL1_AMOUNT ? MAX_XL1_AMOUNT : value < 0n ? 0n : value)
-  }
-
-  static from(value: bigint, places: bigint = XL1Places.atto) {
-    assertEx(allowedPlaces.includes(places), () => `Invalid conversion places (${places} not in ${allowedPlaces})`)
-    return new XL1Amount(value * 10n ** BigInt(places))
-  }
-
-  static fromMilli(value: MilliXL1) {
-    return this.from(value, XL1Places.milli)
-  }
-
-  static fromMicro(value: MicroXL1) {
-    return this.from(value, XL1Places.micro)
-  }
-
-  static fromNano(value: NanoXL1) {
-    return this.from(value, XL1Places.nano)
-  }
-
-  static fromPico(value: PicoXL1) {
-    return this.from(value, XL1Places.pico)
-  }
-
-  static fromFemto(value: FemtoXL1) {
-    return this.from(value, XL1Places.femto)
-  }
-
-  static fromAtto(value: AttoXL1) {
-    return this.from(value, XL1Places.atto)
-  }
-
-  static fromXL1(value: XL1) {
-    return this.from(value, XL1Places.xl1)
-  }
-
-  to(places: number | bigint = XL1Places.atto) {
-    return this.value / 10n ** BigInt(places)
-  }
-
-  get milli() {
-    return MilliXL1(this.to(XL1Places.milli))
-  }
-
-  get micro() {
-    return MicroXL1(this.to(XL1Places.micro))
-  }
-
-  get nano() {
-    return NanoXL1(this.to(XL1Places.nano))
-  }
-
-  get pico() {
-    return PicoXL1(this.to(XL1Places.pico))
-  }
-
-  get femto() {
-    return FemtoXL1(this.to(XL1Places.femto))
-  }
-
-  get atto() {
-    return AttoXL1(this.to(XL1Places.atto))
-  }
-
-  get xl1() {
-    return XL1(this.to(XL1Places.xl1))
-  }
-
-  toString(places: number = Number(XL1Places.atto), config: Partial<ShiftedBigIntConfig> = {}): string {
-    assertEx(allowedPlaces.includes(BigInt(places)), () => `Invalid conversion places (${places} not in ${allowedPlaces})`)
-    return new ShiftedBigInt(
-      this.value,
-      {
-        places,
-        locale: this.locale,
-        maxDecimal: places,
-        minDecimals: 0,
-        maxCharacters: places,
-        ...config,
-      },
-    ).toShortString()
-  }
-}

package/src/amount/splitOnDecimal.ts

@@ -1,5 +0,0 @@
-export const splitOnDecimal = (value: bigint, places = 18): [bigint, bigint] => {
-  const whole = value / BigInt(10 ** places)
-  const decimal = value % BigInt(10 ** places)
-  return [whole, decimal]
-}

package/src/amount/splitOnDecimalToString.ts

@@ -1,39 +0,0 @@
-import { splitOnDecimal } from './splitOnDecimal.ts'
-
-export const splitOnDecimalToString = (
-  value: bigint,
-  places = 18,
-  maxDecimal = places,
-  maxCharacters = 9,
-  minDecimals = 1,
-  locale: Intl.LocalesArgument = 'en-US',
-): string => {
-  const [whole, decimal] = splitOnDecimal(value, places)
-  const remainderLength = decimal.toString().length
-  const precedingZerosInDecimal = places - remainderLength
-  if (whole === 0n && precedingZerosInDecimal >= maxDecimal && decimal !== 0n) return '< 0.'.padEnd(maxDecimal + 5, '0') + '1'
-
-  const wholeCharacters = whole.toString(10).length
-  const calcMaxDecimalCharacters = maxCharacters === -1 ? places : wholeCharacters > maxCharacters ? 0 : maxCharacters - wholeCharacters
-  const maxDecimalCharacters = Math.min(maxDecimal, calcMaxDecimalCharacters)
-
-  // Format whole number with thousand separators according to locale
-  const formattedWhole = new Intl.NumberFormat(locale, {
-    maximumFractionDigits: 0,
-    useGrouping: true,
-  }).format(whole)
-
-  // Get decimal separator for the locale
-  const decimalSeparator = new Intl.NumberFormat(locale)
-    .formatToParts(1.1)
-    .find(part => part.type === 'decimal')?.value ?? '.'
-
-  // Pad decimal part to correct number of places
-  let paddedDecimal = decimal.toString().padStart(places, '0').slice(0, maxDecimalCharacters)
-  // remove unneeded trailing zeros (honoring minDecimals)
-  while (paddedDecimal.length > minDecimals && paddedDecimal.endsWith('0')) {
-    paddedDecimal = paddedDecimal.slice(0, -1)
-  }
-
-  return `${formattedWhole}${paddedDecimal.length > 0 ? decimalSeparator : ''}${paddedDecimal}`
-}