이 페이지는 영어로만 제공됩니다. 영어 버전이 정본으로서 효력을 가집니다.
문서
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.