KARTA — spend control for AI agents

Name: KARTA — spend control for AI agents
Author: mrpkk

โดย mrpkkรุ่น 0.1.0i★ –iรันบนคลาวด์

ชื่อใน registrylat.rta.karta/guard

ติดตั้ง

ภาพรวม

คำอธิบายจากผู้ทำ (ภาษาอังกฤษตามต้นฉบับ)

Task envelope, budget ledger, kill switch and signed receipts for agents that pay.

สามเสาของ PopNx MCP

สามเรื่องนี้ไม่รวมเป็นคะแนนเดียว เพราะความเห็น การวัด และความนิยม เป็นคนละเรื่องกัน

เสียงผู้ใช้iยังไม่มีรีวิวรีวิวเปิดพร้อมระบบบัญชีในขั้นถัดไป
ผลตรวจเบื้องต้นของเราiผ่าน 2 จาก 3 ข้อตรวจจากข้อมูลที่เปิดอยู่ ยังไม่ได้สแกนโค้ด
การใช้งานiยังใหม่มาก★ –

ใช้ทำอะไรได้

ตัวนี้ยังไม่ได้เรียบเรียงเป็นภาษาไทย ด้านล่างคือข้อเท็จจริงที่เราอ่านจาก registry

การเชื่อมต่อ: รันบนคลาวด์
ช่องทาง (transport): Streamable HTTP
หมวด: บัญชี การเงิน และภาษี

ติดตั้ง

เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง

ก่อนติดตั้ง

ผลตรวจเบื้องต้น: ผ่าน 2 จาก 3 ข้อ
รันบนเครื่องของผู้ทำ สิ่งที่คุณถามจะผ่านเครื่องของเขา
ทำได้ 6 อย่าง (เครื่องมือ) check_spend, open_envelope, get_envelope, kill_envelope …
ทะเบียนไม่ได้ระบุ key ที่ต้องใส่

ต้องเตรียมก่อน

รันบนคลาวด์ไม่ต้องลงโปรแกรมเพิ่ม ต่อผ่านอินเทอร์เน็ตได้เลย

คุณใช้แอปไหน

ClaudeClaude CodeCursorVS CodeChatGPT

เลือกแอปด้านบน เราจำไว้ให้ ครั้งหน้าปุ่มจะขึ้นว่า “ติดตั้งลง …”

ใช้ได้ทั้ง Claude บนเว็บ แอปคอมพิวเตอร์ และมือถือ:

เปิด Settings → Connectors
กด Add custom connector
วางที่อยู่ด้านล่างแล้วกด Add
ถ้าให้ล็อกอิน ให้ล็อกอินกับผู้ทำ

https://karta.rta.lat/mcp

พิมพ์คำสั่งนี้ใน Terminal

claude mcp add --transport http guard https://karta.rta.lat/mcp

เปิดใน Cursor

หรือคัดลอกค่าตั้งเอง

วางในไฟล์ .cursor/mcp.json ของโปรเจกต์ หรือ ~/.cursor/mcp.json

{
  "mcpServers": {
    "guard": {
      "url": "https://karta.rta.lat/mcp"
    }
  }
}

เบราว์เซอร์จะถามก่อนเปิดแอป จากนั้นแอปแสดงค่าตั้งให้ตรวจแล้วกดยืนยัน ช่อง key เว้นว่างไว้ให้คุณใส่เอง

เปิดใน VS Code

หรือคัดลอกค่าตั้งเอง

วางในไฟล์ .vscode/mcp.json ของโปรเจกต์

{
  "servers": {
    "guard": {
      "type": "http",
      "url": "https://karta.rta.lat/mcp"
    }
  }
}

ChatGPT ต่อได้เฉพาะ server ที่อยู่บนอินเทอร์เน็ต:

เปิด ChatGPT บนเว็บ → Settings → Connectors (Apps)
กด Create หรือ Add (บางแพ็กเกจต้องเปิด Developer mode ใน Advanced ก่อน)
วางที่อยู่ด้านล่าง ตั้งชื่อ แล้วบันทึก
ถ้าให้ล็อกอิน ให้ล็อกอินกับผู้ทำ

https://karta.rta.lat/mcp

ชื่อเมนูอาจต่างกันเล็กน้อยตามแพ็กเกจและรุ่นของแอป

