Become a Provider | Arkeo Marketplace v2

🔄 Start Over

Select Chain RPC Endpoint Set Rate Register

Select Your Chain

Choose which blockchain data you want to provide.

🏷️

Link to Verified CoinGecko Chain (Optional)

Get standardized chain names, logos, and metadata

Loading available chains from Arkeo network...

Cancel

Already registered as a provider? Skip to Sentinel Setup →

Infrastructure Setup

Configure your blockchain node and sentinel.

🌐 Arkeo Network Connection

Your sentinel needs access to the Arkeo blockchain to verify subscriber contracts and process payments. Choose how to connect:

Use your own Arkeo node Best for Decentralization

Run your own Arkeo node for maximum independence. No reliance on third-party infrastructure. Recommended for serious providers.

Use a community endpoint

Connect to a free public Arkeo node run by community validators. Quick start, but you depend on their uptime. Automatic failover if your selected endpoint goes down.

Select Primary Endpoint

Checking available endpoints...

🔄 Automatic failover: If your selected endpoint goes down, your sentinel config will include all healthy endpoints as fallbacks.

⏳ Checking community endpoints...

⚠️ Why this matters: Arkeo currently has very few public endpoints. If they go down, your sentinel can't verify contracts. Running your own Arkeo node (even pruned) makes you fully independent and strengthens the entire network.

Your Node's RPC URL (internal)

This is your node's RPC endpoint — where the sentinel sends requests to get blockchain data.

🤔 How do I find my RPC URL?

Your RPC URL depends on where your node runs relative to the sentinel:

Same server	http://localhost:PORT	Most common setup
Different server	http://INTERNAL_IP:PORT	Use your node's internal/private IP
Docker	http://host.docker.internal:PORT	If sentinel runs in Docker

Common default ports by chain:

Cosmos/Arkeo: 26657 Ethereum: 8545 Bitcoin: 8332 Solana: 8899

📂 Check your node's config: For Cosmos chains, look in config.toml under [rpc] → laddr

🛡️

What about the Sentinel?

The sentinel is a lightweight proxy that handles authentication and payments. You'll set it up after registration — we'll generate a ready-to-use config and walk you through the install in a later step.

Service Configuration

Set your pricing and provider metadata.

💰 Pricing

Set your pay-as-you-go rate. This is what subscribers pay per request to your node.

Rate (uarkeo per request)

Per request: 0.00025 ARKEO

Per 1,000 requests: 0.25 ARKEO

Per 1M requests: 250 ARKEO

USD per 1M requests: ~$3.47

📊 How should I price my service?

Competitor pricing for reference:

Infura	Free tier + $50/mo for 100k req/day
Alchemy	Free tier + $49/mo for 50M compute units
QuickNode	$49/mo for 15M API credits

Tips: Start competitive to attract subscribers. You can adjust your rate anytime by updating your provider config on-chain.

🛡️ Node Protection

Protect your node from being overwhelmed. Your sentinel will automatically reject requests that exceed these limits.

Max requests per minute (per subscriber)

Each subscriber's contract is capped at this rate. Prevents any single user from hogging your resources.

✅ Each subscriber limited to 100 requests/min

✅ With 10 subscribers: max 1,000 requests/min to your node

⏱️ Contract Duration Limits

Set how long subscribers can open contracts with you. ~4 seconds per block.

Max Contract Duration

The maximum length of time a subscriber can lock in a contract with you.

ℹ️ Arkeo chain limit: Max contract duration cannot exceed 5,256,000 blocks (~8 months). This is a network-wide parameter set by governance.

blocks

≈ 1 year at ~4s/block

Min Contract Duration

The minimum commitment required for subscribers. Prevents spam contracts.

blocks

≈ ~40 seconds at ~4s/block

📄 Your Provider Profile

This is how you'll appear in the marketplace. Your sentinel will serve this info automatically.

Provider Name

Description (optional)

Region (optional)

Chain -

Node RPC -

Rate 1 uarkeo/req

Bond Required 1 ARKEO

💡 You need at least 1 ARKEO in your wallet for the provider bond, plus gas fees (~0.001 ARKEO).

🛡️ Set Up Your Sentinel

One command installs everything. Then come back here to verify.

1 Do you have a domain name for your sentinel?

A domain gives you free HTTPS. No domain? No problem — the installer will use your server's IP address.

🤔 How do I get a free domain?

Go to duckdns.org and sign in with Google/GitHub
Create a subdomain (e.g. my-arkeo-node)
Point it to your server's IP address
Enter it above (e.g. my-arkeo-node.duckdns.org)

The installer handles SSL/HTTPS automatically. Total cost: $0.

2 Run This Command On Your Server

SSH into your server and paste this single command. It installs Docker, configures your sentinel, sets up HTTPS, and starts everything.

✓ Installs Docker (if not already installed)

✓ Writes your config with your provider key and pricing

✓ Sets up HTTPS with nginx + Let's Encrypt (if domain provided)

✓ Starts the sentinel and verifies it's working

3 Verify From Here

After the installer finishes, enter your sentinel URL below and we'll confirm it's working.

Your Sentinel URL

The installer will show this URL when it finishes.

🔧 Advanced: View raw config files

config.yaml

metadata.json

🔄 Optional: Automatic Endpoint Failover

