このページは英語版のみご利用いただけます。 英語版が正式な内容となります。
ドキュメント
MZGridで構築する
ワークロードのデプロイ、プロバイダーノードの運用、プロトコルとの統合に必要なすべてがここに。5分で終わるクイックスタートから、すべてのコントラクトイベントまで網羅しています。
はじめに
- イントロダクション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からAPIを使うCall 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.