AgentFi

La capa económica para la inteligencia no humana.

AgentFi proporciona infraestructura de transacciones cripto para agentes de IA en Ethereum y redes compatibles con EVM. Permite a los agentes ejecutar transacciones DeFi (swaps, yield farming, transferencias) sin manejar claves privadas ni gestionar gas, todo dentro de un marco de políticas seguro en la cadena (on-chain).

Empieza aquí:

• VISION.md — por qué existe este proyecto, hacia dónde va y los principios detrás de cada decisión técnica.

• STATE.md — qué es el proyecto hoy: propósito, stack completo, capacidades, progreso de fases.

• HANDOFF.md — tareas pendientes en vivo, inventario de credenciales, configuración de nuevas máquinas.

📚 Documentación

Toda la documentación del proyecto está organizada en nuestro Centro de Documentación.

Enlaces rápidos

• Visión (lectura obligatoria): Por qué existe este proyecto y hacia dónde va.

• Inicio rápido para desarrolladores: Stack local sin credenciales — docker compose up y estarás operando en 3 minutos.

• Configuración del operador: Pon en marcha una instancia real de AgentFi.

• Grafo de código Graphify: Mapa de código base consultable para el desarrollo asistido por agentes.

• Inicio rápido para agentes: Conecta tu agente en menos de 5 minutos.

• Arquitectura del sistema: Entiende el stack de 4 capas.

Related MCP server: Universal Crypto MCP

🚀 Características clave

• Carteras MPC llave en mano — claves divididas en fragmentos y nunca expuestas.

• Carteras inteligentes seguras — aplicación de políticas en la cadena por agente (límites, listas blancas, interruptor de emergencia).

• Protocolo de contexto de modelo — 28 herramientas en @agent_fi/mcp-server: ejecución DeFi, colaboración A2A, confianza y P&L.

• Cobertura DeFi — Uniswap V3 + Curve StableSwap (swaps); Aave V3, Compound V3 y cualquier bóveda ERC-4626 (rendimiento).

• Economía de agente a agente — cola de trabajos, pagos atómicos, depósito en garantía a nivel de base de datos (v2), puntuación de reputación basada en métricas reales con decaimiento temporal.

• Panel de P&L del agente — detección de punto de equilibrio por agente, incluyendo costos de gas reales (v2).

• Identidad persistente — subdominios ENS opcionales (alice-abc123.agentfi.eth) integrados en el registro del agente.

• Especificación OpenAPI 3.0.3 en docs/api/openapi.yaml — contrato legible por máquina para la generación de SDK.

• Multicadena — Ethereum, Base, Arbitrum, Polygon (Base Mainnet tiene contratos desplegados por el mantenedor).

• Motor de tarifas de protocolo — tarifa en puntos básicos cobrada en la cadena atómicamente a través de AgentExecutor.

🛠️ Primeros pasos

Para operadores

1. Sigue la Lista de verificación de configuración del operador para completar las cuentas de terceros y el .env local.

2. Despliega los Contratos inteligentes en tu cadena objetivo (o reutiliza las direcciones de Base desplegadas por el mantenedor en STATE.md).

3. Despliega el backend a través de la Guía de producción autohospedada — agnóstico al proveedor, con Railway como referencia y Fly.io / Render / Docker documentados como alternativas.

Para desarrolladores

1. Comienza con el Inicio rápido para desarrolladores — docker compose up → stack funcionando en 3 minutos, sin cuentas externas.

2. Ejecuta el Ejemplo de colaboración A2A — flujo de extremo a extremo de dos agentes en un solo archivo.

3. Ejecuta la Demo de MCP para Claude Desktop — dos identidades MCP, descubrimiento, trabajo A2A, confianza y P&L.

4. Revisa la Descripción general de la arquitectura.

5. Usa el Servidor MCP para integrar tus agentes.

🛡️ Seguridad

AgentFi está construido para una autonomía centrada en la seguridad.

• Simulaciones: Cada transacción se simula a través de Tenderly antes de enviarse.

• Barandillas: Las políticas en la cadena evitan que los agentes excedan los límites predefinidos.

• Interruptor de emergencia: Los operadores pueden pausar la capacidad de transacción de cualquier agente al instante.

¿Encontraste una vulnerabilidad? Consulta SECURITY.md para conocer nuestra política de divulgación.

🤝 Comunidad

• Código de conducta: Nuestros estándares comunitarios.

• Contribución: Cómo contribuir a AgentFi.

• Registro de cambios: Historial de versiones y cambios notables.

📄 Licencia

AgentFi es de código abierto y tiene la licencia Apache 2.0 License.