import { historyCommand } from "@rsksmart/rsk-cli/dist/src/commands/history.js";
interface HistoryParams {
testnet: boolean;
apiKey?: string;
number?: string;
walletData?: any;
}
interface HistoryResult {
success: boolean;
data?: any;
error?: string;
responseType: string;
}
export class HistoryService {
async processHistory(params: HistoryParams): Promise<HistoryResult> {
try {
const missingInfo = [];
if (!params.walletData) {
missingInfo.push("š¼ **Wallet Data**: Provide your wallet configuration file (my-wallets.json)");
}
if (missingInfo.length > 0) {
return {
success: false,
error: this.formatMissingInfoError(missingInfo),
responseType: "ErrorMissingInfo"
};
}
let processedWalletData = params.walletData;
if (typeof params.walletData === "string") {
try {
processedWalletData = JSON.parse(params.walletData);
} catch (error) {
return {
success: false,
error: `ā **Invalid Wallet Data Format**\n\nError parsing wallet data: ${error instanceof Error ? error.message : String(error)}\n\nPlease provide valid JSON wallet data.`,
responseType: "ErrorInvalidWalletData"
};
}
}
const historyParams = {
testnet: params.testnet,
apiKey: params.apiKey,
number: params.number,
walletsData: processedWalletData,
isExternal: true
};
const result = await historyCommand(historyParams);
if (result?.success && result.data) {
return {
success: true,
data: result.data,
responseType: "HistoryRetrievedSuccessfully"
};
}
return {
success: false,
error: result?.error || "Failed to retrieve transaction history",
responseType: "ErrorRetrievingHistory"
};
} catch (error) {
return {
success: false,
error: error instanceof Error ? error.message : String(error),
responseType: "ErrorRetrievingHistory"
};
}
}
private formatMissingInfoError(missingInfo: string[]): string {
return `ā **Missing Required Information**\n\nTo retrieve transaction history, please provide the following:\n\n${missingInfo.map(info => `ā¢ ${info}`).join('\n')}\n\nOnce you provide all required information, try again.`;
}
formatHistoryResponse(data: any): string {
const { walletAddress, network, transfers, totalTransfers } = data;
if (!transfers || transfers.length === 0) {
return `š **Transaction History**
š **Wallet**: ${walletAddress}
š **Network**: ${network}
š **No transactions found**
This wallet has no transaction history on ${network}.`;
}
const transactionList = transfers.slice(0, 10).map((transfer: any, index: number) => {
const date = transfer.metadata?.blockTimestamp ? new Date(transfer.metadata.blockTimestamp).toLocaleString() : 'Unknown date';
const asset = transfer.asset || 'RBTC';
const value = transfer.value || 'Unknown';
return `**${index + 1}.** ${asset} Transfer
ā¢ **From**: ${transfer.from}
ā¢ **To**: ${transfer.to}
ā¢ **Amount**: ${value} ${asset}
ā¢ **Hash**: \`${transfer.hash}\`
ā¢ **Date**: ${date}`;
}).join('\n\n');
const showingCount = Math.min(transfers.length, 10);
const moreText = totalTransfers > showingCount ? `\n\nš **Showing ${showingCount} of ${totalTransfers} total transactions**` : '';
return `š **Transaction History**
š **Wallet**: ${walletAddress}
š **Network**: ${network}
š **Total Transactions**: ${totalTransfers}
${transactionList}${moreText}
š” **Tip**: Use the 'number' parameter to retrieve a specific number of recent transactions.`;
}
formatHistoryErrorResponse(error: string): string {
if (error.includes("API key")) {
return `ā **API Key Required**
${error}
š” **How to get an Alchemy API Key:**
1. Visit https://www.alchemy.com/
2. Create a free account
3. Create a new app for Rootstock
4. Copy your API key
š§ **Usage**: Provide the API key as a parameter once, and it will be saved for future use.`;
}
if (error.includes("No transactions found")) {
return `š **No Transactions Found**
${error}
š” **This could mean:**
ā¢ The wallet is new and hasn't made any transactions
ā¢ All transactions are on a different network
ā¢ The wallet address is incorrect
š Please verify the wallet address and network selection.`;
}
return `ā **Error Retrieving History**
${error}
š” **Common Issues:**
ā¢ Invalid or missing Alchemy API key
ā¢ Network connectivity issues
ā¢ Invalid wallet data format
ā¢ API rate limits
š Please check your configuration and try again.`;
}
}