ตัวเลือกเก็บในคุกกี้บนเครื่องนี้ ไม่ต้องมีบัญชี

ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README

ทำอะไรได้บ้าง

ชื่อและคำอธิบายเครื่องมือตามที่ server ตอบมาเมื่อ 7 พ.ย. 2569 ผู้ทำเป็นคนเขียน ไม่ใช่เรา แสดงเป็นข้อความล้วน

check_spend
Check whether a proposed agent spend is inside a task envelope. Returns verdict, rule, reason, counterfactual and next. No state is stored.
open_envelope
Create a signed budget envelope for one task: total budget, per-call cap, call count, allowlisted payees, subscription rule, expiry. Stores it in this server's local ledger (no funds move, no keys). Returns the envelope id. Capped at 30 envelopes/hour per server.
get_envelope
Return an envelope's state: budget, per-call cap, calls used, spent, remaining, allowlist and expiry. Read-only.
kill_envelope
Stop one task envelope immediately: no further spend is approved for it, the reason is recorded with a timestamp. Idempotent — the first reason wins.
envelope_evidence
Return an evidence bundle for one envelope: state, every recorded spend, the stop record and a sha256 of the whole pack that anyone can recompute. Read-only.
policy_rules
List the deterministic rules a spend is checked against (E01-E08) with the order they are applied and the meaning of each. Read-only, no state.

ผลตรวจเบื้องต้นi

เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 8 พ.ย. 2569

! ควรระวัง
ตัวตนผู้ทำตรงกับ repo
ผู้ลงทะเบียน (karta.rta.lat) ไม่ใช่เจ้าของ repo (mrpkk) อาจเป็นคนอื่นที่นำมาลงต่อ
… ยังไม่ตรวจ
ยังมีคนดูแล
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
… ยังไม่ตรวจ
มีสัญญาอนุญาต (license)
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
✓ ผ่าน
endpoint ตอบ
ตอบกลับใน 1304 ms (HTTP 200)
– ไม่เกี่ยว
ล็อกอินแบบ OAuth
ไม่ต้องล็อกอิน
✓ ผ่าน
คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง
อ่านคำอธิบายเครื่องมือ 6 ตัวแล้ว ไม่พบคำสั่งแอบแฝงถึง AI

เทียบกับตัวอื่นในหมวด บัญชี การเงิน และภาษีi

ดาวมากกว่า 0% ของอีก 2937 ตัวในหมวดนี้
ส่งรุ่นใหม่เข้า registry ล่าสุดกว่า 69% ของอีก 2937 ตัวในหมวดนี้
ผลตรวจเบื้องต้นดีกว่าหรือเท่ากับ 46% ของอีก 2937 ตัวในหมวดนี้

เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo

คำถามที่พบบ่อย

KARTA — spend control for AI agents ปลอดภัยไหม?

จากการตรวจเบื้องต้นของเรา ผ่าน 2 จาก 3 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น

ต้องใช้กุญแจหรือรหัสอะไรบ้าง?

registry ไม่ได้ระบุว่าต้องใช้กุญแจ แต่บางตัวจะขอให้ล็อกอินตอนใช้ครั้งแรก

ตัวนี้รันบนเครื่องหรือบนคลาวด์?

รันบนคลาวด์ของผู้ทำ ต่อผ่านอินเทอร์เน็ตได้เลย ไม่ต้องลงโปรแกรม แต่ข้อมูลที่ส่งให้จะผ่านเซิร์ฟเวอร์ของผู้ทำ

ยังมีคนดูแลอยู่ไหม?

repo บน GitHub มีการแก้โค้ดล่าสุด – และส่งรุ่นล่าสุด (0.1.0) เข้า registry 13 วันที่ผ่านมา

ใช้กับโปรแกรมไหนได้บ้าง?

โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต่อผ่าน URL จึงใช้กับโปรแกรมที่รับ remote MCP ได้ เช่น ChatGPT ที่เปิดโหมดนักพัฒนา

มีตัวไหนใช้แทนได้บ้าง?

ในหมวดเดียวกันมี Finance Toolkit, SolidInvoice, Korea Tax Calculator

ตัวที่ใช้แทนได้

server หมวดเดียวกันจากผู้ทำคนอื่น เรียงตามดาว

