此页面仅提供英文版本。 以英文版本为准。
文档
在 MZGrid 上构建
部署工作负载、运营提供方节点以及与协议集成所需的一切——从五分钟快速入门到每一个合约事件。
入门
- 简介What MZGrid is, who uses it, and how a GPU job moves from a funded escrow to a settled payment on Base.
- 快速入门Deploy an OpenAI-compatible Llama 3.1 8B Instruct endpoint on MZGrid in a few minutes, from the website or from the TypeScript SDK.
- 核心概念Offers, SKUs, templates, escrow, settlement, provider lock, reputation, job caps, regions and provider tiers explained.
客户
- 部署工作负载The full customer flow: choose an offer or let the scheduler pick, configure a template, fund the escrow on Base and follow the job to completion.
- 计费与托管How deposits, per-second billing, the 7% protocol fee, refunds, cancellation, timeout reclaim and slashing compensation work, with worked MZG examples.
- 模板Every workload template — what it runs, minimum VRAM, recommended GPUs and an example request.
- GPU 目录The supported GPU models, their reference prices in MZG per GPU-hour, how live prices relate to them, and how to choose a GPU for your workload.
提供方
- 安装提供方代理程序Requirements, installation, the mzgrid-provider CLI, running the agent as a systemd service, and how jobs are isolated on your machine.
- 基准测试与验证How MZGrid verifies provider hardware and work: registration benchmarks, usage reports and canary spot checks.
- 定价Setting your price per SKU, how live prices relate to reference prices, and how the scheduler ranks offers.
- 锁仓与退出How 20% of every payout becomes your collateral, how it raises your job cap, and how to exit and withdraw it after 10 days.
- 罚没The three slashing reasons, the exact amounts, how slashed MZG is split between the client and the treasury, and worked examples.
- 信誉How the 0–100 reliability score is computed from completion rate, uptime, benchmark consistency and tenure, and how it affects ranking.
API 参考
- 概览与认证Base URLs, conventions for amounts and timestamps, wallet sign-in, API keys, provider request signing, errors and rate limits.
- 公共端点Unauthenticated endpoints for health, the GPU and template catalogue, marketplace offers and live network statistics.
- 任务与账户Create, fund, monitor, read logs from and stop jobs, and read your account balances. Includes the Job object and status reference.
- API 密钥Create, list and revoke long-lived mzg_live_ API keys for servers and scripts.
- 提供方端点Endpoints used by the provider agent: registration, benchmarks, heartbeats, job polling, status, usage, completion, account and pricing.
SDK
- TypeScript SDKInstall @mzgrid/sdk, create a client with an API key or wallet, and browse offers, create and fund jobs, wait for endpoints, read logs and stop jobs.
- 在 Python 中使用 APICall the MZGrid REST API from Python with requests, fund jobs with web3.py, and use the job's endpoint with the openai client.
智能合约
- 概览与地址The three MZGrid contracts on Base, their deployed addresses, roles, the admin multisig and the trust model.
- MZGridEscrowConstants, functions, rules and events of the escrow contract, with a viem example of createJobWithPermit.
- ProviderRegistryProvider status, locked balances, job caps, exit and withdrawal, slashing reasons, functions and events.
- MZGTokenThe MZG ERC-20 token: 18 decimals, EIP-2612 permit, fixed supply of 1,000,000,000, no mint and no owner, plus the allocation and vesting wallets.