UXUS Agent Services: wallet lookup, entity labels, caller ID

UXUS — エージェントサービス

AI エージェント向けの従量課金プリミティブです。uxus.finance でご利用いただけます。 x402 プロトコルを介して Base 上の USDC で支払います。アカウント、API キー、登録は不要です。資金を入れたウォレットがあれば、すぐに利用できます。

サービス

エンドポイント	価格	内容
POST /api/llm	$0.01	LLM 補完、5 モデルのフォールバックチェーン
GET /api/scrape	$0.01	URL → 整形済みの Markdown／テキスト／HTML
POST /api/extract	$0.01	雑然としたテキスト／URL → 指定したスキーマの JSON
POST /api/embed	$0.01	テキスト → 1024 次元ベクトル（jina-embeddings-v3）
GET /api/search	$0.01	リアルタイムのウェブ検索
GET /api/risk/pro	$0.02	1 回の呼び出しで判定：PROCEED / CAUTION / BLOCK ＋概要＋理由
GET /api/risk/live/pro	$0.02	トークン所有者の権限を1回の呼び出しで判定（まだ一時停止、アップグレード、ラグプルが可能か？）＋理由
GET /api/risk · /api/risk/live	無料	リスクスコア＋判定（理由／シグナルなし）
GET /api/lookup	無料	Ethereum、Base、XRPL のアドレス検索。チェーンを自動検出
GET /api/entity	無料	エンティティの帰属情報 — このアドレスの正体
GET /api/resolve	無料	ENS／Basenames の順引き＋逆引き（順引きで検証済み）
GET /api/callerid	無料	このウォレットに応答すべきか？（XMTP／Push 用）
/api/shield/*	無料	ユーザーごとのプライベートなウォレットブロックリスト（署名認証）
GET /api/catalog · /openapi.json · /llms.txt · /.well-known/x402.json	無料	検出
POST /api/mcp	無料	無料ツールを提供する MCP サーバー（Streamable HTTP）

すべてのリスク／判定レスポンスには disclaimer が含まれます。これは公開データ（OFAC SDN リスト、コミュニティの詐欺レジストリ、オンチェーンの読み取り）を使った開発者向けのスクリーニングであり、法的助言やコンプライアンスに関する助言ではありません。

データ

• 制裁対象データは、bad_addresses 内の OFAC SDN リスト（source='ofac'）という1つのソースから取得し、/api/cron/refresh-lists によって毎日更新します（保護機能により、上流から0件のアドレスが返された場合はテーブルを消去せず、処理を中止します）。これを結合するのは lib/entity.ts だけです。OFAC 以外のブロックリストに該当するものは sanctioned ではなく flagged カテゴリとなり、許可リストに追加できます。
• スコアリングではフェイルオープンします。判定に必要なデータソースが利用できず、リストにも該当しない場合、レスポンスは degraded:true／判定 CAUTION となり、PROCEED にはなりません。

開発

npm install
npm run dev        # http://localhost:3000
npm run build

環境変数（Vercel プロジェクト設定）：

変数	必須	用途
DATABASE_URL	はい	Neon Postgres
CRON_SECRET	はい	/api/cron/* を保護。Vercel Cron は Authorization: Bearer として送信します
OPENROUTER_API_KEY	/api/llm、/api/extract で必要
JINA_API_KEY	/api/embed で必要
SERPER_API_KEY / BRAVE_API_KEY	任意	/api/search（DuckDuckGo にフォールバック）
ETHERSCAN_API_KEY	任意	ウォレット履歴（Blockscout にフォールバック）
CDP_API_KEY_ID / CDP_API_KEY_SECRET	x402 の決済処理で必要

スクリプト：scripts/schema*.mjs（テーブル作成）、scripts/ingest*.mjs（手動でリストを 読み込み — 定期実行する処理は lib/refresh-lists.ts ＋ scripts/ingest-entity.mjs）、 scripts/shield-verify.mjs（ライブ E2E）、scripts/fix-sanctions.mjs（制裁対象データの 一度限りの修正。実行済み）。