VERITY

VERITY هي وكيل ذكاء اصطناعي مستقل مبني على l402-kit. تبيع 10 خدمات عبر بروتوكول L402، وتجمع خزينة Bitcoin، وتضبط أسعارها بنفسها بناءً على الطلب — دون تدخل بشري. نقطة الاستكشاف: GET https://l402kit.com/api/verity

الخدمات العشر

الخدمة	نقطة الوصول	السعر	المتطلبات
البحث على الويب	`/api/verity/search`	100 sats	—
استخراج بيانات الويب	`/api/verity/scrape`	200 sats	—
سعر BTC	`/api/verity/btc-price`	10 sats	—
التلخيص	`/api/verity/summarize`	50 sats	—
تحليل المشاعر	`/api/verity/sentiment`	30 sats	—
معلومات النطاق	`/api/verity/domain-intel`	500 sats	—
تكامل l402-kit	`/api/verity/integration`	10,000 sats	—
حالة العالم	`/api/verity/worldstate`	80 sats	—
الترجمة	`/api/verity/translate`	50 sats	—
البحث المعمّق	`/api/verity/research`	300 sats	—

الأسعار ديناميكية — تضبطها VERITY كل 30 دقيقة بناءً على الطلب.

كيفية الدفع

كل خدمة تتبع معيار L402:

# الخطوة 1 — طلب الخدمة (الحصول على الفاتورة)
curl -i https://l402kit.com/api/verity/btc-price

# HTTP/1.1 402 Payment Required
# WWW-Authenticate: L402 macaroon="...", invoice="lnbc..."

# الخطوة 2 — ادفع الفاتورة بأي محفظة Lightning
# الخطوة 3 — أعد المحاولة مع إثبات الدفع
curl -H "Authorization: L402 <macaroon>:<preimage>" \
  https://l402kit.com/api/verity/btc-price

الدفع الآلي باستخدام L402Client

import { L402Client } from "l402-kit/agent";
import { BlinkWallet } from "l402-kit/wallets";

const client = new L402Client({
  wallet: new BlinkWallet(process.env.BLINK_API_KEY!),
  budget: { maxSats: 500 },
});

// BTC price — 10 sats
const price = await client.fetch("https://l402kit.com/api/verity/btc-price");
const data = await price.json();
console.log(data.bitcoin.usd);

// World state — 80 sats
const world = await client.fetch("https://l402kit.com/api/verity/worldstate");
const state = await world.json();
console.log(state.time.utc, state.location.city, state.weather.temperature_c);

مرجع الخدمات

البحث — 100 sats

بحث على الويب يُعيد أفضل 10 نتائج عضوية.

# GET
curl -H "Authorization: L402 <token>" \
  "https://l402kit.com/api/verity/search?q=bitcoin+lightning"

# POST
curl -X POST -H "Authorization: L402 <token>" \
  -H "Content-Type: application/json" \
  -d '{"q":"bitcoin lightning"}' \
  https://l402kit.com/api/verity/search

الاستجابة:

{
  "agent": "VERITY",
  "service": "search",
  "query": "bitcoin lightning",
  "results": [
    { "title": "...", "link": "...", "snippet": "..." }
  ],
  "paid_with": "⚡ Lightning L402"
}

استخراج بيانات الويب — 200 sats

يُعيد محتوى الصفحة الكامل بصيغة markdown.

curl -X POST -H "Authorization: L402 <token>" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}' \
  https://l402kit.com/api/verity/scrape

سعر BTC — 10 sats

سعر Bitcoin في الوقت الفعلي بالدولار الأمريكي واليورو والريال البرازيلي.

curl -H "Authorization: L402 <token>" \
  https://l402kit.com/api/verity/btc-price

الاستجابة:

{
  "bitcoin": { "usd": 98000, "eur": 90000, "brl": 550000 },
  "timestamp": "2026-05-10T12:00:00.000Z"
}

التلخيص — 50 sats

تلخيص بالذكاء الاصطناعي يصل إلى 50,000 حرف.

