@elizaos/plugin-wallet 2.0.0-beta.1

package/src/analytics/birdeye/tasks/birdeye.ts

@@ -0,0 +1,232 @@
+// @ts-nocheck — legacy code from absorbed plugins (lp-manager, lpinfo, dexscreener, defi-news, birdeye); strict types pending cleanup
+import {
+	type Content,
+	type IAgentRuntime,
+	//type Memory,
+	//ModelType,
+	type UUID,
+	createUniqueUuid,
+	type ServiceTypeName,
+} from "@elizaos/core";
+import { BIRDEYE_SERVICE_NAME } from "../constants";
+import { extractChain } from "../utils";
+import { BirdeyeService } from "../service";
+import type {
+	BirdeyeSupportedChain,
+	TransactionHistory,
+	Portfolio,
+} from "../types/shared";
+//import type { IToken } from '';
+
+/**
+ * Interface representing content with sentiment analysis data.
+ * @extends Content
+ * @interface
+ */
+export interface SentimentContent extends Content {
+	text: string;
+	source: "sentiment-analysis";
+	metadata: {
+		timeslot: string;
+		processed: boolean;
+		occuringTokens?: Array<{
+			token: string;
+			sentiment: number;
+			reason: string;
+		}>;
+	};
+}
+
+/**
+ * Generates a bulletpoint list from an array of strings.
+ *
+ * @param {string[]} array - The array of strings to create the list from.
+ * @returns {string} The bulletpoint list as a single string with new lines separating each item.
+ */
+/*
+function makeBulletpointList(array: string[]): string {
+  return array.map((a) => ` - ${a}`).join('\n');
+}
+*/
+
+export default class Birdeye {
+	apiKey: string;
+	sentimentRoomId: UUID;
+	twitterFeedRoomId: UUID;
+	runtime: IAgentRuntime;
+
+	pSrvBirdeye: Promise<unknown>;
+	beService!: BirdeyeService;
+
+	constructor(runtime: IAgentRuntime) {
+		this.apiKey = runtime.getSetting("BIRDEYE_API_KEY");
+		this.sentimentRoomId = createUniqueUuid(runtime, "sentiment-analysis");
+		this.twitterFeedRoomId = createUniqueUuid(runtime, "twitter-feed");
+		this.runtime = runtime;
+
+		this.pSrvBirdeye = runtime
+			.getServiceLoadPromise(BIRDEYE_SERVICE_NAME as ServiceTypeName)
+			.then(() => {
+				// used to list positions
+				this.beService = this.runtime.getService(
+					BIRDEYE_SERVICE_NAME,
+				) as BirdeyeService;
+			});
+	}
+
+	private async syncWalletHistory(
+		chain: BirdeyeSupportedChain,
+		publicKey: string,
+	) {
+		try {
+			// Wait for BirdeyeService to initialize
+			await this.pSrvBirdeye;
+
+			if (!this.beService) {
+				throw new Error("BirdeyeService not initialized");
+			}
+
+			const birdeyeData = await this.beService.fetchWalletTxList(
+				chain,
+				publicKey,
+			);
+
+			//console.log('birdeyeData', birdeyeData)
+
+			//console.log('intel/be/syncWalletHistory - birdeyeData', birdeyeData)
+
+			// Convert Birdeye data to our transaction format
+			const transactions: TransactionHistory[] = birdeyeData.map(
+				(tx: { txHash: string; blockTime: number | string }) => ({
+					txHash: tx.txHash,
+					blockTime: new Date(tx.blockTime),
+					data: tx,
+				}),
+			);
+
+			//console.log('intel/be/syncWalletHistory - transactions', transactions)
+
+			// Then try to get cached transactions
+			try {
+				// FIXME: scope to solana and wallet
+				const cachedTxs = await this.runtime.getCache<TransactionHistory[]>(
+					"transaction_history",
+				);
+				if (cachedTxs && Array.isArray(cachedTxs)) {
+					// Add cached transactions that don't exist in Birdeye data
+					for (const cachedTx of cachedTxs) {
+						if (!transactions.some((tx) => tx.txHash === cachedTx.txHash)) {
+							transactions.push(cachedTx);
+						}
+					}
+				}
+			} catch (_error) {
+				// If cache fails, continue with just Birdeye data
+				this.runtime.logger.debug(
+					"Failed to get cached transactions, continuing with Birdeye data only",
+				);
+			}
+
+			// ensure all dates are of type Date for sort
+			for (const tx of transactions) {
+				if (typeof tx.blockTime === "string") {
+					tx.blockTime = new Date(tx.blockTime);
+				}
+			}
+
+			// Sort transactions by blockTime descending (newest first)
+			transactions.sort(
+				(a, b) => b.blockTime.getTime() - a.blockTime.getTime(),
+			);
+
+			// Try to update cache, but don't fail if it doesn't work
+			try {
+				await this.runtime.setCache<TransactionHistory[]>(
+					"transaction_history",
+					transactions,
+				);
+				this.runtime.logger.debug(
+					`Birdeye Task - Updated transaction history with ${transactions.length} transactions for ${publicKey}`,
+				);
+			} catch (error) {
+				this.runtime.logger.debug(
+					`Failed to set transaction cache, continuing without caching: ${error instanceof Error ? error.message : String(error)}`,
+				);
+				//logger.debug({ error }, 'Failed to set transaction cache, continuing without caching');
+			}
+
+			return transactions;
+		} catch (error) {
+			this.runtime.logger.error(
+				`Failed to sync wallet history from Birdeye: ${error instanceof Error ? error.message : String(error)}`,
+			);
+			//logger.error({ error }, 'Failed to sync wallet history from Birdeye');
+			// Return empty array if everything fails
+			return [];
+		}
+	}
+
+	private async syncWalletPortfolio(
+		chain: BirdeyeSupportedChain,
+		publicKey: string,
+	) {
+		// Wait for BirdeyeService to initialize
+		await this.pSrvBirdeye;
+
+		if (!this.beService) {
+			throw new Error("BirdeyeService not initialized");
+		}
+
+		const data = await this.beService.fetchWalletTokenList(chain, publicKey);
+
+		await this.runtime.setCache<Portfolio>("portfolio", {
+			key: "PORTFOLIO",
+			data,
+		});
+	}
+
+	async syncWallet() {
+		const walletAddr = this.runtime.getSetting("BIRDEYE_WALLET_ADDR");
+		if (!walletAddr) {
+			return;
+		}
+
+		// Get explicit chain setting if provided
+		const explicitChain = this.runtime.getSetting("BIRDEYE_CHAIN");
+
+		try {
+			const chain = extractChain(walletAddr, explicitChain);
+			await this.syncWalletHistory(chain, walletAddr);
+			// maybe let solana or birdeye plugin handle this
+			await this.syncWalletPortfolio(chain, walletAddr);
+
+			return true;
+		} catch (error) {
+			this.runtime.logger?.error(
+				`Failed to sync wallet: ${error instanceof Error ? error.message : String(error)}`,
+			);
+			// Don't throw - just log and return false to indicate failure
+			return false;
+		}
+	}
+
+	/*
+  async syncTrendingTokens(chain: 'solana' | 'base' | 'ethereum', depth = 5): Promise<boolean> {
+    try {
+      const res = await this.beService.getTrendingTokensForChain(chain)
+      const tokens = res.data
+      //console.log('trending tokens', tokens)
+      await this.runtime.setCache<IToken[]>(`tokens_${chain}`, tokens);
+
+      logger.debug(`Updated ${chain} tokens cache with ${tokens.length} tokens`);
+
+      return true;
+    } catch (error) {
+      logger.error(
+        `Failed to sync trending tokens: ${error instanceof Error ? error.message : String(error)}`
+      );
+      throw error;
+    }
+  }
+  */
+}

