<h1 class="heading-node">🤖 Telegram Bot Bounty for Copperx Payout</h1><h2 class="heading-node">📋 Overview</h2>Copperx is building a stablecoin bank for individuals and businesses. We're seeking a talented developer to create a Telegram bot that integrates with Copperx Payout's API. This bot will enable users to deposit, withdraw, and transfer USDC directly through Telegram without visiting our web app.<h2 class="heading-node">🛠️ Technical Requirements</h2><ul class="list-node"><li>Built with TypeScript/Node.js and Cursor/ChatGPT/similar</li><li>Clean, maintainable code structure</li><li>Comprehensive Git history with meaningful commits</li><li>Strong type safety throughout the codebase</li><li>Proper error handling and user feedback</li><li>Secure handling of user credentials and sensitive information</li><li>Thorough documentation and setup instructions</li></ul><h2 class="heading-node">📚 API Documentation</h2>The complete API documentation is available at: <a class="link" href="https://income-api.copperx.io/api/doc">https://income-api.copperx.io/api/doc</a>Please refer to this documentation for detailed information about request/response formats, authentication requirements, and available endpoints.Our API docs are still very new, so if you’ve any questions, feel free to ping us at <a class="link" href="https://t.me/copperxcommunity/2991">https://t.me/copperxcommunity/2991</a><h2 class="heading-node">✨ Core Features &amp; API Integration</h2><h3 class="heading-node">🔐 Authentication &amp; Account Management</h3>Features:<ul class="list-node"><li>User login/authentication with Copperx credentials</li><li>View account profile and status</li><li>Check KYC/KYB approval status</li></ul>API Endpoints:<ul class="list-node"><li>Auth API: <code class="inline" spellcheck="false">/api/auth/email-otp/request</code>, <code class="inline" spellcheck="false">/api/auth/email-otp/authenticate</code></li><li>User profile: <code class="inline" spellcheck="false">/api/auth/me</code></li><li>KYC status: <code class="inline" spellcheck="false">/api/kycs</code></li></ul>Implementation Notes:<ul class="list-node"><li>For KYC/KYB, redirect users to the platform if not approved</li><li>Store session tokens securely</li><li>Implement session refresh mechanism or session expiry handling</li><li>Auth APIs have rate limits</li></ul><h3 class="heading-node">👛 Wallet Management</h3>Features:<ul class="list-node"><li>View all wallet balances across networks</li><li>Set default wallet for transactions</li><li>Allow users to deposit funds</li><li>View transaction history</li></ul>API Endpoints:<ul class="list-node"><li>Get wallets: <code class="inline" spellcheck="false">/api/wallets</code></li><li>Get balances: <code class="inline" spellcheck="false">/api/wallets/balances</code></li><li>Set default wallet: <code class="inline" spellcheck="false">/api/wallets/default</code></li><li>Transaction history: <code class="inline" spellcheck="false">/api/transfers</code></li><li>Default wallet: <code class="inline" spellcheck="false">/api/wallets/default</code></li></ul><h3 class="heading-node">💸 Fund Transfers</h3>Features:<ul class="list-node"><li>Send funds to email addresses</li><li>Send funds to external wallet addresses</li><li>Withdraw funds to bank accounts</li><li>View last 10 transactions</li></ul>API Endpoints:<ul class="list-node"><li>Email transfer: <code class="inline" spellcheck="false">/api/transfers/send</code></li><li>Wallet transfer: <code class="inline" spellcheck="false">/api/transfers/wallet-withdraw</code></li><li>Bank withdrawal: <code class="inline" spellcheck="false">/api/transfers/offramp</code></li><li>Bulk transfers: <code class="inline" spellcheck="false">/api/transfers/send-batch</code></li><li>Transfer listing: <code class="inline" spellcheck="false">/api/transfers?page=1&amp;limit=10</code></li></ul>Implementation Notes:<ul class="list-node"><li>Implement proper validation for recipient information</li><li>Display fee calculations before confirming transactions</li><li>Include confirmation steps for security</li><li>We understand that you're a new developer. If you're unable to withdraw to bank due to minimum amount then it's okay.</li></ul><h3 class="heading-node">🔔 Deposit Notifications</h3>Features:<ul class="list-node"><li>Receive deposit notifications</li><li>We will use Pusher for real-time notifications (<a class="link" href="https://pusher.com/docs/channels/using_channels/private-channels/">https://pusher.com/docs/channels/using_channels/private-channels/</a>)</li></ul>API Endpoints:<ul class="list-node"><li>Authentication: <code class="inline" spellcheck="false">/api/notifications/auth</code> (POST)</li><li>Pusher channels: <code class="inline" spellcheck="false">private-org-${organizationId}</code></li><li>Use Pusher Key: <code class="inline" spellcheck="false">e089376087cac1a62785</code></li><li>Use Pusher Cluster: <code class="inline" spellcheck="false">ap1</code></li><li>Sample code for Pusher:<pre class="block-node"><code class="language-typescript">// Initialize Pusher client with authentication
const pusherClient = new Pusher(process.env.VITE_PUSHER_KEY, {
 cluster: process.env.VITE_PUSHER_CLUSTER,
 authorizer: (channel) =&gt; ({
 authorize: async (socketId, callback) =&gt; {
 try {
 const response = await axios.post('/api/notifications/auth', {
 socket_id: socketId,
 channel_name: channel.name
 }, {
 headers: {
 Authorization: `Bearer ${token}`
 }
 });

 if (response.data) {
 callback(null, response.data);
 } else {
 callback(new Error('Pusher authentication failed'), null);
 }
 } catch (error) {
 console.error('Pusher authorization error:', error);
 callback(error, null);
 }
 }
 })
});

