마루(Maroo)는 한국 원화(KRW) 경제를 위해 설계된 규제 친화적 Layer 1 블록체인입니다. 이 문서에서는 마루 네트워크와 통합하는 방법을 안내합니다.
빠른 시작
마루를 처음 시작하는 분들을 위한 안내입니다.
테스트넷 사용해보기
마루 테스트넷의 라이브 도구를 바로 사용해 보세요.
개념
마루 네트워크의 핵심 개념과 아키텍처를 다룹니다. 체인 레이어 설계와 OKRW 경제, 프로그래머블 컴플라이언스(PCL), 신원·AI 에이전트 프리미티브, 네트워크 파라미터, 프라이버시 모델까지 모두 포함합니다.
핵심 아키텍처
마루의 기본 설계를 다룹니다. 시스템 계정, 모듈 권한, 프리컴파일, 제네시스 구성을 살펴봅니다.
OKRW 경제
OKRW 스테이블코인을 다룹니다. 발행 프로세스, 토큰 메커니즘, 모듈 설계를 살펴봅니다.
정책 및 컴플라이언스
프로그래머블 컴플라이언스 레이어(PCL)를 다룹니다. 정책 구조, 템플릿, 시행 흐름, 프리컴파일 인터페이스를 포함합니다.
EAS 증명
마루의 EAS(Ethereum Attestation Service)를 다룹니다. 증명 구조, Indexer 역방향 조회, PCL이 빠른 증명 평가를 위해 사용하는 x/eas 체인 내부 helper를 포함합니다. KYC/KYB 증명 흐름을 구현할 때 이 섹션을 참고합니다. AI 에이전트 신원(ERC-8004 Identity Registry, Agent 프리컴파일)은 AI Agents 섹션에서 다룹니다.
네트워크 및 운영
네트워크 파라미터, 트랜잭션 라이프사이클, 노드 운영을 다룹니다.
AI 에이전트
마루의 AI 에이전트 신원과 툴링을 다룹니다. 온체인 신원은 ERC-8004 IdentityRegistry preinstall과 Agent 프리컴파일(discovery + 인덱싱 읽기)로 구성됩니다. 에이전트 구축을 위한 두 가지 통합 경로로는 가장 가벼운 읽기 전용 경로인 @maroo-chain/mcp와, 잔액 보유·서명·온체인 정책까지 필요한 에이전트를 위한 상태 저장 툴킷인 MAWS(Maroo Agent Wallet Stack)가 있습니다.
프라이버시
검증 가능한 프라이버시 메커니즘을 다룹니다. 규제 감사와 호환되는 선택적 공개, ZKP 기반 기밀성을 포함합니다. 추후 문서 업데이트 예정 — 라이트페이퍼의 프라이버시 챕터가 확정 중이며, 확정 시 이 섹션이 확장됩니다.
가이드
단계별 튜토리얼과 통합 가이드를 모았습니다. 신규 빌더를 위한 빠른 시작, 통합 패턴, 고급 워크플로우, AI 에이전트 배포까지 다룹니다.
API 레퍼런스
마루 네트워크 API 레퍼런스를 다룹니다. JSON-RPC 엔드포인트, Solidity 호출 프리컴파일, MAWS 에이전트 툴킷을 포함합니다.
JSON-RPC API
마루 네트워크는 이더리움 도구와 호환되는 JSON-RPC API를 제공합니다. 이 API를 통해 개발자는 네트워크와 상호작용하고, 블록체인 데이터를 조회하며, 트랜잭션을 제출할 수 있습니다.
Contract API
Solidity에서 직접 호출할 수 있는 프리컴파일 인터페이스를 다룹니다. OKRW(스테이블코인), PCL(규제), EAS(attestation), Agent(ERC-8004 인덱싱) 네 가지를 포함합니다.
MAWS API
MAWS(Maroo Agent Wallet Stack)가 노출하는 MCP 서버 도구로, AI 클라이언트가 마루에서 AI 에이전트 지갑을 생성하고 운용합니다. 세 개 네임스페이스 — agent. (라이프사이클, 잔액, 가스 소스), policy. (온체인 지출 정책), transfer.* (OKRW 가치 전송 + 소유권 이전) —를 통해 19개 도구를 엔드투엔드로 제공합니다.
리소스
마루 테스트넷에서 빌드할 때 참고할 수 있는 자료를 모았습니다. 네트워크 접속 정보(엔드포인트, 지갑 설정)와 배포된 컨트랙트 주소를 포함합니다.