Files
zeekay b832ba2c39 Initial Torus commit
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.
2026-05-29 14:16:47 -07:00

220 lines
6.8 KiB
Python

"""
Tests of execution of mul operation.
"""
import numpy as np
import pytest
from torus import fhe
@pytest.mark.parametrize(
"function",
[
pytest.param(
lambda x: x * 3,
id="x * 3",
),
pytest.param(
lambda x: 3 * x,
id="3 * x",
),
pytest.param(
lambda x: np.dot(x, 3),
id="np.dot(x, 3)",
),
pytest.param(
lambda x: np.dot(3, x),
id="np.dot(3, x)",
),
pytest.param(
lambda x: x * np.array([1, 2, 3]),
id="x * [1, 2, 3]",
),
pytest.param(
lambda x: np.array([1, 2, 3]) * x,
id="[1, 2, 3] * x",
),
pytest.param(
lambda x: x * np.array([[1, 2, 3], [3, 1, 2]]),
id="x * [[1, 2, 3], [3, 1, 2]]",
),
pytest.param(
lambda x: np.array([[1, 2, 3], [3, 1, 2]]) * x,
id="[[1, 2, 3], [3, 1, 2]] * x",
),
],
)
@pytest.mark.parametrize(
"parameters",
[
{
"x": {"range": [0, 40], "status": "encrypted"},
},
{
"x": {"range": [0, 40], "status": "encrypted", "shape": (3,)},
},
{
"x": {"range": [0, 40], "status": "encrypted", "shape": (2, 3)},
},
],
)
def test_constant_mul(function, parameters, helpers):
"""
Test mul where one of the operators is a constant.
"""
parameter_encryption_statuses = helpers.generate_encryption_statuses(parameters)
configuration = helpers.configuration()
compiler = fhe.Compiler(function, parameter_encryption_statuses)
inputset = helpers.generate_inputset(parameters)
circuit = compiler.compile(inputset, configuration)
sample = helpers.generate_sample(parameters)
helpers.check_execution(circuit, function, sample)
@pytest.mark.parametrize(
"function",
[
pytest.param(
lambda x, y: x * y,
id="x * y",
),
],
)
@pytest.mark.parametrize(
"parameters",
[
{
"x": {"range": [0, 10], "status": "clear"},
"y": {"range": [0, 10], "status": "encrypted"},
},
{
"x": {"range": [0, 10], "status": "encrypted"},
"y": {"range": [0, 10], "status": "clear"},
},
{
"x": {"range": [0, 10], "status": "encrypted"},
"y": {"range": [0, 10], "status": "encrypted"},
},
{
"x": {"range": [0, 10], "status": "clear", "shape": (3,)},
"y": {"range": [0, 10], "status": "encrypted"},
},
{
"x": {"range": [0, 10], "status": "encrypted", "shape": (3,)},
"y": {"range": [0, 10], "status": "clear"},
},
{
"x": {"range": [0, 10], "status": "encrypted", "shape": (3,)},
"y": {"range": [0, 10], "status": "encrypted"},
},
{
"x": {"range": [0, 10], "status": "clear"},
"y": {"range": [0, 10], "status": "encrypted", "shape": (3,)},
},
{
"x": {"range": [0, 10], "status": "encrypted"},
"y": {"range": [0, 10], "status": "clear", "shape": (3,)},
},
{
"x": {"range": [0, 10], "status": "encrypted"},
"y": {"range": [0, 10], "status": "encrypted", "shape": (3,)},
},
{
"x": {"range": [0, 10], "status": "clear", "shape": (3,)},
"y": {"range": [0, 10], "status": "encrypted", "shape": (3,)},
},
{
"x": {"range": [0, 10], "status": "encrypted", "shape": (3,)},
"y": {"range": [0, 10], "status": "clear", "shape": (3,)},
},
{
"x": {"range": [0, 10], "status": "encrypted", "shape": (3,)},
"y": {"range": [0, 10], "status": "encrypted", "shape": (3,)},
},
{
"x": {"range": [0, 10], "status": "clear", "shape": (2, 1)},
"y": {"range": [0, 10], "status": "encrypted", "shape": (3,)},
},
{
"x": {"range": [0, 10], "status": "encrypted", "shape": (2, 1)},
"y": {"range": [0, 10], "status": "clear", "shape": (3,)},
},
{
"x": {"range": [0, 10], "status": "encrypted", "shape": (2, 1)},
"y": {"range": [0, 10], "status": "encrypted", "shape": (3,)},
},
{
"x": {"range": [-10, 10], "status": "encrypted", "shape": (3, 2)},
"y": {"range": [-10, 10], "status": "encrypted", "shape": (3, 2)},
},
{
"x": {"range": [-10, 10], "status": "encrypted", "shape": (3, 1)},
"y": {"range": [0, 0], "status": "encrypted", "shape": (3, 1)},
},
{
"x": {"range": [10, 20], "status": "encrypted", "shape": (3, 1)},
"y": {"range": [0, 0], "status": "encrypted", "shape": (1, 3)},
},
{
"x": {"range": [2**12, 2**13 - 1], "status": "encrypted", "shape": (3, 1)},
"y": {"range": [0, 0], "status": "encrypted", "shape": (1, 3)},
},
{
"x": {"range": [2**12, 2**13 - 1], "status": "encrypted", "shape": (3, 1)},
"y": {"range": [0, 2 * 3 - 1], "status": "encrypted", "shape": (1, 3)},
},
{
"x": {"range": [-(2**7), 2**7 - 1], "status": "encrypted", "shape": (3, 1)},
"y": {"range": [-(2**7), 2**7 - 1], "status": "encrypted", "shape": (1, 3)},
},
],
)
@pytest.mark.minimal
def test_mul(function, parameters, helpers):
"""
Test mul where both of the operators are dynamic.
"""
parameter_encryption_statuses = helpers.generate_encryption_statuses(parameters)
configuration = helpers.configuration()
compiler = fhe.Compiler(function, parameter_encryption_statuses)
inputset = helpers.generate_inputset(parameters)
circuit = compiler.compile(inputset, configuration)
sample = helpers.generate_sample(parameters)
helpers.check_execution(circuit, function, sample, retries=3)
@pytest.mark.parametrize(
"parameter_encryption_statuses,function,inputs",
[
pytest.param(
{"x": "encrypted", "y": "encrypted"},
lambda x, y: (x - y) * ((x - y) > 0),
[
np.array([0, 1, 2, 3, 0, 1, 2, 3, 0, 1, 2, 3, 0, 1, 2, 3]),
np.array([0, 0, 0, 0, 1, 1, 1, 1, 2, 2, 2, 2, 3, 3, 3, 3]),
],
id="(x - y) * ((x - y) > 0)",
),
],
)
def test_mul_specific(parameter_encryption_statuses, function, inputs, helpers):
"""
Test mul with specific inputs.
"""
configuration = helpers.configuration()
compiler = fhe.Compiler(function, parameter_encryption_statuses)
circuit = compiler.compile([tuple(inputs)], configuration)
helpers.check_execution(circuit, function, inputs)