Initial commit

Author: gromdimon

.claude/commands/add-callback.md

@@ -0,0 +1,32 @@
+---
+description: Create a new Telegram callback handler
+allowed-tools: Read, Write, Edit, Grep
+argument-hint: <callback_name>
+---
+
+# Add Callback Handler
+
+Create a new Grammy callback handler named: $ARGUMENTS
+
+## Reference Patterns
+
+Review existing callback implementations:
+- @src/bot/callbacks/buyCallback.ts
+- @src/bot/callbacks/sellCallback.ts
+- @src/bot/callbacks/walletCallback.ts
+
+## Requirements
+
+1. Follow the existing callback structure
+2. Use TypeScript with proper typing
+3. Include i18n support for all user messages
+4. Handle errors gracefully with user-friendly messages
+5. Add to the callback index at @src/bot/callbacks/index.ts
+
+## Checklist
+
+- [ ] Create callback file at `src/bot/callbacks/{name}Callback.ts`
+- [ ] Export handler function
+- [ ] Add i18n keys to locales if needed
+- [ ] Register in index.ts
+- [ ] Add any required types to `src/types/`

.claude/commands/check-i18n.md

@@ -0,0 +1,36 @@
+---
+description: Verify translation completeness across all locales
+allowed-tools: Read, Grep
+---
+
+# Check i18n Translations
+
+Verify all translation keys are complete and consistent across locales.
+
+## Supported Locales
+
+- English (primary): @locales/en/
+- Russian: @locales/ru/
+- Spanish: @locales/es/
+- German: @locales/de/
+
+## i18n Service
+
+Configuration: @src/services/i18n/i18n.ts
+
+## Find Translation Usages
+
+Search for i18n function calls in the codebase to identify all required keys.
+
+## Verification Steps
+
+1. List all keys used in the English locale (source of truth)
+2. Compare with other locales for missing translations
+3. Check for unused translation keys
+4. Verify placeholder consistency (e.g., `{amount}`, `{token}`)
+
+## Common Issues
+
+- Missing keys in non-English locales
+- Inconsistent placeholder names
+- Hardcoded strings that should use i18n

.claude/commands/debug-trade.md

@@ -0,0 +1,36 @@
+---
+description: Debug trading execution issues in the Telegram Trading bot
+allowed-tools: Read, Grep, Bash(make test:*)
+---
+
+# Debug Trading Issue
+
+Investigate the trading issue described: $ARGUMENTS
+
+## Investigation Steps
+
+1. Check the main trading service for the issue pattern
+2. Review the OpenOcean DEX integration
+3. Verify blockchain RPC interactions
+4. Look for error handling gaps
+
+## Key Files to Review
+
+- Trading engine: @src/services/engine/neurodex.ts
+- DEX aggregator: @src/services/engine/openocean.ts
+- Blockchain client: @src/services/engine/viem.ts
+- Buy callback: @src/bot/callbacks/buyCallback.ts
+- Sell callback: @src/bot/callbacks/sellCallback.ts
+
+## Current Test Status
+
+```
+!`pnpm test 2>&1 | tail -30`
+```
+
+## Common Issues
+
+- Slippage too low for volatile tokens
+- Insufficient gas estimation
+- RPC rate limiting
+- Token approval not completed

.claude/settings.json

@@ -0,0 +1,28 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(make:*)",
+      "Bash(pnpm add:*)",
+      "Bash(pnpm run lint:fix:*)",
+      "Bash(pnpm run typecheck:*)",
+      "Bash(pnpm test:*)",
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
+      "Bash(git push:*)",
+      "Bash(git status:*)",
+      "Bash(git diff:*)",
+      "Bash(git log:*)",
+      "Bash(gh pr list:*)"
+    ],
+    "deny": [
+      "Read(.env)",
+      "Read(.env.*)",
+      "Read(keys/**)",
+      "Read(wallets/**)",
+      "Bash(rm -rf:*)"
+    ]
+  },
+  "env": {
+    "NODE_ENV": "development"
+  }
+}

.dockerignore