If you're using a community Arkeo endpoint, this script auto-switches to a backup if it goes down.

# Download and install the failover monitor
curl -o /usr/local/bin/arkeo-failover.sh \
  https://raw.githubusercontent.com/rbechtold69/arkeo-data-engine-v2/main/docs/scripts/arkeo-endpoint-monitor.sh
chmod +x /usr/local/bin/arkeo-failover.sh

# Run every 2 minutes via cron
(crontab -l 2>/dev/null; echo "*/2 * * * * /usr/local/bin/arkeo-failover.sh ~/.arkeo/config.yaml >> /var/log/arkeo-failover.log 2>&1") | crontab -

ℹ️ Not needed if you run your own Arkeo node.

🚀

Once your sentinel passes the test, you're live!

Subscribers can now find you in the marketplace and open contracts to query your node.

View Marketplace Test Your Provider

⚡ Sentinel Rate Limiting

The Arkeo sentinel automatically enforces QPM (Queries Per Minute) limits per contract. Each contract has a queries_per_minute field — the sentinel will reject requests that exceed the contracted rate. No extra configuration needed on your end for per-contract enforcement.

🔧 Recommended Infrastructure: Nginx Reverse Proxy

Place Nginx in front of your sentinel for additional rate limiting, TLS termination, and DDoS mitigation:

# /etc/nginx/conf.d/arkeo-sentinel.conf

# Rate limit zone: 100 requests/min per IP
limit_req_zone $binary_remote_addr zone=sentinel:10m rate=100r/m;

server {
    listen 443 ssl http2;
    server_name your-provider.example.com;

    ssl_certificate     /etc/letsencrypt/live/your-provider.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/your-provider.example.com/privkey.pem;

    location / {
        limit_req zone=sentinel burst=20 nodelay;
        limit_req_status 429;

        proxy_pass http://127.0.0.1:3636;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

💻 Hardware Guidelines

🟢 Light (<100 QPM)

2 CPU, 4 GB RAM

Suitable for low-traffic chains

🟡 Medium (100–1000 QPM)

4 CPU, 8 GB RAM

Most providers start here

🔴 Heavy (1000+ QPM)

8+ CPU, 16+ GB RAM, SSD

High-demand or archive nodes

🛡️ DDoS Protection

Cloudflare (free tier) — Proxy your domain through Cloudflare for automatic DDoS mitigation and TLS.
UFW firewall — Allow only necessary ports:

sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw allow ssh
sudo ufw allow 443/tcp    # HTTPS (Nginx)
sudo ufw allow 3636/tcp   # Sentinel (if no Nginx proxy)
sudo ufw enable

fail2ban — Auto-ban repeat offenders:

sudo apt install fail2ban
sudo systemctl enable fail2ban
# Default config bans after 5 failed SSH attempts

📊 Setting Your Max QPM

QPM is set per contract when a user opens a contract with you. To decide your per-contract QPM limit:

Per-Contract QPM = Total Hardware Capacity ÷ Max Expected Contracts

Example: 500 QPM capacity with up to 10 contracts → set 50 QPM per contract

Benchmark your node under load to find your actual capacity.
Leave 20–30% headroom for spikes.
You can update QPM settings by modifying your provider configuration on-chain.

⚡ Enable x402 Payments

Accept USDC micropayments via Arkeo's centralized x402 proxy (optional)

What is x402?

x402 is Coinbase's open standard for HTTP-native payments. It lets clients pay per request with USDC on Base (low fees) — no accounts, no API keys. Perfect for AI agents. Learn more →

✅ Prerequisites

Checking provider registration...

Done - View Marketplace →

x402 is Coinbase's open HTTP payment standard. It lets clients pay per request with USDC — no accounts, no KYC. Add x402 middleware to your sentinel to accept micropayments from AI agents and developers on Base network (low fees).

1. Install x402 packages

npm install @x402/express @x402/core @x402/evm

2. Add x402 middleware to your sentinel

import express from "express";
import { paymentMiddleware } from "@x402/express";
import { createVerifier } from "@x402/evm";

const app = express();

// Your wallet address to receive USDC payments
const WALLET_ADDRESS = "0xYourWalletAddress";

// Configure x402 payment verification
const verifier = createVerifier({
  network: "base",  // Base network for low fees
});

// Protect your RPC endpoint with x402
app.use("/rpc", paymentMiddleware(verifier, {
  recipient: WALLET_ADDRESS,
  amount: "0.0001",  // $0.0001 USDC per request
  asset: "USDC",
}));

// Proxy to your node
app.post("/rpc", async (req, res) => {
  const response = await fetch("http://localhost:26657", {
    method: "POST",
    body: JSON.stringify(req.body),
  });
  res.json(await response.json());
});

app.listen(3637);

3. Requirements

An EVM wallet address to receive USDC payments
Runs on Base network — transaction fees are fractions of a cent
Works alongside your existing Arkeo sentinel — run on a different port
Set your own per-request price in USDC

🤖 AI Agent Revenue

Agents can't sign up for accounts — x402 lets them pay automatically.

💸 Instant Settlement

USDC payments settle on Base — no waiting for on-chain contract claims.

🌐 HTTP Standard

Uses HTTP 402 status code — works with any HTTP client.

Full x402 seller documentation →