stability-nexus

Stability Nexus multi-protocol simulation library.

Installation

pip install stability-nexus

Quick Start

from stability_nexus.gluon.reactors import GluonZReactor
from stability_nexus.gluon.reactors.types import (
    GluonReaction,
    GluonZReactorParameters,
    GluonZReactorState,
    Tokeons,
)

# Configure reactor parameters
params = GluonZReactorParameters(
    critical_neutron_ratio=0.5,
    fission_fee=0.01,
    fusion_fee=0.01,
    beta_decay_fee_slope=0.1,
    beta_decay_fee_intercept=0.005,
    volume_decay_factor=0.99,
)

# Initialize reactor state
state = GluonZReactorState(
    reserves=1000.0,
    neutron_circulating_supply=500.0,
    proton_circulating_supply=500.0,
    prev_volume_delta=0.0,
    prev_reaction_time=0.0,
)

# Create reactor instance
reactor = GluonZReactor(params, state)

# Execute a fission reaction (basecoins -> neutrons + protons)
result = reactor.execute(
    GluonReaction.FISSION,
    balance=100.0,
    neutron_target_price=1.0,
    reaction_time=1.0,
)
print(f"Received: {result.reactor_output}")
print(f"New reserves: {result.reactor_state.reserves}")

Reactions

The Gluon protocol supports four reaction types:

• FISSION: Convert basecoins into neutrons and protons
• FUSION: Convert neutrons and protons back into basecoins
• BETA_DECAY_PLUS: Convert protons into neutrons
• BETA_DECAY_MINUS: Convert neutrons into protons

Types

The library uses type aliases for documentation:

• Basecoin - Reserve currency amounts (float)
• Neutron - Neutron token amounts (float)
• Proton - Proton token amounts (float)
• BasecoinPerNeutron - Price ratio (float)
• BasecoinPerProton - Price ratio (float)
• Tokeons - A dataclass containing neutrons and protons

Contributing

If you encounter bugs, need help, or have feature requests:

• Please open an issue in this repository providing detailed information.
• Describe the problem clearly and include any relevant logs or screenshots.

We appreciate your feedback and contributions!

© 2025 The Stable Order.