@elizaos/plugin-wallet 2.0.0-beta.1 → 2.0.3-beta.5

package/dist/analytics/birdeye/types/api/wallet.d.ts

@@ -0,0 +1,161 @@
+export interface WalletPortfolioParams {
+    wallet: string;
+}
+export interface WalletPortfolioResponse {
+    success: boolean;
+    data: {
+        wallet?: string;
+        totalUsd?: number;
+        items: Array<{
+            address?: string;
+            name?: string;
+            symbol?: string;
+            decimals?: number;
+            balance?: string;
+            uiAmount?: number;
+            chainId?: string;
+            logoURI?: string;
+            priceUsd?: number;
+            valueUsd?: number;
+        }>;
+    };
+}
+export interface WalletTokenBalanceParams {
+    wallet: string;
+    token_address: string;
+}
+export interface WalletTokenBalanceResponse {
+    success: boolean;
+    data: {
+        address?: string;
+        name?: string;
+        symbol?: string;
+        decimals?: number;
+        balance?: number;
+        uiAmount?: number;
+        chainId?: string;
+        priceUsd?: number;
+        valueUsd?: number;
+    };
+}
+export interface WalletTransactionHistoryParams {
+    wallet: string;
+    limit?: number;
+    before?: string;
+}
+export interface WalletTransactionHistoryResponse {
+    success: boolean;
+    data: {
+        [chain: string]: Array<{
+            txHash?: string;
+            blockNumber?: number;
+            blockTime?: string;
+            status?: boolean;
+            from?: string;
+            to?: string;
+            gasUsed?: number;
+            gasPrice?: number;
+            fee?: string;
+            feeUsd?: number;
+            value?: string;
+            contractLabel?: {
+                address?: string;
+                name?: string;
+                metadata?: Record<string, unknown>;
+            };
+            mainAction?: string;
+            balanceChange?: Array<{
+                name?: string;
+                symbol?: string;
+                logoURI?: string;
+                address?: string;
+                amount?: number;
+                decimals?: number;
+            }>;
+        }>;
+    };
+}
+export interface WalletNetworksResponse {
+    success: boolean;
+    data: {
+        chains?: string[];
+    };
+}
+export interface WalletPortfolioMultichainParams {
+    wallet: string;
+}
+export interface WalletPortfolioMultichainResponse {
+    success: boolean;
+    data: {
+        items: Array<{
+            chain?: string;
+            address?: string;
+            symbol?: string;
+            name?: string;
+            decimals?: number;
+            price?: number;
+            priceChange24h?: number;
+            value?: number;
+            amount?: number;
+        }>;
+        total?: number;
+        totalValue?: number;
+    };
+}
+export interface WalletTransactionHistoryMultichainParams {
+    wallet: string;
+}
+export interface WalletTransactionHistoryMultichainResponse {
+    success: boolean;
+    data: {
+        [chain: string]: Array<{
+            txHash?: string;
+            blockNumber?: number;
+            blockTime?: string;
+            status?: boolean;
+            from?: string;
+            to?: string;
+            gasUsed?: number;
+            gasPrice?: number;
+            fee?: string;
+            feeUsd?: number;
+            value?: string;
+            contractLabel?: {
+                address?: string;
+                name?: string;
+                metadata?: Record<string, unknown>;
+            };
+            mainAction?: string;
+            balanceChange?: Array<{
+                name?: string;
+                symbol?: string;
+                logoURI?: string;
+                address?: string;
+                amount?: number;
+                decimals?: number;
+            }>;
+        }>;
+    };
+}
+export interface WalletSimulationParams {
+    from?: string;
+    to?: string;
+    data?: string;
+    value?: string;
+}
+export interface WalletSimulationResponse {
+    success: boolean;
+    data: {
+        balanceChange: Array<{
+            index?: number;
+            before?: number;
+            after?: number;
+            address?: string;
+            name?: string;
+            symbol?: string;
+            logoURI?: string;
+            decimals?: number;
+        }>;
+        gasUsed?: number;
+    };
+}

package/dist/analytics/birdeye/types/shared.d.ts

