Native EVM precompiles for the Lux blockchain. Each precompile is a Go package that implements contract.StatefulPrecompiledContract and registers via modules.RegisterModule() in its init().

Geth provides NewPrecompileAdapter() to wrap these into geth-compatible precompiles. L1 chains select which precompiles to enable via PrecompileOverrider.

Each precompile follows this pattern:

<name>/
├── contract.go        # Run(), RequiredGas(), Address()
├── contract_test.go   # Tests with known vectors
├── module.go          # init() → modules.RegisterModule()
└── I<Name>.sol        # Solidity interface (optional)

1. Pick an address in a reserved range
2. Implement contract.StatefulPrecompiledContract
3. Register via modules.RegisterModule() in init()
4. Add tests (valid, invalid, gas, edge cases)
5. Wire into your L1 via PrecompileOverrider or geth's LuxPrecompiles()

go build ./...
go test ./...
go test -bench=. ./sr25519/  # benchmark a specific package

CGO is required for sr25519 (sr25519-donna C library). All other packages are pure Go.

Copyright (C) 2025, Lux Industries, Inc. All rights reserved.

Saves ~2000 gas per MulDiv vs Solidity. Used by every DeFi calculation.

10x gas savings vs Solidity StableSwap. For pegged-asset pools (LUSD/USDC, LETH/stETH).

Integrates with A-Chain TEE attestation. Register GPU providers, submit jobs, verify compute, claim $AI rewards.