참가자 가이드
Pouchi Agent Wallet on Maroo
트랙 안내
사용자가 자금을 맡기고, 에이전트가 정해진 범위에서 일하는 앱을 만드세요.
에이전트 월렛은 사용자 지갑과 별도의 주소와 잔액을 가져요. 사용자는 자금과 지출 정책을 승인하고, 필요하면 실행을 멈추거나 남은 자금을 회수해요.
기본 실습은 테스트넷 송금이에요. 실제 외부 유료 API 구매, 정기 실행, 임의 계약 호출은 제공하지 않아요.
시작하기
참가 경로는 하나예요. 같은 스타터로 첫 거래를 실행하고, 사용하는 AI 클라이언트에 MCP 도구를 연결해요.
팀 설정 준비
주최자에게 팀별
team.config.json, 승인 화면 주소, 테스트 원금과 가스 지원을 받으세요. 참가자가 테넌트를 만들 필요는 없어요. 연결과 각 권한의 소유자 승인은 직접 진행하세요.스타터 설치
Node.js 24를 준비하고 ZIP을 새 폴더에 푸세요.
team.config.json을 스타터 폴더에 넣고 터미널에서 실행하세요.검증용 스타터 RC1 다운로드npm ci파일 확인 정보
pouchi-unified-starter-rc1-20261030.zip
SHA256: 88bf38871d10e26d9c7dbc75c8e402a950b0c03bb19985e5875e03e02bc7bd65
등록과 네트워크 확인
아래 명령은 연결 요청이나 거래를 만들지 않아요.
npm run quickstart -- --config ./team.config.json --check-only --json지갑 연결과 첫 거래
수신자는 승인된 테스트 범위에서 선택하세요. 기본 실습 수신자는 주최자가 제공해요. 아래 주소는 현재 리허설용 테스트 수신자예요.
npm run quickstart -- --config ./team.config.json --name my-agent --recipient 0x9a8f75E2e57DA3Ed3Fc0b26858C3205D216cE672승인 링크에서 소유자가 내용을 확인한 뒤 같은 명령을 다시 실행하세요. 자식 월렛 생성, 0.3 테스트 OKRW 충전, 지출 정책 승인, 0.1 첫 거래를 이어가요. 원금 0.3과 가스 스폰서는 별도로 필요해요.
승인 대기와 응답 유실은 성공이 아니에요. 같은 명령과 요청 ID로 원래 결과를 확인하세요.succeeded와 실제 거래 해시가 있어야 완료예요.같은 스타터를 AI에 연결
아래 출력 JSON을 사용하는 AI 클라이언트의 MCP 설정에 등록하세요. 같은 팀 설정과 로컬 상태를 사용하며 별도 서버 배포는 필요하지 않아요.
npm run mcp:config
팀 미등록, 설정 불일치, 자금 부족이 표시되면 주최자에게 원문 오류를 전달하세요. 키와 연결 상태가 있는 .local을 삭제하거나 다른 팀과 공유하지 마세요.
지출 정책
에이전트가 실행할 수 있는 송금 범위를 소유자가 승인해요. 미리보기는 권한을 만들지 않으며, 정책이 enabled 상태가 된 뒤에만 실행할 수 있어요.
| 항목 | 참가자 입력과 제한 |
|---|---|
| 월렛 이름 | name, 소유자 아래의 정확한 이름 |
| 수신자 | recipient, 승인된 테스트 범위에서 선택한 주소 한 개 |
| 목적 | purpose, 사람이 읽을 설명. 실행 검증 조건은 아니에요. |
| 횟수 | maxCalls, 1회 또는 2회 |
| 회당 금액 | 0.1 테스트 OKRW, 변경 불가 |
| 기간 | 승인 요청 준비 기준 1시간, 변경 불가 |
| 호출 | 빈 calldata의 native 송금 |
이 화면은 제한 설명용이에요. 지갑 연결이나 승인 요청을 만들지 않아요.
npm run policy:preview -- --name my-agent --recipient 0x9a8f75E2e57DA3Ed3Fc0b26858C3205D216cE672 --max-calls 1 --purpose "작업 완료 보상" --json임의 금액, 일일 초기화, 모든 주소로 송금, 모든 토큰에 적용되는 예산은 현재 지원하지 않아요. 지원하지 않는 요청을 다른 정책으로 바꾸지 마세요.
중단과 자금 회수
지출 권한에 생성·충전·동결·회수 권한은 포함되지 않아요. 각 관리 작업은 소유자의 별도 승인이 필요해요.
- 동결
- 자식 월렛의 실행을 멈춰요. 동결 상태에서도 회수할 수 있어요.
- 회수
- 남은 자금을 소유자의 부모 지갑으로 돌려줘요.
- 철회
- 해당 지출 정책을 막아요.
revoked상태와 이후 실행 차단을 확인하세요.
첫 거래가 끝나면 자식 잔액은 0.2 테스트 OKRW예요. 2회 정책이라면 아직 사용하지 않은 1회 권한도 남아요. 실습을 마칠 때 잔액, 동결, 회수, 철회 결과를 확인하세요.
MCP 도구 7개
MCP는 AI 클라이언트가 스타터의 기능을 호출하는 연결 방식이에요. 도구 목록 조회와 정책 미리보기의 성공은 실제 송금 성공과 달라요.
| 도구 | 하는 일 |
|---|---|
policy_preview | 승인 없이 지원 범위 미리보기 |
wallet_status | 월렛 주소·잔액·동결 상태 조회 |
wallet_request | 생성·충전·동결·회수 승인 요청 |
policy_request | 지출 정책의 소유자 승인 요청 |
wallet_execute | 승인된 정확한 호출 실행 |
operation_status | 원래 요청의 결과 조회 |
policy_revoke | 정책 철회 승인 요청 |
node examples/call.mjs --list결과가 pending이나 unknown이면 원래 요청을 조회하세요. 새 요청 ID로 다시 송금하지 마세요.
작품 아이디어
- 작업 완료 보상
- 앱에서 작업 완료를 확인하고 지정한 수신자에게 테스트 보상을 지급해요. 완료 판단은 앱이 맡으며 정책 목적 문구가 자동 검증하지 않아요.
- 팀 에이전트 운영비
- 에이전트마다 별도 주소와 잔액을 두고, 맡긴 자금과 사용 내역을 보여줘요. 중단과 회수 버튼을 함께 설계할 수 있어요.
- 리서치 비용 계획
- 조사 작업별 비용 계획을 만들고 허용된 테스트 송금으로 실행 과정을 시연해요. 실제 유료 데이터나 외부 API를 구매하는 기능은 별도로 구현해야 해요.
제출물과 심사 안내
- 코드, 설치·실행 방법, 해결하려는 사용자 작업
- 짧은 데모와 에이전트 월렛의 공개 주소
- 실제 거래 링크와 적용한 정책
- 같은 요청을 재실행했을 때 추가 송금이 없는 결과
- 사용자의 승인·중단·회수·철회 방법과 확인 결과
.local, PIN, 복구키, 연결 토큰, 위임 키, 소유자 자동 승인 도구는 제출하지 마세요. 테스트넷 송금과 실제 외부 서비스 구매를 구분하세요.
심사 안내
심사 기준과 배점은 추후 공개 예정이에요.