MAWS API
MAWS(Maroo Agent Wallet Stack)가 노출하는 MCP 서버 도구로, AI 클라이언트가 마루에서 AI 에이전트 지갑을 생성하고 운용합니다. 세 개 네임스페이스 — agent. (라이프사이클, 잔액, 가스 소스), policy. (온체인 지출 정책), transfer.* (OKRW 가치 전송 + 소유권 이전) —를 통해 19개 도구를 엔드투엔드로 제공합니다.
agent
지정된 에이전트 AA 지갑의 현재 OKRW 잔액을 조회합니다.
마루 체인에 자체 AA 지갑을 가진 새로운 AI 에이전트를 생성합니다. 에이전트는 처음에 PENDING 상태로 생성되며 WaaS가 온체인에 등록하는 동안 ACTIVE 상태가 되기까지 1~3분 정도 걸립니다.
현재 상태(PENDING, ACTIVE, FROZEN, REVOKED) 및 onchainAgentId를 포함하여 특정 에이전트의 전체 세부 정보를 가져옵니다.
에이전트의 AA 지갑에서 소유자의 기본 지갑으로 OKRW를 다시 전송합니다. 에이전트의 spendingLimit이 적용됩니다.
에이전트를 일시적으로 비활성화합니다. FROZEN 에이전트는 전송을 실행하거나 정책을 업데이트할 수 없습니다.
소유자의 기본 지갑에서 에이전트의 AA 지갑으로 OKRW를 전송합니다. 에이전트는 ACTIVE 상태여야 합니다.
인증된 사용자가 소유한 모든 에이전트 목록을 조회합니다.
사람 소유자의 기본 지갑 OKRW 잔액을 조회합니다.
에이전트를 영구적으로 비활성화합니다. REVOKED 에이전트는 다시 활성화할 수 없습니다.
이 에이전트의 트랜잭션 가스를 지불할 주체를 변경합니다. 이는 WaaS 서버의 메타데이터 전용 업데이트입니다.
FROZEN 에이전트를 ACTIVE 상태로 복원합니다.
policy
transfer
보류 중인 에이전트 소유권 이전을 수락합니다. 에이전트는 새 소유자 하에서 ACTIVE 상태가 됩니다.
보류 중인 에이전트 소유권 이전을 취소합니다. 에이전트의 동결이 해제되고 원래 소유자가 그대로 보유합니다.
에이전트의 소유권을 다른 사용자에게 이전하는 절차를 시작합니다. 에이전트는 즉시 FROZEN 상태가 되며, 수락이 이루어지지 않으면 최대 24시간 후 자동으로 만료됩니다.
인증된 사용자가 발신자이거나 수신자인 모든 보류 중인 에이전트 소유권 이전 목록을 조회합니다.
에이전트가 다른 주소로 OKRW를 전송하도록 합니다. 제출하기 전에 서버 측에서 에이전트의 온체인 정책을 시행합니다. WaaS가 에이전트를 대신하여 트랜잭션에 서명합니다.