ethoryx

Official Python client for the Ethoryx prime-generation API — structurally-guided primes for RSA, FHE, zk-SNARKs, and NTT, backed by the Ethoryx C/GMP core. Fewer Miller–Rabin tests, fewer candidates, same cryptographic strength.

• API: https://api.ethoryx.io · Docs · Status

Install

pip install ethoryx

Quick start

import ethoryx

client = ethoryx.Client(api_key="tg_your_key")   # or set ETHORYX_API_KEY

# Generate primes
prime = client.generate(bits=2048)
rsa   = client.generate_rsa(bits=2048)
pair  = client.generate_rsa_pair(bits=2048)      # matched (p, q)
ntt   = client.generate_ntt(bits=256)
fhe   = client.generate_fhe(bits=2048)           # Starter tier or above

# Public endpoints — no API key required
ethoryx.verify(999983)                           # {"is_prime": true, ...}
ethoryx.optimize_next(last_prime=999983, last_gap=6)  # -> predicted_next, confidence
ethoryx.status()                                 # version, benchmarks

Get a free key (100 calls/month) at https://ethoryx.io/register.

Authentication

Pass your key to the client, or set it once in the environment:

export ETHORYX_API_KEY="tg_your_key"

client = ethoryx.Client()                 # picks up ETHORYX_API_KEY

The public endpoints (verify, optimize_next, predict_gap, status) work without a key. Everything under generate* and account* requires one.

API

Every method returns the parsed JSON response as a dict.

Errors

from ethoryx import EthoryxError, AuthError, RateLimitError, APIError

try:
    client.generate(bits=2048)
except AuthError:
    ...        # missing/invalid key, or tier too low (401/403)
except RateLimitError:
    ...        # 429 — back off and retry
except APIError as e:
    print(e.status, e.response)
except EthoryxError:
    ...        # network/other

License

MIT © Ethoryx Research