English Français العربية

io.github.vjshaw/nulucre-wallet-reputation

السجل الرسمي المالية والمدفوعات

Wallet trust scores for AI agents. Stellar, XRPL, EVM 81+ chains. OFAC sanctions. x402 payments.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http nulucre-wallet-reputation 'https://agents.nulucre.com/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "nulucre-wallet-reputation": {
            "type": "http",
            "url": "https://agents.nulucre.com/mcp"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Nulucre Agents — Wallet Reputation Oracle for AI Agents
  2. Endpoints
  3. Payment Networks
  4. Score Bands
  5. Standard Response
  6. How x402 Payment Works
  7. Cryptographic Verification
  8. Agent Discovery
  9. Quick Start
  10. Stack
  11. Links

Nulucre Agents — Wallet Reputation Oracle for AI Agents

Real-time wallet trust scores across 4 chains, paid via x402 micropayments. No API keys, no accounts, no subscriptions — pure agent-to-agent commerce.

Base URL: https://agents.nulucre.com
Methodology: https://agents.nulucre.com/methodology
MCP Server: https://agents.nulucre.com/mcp

Endpoints

EndpointPriceDescription
GET /reputation/{wallet}$0.001 USDCEVM wallet score (81+ chains)
GET /reputation/signed/{wallet}$0.01 USDCEVM score with ECDSA proof
GET /reputation/stellar/{G-address}$0.001 USDCStellar wallet score
GET /reputation/stellar/signed/{G-address}$0.01 USDCStellar score with ECDSA proof
GET /reputation/xrpl/{r-address}$0.001 USDCXRPL wallet score
GET /reputation/solana/{address}$0.001 USDCSolana wallet score
POST /verify$0.01 USDCDeFi TVL fact verification
GET /tvl/{protocol}FREERaw TVL lookup
GET /healthFREEHealth check
GET /methodologyFREEScoring methodology

Payment Networks

NetworkTokenPay To
Base MainnetUSDC (ERC-20)0xd97C122cB81894213C67Bcc774448955d09915bC
Stellar PubnetUSDC (SEP-41)GCRUBFDANV52JP3URUJ7EZGPZKFEESBTW7T3FV2SJXZZGB6HDNRBWV24
Solana MainnetUSDC (SPL)GCRUBFDANv52JP3URUJ7EZGPZKFEESBTW7T3FV2SJXZZGB6HDNRBWV24

Score Bands

ScoreStatusMeaning
80–100TRUSTEDLong history, high activity, broad multi-chain footprint
60–79VERIFIEDEstablished wallet with meaningful on-chain history
40–59CAUTIONLimited history or signals
20–39RISKYVery new, inactive, or abnormal patterns
0–19BLACKLISTEDSanctioned or near-zero activity
—INSUFFICIENT_DATAFewer than 5 txs (EVM/Solana) or 3 txs (Stellar/XRPL) — not a risk verdict

Full methodology: https://agents.nulucre.com/methodology

Standard Response

{
  "wallet": "0x123...abc",
  "score": 74,
  "status": "VERIFIED",
  "network": "evm",
  "breakdown": {
    "walletAge": { "score": 28, "raw": "3400 days" },
    "txVolume": { "score": 35, "raw": "2100 txs" },
    "defiActivity": { "score": 6, "raw": "3 protocols" },
    "multiChain": { "score": 5, "raw": "2 EVM chains" }
  },
  "timestamp": "2026-10-20T00:00:00.000Z"
}

Thin-file response:

{
  "wallet": "0x123...abc",
  "score": null,
  "status": "INSUFFICIENT_DATA",
  "message": "Too few transactions to score reliably",
  "timestamp": "2026-10-20T00:00:00.000Z"
}

How x402 Payment Works

  1. Agent calls endpoint
  2. Server returns 402 Payment Required with payment details (Base, Stellar, or Solana)
  3. Agent sends USDC on chosen network
  4. Agent includes payment proof in next request header
  5. Server verifies and returns score

No accounts. No API keys. Fully autonomous.

Cryptographic Verification

Signed endpoints return an ECDSA-P256 signature verifiable against the Nulucre public key.

  • JWKS: https://nulucre.com/.well-known/jwks.json
  • Algorithm: ECDSA-P256 / SHA-256 / IEEE P1363

Agent Discovery

https://agents.nulucre.com/reputation/ https://nulucre.com/.well-known/agent.json https://nulucre.com/.well-known/x402.json https://nulucre.com/.well-known/jwks.json https://nulucre.com/openapi.json

Quick Start

# Free health check
curl https://agents.nulucre.com/health

# Free TVL lookup
curl https://agents.nulucre.com/tvl/aave

# EVM wallet score (requires x402 payment)
curl https://agents.nulucre.com/reputation/0xYourWalletAddress

# EVM signed score with ECDSA proof
curl https://agents.nulucre.com/reputation/signed/0xYourWalletAddress

# Stellar wallet score
curl https://agents.nulucre.com/reputation/stellar/GYourStellarAddress

# XRPL wallet score
curl https://agents.nulucre.com/reputation/xrpl/rYourXRPLAddress

# Solana wallet score
curl https://agents.nulucre.com/reputation/solana/YourSolanaAddress

# Fact verification
curl -X POST https://agents.nulucre.com/verify \
  -H "Content-Type: application/json" \
  -d '{"claim": "Uniswap has $5B TVL", "protocol": "uniswap"}'

Stack

  • Node.js + Express + PM2
  • x402 payment protocol (Base, Stellar, Solana)
  • Etherscan V2, Alchemy, Ankr, DeBank/Moralis (EVM)
  • Stellar Horizon + StellarExpert (Stellar)
  • xrplcluster.com (XRPL)
  • Solana Mainnet RPC (Solana)
  • ECDSA-P256 cryptographic signing
  • Nginx reverse proxy on Ubuntu VPS

MIT License — © 2026 Nulucre Inc.

الأسئلة الشائعة

ما هو io.github.vjshaw/nulucre-wallet-reputation؟

Wallet trust scores for AI agents. Stellar, XRPL, EVM 81+ chains. OFAC sanctions. x402 payments.

كيف أثبّت io.github.vjshaw/nulucre-wallet-reputation؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http nulucre-wallet-reputation 'https://agents.nulucre.com/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.vjshaw/nulucre-wallet-reputation إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.vjshaw/nulucre-wallet-reputation مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.github.vjshaw/nulucre-wallet-reputation؟

ينشره vjshaw. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.