อ่านการ์ด:↓ ดาวน์โหลดต่อสัปดาห์i★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi

Finance Toolkit

500+ transparent financial methods calculated from raw statements, not third-party endpoints.

โดย JerBoumaใช้กันมาก↓ 15.5K/สัปดาห์★ 5.5Kอัปเดต เมื่อวานซืน

บนเครื่องหรือคลาวด์

ติดตั้ง

SolidInvoice

Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.

โดย SolidInvoiceกำลังโต★ 981อัปเดต 9 วันที่ผ่านมา

รันบนคลาวด์✓ solidinvoice.co

ติดตั้ง

Korea Tax Calculator

Korean tax calculation and tax-audit judgment MCP: 96 tools with statutory citations.

โดย UpstageAIกำลังโต↓ 3.2K/สัปดาห์★ 97อัปเดต วันนี้

รันบนเครื่อง

ติดตั้ง

README จากผู้ทำ

เปิดอ่าน README

ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ

KARTA — onchain-ai-agent

Trust layer между AI и ончейн-действием. Агент предлагает → детерминированная политика

(Dharma Engine) разрешает → симуляция подтверждает → человек аппрувит → Karma Engine

исполняет → Sakshi Log доказывает.

Статус: v2 в разработке (ветка feature/v2-modernization). Тесты: 116 backend + 56 контрактов.

Канон-спека: Документы/work/projectBooks/OnChainKartaSPEC.md.

✅ Что реально работает (проверено тестами)

Область	Статус
Auth	Argon2id; JWT access 15 мин + refresh 7 дней (ротация, reuse-detection → отзыв семьи, revoke-all); rate-limit логина 5/мин; legacy-sha256-миграция
Хранилище	PostgreSQL 16 (14 таблиц, Alembic-миграции); данные переживают рестарт (тест «engine reset = restart»)
Dharma Engine	15 правил (лимиты per-tx/daily/velocity, газ-кап, slippage, black/whitelist, окно, breakers, approve-гигиена); вердикты allow/deny/require_approval; гейт в ОБОИХ путях исполнения; `DHARMA_ENFORCE=off` для отката
Approve	Только точные суммы; `2^256-1` заблокирован (`INFINITE_APPROVE_BLOCKED`); `revoke_approve`
KeyVault	Ключ только через vault (lazy-init), `core.py` не читает ключ из конфига (guard-тест)
Безопасность исполнения	Simulation-mode (дефолт); реальное исполнение — за флагом (READ+SIMULATE+PROPOSE)
Kill switch	soft/hard, терминальный (без auto-resume), drill-тесты
Sakshi Log	HMAC-цепочка (`prev_hash‖canonical(payload)`), append-only (PG-триггер), экспорт `json\	csv`
Decision Diary	Каждое решение (action/reasoning/confidence/risk/policy_verdict) пишется в БД
Live-события	`WS /ws?token=` — agent.status, decision.proposed (fan-out, 4401 при невалидном токене)
LLM	Цепочка GigaChat → DeepSeek → Qwen → агрегатор → Ollama; structured output (pydantic) + repair + circuit breaker 3×60с; fail-safe `ask_human`
Mempool	Реальный сканер блоков: watch-фильтр адресов + газ-тренд; честный `rpc_unavailable` без выдумок
Health	`/health` + `/health/deep`: реальные TCP/RPC/LLM/KeyVault-проверки → ok/degraded/down
Контракты	AgentRegistry + Escrow + RicardianAgreement: 56 hardhat-тестов, Slither (`fail-on: high`) в CI

🚧 Чего ещё нет (честно)

Реальное исполнение транзакций, swap/bridge/deploy — Phase 5 (STOP-GATE)
Кокпит-UI, Telegram-approve, i18n — Phase 4
ERC-4337 session keys, private RPC, MEV-защита — Phase 5
MCP-сервер наружу (read-tools) — Phase 6
RefreshStore пока in-memory (таблица refresh_tokens готова — миграция слоем позже)

🔌 API (37 маршрутов + WebSocket; авто-перечень — `docs/API.md`)

