워커 가이드
워커는 로컬 Ollama 모델을 제공하는 데스크톱 앱입니다. 앱 안에서 한 번의 클릭으로 시작하며 CLI 설정도 계정도 없습니다.
요구 사항
- macOS 13 이상(Apple Silicon 또는 Intel) 또는 Windows 11.
- Ollama — 없으면 앱이 설치하고 관리합니다.
- Base Sepolia 지갑. 테스트 USDC는 faucet에서 받으며 가치가 없습니다.
- 선택한 모델용 디스크(7B 기준 약 4~5 GB).
1. 설치와 시작
앱을 열고 워커 실행을 선택해 Ollama를 설치하거나 연결합니다. 앱이 Ollama를 시작하고 필요하면 모델을 내려받으며, 준비되면 상태 카드를 보여 줍니다.
2. 모델 선택
Ollama가 로컬에서 제공할 수 있는 모델만 나옵니다. 오퍼 하나에 모델 하나입니다. 디스크와 VRAM이 충분하면 여러 오퍼를 만들 수 있습니다.
3. 가격 설정
가격은 직접 입력하는 시간당 견적입니다. 권장 가격은 없고 앱이 깎지도 않습니다. 과금은 시작된 분 단위로 누적됩니다.
| 시간당 견적 | 2분 작업 지급액 |
|---|---|
| 6 USDC / 시간 | 0.2 USDC |
| 30 USDC / 시간 | 1.0 USDC |
4. 등록
등록은 peer ID와 policy hash를 WorkerRegistry에 기록하며 Base Sepolia gas가 듭니다.
다시 등록해도 최초 등록 시각은 유지됩니다.
5. 도달성
제공을 시작하기 전에 다른 피어가 실제로 도달할 수 있는지 앱이 확인합니다. 릴레이 없는 대칭 NAT, 막힌 인바운드 포트, 인바운드 IPv6를 차단하는 캠퍼스 네트워크는 실패합니다.
- IPv6는 명시적 옵트인입니다. 기본적으로 의존하지 않습니다.
- 릴레이는 핸드셰이크 전용입니다. 세션 전체를 나르는 수단이 아닙니다.
- 공개 locator는 옵트인입니다. IP 공개는 영구적이며 앱을 지워도 되돌릴 수 없습니다.
6. 수익과 인출
정산된 세션은 워커 지갑에 누적됩니다. 앱에서 claim()을 호출하면 JobEscrow에서 잔액을 옮깁니다.
재무가 1%를 가져가고 99%는 당신 것입니다.
문제 해결
| 증상 | 가능한 원인 |
|---|---|
| 등록했지만 세션이 없음 | 도달성 검사 실패. NAT와 방화벽 확인 |
| Ollama는 도는데 앱이 오프라인 표시 | Ollama가 앱이 기대하지 않는 포트의 127.0.0.1에 바인딩됨 |
| 세션이 열린 뒤 환불됨 | 타임아웃 전에 서명 영수증이 나오지 않음 |
| 잔액이 움직이지 않음 | 정산은 세션 단위, claim()은 별도 단계 |
앱이 보내는 것
사용 보고는 꺼져 있습니다. 앱은 공개 RPC로 체인과, libp2p로 워커와, GitHub Releases로 업데이트와 통신합니다. 프롬프트, 파일 이름, 모델 이름을 GenKaKu Labs로 보내지 않습니다.