MLXDocs
Protocol

Parameters

Markdown

Every protocol constant in one place, with the name it has in the code and the file it lives in. The values on this page are read from those constants when the docs are built.

Live values, such as the price, the spot spread the operator set, balances and counts, are not here. Read them from the Network API.

Token and curve

ParameterValueConstantFile
Total supply10,000,000,000 MLXTOTAL_SUPPLYlib/chain/curve.ts
Decimals6DECIMALSlib/chain/curve.ts
One unit$100UNIT_USDlib/chain/curve.ts
MLX per unit at genesis10,000GENESIS_RATElib/chain/curve.ts
Network price at genesis$0.01UNIT_USD / GENESIS_RATElib/chain/curve.ts
Units per doubling200,000 ($20 million), then 300,000 ($30 million), then 400,000 ($40 million), then 500,000 ($50 million) for every doubling afterDOUBLINGSlib/chain/curve.ts
Seat weight on the curve50% of a seat's units, from 29 Oct 2026SEAT_CURVE_WEIGHTlib/chain/curve.ts
Mining referral bonus, levels 1 / 2 / 320% / 4% / 0.8%; KOL 25% / 5% / 1%; strategic 30% / 6% / 1.2%REF_BPSlib/chain/curve.ts
Mining referral budget300 million MLX from community.mlxREFERRAL_BUDGETlib/chain/curve.ts
Inviter's own Mac active within7 daysREF_ACTIVE_DAYSlib/chain/curve.ts
Spot buy premium, default3%BUY_PREMIUMlib/chain/curve.ts
Spot sell discount, default20%SELL_DISCOUNTlib/chain/curve.ts

The live spread is market in /api/stats. See The price curve.

Allocation

AccountPurposeShareMLX
rewards.mlxSeat reserve30%3,000,000,000
compute.mlxCompute rewards35%3,500,000,000
community.mlxCommunity and referrals10%1,000,000,000
treasury.mlxTreasury15%1,500,000,000
team.mlxContributors10%1,000,000,000

From ALLOCATION in lib/chain/curve.ts.

Seats

SeatIdPriceUnitsMLX a day (cap)MLX an hourMined MLX lockedFull rate on
NanoN$500.54~0.1720 daysany Mac
LiteT$10018~0.3314 daysany Mac
CoreS$2502.520~0.8310 daysany M chip
ProM$1,0001080~3.337 daysPro or Max
UltraL$4,00040320~13.333 daysUltra
Core LatestSX$3753.7530~1.2510 daysnewest base
Pro LatestMX$1,50015120~57 daysnewest Pro or Max
Ultra LatestLX$6,00060480~203 daysnewest Ultra

From TIERS in lib/chain/curve.ts. The cap is COMPUTE_KAPPA × units a day (seatPerDay). See Dedicated seats.

ParameterValueConstantFile
Latest edition, price and weight1.5×LATEST_MULTlib/chain/curve.ts
Chips that carry a Latest editionM6, M5 Pro, M5 Max, M5 UltraLATEST_CHIPSlib/chain/curve.ts
Devices a wallet can link32MAX_DEVICESlib/chain/device.ts

Compute rewards

ParameterValueConstantFile
Cap, κ8 MLX per unit a dayCOMPUTE_KAPPAlib/chain/curve.ts
Half-life of the compute pool4 yearsCOMPUTE_HALF_LIFE_DAYSlib/chain/curve.ts
Share released each hour, λ_h1.9768e-5COMPUTE_LAMBDA_HOURlib/chain/curve.ts
Free-seat weight0.125COMPUTE_FREE_WEIGHTlib/chain/curve.ts
Free-seat cap1 MLX a day, 0.0417 an hourFREE_PER_DAYlib/chain/curve.ts
Free seats' share of a release, at most10%COMPUTE_FREE_SHARElib/chain/curve.ts
Delivery target, dedicated seatone job per 15 sDEDICATED_MIN_PER_JOB (minutes)lib/compute/seats.ts
Delivery target, free seatone job per 12 sFREE_CYCLE_Slib/compute/seats.ts

See Compute rewards.

Lock-ins

ParameterValueConstantFile
Mined MLX on a dedicated seatthe wallet's shortest seat lock-in (seat table above)lockDays in TIERS, computeLockDayslib/chain/curve.ts
Mined MLX on a free seat30 daysCOMPUTE_FREE_LOCK_DAYSlib/chain/curve.ts

See Lock-ins.

Free-seat throttle

ParameterValueConstantFile
Shortest wait between jobs1 sCOMPUTE_FREE_JOB_GAP_MIN_Slib/chain/curve.ts
Longest wait between jobs9 sCOMPUTE_FREE_JOB_GAP_MAX_Slib/chain/curve.ts
Tokens in a short job32FREE_JOB_TOKENSlib/worker/jobs.ts
Tokens in a full job160maxTokens in freshJoblib/worker/jobs.ts

See Free seats.

Jobs and checks

ParameterValueConstantFile
Macs an index is handed to, at most5SHARE_HANDOUTSlib/worker/core.ts
Answers that close an index3SHARE_ANSWERSlib/worker/core.ts
Least time between hand-outs to one Mac200 msMIN_HANDOUT_GAP_MSlib/worker/core.ts
Results a minute from one Mac, at most300RESULTS_PER_MINUTElib/worker/core.ts
Timing floor1 ms per tokenFLOOR_MS_PER_TOKENlib/worker/core.ts
Speed floor against base Macs60%SPEED_FLOORlib/compute/verify.ts
Measured jobs before the speed check applies40SPEED_MIN_SAMPLESlib/compute/verify.ts
Base Macs needed for a baseline3SPEED_MIN_BASElib/compute/verify.ts

See Jobs and checks.

Worker API

ParameterValueConstantFile
/api/worker/job and /api/worker/result, per Mac240 a minute eachWORK_ROUTE_PER_MINUTElib/worker/route.ts
A device route that sets no limit of its own30 a minuteDEVICE_ROUTE_PER_MINUTElib/worker/route.ts

The other worker routes set their own limits in their route files. See The worker protocol.

Transactions and money

ParameterValueConstantFile
Transactions a minute from one address60TX_LIMITS.ipPerMinutelib/chain/limits.ts
The same, on one server instance40TX_LIMITS.perInstanceIpPerMinutelib/chain/limits.ts
Transactions a minute from one wallet30TX_LIMITS.walletPerMinutelib/chain/limits.ts
Failed transactions an hour before a wallet waits20TX_LIMITS.failedPerHourlib/chain/limits.ts
New wallets an hour from one address10TX_LIMITS.accountsPerIpHourlib/chain/limits.ts
New wallets a day from one address25TX_LIMITS.accountsPerIpDaylib/chain/limits.ts
MLX one wallet may buy in a UTC day$2,500buyDayUsdlib/abuse/fair.ts
The same, with a linked Mac$25,000buyDayUsdLinkedlib/abuse/fair.ts
Free-seat Macs that earn per network in an hour5freePerNetworklib/abuse/fair.ts
Different wallets one Mac may link to in 30 days3macWallets30dlib/abuse/fair.ts
Smallest withdrawal10 USDCWITHDRAW_MINlib/chain/ledger.ts
Withdrawal fee to Solana0.5 USDCWITHDRAW_FEElib/chain/ledger.ts
Largest payout sent automatically2,000 USDCHL_AUTO_MAXlib/bridge/hyperliquid.ts
Automatic payouts in a UTC day, at most10,000 USDCHL_DAILY_MAXlib/bridge/hyperliquid.ts

See Rate limits.