Revettr

Revettr

エージェント型コマースにおける取引相手のリスクスコアリングです。API を 1 回呼び出すだけで、**「このエージェントはこの取引相手に送金すべきか？」**が分かります。

Revettr は、ドメイン情報、IP レピュテーション、オンチェーンのウォレット履歴、制裁リストを分析して取引相手をスコアリングします。Base 上で x402 を介して取引する AI エージェント向けに設計されています。

インストール

pip install revettr

クイックスタート

from revettr import Revettr

client = Revettr()

# Score a counterparty — send whatever data you have
score = client.score(
    domain="uniswap.org",
    ip="104.18.28.72",
    wallet_address="0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
)

print(f"Score: {score.score}/100 ({score.tier})")
print(f"Confidence: {score.confidence}")
print(f"Flags: {score.flags}")

if score.tier == "critical":
    print("DO NOT TRANSACT")

スコアリング対象

任意の入力を組み合わせて送信できます。データが多いほど、信頼度が高まります。

入力	シグナルグループ	確認内容
domain	ドメインインテリジェンス	WHOIS の登録期間、DNS 設定（MX、SPF、DMARC）、SSL 証明書
ip	IP インテリジェンス	地理的位置、VPN／プロキシ／Tor の検出、データセンターか住宅用か
wallet_address	ウォレット分析	取引数、ウォレットの経過期間、取引相手の多様性、オンチェーンの行動
company_name	制裁スクリーニング	OFAC SDN、EU 統合リスト、国連統合制裁リスト

レスポンス

{
  "score": 90,
  "tier": "low",
  "confidence": 0.75,
  "signals_checked": 3,
  "flags": [],
  "signal_scores": {
    "domain": {
      "score": 80,
      "flags": [],
      "available": true,
      "details": {
        "domain_age_days": 2673,
        "dns": {"has_mx": true, "has_spf": true, "has_dmarc": true}
      }
    },
    "ip": {
      "score": 100,
      "flags": [],
      "available": true,
      "details": {
        "country": "US",
        "asn_org": "Cloudflare, Inc.",
        "is_private": false
      }
    },
    "wallet": {
      "score": 100,
      "flags": [],
      "available": true,
      "details": {
        "blockchain": {"tx_count": 100, "unique_counterparties": 29},
        "onchain": {"nonce": 16, "eth_balance": 0.072}
      }
    }
  },
  "metadata": {
    "inputs_provided": ["domain", "ip", "wallet_address"],
    "latency_ms": 1185,
    "version": "0.1.0"
  }
}

スコアの段階

スコア	ティア	意味
80-100	low	取引相手は正当であると思われます
60-79	medium	注意が必要なシグナルがいくつかあります
30-59	high	複数のリスク指標が確認されました
0-29	critical	強いリスクシグナルがあります — 取引しないでください

スコア 0 は、完全一致（例：制裁対象との完全一致）を意味します。この場合、他のすべてのシグナルより優先されます。

リスクフラグ

フラグを見ると、スコアが下がった原因を正確に確認できます。フラグはシグナルのカテゴリ別に分類されています。

カテゴリ	例	対象範囲
ドメイン	domain_age_under_*、no_mx_records、ssl_*	ドメインの経過期間、DNS の衛生状態、SSL の有効性
IP	tor_exit_node、known_vpn、high_risk_country_*	匿名化、地理的位置のリスク
ウォレット	wallet_never_transacted、wallet_age_under_*	オンチェーンの履歴、活動パターン
制裁	sanctions_exact_match、sanctions_high_confidence_match	OFAC／EU／国連の制裁スクリーニング

フラグ一式とその説明は、API レスポンスで返されます。フラグ名は安定しており、機械で読み取れます。

使用例

ウォレットのみ（最小構成）

score = client.score(wallet_address="0xabc...")

ドメイン + IP（ウェブサービスの確認）

score = client.score(domain="some-api.xyz", ip="185.220.101.42")

完全チェック

score = client.score(
    domain="merchant.com",
    ip="104.18.28.72",
    wallet_address="0xabc...",
    company_name="Merchant LLC",
)

x402 自動決済を使用

クライアントが x402 決済を自動的に処理します。資金を入金したウォレットが必要です。

from revettr import Revettr

client = Revettr(
    wallet_private_key="0xYOUR_PRIVATE_KEY",  # Wallet that pays for the API call
)

# Client automatically handles the 402 → payment → retry flow
score = client.score(wallet_address="0xabc...")

セキュリティ：秘密鍵をハードコードしないでください。本番環境では環境変数またはシークレットマネージャーを使用してください。

Virtuals Protocol（ACP）を使用

Agent Commerce Protocol でジョブを作成する前に、販売者エージェントをスコアリングします。

from revettr import Revettr

client = Revettr()
result = client.score(wallet_address=seller_wallet)
if result.score >= 60:
    # Safe to create ACP job
    job_id = chosen_offering.initiate_job(
        service_requirement={"task": "Analyze Q1 sales data"},
        evaluator_address=evaluator_address,
    )

購入者エージェントの一連の処理については、examples/virtuals_acp_safe_buyer.py を参照してください。

安全なエージェント決済

x402 決済を置き換えてすぐに使える仕組みです。送金前に取引相手のリスクを自動的に確認します。取引相手のスコアがしきい値を下回る場合、決済はブロックされます。

from revettr import SafeX402Client, PaymentBlocked

async with SafeX402Client(
    wallet_private_key="0x...",
    min_score=60,    # Block "high" and "critical" risk
    on_fail="block", # Raise PaymentBlocked (default)
) as http:
    try:
        # Automatically scores the counterparty before paying
        response = await http.post("https://some-api.com/endpoint", json=data)
    except PaymentBlocked as e:
        print(f"Blocked: {e.url} scored {e.score}/100")

on_fail	動作
"block"（デフォルト）	PaymentBlocked 例外を発生させます
"warn"	警告をログに記録して、決済を続行します
"log"	ログに記録して、決済を続行します

料金

ティア	料金	提供内容
Standard	$0.01 USDC	入力内容に応じて利用可能なすべてのシグナル

決済には x402 プロトコルを使用します。Base ネットワーク上の USDC で支払います。API キー、アカウント、コントラクトは不要です。

API リファレンス

POST /v1/score

支払い：x402 — リクエストごとに Base で $0.01 USDC

リクエストボディ（JSON）：

フィールド	型	必須	説明
domain	string	いいえ	ドメインまたは URL
ip	string	いいえ	IPv4 アドレス
wallet_address	string	いいえ	EVM アドレス（0x...）
chain	string	いいえ	ブロックチェーンネットワーク（デフォルト：base）
company_name	string	いいえ	制裁対象との照合に使用する名前
email	string	いいえ	メールアドレス（今後対応予定 — 現時点ではスコアに反映されません）
amount	float	いいえ	USD 建ての取引金額（参考情報のみ）

domain、ip、wallet_address、company_name のいずれかを指定する必要があります。

GET /health

支払い：なし（常に無料）

API のステータスとシグナルソースの利用可否を返します。

SDK を使わない直接 HTTP 接続

# Without payment (returns 402):
curl -X POST https://revettr.com/v1/score \
  -H "Content-Type: application/json" \
  -d '{"domain": "example.com"}'

# Returns HTTP 402 with payment-required header containing x402 payment terms

免責事項

Revettr は情報提供ツールです。一般に公開されているシグナルを集約し、リスクスコアを返します。コンプライアンス認証、法律上の助言、または取引相手の正当性を保証するものではありません。取引に関する判断は、ご自身の責任で行ってください。

開発元

L Squared Digital Holdings