AlgebraCripto 📐🔐

AlgebraCripto is a Python library that generates deterministic cryptocurrency wallets (EVM and Solana) based on mental coordinates and algebraic functions. Instead of saving 12 standard words, you remember geometric figures, mathematical limits, and an optional (but highly recommended) strong password!

To install the core library (for backend generation without visual plotting):

pip install algebracripto

If you plan to use the visual CLI generator to plot the mathematical paths to a PDF, you must install the optional visualizer dependencies:

pip install algebracripto[visualizer]

AlgebraCripto uses the formulas of geometric curves to generate entropy. You define an origin point (e.g., Point(x, y)) and provide a password. The engine generates a random curve passing through that point to find a "Recovery Point".

The mathematical properties of this curve, combined securely with a PBKDF2 HMAC SHA256 KDF (using your password as a salt), derive a deterministic 32-byte seed.

from algebracripto import AlgebraCrypto, Point, Network

# 1. Initialize the Crypto Manager
wallet_manager = AlgebraCrypto()

# 2. Define a mental point and a strong password (optional but secure)
origin = Point(x=5421, y=9912)
my_password = "SuperStrongPassword123!"

# 3. Create a deterministic Line-based wallet
wallet = wallet_manager.create_line_wallet(
    origin=origin, 
    network=Network.EVM, 
    password=my_password
)

# 4. Save the recovery data
recovery_point = wallet.recovery_data["recovery_point"]
print(f"Write this down! Recovery X: {recovery_point.x}, Y: {recovery_point.y}")

# 5. Access your keys
print(f"EVM Public Key: {wallet.keys.public_key}")
print(f"EVM Private Key: {wallet.keys.private_key}")

If you lose your private key but remember your password, your origin mental coordinates, and the recovery_point, you can recover the exact same wallet:

recovered_keys = wallet_manager.recover_line_wallet(
    origin=origin, 
    recovery_point=recovery_point, 
    network=Network.EVM, 
    password=my_password
)

assert recovered_keys.private_key == wallet.keys.private_key

The AlgebraCrypto main class orchestrates all wallet generation capabilities. All generation methods return a WalletData (containing the recovery data and keys), and recovery methods return the WalletKeys itself.

• network (Network Enum): Target network, either Network.EVM or Network.SOLANA. Defaults to Network.EVM.
• password (str): User passphrase converted into a cryptographic salt. Defaults to "" (no password).

• create_line_wallet(origin: Point, network, password) -> WalletData: Uses linear slope equations relative to the mental origin.
• recover_line_wallet(origin: Point, recovery_point: Point, network, password) -> WalletKeys

• create_circle_wallet(center: Point, network, password) -> WalletData: Uses the radius created from Pythagorean pairs from the center point.
• recover_circle_wallet(center: Point, recovery_point: Point, network, password) -> WalletKeys

• create_parabola_wallet(vertex: Point, network, password) -> WalletData: Generates a random parabola intersecting the vertex.
• recover_parabola_wallet(vertex: Point, recovery_point: Point, network, password) -> WalletKeys

• create_intersection_wallet(m1: int, m2: int, network, password) -> WalletData: Computes the geometric intersection point of two linear system coordinates defined by slopes m1 and m2.
• recover_intersection_wallet(m1: int, m2: int, intercept_1: int, intercept_2: int, network, password) -> WalletKeys

• create_wave_wallet(amplitude: int, network, target_peak: int = 7, password) -> WalletData: Utilizes frequency-based trigonometry. target_peak defaults to 7.
• recover_wave_wallet(amplitude: int, peak_x_coordinate: int, network, target_peak: int = 7, password) -> WalletKeys