@@ -0,0 +1,83 @@
+import type { BIRDEYE_SUPPORTED_CHAINS } from "../utils";
+export type BirdeyeSupportedChain = (typeof BIRDEYE_SUPPORTED_CHAINS)[number];
+export interface BaseAddress {
+    type?: "wallet" | "token" | "contract";
+    symbol?: string;
+    address: string;
+    chain: BirdeyeSupportedChain;
+}
+export interface WalletAddress extends BaseAddress {
+    type: "wallet";
+}
+export interface TokenAddress extends BaseAddress {
+    type: "token";
+}
+export interface ContractAddress extends BaseAddress {
+    type: "contract";
+}
+export interface CacheWrapper<T> {
+    data: T;
+    /** Unix ms timestamp when the entry was set */
+    setAt: number;
+}
+export interface GetCacheTimedOptions {
+    /** Max age in milliseconds. If exceeded, treat as a cache miss. */
+    notOlderThan?: number;
+    /** Timestamp in milliseconds for cache entry. Defaults to Date.now() if not provided. */
+    tsInMs?: number;
+}
+/**
+ * Interface representing a token with various properties.
+ * @typedef { object } IToken
+ * @property { TDataProvider } provider - The data provider of the token.
+ * @property { TChain } chain - The blockchain the token belongs to.
+ * @property { string } address - The address of the token.
+ * @property { number } decimals - The number of decimal places for the token.
+ * @property { number } liquidity - The liquidity of the token.
+ * @property { number } marketcap - The market cap of the token.
+ * @property { string } logoURI - The URI for the token's logo.
+ * @property { string } name - The name of the token.
+ * @property { string } symbol - The symbol of the token.
+ * @property { number } volume24hUSD - The 24-hour trading volume in USD.
+ * @property { number } rank - The rank of the token.
+ * @property { number } price - The current price of the token.
+ * @property { number } price24hChangePercent - The percentage change in price over the last 24 hours.
+ * @property { Date } last_updated - The date when the token data was last updated.
+ */
+export interface IToken {
+    provider: string;
+    chain: BirdeyeSupportedChain;
+    address: string;
+    decimals: number;
+    liquidity: number;
+    marketcap: number;
+    logoURI: string;
+    name: string;
+    symbol: string;
+    volume24hUSD: number;
+    rank: number;
+    price: number;
+    price24hChangePercent: number;
+    last_updated: Date;
+}
+/**
+ * Interface representing a transaction history entry.
+ * @property {string} txHash - The hash of the transaction.
+ * @property {Date} blockTime - The time when the transaction occurred.
+ * @property {any} data - Additional data related to the transaction.
+ */
+export interface TransactionHistory {
+    txHash: string;
+    blockTime: Date;
+    data: unknown;
+}
+/**
+ * Interface representing a Portfolio object.
+ * @typedef {Object} Portfolio
+ * @property {string} key - The key associated with the portfolio.
+ * @property {any} data - The data contained in the portfolio.
+ */
+export interface Portfolio {
+    key: string;
+    data: unknown;
+}

package/dist/analytics/birdeye/utils.d.ts

