자주 묻는 질문

에이전트의 결제 범위

에이전트에는 키가 없습니다. 처음 결제할 때 사용자가 한도(금액, 횟수, 기간)를 승인하고, 그 안에서만 실행됩니다. 한도는 지갑 컨트랙트가 체인에서 강제합니다.

승인 횟수

권한마다 한 번입니다. 같은 권한 안의 결제는 다시 묻지 않습니다. 한도를 넘으면 오류가 반환되므로 한도 변경이나 새 권한을 승인받아야 합니다. 다른 서비스나 승인 범위 밖의 호출에는 새 권한이 필요합니다. 주기 한도를 다 썼다면 다음 주기가 시작될 때까지 기다립니다.

지원 에이전트 앱

Streamable HTTP, OAuth 자동 클라이언트 등록(DCR), authorization code + PKCE를 지원하는 클라이언트를 씁니다. Hermes, Claude, Cursor 설정은 AI 에이전트 연결에 있습니다. 에이전트가 승인 URL을 텍스트 링크로 보여 주므로 MCP elicitation은 필요하지 않습니다.

Privy 이전과 지갑 주소

키를 옮길 수 없어서 새 지갑이 만들어집니다. 사용자가 옛 지갑에서 자산을 한 번 보내는 이전 키트가 있습니다. Privy에서 옮기기를 보세요.

가스비 부담

가스비는 앱이 부담합니다 (ERC-4337 paymaster). 이용자 지갑에서는 가스비를 차감하지 않습니다. 앱 운영자는 대납 예산과 건당 한도를 설정합니다.

서비스 MCP 운영 주체

각 서비스가 직접 만들고 호스팅합니다. 템플릿과 Docker 이미지가 있습니다. 서비스는 앱 운영자에게 origin과 컨트랙트를 등록해야 intent가 받아들여집니다.

구독 요금 변경

승인한 금액, 인자 조건과 주기 한도 안에서만 청구합니다. 이용자가 승인한 mandate.update로 전체 금액, 횟수, 기간이나 1회 한도를 늘릴 수 있습니다. 대상 함수, 인자 조건과 주기 한도는 바뀌지 않습니다. 기존 eq 또는 lte 조건을 넘는 가격이나 다른 주기 한도에는 새 권한이 필요합니다.

해지와 중지 시점

revoke_mandate는 게이트웨이를 통한 이후 에이전트와 서비스 결제를 즉시 멈춥니다. 체인 해지가 필요하면 이용자가 링크에서 승인해 마칩니다. 체인에 남은 실행 횟수가 없으면 더 실행할 수 없어 추가 승인이 필요하지 않습니다. 서비스의 release는 서비스 청구 자격 증명을 반납하며, 체인 권한을 해지하는 동작은 아닙니다.

앱별 지갑

같은 계정으로 로그인해도 지갑은 앱별로 분리되는 것이 기본입니다. 앱 운영자가 공유를 선택한 경우에만 지갑을 공유합니다.

다른 기기에서 사용

하나의 Pouchi 계정으로 로그인합니다. 복구가 필요하면 Pouchi 화면에서 패스키 또는 복구 코드를 사용합니다. 복구는 계정에 한 번 설정하며 서버가 자동으로 복구하지 않습니다. Pouchi Home에서 기기와 복구 설정을 확인합니다. 계정과 보안

테스트 자산

SDK 송금 예시는 Maroo Testnet(chainId 450815)의 네이티브 테스트 OKRW를 씁니다. 서비스 데모는 별도 결제 토큰을 쓸 수 있으므로 충전 전에 응답의 자산과 잔액을 확인합니다. 테스트 자금이나 초대 전용 접근 권한은 지갑 주소와 데모 이름을 적어 business@pouchi.app으로 요청하세요.

패키지 받는 곳

shard-lab 조직의 GitHub Packages입니다. read:packages 토큰이 필요합니다. npm 공개는 아직입니다.