{"id":51476009,"url":"https://github.com/alberto2005-coder/trustmm-discord-bot","last_synced_at":"2026-07-06T21:01:07.756Z","repository":{"id":359375664,"uuid":"1242609633","full_name":"alberto2005-coder/TrustMM-Discord-Bot","owner":"alberto2005-coder","description":"Un bot de Discord seguro y totalmente automatizado para actuar como intermediario (Escrow / Middleman) en transacciones P2P de Litecoin (LTC) en tiempo real.","archived":false,"fork":false,"pushed_at":"2026-05-21T15:20:18.000Z","size":28,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-22T00:20:27.105Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alberto2005-coder.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-18T15:27:31.000Z","updated_at":"2026-05-21T15:27:13.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/alberto2005-coder/TrustMM-Discord-Bot","commit_stats":null,"previous_names":["alberto2005-coder/trustmm-discord-bot"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/alberto2005-coder/TrustMM-Discord-Bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alberto2005-coder%2FTrustMM-Discord-Bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alberto2005-coder%2FTrustMM-Discord-Bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alberto2005-coder%2FTrustMM-Discord-Bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alberto2005-coder%2FTrustMM-Discord-Bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alberto2005-coder","download_url":"https://codeload.github.com/alberto2005-coder/TrustMM-Discord-Bot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alberto2005-coder%2FTrustMM-Discord-Bot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35205739,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-06T02:00:07.184Z","response_time":106,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-07-06T21:01:06.609Z","updated_at":"2026-07-06T21:01:07.730Z","avatar_url":"https://github.com/alberto2005-coder.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 TrustMM - Bot de Discord de Escrow / Intermediario Automático de Litecoin (LTC)\n\n\u003e **IDIOMA / LANGUAGE**: [Español (ES)](#español) | [English (EN)](#english)\n\n---\n\n## Español\n\n**TrustMM** es un bot de Discord seguro y totalmente automatizado para actuar como intermediario o **Escrow / Middleman** en transacciones peer-to-peer (P2P) de **Litecoin (LTC)**. Elimina la necesidad de intermediarios manuales en las transacciones de criptomonedas mediante el uso de monederos temporales (\"hot-wallets\") y el monitoreo de transacciones entrantes directamente en la blockchain en tiempo real.\n\n---\n\n## 📋 Características\n\n- **Creación Automatizada de Tickets**: Creación instantánea de canales de texto privados dedicados exclusivamente a cada transacción entre Comprador y Vendedor.\n- **Selección de Roles Dinámica**: Interfaz intuitiva con botones interactivos para definir quién actúa como Comprador y quién como Vendedor.\n- **Modales Interactivos Seguros**: Transición de entradas por mensajes de texto (`wait_for`) a modales emergentes interactivos integrados en Discord para configurar detalles del trato y capturar direcciones de monedero de manera limpia y sin interferencias en el chat.\n- **Soporte de Divisas Personalizables**: Permite al vendedor seleccionar su divisa fiat preferida (como USD, EUR, GBP, ARS, etc.) al configurar la transacción, obteniendo la tasa de conversión a LTC en tiempo real mediante la API de Coinbase.\n- **Validación Avanzada de Direcciones LTC**: Validación automatizada mediante expresiones regulares (Regex) de direcciones Litecoin en mainnet (formatos Legacy `L...`, P2SH `M...` y Bech32 `ltc1...`) para evitar transacciones a direcciones inválidas o incorrectas.\n- **Sanitización Robusta de Montos**: Capacidad de procesar y limpiar cantidades monetarias ingresadas por el usuario eliminando automáticamente espacios, símbolos de moneda ($, €, £, etc.) y estandarizando separadores decimales.\n- **Monitoreo Automático de la Blockchain**: Consulta periódica a través de la API de Tatum para detectar transacciones pendientes y confirmadas en la blockchain de Litecoin de forma automatizada.\n- **Gestión Segura de Fondos**: Permite liberar los fondos al vendedor (deduciendo comisiones de red estándar) o reembolsarlos al comprador mediante mutuo acuerdo.\n- **Transcripciones HTML del Chat**: Generación automática de auditorías en HTML utilizando `chat-exporter` que son enviadas a los mensajes directos (DMs) de ambas partes al completarse o cancelarse la transacción.\n- **Comandos Administrativos**: Panel de control y comandos Slash para administradores para gestionar perfiles, forzar liberaciones manuales de LTC y revisar estadísticas generales del servidor.\n\n---\n\n## 🔧 Requisitos Previos\n\n- **Python 3.8 o superior**\n- **Token de Bot de Discord** (con todos los Gateway Intents habilitados en el Discord Developer Portal).\n- **API Key de Tatum** (para verificación de balances y envío/emisión de transacciones en la red Litecoin).\n\n---\n\n## ⚙️ Instrucciones de Configuración\n\n### 1. Clonar el Repositorio y Navegar a la Carpeta\n\n```bash\ngit clone \u003curl-de-tu-repositorio\u003e\ncd \u003ccarpeta-del-repositorio\u003e\n```\n\n### 2. Instalar las Dependencias\n\nInstala las librerías de Python requeridas ejecutando:\n\n```bash\npip install -r requirements.txt\n```\n\n### 3. Configurar el archivo `config.ini`\n\nCrea o edita el archivo `config.ini` en la raíz del proyecto con tus credenciales y configuraciones:\n\n```ini\n[EmbedSettings]\nembed_color = 0xFFFFFF\nfooter_text = TrustMM | Secure P2P Escrow Bot\nicon_url = \nthumbnail_url = \nloading_url = https://www.icegif.com/wp-content/uploads/2023/07/icegif-1263.gif\nltc_image = https://w7.pngwing.com/pngs/786/58/png-transparent-coin-crypto-lite-litecion-ltc-crypto-currency-and-coin-icon.png\ntick_image = https://e7.pngegg.com/pngimages/270/706/png-clipart-check-mark-computer-icons-green-tick-mark-angle-text-thumbnail.png\n\n[Token]\nTOKEN = TU_DISCORD_BOT_TOKEN_AQUÍ\n\n[APIKeys]\nTATUM_APIKEY = TU_TATUM_API_KEY_AQUÍ\n\n[ChannelSettings]\nmm_log_channel_id = TU_ID_DE_CANAL_DE_LOGS\ncategory_id = TU_ID_DE_CATEGORÍA_DE_DISCORD\n\n[RoleSettings]\nadmin_role_id = TU_ID_DE_ROL_DE_ADMINISTRADOR\nclient_role_id = TU_ID_DE_ROL_DE_CLIENTE\n\n[DisplaySettings]\nshow_buyer_seller = True\n```\n\n### 4. Iniciar el Bot\n\nEjecuta el bot usando Python en tu terminal:\n\n```bash\npython main.py\n```\n\n---\n\n## 🛠️ Comandos Slash (`/`)\n\n- **/automm-panel**: Envía el panel embed interactivo de creación de transacciones (Solo Administradores).\n- **/transcript**: Genera y envía en el chat una transcripción completa interactiva en HTML del canal actual.\n- **/release**: Libera manualmente fondos en LTC de un Deal ID específico a una dirección externa (Solo Administradores).\n- **/delete**: Elimina el canal de transacción actual de forma segura después de 5 segundos (Solo Administradores).\n- **/profile**: Muestra el perfil y volumen de transacciones de un miembro (Volumen de USD comprado y vendido).\n- **/statistics**: Muestra la cantidad total de transacciones completadas y el volumen total en USD en el servidor.\n- **/about**: Muestra especificaciones técnicas del bot, tiempo en línea (uptime), uso de CPU/RAM e información de autoría.\n\n---\n\n## 📜 Licencia\n\nEste proyecto está bajo la **LICENCIA DE SOFTWARE LIBRE CON ATRIBUCIÓN OBLIGATORIA (LICENCIA ALBERTO ORTIZ)**.\n\n### Resumen de la Licencia\n\n1. **Uso Gratuito**: Permitido para fines personales y no comerciales.\n2. **Bifurcaciones (Forks) y Modificaciones**: Permitidos en plataformas públicas (como GitHub).\n3. **Atribución Obligatoria**:\n   - Se deben conservar todos los avisos de copyright y el nombre de **Alberto Ortiz** en el código fuente y las respuestas del bot.\n   - Cualquier modificación o bifurcación debe declarar explícitamente al inicio de su documentación y en la interfaz:\n     \u003e *\"Este Software es una bifurcación/modificación basada en el proyecto original 'TrustMM' desarrollado por Alberto Ortiz ([https://github.com/alberto2005-coder](https://github.com/alberto2005-coder)).\"*\n4. **Prohibición Comercial**: Queda estrictamente prohibida la explotación comercial o venta de este Software o sus derivados sin consentimiento previo por escrito.\n\nPara más detalles, consulta el archivo [LICENSE](LICENSE).\n\n---\n---\n\n## English\n\n**TrustMM** is a secure, fully automated peer-to-peer (P2P) **Litecoin (LTC) Escrow / Middleman** Discord bot. It eliminates the need for manual intermediaries in cryptocurrency transactions by using temporary hot-wallets and monitoring incoming transactions directly on the blockchain in real-time.\n\n---\n\n## 📋 Features\n\n- **Automated Ticket/Channel Creation**: Secure, dedicated channels created instantly for Comprador/Vendedor (Buyer/Seller) deals.\n- **Dynamic Role Selection**: Simple interface buttons for identifying each participant's role (Buyer vs. Seller).\n- **Secure Interactive Modals**: Replaces chat-based text listeners (`wait_for` loops) with clean Discord pop-up modals for setting deal parameters and collecting payout wallet addresses.\n- **Custom Fiat Currency Support**: Allows the user to specify their preferred fiat currency (e.g., USD, EUR, GBP, ARS) at transaction setup, querying the Coinbase API for real-time LTC conversion rates.\n- **Advanced LTC Address Validation**: Automated Regex validation for mainnet Litecoin addresses supporting Legacy (`L...`), P2SH (`M...`), and Bech32 (`ltc1...`) formats to prevent transfer mistakes.\n- **Robust Amount Sanitization**: Strips currency symbols ($, €, £, etc.), spaces, and formats decimal separators automatically from user input to ensure robust and error-free amount parsing.\n- **Automatic Blockchain Monitoring**: Periodically tracks temporary wallets via Tatum API to detect pending and confirmed deposits.\n- **Secure Funds Management**: Funds can be released to the seller (deducting network fees) or refunded back to the buyer through mutual agreement.\n- **HTML Chat Transcripts**: Uses `chat-exporter` to auto-generate beautiful HTML audit logs of completed/cancelled transactions and DMs them to both parties.\n- **Admin Control Commands**: Complete control panel for administrators to manage profiles, generate reports, force manual releases, and view server deal statistics.\n\n---\n\n## 🔧 Prerequisites\n\n- **Python 3.8+**\n- **Discord Bot Token** (with all gateway intents enabled on the Discord Developer Portal)\n- **Tatum API Key** (for balance checks and transaction broadcasting)\n\n---\n\n## ⚙️ Setup Instructions\n\n### 1. Clone \u0026 Navigate to Folder\n\n```bash\ngit clone \u003cyour-repository-url\u003e\ncd \u003crepository-folder\u003e\n```\n\n### 2. Install Dependencies\n\nInstall all required Python packages using pip:\n\n```bash\npip install -r requirements.txt\n```\n\n### 3. Configure `config.ini`\n\nCreate/update `config.ini` in the root folder with your Discord Bot Token and API Credentials:\n\n```ini\n[EmbedSettings]\nembed_color = 0xFFFFFF\nfooter_text = TrustMM | Secure P2P Escrow Bot\nicon_url = \nthumbnail_url = \nloading_url = https://www.icegif.com/wp-content/uploads/2023/07/icegif-1263.gif\nltc_image = https://w7.pngwing.com/pngs/786/58/png-transparent-coin-crypto-lite-litecion-ltc-crypto-currency-and-coin-icon.png\ntick_image = https://e7.pngegg.com/pngimages/270/706/png-clipart-check-mark-computer-icons-green-tick-mark-angle-text-thumbnail.png\n\n[Token]\nTOKEN = YOUR_DISCORD_BOT_TOKEN_HERE\n\n[APIKeys]\nTATUM_APIKEY = YOUR_TATUM_API_KEY_HERE\n\n[ChannelSettings]\nmm_log_channel_id = YOUR_LOG_CHANNEL_ID\ncategory_id = YOUR_CATEGORY_ID\n\n[RoleSettings]\nadmin_role_id = YOUR_ADMIN_ROLE_ID\nclient_role_id = YOUR_CLIENT_ROLE_ID\n\n[DisplaySettings]\nshow_buyer_seller = True\n```\n\n### 4. Run the Bot\n\nStart the bot using Python:\n\n```bash\npython main.py\n```\n\n---\n\n## 🛠️ Slash Commands\n\n- **/automm-panel**: Displays the interactive setup embed panel (Admin only).\n- **/transcript**: Generates and sends a complete HTML chat transcript of the current channel.\n- **/release**: Manually release LTC for a specific deal ID to a custom address (Admin only).\n- **/delete**: Safe-deletes the current transaction channel after 5 seconds (Admin only).\n- **/profile**: Displays P2P statistics for a specific server member (Spent/Earned USD volume).\n- **/statistics**: Shows total deals completed and overall USD volume in the server.\n- **/about**: Displays technical specifications, uptime, CPU/RAM usage, and bot information.\n\n---\n\n## 📜 License\n\nThis project is licensed under the **OBLIGATORY ATTRIBUTION FREE SOFTWARE LICENSE (ALBERTO ORTIZ LICENSE)**.\n\n### License Summary\n\n1. **Free Use**: Permitted for personal and non-commercial purposes.\n2. **Forks \u0026 Modifications**: Permitted on public development platforms (such as GitHub).\n3. **Obligatory Attribution**:\n   - All copyright notices and the name of **Alberto Ortiz** must remain intact in the source code and bot replies.\n   - Any modification or fork must explicitly declare at the beginning of its documentation and interface:\n     \u003e *\"This Software is a fork/modification based on the original 'TrustMM' project developed by Alberto Ortiz ([https://github.com/alberto2005-coder](https://github.com/alberto2005-coder)).\"*\n4. **Commercial Prohibition**: Commercial sale, distribution, or economic exploitation of this Software or its derivatives is strictly prohibited without prior written consent.\n\nFor more details, see the [LICENSE](LICENSE) file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falberto2005-coder%2Ftrustmm-discord-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falberto2005-coder%2Ftrustmm-discord-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falberto2005-coder%2Ftrustmm-discord-bot/lists"}