@@ -0,0 +1,74 @@
+import type { BirdeyeApiParams } from "./types/api/common";
+import type { TokenMarketSearchResponse, TokenResult } from "./types/api/search";
+import type { TokenMetadataSingleResponse } from "./types/api/token";
+import type { BaseAddress, BirdeyeSupportedChain } from "./types/shared";
+export declare const BASE_URL = "https://public-api.birdeye.so";
+export declare const BIRDEYE_SUPPORTED_CHAINS: readonly ["solana", "ethereum", "arbitrum", "avalanche", "bsc", "optimism", "polygon", "base", "zksync", "sui", "evm"];
+export declare const CHAIN_ALIASES: Record<string, BirdeyeSupportedChain>;
+export declare class BirdeyeApiError extends Error {
+    status: number;
+    constructor(status: number, message: string);
+}
+export interface ApiResponse<T> {
+    success: boolean;
+    data: T;
+    error?: string;
+}
+export declare const TIME_UNITS: {
+    readonly second: 1;
+    readonly minute: 60;
+    readonly hour: 3600;
+    readonly day: 86400;
+    readonly week: 604800;
+    readonly month: 2592000;
+};
+export declare const TIMEFRAME_KEYWORDS: {
+    readonly "1m": 60;
+    readonly "3m": 180;
+    readonly "5m": 300;
+    readonly "15m": 900;
+    readonly "30m": 1800;
+    readonly "1h": 3600;
+    readonly "2h": 7200;
+    readonly "4h": 14400;
+    readonly "6h": 21600;
+    readonly "12h": 43200;
+    readonly "1d": 86400;
+    readonly "1w": 604800;
+};
+export type TimeUnit = keyof typeof TIME_UNITS;
+export type Timeframe = keyof typeof TIMEFRAME_KEYWORDS;
+/**
+ * Extract blockchain chain from address with optional explicit chain setting
+ * @param text - The wallet address to analyze (optional if explicitChain is provided)
+ * @param explicitChain - Optional explicit chain specification (from BIRDEYE_CHAIN setting)
+ * @returns The detected or specified chain
+ * @throws Error if address format is invalid or EVM address without explicit chain
+ */
+export declare const extractChain: (text?: string, explicitChain?: string) => BirdeyeSupportedChain;
+export declare const extractAddresses: (text: string) => BaseAddress[];
+export declare const extractTimeframe: (text: string) => Timeframe;
+export declare const extractTimeRange: (text: string) => {
+    start: number;
+    end: number;
+};
+export declare const extractLimit: (text: string) => number;
+export declare const formatValue: (value?: number) => string;
+export declare const formatPercentChange: (change?: number) => string;
+export declare const shortenAddress: (address?: string) => string;
+export declare const formatTimestamp: (timestamp?: number) => string;
+export declare const formatPrice: (price?: number) => string;
+export declare const formatJsonScalar: (value: unknown) => string;
+export declare const formatJsonTable: (label: string, rows: Array<Record<string, unknown>>, fields: string[]) => string;
+export declare function makeApiRequest<T>(url: string, options: {
+    apiKey: string;
+    chain?: BirdeyeSupportedChain;
+    method?: "GET" | "POST";
+    body?: unknown;
+}): Promise<T>;
+export declare const formatTokenInfo: (token: TokenResult, metadata?: TokenMetadataSingleResponse) => string;
+export declare const extractSymbols: (text: string, mode?: "strict" | "loose") => string[];
+export declare const formatMetadataResponse: (data: TokenMetadataSingleResponse, chain: BirdeyeSupportedChain) => string;
+export declare const waitFor: (ms: number) => Promise<unknown>;
+export declare const convertToStringParams: (params: BirdeyeApiParams | Record<string, unknown>) => Record<string, string>;
+export declare const getTokenResultFromSearchResponse: (response: TokenMarketSearchResponse) => TokenResult[] | undefined;

package/dist/analytics/dexscreener/errors.d.ts

@@ -0,0 +1,2 @@
+/** Best-effort message extraction for DexScreener HTTP / fetch failures. */
+export declare function dexScreenerErrorMessage(caught: unknown): string;

package/dist/analytics/dexscreener/index.d.ts

@@ -0,0 +1,3 @@
+export { registerDexScreenerSearchCategory } from "./search-category";
+export { DexScreenerService } from "./service";
+export * from "./types";

package/dist/analytics/dexscreener/search-category.d.ts

@@ -0,0 +1,3 @@
+import type { IAgentRuntime, SearchCategoryRegistration } from "@elizaos/core";
+export declare const DEXSCREENER_SEARCH_CATEGORY: SearchCategoryRegistration;
+export declare function registerDexScreenerSearchCategory(runtime: IAgentRuntime): void;

package/dist/analytics/dexscreener/service.d.ts

