Esta página está disponível apenas em inglês. A versão em inglês é a que prevalece.
Frequently asked questions
Answers to common questions from customers and providers about billing, refunds, the lock, slashing, the MZG token and security.
Customers
What can I run on MZGrid?
Anything that runs in a Docker container on an NVIDIA GPU. The templates cover OpenAI-compatible LLM endpoints (any Hugging Face model via vLLM, plus ready-made Llama 3.1 8B, Llama 3.3 70B and Qwen2.5 32B), ComfyUI with SDXL and FLUX.1-schnell, Whisper transcription and JupyterLab. The custom-docker and batch templates run your own images.
How much will my job cost?
The offer price in MZG per GPU-hour multiplied by the time the job actually runs, billed per second. You deposit pricePerHour × maxDuration up front and the unused part is refunded at settlement. For example, an H100 SXM at 750 MZG/h stopped after 2.5 hours costs 1,875 MZG out of a 3,000 MZG deposit for 4 hours. See Billing & escrow.
Is the 7% fee added on top of the price?
No. The 7% protocol fee is taken out of the charged amount. The price you see is the price you pay.
Can I pay in anything other than MZG?
No. Every price, deposit, payout and fee on MZGrid is in MZG. You also need a small amount of ETH on Base to pay transaction gas.
What happens if the provider never starts my job?
Providers must accept within 10 minutes of funding. If they do not, you can cancel the job from your dashboard (cancelJob) and get the full deposit back, then deploy to another offer.
What if MZGrid's API goes down while my job is running?
Your deposit stays safe in the escrow contract. If the job is not settled by its deadline plus a 1-hour grace period, you can call reclaimTimeout on the contract yourself and receive the full deposit, without involving the API.
Do I get compensated if a provider fails me?
Yes. A failed job is refunded in full. If the failure was the provider's fault — abandoning the job, going offline for more than 10 minutes, or failing verification — the provider's locked MZG is slashed and 50% of the slashed amount is sent to you on top of the refund.
How do I choose between offers?
Filter by VRAM first (see the GPU catalogue), then trade off price against reliability and region. If you do not want to choose, create the job with a sku and autoSelect: true and the scheduler picks the best-scoring offer.
Why can't I book a long job on a particular offer?
Each provider has a job cap of 25 MZG + 4 × locked. A newer provider with little locked collateral cannot take a job whose deposit exceeds that cap. Choose a shorter duration or a provider with a longer track record.
Can I use the endpoint with existing OpenAI client libraries?
Yes. vLLM-based templates serve the OpenAI Chat Completions and Completions APIs under /v1 on the job's endpointUrl. Set the client's base URL to endpointUrl + "/v1". See Using the API from Python.
Providers
What do I need to become a provider?
A Linux machine with a supported NVIDIA GPU, the NVIDIA driver, Docker with the NVIDIA Container Toolkit, Node.js 24, outbound HTTPS, and a Base wallet with a little ETH for gas. You do not need any MZG to start. See Installing the provider agent.
How much do I receive from each job?
93% of the charged amount: 74.4% is paid to your wallet immediately at settlement, and 18.6% is added to your locked balance in the ProviderRegistry. The remaining 7% is the protocol fee.
Why is part of my earnings locked?
The lock is your collateral. MZGrid has no up-front staking; instead, collateral builds up from your own work. It raises your job cap so you can take larger jobs, and it is what customers are compensated from if you fail them.
How do I get my locked MZG back?
Run mzgrid-provider exit (requestExit()), wait 10 days, make sure you have no active jobs, then run mzgrid-provider withdraw (withdrawLocked()). The full locked balance is transferred to your wallet. See Lock & exit.
Can I be slashed after requesting exit?
Yes. Slashing remains possible during the 10-day exit delay, so misconduct discovered after your last job can still be compensated.
How much can I lose to slashing?
At most your locked balance; slashing never touches your liquid earnings or wallet. Going offline for more than 10 minutes during a job costs min(locked, 1 × job deposit), abandoning an accepted job costs min(locked, 2 × job deposit), and failing verification costs 100% of your lock.
Who sets my price?
You do, per SKU, during init or later with PUT /v1/providers/pricing. Live offers on the network typically sit between 0.85× and 1.20× the catalogue reference. See Pricing.
Why is my machine listed as unverified?
Its benchmark result fell outside 70–115% of the reference FP16 TFLOPS for its SKU. Check for thermal throttling, reduced power limits or other processes on the GPU, then run mzgrid-provider benchmark again. See Benchmark & verification.
How can I improve my ranking?
Raise your reliability: complete every job, keep machines online (uptime is 30% of the score), keep benchmarks consistent, and stay on the network — tenure counts up to 180 days. Reliability is 35% of the scheduler's ranking score and price is 50%.
Token
What is MZG used for?
MZG is the payment asset of the network: customers pay for compute in MZG, providers are paid in MZG, the protocol fee is collected in MZG and provider collateral is locked in MZG. It carries no governance rights.
What is the supply of MZG?
1,000,000,000 MZG, minted once when the token was deployed. The contract has no mint function and no owner, so the supply cannot increase. The allocation and vesting schedule are on the MZGToken page and the token page.
Does holding or locking MZG earn a yield?
No. There is no staking and no yield. The provider lock is collateral that is returned on exit, less any slashing. Nothing in these docs is a statement about MZG's price or any return; see the risk disclosure.
Where are the contract addresses?
On the Smart contracts page and in the addresses export of the SDK. Always check addresses there before approving tokens.
Security
Can a provider see my data?
Possibly. Jobs run in isolated containers, which protects customers from each other and providers from customers, but the provider controls the physical machine. MZGrid offers isolated execution, not confidential computing. Do not run workloads with data or credentials you would not be comfortable exposing to the machine operator. See the Security model.
Have the contracts been audited?
No third-party audit is claimed in this documentation. The contracts are open source and verified on BaseScan, and we encourage you to review the verified source before relying on them.
Can MZGrid take funds from my wallet?
No. Funding a job always requires your wallet's signature for a specific amount. Once deposited, funds can only leave the escrow through the rules in MZGridEscrow: to you as a refund, or to the provider, registry and treasury at settlement.
How do I report a vulnerability?
Email [email protected]. We follow a 90-day coordinated disclosure policy. Details are in the Security model.