curl -X POST -H "Authorization: L402 <token>" \
  -H "Content-Type: application/json" \
  -d '{"text":"...long text...", "language":"portuguese"}' \
  https://l402kit.com/api/verity/summarize

تحليل المشاعر — 30 sats

تحليل المشاعر مع الدرجة، ومستوى الثقة، والكلمات المفتاحية.

curl -X POST -H "Authorization: L402 <token>" \
  -H "Content-Type: application/json" \
  -d '{"text":"Bitcoin is the future of money"}' \
  https://l402kit.com/api/verity/sentiment

الاستجابة:

{
  "analysis": {
    "sentiment": "positive",
    "score": 0.92,
    "confidence": 0.88,
    "keywords": ["bitcoin", "future", "money"]
  }
}

معلومات النطاق — 500 sats

WHOIS وسجلات DNS وشهادات SSL. لا يتطلب مفتاح API — يستخدم RDAP العام وcrt.sh.

curl -H "Authorization: L402 <token>" \
  "https://l402kit.com/api/verity/domain-intel?domain=example.com"

الاستجابة:

{
  "domain": "example.com",
  "whois": { "registrar": "...", "registered": "...", "expires": "..." },
  "dns": { "a_records": ["93.184.216.34"] },
  "certificates": [{ "issued": "...", "expires": "...", "issuer": "..." }]
}

تكامل l402-kit — 10,000 sats

أرسل رابط مستودع GitHub عام. تحلل VERITY قاعدة الكود وتُعيد كود تكامل l402-kit الكامل.

curl -X POST -H "Authorization: L402 <token>" \
  -H "Content-Type: application/json" \
  -d '{"repoUrl":"https://github.com/owner/repo"}' \
  https://l402kit.com/api/verity/integration

الاستجابة:

{
  "repo": "owner/repo",
  "integration": "## Detected: Express.js\n\n```typescript\nimport { l402 } from 'l402-kit';\n...",
  "next_steps": ["Apply integration code", "Set env vars", "Deploy and test"]
}

حالة العالم — 80 sats

الوقت بتوقيت UTC + تحديد الموقع الجغرافي للمتصل + الطقس المحلي في استدعاء واحد. بدون أي تكلفة لواجهات API الخارجية.

curl -H "Authorization: L402 <token>" \
  https://l402kit.com/api/verity/worldstate

الاستجابة:

{
  "time": {
    "utc": "2026-05-10T14:32:00.000Z",
    "unix": 1778421120,
    "hour": 14, "minute": 32, "weekday": "Sun"
  },
  "location": {
    "city": "São Paulo", "country": "BR", "timezone": "America/Sao_Paulo"
  },
  "weather": {
    "temperature_c": 23.4,
    "feels_like_c": 22.1,
    "humidity_pct": 68,
    "condition": "partly cloudy"
  }
}

البحث المعمّق — 300 sats

حزمة بحث شاملة: بحث + استخراج بيانات + تلخيص بالذكاء الاصطناعي في استدعاء واحد. يوفّر 3 مدفوعات منفصلة وثلاثة أضعاف زمن الاستجابة.

curl -X POST -H "Authorization: L402 <token>" \
  -H "Content-Type: application/json" \
  -d '{"query": "bitcoin lightning network adoption 2026"}' \
  https://l402kit.com/api/verity/research

الاستجابة:

{
  "agent": "VERITY",
  "service": "research",
  "query": "bitcoin lightning network adoption 2026",
  "summary": "Lightning Network adoption has accelerated significantly in 2026...",
  "scraped_url": "https://example.com/article",
  "sources": [
    { "title": "...", "link": "...", "snippet": "..." }
  ],
  "provider": "serper",
  "paid_with": "⚡ Lightning L402"
}

مقارنةً باستدعاء الخدمات بشكل منفصل: بحث (100 sats) + استخراج بيانات (200 sats) + تلخيص (50 sats) = 350 sats إجمالاً. البحث المعمّق يكلف 300 sats — أرخص ودفعة واحدة.

الترجمة — 50 sats

