AI 에이전트

@maroo-chain/mcp는 공식 마루 MCP 서버입니다. npx로 바로 설치할 수 있는 Model Context Protocol 키트로, Claude Code, Cursor, Claude Desktop, Windsurf, Gemini CLI와 같은 호환 AI 클라이언트에 마루 지식 베이스, 체인·PCL 조회, 로컬 키 기반 테스트넷 지갑을 제공합니다. 읽기 전용이 아니며, 지갑 도구는 개인 키를 생성하거나 가져와 그 키로 테스트넷 OKRW 전송에 서명하고 브로드캐스트합니다. 에이전트에 온체인 정책을 따르는 WaaS 관리형 AA 지갑이 필요하다면 @maroo-chain/m-aws와 함께 사용하고, 마루를 이해하는 것이 주된 목적이라면 단독으로 실행합니다.

에이전트 정책은 MAWS의 핵심 위험 제어 메커니즘입니다. spendingLimit(트랜잭션당 최대 OKRW)과 allowedTargets(목적지 주소 허용 목록)로 구성되며, IdentityRegistry에 온체인으로 저장됩니다. 다만 이 규칙을 강제하는 것은 MAWS뿐입니다. MCP 서버가 서명하기 전에 검사합니다. 어떤 체인 모듈도 이 값을 읽지 않으므로, 에이전트 지갑 키로 MAWS를 거치지 않고 보낸 트랜잭션은 이 규칙에 막히지 않습니다. 체인이 직접 강제할 수 있는 에이전트별 한도는 별도의 TransferLimit 키입니다(two-layer-policy-model 참고).

MAWS 에이전트는 계정 추상화(AA) 지갑으로 작동하므로 가스비를 후원받거나 위임할 수 있습니다. gasSource 설정은 실행 비용을 누가 부담할지 정합니다. WaaS 페이마스터, 에이전트 자체, 또는 인간 소유자(실험 단계로, 아직 온체인 라우팅이 없음) 중 하나입니다.

소유자 단위 한도는 MAWS가 아니라 체인의 프로그래머블 컴플라이언스 레이어(PCL) 전역 정책에서 나옵니다. KYC는 EAS attestation으로 확인합니다. 마루 테스트넷에서는 attestation이 없는 발신자를 트랜잭션당 2,000,000 OKRW, UTC 기준 하루 10,000,000 OKRW로 제한하며, 이 한도는 에이전트의 MAWS spendingLimit이 허용하는 값과 관계없이 적용됩니다.

마루 에이전트 지갑 스택(MAWS)은 자율 AI 에이전트와 마루 블록체인 사이의 간극을 메웁니다. 지갑 작업을 표준 도구 호출로 노출하는 모델 컨텍스트 프로토콜(MCP) 서버를 제공하여 에이전트가 가치를 보유하고, 거래하며, 정책을 관리할 수 있게 합니다. 이 아키텍처는 신원, 지식, 인터페이스, 지갑, 컴플라이언스, 커머스라는 계층형 모델 위에 구축되어 에이전트 작업의 안전성, 규정 준수, 추적 가능성을 보장합니다.

transfer.initiate를 사용하여 한 인간 소유자에서 다른 소유자로 에이전트를 이전할 때 에이전트는 잠금 상태가 됩니다. 이전 요청에는 24시간의 TTL(Time-To-Live)이 있으며, 이 기간 동안 수신자가 이를 수락해야 합니다.

MAWS는 서명하기 전에 에이전트의 정책을 검사하므로 AI 에이전트는 즉시 피드백을 받습니다. MAWS의 규칙(spendingLimit, allowedTargets, status)은 IdentityRegistry 메타데이터로 온체인에 저장되지만, 이를 강제하는 것은 MAWS뿐이며 체인은 이 값을 읽지 않습니다. 체인이 강제하는 것은 별도의 계층인 프로그래머블 컴플라이언스 레이어(PCL)로, 자체 전역 정책과 컨트랙트 정책으로 설정됩니다. PCL의 에이전트별 한도는 다른 메타데이터 키인 TransferLimit을 읽습니다.

0x100000000000000000000000000000000000000A의 Agent 프리컴파일은 view 전용 surface입니다. getParams()는 이 체인이 해석하는 ERC-8004 identityRegistry와 reputationRegistry 주소를 반환하고, getAgentIds(wallet, pageRequest)는 ERC-8004 에이전트 지갑이 wallet인 agent ID를 체인 측 인덱스에서 읽어 페이지네이션으로 반환합니다. 등록, 에이전트 URI, 메타데이터, 에이전트 지갑, ERC-721 소유권 같은 그 외의 작업은 0x8004000000000000000000000000000000000001의 ERC-8004 IdentityRegistry preinstall을 직접 호출하며, 이 레지스트리에는 attest나 revoke 함수가 없습니다.

마루는 자율 에이전트를 위한 KYA(에이전트 신원 확인) 검증 및 트랜잭션 모듈을 제공하여 AI 주도 경제 활동에 대한 책임과 엄격한 경계를 보장합니다.

마루는 AI 에이전트 신원을 체인 레벨 프리미티브로 다루기 위해 ERC-8004 Identity Registry를 preinstall로 설치합니다. dapp마다 따로 배포하는 대신 고정된 널리 알려진 주소(0x8004000000000000000000000000000000000001)에 하나만 둡니다. 마루 테스트넷에서는 제네시스가 아니라 v0.4.0 체인 업그레이드(블록 6,372,905)로 설치되었습니다. 등록, 에이전트 URI, 에이전트별 메타데이터, 에이전트 지갑은 ERC-8004 v1 Identity Registry ABI를 따르므로 이 ABI를 쓰는 도구는 그대로 동작합니다. 레지스트리에는 attestation이나 폐기(revoke) 함수가 없습니다. 마루 고유의 agent 프리컴파일이 그 옆에서 레지스트리 주소를 돌려주고, 에이전트 지갑을 에이전트 ID에 매핑합니다(agent-precompile-overview 참조).