마루 에이전트 지갑 스택(MAWS) 아키텍처
AI 에이전트를 온체인 마루 지갑에 연결하고 컴플라이언스를 내장한 계층형 아키텍처입니다.
마루 에이전트 지갑 스택(MAWS)은 자율 AI 에이전트와 마루 블록체인 사이의 간극을 메웁니다. 지갑 작업을 표준 도구 호출로 노출하는 모델 컨텍스트 프로토콜(MCP) 서버를 제공하여 에이전트가 가치를 보유하고, 거래하며, 정책을 관리할 수 있게 합니다. 이 아키텍처는 신원, 지식, 인터페이스, 지갑, 컴플라이언스, 커머스라는 계층형 모델 위에 구축되어 에이전트 작업의 안전성, 규정 준수, 추적 가능성을 보장합니다.
주요 기능
MCP 도구 통합
Claude, Cursor 및 기타 MCP 호환 클라이언트에 마루 지갑 기능을 직접 노출합니다.
이중 계층 정책 시행
MAWS의 오프체인 사전 검사는 에이전트 자체의 spendingLimit과 allowedTargets를 강제하고, 체인의 프로그래머블 컴플라이언스 레이어(PCL)는 이와 별도로 자체 전역 정책과 컨트랙트 정책을 적용합니다.
유연한 가스 스폰서십
에이전트 트랜잭션에 페이마스터(스폰서) 가스와 자체 자금 가스를 지원합니다. OWNER 모드는 기록되지만 실험 단계로, 온체인 라우팅이 지원되기 전까지는 자체 자금 모드처럼 에이전트 자신의 OKRW로 가스를 지불합니다.
아키텍처
graph TD
A[AI Agent / LLM] -->|MCP Protocol| B(MAWS MCP Server)
B -->|Off-chain| C{AgentManager}
B -->|API| D[WaaS Backend]
C -->|Preflight Check| E[(IdentityRegistry)]
D -->|Submit Tx| F[Maroo Chain]
F -->|Pre-execution check| G{PCL Enforcement}
G -->|Pass| H[Execute Transfer]
classDef evm fill:#0096AA,stroke:#0096AA,color:#fff;
classDef precompile fill:#FF8C50,stroke:#FF8C50,color:#fff;
class A,B,C,D,E,F,H evm;
class G precompile; MAWS는 에이전트의 의도를 가로채고, AgentManager를 통해 자체 지출 한도와 허용 목록을 오프체인 사전 검사로 확인한 뒤, WaaS를 통해 트랜잭션을 마루 체인으로 보냅니다. 체인에서는 PCL이 별도로 설정된 자체 정책을 적용합니다.
계층형 모델
MAWS는 에이전트 자율성을 위한 구조화된 접근 방식을 구현합니다. 인터페이스 계층은 MCP 서버가 처리하며, 자연어 의도를 구조화된 도구 호출(
컴플라이언스 계층은 두 부분으로 이루어지며, 각 부분이 검사하는 규칙은 서로 다릅니다. 트랜잭션에 서명하기 전에
agent.*, policy.*, transfer.*)로 변환합니다. 지갑 계층은 각 에이전트에 계정 추상화(AA) 지갑을 프로비저닝하는 마루 WaaS(Wallet-as-a-Service)가 구동합니다. 이를 통해 개인 키 관리가 추상화되어, 에이전트가 자율적으로 작동하는 동안에도 인간 소유자가 최종 통제권을 유지합니다.컴플라이언스 계층은 두 부분으로 이루어지며, 각 부분이 검사하는 규칙은 서로 다릅니다. 트랜잭션에 서명하기 전에
AgentManager는 MAWS 자체 규칙, 즉 에이전트의 ERC-8004 IdentityRegistry 레코드에 저장된 spendingLimit과 allowedTargets로 오프체인 사전 검사를 수행합니다. 에이전트가 지출 한도를 초과하거나 허용 목록에 없는 주소로 전송하려고 시도하면, MCP 서버는 도구 호출을 즉시 거부하고 LLM이 이해하고 복구할 수 있는 구조화된 ToolError를 반환합니다. 이 규칙을 강제하는 것은 MAWS뿐이며, 어떤 체인 모듈도 이 값을 읽지 않습니다. 사전 검사를 통과하면 트랜잭션이 마루 체인에 제출되고, 프로그래머블 컴플라이언스 레이어(PCL)가 자체 전역 정책과 컨트랙트 정책으로 이를 평가합니다. 이 정책은 MAWS 규칙과 별도로 설정됩니다. 체인이 강제할 수 있는 에이전트별 한도는 다른 메타데이터 키인 TransferLimit에 저장되며, 테스트넷의 전역 정책은 이 한도를 검사하지 않습니다. 참고: 사전 검사 덕분에 AI 에이전트는 서명 전에 바로 대응할 수 있는 피드백을 받습니다. 다만 온체인 보장은 아닙니다. 에이전트 지갑 키로 MAWS를 거치지 않고 보낸 트랜잭션은 PCL 정책은 거치지만 MAWS 규칙은 하나도 거치지 않습니다.