package/src/analytics/birdeye/types/api/common.ts

@@ -0,0 +1,305 @@
+// @ts-nocheck — legacy code from absorbed plugins (lp-manager, lpinfo, dexscreener, defi-news, birdeye); strict types pending cleanup
+import type {
+  BaseQuoteParams,
+  DefiHistoryPriceParams,
+  DefiMultiPriceParams,
+  DefiPriceParams,
+  HistoricalPriceUnixParams,
+  MultiPriceVolumeParams,
+  OHLCVParams,
+  PriceVolumeParams,
+} from "./defi";
+import type {
+  OHLCVPairParams,
+  PairOverviewMultiParams,
+  PairOverviewSingleParams,
+  PairTradesParams,
+} from "./pair";
+import type { TokenMarketSearchParams } from "./search";
+import type {
+  AllMarketsParams,
+  MintBurnParams,
+  NewListingParams,
+  TokenCreationInfoParams,
+  TokenHoldersParams,
+  TokenListV2Params,
+  TokenMarketDataParams,
+  TokenMetadataMultiParams,
+  TokenMetadataSingleParams,
+  TokenOverviewParams,
+  TokenSecurityParams,
+  TokenTradeDataMultiParams,
+  TokenTradeDataSingleParams,
+  TokenTradesParams,
+  TopTradersParams,
+} from "./token";
+import type {
+  GainersLosersParams,
+  TraderTransactionsSeekParams,
+} from "./trader";
+import type {
+  WalletPortfolioMultichainParams,
+  WalletPortfolioParams,
+  WalletSimulationParams,
+  WalletTokenBalanceParams,
+  WalletTransactionHistoryMultichainParams,
+  WalletTransactionHistoryParams,
+} from "./wallet";
+
+export type BirdeyeApiParams =
+  | DefiPriceParams
+  | DefiMultiPriceParams
+  | DefiHistoryPriceParams
+  | HistoricalPriceUnixParams
+  | OHLCVParams
+  | PriceVolumeParams
+  | MultiPriceVolumeParams
+  | PairTradesParams
+  | OHLCVPairParams
+  | PairOverviewMultiParams
+  | PairOverviewSingleParams
+  | TokenMarketSearchParams
+  | TokenTradesParams
+  | TokenSecurityParams
+  | TokenOverviewParams
+  | TokenCreationInfoParams
+  | TokenListV2Params
+  | TokenMetadataMultiParams
+  | TokenTradeDataMultiParams
+  | GainersLosersParams
+  | TraderTransactionsSeekParams
+  | WalletPortfolioParams
+  | WalletTokenBalanceParams
+  | WalletTransactionHistoryParams
+  | BaseQuoteParams
+  | TokenHoldersParams
+  | MintBurnParams
+  | TopTradersParams
+  | AllMarketsParams
+  | NewListingParams
+  | TokenMetadataSingleParams
+  | TokenMarketDataParams
+  | TokenTradeDataSingleParams
+  | WalletPortfolioMultichainParams
+  | WalletTransactionHistoryMultichainParams
+  | WalletSimulationParams
+  | Record<string, never>;
+
+export interface BirdeyeApiResponseWrapper<T> {
+  data: T;
+  success: boolean;
+}
+
+export type BirdeyeApiResponse = BirdeyeApiResponseWrapper<unknown>;
+
+export type TimeInterval =
+  | "1m"
+  | "3m"
+  | "5m"
+  | "15m"
+  | "30m"
+  | "1H"
+  | "2H"
+  | "4H"
+  | "6H"
+  | "8H"
+  | "12H"
+  | "1D"
+  | "3D"
+  | "1W"
+  | "1M"
+  | "30m"
+  | "1h"
+  | "2h"
+  | "4h"
+  | "6h"
+  | "8h"
+  | "12h"
+  | "24h";
+
+export interface TokenTradeData {
+  address: string;
+  holder: number;
+  market: number;
+  last_trade_unix_time: number;
+  last_trade_human_time: string;
+  price: number;
+  history_30m_price: number;
+  price_change_30m_percent: number;
+  history_1h_price: number;
+  price_change_1h_percent: number;
+  history_2h_price: number;
+  price_change_2h_percent: number;
+  history_4h_price: number;
+  price_change_4h_percent: number;
+  history_6h_price: number;
+  price_change_6h_percent: number;
+  history_8h_price: number;
+  price_change_8h_percent: number;
+  history_12h_price: number;
+  price_change_12h_percent: number;
+  history_24h_price: number;
+  price_change_24h_percent: number;
+  unique_wallet_30m: number;
+  unique_wallet_history_30m: number;
+  unique_wallet_30m_change_percent: number | null;
+  unique_wallet_1h: number;
+  unique_wallet_history_1h: number;
+  unique_wallet_1h_change_percent: number | null;
+  unique_wallet_2h: number;
+  unique_wallet_history_2h: number;
+  unique_wallet_2h_change_percent: number | null;
+  unique_wallet_4h: number;
+  unique_wallet_history_4h: number;
+  unique_wallet_4h_change_percent: number | null;
+  unique_wallet_8h: number;
+  unique_wallet_history_8h: number;
+  unique_wallet_8h_change_percent: number | null;
+  unique_wallet_24h: number;
+  unique_wallet_history_24h: number;
+  unique_wallet_24h_change_percent: number | null;
+  trade_30m: number;
+  trade_history_30m: number;
+  trade_30m_change_percent: number;
+  sell_30m: number;
+  sell_history_30m: number;
+  sell_30m_change_percent: number;
+  buy_30m: number;
+  buy_history_30m: number;
+  buy_30m_change_percent: number;
+  volume_30m: number;
+  volume_30m_usd: number;
+  volume_history_30m: number;
+  volume_history_30m_usd: number;
+  volume_30m_change_percent: number;
+  volume_buy_30m: number;
+  volume_buy_30m_usd: number;
+  volume_buy_history_30m: number;
+  volume_buy_history_30m_usd: number;
+  volume_buy_30m_change_percent: number;
+  volume_sell_30m: number;
+  volume_sell_30m_usd: number;
+  volume_sell_history_30m: number;
+  volume_sell_history_30m_usd: number;
+  volume_sell_30m_change_percent: number;
+  trade_1h: number;
+  trade_history_1h: number;
+  trade_1h_change_percent: number;
+  sell_1h: number;
+  sell_history_1h: number;
+  sell_1h_change_percent: number;
+  buy_1h: number;
+  buy_history_1h: number;
+  buy_1h_change_percent: number;
+  volume_1h: number;
+  volume_1h_usd: number;
+  volume_history_1h: number;
+  volume_history_1h_usd: number;
+  volume_1h_change_percent: number;
+  volume_buy_1h: number;
+  volume_buy_1h_usd: number;
+  volume_buy_history_1h: number;
+  volume_buy_history_1h_usd: number;
+  volume_buy_1h_change_percent: number;
+  volume_sell_1h: number;
+  volume_sell_1h_usd: number;
+  volume_sell_history_1h: number;
+  volume_sell_history_1h_usd: number;
+  volume_sell_1h_change_percent: number;
+  trade_2h: number;
+  trade_history_2h: number;
+  trade_2h_change_percent: number;
+  sell_2h: number;
+  sell_history_2h: number;
+  sell_2h_change_percent: number;
+  buy_2h: number;
+  buy_history_2h: number;
+  buy_2h_change_percent: number;
+  volume_2h: number;
+  volume_2h_usd: number;
+  volume_history_2h: number;
+  volume_history_2h_usd: number;
+  volume_2h_change_percent: number;
+  volume_buy_2h: number;
+  volume_buy_2h_usd: number;
+  volume_buy_history_2h: number;
+  volume_buy_history_2h_usd: number;
+  volume_buy_2h_change_percent: number;
+  volume_sell_2h: number;
+  volume_sell_2h_usd: number;
+  volume_sell_history_2h: number;
+  volume_sell_history_2h_usd: number;
+  volume_sell_2h_change_percent: number;
+  trade_4h: number;
+  trade_history_4h: number;
+  trade_4h_change_percent: number;
+  sell_4h: number;
+  sell_history_4h: number;
+  sell_4h_change_percent: number;
+  buy_4h: number;
+  buy_history_4h: number;
+  buy_4h_change_percent: number;
+  volume_4h: number;
+  volume_4h_usd: number;
+  volume_history_4h: number;
+  volume_history_4h_usd: number;
+  volume_4h_change_percent: number;
+  volume_buy_4h: number;
+  volume_buy_4h_usd: number;
+  volume_buy_history_4h: number;
+  volume_buy_history_4h_usd: number;
+  volume_buy_4h_change_percent: number;
+  volume_sell_4h: number;
+  volume_sell_4h_usd: number;
+  volume_sell_history_4h: number;
+  volume_sell_history_4h_usd: number;
+  volume_sell_4h_change_percent: number;
+  trade_8h: number;
+  trade_history_8h: number;
+  trade_8h_change_percent: number;
+  sell_8h: number;
+  sell_history_8h: number;
+  sell_8h_change_percent: number;
+  buy_8h: number;
+  buy_history_8h: number;
+  buy_8h_change_percent: number;
+  volume_8h: number;
+  volume_8h_usd: number;
+  volume_history_8h: number;
+  volume_history_8h_usd: number;
+  volume_8h_change_percent: number;
+  volume_buy_8h: number;
+  volume_buy_8h_usd: number;
+  volume_buy_history_8h: number;
+  volume_buy_history_8h_usd: number;
+  volume_buy_8h_change_percent: number;
+  volume_sell_8h: number;
+  volume_sell_8h_usd: number;
+  volume_sell_history_8h: number;
+  volume_sell_history_8h_usd: number;
+  volume_sell_8h_change_percent: number;
+  trade_24h: number;
+  trade_history_24h: number;
+  trade_24h_change_percent: number;
+  sell_24h: number;
+  sell_history_24h: number;
+  sell_24h_change_percent: number;
+  buy_24h: number;
+  buy_history_24h: number;
+  buy_24h_change_percent: number;
+  volume_24h: number;
+  volume_24h_usd: number;
+  volume_history_24h: number;
+  volume_history_24h_usd: number;
+  volume_24h_change_percent: number;
+  volume_buy_24h: number;
+  volume_buy_24h_usd: number;
+  volume_buy_history_24h: number;
+  volume_buy_history_24h_usd: number;
+  volume_buy_24h_change_percent: number;
+  volume_sell_24h: number;
+  volume_sell_24h_usd: number;
+  volume_sell_history_24h: number;
+  volume_sell_history_24h_usd: number;
+  volume_sell_24h_change_percent: number;
+}