@blockbima/xrpl-integration 0.1.0

package/dist/client/XRPLClient.d.ts

@@ -0,0 +1,107 @@
+import { Client, type Wallet } from "xrpl";
+import { type TrustlineInfo, type XRPBalanceResult, type IOUBalanceResult, type SendXRPOptions, type SendIOUOptions, type TransactionResult } from "../types/index.js";
+/**
+ * Singleton wrapper client for XRP Ledger interactions
+ * Provides a simplified interface for common XRPL operations
+ */
+export declare class XRPLClient {
+    private static instance;
+    private client;
+    private networkUrl;
+    private _isConnected;
+    /**
+     * Private constructor to enforce singleton pattern
+     * @param networkUrl - WebSocket URL for the XRPL node
+     */
+    private constructor();
+    /**
+     * Gets the singleton instance of XRPLClient
+     * @param networkUrl - Optional WebSocket URL for the XRPL node (only used on first call)
+     * @returns The singleton XRPLClient instance
+     */
+    static getInstance(networkUrl?: string): XRPLClient;
+    /**
+     * Resets the singleton instance (useful for testing or changing networks)
+     * Will disconnect if currently connected
+     */
+    static resetInstance(): Promise<void>;
+    /**
+     * Gets the current connection status
+     */
+    get isConnected(): boolean;
+    /**
+     * Gets the current network URL
+     */
+    get network(): string;
+    /**
+     * Gets the underlying xrpl.js Client instance
+     * Use with caution - prefer using wrapper methods
+     */
+    get rawClient(): Client;
+    /**
+     * Connects to the XRPL network
+     * @throws XRPLClientError if connection fails
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnects from the XRPL network
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Ensures the client is connected before performing operations
+     * @throws XRPLClientError if not connected
+     */
+    private ensureConnected;
+    /**
+     * Gets the XRP balance for an account
+     * @param address - The account address to query
+     * @returns The XRP balance information
+     * @throws XRPLClientError if account not found or other error
+     */
+    getXRPBalance(address: string): Promise<XRPBalanceResult>;
+    /**
+     * Gets the IOU token balance for an account
+     * @param address - The account address to query
+     * @param currency - The currency code
+     * @param issuer - The token issuer address
+     * @returns The IOU balance information
+     * @throws XRPLClientError if trustline not found or other error
+     */
+    getIOUBalance(address: string, currency: string, issuer: string): Promise<IOUBalanceResult>;
+    /**
+     * Sends XRP from one account to another
+     * @param options - The send options
+     * @returns The transaction result
+     * @throws XRPLClientError if transaction fails
+     */
+    sendXRP(options: SendXRPOptions): Promise<TransactionResult>;
+    /**
+     * Sends IOU tokens from one account to another
+     * @param options - The send options
+     * @returns The transaction result
+     * @throws XRPLClientError if transaction fails
+     */
+    sendIOU(options: SendIOUOptions): Promise<TransactionResult>;
+    /**
+     * Checks if a trustline exists between an account and an issuer
+     * @param address - The account address to check
+     * @param currency - The currency code
+     * @param issuer - The token issuer address
+     * @returns Trustline information including whether it exists
+     */
+    checkTrustline(address: string, currency: string, issuer: string): Promise<TrustlineInfo>;
+    /**
+     * Gets all trustlines for an account
+     * @param address - The account address to query
+     * @returns Array of trustline information
+     */
+    getAllTrustlines(address: string): Promise<TrustlineInfo[]>;
+    /**
+     * Funds a wallet on testnet/devnet using the faucet
+     * Only works on test networks
+     * @param wallet - Optional wallet to fund (creates new one if not provided)
+     * @returns The funded wallet
+     */
+    fundWallet(wallet?: Wallet): Promise<Wallet>;
+}
+//# sourceMappingURL=XRPLClient.d.ts.map