تُترجم النصوص أو توثيق MDX إلى أي من 11 لغة مدعومة. عند تحديد format بقيمة mdx، تُحفظ كتل الكود ومكونات MDX والروابط والمصطلحات التقنية كما هي — ويُترجم النص العادي فقط. اللغات المدعومة: pt, es, zh, ar, hi, fr, de, ru, ja, it, en

curl -X POST -H "Authorization: L402 <token>" \
  -H "Content-Type: application/json" \
  -d '{"text": "Pay once, access forever.", "locale": "pt", "format": "plain"}' \
  https://l402kit.com/api/verity/translate

صيغة MDX (تحفظ كتل الكود والمكونات):

curl -X POST -H "Authorization: L402 <token>" \
  -H "Content-Type: application/json" \
  -d '{"text": "---\ntitle: Quickstart\n---\n\nPay with Lightning.", "locale": "ja", "format": "mdx"}' \
  https://l402kit.com/api/verity/translate

الاستجابة:

{
  "agent": "VERITY",
  "service": "translate",
  "locale": "pt",
  "language": "Brazilian Portuguese",
  "format": "plain",
  "translated": "Pague uma vez, acesse para sempre.",
  "source_length": 26,
  "paid_with": "⚡ Lightning L402"
}

الحد الأقصى للإدخال: 100,000 حرف لكل استدعاء.

التسعير الديناميكي

تضبط VERITY الأسعار كل 30 دقيقة:

طلب مرتفع (> حد معين من الاستدعاءات/الساعة) → السعر × 1.1
طلب معدوم (ساعتان متتاليتان)                → السعر × 0.9
حماية الحد الأدنى                            → السعر لا ينخفض أبدًا عن الحد الأدنى

تحقق من الأسعار الحالية في أي وقت:

curl https://l402kit.com/api/verity | jq '.services[].priceSats'

نقاط النهاية العامة للاكتشاف

لا تتطلب هذه النقطتان دفع L402 — تكشفان عن كتالوج VERITY وبياناتها المالية للتدقيق والاكتشاف.

GET /api/verity/services

كتالوج قابل للقراءة آليًا لجميع الخدمات النشطة مع التسعير الفوري والحد الأدنى وعتبات الزيادة.

curl https://l402kit.com/api/verity/services

{
  "services": [
    {
      "id": "search",
      "endpoint": "https://l402kit.com/api/verity/search",
      "price_sats": 500,
      "floor_sats": 500,
      "cogs_sats": 50,
      "surge_threshold": 50
    }
  ],
  "count": 10,
  "updated": "2026-05-12T14:32:00.000Z"
}

GET /api/verity/fiscal

التقرير المالي اليومي لـ VERITY — الإيرادات والتكاليف والهامش والتفصيل حسب الخدمة. يُنشأ يوميًا في 00:00 UTC.

curl https://l402kit.com/api/verity/fiscal

{
  "date": "2026-05-12",
  "agent": "VERITY",
  "revenue_sats": 8450,
  "consumer_spent_sats": 340,
  "net_sats": 8110,
  "margin_pct": "95.98",
  "usd_equivalent": "10.00",
  "btc_usd_rate": 95000,
  "breakdown": {
    "search": { "calls": 21, "price": 500, "revenue": 10500, "success_rate": 98 }
  },
  "generated_at": "2026-05-12T00:00:01.000Z"
}

تُحفظ التقارير لمدة 7 أيام. يُرجع 404 إذا لم يُنشأ تقرير اليوم بعد.

واجهة برمجة المشغّل

إذا قمت بنسخ VERITY لتشغيل وكيلك الخاص، تتيح لك هذه النقاط تغيير التسعير والميزانيات في وقت التشغيل — دون الحاجة إلى نشر جديد. جميع مسارات الإدارة تتطلب رأس DASHBOARD_SECRET:

Authorization: Bearer <DASHBOARD_SECRET>

GET /api/verity/admin/config

يُعيد إعدادات التسعير الحالية وإنفاق المستخدم لجميع الخدمات.

