@waiaas/actions 2.13.0 → 2.14.0

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

@@ -0,0 +1,39 @@
+import type { IActionProvider, ActionProviderMetadata, ActionDefinition, ActionContext, ContractCallRequest, ApiDirectResult } from '@waiaas/core';
+import type { XrplOrderbookClient } from './orderbook-client.js';
+export declare class XrplDexProvider implements IActionProvider {
+    private readonly orderbookClient;
+    readonly metadata: ActionProviderMetadata;
+    readonly actions: readonly ActionDefinition[];
+    constructor(orderbookClient: XrplOrderbookClient);
+    resolve(actionName: string, params: Record<string, unknown>, context: ActionContext): Promise<ContractCallRequest | ContractCallRequest[] | ApiDirectResult>;
+    /**
+     * Immediate swap with tfImmediateOrCancel.
+     * If TakerPays is an IOU and no trust line exists, returns 2-step
+     * [TrustSet, OfferCreate] array for automatic trust line setup (DEX-07).
+     */
+    private resolveSwap;
+    /**
+     * Limit order -- passive order on the orderbook.
+     * Validates reserve before placing (DEX-08).
+     * Checks trust line for IOU TakerPays (DEX-07).
+     */
+    private resolveLimitOrder;
+    /**
+     * Cancel an existing offer by OfferSequence.
+     */
+    private resolveCancelOrder;
+    /**
+     * Query orderbook depth for a trading pair.
+     */
+    private resolveGetOrderbook;
+    /**
+     * List active offers for the wallet account.
+     */
+    private resolveGetOffers;
+    /**
+     * If token is IOU and trust line doesn't exist, build a TrustSet
+     * ContractCallRequest to be prepended as the first step.
+     */
+    private maybeBuildTrustSet;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/xrpl-dex/index.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EACV,eAAe,EACf,sBAAsB,EACtB,gBAAgB,EAChB,aAAa,EACb,mBAAmB,EACnB,eAAe,EAChB,MAAM,cAAc,CAAC;AAgBtB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAMjE,qBAAa,eAAgB,YAAW,eAAe;IAIzC,OAAO,CAAC,QAAQ,CAAC,eAAe;IAH5C,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;gBAEjB,eAAe,EAAE,mBAAmB;IAyD3D,OAAO,CACX,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,mBAAmB,GAAG,mBAAmB,EAAE,GAAG,eAAe,CAAC;IAuBzE;;;;OAIG;YACW,WAAW;IA4BzB;;;;OAIG;YACW,iBAAiB;IAkC/B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAmB1B;;OAEG;YACW,mBAAmB;IAyBjC;;OAEG;YACW,gBAAgB;IA0B9B;;;OAGG;YACW,kBAAkB;CAuCjC"}

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

@@ -0,0 +1,262 @@
+/**
+ * XRPL DEX Action Provider.
+ *
+ * Implements IActionProvider with 5 actions:
+ * - swap: Immediate-or-Cancel swap (tfImmediateOrCancel)
+ * - limit_order: Passive limit order on the orderbook
+ * - cancel_order: Cancel an existing offer by OfferSequence
+ * - get_orderbook: Query orderbook depth (ApiDirectResult)
+ * - get_offers: Query account's active offers (ApiDirectResult)
+ *
+ * On-chain actions return ContractCallRequest with calldata JSON
+ * containing xrplTxType for RippleAdapter.buildContractCall() routing.
+ *
+ * @see Phase 02-02 Task 1
+ */
+import { ChainError } from '@waiaas/core';
+import { SwapInputSchema, LimitOrderInputSchema, CancelOrderInputSchema, GetOrderbookInputSchema, GetOffersInputSchema, } from './schemas.js';
+import { buildSwapParams, buildLimitOrderParams, buildCancelParams, validateReserve, parseTokenToBookOfferCurrency, } from './offer-builder.js';
+// ---------------------------------------------------------------------------
+// Provider implementation
+// ---------------------------------------------------------------------------
+export class XrplDexProvider {
+    orderbookClient;
+    metadata;
+    actions;
+    constructor(orderbookClient) {
+        this.orderbookClient = orderbookClient;
+        this.metadata = {
+            name: 'xrpl_dex',
+            displayName: 'XRPL DEX',
+            description: 'XRPL native orderbook DEX for token swaps and limit orders',
+            version: '1.0.0',
+            chains: ['ripple'],
+            mcpExpose: true,
+            requiresApiKey: false,
+            requiredApis: [],
+            requiresSigningKey: false,
+        };
+        this.actions = [
+            {
+                name: 'swap',
+                description: 'Immediate swap on XRPL DEX with slippage protection (tfImmediateOrCancel)',
+                chain: 'ripple',
+                inputSchema: SwapInputSchema,
+                riskLevel: 'medium',
+                defaultTier: 'INSTANT',
+            },
+            {
+                name: 'limit_order',
+                description: 'Place a limit order on the XRPL DEX orderbook with expiration',
+                chain: 'ripple',
+                inputSchema: LimitOrderInputSchema,
+                riskLevel: 'medium',
+                defaultTier: 'DELAY',
+            },
+            {
+                name: 'cancel_order',
+                description: 'Cancel an existing XRPL DEX offer by its sequence number',
+                chain: 'ripple',
+                inputSchema: CancelOrderInputSchema,
+                riskLevel: 'low',
+                defaultTier: 'INSTANT',
+            },
+            {
+                name: 'get_orderbook',
+                description: 'Query the XRPL DEX orderbook depth for a trading pair (bids and asks)',
+                chain: 'ripple',
+                inputSchema: GetOrderbookInputSchema,
+                riskLevel: 'low',
+                defaultTier: 'INSTANT',
+            },
+            {
+                name: 'get_offers',
+                description: 'List active XRPL DEX offers for the current wallet account',
+                chain: 'ripple',
+                inputSchema: GetOffersInputSchema,
+                riskLevel: 'low',
+                defaultTier: 'INSTANT',
+            },
+        ];
+    }
+    async resolve(actionName, params, context) {
+        switch (actionName) {
+            case 'swap':
+                return this.resolveSwap(params, context);
+            case 'limit_order':
+                return this.resolveLimitOrder(params, context);
+            case 'cancel_order':
+                return this.resolveCancelOrder(params);
+            case 'get_orderbook':
+                return this.resolveGetOrderbook(params);
+            case 'get_offers':
+                return this.resolveGetOffers(context);
+            default:
+                throw new ChainError('INVALID_INSTRUCTION', 'ripple', {
+                    message: `Unknown XRPL DEX action: ${actionName}`,
+                });
+        }
+    }
+    // -------------------------------------------------------------------------
+    // On-chain actions
+    // -------------------------------------------------------------------------
+    /**
+     * Immediate swap with tfImmediateOrCancel.
+     * If TakerPays is an IOU and no trust line exists, returns 2-step
+     * [TrustSet, OfferCreate] array for automatic trust line setup (DEX-07).
+     */
+    async resolveSwap(params, context) {
+        const input = SwapInputSchema.parse(params);
+        const calldataObj = buildSwapParams(input);
+        // Check trust line for IOU TakerPays (what we receive)
+        const trustSetRequest = await this.maybeBuildTrustSet(input.takerPays, context.walletAddress);
+        const swapRequest = {
+            type: 'CONTRACT_CALL',
+            to: getIssuerAddress(input.takerPays),
+            value: input.takerGets === 'XRP' ? input.takerGetsAmount : undefined,
+            calldata: JSON.stringify(calldataObj),
+            actionProvider: 'xrpl_dex',
+            actionName: 'swap',
+        };
+        if (trustSetRequest) {
+            return [trustSetRequest, swapRequest];
+        }
+        return swapRequest;
+    }
+    /**
+     * Limit order -- passive order on the orderbook.
+     * Validates reserve before placing (DEX-08).
+     * Checks trust line for IOU TakerPays (DEX-07).
+     */
+    async resolveLimitOrder(params, context) {
+        const input = LimitOrderInputSchema.parse(params);
+        // Validate reserve for new offer object
+        const reserve = await this.orderbookClient.getAccountReserve(context.walletAddress);
+        const offers = await this.orderbookClient.getAccountOffers(context.walletAddress, 400);
+        validateReserve(reserve.availableBalance, offers.length);
+        const calldataObj = buildLimitOrderParams(input);
+        // Check trust line for IOU TakerPays
+        const trustSetRequest = await this.maybeBuildTrustSet(input.takerPays, context.walletAddress);
+        const limitRequest = {
+            type: 'CONTRACT_CALL',
+            to: getIssuerAddress(input.takerPays),
+            value: input.takerGets === 'XRP' ? input.takerGetsAmount : undefined,
+            calldata: JSON.stringify(calldataObj),
+            actionProvider: 'xrpl_dex',
+            actionName: 'limit_order',
+        };
+        if (trustSetRequest) {
+            return [trustSetRequest, limitRequest];
+        }
+        return limitRequest;
+    }
+    /**
+     * Cancel an existing offer by OfferSequence.
+     */
+    resolveCancelOrder(params) {
+        const input = CancelOrderInputSchema.parse(params);
+        const calldataObj = buildCancelParams(input.offerSequence);
+        return {
+            type: 'CONTRACT_CALL',
+            to: 'native',
+            calldata: JSON.stringify(calldataObj),
+            actionProvider: 'xrpl_dex',
+            actionName: 'cancel_order',
+        };
+    }
+    // -------------------------------------------------------------------------
+    // Read-only queries (ApiDirectResult -- pipeline bypass)
+    // -------------------------------------------------------------------------
+    /**
+     * Query orderbook depth for a trading pair.
+     */
+    async resolveGetOrderbook(params) {
+        const input = GetOrderbookInputSchema.parse(params);
+        const base = parseTokenToBookOfferCurrency(input.base);
+        const counter = parseTokenToBookOfferCurrency(input.counter);
+        const orderbook = await this.orderbookClient.getOrderbook(base, counter, input.limit);
+        return {
+            __apiDirect: true,
+            externalId: `orderbook-${Date.now()}`,
+            status: 'success',
+            provider: 'xrpl_dex',
+            action: 'get_orderbook',
+            data: {
+                base: input.base,
+                counter: input.counter,
+                bids: orderbook.bids,
+                asks: orderbook.asks,
+                spread: orderbook.spread,
+            },
+        };
+    }
+    /**
+     * List active offers for the wallet account.
+     */
+    async resolveGetOffers(context) {
+        const offers = await this.orderbookClient.getAccountOffers(context.walletAddress, 50);
+        return {
+            __apiDirect: true,
+            externalId: `offers-${Date.now()}`,
+            status: 'success',
+            provider: 'xrpl_dex',
+            action: 'get_offers',
+            data: {
+                account: context.walletAddress,
+                offers,
+                count: offers.length,
+            },
+        };
+    }
+    // -------------------------------------------------------------------------
+    // Trust line auto-setup (DEX-07)
+    // -------------------------------------------------------------------------
+    /**
+     * If token is IOU and trust line doesn't exist, build a TrustSet
+     * ContractCallRequest to be prepended as the first step.
+     */
+    async maybeBuildTrustSet(token, walletAddress) {
+        if (token === 'XRP')
+            return null;
+        const dotIndex = token.indexOf('.');
+        if (dotIndex === -1)
+            return null;
+        const currency = token.slice(0, dotIndex);
+        const issuer = token.slice(dotIndex + 1);
+        const hasTrustLine = await this.orderbookClient.checkTrustLine(walletAddress, currency, issuer);
+        if (hasTrustLine)
+            return null;
+        // Build TrustSet calldata for buildContractCall routing
+        const trustSetCalldata = {
+            xrplTxType: 'TrustSet',
+            LimitAmount: {
+                currency,
+                issuer,
+                value: '1000000000000000', // max trust line limit
+            },
+            Flags: 0x00020000, // tfSetNoRipple
+        };
+        return {
+            type: 'CONTRACT_CALL',
+            to: issuer,
+            calldata: JSON.stringify(trustSetCalldata),
+            actionProvider: 'xrpl_dex',
+            actionName: 'trust_set_auto',
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Extract issuer address from token string for ContractCallRequest.to field.
+ * "XRP" -> "native"
+ * "USD.rIssuer" -> "rIssuer"
+ */
+function getIssuerAddress(token) {
+    if (token === 'XRP')
+        return 'native';
+    const dotIndex = token.indexOf('.');
+    return dotIndex > 0 ? token.slice(dotIndex + 1) : 'native';
+}
+//# sourceMappingURL=index.js.map

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

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

package/dist/providers/xrpl-dex/offer-builder.d.ts

@@ -0,0 +1,67 @@
+import type { SwapInput, LimitOrderInput } from './schemas.js';
+/** Ripple epoch offset: 2000-01-01 00:00:00 UTC in Unix seconds. */
+export declare const RIPPLE_EPOCH = 946684800;
+/** tfImmediateOrCancel flag for instant swaps. */
+export declare const TF_IMMEDIATE_OR_CANCEL = 131072;
+/** Owner reserve per ledger object in drops (0.2 XRP). */
+export declare const OWNER_RESERVE_DROPS = 200000;
+export interface IssuedCurrencyAmount {
+    currency: string;
+    issuer: string;
+    value: string;
+}
+export interface BookOfferCurrency {
+    currency: string;
+    issuer?: string;
+}
+/** XRPL Amount: string (XRP drops) or IssuedCurrencyAmount (IOU). */
+export type XrplAmount = string | IssuedCurrencyAmount;
+/**
+ * Convert a token identifier + amount to XRPL Amount format.
+ *
+ * - "XRP" + amount -> string drops (e.g., "1000000")
+ * - "USD.rIssuer" + amount -> { currency: "USD", issuer: "rIssuer", value: "100" }
+ *
+ * @param token Token identifier ("XRP" or "CURRENCY.ISSUER")
+ * @param amount Amount string (drops for XRP, decimal for IOU)
+ * @throws ChainError if amount is zero/negative or token format invalid
+ */
+export declare function formatXrplAmount(token: string, amount: string): XrplAmount;
+/**
+ * Parse a token string into a BookOfferCurrency for book_offers RPC.
+ * "XRP" -> { currency: "XRP" }
+ * "USD.rIssuer" -> { currency: "USD", issuer: "rIssuer" }
+ */
+export declare function parseTokenToBookOfferCurrency(token: string): BookOfferCurrency;
+/** Calldata JSON for OfferCreate (swap/limit) or OfferCancel. */
+export interface OfferCalldata {
+    xrplTxType: 'OfferCreate' | 'OfferCancel';
+    TakerGets?: XrplAmount;
+    TakerPays?: XrplAmount;
+    Flags?: number;
+    Expiration?: number;
+    OfferSequence?: number;
+}
+/**
+ * Build OfferCreate calldata for an immediate swap (tfImmediateOrCancel).
+ * Slippage is applied to TakerPays (reduce minimum receive).
+ */
+export declare function buildSwapParams(input: SwapInput): OfferCalldata;
+/**
+ * Build OfferCreate calldata for a limit order (no IoC).
+ * Expiration is converted to Ripple epoch.
+ */
+export declare function buildLimitOrderParams(input: LimitOrderInput): OfferCalldata;
+/**
+ * Build OfferCancel calldata.
+ */
+export declare function buildCancelParams(offerSequence: number): OfferCalldata;
+/**
+ * Validate that the account has sufficient XRP for a new offer's owner reserve.
+ *
+ * @param availableXrpDrops Available XRP balance in drops (after existing reserves)
+ * @param existingOfferCount Number of existing offers (for context in error message)
+ * @throws ChainError if available balance < OWNER_RESERVE_DROPS
+ */
+export declare function validateReserve(availableXrpDrops: string, existingOfferCount: number): void;
+//# sourceMappingURL=offer-builder.d.ts.map

package/dist/providers/xrpl-dex/offer-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offer-builder.d.ts","sourceRoot":"","sources":["../../../src/providers/xrpl-dex/offer-builder.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAM/D,oEAAoE;AACpE,eAAO,MAAM,YAAY,YAAY,CAAC;AAEtC,kDAAkD;AAClD,eAAO,MAAM,sBAAsB,SAAa,CAAC;AAEjD,0DAA0D;AAC1D,eAAO,MAAM,mBAAmB,SAAS,CAAC;AAM1C,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qEAAqE;AACrE,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,oBAAoB,CAAC;AAMvD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CA8B1E;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,CAgB9E;AA6BD,iEAAiE;AACjE,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,aAAa,GAAG,aAAa,CAAC;IAC1C,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,aAAa,CAc/D;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,eAAe,GAAG,aAAa,CAa3E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,aAAa,CAKtE;AAMD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,iBAAiB,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAW3F"}

package/dist/providers/xrpl-dex/offer-builder.js

@@ -0,0 +1,166 @@
+/**
+ * XRPL DEX OfferBuilder -- builds OfferCreate/OfferCancel calldata JSON
+ * for the RippleAdapter.buildContractCall() pipeline.
+ *
+ * Handles:
+ * - Currency amount conversion (XRP drops vs IOU object)
+ * - Slippage application for IoC swaps
+ * - Ripple epoch expiration for limit orders
+ * - Owner reserve validation for new offers
+ *
+ * @see Phase 02-01 Task 2
+ */
+import { ChainError } from '@waiaas/core';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Ripple epoch offset: 2000-01-01 00:00:00 UTC in Unix seconds. */
+export const RIPPLE_EPOCH = 946684800;
+/** tfImmediateOrCancel flag for instant swaps. */
+export const TF_IMMEDIATE_OR_CANCEL = 0x00020000;
+/** Owner reserve per ledger object in drops (0.2 XRP). */
+export const OWNER_RESERVE_DROPS = 200000;
+// ---------------------------------------------------------------------------
+// Amount formatting
+// ---------------------------------------------------------------------------
+/**
+ * Convert a token identifier + amount to XRPL Amount format.
+ *
+ * - "XRP" + amount -> string drops (e.g., "1000000")
+ * - "USD.rIssuer" + amount -> { currency: "USD", issuer: "rIssuer", value: "100" }
+ *
+ * @param token Token identifier ("XRP" or "CURRENCY.ISSUER")
+ * @param amount Amount string (drops for XRP, decimal for IOU)
+ * @throws ChainError if amount is zero/negative or token format invalid
+ */
+export function formatXrplAmount(token, amount) {
+    // Validate amount is not zero or negative
+    const numericAmount = Number(amount);
+    if (isNaN(numericAmount) || numericAmount <= 0) {
+        throw new ChainError('INVALID_INSTRUCTION', 'ripple', {
+            message: `Invalid amount: ${amount}. Must be a positive number.`,
+        });
+    }
+    if (token === 'XRP') {
+        // XRP native: amount is already in drops (string)
+        return amount;
+    }
+    // IOU: parse "CURRENCY.ISSUER" format
+    const dotIndex = token.indexOf('.');
+    if (dotIndex === -1 || dotIndex === 0 || dotIndex === token.length - 1) {
+        throw new ChainError('INVALID_INSTRUCTION', 'ripple', {
+            message: `Invalid IOU token format: "${token}". Expected "CURRENCY.ISSUER" (e.g., "USD.rIssuer...").`,
+        });
+    }
+    const currency = token.slice(0, dotIndex);
+    const issuer = token.slice(dotIndex + 1);
+    return {
+        currency,
+        issuer,
+        value: amount,
+    };
+}
+/**
+ * Parse a token string into a BookOfferCurrency for book_offers RPC.
+ * "XRP" -> { currency: "XRP" }
+ * "USD.rIssuer" -> { currency: "USD", issuer: "rIssuer" }
+ */
+export function parseTokenToBookOfferCurrency(token) {
+    if (token === 'XRP') {
+        return { currency: 'XRP' };
+    }
+    const dotIndex = token.indexOf('.');
+    if (dotIndex === -1 || dotIndex === 0 || dotIndex === token.length - 1) {
+        throw new ChainError('INVALID_INSTRUCTION', 'ripple', {
+            message: `Invalid IOU token format: "${token}". Expected "CURRENCY.ISSUER".`,
+        });
+    }
+    return {
+        currency: token.slice(0, dotIndex),
+        issuer: token.slice(dotIndex + 1),
+    };
+}
+// ---------------------------------------------------------------------------
+// Slippage helpers
+// ---------------------------------------------------------------------------
+/**
+ * Apply slippage to an amount (reduce by slippageBps).
+ * For IoC swaps, slippage reduces TakerPays (minimum receive).
+ */
+function applySlippage(amount, slippageBps, isIou) {
+    if (isIou) {
+        // IOU: decimal arithmetic
+        const value = parseFloat(amount);
+        const adjusted = value * (1 - slippageBps / 10000);
+        // Preserve precision (max 15 significant digits for XRPL IOU)
+        return adjusted.toPrecision(15).replace(/0+$/, '').replace(/\.$/, '');
+    }
+    // XRP drops: integer arithmetic
+    const drops = BigInt(amount);
+    const adjusted = drops - (drops * BigInt(slippageBps)) / 10000n;
+    return adjusted.toString();
+}
+/**
+ * Build OfferCreate calldata for an immediate swap (tfImmediateOrCancel).
+ * Slippage is applied to TakerPays (reduce minimum receive).
+ */
+export function buildSwapParams(input) {
+    const takerGets = formatXrplAmount(input.takerGets, input.takerGetsAmount);
+    const isPayIou = input.takerPays !== 'XRP';
+    // Apply slippage to TakerPays (what we want = minimum acceptable)
+    const adjustedPayAmount = applySlippage(input.takerPaysAmount, input.slippageBps, isPayIou);
+    const takerPays = formatXrplAmount(input.takerPays, adjustedPayAmount);
+    return {
+        xrplTxType: 'OfferCreate',
+        TakerGets: takerGets,
+        TakerPays: takerPays,
+        Flags: TF_IMMEDIATE_OR_CANCEL,
+    };
+}
+/**
+ * Build OfferCreate calldata for a limit order (no IoC).
+ * Expiration is converted to Ripple epoch.
+ */
+export function buildLimitOrderParams(input) {
+    const takerGets = formatXrplAmount(input.takerGets, input.takerGetsAmount);
+    const takerPays = formatXrplAmount(input.takerPays, input.takerPaysAmount);
+    // Convert expiration to Ripple epoch (current time + seconds - RIPPLE_EPOCH offset)
+    const expirationRipple = Math.floor(Date.now() / 1000) + input.expirationSeconds - RIPPLE_EPOCH;
+    return {
+        xrplTxType: 'OfferCreate',
+        TakerGets: takerGets,
+        TakerPays: takerPays,
+        Expiration: expirationRipple,
+    };
+}
+/**
+ * Build OfferCancel calldata.
+ */
+export function buildCancelParams(offerSequence) {
+    return {
+        xrplTxType: 'OfferCancel',
+        OfferSequence: offerSequence,
+    };
+}
+// ---------------------------------------------------------------------------
+// Reserve validation
+// ---------------------------------------------------------------------------
+/**
+ * Validate that the account has sufficient XRP for a new offer's owner reserve.
+ *
+ * @param availableXrpDrops Available XRP balance in drops (after existing reserves)
+ * @param existingOfferCount Number of existing offers (for context in error message)
+ * @throws ChainError if available balance < OWNER_RESERVE_DROPS
+ */
+export function validateReserve(availableXrpDrops, existingOfferCount) {
+    const available = BigInt(availableXrpDrops);
+    const required = BigInt(OWNER_RESERVE_DROPS);
+    if (available < required) {
+        const availableXrp = Number(available) / 1_000_000;
+        const requiredXrp = Number(required) / 1_000_000;
+        throw new ChainError('INSUFFICIENT_BALANCE', 'ripple', {
+            message: `Insufficient XRP for new offer: need ${requiredXrp} XRP reserve (available: ${availableXrp} XRP, current offers: ${existingOfferCount}). Each open offer requires ${requiredXrp} XRP owner reserve.`,
+        });
+    }
+}
+//# sourceMappingURL=offer-builder.js.map

package/dist/providers/xrpl-dex/offer-builder.js.map

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

package/dist/providers/xrpl-dex/orderbook-client.d.ts

@@ -0,0 +1,94 @@
+/**
+ * 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';
+import type { BookOfferCurrency } from './offer-builder.js';
+export interface OrderbookEntry {
+    /** Price in counter/base units. */
+    price: number;
+    /** Amount in base units. */
+    amount: number;
+    /** Total in counter units (price * amount). */
+    total: number;
+    /** Available balance of the offer owner. */
+    ownerFunds: string;
+    /** Offer sequence number. */
+    sequence: number;
+}
+export interface OrderbookResult {
+    /** Sell orders (ascending by price -- best ask first). */
+    asks: OrderbookEntry[];
+    /** Buy orders (descending by price -- best bid first). */
+    bids: OrderbookEntry[];
+    /** Spread between best ask and best bid (NaN if no orders). */
+    spread: number;
+}
+export interface AccountOffer {
+    /** Offer sequence number (use for cancel_order). */
+    seq: number;
+    /** What the offer gives away. */
+    takerGets: string;
+    /** What the offer wants. */
+    takerPays: string;
+    /** Offer flags. */
+    flags: number;
+    /** Expiration (Ripple epoch, optional). */
+    expiration?: number;
+}
+export interface ReserveInfo {
+    /** Total balance in drops. */
+    balance: string;
+    /** Number of owned ledger objects. */
+    ownerCount: number;
+    /** Base reserve in drops (10 XRP). */
+    baseReserve: number;
+    /** Per-object owner reserve in drops (0.2 XRP). */
+    ownerReserve: number;
+    /** Available balance for new objects (balance - baseReserve - ownerCount * ownerReserve) in drops. */
+    availableBalance: string;
+}
+export declare class XrplOrderbookClient {
+    private readonly rpcUrl;
+    private client;
+    private connectingPromise;
+    constructor(rpcUrl: string);
+    /**
+     * Ensure WebSocket connection is established (lazy connect).
+     */
+    ensureConnected(): Promise<void>;
+    /**
+     * Close WebSocket connection.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Get the underlying xrpl.Client (for testing/direct access).
+     */
+    getClient(): Client;
+    /**
+     * Query orderbook for a trading pair (both ask and bid sides).
+     */
+    getOrderbook(base: BookOfferCurrency, counter: BookOfferCurrency, limit: number): Promise<OrderbookResult>;
+    /**
+     * Query account's active offers.
+     */
+    getAccountOffers(account: string, limit: number): Promise<AccountOffer[]>;
+    /**
+     * Check if a trust line exists for a specific currency/issuer pair.
+     */
+    checkTrustLine(account: string, currency: string, issuer: string): Promise<boolean>;
+    /**
+     * Get account reserve information.
+     */
+    getAccountReserve(account: string): Promise<ReserveInfo>;
+}
+//# sourceMappingURL=orderbook-client.d.ts.map

package/dist/providers/xrpl-dex/orderbook-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orderbook-client.d.ts","sourceRoot":"","sources":["../../../src/providers/xrpl-dex/orderbook-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAE9B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAM5D,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,0DAA0D;IAC1D,IAAI,EAAE,cAAc,EAAE,CAAC;IACvB,0DAA0D;IAC1D,IAAI,EAAE,cAAc,EAAE,CAAC;IACvB,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,GAAG,EAAE,MAAM,CAAC;IACZ,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,YAAY,EAAE,MAAM,CAAC;IACrB,sGAAsG;IACtG,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAMD,qBAAa,mBAAmB;IAIlB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,iBAAiB,CAA8B;gBAE1B,MAAM,EAAE,MAAM;IAE3C;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBtC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAWjC;;OAEG;IACH,SAAS,IAAI,MAAM;IAWnB;;OAEG;IACG,YAAY,CAChB,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,iBAAiB,EAC1B,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,eAAe,CAAC;IAsD3B;;OAEG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAuB/E;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAqBzF;;OAEG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CA8B/D"}