@@ -0,0 +1,46 @@
+# Git and GitHub
+.github
+.git
+.gitignore
+.gitattributes
+
+# Environment files
+.env
+.env.*
+
+# Dependencies and build output
+node_modules
+generated
+dist
+
+# Documentation (not needed in container)
+README.md
+CONTRIBUTING.md
+SECURITY.md
+CLAUDE.md
+docs/
+
+# Development tools config
+.claude/
+.eslintrc.json
+.prettierrc
+.prettierignore
+tsconfig.dev.json
+typedoc.json
+jest.config.js
+
+# Logs
+*.log
+combined.log
+error.log
+
+# Scripts (development only)
+scripts/
+
+# Tests
+tests/
+
+# Editor files
+.DS_Store
+*.swp
+*.swo

.env.example

@@ -0,0 +1,47 @@
+ENVIRONMENT=development
+# Include as described here: https://nodejs.org/en/learn/getting-started/nodejs-the-difference-between-development-and-production
+NODE_ENV=production
+
+# Telegram Bot Token
+TELEGRAM_BOT_TOKEN=
+
+# Telegram Bot Username (without @)
+TELEGRAM_BOT_USERNAME=
+
+# RPC URLs (replace with your provider URLs)
+ETHEREUM_MAINNET_RPC=https://your-ethereum-mainnet-rpc-url
+BASE_MAINNET_RPC=https://your-base-mainnet-rpc-url
+BASE_SEPOLIA_RPC=https://your-base-sepolia-rpc-url
+BNC_RPC=https://your-bnc-rpc-url
+
+DEFAULT_SLIPPAGE=1   # Default Slippage (percentage)
+DEFAULT_FEE=1   # Default free (percentage)
+DEFAULT_FEE_WALLET=
+DEFAULT_GAS_PRIORITY=medium   # Default Gas Priority 'standard' | 'fast' | 'instant'
+
+# Prisma Database URI
+# For more info: https://www.prisma.io/docs/getting-started/quickstart-prismaPostgres
+DATABASE_URL="prisma+postgres://accelerate.prisma-data.net/?api_key="
+# Database Encryption key. Must be generated with cloak!
+PRISMA_FIELD_ENCRYPTION_KEY=""
+
+COVALENTHQ_API_KEY=""
+
+BETTERSTACK_SOURCE_TOKEN=""
+BETTERSTACK_ENDPOINT=""
+
+# Supabase (for secure private key storage)
+# Get these from your Supabase project settings: https://app.supabase.com/
+SUPABASE_URL=https://your-project.supabase.co
+SUPABASE_ANON_KEY=your-anon-key
+SUPABASE_SERVICE_KEY=your-service-key
+
+# Encryption keys
+MASTER_ENCRYPTION_PASSWORD=
+WALLET_ENCRYPTION_KEY=
+
+# Rate Limiting (optional - defaults shown)
+# Protects against abuse by limiting requests per user
+RATE_LIMIT_PER_SECOND=3
+RATE_LIMIT_PER_MINUTE=50
+RATE_LIMIT_PER_15MIN=300

.eslintrc.json

@@ -0,0 +1,34 @@
+{
+  "env": {
+    "node": true,
+    "es2022": true
+  },
+  "extends": [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/recommended",
+    "plugin:prettier/recommended"
+  ],
+  "parser": "@typescript-eslint/parser",
+  "parserOptions": {
+    "ecmaVersion": "latest",
+    "sourceType": "module",
+    "project": ["./tsconfig.json", "./tsconfig.dev.json"]
+  },
+  "plugins": ["@typescript-eslint", "prettier"],
+  "rules": {
+    "@typescript-eslint/explicit-function-return-type": "warn",
+    "@typescript-eslint/no-unused-vars": ["error", { "argsIgnorePattern": "^_" }],
+    "@typescript-eslint/no-explicit-any": "error",
+    "prettier/prettier": "error",
+    "no-console": "error"
+  },
+  "overrides": [
+    {
+      "files": ["scripts/**/*.ts", "tests/**/*.ts"],
+      "rules": {
+        "no-console": "off"
+      }
+    }
+  ],
+  "ignorePatterns": ["prisma/generated/**/*", "dist/**/*"]
+} 

.gitattributes

@@ -0,0 +1 @@
+pnpm-lock.yaml binary

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,31 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: bug
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. Encounter issue
+
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+
+**Additional context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,23 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: enhancement
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+
+**Additional context**
+Add any other context or screenshots about the feature request here.