package/dist/client/XRPLClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"XRPLClient.d.ts","sourceRoot":"","sources":["../../src/client/XRPLClient.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,KAAK,MAAM,EAKZ,MAAM,MAAM,CAAC;AACd,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EAIvB,MAAM,mBAAmB,CAAC;AAS3B;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA2B;IAClD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAAkB;IAEtC;;;OAGG;IACH,OAAO;IAcP;;;;OAIG;WACW,WAAW,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,UAAU;IAO1D;;;OAGG;WACiB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAOlD;;OAEG;IACH,IAAW,WAAW,IAAI,OAAO,CAEhC;IAED;;OAEG;IACH,IAAW,OAAO,IAAI,MAAM,CAE3B;IAED;;;OAGG;IACH,IAAW,SAAS,IAAI,MAAM,CAE7B;IAED;;;OAGG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBrC;;OAEG;IACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IASxC;;;OAGG;IACH,OAAO,CAAC,eAAe;IASvB;;;;;OAKG;IACU,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAkCtE;;;;;;;OAOG;IACU,aAAa,CACxB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,gBAAgB,CAAC;IA+C5B;;;;;OAKG;IACU,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAiDzE;;;;;OAKG;IACU,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAsDzE;;;;;;OAMG;IACU,cAAc,CACzB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,aAAa,CAAC;IA6DzB;;;;OAIG;IACU,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IA0CxE;;;;;OAKG;IACU,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAM1D"}

package/dist/client/XRPLClient.js

