alpacahq / alpacahq/alpaca-mcp-server

Add optional AOTrust notarization for agent-executed trades (x402, Ed25519 PDR)

Ouverte
#120 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub
Langage dominant
Python
Étoiles
961
Forks
311
Merge moyen
2 j 13 h
PR mergées (30 j)
4

Description

Hi! Great MCP server — we've been running a similar FastMCP production service and know how much care this stack takes.

I'd like to propose an **optional** integration: cryptographic receipts for agent-executed trades.

**The gap:** when an AI agent executes a trade via your MCP server, the agent's principal usually has no tamper-evident, independently-verifiable record of *what* the agent did, *when*, and *under which authorization*. Internal logs work, but they're self-issued — an auditor has to trust the operator.

**What AOTrust adds:** a 239-byte Ed25519-signed receipt (PDR — Provenance Data Record) that proves a specific action happened at a specific time. Receipts are anchored to NEAR blockchain daily, so anyone can verify them offline — no account, no install, no trust in our servers:

```
verify.aotrust.link/?pdr=
```

or programmatically via the public API. The PDR binary spec and an offline Python verifier are open source.

**Proposed change:** add `aotrust-protocol` (on PyPI, MIT) as an *optional* dependency. One line per call site:

```python
from agent_notary import AOTrustTool
receipt = AOTrustTool.run(work_hash=trade_hash) # → Ed25519 PDR, $0.01 x402 (or free tier)
```

- Payment: x402 protocol, $0.01 USDC on Base (EIP-3009), plus a free anonymous tier (5 receipts/IP/24h)
- Works as plain HTTP — no wallet needed on the server side
- Spec + offline verifier + SDK: https://github.com/GitSerge-crypto/aotrust-skills
- Discovery: https://shield.aotrust.link/.well-known/x402.json

Happy to adjust scope (e.g., only for `get_trade_history`-adjacent write ops, or behind a feature flag) — and happy to answer any questions about the trust model. We don't need to trust the notary: spec + offline verifier + daily NEAR anchor means anyone can check receipts independently.

Guide de contribution

Aucun guide de contribution indexé pour ce dépôt

Piste de recherche

Start by locating the MCP trade-execution entry points, especially write operations adjacent to get_trade_history, then review the linked AOTrust PDR specification and offline verifier. Before implementation, clarify receipt scope, optional-dependency and feature-flag behavior, and x402 payment handling; done should include independently verifiable receipts without affecting users who do not enable the integration.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Évaluation

Stack technique
blockchain, python
Domaine
backend, blockchain, security
Type d'issue
Fonctionnalité
Difficulté
5/5
Temps estimé
Plus d'une semaine
Activité
Active
Clarté
Plutôt claire
Accessibilité débutants
35/100

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.