ข้ามไปที่เนื้อหา

Pearl Mining

OpenJarvis สามารถขุดเชน Pearl Proof-of-Useful-Work ผ่านการอนุมาน LLM ในเครื่องได้ เส้นทาง v1 หลักรองรับเครื่อง NVIDIA H100/H200 ที่รัน vLLM ร่วมกับ Docker miner ของ Pearl ส่วนการรวม Pearl integration ยังมี provider แบบทดลองสำหรับ Apple Silicon และ CPU ผ่าน MiningProvider registry เดียวกันด้วย

สิ่งที่ต้องมีก่อน

สิ่งที่ต้องมี ข้อกำหนดของ v1
GPU NVIDIA H100 หรือ H200, class sm_90a, VRAM อย่างน้อย 70 GB
OS Linux ที่ตั้งค่า nvidia-container-toolkit แล้ว
Docker Docker 24+ พร้อมสิทธิ์เข้าถึง GPU runtime
Disk พื้นที่ว่างอย่างน้อย 200 GB สำหรับโมเดล 70B และ build cache
Pearl node Endpoint pearld JSON-RPC ที่เข้าถึงได้ ค่าเริ่มต้น http://localhost:44107
Wallet ที่อยู่ Pearl ที่ขึ้นต้นด้วย prl1q หรือ prl1p

การตั้งค่า vLLM เริ่มต้นใช้ gpu_memory_utilization = 0.96 และ max_model_len = 8192 สำหรับโมเดลขุด Pearl 70B บน GPU H100/H200 ขนาด 80 GB

หากต้องการสร้างที่อยู่ wallet ด้วย Oyster wallet ของ Pearl ให้รัน wallet daemon ของ Pearl แล้ว query ด้วย prlctl --wallet --skipverify -s localhost:44207 getnewaddress อย่านำ wallet ที่มี mnemonic ถูกวางไว้ใน log, แชท หรือ issue tracker กลับมาใช้ซ้ำ

Quick Start

uv sync --extra mining-pearl-vllm
export PEARLD_RPC_PASSWORD=<your-pearld-password>
export HF_TOKEN=<your-huggingface-token>

uv run jarvis mine init
uv run jarvis mine start
uv run jarvis mine status

mine init จะเขียนหมวด config [mining] และ resolve Docker image ของ Pearl หาก Pearl ยังไม่ได้เผยแพร่ image ที่เหมาะสมสำหรับ ref ที่ pin ไว้ OpenJarvis จะ fallback ไป build จาก Pearl source checkout ที่ pin ไว้ การ build ครั้งแรกอาจใช้เวลา 30-60 นาที

บน host NVIDIA ที่ใช้ร่วมกัน จำกัด miner ให้ใช้เฉพาะ GPU ที่ว่างอยู่:

uv run jarvis mine init --cuda-visible-devices 0

คำสั่งนี้เขียน [mining.extra].cuda_visible_devices ซึ่ง mine start จะส่งให้ Docker แทนที่จะเปิดให้ใช้ GPU ทุกตัวในเครื่อง

คำสั่ง

  • jarvis mine models แสดงสถานะการรองรับโมเดลของ Pearl
  • jarvis mine inspect-model ตรวจสอบ artifact ของโมเดล Pearl ก่อนเปิด GPU
  • jarvis mine doctor แสดงการตรวจสอบฮาร์ดแวร์, Docker, Pearl node, wallet, provider และ session
  • jarvis mine init เขียน config การขุดในเครื่องและ resolve image
  • jarvis mine start เปิด container ของ Pearl miner และเขียน runtime sidecar
  • jarvis mine stop หยุด provider และลบ sidecar
  • jarvis mine status อ่าน metric ของ gateway แบบ live
  • jarvis mine attach เขียน sidecar สำหรับ miner ที่คุณเปิดเองด้วยตนเอง
  • jarvis mine logs แสดง log tail ของ Docker container
  • jarvis mine validate-model ตรวจสอบ vLLM miner และ gateway ที่ใช้งานอยู่ ก่อนจะ เลื่อนโมเดล Pearl ที่วางแผนไว้ให้เป็น validated

การรองรับโมเดล

รัน:

jarvis mine models

OpenJarvis จะแสดงเฉพาะโมเดลที่เข้ากันได้กับ Pearl ที่เผยแพร่โดย Pearl Research Labs Hugging Face org เท่านั้น โมเดล base ดิบจาก Hugging Face เช่น meta-llama/Llama-3.3-70B-Instruct หรือ google/gemma-4-31B-it ไม่สามารถขุดได้ ด้วยตัวเอง ต้องใช้ตัวแปร pearl-ai/*-pearl ที่สอดคล้องกัน

รายการ id โมเดล Pearl ที่รองรับ:

pearl-ai/Llama-3.3-70B-Instruct-pearl
pearl-ai/Gemma-4-31B-it-pearl
pearl-ai/Llama-3.1-8B-Instruct-pearl

pearl-ai/Llama-3.3-70B-Instruct-pearl คือโมเดลเริ่มต้นที่ validated แล้ว artifact pearl-ai/* สาธารณะอื่นๆ อาจยังคงมีสถานะ planned จนกว่าจะผ่านการ validate บน H100/H200 ของ OpenJarvis

เมื่อ validate โมเดลของ Pearl org บน mining host ให้รัน:

jarvis mine inspect-model \
  --model pearl-ai/Gemma-4-31B-it-pearl \
  --allow-planned

jarvis mine validate-model \
  --model pearl-ai/Gemma-4-31B-it-pearl \
  --allow-planned \
  --prompt "Say hello in one sentence." \
  --output gemma-4-31b-pearl-validation.json

แนบ artifact JSON เข้ากับ validation issue เมื่อจะเลื่อนสถานะโมเดลเพิ่มเติม

ขอบเขตของ v1

v1 รองรับเฉพาะการขุดเดี่ยว (solo mining) เท่านั้น OpenJarvis ไม่เก็บค่าธรรมเนียม ไม่ดูแลเงินทุน ไม่สร้าง wallet key ไม่รัน pool และไม่ดำเนินการ pearld เอง ผู้ใช้ต้องมี Pearl node และที่อยู่รับเงินของตัวเอง

สิ่งที่ยังไม่รองรับใน PR นี้:

  • Pool mining และโมเดลค่าธรรมเนียม 20% ของ OpenJarvis ในอนาคต
  • การขุดด้วย AMD GPU และ backend ที่ไม่ใช่ Pearl
  • RTX 4090 หรือ GPU NVIDIA ที่ไม่ใช่ Hopper อื่นๆ
  • การสร้าง wallet หรือเซ็นธุรกรรมภายใน OpenJarvis

การแก้ปัญหา

รัน:

uv run jarvis mine doctor

อ่านแถวจากบนลงล่าง แก้ dependency ที่ล้มเหลวตัวแรกก่อนลองรัน mine start ใหม่ เครื่อง Mac หรือ AMD ควรล้มเหลวอย่างตรงไปตรงมาที่ความสามารถของ provider เส้นทาง เหล่านั้นคาดว่าจะกลายเป็น provider แยกต่างหากในอนาคต

ความพร้อมสำหรับการใช้งานจริง

เส้นทาง NVIDIA ต้องผ่านการ validate จริงบน H100/H200 อย่างน้อยหนึ่งครั้ง ก่อนที่จะ ถูกนำเสนอในฐานะเส้นทางสร้างรายได้ที่พิสูจน์แล้ว runbook สำหรับนักพัฒนาอยู่ที่ ../development/mining-nvidia-validation.md