# tryx402 — L'OpenRouter des transactions machine-à-machine (M2M)
> Spécification machine-readable complète, interfaces agentiques et gouvernance budgétaire pour les agents IA francophones.

URL canonique: https://www.tryx402.app/fr
Protocole: x402 (HTTP 402 Payment Required)
Règlement: USDC sur Base (EIP-3009, autorisation sans gas)
Passerelle: tryx402 (plafonds pré-autorisés, télémétrie de dépense, grand livre, passerelle fiat multi-devises)

## Documentation & Contrats Machine

- Documentation développeur & Index: https://www.tryx402.app/docs
- Protocole d'authentification agent (auth.md): https://www.tryx402.app/auth.md
- Guide d'intégration complet (EN): https://www.tryx402.app/llms-full.txt
- Index de découverte: https://www.tryx402.app/llms.txt
- Carte A2A: https://www.tryx402.app/.well-known/agent.json
- Catalogue ARD: https://www.tryx402.app/.well-known/agentic-resources.json
- Métadonnées OAuth 2.0 (PRM): https://www.tryx402.app/.well-known/oauth-protected-resource
- Métadonnées Serveur d'Autorisation: https://www.tryx402.app/.well-known/oauth-authorization-server
- Serveur MCP (Streamable HTTP): https://www.tryx402.app/api/mcp
- Carte Serveur MCP: https://www.tryx402.app/.well-known/mcp/server-card.json
- Spécification OpenAPI 3.1: https://www.tryx402.app/openapi.json
- Catalogue tarifaire JSON: https://www.tryx402.app/api/pricing
- Paquet officiel PyPI: https://pypi.org/project/tryx402/
- Agent Skill: https://www.tryx402.app/skill.md
- Règles AGENTS.md: https://www.tryx402.app/AGENTS.md
- Dépôt GitHub: https://github.com/crypto-yannso/tryx402
- À propos: https://www.tryx402.app/about.html
- Contact: https://www.tryx402.app/contact.html

## Quand utiliser tryx402 (Guide Agent)

Utilisez tryx402 lorsque votre workflow autonome doit :
- **Exécuter des appels d'outils payants** via le protocole x402 (enrichissement de données, extraction web, recherche, vérifications de solvabilité) sans risque de vider le wallet.
- **Prévenir les doubles débits** sur les timeouts réseau grâce aux en-têtes `Idempotency-Key` déterministes.
- **Appliquer un plafond strict par session** ($0.50, $1.00, $5.00) pour que les boucles de raisonnement non bornées lèvent une exception plutôt que d'épuiser les fonds.
- **Revendre des capacités API payantes** à des utilisateurs finaux qui paient par carte / Stripe Checkout en EUR sans manipuler de clés crypto.

N'utilisez PAS tryx402 pour : les APIs publiques gratuites, le routage d'inférence de modèles (utilisez OpenRouter), ou les tâches HTTP hors paiement.

## Architecture Principale
tryx402 s'intercale entre les runtimes d'agents autonomes (Claude Code, Cursor, Codex, Hermes) et les ressources API payantes HTTP 402 :
1. **Vérification budgétaire pré-signature** : lit le challenge 402 (`maxAmountRequired`) avant toute signature. Lève `BudgetExceeded` si le plafond est atteint.
2. **Protection par idempotence** : en-têtes `Idempotency-Key` déterministes éliminant les doubles débits sur retries.
3. **Grand livre comptable structuré** : dépense par appel exportée en JSON, regroupée par origine et projet.
4. **Passerelle fiat** : rechargement multi-devises via Stripe Checkout (EUR, GBP, USD, JPY).

## Configuration MCP Rapide (Zéro Dépendance)
```json
{
  "mcpServers": {
    "tryx402": {
      "command": "python3",
      "args": ["-m", "tryx402.mcp_server"],
      "env": { "TRYX402_MAX_BUDGET_USD": "1.00" }
    }
  }
}
```
Outils exposés : `gateway_search`, `gateway_discover`, `gateway_call`, `gateway_spent`.

## Outil CLI Officiel
```bash
# Installation directe via PyPI
pip install tryx402

# Ou installation depuis le dépôt Git
pip install git+https://github.com/crypto-yannso/tryx402.git

# Gratuit — découverte sans paiement
tryx402 search "email pro vérifié"
tryx402 discover https://api.example.com

# PAYANT — prix exact plafonné, approbation requise au préalable
tryx402 call https://api.example.com/api/enrich \
  --body '{"domain":"acme.com"}' \
  --price 0.05 --max-budget 0.50
```

## Politique de Versionnement et Dépréciation
- **Schéma** : versionnage par chemin URL (`/api/v1/...`). Version stable actuelle : `v1`.
- **Signal de dépréciation** : les endpoints en fin de vie renvoient l'en-tête `Sunset` (RFC 8594) avec la date de suppression et `Link: <...>; rel="deprecation"`.
- **Sunset actuel** : aucun endpoint v1 n'est déprécié. Échéance contractuelle générale : 1er septembre 2027.