{"id":26607049,"url":"https://github.com/fisapool/pe","last_synced_at":"2026-01-28T00:35:37.178Z","repository":{"id":283131759,"uuid":"949617767","full_name":"fisapool/PE","owner":"fisapool","description":null,"archived":false,"fork":false,"pushed_at":"2025-03-19T02:14:59.000Z","size":1091,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-31T20:35:07.695Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fisapool.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":"2025-03-16T20:56:21.000Z","updated_at":"2025-03-19T03:45:32.000Z","dependencies_parsed_at":"2025-03-18T18:54:58.711Z","dependency_job_id":null,"html_url":"https://github.com/fisapool/PE","commit_stats":null,"previous_names":["fisapool/pe"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/fisapool/PE","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fisapool%2FPE","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fisapool%2FPE/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fisapool%2FPE/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fisapool%2FPE/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fisapool","download_url":"https://codeload.github.com/fisapool/PE/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fisapool%2FPE/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28829454,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-27T23:29:49.665Z","status":"ssl_error","status_checked_at":"2026-01-27T23:25:58.379Z","response_time":168,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":"2025-03-23T22:36:21.722Z","updated_at":"2026-01-28T00:35:37.148Z","avatar_url":"https://github.com/fisapool.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PE - Residential Proxy Extension\n\nA browser extension for managing and utilizing residential proxies.\n\n## Features\n\n- Configure and connect to multiple proxy servers\n- Support for various server types (including SSE)\n- Secure connection handling\n- Input validation for proxy endpoints\n\n## Installation\n\n1. Clone this repository\n2. Install dependencies with `npm install`\n3. Build the extension with `npm run build`\n4. Load the extension in your browser:\n   - Chrome: Go to `chrome://extensions/`, enable Developer mode, and click \"Load unpacked\"\n   - Firefox: Go to `about:debugging#/runtime/this-firefox`, click \"Load Temporary Add-on\", and select the manifest.json file\n\n## Usage Guidelines\n\nThis extension should be used responsibly and in accordance with:\n- Terms of service for websites you access\n- Local laws and regulations\n- Proxy provider policies\n\n## Development\n\n- Use `npm run dev` for development build with hot-reloading\n- Run tests with `npm test`\n\n## Security Notice\n\nThis extension implements several security features:\n- No credentials are stored in code\n- All connections use HTTPS by default\n- Input validation for all proxy endpoints\n- Rate limiting to prevent abuse\n\n# ProxyEthica\n\nProxyEthica is a comprehensive residential proxy management system designed for ethical data collection. It provides secure, compliant, and bandwidth-efficient proxy connections with built-in fallback mechanisms and monitoring.\n\n## Features\n\n- 🔒 **Secure Proxy Management**: No hardcoded credentials, HTTPS enforcement\n- 🔄 **Automatic Rotation**: IP rotation with randomized delays and rate limit respect\n- 🌐 **Multiple Fallbacks**: Protocol fallbacks (HTTPS/HTTP/SOCKS5) and provider-level fallbacks\n- 📊 **Bandwidth Tracking**: Monitor and limit data usage per session\n- 🤖 **Ethical Compliance**: Robots.txt parsing and respect\n- 🛡️ **DNS Leak Prevention**: Protects against DNS-based identity leaks\n- 📱 **Web Dashboard**: Manage proxy sessions through a user-friendly interface\n\n## Project Structure \n\n# ProxyEthica Firebase Integration\n\nThis document outlines the Firebase integration for the ProxyEthica Chrome extension.\n\n## Architecture\n\nThe extension uses Firebase for:\n- User authentication\n- Storing proxy session data\n- Tracking bandwidth contributions\n- Managing user credits\n- Offline support\n\n## Firebase Services Used\n\n- **Authentication**: Email/password authentication\n- **Firestore**: NoSQL database for storing user data\n- **Analytics**: Optional tracking of usage patterns\n- **Hosting**: Hosting the dashboard web app\n\n## Collections Structure\n\n1. **users**: User profiles and credit balances\n   - `userId`: (document ID)\n   - `email`: User's email\n   - `credits`: Available proxy credits\n   - `contribution`: Object containing bandwidth contribution stats\n\n2. **apiKeys**: Secure storage of API keys\n   - `userId`: (document ID)\n   - `key`: The API key\n   - `createdAt`: Creation timestamp\n\n3. **proxySessions**: Records of proxy sessions\n   - `userId`: User who created the session\n   - `ip`: Proxy IP address\n   - `country`: Country of the proxy\n   - `createdAt`: Start time\n   - `active`: Whether session is active\n\n4. **contributions**: Records of bandwidth contributions\n   - `userId`: Contributing user\n   - `timestamp`: When contribution occurred\n   - `bandwidthBytes`: Amount contributed\n   - `creditsEarned`: Credits earned\n\n## Security Rules\n\nThe Firestore security rules enforce:\n- Users can only read/write their own data\n- API keys are read-only by the owning user\n- Contribution records cannot be modified after creation\n\n## Error Handling\n\nAll Firebase operations use try/catch blocks and proper error handling.\nThe `firebase-error-handler.js` utility provides user-friendly error messages.\n\n## Offline Support\n\nThe extension uses Firestore offline persistence to function even when\noffline, syncing when connection is restored.\n\n## Integration Points\n\n- **Authentication**: Login/signup in popup.html\n- **Profile Management**: Settings page\n- **Proxy Usage**: Background script for tracking\n- **Bandwidth Contribution**: Background script for recording\n\nProxyEthica Extension\nTable of Contents\n\n    Overview\n    Completed Components\n    Partially Completed Components\n    Minimally Implemented Components\n    Next Priority Tasks\n\nOverview\n\nProxyEthica is a browser extension designed to manage proxy connections ethically and efficiently. This extension allows users to share their unused bandwidth while maintaining full control over their privacy and settings.\nCompleted Components (90-100%)\nComponent\tCompletion\nExtension Structure \u0026 Core Files\t~95%\n- Manifest configuration\t\n- Background scripts\t\n- Basic service worker setup\t\n- Popup HTML/JS implementation\t\nUser Interface\t~95%\n- Dashboard design and implementation\t\n- About page with ethical principles\t\n- Popup interface\t\n- Settings panels and forms\t\nBasic Proxy Functionality\t~90%\n- Proxy connection handling\t\n- Server management (add/remove/connect)\t\n- Proxy settings configuration\t\n- Error handling for connections\t\nPartially Completed Components (50-89%)\nComponent\tCompletion\nFallback Mechanisms\t~75%\n- Basic retry logic implemented\t\n- Error detection working\t\n- Missing advanced provider-level fallbacks\t\n- Missing some protocol fallback options\t\nSecurity Features\t~80%\n- No hardcoded credentials\t\n- HTTPS enforcement options\t\n- Input validation present\t\n- Missing some advanced security measures\t\nSettings Persistence\t~85%\n- Settings storage working with Chrome storage API\t\n- Settings retrieval implemented\t\n- Missing some edge case handling\t\nMinimally Implemented Components (0-49%)\nComponent\tCompletion\nFirebase Integration\t~10%\n- Database structure defined conceptually\t\n- No actual Firebase initialization or integration code\t\n- Missing authentication flows\t\n- Missing Firestore collection implementation\t\nEthical Compliance\t~20%\n- UI mentions ethical principles\t\n- No robots.txt parsing or compliance enforcement\t\nBandwidth Tracking\t~30%\n- UI components for stats exist\t\n- Placeholder tracking code only\t\n- Missing actual bandwidth measurement\t\nIcons and Assets\t~0%\n- Referenced in manifest but not created/included\t\n\n1. Protocol \u0026 Implementation Upgrades\nWebSocket Support\nAdd WebSocket proxy support beyond HTTP/HTTPS/SOCKS5\nImplement secure WebSocket (WSS) proxying capabilities\nCreate connection handlers for streaming data\nBrowser Extension API\nDevelop Chrome/Firefox extension-specific proxy implementations\nAdd manifest V3 compatible proxy configuration\nImplement background script integration for browser extensions\n2. Authentication \u0026 Security Enhancements\nMulti-factor Authentication\nImplement token-based authentication beyond API keys\nAdd session-based authentication with refresh capabilities\nDevelop user-level access controls for proxy sharing\nEncryption Layer\nAdd end-to-end encryption for proxy traffic\nImplement certificate pinning for HTTPS proxies\nCreate encrypted storage for credentials beyond localStorage\n3. Advanced Proxy Management\nMachine Learning Rotation\nImplement ML-based rotation timing to avoid detection\nAdd behavior-based proxy selection based on target sites\nDevelop pattern recognition for rate-limiting detection\nGeographic Targeting\nAdd city-level proxy targeting beyond country selection\nImplement autonomous region selection for specific countries\nCreate proximity-based selection for lowest latency\n4. Performance Optimization\nConnection Pooling\nImplement connection reuse to reduce setup overhead\nAdd persistent connection management\nCreate priority queues for critical requests\nCaching Layer\nDevelop intelligent caching with proxy awareness\nImplement cache invalidation strategies per proxy\nAdd bandwidth optimization through selective caching\n5. Monitoring \u0026 Analytics\nReal-time Metrics\nCreate detailed performance metrics dashboard\nImplement latency tracking per proxy and target\nAdd success rate monitoring by proxy source\nFailure Analysis\nDevelop automatic root cause analysis for proxy failures\nAdd pattern detection for blocked proxies\nImplement automatic reporting for problematic targets\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffisapool%2Fpe","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffisapool%2Fpe","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffisapool%2Fpe/lists"}