@@ -0,0 +1,34 @@
+import { type IAgentRuntime, Service } from "@elizaos/core";
+import type { DexScreenerBoostedToken, DexScreenerChainParams, DexScreenerNewPairsParams, DexScreenerOrder, DexScreenerPair, DexScreenerPairParams, DexScreenerProfile, DexScreenerSearchParams, DexScreenerServiceResponse, DexScreenerTokenParams, DexScreenerTrendingParams } from "./types";
+type DexScreenerBoostedWire = DexScreenerBoostedToken & {
+    labels?: string[];
+};
+export declare class DexScreenerService extends Service {
+    static serviceType: "dexscreener";
+    private baseUrl;
+    private defaultHeaders;
+    private dexConfig;
+    private lastRequestTime;
+    capabilityDescription: string;
+    static start(runtime: IAgentRuntime): Promise<Service>;
+    stop(): Promise<void>;
+    private get;
+    private rateLimit;
+    search(params: DexScreenerSearchParams): Promise<DexScreenerServiceResponse<DexScreenerPair[]>>;
+    getTokenPairs(params: DexScreenerTokenParams): Promise<DexScreenerServiceResponse<DexScreenerPair[]>>;
+    getPair(params: DexScreenerPairParams): Promise<DexScreenerServiceResponse<DexScreenerPair>>;
+    getTrending(params?: DexScreenerTrendingParams): Promise<DexScreenerServiceResponse<DexScreenerPair[]>>;
+    getPairsByChain(params: DexScreenerChainParams): Promise<DexScreenerServiceResponse<DexScreenerPair[]>>;
+    getNewPairs(params?: DexScreenerNewPairsParams): Promise<DexScreenerServiceResponse<DexScreenerPair[]>>;
+    getTokenProfile(tokenAddress: string): Promise<DexScreenerServiceResponse<DexScreenerProfile>>;
+    formatPrice(price: string | number): string;
+    formatPriceChange(change: number): string;
+    formatUsdValue(value: number): string;
+    getMultipleTokens(chainId: string, tokenAddresses: string[]): Promise<DexScreenerServiceResponse<DexScreenerPair[]>>;
+    getLatestTokenProfiles(): Promise<DexScreenerServiceResponse<DexScreenerProfile[]>>;
+    getLatestBoostedTokens(): Promise<DexScreenerServiceResponse<DexScreenerBoostedWire[]>>;
+    getTopBoostedTokens(): Promise<DexScreenerServiceResponse<DexScreenerBoostedWire[]>>;
+    checkOrderStatus(chainId: string, tokenAddress: string): Promise<DexScreenerServiceResponse<DexScreenerOrder[]>>;
+    getTokenPairsByChain(chainId: string, tokenAddress: string): Promise<DexScreenerServiceResponse<DexScreenerPair[]>>;
+}
+export {};

package/dist/analytics/dexscreener/types.d.ts

@@ -0,0 +1,131 @@
+export interface DexScreenerTokenInfo {
+    address: string;
+    name: string;
+    symbol: string;
+    decimals: number;
+}
+export interface DexScreenerPair {
+    chainId: string;
+    dexId: string;
+    url: string;
+    pairAddress: string;
+    labels?: string[];
+    baseToken: DexScreenerTokenInfo;
+    quoteToken: DexScreenerTokenInfo;
+    priceNative: string;
+    priceUsd?: string;
+    txns: {
+        m5: {
+            buys: number;
+            sells: number;
+        };
+        h1: {
+            buys: number;
+            sells: number;
+        };
+        h6: {
+            buys: number;
+            sells: number;
+        };
+        h24: {
+            buys: number;
+            sells: number;
+        };
+    };
+    volume: {
+        h24: number;
+        h6: number;
+        h1: number;
+        m5: number;
+    };
+    priceChange: {
+        m5: number;
+        h1: number;
+        h6: number;
+        h24: number;
+    };
+    liquidity?: {
+        usd?: number;
+        base: number;
+        quote: number;
+    };
+    fdv?: number;
+    marketCap?: number;
+    pairCreatedAt?: number;
+    info?: {
+        imageUrl?: string;
+        websites?: {
+            label: string;
+            url: string;
+        }[];
+        socials?: {
+            type: string;
+            url: string;
+        }[];
+    };
+}
+export interface DexScreenerSearchParams {
+    query: string;
+}
+export interface DexScreenerTokenParams {
+    tokenAddress: string;
+}
+export interface DexScreenerPairParams {
+    pairAddress: string;
+}
+export interface DexScreenerTrendingParams {
+    timeframe?: "1h" | "6h" | "24h";
+    limit?: number;
+}
+export interface DexScreenerChainParams {
+    chain: string;
+    sortBy?: "volume" | "liquidity" | "priceChange" | "txns";
+    limit?: number;
+}
+export interface DexScreenerNewPairsParams {
+    chain?: string;
+    limit?: number;
+}
+export interface DexScreenerProfile {
+    url: string;
+    chainId: string;
+    tokenAddress: string;
+    icon?: string;
+    header?: string;
+    openGraph?: string;
+    description?: string;
+    links?: Array<{
+        label: string;
+        type: string;
+        url: string;
+    }>;
+}
+export interface DexScreenerServiceResponse<T> {
+    success: boolean;
+    data?: T;
+    error?: string;
+}
+export interface DexScreenerConfig {
+    apiUrl?: string;
+    rateLimitDelay?: number;
+}
+export interface DexScreenerBoostedToken {
+    url: string;
+    chainId: string;
+    tokenAddress: string;
+    amount: number;
+    totalAmount: number;
+    icon?: string;
+    header?: string;
+    description?: string;
+    links?: Array<{
+        type: string;
+        label: string;
+        url: string;
+    }>;
+}
+export interface DexScreenerOrder {
+    type: "tokenProfile" | "boost" | string;
+    status: "processing" | "completed" | "failed" | string;
+    paymentTimestamp: number;
+}

