feat: add Account & Asset Explorer tools with read-only Horizon queries

.gitignore

@@ -1,32 +1,3 @@
-# Dependencies
 node_modules/
-package-lock.json
-
-# Build outputs
 dist/
-
-# Environment variables
-.env
-.env.local
-.env.*.local
-
-# IDE
-.vscode/
-.idea/
-*.swp
-*.swo
-*~
-
-# OS
-.DS_Store
-Thumbs.db
-
-# Logs
-*.log
-npm-debug.log*
-
-# Testing
-coverage/
-
-# Backup files
-*.backup
+.env

agent.ts

@@ -14,6 +14,26 @@ import {
   type SwapBestRouteParams,
   type SwapBestRouteResult,
 } from "./lib/dex";
+import {
+  getAccountInfo,
+  getBalances,
+  getTransactionHistory,
+  getOperationHistory,
+  fundTestnetAccount,
+  type AccountInfo,
+  type AccountBalance,
+  type TransactionRecord,
+  type OperationRecord,
+} from "./lib/account";
+import {
+  getAssetDetails,
+  getOrderbook,
+  getTrades,
+  type AssetDetails,
+  type OrderbookSummary,
+  type TradeRecord,
+  type StellarAssetInput as AssetStellarAssetInput,
+} from "./lib/asset";
 import { bridgeTokenTool } from "./tools/bridge";
 import { stellarGetBalanceTool, stellarGetAccountInfoTool } from "./tools/stellar";
 import {
@@ -67,6 +87,13 @@ export type {
   RouteQuote,
   SwapBestRouteParams,
   SwapBestRouteResult,
+  AccountInfo,
+  AccountBalance,
+  TransactionRecord,
+  OperationRecord,
+  AssetDetails,
+  OrderbookSummary,
+  TradeRecord,
 };
 
 export class AgentClient {
@@ -284,6 +311,165 @@ export class AgentClient {
     },
   };
 
+  /**
+   * Account explorer – read-only access to Stellar account data.
+   *
+   * These methods query the Horizon API and do NOT require a private key.
+   * They work on both testnet and mainnet.
+   */
+  public account = {
+    /**
+     * Get comprehensive account information: balances, signers, thresholds, flags.
+     *
+     * @param publicKey - The Stellar G-address to query (defaults to configured publicKey)
+     */
+    getInfo: async (publicKey?: string): Promise<AccountInfo> => {
+      const key = publicKey ?? this.publicKey;
+      if (!key) throw new Error("No public key provided or configured");
+      return await getAccountInfo(key, {
+        network: this.network,
+        horizonUrl: this.rpcUrl,
+      });
+    },
+
+    /**
+     * Get account balance summary.
+     *
+     * @param publicKey - The Stellar G-address to query (defaults to configured publicKey)
+     */
+    getBalances: async (publicKey?: string): Promise<AccountBalance[]> => {
+      const key = publicKey ?? this.publicKey;
+      if (!key) throw new Error("No public key provided or configured");
+      return await getBalances(key, {
+        network: this.network,
+        horizonUrl: this.rpcUrl,
+      });
+    },
+
+    /**
+     * Get recent transaction history.
+     *
+     * @param publicKey - The Stellar G-address (defaults to configured publicKey)
+     * @param limit     - Max transactions to return (1–50, default 10)
+     * @param order     - 'desc' (newest first) or 'asc' (oldest first)
+     */
+    getTransactions: async (
+      publicKey?: string,
+      limit: number = 10,
+      order: "asc" | "desc" = "desc"
+    ): Promise<TransactionRecord[]> => {
+      const key = publicKey ?? this.publicKey;
+      if (!key) throw new Error("No public key provided or configured");
+      return await getTransactionHistory(key, {
+        network: this.network,
+        horizonUrl: this.rpcUrl,
+      }, limit, order);
+    },
+
+    /**
+     * Get recent operation history.
+     *
+     * @param publicKey - The Stellar G-address (defaults to configured publicKey)
+     * @param limit     - Max operations to return (1–50, default 10)
+     * @param order     - 'desc' (newest first) or 'asc' (oldest first)
+     */
+    getOperations: async (
+      publicKey?: string,
+      limit: number = 10,
+      order: "asc" | "desc" = "desc"
+    ): Promise<OperationRecord[]> => {
+      const key = publicKey ?? this.publicKey;
+      if (!key) throw new Error("No public key provided or configured");
+      return await getOperationHistory(key, {
+        network: this.network,
+        horizonUrl: this.rpcUrl,
+      }, limit, order);
+    },
+
+    /**
+     * Fund a testnet account using Stellar Friendbot.
+     * Only works on testnet. Creates and funds the account with 10,000 test XLM.
+     *
+     * @param publicKey - The Stellar G-address to fund (defaults to configured publicKey)
+     */
+    fundTestnet: async (
+      publicKey?: string
+    ): Promise<{ success: boolean; message: string }> => {
+      if (this.network !== "testnet") {
+        throw new Error(
+          "Friendbot funding is only available on testnet. " +
+          "Initialize AgentClient with network: 'testnet' to use this method."
+        );
+      }
+      const key = publicKey ?? this.publicKey;
+      if (!key) throw new Error("No public key provided or configured");
+      return await fundTestnetAccount(key);
+    },
+  };
+
+  /**
+   * Asset & market data explorer – read-only access to Stellar asset information.
+   *
+   * These methods query the Horizon API and do NOT require a private key.
+   * They work on both testnet and mainnet.
+   */
+  public asset = {
+    /**
+     * Look up details about a Stellar asset.
+     * Returns metadata including trust count, circulating supply, and issuer flags.
+     *
+     * @param assetCode   - The asset code (e.g. "USDC")
+     * @param assetIssuer - The issuer's public key
+     */
+    getDetails: async (
+      assetCode: string,
+      assetIssuer: string
+    ): Promise<AssetDetails[]> => {
+      return await getAssetDetails(assetCode, assetIssuer, {
+        network: this.network,
+        horizonUrl: this.rpcUrl,
+      });
+    },
+
+    /**
+     * Fetch the current SDEX orderbook for a trading pair.
+     *
+     * @param baseAsset    - The base asset (e.g. { type: "native" } or { code: "USDC", issuer: "G..." })
+     * @param counterAsset - The counter asset
+     * @param limit        - Number of entries per side (1–200, default 10)
+     */
+    getOrderbook: async (
+      baseAsset: AssetStellarAssetInput,
+      counterAsset: AssetStellarAssetInput,
+      limit: number = 10
+    ): Promise<OrderbookSummary> => {
+      return await getOrderbook(baseAsset, counterAsset, {
+        network: this.network,
+        horizonUrl: this.rpcUrl,
+      }, limit);
+    },
+
+    /**
+     * Fetch recent trades for a trading pair on the SDEX.
+     *
+     * @param baseAsset    - The base asset
+     * @param counterAsset - The counter asset
+     * @param limit        - Max trades to return (1–50, default 10)
+     * @param order        - 'desc' (newest first) or 'asc' (oldest first)
+     */
+    getTrades: async (
+      baseAsset: AssetStellarAssetInput,
+      counterAsset: AssetStellarAssetInput,
+      limit: number = 10,
+      order: "asc" | "desc" = "desc"
+    ): Promise<TradeRecord[]> => {
+      return await getTrades(baseAsset, counterAsset, {
+        network: this.network,
+        horizonUrl: this.rpcUrl,
+      }, limit, order);
+    },
+  };
+
   /**
    * Launch a new token on the Stellar network.
    * 

index.ts

@@ -3,40 +3,65 @@ import { StellarLiquidityContractTool } from "./tools/contract";
 import { StellarDexTool } from "./tools/dex";
 import { StellarContractTool } from "./tools/stake";
 import { stellarSendPaymentTool, stellarGetBalanceTool, stellarGetAccountInfoTool } from "./tools/stellar";
-import { 
-  AgentClient, 
-  AgentConfig,
-  LaunchTokenParams,
-  LaunchTokenResult,
-} from "./agent";
-import type {
-  StellarAssetInput,
-  QuoteSwapParams,
-  RouteQuote,
-  SwapBestRouteParams,
-  SwapBestRouteResult,
-} from "./agent";
+import { StellarClaimBalanceTool } from "./tools/claim_balance_tool";
+import { StellarAccountTool } from "./tools/account";
+import { StellarAssetTool } from "./tools/asset";
 
-export { 
+// Agent exportları (Hem sınıfları hem de tipleri içerecek şekilde)
+export {
   AgentClient,
   AgentConfig,
   LaunchTokenParams,
   LaunchTokenResult,
-};
+} from "./agent";
 
 export type {
   StellarAssetInput,
   QuoteSwapParams,
   RouteQuote,
   SwapBestRouteParams,
   SwapBestRouteResult,
-};
+  AccountInfo,
+  AccountBalance,
+  TransactionRecord,
+  OperationRecord,
+  AssetDetails,
+  OrderbookSummary,
+  TradeRecord,
+} from "./agent";
+
+// claim_balance_tool içindeki her şeyi export et
+export * from "./tools/claim_balance_tool";
+
+// Account & Asset tool exportları
+export { StellarAccountTool } from "./tools/account";
+export { StellarAssetTool } from "./tools/asset";
+
+// Lib-level exports for direct usage
+export {
+  getAccountInfo,
+  getBalances,
+  getTransactionHistory,
+  getOperationHistory,
+  fundTestnetAccount,
+} from "./lib/account";
+
+export {
+  getAssetDetails,
+  getOrderbook,
+  getTrades,
+} from "./lib/asset";
+
+// Bütün tool'ların listesi
 export const stellarTools = [
   bridgeTokenTool,
   StellarDexTool,
   StellarLiquidityContractTool,
   StellarContractTool,
   stellarSendPaymentTool,
   stellarGetBalanceTool,
-  stellarGetAccountInfoTool
+  stellarGetAccountInfoTool,
+  StellarClaimBalanceTool,
+  StellarAccountTool,
+  StellarAssetTool,
 ];