How MiroShark works

Text flows through NER (with an ontology) into a batched embedding call (OpenRouter text-embedding-3-large or a local Ollama equivalent). Entity resolution combines fuzzy matching, vector similarity, and an LLM reflection step - collapsing “NeuralCoin”, “Neural Coin” and “NC” into one canonical UUID. Same-endpoint relationship pairs are sent to an LLM adjudicator that invalidates the older edge instead of stacking contradictions.

text  →  NER (with ontology)
      →  batch embed (text-embedding-3-large | Ollama)
      →  entity resolve (fuzzy + vector + LLM reflection)
      →  MERGE entities (canonical UUIDs)
      →  contradiction adjudication (invalidate old)
      →  CREATE RELATION {valid_at, invalid_at, kind, source_type, source_id}

Each query fans out into three parallel searches - vector edge search over Neo4j HNSW, BM25 fulltext, and a BFS traversal from seed entities. The top 30 candidates are fused, filtered by valid_at / kind, and re-ranked by a BGE-reranker-v2-m3 cross-encoder on Apple MPS, CUDA or CPU.

query
  ├─ vector edge   (Neo4j HNSW)        ─┐
  ├─ BM25 edge     (Neo4j fulltext)    ─┼─ temporal + kind filters → fused top 30
  └─ BFS traversal (from seed entities) ┘
                                       ↓
                BGE-reranker-v2-m3 (MPS / CUDA / CPU)
                                       ↓
                top N tagged with _sources ("v" / "k" / "g" / combos)

pip install 'x402[evm,requests]' eth-account requests

import os
from eth_account import Account
from x402.client import x402ClientSync
from x402.http.clients import x402_requests
from x402.mechanisms.evm.exact.client import ExactEvmScheme

account = Account.from_key(os.environ["X402_BUYER_PRIVATE_KEY"])

client = x402ClientSync()
client.register("eip155:8453", ExactEvmScheme(signer=account))   # Base mainnet
session = x402_requests(client)   # handles 402 → sign → retry automatically

resp = session.post(
    "https://x402.miroshark.xyz/run",
    json={"prompt": "How will developers react if OpenAI releases GPT-6 next month?"},
    timeout=120,
)
data = resp.json()["data"]
print("Run ID:", data["run_id"], "| follow:", data["wait_url"])

Fund the address with ~$1+ USDC on Base mainnet - no ETH needed, settlement gas is sponsored.

pip install 'x402[svm,requests]'

import os, json
from solders.keypair import Keypair
from x402.client import x402ClientSync
from x402.http.clients import x402_requests
from x402.mechanisms.svm.exact.client import ExactSvmScheme
from x402.mechanisms.svm.signers import KeypairSigner

SOLANA_MAINNET = "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"

raw = os.environ["SOLANA_BUYER_PRIVATE_KEY"].strip()
kp = (Keypair.from_bytes(bytes(json.loads(raw))) if raw.startswith("[")
      else Keypair.from_base58_string(raw))

client = x402ClientSync()
client.register(SOLANA_MAINNET, ExactSvmScheme(signer=KeypairSigner(kp)))
session = x402_requests(client)   # picks the Solana accepts[] entry automatically

resp = session.post(
    "https://x402.miroshark.xyz/run",
    json={"prompt": "Your scenario"}, timeout=120,
)
print(resp.json()["data"]["run_id"])   # paid on: "solana"

npm install @x402/fetch @x402/evm viem

import { x402Client } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client();
const signer = privateKeyToAccount(process.env.X402_BUYER_PRIVATE_KEY as `0x${string}`);
registerExactEvmScheme(client, { signer });

const res = await client.fetch("https://x402.miroshark.xyz/run", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ prompt: "Your scenario" }),
});
const data = (await res.json()).data;

{
  "x402Version": 2,
  "resource": {
    "url": "https://x402.miroshark.xyz/run",
    "serviceName": "MiroShark",
    "tags": ["Simulation","Research","Search","Crypto","AI"]
  },
  "accepts": [
    { "scheme":"exact", "network":"eip155:8453",
      "asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount":"1000000",
      "payTo":"0x6cab485fc28ec70d3845113b704d4824e4d2b24f",
      "maxTimeoutSeconds":300, "extra":{"name":"USDC","version":"2"} },
    { "scheme":"exact", "network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "amount":"1000000",
      "payTo":"9vWbPNMvt8ui1cNN8jWWPUWT5LPmeXzq7nr3vry1vMPH",
      "maxTimeoutSeconds":300, "extra":{"feePayer":"<facilitator-sponsored>"} }
  ]
}

{
  "x402Version": 2,
  "accepted": { … the chosen accepts[] entry … },
  "resource": "https://x402.miroshark.xyz/run",
  "payload": {
    "signature": "0x…",
    "authorization": {
      "from": "0xYourWalletAddress",
      "to":   "0x6cab485fc28ec70d3845113b704d4824e4d2b24f",
      "value":"1000000",
      "validAfter":"…", "validBefore":"…",
      "nonce":"0x<random 32 bytes>"
    }
  }
}

{
  "success": true,
  "transaction": "0x1f2ab48e…2ee06a",   // on-chain USDC transfer
  "network": "eip155:8453",
  "payer": "0xYourWalletAddress"
}