package/dist/analytics/lpinfo/index.d.ts

@@ -0,0 +1,31 @@
+import type { Plugin } from "@elizaos/core";
+/**
+ * Liquidity Pool Information Plugin
+ *
+ * A comprehensive plugin that provides liquidity pool management and analytics
+ * for multiple DeFi protocols on Solana.
+ *
+ * Supported Protocols:
+ * - Steer Finance: Vault and staking pool management
+ * - Kamino Protocol: Lending and liquidity pool management
+ *
+ * Features:
+ * - Multi-protocol liquidity pool tracking
+ * - Yield optimization analytics
+ * - Position tracking and management
+ * - Market data and statistics
+ *
+ * @author ElizaOS
+ * @version 1.0.0
+ */
+export declare const lpinfoPlugin: Plugin;
+export default lpinfoPlugin;
+export { kaminoPlugin } from "./kamino";
+export * from "./kamino/providers/kaminoLiquidityProvider";
+export * from "./kamino/providers/kaminoPoolProvider";
+export * from "./kamino/providers/kaminoProvider";
+export * from "./kamino/services/kaminoLiquidityService";
+export * from "./kamino/services/kaminoService";
+export { steerPlugin } from "./steer";
+export * from "./steer/providers/steerLiquidityProvider";
+export * from "./steer/services/steerLiquidityService";

package/dist/analytics/lpinfo/kamino/index.d.ts

@@ -0,0 +1,7 @@
+import type { Plugin } from "@elizaos/core";
+/**
+ * Kamino Protocol Plugin
+ * Provides comprehensive access to Kamino lending and liquidity protocols
+ */
+export declare const kaminoPlugin: Plugin;
+export default kaminoPlugin;

package/dist/analytics/lpinfo/kamino/providers/kaminoLiquidityProvider.d.ts

@@ -0,0 +1,6 @@
+import type { Provider } from "@elizaos/core";
+/**
+ * Kamino Liquidity Protocol Provider
+ * Provides information about Kamino liquidity pools and strategies
+ */
+export declare const kaminoLiquidityProvider: Provider;

package/dist/analytics/lpinfo/kamino/providers/kaminoPoolProvider.d.ts

@@ -0,0 +1,6 @@
+import type { Provider } from "@elizaos/core";
+/**
+ * Kamino Pool-Specific Provider
+ * Provides detailed information about specific Kamino pools by their address
+ */
+export declare const kaminoPoolProvider: Provider;

package/dist/analytics/lpinfo/kamino/providers/kaminoProvider.d.ts

@@ -0,0 +1,6 @@
+import type { Provider } from "@elizaos/core";
+/**
+ * Kamino Lending Protocol Provider
+ * Provides information about Kamino lending positions and market data
+ */
+export declare const kaminoProvider: Provider;