Wallet Callbacks

This document details the callback operations related to wallet management in the CopperX Payout Bot.

Wallet Callback Overview

Wallet callbacks enable users to interact with their cryptocurrency wallets through inline keyboard buttons. These callbacks handle operations such as viewing wallet details, setting default wallets, generating deposit addresses, and creating new wallets.

Available Wallet Callbacks

Callback	Description	Parameters	Authentication	KYC
`wallet_details:id`	Show wallet details	Wallet ID	Required	Required
`wallet_set_default:id`	Set default wallet	Wallet ID	Required	Required
`wallet_deposit:id`	Show deposit address	Wallet ID	Required	Required
`wallet_all_balances`	Show all wallet balances	None	Required	Required
`wallet_back`	Return to wallet list	None	Required	Required
`wallet_create`	Create new wallet	None	Required	Required
`create_wallet_*`	Create wallet on specific network	Network name	Required	Required

Wallet Details Callback

Purpose: Display detailed information about a specific wallet including its balance, network, and address.

Implementation:

Response Example:

💼 Wallet Details

Network: ethereum
Wallet ID: 12345abcde
Address: 0x1234...5678
Balance: 100.50 USDT
✅ Default Wallet

What would you like to do with this wallet?

Set Default Wallet Callback

Purpose: Set a specific wallet as the default wallet for transactions.

Implementation:

Response Example:

✅ Your ethereum wallet has been set as the default wallet.

Deposit Callback

Purpose: Display a wallet address for receiving funds.

Implementation:

Response Example:

📥 Deposit to your ethereum wallet

Send funds to this address:
0x1234567890abcdef1234567890abcdef12345678

Only send ethereum network tokens to this address. Sending other tokens may result in permanent loss.

All Balances Callback

Purpose: Display balances across all user wallets.

Implementation:

Response Example:

💰 Your Wallet Balances

Network: ethereum
Balance: 100.50 USDT
Address: 0x1234...5678

Network: polygon
Balance: 25.75 MATIC
Address: 0xabcd...efgh

Wallet Back Callback

Purpose: Return to the wallet list view.

Implementation:

Create Wallet Callback

Purpose: Initiate the wallet creation process.

Implementation:

Dynamic Create Wallet Network Callback

Purpose: Create a wallet on a specific network.

Implementation:

This is handled in the main callback router:

Wallet Callback Registration

Wallet callbacks are registered in the callback operations:

src/bot/handlers/wallet.handler.ts - Contains wallet callback handlers

src/services/wallet.service.ts - Service layer for wallet operations

src/constants/callback.enum.ts - Defines callback enum values

src/bot/messages/wallet.messages.ts - Contains wallet message templates

wallet

Wallet Callbacks#

Wallet Callback Overview#

Available Wallet Callbacks#

Wallet Details Callback#

Set Default Wallet Callback#

Deposit Callback#

All Balances Callback#

Wallet Back Callback#

Create Wallet Callback#

Dynamic Create Wallet Network Callback#

Wallet Callback Registration#

Related Files#

Wallet Callbacks

Wallet Callback Overview

Available Wallet Callbacks

Wallet Details Callback

Set Default Wallet Callback

Deposit Callback

All Balances Callback

Wallet Back Callback

Create Wallet Callback

Dynamic Create Wallet Network Callback

Wallet Callback Registration

Related Files