// Subscribe to organization's private channel
const channel = pusherClient.subscribe(`private-org-${organizationId}`);

channel.bind('pusher:subscription_succeeded', () =&gt; {
 console.log('Successfully subscribed to private channel');
});

channel.bind('pusher:subscription_error', (error) =&gt; {
 console.error('Subscription error:', error);
});

// Bind to the deposit event
pusherClient.bind('deposit', (data) =&gt; {
 bot.sendMessage(chatId,
 `💰 *New Deposit Received*\n\n` +
 `${data.amount} USDC deposited on Solana`
 );
});</code></pre></li></ul>Implementation Notes:<ul class="list-node"><li>Authenticate with the notification service using organization ID and token</li><li>Implement a Pusher client to subscribe to appropriate channels</li><li>Listen for event <code class="inline" spellcheck="false">deposit</code></li><li>Format Telegram messages with relevant transaction details</li></ul><h2 class="heading-node">💬 Bot Interaction Design</h2><ul class="list-node"><li>Implement intuitive command structure (<code class="inline" spellcheck="false">/balance</code>, <code class="inline" spellcheck="false">/send</code>, <code class="inline" spellcheck="false">/withdraw</code>, etc.)</li><li>Create interactive menus for complex operations</li><li>Develop inline keyboards for option selection</li><li>Include help commands and clear instructions</li><li>Support natural language queries where possible</li><li>Add link to Copperx support: <a class="link" href="https://t.me/copperxcommunity/2183">https://t.me/copperxcommunity/2183</a></li></ul><h2 class="heading-node">🔒 Security Considerations</h2><ul class="list-node"><li>Implement proper authentication flow</li><li>Never store plaintext passwords</li><li>Use secure session management</li><li>Provide options for additional security (transaction confirmations)</li><li>Follow Telegram Bot API best practices for security</li></ul><h2 class="heading-node">📦 Deliverables</h2><ol class="list-node"><li>Complete GitHub repository for the Telegram bot</li><li>For testing the Username of your bot. (You can deploy bot at <a class="link" href="https://render.com/">https://render.com/</a> for free)</li><li>Comprehensive documentation:<ul class="list-node"><li>Setup instructions</li><li>API integration details</li><li>Command reference</li><li>Troubleshooting guide</li></ul></li><li>Showcase your Bot on X and be proud &lt;3 (optional)</li></ol><hr>For questions regarding this bounty, please contact our team in Telegram at <a class="link" href="https://t.me/copperxcommunity/2991">https://t.me/copperxcommunity/2991</a>.

Telegram Bot for Copperx Payout 🤖 - Build with AI

Telegram Bot for Copperx Payout 🤖 - Build with AI