에이전트

에이전트 지갑은 AI 앱이 결제할 수 있는, 한도가 있는 별도 지갑입니다. 모든 결제는 확장 프로그램에서 다시 사용자에게 넘어옵니다.

최악의 경우에도 잃을 수 있는 금액은 에이전트 지갑에 넣은 금액이 최대입니다.

주소로 AI 앱을 연결하는 기능은 https://mcp.openapps.network/connect의 공유 게이트웨이로 옮기는 중이며, 지금은 이용할 수 없습니다. 게이트웨이 문서를 참조하세요. 확장 프로그램에서 에이전트 지갑을 만들고, 충전하고, 전액 돌려보내고, 닫는 것은 지금도 할 수 있습니다. 에이전트 결제가 다시 가능해지면 Mainnet에서는 소액으로 시작하세요. OnWallet은 내부 보안 검토만 거쳤으며, 독립적인 보안 감사는 받지 않았습니다.

에이전트 지갑

내 지갑에서 만든 별도 계정으로, 에이전트가 쓸 수 있는 금액만큼 자금을 넣습니다. 메인 지갑은 에이전트가 절대 쓸 수 없습니다.
에이전트는 자신이 보낸 요청에 대해 웹사이트나 도구가 요구한 가격만 결제할 수 있습니다. 자기가 고른 주소로 돈을 보낼 수는 없습니다.
결제는 개방형 표준인 x402를 사용해 XRP Ledger에서 XRP 또는 RLUSD로 이루어집니다.

AI 앱 연결

주소로 AI 앱을 연결하는 기능은 https://mcp.openapps.network/connect의 공유 게이트웨이로 옮기는 중이며, 지금은 이용할 수 없습니다. 게이트웨이 문서를 참조하세요.

연결이 열리면 AI 앱이 연결 페이지로 안내합니다. OnWallet에서 승인(Approve in OnWallet)을 누르면 확장 프로그램이 앱 이름이 표시된 자체 창을 열고, 거기서 에이전트 지갑과 한도를 고른 뒤 Touch ID나 비밀번호로 승인합니다. 입력할 코드는 없습니다. 언제든 확장 프로그램에서 앱 연결을 해제할 수 있으며, 그러면 앱은 즉시 차단됩니다.

결제

AI 앱에 돈이 드는 일을 요청합니다. 예를 들어 유료 서비스의 보고서입니다.
앱이 OnWallet에 그것을 가져오도록 요청합니다. 서비스는 가격으로 응답합니다. 한도를 넘는 것은 즉시 거부됩니다.
확장 프로그램이 요청을 보여 줍니다. 앱 이름, 서비스, 금액, 결제할 에이전트 지갑, 오늘 예산 중 남은 금액입니다. 시스템 알림도 받습니다.
승인하기 전에 확장 프로그램은 서비스에 직접 가격을 묻고, 금액, 통화, 받는 사람, 네트워크가 표시된 것과 같은지 확인합니다. 하나라도 다르면 거부합니다. 새 서비스에 처음 결제할 때는 브라우저가 OnWallet이 그 사이트에 접속하도록 허용할지 묻습니다.
Touch ID나 비밀번호로 승인합니다. 결제는 내 기기에서 서명되고, 앱은 요청한 것을 받습니다.

1분 안에 승인하지 않으면 앱은 결제가 대기 중이라는 안내를 받고 나중에 다시 확인합니다. 거절하거나 만료되도록 두면 아무것도 서명되지 않습니다.

한도

연결을 승인하거나 로컬 에이전트를 페어링할 때 한도를 정합니다. 확장 프로그램은 1회 결제 1 XRP 또는 1 RLUSD, 1일 5 XRP 또는 5 RLUSD를 제안하며, 이 값은 바꿀 수 있습니다. 다만 어떤 에이전트 지갑에도 허용되는 최대치보다 높게 정할 수는 없습니다.

	1회 결제	1일	최대 보유액
XRP	20	100	1,000
RLUSD	10	50	500

앱 하나에는 대기 중인 결제가 최대 10건, 요청이 시간당 최대 60건까지 허용됩니다. 같은 서비스가 10분 안에 같은 금액을 5번 넘게 요청하면, 확장 프로그램이 경고하고 앱 차단을 제안합니다.

Mac에서: OnWallet Agent

데스크톱 프로그램인 OnWallet Agent는 지금은 다운로드할 수 없습니다. 이 페이지는 작동 방식을 설명하며, 설치 안내는 첫 다운로드와 함께 여기에 추가됩니다.

Claude Code처럼 컴퓨터에서 프로그램을 실행하는 AI 앱은 대신 OnWallet Agent를 쓸 수 있습니다. OnWallet Agent는 macOS용 로컬 MCP 서버로, 에이전트 지갑에 대한 한도가 걸린 자체 키를 보관합니다. 확장 프로그램과 한 번 페어링하고, macOS 프롬프트에서 Touch ID나 Mac 로그인 비밀번호로 결제를 승인합니다. 이미 승인한 서비스에 대한 소액 결제는 묻지 않고 진행될 수 있으며, 기본값은 0.10 RLUSD 또는 0.2 XRP 미만입니다. 데스크톱 설정을 참조하세요.

지켜보기와 중지

확장 프로그램은 잠금을 해제할 때, 그리고 브라우저가 실행되는 동안 15분마다 각 에이전트 지갑을 확인합니다. 계정이 허용된 결제 외의 일을 하면 에이전트 중지(Stop agent)가 있는 알림을 받습니다.
앱을 차단하려면 연결 해제(Disconnect)를 누릅니다. 전액 돌려보내기(Sweep)는 에이전트 지갑에 남은 금액을 메인 지갑으로 돌려보냅니다. 닫기(Close)는 계정을 삭제하고 남은 금액, 즉 남은 잔액과 1 XRP 준비금 중 약 0.8 XRP를 메인 지갑으로 보냅니다. 나머지(현재 0.2 XRP)는 XRP Ledger가 계정 삭제 수수료로 소각합니다.

알아 둘 점

XRP Ledger 시드(s로 시작)로 가져온 지갑은 키가 하나뿐이어서 에이전트 지갑을 만들 수 없습니다. 24개 단어 지갑은 만들 수 있습니다.
에이전트 지갑의 RLUSD도 다른 모든 RLUSD처럼 Ripple이 동결하거나 회수할 수 있습니다.
OnWallet의 MCP 서버는 유료 콘텐츠를 전달하기 위해 전송 중에 보게 되지만, 보관하지는 않습니다.
기술적인 구조는 개발자 문서를 참조하세요.