Maroo is a regulation-friendly Layer 1 blockchain designed for the Korean Won (KRW) economy. This documentation will guide you through integrating with the Maroo Network.
Quick Start
Get up and running with Maroo.
Getting Started with Maroo Network
Learn how to connect to Maroo Network and make your first RPC call.
Setting Up a Hardhat Development Environment
A step-by-step guide to configuring a Hardhat project to compile, test, and deploy smart contracts on the Maroo network.
Sending Your First Transaction
A step-by-step guide to checking your balance and sending OKRW to another address using ethers.js v6.
Try the Testnet
Hop straight into Maroo testnet — faucet, explorer, and the playground.
Concepts
Core concepts and architecture of the Maroo Network — chain-layer design and OKRW economics, programmable compliance (PCL), identity and AI-agent primitives, network parameters, and the privacy model.
Core Architecture
Maroo's foundational design — system accounts, module authority, precompiles, and genesis configuration are covered in this section.
OKRW Economics
OKRW stablecoin — covers the minting process, token mechanics, and module design.
Policy & Compliance
Programmable Compliance Layer (PCL) — covers policy structure, templates, enforcement, and precompile interfaces.
EAS Attestation
EAS (Ethereum Attestation Service) on Maroo — attestation structure, indexer reverse lookups, and the x/eas chain-internal helper that PCL uses for fast attestation evaluation. Use this section when implementing KYC/KYB attestation flows. AI agent identity (ERC-8004 Identity Registry, Agent precompile) lives in the AI Agents section.
Network & Operations
Network parameters, transaction lifecycle, and node operations.
AI Agents
AI agent identity and tooling on Maroo. On-chain identity sits on the ERC-8004 IdentityRegistry preinstall plus the Agent precompile (discovery + indexed reads). Two integration paths for building agents: @maroo-chain/mcp is the lightest path, with knowledge, chain reads and a local-key testnet wallet that signs and sends transfers; MAWS (Maroo Agent Wallet Stack) is the stateful toolkit when an agent needs to hold balances, sign transfers, and run on-chain policy.
Privacy
Verifiable privacy on Maroo — the shielded-pool privacy precompile, the EIP-712 authorized-relay domain, PCL policy enforcement on every privacy call, and the selective-disclosure model compatible with regulator audits.
Developer
Guides
Step-by-step tutorials and integration guides — quickstart for new builders, integration patterns, advanced workflows, and AI-agent deployment.
Integration Guides
Integrate with the Maroo Network.
Advanced Guides
Advanced topics and deep dives.
Agent Guides
Hands-on guides and tutorials for shipping AI agents on Maroo: setting up MAWS, authenticating, configuring spending policy, handling preflight rejection, container deployment, and end-to-end tutorials (create + fund an agent, regulatory compliance limits).
API Reference
Maroo Network API reference — covers JSON-RPC endpoints, Solidity-callable contract precompiles, and the MAWS agent toolkit.
JSON-RPC API
Maroo Network provides a JSON-RPC API compatible with Ethereum tooling. This API allows developers to interact with the network, query blockchain data, and submit transactions.
Contract API
Solidity-callable precompile interfaces covering OKRW (stablecoin), PCL (compliance), EAS (attestation), Agent (ERC-8004 indexing) and Privacy (shielded OKRW).
MAWS API
MCP server tools exposed by MAWS (Maroo Agent Wallet Stack) for AI clients to create and operate AI agent wallets on Maroo. Three namespaces — agent. (lifecycle, balance, gas-source), policy. (on-chain spending policy), transfer.* (OKRW value transfer + ownership transfer) — covering 19 tools end-to-end.
Resources
Reference material for building on Maroo testnet — network access (endpoints, wallet config) and deployed contract addresses.