curl -H "Authorization: Bearer <secret>" \
  https://l402kit.com/api/verity/admin/config

الاستجابة:

{
  "configs": {
    "search":  { "base": 100, "floor": 50, "surgeThreshold": 50, "cogs": 2 },
    "translate": { "base": 50, "floor": 50, "surgeThreshold": 30, "cogs": 1 }
  },
  "prices": { "search": 100, "translate": 50 },
  "consumer": { "spent_today": 340, "budget": 10000 }
}

POST /api/verity/admin/config

يُحدّث معاملات التسعير لخدمة محددة. يُغيَّر فقط الحقول المُدرجة.

curl -X POST -H "Authorization: Bearer <secret>" \
  -H "Content-Type: application/json" \
  -d '{"service": "search", "base": 150, "floor": 80}' \
  https://l402kit.com/api/verity/admin/config

الحقل	الوصف
`service`	اسم الخدمة (مطلوب)
`base`	السعر الأساسي بـ sats
`floor`	الحد الأدنى للسعر (لا ينخفض عنه التسعير الديناميكي أبدًا)
`surgeThreshold`	عدد الاستدعاءات/الساعة الذي يُفعّل زيادة بنسبة 10%
`cogs`	تكلفة البضائع بـ sats (تستخدمها الوكالة المالية)

POST /api/verity/admin/budget

يضبط حد الإنفاق اليومي للمستخدم.

curl -X POST -H "Authorization: Bearer <secret>" \
  -H "Content-Type: application/json" \
  -d '{"sats": 5000}' \
  https://l402kit.com/api/verity/admin/budget

الحد الأدنى: 100 sats. تسري التغييرات فورًا.

البنية التقنية

VERITY (agent:shinydapps.verity)
  ├── 10 L402-protected services
  ├── Treasury: shinydapps@blink.sv
  ├── Heartbeat: every 30min (price adjustment + Satring market scan)
  ├── Query cache: KV-backed, per-service TTL (5min–24h)
  ├── Fiscal Agent: daily report at 00:00 UTC → GET /api/verity/fiscal
  ├── Service catalog: machine-readable → GET /api/verity/services
  ├── Agent contract: GET /.well-known/agent.json → verity block
  └── LAW-N: behavioral events emitted per transaction

VERITY مفتوحة المصدر — يمكن نسخ نفس البنية التقنية لإنشاء وكيلك المستقل الخاص.

​VERITY

​الخدمات العشر

​كيفية الدفع

​الدفع الآلي باستخدام L402Client

​مرجع الخدمات

​البحث — 100 sats

​استخراج بيانات الويب — 200 sats

​سعر BTC — 10 sats

​التلخيص — 50 sats

​تحليل المشاعر — 30 sats

​معلومات النطاق — 500 sats

​تكامل l402-kit — 10,000 sats

​حالة العالم — 80 sats

​البحث المعمّق — 300 sats

​الترجمة — 50 sats

​التسعير الديناميكي

​نقاط النهاية العامة للاكتشاف

​GET /api/verity/services

​GET /api/verity/fiscal

​واجهة برمجة المشغّل

​GET /api/verity/admin/config

​POST /api/verity/admin/config

​POST /api/verity/admin/budget

​البنية التقنية

VERITY

الخدمات العشر

كيفية الدفع

الدفع الآلي باستخدام L402Client

مرجع الخدمات

البحث — 100 sats

استخراج بيانات الويب — 200 sats

سعر BTC — 10 sats

التلخيص — 50 sats

تحليل المشاعر — 30 sats

معلومات النطاق — 500 sats

تكامل l402-kit — 10,000 sats

حالة العالم — 80 sats

البحث المعمّق — 300 sats

الترجمة — 50 sats

التسعير الديناميكي

نقاط النهاية العامة للاكتشاف

GET /api/verity/services

GET /api/verity/fiscal

واجهة برمجة المشغّل

GET /api/verity/admin/config

POST /api/verity/admin/config

POST /api/verity/admin/budget

البنية التقنية