Метод	Путь	Назначение
POST	`/api/v1/auth/register` · `/token` · `/refresh` · `/revoke-all` · `/logout`	Argon2id, JWT-пара с ротацией и reuse-detection
POST/GET	`/api/v1/agents`	Создать / список агентов (тиры 0–3, авто-политика тира)
GET	`/api/v1/agents/{id}`	Карточка агента
POST	`/api/v1/agents/{id}/start` · `/stop` · `/heartbeat`	Жизненный цикл (+ dead-man switch)
POST	`/api/v1/agents/{id}/goal` · `/intent` · `/intent/confirm`	Цель; чат-задача NL→intent с Dharma-превью
GET/PUT	`/api/v1/agents/{id}/policy` · POST `/policy/from-text` · `/policy/simulate`	Версии Dharma-политики; правила словами; impact-симулятор
GET	`/api/v1/agents/{id}/decisions` · `/pending` · `/audit` · `/drift`	Decision Diary; undo-очередь; Sakshi; дрейф
GET	`/api/v1/agents/{id}/reports/summary` · `/export.csv`	Health/Trust/дрейф-сводка; CSV (decisions/transactions/audit)
GET/POST	`/api/v1/approvals` · `/approvals/{id}/approve	reject `·` /pending/{id}/cancel`	Approvals-inbox (web=Telegram, единый путь)
GET/POST/PUT	`/api/v1/decisions/{id}`	Replay: текущий вердикт vs сохранённый
POST	`/api/v1/agents/{id}/kill-switch`	Экстренная остановка (soft/hard, терминальная)
GET	`/api/v1/agents/{id}/transactions`	История транзакций
GET/POST/DELETE	`/api/v1/api-keys`	API-ключи `karta_` для MCP (scope mcp:read)
POST	`/mcp`	MCP-сервер (streamable HTTP, stateless, read-only v1) — см. `docs/MCP.md`
GET/POST	`/api/v1/ricardian/*`	Ricardian 2-of-3: соглашения, подписи, вехи, споры (Sepolia)
GET/POST	`/api/v1/agents/{id}/registry`	ERC-8004-паспорт: регистрация/верификация/репутация + бейджи
GET	`/api/v1/registry/agents/{id}/metadata`	Публичный паспорт агента (metadataURI, без auth)
GET/POST	`/api/v1/escrow/*`	Аренда агентов: эскроу-оплата, release/refund/dispute/resolve (Sepolia)
GET	`/api/v1/x402/demo/premium`	x402-демо: 402 → EIP-3009-подпись → сеттлмент (Sepolia, токен без ценности)
GET	`/api/v1/chains`	Multi-chain реестр: 6 сетей (ETH/Sepolia/Base/Base Sepolia/BSC/Polygon) + health
GET/POST	`/api/v1/swap/*`	Swap: котировка, slippage-guard, исполнение (MockDEX/Uniswap-V2, Sepolia)
GET/POST	`/api/v1/bridge/*`	Bridge: реальные котировки LI.FI (AcrossV4), статус; исполнение gated
GET/POST	`/api/v1/erc4337/*`	ERC-4337: smart account, session keys (TTL/лимит/цель), guardians
GET	`/api/v1/health` · `/health` · `/health/deep`	Честные проверки компонентов
WS	`/ws?token=`	Live-события
GET	`/docs` · `/openapi.json`	OpenAPI/Swagger

🚀 Быстрый старт

# 1) PostgreSQL (dev): контейнер на 5433 (системный PG занимает 5432)

docker compose up -d postgres # или: docker run -d --name karta-postgres \

-e POSTGRES_USER=agent -e POSTGRES_PASSWORD=agent \

-e POSTGRES_DB=onchain_ai -p 5433:5432 postgres:16-alpine

2) Зависимости

python3 -m venv backend/.venv && backend/.venv/bin/pip install -r backend/requirements.txt

3) Схема

cd backend && DATABASE_URL=postgresql+asyncpg://agent:agent@127.0.0.1:5433/onchain_ai \ .venv/bin/alembic upgrade head

4) Запуск

DEBUG=true .venv/bin/uvicorn src.api.main:app --port 8000 # из backend/

5) Swagger: http://127.0.0.1:8000/docs

Ключевые переменные окружения (только `~/.env`, chmod 600)

