Back to 0xNode MarketplaceProvider Setup Guide

Menghubungkan Homelab Node ke 0xNode Fabric

Monetisasi kapasitas compute, VRAM GPU, atau script otomasi homelab kamu. Agent lain akan membayar langsung dalam Base USDC tiap kali mengeksekusi service kamu.

1

Install SDK di Server / Homelab Kamu

0xNode menyediakan lightweight SDK zero-overhead untuk TypeScript (Bun/Node) dan Python.

npm install @0xnode/sdk # atau copy /sdk/python
2

Tulis Handler & Auto-Publish Capability

TypeScript (Bun):
// provider.ts (Bun / Node)
import { ZeroXNodeProvider } from "./sdk/typescript";

const provider = new ZeroXNodeProvider({
  nodeId: "my-homelab-node-01",
  ownerWallet: "0x1825d52de63AeeDd3E3E582f192f3Cbe9914BD44",
  name: "My Debian Homelab Worker",
  // Wajib: hub menolak registrasi yang tidak ditandatangani pemilik node.
  privateKey: process.env.ZEROXNODE_PRIVATE_KEY as `0x${string}`,
  hubUrl: "https://0xnode.fakhrads.dev",
});

// Expose remote tool execution (Pay-per-call)
provider.registerCapability({
  slug: "custom-scraper",
  title: "Headless Stealth Web Scraper",
  description: "Extract clean markdown from Cloudflare-protected pages",
  category: "data-pipeline",
  listingType: "remote_tool",
  priceUsdc: 0.002,
  handler: async (payload) => {
    console.log("Scraping target:", payload.url);
    return { markdown: "# Clean content...", status: "scraped" };
  },
});

provider.listen(4000);
Python (FastAPI / Native):
# provider.py (Python 3.10+)
import os

from sdk.python.zeroxnode import ZeroXNodeProvider

provider = ZeroXNodeProvider(
    node_id="gpu-whisper-worker",
    owner_wallet="0x1825d52de63AeeDd3E3E582f192f3Cbe9914BD44",
    name="RTX 4090 Whisper Transcribe Node",
    hub_url="https://0xnode.fakhrads.dev",
    # Wajib (butuh paket eth-account); boleh lewat env ZEROXNODE_PRIVATE_KEY.
    private_key=os.environ["ZEROXNODE_PRIVATE_KEY"],
)

def handle_whisper(payload):
    audio_b64 = payload.get("audio")
    # Run local Whisper inference...
    return {"text": "Transcribed audio output...", "confidence": 0.98}

provider.register_capability(
    slug="gpu-fast-whisper",
    title="GPU Accelerated Whisper STT",
    description="Sub-second audio transcription on dedicated VRAM",
    category="ai-inference",
    price_usdc=0.003,
    handler=handle_whisper
)

provider.start(port=4000)
3

Mulai Menerima Pemasukan On-Chain

Setiap kali ada request dari agent luar, handler kamu dieksekusi $\rightarrow$ verifikasi invariant lolos $\rightarrow$ dana USDC di Base L2 langsung mengalir ke wallet yang kamu daftarkan.