mirror of
https://github.com/luxfhe/torus.git
synced 2026-10-30 17:07:26 +00:00
Forked from upstream concrete (BSD-3-Clause-Clear, © 2024 ZAMA) at HEAD
ecb729bb. Modifications copyright © 2026 Lux Industries Inc.
Rebranding scope:
- Python module concrete → torus (across frontends/torus-python)
- Rust module concrete-* → torus-* (across frontends/torus-rust)
- MLIR dialect concretelang → toruslang (across compilers/torus-compiler)
- Compiler optimizer concrete-optimizer → torus-optimizer
- Backend concrete-cpu / concrete-cuda → torus-cpu / torus-cuda
- Wire protocol concrete-protocol → torus-protocol
- Parameter-curves concrete-security-curves-* → torus-security-curves-*
- Public symbols concretelib → toruslib, ConcreteLang → TorusLang
- URLs github.com/zama-ai/concrete → github.com/luxfhe/torus
- URLs docs.zama.ai/concrete → docs.luxfhe.com/torus
Legal compliance:
- LICENSE.txt retains original Copyright © 2024 ZAMA verbatim (§1-§2)
- LICENSE.txt adds modifications copyright © 2026 Lux Industries Inc.
- §3 endorsement clause: Torus is marketed exclusively as a Lux product;
no Zama name used in README, docs, or marketing
- NOTICE file provides factual attribution per legal best practice
(not endorsement; required by upstream BSD-3-Clause-Clear)
README + NOTICE rewritten from scratch with Lux brand:
- Quick-start in Python (torus.fhe)
- Architecture diagram showing the gen-1 vtbl integration path
(luxcpp/gpu → lux-private/gpu-kernels for CUDA/Metal/WebGPU)
- Scheme coverage table: TFHE (luxfi/fhe), CKKS/BGV/BFV (luxfi/lattice)
- Lux FHE family table: Torus / TorusVM / TorusEVM / TorusML / TorusNet
Known limitations (phase-2A scope):
- PyPI package torus-fhe not yet published; the torus Python module
is renamed structurally but pip-installable distribution is a
follow-up (Phase 2A.1)
- MLIR dialect rename is text-level; the compiler-internal LLVM
rebuild (concrete-compiler-internal-llvm-project submodule) is
structural and works; tablegen files renamed concrete→torus but the
generated .inc files in the source tree will regenerate at build
time
- backends/torus-cuda/implementation/ is an upstream submodule
pointer to the tfhe-rs source (not fetched in the staging clone);
the CUDA backend body is delivered out-of-tree
- ~100 test-fixture variable names like concrete_encoded_sample
retain "concrete" as a math term (vs symbolic); these are inside
tests/, not the public API; cleanup is a follow-up commit
- 295 Python `from concrete import ...` residuals in luxfhe/ml-sdk
consumer remain; that repo's import update is Phase 2B
This commit is the seed for the luxfhe/torus repo. Push as the first
commit to a fresh GitHub repo; do not re-import upstream Zama git
history.
125 lines
3.4 KiB
Python
125 lines
3.4 KiB
Python
import random
|
|
import time
|
|
|
|
import numpy as np
|
|
|
|
from torus import fhe
|
|
|
|
# ruff: noqa:S311
|
|
|
|
# Users can change these settings
|
|
NUMBER_OF_SYMBOLS = 10
|
|
MINIMUM_ORDER_QUANTITY = 1
|
|
MAXIMUM_ORDER_QUANTITY = 50
|
|
|
|
assert 0 < MINIMUM_ORDER_QUANTITY < MAXIMUM_ORDER_QUANTITY
|
|
|
|
|
|
def prime_match(
|
|
bank_order_quantities,
|
|
client_order_quantities,
|
|
):
|
|
with fhe.tag("calculating-matching-order-quantity"):
|
|
return np.minimum(bank_order_quantities, client_order_quantities)
|
|
|
|
|
|
inputset = [
|
|
(
|
|
np.random.randint(
|
|
MINIMUM_ORDER_QUANTITY, MAXIMUM_ORDER_QUANTITY, size=(NUMBER_OF_SYMBOLS * 2,)
|
|
),
|
|
np.random.randint(
|
|
MINIMUM_ORDER_QUANTITY, MAXIMUM_ORDER_QUANTITY, size=(NUMBER_OF_SYMBOLS * 2,)
|
|
),
|
|
)
|
|
for _ in range(1000)
|
|
]
|
|
configuration = fhe.Configuration(
|
|
enable_unsafe_features=True,
|
|
use_insecure_key_cache=True,
|
|
insecure_key_cache_location=".keys",
|
|
fhe_simulation=True,
|
|
min_max_strategy_preference=fhe.MinMaxStrategy.ONE_TLU_PROMOTED,
|
|
show_progress=True,
|
|
progress_tag=True,
|
|
)
|
|
|
|
|
|
# Only the quantities are encrypted, on both client and bank sides
|
|
compiler = fhe.Compiler(
|
|
prime_match,
|
|
{
|
|
"bank_order_quantities": "encrypted",
|
|
"client_order_quantities": "encrypted",
|
|
},
|
|
)
|
|
circuit = compiler.compile(inputset, configuration)
|
|
|
|
|
|
print()
|
|
start = time.time()
|
|
assert circuit.keys is not None
|
|
circuit.keys.generate()
|
|
end = time.time()
|
|
print(f"Key generation took: {end - start:.3f} seconds")
|
|
print()
|
|
|
|
|
|
# Generate random orders
|
|
sample_bank_order_quantities = [0] * NUMBER_OF_SYMBOLS * 2
|
|
sample_client_order_quantities = [0] * NUMBER_OF_SYMBOLS * 2
|
|
|
|
for i in range(NUMBER_OF_SYMBOLS):
|
|
# Randomly choose between a Sell Client / Buy Bank or a Buy Client / Sell Bank
|
|
# but avoir Sell Client / Buy Client
|
|
idx = i + random.randint(0, 1) * NUMBER_OF_SYMBOLS
|
|
sample_bank_order_quantities[idx] = np.random.randint(
|
|
MINIMUM_ORDER_QUANTITY, MAXIMUM_ORDER_QUANTITY
|
|
)
|
|
sample_client_order_quantities[idx] = np.random.randint(
|
|
MINIMUM_ORDER_QUANTITY, MAXIMUM_ORDER_QUANTITY
|
|
)
|
|
|
|
sample_args = (sample_bank_order_quantities, sample_client_order_quantities)
|
|
|
|
# Perform the matching with FHE simulation
|
|
print("FHE Simulation:")
|
|
simulated_matches = circuit.simulate(*sample_args)
|
|
print()
|
|
|
|
print("\tResult Orders:")
|
|
for c1_order, c2_order, result in zip(
|
|
sample_bank_order_quantities, sample_client_order_quantities, simulated_matches
|
|
):
|
|
print(f"\t\t{c1_order}\t{c2_order}\t->\t{result}")
|
|
print()
|
|
|
|
# Perform the matching in FHE
|
|
print("FHE:")
|
|
start = time.time()
|
|
executed_matches = circuit.encrypt_run_decrypt(*sample_args)
|
|
end = time.time()
|
|
print()
|
|
|
|
print("\tResult Orders:")
|
|
for c1_order, c2_order, result in zip(
|
|
sample_bank_order_quantities, sample_client_order_quantities, executed_matches
|
|
):
|
|
print(f"\t\t{c1_order}\t{c2_order}\t->\t{result}")
|
|
print()
|
|
|
|
# Check
|
|
assert all(simulated_matches == executed_matches), "Error in FHE computation"
|
|
|
|
# Some information about the complexity of the computations
|
|
NUMBER_OF_TRANSACTIONS = NUMBER_OF_SYMBOLS * 2
|
|
print(f"Complexity was: {circuit.complexity:.3f}")
|
|
print()
|
|
print(f"Quantities in [{MINIMUM_ORDER_QUANTITY}, {MAXIMUM_ORDER_QUANTITY}]")
|
|
print(f"Nb of transactions: {NUMBER_OF_TRANSACTIONS}")
|
|
print(f"Nb of Symbols: {NUMBER_OF_SYMBOLS}")
|
|
print(
|
|
f"Execution took: {end - start:.3f} seconds, ie "
|
|
f"{(end - start) / NUMBER_OF_TRANSACTIONS:.3f} seconds per transaction"
|
|
)
|