@@ -0,0 +1,377 @@
+import { Client, } from "xrpl";
+import { XRPLClientError, XRPLClientErrorType, NETWORKS, } from "../types/index.js";
+import { validateAddress, validateAmount, convertXRPToDrops, convertDropsToXRP, createMemo, } from "../utils/index.js";
+/**
+ * Singleton wrapper client for XRP Ledger interactions
+ * Provides a simplified interface for common XRPL operations
+ */
+export class XRPLClient {
+    static instance = null;
+    client;
+    networkUrl;
+    _isConnected = false;
+    /**
+     * Private constructor to enforce singleton pattern
+     * @param networkUrl - WebSocket URL for the XRPL node
+     */
+    constructor(networkUrl = NETWORKS.TESTNET) {
+        this.networkUrl = networkUrl;
+        this.client = new Client(networkUrl);
+        // Set up connection event handlers
+        this.client.on("connected", () => {
+            this._isConnected = true;
+        });
+        this.client.on("disconnected", () => {
+            this._isConnected = false;
+        });
+    }
+    /**
+     * Gets the singleton instance of XRPLClient
+     * @param networkUrl - Optional WebSocket URL for the XRPL node (only used on first call)
+     * @returns The singleton XRPLClient instance
+     */
+    static getInstance(networkUrl) {
+        if (!XRPLClient.instance) {
+            XRPLClient.instance = new XRPLClient(networkUrl);
+        }
+        return XRPLClient.instance;
+    }
+    /**
+     * Resets the singleton instance (useful for testing or changing networks)
+     * Will disconnect if currently connected
+     */
+    static async resetInstance() {
+        if (XRPLClient.instance) {
+            await XRPLClient.instance.disconnect();
+            XRPLClient.instance = null;
+        }
+    }
+    /**
+     * Gets the current connection status
+     */
+    get isConnected() {
+        return this._isConnected && this.client.isConnected();
+    }
+    /**
+     * Gets the current network URL
+     */
+    get network() {
+        return this.networkUrl;
+    }
+    /**
+     * Gets the underlying xrpl.js Client instance
+     * Use with caution - prefer using wrapper methods
+     */
+    get rawClient() {
+        return this.client;
+    }
+    /**
+     * Connects to the XRPL network
+     * @throws XRPLClientError if connection fails
+     */
+    async connect() {
+        if (this.isConnected) {
+            return;
+        }
+        try {
+            await this.client.connect();
+            this._isConnected = true;
+        }
+        catch (error) {
+            throw new XRPLClientError(XRPLClientErrorType.CONNECTION_ERROR, `Failed to connect to XRPL network at ${this.networkUrl}`, error);
+        }
+    }
+    /**
+     * Disconnects from the XRPL network
+     */
+    async disconnect() {
+        if (!this.isConnected) {
+            return;
+        }
+        await this.client.disconnect();
+        this._isConnected = false;
+    }
+    /**
+     * Ensures the client is connected before performing operations
+     * @throws XRPLClientError if not connected
+     */
+    ensureConnected() {
+        if (!this.isConnected) {
+            throw new XRPLClientError(XRPLClientErrorType.NOT_CONNECTED, "Client is not connected. Call connect() first.");
+        }
+    }
+    /**
+     * Gets the XRP balance for an account
+     * @param address - The account address to query
+     * @returns The XRP balance information
+     * @throws XRPLClientError if account not found or other error
+     */
+    async getXRPBalance(address) {
+        this.ensureConnected();
+        validateAddress(address);
+        try {
+            const response = await this.client.request({
+                command: "account_info",
+                account: address,
+                ledger_index: "validated",
+            });
+            const balanceDrops = response.result.account_data.Balance;
+            const balance = convertDropsToXRP(balanceDrops);
+            return {
+                address,
+                balance,
+                balanceDrops,
+            };
+        }
+        catch (error) {
+            if (error instanceof Error &&
+                error.message.includes("actNotFound")) {
+                throw new XRPLClientError(XRPLClientErrorType.ACCOUNT_NOT_FOUND, `Account not found: ${address}`, error);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Gets the IOU token balance for an account
+     * @param address - The account address to query
+     * @param currency - The currency code
+     * @param issuer - The token issuer address
+     * @returns The IOU balance information
+     * @throws XRPLClientError if trustline not found or other error
+     */
+    async getIOUBalance(address, currency, issuer) {
+        this.ensureConnected();
+        validateAddress(address);
+        validateAddress(issuer);
+        try {
+            const response = await this.client.request({
+                command: "account_lines",
+                account: address,
+                peer: issuer,
+                ledger_index: "validated",
+            });
+            const trustline = response.result.lines.find((line) => line.currency === currency);
+            if (!trustline) {
+                return {
+                    address,
+                    currency,
+                    issuer,
+                    balance: "0",
+                };
+            }
+            return {
+                address,
+                currency,
+                issuer,
+                balance: trustline.balance,
+            };
+        }
+        catch (error) {
+            if (error instanceof Error &&
+                error.message.includes("actNotFound")) {
+                throw new XRPLClientError(XRPLClientErrorType.ACCOUNT_NOT_FOUND, `Account not found: ${address}`, error);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Sends XRP from one account to another
+     * @param options - The send options
+     * @returns The transaction result
+     * @throws XRPLClientError if transaction fails
+     */
+    async sendXRP(options) {
+        this.ensureConnected();
+        validateAddress(options.destination);
+        validateAmount(options.amount);
+        const payment = {
+            TransactionType: "Payment",
+            Account: options.wallet.address,
+            Destination: options.destination,
+            Amount: convertXRPToDrops(options.amount),
+        };
+        // Add destination tag if provided
+        if (options.destinationTag !== undefined) {
+            payment.DestinationTag = options.destinationTag;
+        }
+        // Add memo if provided
+        if (options.memo) {
+            payment.Memos = createMemo(options.memo);
+        }
+        try {
+            const prepared = await this.client.autofill(payment);
+            const response = await this.client.submitAndWait(prepared, {
+                wallet: options.wallet,
+            });
+            const success = typeof response.result.meta === "object" &&
+                response.result.meta !== null &&
+                "TransactionResult" in response.result.meta &&
+                response.result.meta.TransactionResult === "tesSUCCESS";
+            return {
+                success,
+                hash: response.result.hash,
+                ledgerIndex: response.result.ledger_index,
+                response,
+            };
+        }
+        catch (error) {
+            throw new XRPLClientError(XRPLClientErrorType.TRANSACTION_FAILED, `Failed to send XRP: ${error instanceof Error ? error.message : String(error)}`, error);
+        }
+    }
+    /**
+     * Sends IOU tokens from one account to another
+     * @param options - The send options
+     * @returns The transaction result
+     * @throws XRPLClientError if transaction fails
+     */
+    async sendIOU(options) {
+        this.ensureConnected();
+        validateAddress(options.destination);
+        validateAddress(options.issuer);
+        validateAmount(options.amount);
+        const payment = {
+            TransactionType: "Payment",
+            Account: options.wallet.address,
+            Destination: options.destination,
+            Amount: {
+                currency: options.currency,
+                issuer: options.issuer,
+                value: options.amount,
+            },
+        };
+        // Add destination tag if provided
+        if (options.destinationTag !== undefined) {
+            payment.DestinationTag = options.destinationTag;
+        }
+        // Add memo if provided
+        if (options.memo) {
+            payment.Memos = createMemo(options.memo);
+        }
+        try {
+            const prepared = await this.client.autofill(payment);
+            const response = await this.client.submitAndWait(prepared, {
+                wallet: options.wallet,
+            });
+            const success = typeof response.result.meta === "object" &&
+                response.result.meta !== null &&
+                "TransactionResult" in response.result.meta &&
+                response.result.meta.TransactionResult === "tesSUCCESS";
+            return {
+                success,
+                hash: response.result.hash,
+                ledgerIndex: response.result.ledger_index,
+                response,
+            };
+        }
+        catch (error) {
+            throw new XRPLClientError(XRPLClientErrorType.TRANSACTION_FAILED, `Failed to send IOU: ${error instanceof Error ? error.message : String(error)}`, error);
+        }
+    }
+    /**
+     * Checks if a trustline exists between an account and an issuer
+     * @param address - The account address to check
+     * @param currency - The currency code
+     * @param issuer - The token issuer address
+     * @returns Trustline information including whether it exists
+     */
+    async checkTrustline(address, currency, issuer) {
+        this.ensureConnected();
+        validateAddress(address);
+        validateAddress(issuer);
+        try {
+            const response = await this.client.request({
+                command: "account_lines",
+                account: address,
+                peer: issuer,
+                ledger_index: "validated",
+            });
+            const trustline = response.result.lines.find((line) => line.currency === currency);
+            if (!trustline) {
+                return {
+                    exists: false,
+                    currency,
+                    issuer,
+                    balance: "0",
+                    limit: "0",
+                    limitPeer: "0",
+                    qualityIn: 0,
+                    qualityOut: 0,
+                };
+            }
+            return {
+                exists: true,
+                currency: trustline.currency,
+                issuer,
+                balance: trustline.balance,
+                limit: trustline.limit,
+                limitPeer: trustline.limit_peer,
+                qualityIn: trustline.quality_in ?? 0,
+                qualityOut: trustline.quality_out ?? 0,
+                authorized: trustline.authorized,
+                peerAuthorized: trustline.peer_authorized,
+                noRipple: trustline.no_ripple,
+                noRipplePeer: trustline.no_ripple_peer,
+                freeze: trustline.freeze,
+                freezePeer: trustline.freeze_peer,
+            };
+        }
+        catch (error) {
+            if (error instanceof Error &&
+                error.message.includes("actNotFound")) {
+                throw new XRPLClientError(XRPLClientErrorType.ACCOUNT_NOT_FOUND, `Account not found: ${address}`, error);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Gets all trustlines for an account
+     * @param address - The account address to query
+     * @returns Array of trustline information
+     */
+    async getAllTrustlines(address) {
+        this.ensureConnected();
+        validateAddress(address);
+        try {
+            const response = await this.client.request({
+                command: "account_lines",
+                account: address,
+                ledger_index: "validated",
+            });
+            return response.result.lines.map((line) => ({
+                exists: true,
+                currency: line.currency,
+                issuer: line.account,
+                balance: line.balance,
+                limit: line.limit,
+                limitPeer: line.limit_peer,
+                qualityIn: line.quality_in ?? 0,
+                qualityOut: line.quality_out ?? 0,
+                authorized: line.authorized,
+                peerAuthorized: line.peer_authorized,
+                noRipple: line.no_ripple,
+                noRipplePeer: line.no_ripple_peer,
+                freeze: line.freeze,
+                freezePeer: line.freeze_peer,
+            }));
+        }
+        catch (error) {
+            if (error instanceof Error &&
+                error.message.includes("actNotFound")) {
+                throw new XRPLClientError(XRPLClientErrorType.ACCOUNT_NOT_FOUND, `Account not found: ${address}`, error);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Funds a wallet on testnet/devnet using the faucet
+     * Only works on test networks
+     * @param wallet - Optional wallet to fund (creates new one if not provided)
+     * @returns The funded wallet
+     */
+    async fundWallet(wallet) {
+        this.ensureConnected();
+        const result = await this.client.fundWallet(wallet);
+        return result.wallet;
+    }
+}
+//# sourceMappingURL=XRPLClient.js.map

package/dist/client/XRPLClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"XRPLClient.js","sourceRoot":"","sources":["../../src/client/XRPLClient.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { XRPLClient } from "./client/XRPLClient.js";
+export type { NetworkConfig, TrustlineInfo, XRPBalanceResult, IOUBalanceResult, SendXRPOptions, SendIOUOptions, TransactionResult, } from "./types/index.js";
+export { NETWORKS, type NetworkType, XRPLClientError, XRPLClientErrorType, } from "./types/index.js";
+export { validateAddress, isValidAddress, convertXRPToDrops, convertDropsToXRP, validateAmount, formatCurrencyCode, encodeCurrencyCode, createMemo, decodeMemo, } from "./utils/index.js";
+export type { Wallet, TxResponse } from "xrpl";
+export { Wallet as WalletClass } from "xrpl";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGpD,YAAY,EACV,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,QAAQ,EACR,KAAK,WAAW,EAChB,eAAe,EACf,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,UAAU,EACV,UAAU,GACX,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAC/C,OAAO,EAAE,MAAM,IAAI,WAAW,EAAE,MAAM,MAAM,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+// Main client export
+export { XRPLClient } from "./client/XRPLClient.js";
+export { NETWORKS, XRPLClientError, XRPLClientErrorType, } from "./types/index.js";
+// Utility exports
+export { validateAddress, isValidAddress, convertXRPToDrops, convertDropsToXRP, validateAmount, formatCurrencyCode, encodeCurrencyCode, createMemo, decodeMemo, } from "./utils/index.js";
+export { Wallet as WalletClass } from "xrpl";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAapD,OAAO,EACL,QAAQ,EAER,eAAe,EACf,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAE1B,kBAAkB;AAClB,OAAO,EACL,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,UAAU,EACV,UAAU,GACX,MAAM,kBAAkB,CAAC;AAI1B,OAAO,EAAE,MAAM,IAAI,WAAW,EAAE,MAAM,MAAM,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,146 @@
+import type { TxResponse, Wallet } from "xrpl";
+/**
+ * Network configuration options
+ */
+export interface NetworkConfig {
+    /** WebSocket URL for the XRPL node */
+    url: string;
+    /** Optional connection timeout in milliseconds */
+    connectionTimeout?: number;
+}
+/**
+ * Predefined network URLs
+ */
+export declare const NETWORKS: {
+    readonly MAINNET: "wss://xrplcluster.com/";
+    readonly MAINNET_RIPPLE: "wss://s1.ripple.com/";
+    readonly TESTNET: "wss://s.altnet.rippletest.net:51233/";
+    readonly DEVNET: "wss://s.devnet.rippletest.net:51233/";
+};
+export type NetworkType = keyof typeof NETWORKS;
+/**
+ * Information about an IOU trustline
+ */
+export interface TrustlineInfo {
+    /** Whether the trustline exists */
+    exists: boolean;
+    /** The currency code */
+    currency: string;
+    /** The issuer address */
+    issuer: string;
+    /** Current balance of the trustline */
+    balance: string;
+    /** Maximum amount the account trusts the issuer for */
+    limit: string;
+    /** Maximum amount the issuer trusts the account for */
+    limitPeer: string;
+    /** Quality in (exchange rate) */
+    qualityIn: number;
+    /** Quality out (exchange rate) */
+    qualityOut: number;
+    /** Whether the account has authorized the trustline */
+    authorized?: boolean | undefined;
+    /** Whether the peer has authorized the trustline */
+    peerAuthorized?: boolean | undefined;
+    /** Whether the trustline has the no-ripple flag */
+    noRipple?: boolean | undefined;
+    /** Whether the peer has the no-ripple flag */
+    noRipplePeer?: boolean | undefined;
+    /** Whether the trustline is frozen */
+    freeze?: boolean | undefined;
+    /** Whether the peer has frozen the trustline */
+    freezePeer?: boolean | undefined;
+}
+/**
+ * Result of an XRP balance query
+ */
+export interface XRPBalanceResult {
+    /** The account address */
+    address: string;
+    /** Balance in XRP (not drops) */
+    balance: string;
+    /** Balance in drops */
+    balanceDrops: string;
+}
+/**
+ * Result of an IOU balance query
+ */
+export interface IOUBalanceResult {
+    /** The account address */
+    address: string;
+    /** The currency code */
+    currency: string;
+    /** The issuer address */
+    issuer: string;
+    /** Balance amount */
+    balance: string;
+}
+/**
+ * Options for sending XRP
+ */
+export interface SendXRPOptions {
+    /** The wallet to send from */
+    wallet: Wallet;
+    /** Destination address */
+    destination: string;
+    /** Amount in XRP (not drops) */
+    amount: string;
+    /** Optional destination tag */
+    destinationTag?: number;
+    /** Optional memo */
+    memo?: string;
+}
+/**
+ * Options for sending IOU tokens
+ */
+export interface SendIOUOptions {
+    /** The wallet to send from */
+    wallet: Wallet;
+    /** Destination address */
+    destination: string;
+    /** Currency code */
+    currency: string;
+    /** Issuer address */
+    issuer: string;
+    /** Amount to send */
+    amount: string;
+    /** Optional destination tag */
+    destinationTag?: number;
+    /** Optional memo */
+    memo?: string;
+}
+/**
+ * Result of a transaction submission
+ */
+export interface TransactionResult {
+    /** Whether the transaction was successful */
+    success: boolean;
+    /** Transaction hash */
+    hash: string;
+    /** Ledger index the transaction was validated in */
+    ledgerIndex?: number | undefined;
+    /** Full transaction response from xrpl.js */
+    response: TxResponse;
+}
+/**
+ * Error types for the XRPL client
+ */
+export declare enum XRPLClientErrorType {
+    CONNECTION_ERROR = "CONNECTION_ERROR",
+    NOT_CONNECTED = "NOT_CONNECTED",
+    ACCOUNT_NOT_FOUND = "ACCOUNT_NOT_FOUND",
+    TRUSTLINE_NOT_FOUND = "TRUSTLINE_NOT_FOUND",
+    INSUFFICIENT_BALANCE = "INSUFFICIENT_BALANCE",
+    TRANSACTION_FAILED = "TRANSACTION_FAILED",
+    INVALID_ADDRESS = "INVALID_ADDRESS",
+    INVALID_AMOUNT = "INVALID_AMOUNT"
+}
+/**
+ * Custom error class for XRPL client errors
+ */
+export declare class XRPLClientError extends Error {
+    readonly type: XRPLClientErrorType;
+    readonly details?: unknown;
+    constructor(type: XRPLClientErrorType, message: string, details?: unknown);
+}
+//# sourceMappingURL=index.d.ts.map