@waiaas/actions 2.13.0 → 2.14.0-rc.4

package/dist/providers/xrpl-dex/orderbook-client.js

@@ -0,0 +1,220 @@
+/**
+ * XrplOrderbookClient -- XRPL RPC wrapper for orderbook and account queries.
+ *
+ * Provides:
+ * - getOrderbook: book_offers for asks + bids with normalized prices
+ * - getAccountOffers: account_offers for active orders
+ * - checkTrustLine: account_lines for trust line existence
+ * - getAccountReserve: account_info for reserve calculation
+ *
+ * Uses lazy connection (ensureConnected) and explicit disconnect.
+ *
+ * @see Phase 02-01 Task 3
+ */
+import { Client } from 'xrpl';
+// ---------------------------------------------------------------------------
+// Client
+// ---------------------------------------------------------------------------
+export class XrplOrderbookClient {
+    rpcUrl;
+    client = null;
+    connectingPromise = null;
+    constructor(rpcUrl) {
+        this.rpcUrl = rpcUrl;
+    }
+    /**
+     * Ensure WebSocket connection is established (lazy connect).
+     */
+    async ensureConnected() {
+        if (this.client?.isConnected())
+            return;
+        // Prevent concurrent connect attempts
+        if (this.connectingPromise) {
+            await this.connectingPromise;
+            return;
+        }
+        this.connectingPromise = (async () => {
+            try {
+                this.client = new Client(this.rpcUrl, { connectionTimeout: 10000 });
+                await this.client.connect();
+            }
+            finally {
+                this.connectingPromise = null;
+            }
+        })();
+        await this.connectingPromise;
+    }
+    /**
+     * Close WebSocket connection.
+     */
+    async disconnect() {
+        if (this.client) {
+            try {
+                await this.client.disconnect();
+            }
+            catch {
+                // ignore disconnect errors
+            }
+            this.client = null;
+        }
+    }
+    /**
+     * Get the underlying xrpl.Client (for testing/direct access).
+     */
+    getClient() {
+        if (!this.client) {
+            throw new Error('XrplOrderbookClient: not connected. Call ensureConnected() first.');
+        }
+        return this.client;
+    }
+    // -------------------------------------------------------------------------
+    // Orderbook queries
+    // -------------------------------------------------------------------------
+    /**
+     * Query orderbook for a trading pair (both ask and bid sides).
+     */
+    async getOrderbook(base, counter, limit) {
+        await this.ensureConnected();
+        const client = this.getClient();
+        // Asks: offers selling base for counter (taker perspective: taker_gets=base, taker_pays=counter)
+        const asksResponse = await client.request({
+            command: 'book_offers',
+            taker_gets: base,
+            taker_pays: counter,
+            limit,
+        });
+        // Bids: offers buying base with counter (taker perspective: taker_gets=counter, taker_pays=base)
+        const bidsResponse = await client.request({
+            command: 'book_offers',
+            taker_gets: counter,
+            taker_pays: base,
+            limit,
+        });
+        const asks = (asksResponse.result.offers || []).map((offer) => {
+            const getsValue = parseAmountValue(offer.TakerGets);
+            const paysValue = parseAmountValue(offer.TakerPays);
+            const price = paysValue / getsValue; // counter per base
+            return {
+                price,
+                amount: getsValue,
+                total: paysValue,
+                ownerFunds: String(offer.owner_funds ?? '0'),
+                sequence: offer.Sequence ?? 0,
+            };
+        });
+        const bids = (bidsResponse.result.offers || []).map((offer) => {
+            const getsValue = parseAmountValue(offer.TakerGets); // counter
+            const paysValue = parseAmountValue(offer.TakerPays); // base
+            const price = getsValue / paysValue; // counter per base
+            return {
+                price,
+                amount: paysValue,
+                total: getsValue,
+                ownerFunds: String(offer.owner_funds ?? '0'),
+                sequence: offer.Sequence ?? 0,
+            };
+        });
+        // Calculate spread
+        const bestAsk = asks.length > 0 ? asks[0].price : NaN;
+        const bestBid = bids.length > 0 ? bids[0].price : NaN;
+        const spread = !isNaN(bestAsk) && !isNaN(bestBid) ? bestAsk - bestBid : NaN;
+        return { asks, bids, spread };
+    }
+    /**
+     * Query account's active offers.
+     */
+    async getAccountOffers(account, limit) {
+        await this.ensureConnected();
+        const client = this.getClient();
+        const response = await client.request({
+            command: 'account_offers',
+            account,
+            limit,
+        });
+        return (response.result.offers || []).map((offer) => ({
+            seq: offer.seq,
+            takerGets: formatAmountDisplay(offer.taker_gets),
+            takerPays: formatAmountDisplay(offer.taker_pays),
+            flags: offer.flags ?? 0,
+            expiration: offer.expiration,
+        }));
+    }
+    // -------------------------------------------------------------------------
+    // Trust line and reserve queries
+    // -------------------------------------------------------------------------
+    /**
+     * Check if a trust line exists for a specific currency/issuer pair.
+     */
+    async checkTrustLine(account, currency, issuer) {
+        await this.ensureConnected();
+        const client = this.getClient();
+        try {
+            const response = await client.request({
+                command: 'account_lines',
+                account,
+                peer: issuer,
+            });
+            const lines = response.result.lines || [];
+            return lines.some((line) => line.currency?.toUpperCase() === currency.toUpperCase());
+        }
+        catch {
+            // If account doesn't exist yet, no trust lines
+            return false;
+        }
+    }
+    /**
+     * Get account reserve information.
+     */
+    async getAccountReserve(account) {
+        await this.ensureConnected();
+        const client = this.getClient();
+        const accountInfo = await client.request({
+            command: 'account_info',
+            account,
+            ledger_index: 'validated',
+        });
+        const accountData = accountInfo.result.account_data;
+        const balance = accountData.Balance;
+        const ownerCount = (accountData.OwnerCount ?? 0);
+        // Default reserves (per amendment status as of 2024)
+        const baseReserve = 1_000_000; // 1 XRP (previously 10, reduced by amendment)
+        const ownerReserve = 200_000; // 0.2 XRP
+        const totalReserve = BigInt(baseReserve) + BigInt(ownerCount) * BigInt(ownerReserve);
+        const available = BigInt(balance) - totalReserve;
+        const availableBalance = available > 0n ? available.toString() : '0';
+        return {
+            balance,
+            ownerCount,
+            baseReserve,
+            ownerReserve,
+            availableBalance,
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Parse XRPL Amount to numeric value.
+ * XRP: drops string -> drops / 1000000
+ * IOU: { value: "100.5" } -> 100.5
+ */
+function parseAmountValue(amount) {
+    if (typeof amount === 'string') {
+        // XRP drops
+        return Number(amount) / 1_000_000;
+    }
+    return parseFloat(amount.value);
+}
+/**
+ * Format XRPL Amount for display.
+ * XRP: drops string -> "1000000 drops"
+ * IOU: { currency, issuer, value } -> "100.5 USD"
+ */
+function formatAmountDisplay(amount) {
+    if (typeof amount === 'string') {
+        return `${amount} drops`;
+    }
+    return `${amount.value} ${amount.currency}`;
+}
+//# sourceMappingURL=orderbook-client.js.map

package/dist/providers/xrpl-dex/orderbook-client.js.map

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

package/dist/providers/xrpl-dex/schemas.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Zod input schemas for XRPL DEX Provider actions.
+ *
+ * Token format: "XRP" for native, "{CURRENCY}.{ISSUER}" for IOU
+ * (matches parseTrustLineToken convention from @waiaas/adapter-ripple).
+ *
+ * @see Phase 02-01 Task 1
+ */
+import { z } from 'zod';
+export declare const SwapInputSchema: z.ZodObject<{
+    /** Token the agent offers (gives away). "XRP" or "CURRENCY.ISSUER". */
+    takerGets: z.ZodString;
+    /** Amount of takerGets in display units. XRP in drops, IOU in decimal string. */
+    takerGetsAmount: z.ZodString;
+    /** Token the agent wants to receive. "XRP" or "CURRENCY.ISSUER". */
+    takerPays: z.ZodString;
+    /** Amount of takerPays in display units. */
+    takerPaysAmount: z.ZodString;
+    /** Slippage tolerance in basis points (default 50 = 0.5%). */
+    slippageBps: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    slippageBps: number;
+    takerGets: string;
+    takerGetsAmount: string;
+    takerPays: string;
+    takerPaysAmount: string;
+}, {
+    takerGets: string;
+    takerGetsAmount: string;
+    takerPays: string;
+    takerPaysAmount: string;
+    slippageBps?: number | undefined;
+}>;
+export type SwapInput = z.infer<typeof SwapInputSchema>;
+export declare const LimitOrderInputSchema: z.ZodObject<{
+    /** Token the agent offers (gives away). */
+    takerGets: z.ZodString;
+    /** Amount of takerGets in display units. */
+    takerGetsAmount: z.ZodString;
+    /** Token the agent wants to receive. */
+    takerPays: z.ZodString;
+    /** Amount of takerPays in display units. */
+    takerPaysAmount: z.ZodString;
+    /** Order expiration in seconds from now (default 86400 = 24h). */
+    expirationSeconds: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    takerGets: string;
+    takerGetsAmount: string;
+    takerPays: string;
+    takerPaysAmount: string;
+    expirationSeconds: number;
+}, {
+    takerGets: string;
+    takerGetsAmount: string;
+    takerPays: string;
+    takerPaysAmount: string;
+    expirationSeconds?: number | undefined;
+}>;
+export type LimitOrderInput = z.infer<typeof LimitOrderInputSchema>;
+export declare const CancelOrderInputSchema: z.ZodObject<{
+    /** The Sequence number of the offer to cancel (from get_offers result). */
+    offerSequence: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    offerSequence: number;
+}, {
+    offerSequence: number;
+}>;
+export type CancelOrderInput = z.infer<typeof CancelOrderInputSchema>;
+export declare const GetOrderbookInputSchema: z.ZodObject<{
+    /** Base token (e.g., "XRP"). */
+    base: z.ZodString;
+    /** Counter token (e.g., "USD.rIssuer..."). */
+    counter: z.ZodString;
+    /** Max offers per side (default 20). */
+    limit: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    base: string;
+    counter: string;
+    limit: number;
+}, {
+    base: string;
+    counter: string;
+    limit?: number | undefined;
+}>;
+export type GetOrderbookInput = z.infer<typeof GetOrderbookInputSchema>;
+export declare const GetOffersInputSchema: z.ZodObject<{
+    /** Max offers to return (default 50). */
+    limit: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+}, {
+    limit?: number | undefined;
+}>;
+export type GetOffersInput = z.infer<typeof GetOffersInputSchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/providers/xrpl-dex/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/providers/xrpl-dex/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgBxB,eAAO,MAAM,eAAe;IAC1B,uEAAuE;;IAEvE,iFAAiF;;IAEjF,oEAAoE;;IAEpE,4CAA4C;;IAE5C,8DAA8D;;;;;;;;;;;;;;EAE9D,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAMxD,eAAO,MAAM,qBAAqB;IAChC,2CAA2C;;IAE3C,4CAA4C;;IAE5C,wCAAwC;;IAExC,4CAA4C;;IAE5C,kEAAkE;;;;;;;;;;;;;;EAElE,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAMpE,eAAO,MAAM,sBAAsB;IACjC,2EAA2E;;;;;;EAE3E,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAMtE,eAAO,MAAM,uBAAuB;IAClC,gCAAgC;;IAEhC,8CAA8C;;IAE9C,wCAAwC;;;;;;;;;;EAExC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAMxE,eAAO,MAAM,oBAAoB;IAC/B,yCAAyC;;;;;;EAEzC,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/providers/xrpl-dex/schemas.js

@@ -0,0 +1,73 @@
+/**
+ * Zod input schemas for XRPL DEX Provider actions.
+ *
+ * Token format: "XRP" for native, "{CURRENCY}.{ISSUER}" for IOU
+ * (matches parseTrustLineToken convention from @waiaas/adapter-ripple).
+ *
+ * @see Phase 02-01 Task 1
+ */
+import { z } from 'zod';
+// ---------------------------------------------------------------------------
+// Shared token string pattern
+// ---------------------------------------------------------------------------
+/**
+ * Token identifier: "XRP" for native, or "CURRENCY.rISSUER" (dot-separated) for IOU.
+ * Examples: "XRP", "USD.rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe"
+ */
+const tokenString = z.string().min(1, 'Token identifier is required');
+// ---------------------------------------------------------------------------
+// SwapInputSchema -- Immediate or Cancel swap
+// ---------------------------------------------------------------------------
+export const SwapInputSchema = z.object({
+    /** Token the agent offers (gives away). "XRP" or "CURRENCY.ISSUER". */
+    takerGets: tokenString.describe('Token to sell (e.g., "XRP" or "USD.rIssuer...")'),
+    /** Amount of takerGets in display units. XRP in drops, IOU in decimal string. */
+    takerGetsAmount: z.string().min(1, 'takerGetsAmount is required'),
+    /** Token the agent wants to receive. "XRP" or "CURRENCY.ISSUER". */
+    takerPays: tokenString.describe('Token to buy (e.g., "USD.rIssuer..." or "XRP")'),
+    /** Amount of takerPays in display units. */
+    takerPaysAmount: z.string().min(1, 'takerPaysAmount is required'),
+    /** Slippage tolerance in basis points (default 50 = 0.5%). */
+    slippageBps: z.number().int().min(1).max(500).default(50),
+});
+// ---------------------------------------------------------------------------
+// LimitOrderInputSchema -- Passive order on the orderbook
+// ---------------------------------------------------------------------------
+export const LimitOrderInputSchema = z.object({
+    /** Token the agent offers (gives away). */
+    takerGets: tokenString.describe('Token to sell'),
+    /** Amount of takerGets in display units. */
+    takerGetsAmount: z.string().min(1, 'takerGetsAmount is required'),
+    /** Token the agent wants to receive. */
+    takerPays: tokenString.describe('Token to buy'),
+    /** Amount of takerPays in display units. */
+    takerPaysAmount: z.string().min(1, 'takerPaysAmount is required'),
+    /** Order expiration in seconds from now (default 86400 = 24h). */
+    expirationSeconds: z.number().int().min(60).max(2592000).default(86400),
+});
+// ---------------------------------------------------------------------------
+// CancelOrderInputSchema -- Cancel an existing offer
+// ---------------------------------------------------------------------------
+export const CancelOrderInputSchema = z.object({
+    /** The Sequence number of the offer to cancel (from get_offers result). */
+    offerSequence: z.number().int().positive(),
+});
+// ---------------------------------------------------------------------------
+// GetOrderbookInputSchema -- Query orderbook depth
+// ---------------------------------------------------------------------------
+export const GetOrderbookInputSchema = z.object({
+    /** Base token (e.g., "XRP"). */
+    base: tokenString.describe('Base token for the trading pair'),
+    /** Counter token (e.g., "USD.rIssuer..."). */
+    counter: tokenString.describe('Counter/quote token for the trading pair'),
+    /** Max offers per side (default 20). */
+    limit: z.number().int().min(1).max(400).default(20),
+});
+// ---------------------------------------------------------------------------
+// GetOffersInputSchema -- Query account's active offers
+// ---------------------------------------------------------------------------
+export const GetOffersInputSchema = z.object({
+    /** Max offers to return (default 50). */
+    limit: z.number().int().min(1).max(400).default(50),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/providers/xrpl-dex/schemas.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@waiaas/actions",
-  "version": "2.13.0",
+  "version": "2.14.0-rc.4",
   "description": "WAIaaS built-in DeFi Action Provider implementations",
   "license": "MIT",
   "type": "module",
@@ -31,12 +31,13 @@
     "@msgpack/msgpack": "^3.1.3",
     "viem": "^2.21.0",
     "zod": "^3.24.0",
-    "@waiaas/core": "2.13.0"
+    "@waiaas/core": "2.14.0-rc.4"
   },
   "optionalDependencies": {
     "@kamino-finance/klend-sdk": "^3.2.26",
     "@drift-labs/sdk": "^2.106.0",
-    "@solana/web3.js": "^1.98.0"
+    "@solana/web3.js": "^1.98.0",
+    "xrpl": "^4.6.0"
   },
   "devDependencies": {
     "@types/node": "^25.2.3",