Переменная	Назначение
`DATABASE_URL`	`postgresql+asyncpg://agent:agent@127.0.0.1:5433/onchain_ai`
`JWT_SECRET_KEY`	`openssl rand -hex 32` (обязательно в prod)
`ONCHAIN_MASTER_KEY`	мастер-ключ KeyVault
`SAKSHI_AUDIT_KEY`	ключ HMAC-цепочки аудита
`GIGACHAT_AUTH_KEY`	GigaChat (первичный LLM)
`DEEPSEEK_API_KEY_*`	DeepSeek (fallback)

🧪 Тесты

# Backend: 338 тестов + coverage-гейт 80%

backend/.venv/bin/python -m pytest backend/tests -q --cov=src --cov-fail-under=80

Контракты: 56 тестов (hardhat)

cd smart-contracts && npx hardhat test

Live E2E-смоук (13 проверок) против запущенного сервера:

python3 scripts/e2e_live.py # KARTA_E2E_BASE/USER/PASS — при необходимости

🏗 Архитектура (кратко)

Human → REST /api/v1 + WS /ws → [Dharma Engine] → [Simulation] → [Timelock/Approval] → [Karma Engine] → Chain*

↓ ↓ Sakshi Log (HMAC, append-only) ← Decision Diary (decisions)

Реальное исполнение on-chain — Phase 5 (STOP-GATE); сейчас: тиры 0–1 simulation-mode, тиры 2–3 за гейтами

Инварианты: LLM не получает ключ; tx не подписывается без policy-вердикта и симуляции; любая ошибка → hold + ask_human; ни один слой не контролирует pipeline единолично.

📚 Документы

PROGRESS.md — мега-контекст, реестр слайсов, журнал
docs/AUDIT_REPORT.md — actual-vs-claimed аудит
docs/THREAT_MODEL.md — STRIDE T1–T12
docs/ARCHITECTURE_CURRENT.md — фактическая архитектура (до модернизации)
docs/ARCHITECTURE.md · docs/SECURITY.md — as-built архитектура и security-posture
docs/API.md — перечень API (генератор docs/generate_api_md.py)
docs/MCP.md · docs/MCP_TOOL_CONTRACTS.md — MCP-сервер: подключение и контракты (генератор docs/generate_mcp_contracts.py)
docs/X402.md — x402-демо (тестнет): поток, запуск, честные ограничения
docs/DEPLOYMENT.md — развёртывание (dev/prod, env, адреса Sepolia)
CHANGELOG.md — релизы v2.0-alpha / v2.0-beta
smart-contracts/ — Solidity 0.8.20 + Hardhat

Дисклеймер: не является финансовой рекомендацией. Автономный агент действует в границах

политик владельца; реальное исполнение — только после отдельного решения (STOP-GATE).

KARTA — spend control for AI agents

ภาพรวม

สามเสาของ PopNx MCP

ใช้ทำอะไรได้

ติดตั้ง

ก่อนติดตั้ง

ทำอะไรได้บ้าง

ผลตรวจเบื้องต้นi

ตัวตนผู้ทำตรงกับ repo

ยังมีคนดูแล

มีสัญญาอนุญาต (license)

endpoint ตอบ

ล็อกอินแบบ OAuth

คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง

เทียบกับตัวอื่นในหมวด บัญชี การเงิน และภาษีi

คำถามที่พบบ่อย

ตัวที่ใช้แทนได้

Finance Toolkit

SolidInvoice

Korea Tax Calculator

README จากผู้ทำ

KARTA — onchain-ai-agent

✅ Что реально работает (проверено тестами)

🚧 Чего ещё нет (честно)

🔌 API (37 маршрутов + WebSocket; авто-перечень — docs/API.md)

🚀 Быстрый старт

-e POSTGRES_USER=agent -e POSTGRES_PASSWORD=agent \

-e POSTGRES_DB=onchain_ai -p 5433:5432 postgres:16-alpine

2) Зависимости

3) Схема

4) Запуск

5) Swagger: http://127.0.0.1:8000/docs

Ключевые переменные окружения (только ~/.env, chmod 600)

🧪 Тесты

Контракты: 56 тестов (hardhat)

Live E2E-смоук (13 проверок) против запущенного сервера:

🏗 Архитектура (кратко)

📚 Документы

🔌 API (37 маршрутов + WebSocket; авто-перечень — `docs/API.md`)

Ключевые переменные окружения (только `~/.env`, chmod 600)