@blockbima/xrpl-integration 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mohammed Mwijaa
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,152 @@
+# XRPL Integration
+
+A lightweight TypeScript wrapper for the XRP Ledger using [xrpl.js](https://github.com/XRPLF/xrpl.js). Implements a singleton pattern for easy integration into any application.
+
+## Features
+
+- Singleton client pattern for connection management
+- XRP and IOU token balance queries
+- XRP and IOU token transfers
+- Trustline verification
+- Full TypeScript support with exported types
+- Works with Mainnet, Testnet, and Devnet
+
+## Installation
+
+```bash
+npm install xrpl-integration
+```
+
+## Quick Start
+
+```typescript
+import { XRPLClient, NETWORKS } from "xrpl-integration";
+import { Wallet } from "xrpl";
+
+// Get singleton instance (defaults to testnet)
+const client = XRPLClient.getInstance(NETWORKS.TESTNET);
+
+// Connect to the network
+await client.connect();
+
+// Check XRP balance
+const balance = await client.getXRPBalance("rAddress...");
+console.log(`Balance: ${balance.balance} XRP`);
+
+// Disconnect when done
+await client.disconnect();
+```
+
+## API Reference
+
+### Connection
+
+```typescript
+// Get client instance
+const client = XRPLClient.getInstance(networkUrl?: string);
+
+// Connect/disconnect
+await client.connect();
+await client.disconnect();
+
+// Check connection status
+client.isConnected; // boolean
+
+// Reset instance (for switching networks)
+await XRPLClient.resetInstance();
+```
+
+### Balance Queries
+
+```typescript
+// XRP balance
+const xrpBalance = await client.getXRPBalance(address);
+// Returns: { address, balance, balanceDrops }
+
+// IOU token balance
+const iouBalance = await client.getIOUBalance(address, currency, issuer);
+// Returns: { address, currency, issuer, balance }
+```
+
+### Transfers
+
+```typescript
+// Send XRP
+const result = await client.sendXRP({
+  wallet,           // xrpl Wallet instance
+  destination,      // recipient address
+  amount,           // amount in XRP (not drops)
+  destinationTag?,  // optional
+  memo?,            // optional
+});
+
+// Send IOU tokens
+const result = await client.sendIOU({
+  wallet,
+  destination,
+  currency,         // e.g., "USD"
+  issuer,           // token issuer address
+  amount,
+  destinationTag?,
+  memo?,
+});
+
+// Returns: { success, hash, ledgerIndex, response }
+```
+
+### Trustlines
+
+```typescript
+// Check specific trustline
+const trustline = await client.checkTrustline(address, currency, issuer);
+// Returns: { exists, currency, issuer, balance, limit, ... }
+
+// Get all trustlines for an account
+const trustlines = await client.getAllTrustlines(address);
+```
+
+### Testnet Utilities
+
+```typescript
+// Fund a wallet on testnet/devnet
+const wallet = await client.fundWallet();
+// Or fund an existing wallet
+const funded = await client.fundWallet(existingWallet);
+```
+
+## Network Constants
+
+```typescript
+import { NETWORKS } from "xrpl-integration";
+
+NETWORKS.MAINNET       // wss://xrplcluster.com/
+NETWORKS.MAINNET_RIPPLE // wss://s1.ripple.com/
+NETWORKS.TESTNET       // wss://s.altnet.rippletest.net:51233/
+NETWORKS.DEVNET        // wss://s.devnet.rippletest.net:51233/
+```
+
+## Error Handling
+
+All methods throw `XRPLClientError` with specific error types:
+
+```typescript
+import { XRPLClientError, XRPLClientErrorType } from "xrpl-integration";
+
+try {
+  await client.getXRPBalance("invalid");
+} catch (error) {
+  if (error instanceof XRPLClientError) {
+    switch (error.type) {
+      case XRPLClientErrorType.NOT_CONNECTED:
+      case XRPLClientErrorType.INVALID_ADDRESS:
+      case XRPLClientErrorType.ACCOUNT_NOT_FOUND:
+      case XRPLClientErrorType.TRANSACTION_FAILED:
+        // Handle specific error
+    }
+  }
+}
+```
+
+## License
+
+MIT

package/dist/__tests__/XRPLClient.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=XRPLClient.test.d.ts.map

package/dist/__tests__/XRPLClient.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"XRPLClient.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/XRPLClient.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/XRPLClient.test.js

@@ -0,0 +1,121 @@
+import { describe, it, expect, beforeEach } from "@jest/globals";
+import { XRPLClient } from "../client/XRPLClient.js";
+import { NETWORKS, XRPLClientError, XRPLClientErrorType, } from "../types/index.js";
+describe("XRPLClient", () => {
+    // Reset singleton before each test
+    beforeEach(async () => {
+        await XRPLClient.resetInstance();
+    });
+    describe("Singleton Pattern", () => {
+        it("should return the same instance on multiple calls", () => {
+            const instance1 = XRPLClient.getInstance();
+            const instance2 = XRPLClient.getInstance();
+            expect(instance1).toBe(instance2);
+        });
+        it("should use default testnet URL when no URL provided", () => {
+            const client = XRPLClient.getInstance();
+            expect(client.network).toBe(NETWORKS.TESTNET);
+        });
+        it("should use custom URL when provided on first call", () => {
+            const client = XRPLClient.getInstance(NETWORKS.MAINNET);
+            expect(client.network).toBe(NETWORKS.MAINNET);
+        });
+        it("should ignore URL on subsequent calls", () => {
+            XRPLClient.getInstance(NETWORKS.TESTNET);
+            const client2 = XRPLClient.getInstance(NETWORKS.MAINNET);
+            expect(client2.network).toBe(NETWORKS.TESTNET);
+        });
+        it("should reset instance correctly", async () => {
+            const client1 = XRPLClient.getInstance(NETWORKS.TESTNET);
+            await XRPLClient.resetInstance();
+            const client2 = XRPLClient.getInstance(NETWORKS.MAINNET);
+            expect(client2.network).toBe(NETWORKS.MAINNET);
+            expect(client1).not.toBe(client2);
+        });
+        it("should expose raw client", () => {
+            const client = XRPLClient.getInstance();
+            expect(client.rawClient).toBeDefined();
+        });
+    });
+    describe("Connection State", () => {
+        it("should start disconnected", () => {
+            const client = XRPLClient.getInstance();
+            expect(client.isConnected).toBe(false);
+        });
+        it("should not disconnect if not connected", async () => {
+            const client = XRPLClient.getInstance();
+            // Should not throw
+            await client.disconnect();
+            expect(client.isConnected).toBe(false);
+        });
+    });
+    describe("Validation Errors (without connection)", () => {
+        it("should throw NOT_CONNECTED for getXRPBalance when not connected", async () => {
+            const client = XRPLClient.getInstance();
+            await expect(client.getXRPBalance("rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh")).rejects.toMatchObject({
+                type: XRPLClientErrorType.NOT_CONNECTED,
+            });
+        });
+        it("should throw NOT_CONNECTED for getIOUBalance when not connected", async () => {
+            const client = XRPLClient.getInstance();
+            await expect(client.getIOUBalance("rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh", "USD", "rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe")).rejects.toMatchObject({
+                type: XRPLClientErrorType.NOT_CONNECTED,
+            });
+        });
+        it("should throw NOT_CONNECTED for sendXRP when not connected", async () => {
+            const client = XRPLClient.getInstance();
+            await expect(client.sendXRP({
+                wallet: {},
+                destination: "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
+                amount: "10",
+            })).rejects.toMatchObject({
+                type: XRPLClientErrorType.NOT_CONNECTED,
+            });
+        });
+        it("should throw NOT_CONNECTED for sendIOU when not connected", async () => {
+            const client = XRPLClient.getInstance();
+            await expect(client.sendIOU({
+                wallet: {},
+                destination: "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
+                currency: "USD",
+                issuer: "rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe",
+                amount: "100",
+            })).rejects.toMatchObject({
+                type: XRPLClientErrorType.NOT_CONNECTED,
+            });
+        });
+        it("should throw NOT_CONNECTED for checkTrustline when not connected", async () => {
+            const client = XRPLClient.getInstance();
+            await expect(client.checkTrustline("rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh", "USD", "rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe")).rejects.toMatchObject({
+                type: XRPLClientErrorType.NOT_CONNECTED,
+            });
+        });
+        it("should throw NOT_CONNECTED for getAllTrustlines when not connected", async () => {
+            const client = XRPLClient.getInstance();
+            await expect(client.getAllTrustlines("rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh")).rejects.toMatchObject({
+                type: XRPLClientErrorType.NOT_CONNECTED,
+            });
+        });
+        it("should throw NOT_CONNECTED for fundWallet when not connected", async () => {
+            const client = XRPLClient.getInstance();
+            await expect(client.fundWallet()).rejects.toMatchObject({
+                type: XRPLClientErrorType.NOT_CONNECTED,
+            });
+        });
+    });
+    describe("XRPLClientError", () => {
+        it("should create error with correct properties", () => {
+            const error = new XRPLClientError(XRPLClientErrorType.CONNECTION_ERROR, "Test error", { detail: "test" });
+            expect(error.type).toBe(XRPLClientErrorType.CONNECTION_ERROR);
+            expect(error.message).toBe("Test error");
+            expect(error.details).toEqual({ detail: "test" });
+            expect(error.name).toBe("XRPLClientError");
+        });
+        it("should be an instance of Error", () => {
+            const error = new XRPLClientError(XRPLClientErrorType.NOT_CONNECTED, "Test");
+            expect(error).toBeInstanceOf(Error);
+            expect(error).toBeInstanceOf(XRPLClientError);
+        });
+    });
+});
+//# sourceMappingURL=XRPLClient.test.js.map

package/dist/__tests__/XRPLClient.test.js.map

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

package/dist/__tests__/types.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.test.d.ts.map

package/dist/__tests__/types.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/types.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/types.test.js

@@ -0,0 +1,103 @@
+import { describe, it, expect } from "@jest/globals";
+import { NETWORKS, XRPLClientError, XRPLClientErrorType, } from "../types/index.js";
+describe("Types", () => {
+    describe("NETWORKS", () => {
+        it("should have correct mainnet URL", () => {
+            expect(NETWORKS.MAINNET).toBe("wss://xrplcluster.com/");
+        });
+        it("should have correct mainnet ripple URL", () => {
+            expect(NETWORKS.MAINNET_RIPPLE).toBe("wss://s1.ripple.com/");
+        });
+        it("should have correct testnet URL", () => {
+            expect(NETWORKS.TESTNET).toBe("wss://s.altnet.rippletest.net:51233/");
+        });
+        it("should have correct devnet URL", () => {
+            expect(NETWORKS.DEVNET).toBe("wss://s.devnet.rippletest.net:51233/");
+        });
+        it("should be immutable (readonly)", () => {
+            // TypeScript enforces this at compile time, but we can verify the values exist
+            expect(Object.keys(NETWORKS)).toHaveLength(4);
+        });
+    });
+    describe("XRPLClientErrorType", () => {
+        it("should have CONNECTION_ERROR type", () => {
+            expect(XRPLClientErrorType.CONNECTION_ERROR).toBe("CONNECTION_ERROR");
+        });
+        it("should have NOT_CONNECTED type", () => {
+            expect(XRPLClientErrorType.NOT_CONNECTED).toBe("NOT_CONNECTED");
+        });
+        it("should have ACCOUNT_NOT_FOUND type", () => {
+            expect(XRPLClientErrorType.ACCOUNT_NOT_FOUND).toBe("ACCOUNT_NOT_FOUND");
+        });
+        it("should have TRUSTLINE_NOT_FOUND type", () => {
+            expect(XRPLClientErrorType.TRUSTLINE_NOT_FOUND).toBe("TRUSTLINE_NOT_FOUND");
+        });
+        it("should have INSUFFICIENT_BALANCE type", () => {
+            expect(XRPLClientErrorType.INSUFFICIENT_BALANCE).toBe("INSUFFICIENT_BALANCE");
+        });
+        it("should have TRANSACTION_FAILED type", () => {
+            expect(XRPLClientErrorType.TRANSACTION_FAILED).toBe("TRANSACTION_FAILED");
+        });
+        it("should have INVALID_ADDRESS type", () => {
+            expect(XRPLClientErrorType.INVALID_ADDRESS).toBe("INVALID_ADDRESS");
+        });
+        it("should have INVALID_AMOUNT type", () => {
+            expect(XRPLClientErrorType.INVALID_AMOUNT).toBe("INVALID_AMOUNT");
+        });
+    });
+    describe("XRPLClientError", () => {
+        it("should create error with type and message", () => {
+            const error = new XRPLClientError(XRPLClientErrorType.CONNECTION_ERROR, "Failed to connect");
+            expect(error).toBeInstanceOf(Error);
+            expect(error).toBeInstanceOf(XRPLClientError);
+            expect(error.type).toBe(XRPLClientErrorType.CONNECTION_ERROR);
+            expect(error.message).toBe("Failed to connect");
+            expect(error.name).toBe("XRPLClientError");
+        });
+        it("should create error with type, message, and details", () => {
+            const details = { code: 500, reason: "Network failure" };
+            const error = new XRPLClientError(XRPLClientErrorType.CONNECTION_ERROR, "Failed to connect", details);
+            expect(error.details).toEqual(details);
+        });
+        it("should handle undefined details", () => {
+            const error = new XRPLClientError(XRPLClientErrorType.NOT_CONNECTED, "Not connected");
+            expect(error.details).toBeUndefined();
+        });
+        it("should be throwable and catchable", () => {
+            expect(() => {
+                throw new XRPLClientError(XRPLClientErrorType.INVALID_ADDRESS, "Bad address");
+            }).toThrow(XRPLClientError);
+        });
+        it("should preserve prototype chain", () => {
+            const error = new XRPLClientError(XRPLClientErrorType.TRANSACTION_FAILED, "TX failed");
+            expect(error instanceof XRPLClientError).toBe(true);
+            expect(error instanceof Error).toBe(true);
+        });
+        it("should have correct stack trace", () => {
+            const error = new XRPLClientError(XRPLClientErrorType.ACCOUNT_NOT_FOUND, "Account not found");
+            expect(error.stack).toBeDefined();
+            expect(error.stack).toContain("XRPLClientError");
+        });
+        it("should work with different error types", () => {
+            const errorTypes = Object.values(XRPLClientErrorType);
+            errorTypes.forEach((type) => {
+                const error = new XRPLClientError(type, `Error of type ${type}`);
+                expect(error.type).toBe(type);
+            });
+        });
+        it("should handle complex details objects", () => {
+            const complexDetails = {
+                nested: {
+                    deep: {
+                        value: 123,
+                    },
+                },
+                array: [1, 2, 3],
+                nullValue: null,
+            };
+            const error = new XRPLClientError(XRPLClientErrorType.TRANSACTION_FAILED, "Complex error", complexDetails);
+            expect(error.details).toEqual(complexDetails);
+        });
+    });
+});
+//# sourceMappingURL=types.test.js.map

package/dist/__tests__/types.test.js.map

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

package/dist/__tests__/utils.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=utils.test.d.ts.map

package/dist/__tests__/utils.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/utils.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/utils.test.js

@@ -0,0 +1,194 @@
+import { jest, describe, it, expect } from "@jest/globals";
+import { validateAddress, isValidAddress, convertXRPToDrops, convertDropsToXRP, validateAmount, formatCurrencyCode, encodeCurrencyCode, createMemo, decodeMemo, } from "../utils/index.js";
+import { XRPLClientError, XRPLClientErrorType } from "../types/index.js";
+// Mock xrpl module
+jest.mock("xrpl", () => ({
+    isValidClassicAddress: jest.fn((address) => {
+        return /^r[1-9A-HJ-NP-Za-km-z]{24,34}$/.test(address);
+    }),
+    xrpToDrops: jest.fn((xrp) => {
+        const num = typeof xrp === "string" ? parseFloat(xrp) : xrp;
+        if (isNaN(num)) {
+            throw new Error("Invalid XRP amount");
+        }
+        return String(Math.floor(num * 1_000_000));
+    }),
+    dropsToXrp: jest.fn((drops) => {
+        const num = typeof drops === "string" ? parseInt(drops, 10) : drops;
+        if (isNaN(num)) {
+            throw new Error("Invalid drops amount");
+        }
+        return num / 1_000_000;
+    }),
+}));
+describe("Utils", () => {
+    describe("validateAddress", () => {
+        it("should return true for valid addresses", () => {
+            const validAddress = "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh";
+            expect(validateAddress(validAddress)).toBe(true);
+        });
+        it("should throw XRPLClientError for invalid addresses", () => {
+            const invalidAddress = "invalid";
+            expect(() => validateAddress(invalidAddress)).toThrow(XRPLClientError);
+            expect(() => validateAddress(invalidAddress)).toThrow(/Invalid XRP Ledger address/);
+        });
+        it("should throw error with correct error type", () => {
+            try {
+                validateAddress("bad");
+            }
+            catch (error) {
+                expect(error).toBeInstanceOf(XRPLClientError);
+                expect(error.type).toBe(XRPLClientErrorType.INVALID_ADDRESS);
+            }
+        });
+    });
+    describe("isValidAddress", () => {
+        it("should return true for valid addresses", () => {
+            expect(isValidAddress("rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh")).toBe(true);
+        });
+        it("should return false for invalid addresses", () => {
+            expect(isValidAddress("invalid")).toBe(false);
+            expect(isValidAddress("")).toBe(false);
+            expect(isValidAddress("r")).toBe(false);
+        });
+    });
+    describe("convertXRPToDrops", () => {
+        it("should convert XRP to drops correctly", () => {
+            expect(convertXRPToDrops("1")).toBe("1000000");
+            expect(convertXRPToDrops("10")).toBe("10000000");
+            expect(convertXRPToDrops("0.5")).toBe("500000");
+            expect(convertXRPToDrops("0.000001")).toBe("1");
+        });
+        it("should throw XRPLClientError for invalid amounts", () => {
+            expect(() => convertXRPToDrops("invalid")).toThrow(XRPLClientError);
+            expect(() => convertXRPToDrops("invalid")).toThrow(/Invalid XRP amount/);
+        });
+        it("should throw error with correct error type", () => {
+            try {
+                convertXRPToDrops("not-a-number");
+            }
+            catch (error) {
+                expect(error).toBeInstanceOf(XRPLClientError);
+                expect(error.type).toBe(XRPLClientErrorType.INVALID_AMOUNT);
+            }
+        });
+    });
+    describe("convertDropsToXRP", () => {
+        it("should convert drops to XRP correctly", () => {
+            expect(convertDropsToXRP("1000000")).toBe("1");
+            expect(convertDropsToXRP("10000000")).toBe("10");
+            expect(convertDropsToXRP("500000")).toBe("0.5");
+            expect(convertDropsToXRP(1000000)).toBe("1");
+        });
+        it("should throw XRPLClientError for invalid amounts", () => {
+            expect(() => convertDropsToXRP("invalid")).toThrow(XRPLClientError);
+            expect(() => convertDropsToXRP("invalid")).toThrow(/Invalid drops amount/);
+        });
+        it("should throw error with correct error type", () => {
+            try {
+                convertDropsToXRP("not-a-number");
+            }
+            catch (error) {
+                expect(error).toBeInstanceOf(XRPLClientError);
+                expect(error.type).toBe(XRPLClientErrorType.INVALID_AMOUNT);
+            }
+        });
+    });
+    describe("validateAmount", () => {
+        it("should return true for valid positive amounts", () => {
+            expect(validateAmount("1")).toBe(true);
+            expect(validateAmount("0.5")).toBe(true);
+            expect(validateAmount("100.123")).toBe(true);
+        });
+        it("should throw XRPLClientError for invalid amounts", () => {
+            expect(() => validateAmount("0")).toThrow(XRPLClientError);
+            expect(() => validateAmount("-1")).toThrow(XRPLClientError);
+            expect(() => validateAmount("invalid")).toThrow(XRPLClientError);
+            expect(() => validateAmount("")).toThrow(XRPLClientError);
+        });
+        it("should throw error with correct error type and message", () => {
+            try {
+                validateAmount("-5");
+            }
+            catch (error) {
+                expect(error).toBeInstanceOf(XRPLClientError);
+                expect(error.type).toBe(XRPLClientErrorType.INVALID_AMOUNT);
+                expect(error.message).toContain("Must be a positive number");
+            }
+        });
+    });
+    describe("formatCurrencyCode", () => {
+        it("should return standard 3-character codes as-is", () => {
+            expect(formatCurrencyCode("USD")).toBe("USD");
+            expect(formatCurrencyCode("EUR")).toBe("EUR");
+            expect(formatCurrencyCode("XRP")).toBe("XRP");
+        });
+        it("should decode hex currency codes to readable strings", () => {
+            // "TEST" encoded as hex with padding
+            const hexCode = "5445535400000000000000000000000000000000";
+            expect(formatCurrencyCode(hexCode)).toBe("TEST");
+        });
+        it("should return hex code if decoding fails or is non-printable", () => {
+            // Non-printable characters
+            const nonPrintableHex = "0000000000000000000000000000000000000001";
+            expect(formatCurrencyCode(nonPrintableHex)).toBe(nonPrintableHex);
+        });
+        it("should handle edge cases", () => {
+            expect(formatCurrencyCode("")).toBe("");
+            expect(formatCurrencyCode("AB")).toBe("AB");
+        });
+    });
+    describe("encodeCurrencyCode", () => {
+        it("should return standard 3-character codes in uppercase", () => {
+            expect(encodeCurrencyCode("USD")).toBe("USD");
+            expect(encodeCurrencyCode("usd")).toBe("USD");
+            expect(encodeCurrencyCode("Eur")).toBe("EUR");
+        });
+        it("should return already hex-encoded codes as-is", () => {
+            const hexCode = "5445535400000000000000000000000000000000";
+            expect(encodeCurrencyCode(hexCode)).toBe(hexCode.toUpperCase());
+        });
+        it("should encode longer currency names as hex", () => {
+            const encoded = encodeCurrencyCode("TEST");
+            expect(encoded).toHaveLength(40);
+            expect(encoded).toMatch(/^[0-9A-F]+$/);
+        });
+        it("should handle special characters", () => {
+            const encoded = encodeCurrencyCode("LP Token");
+            expect(encoded).toHaveLength(40);
+        });
+    });
+    describe("createMemo", () => {
+        it("should create memo array with hex-encoded data", () => {
+            const memo = createMemo("Hello");
+            expect(memo).toHaveLength(1);
+            expect(memo[0]).toHaveProperty("Memo");
+            expect(memo[0]?.Memo).toHaveProperty("MemoData");
+            // "Hello" in hex
+            expect(memo[0]?.Memo.MemoData).toBe("48656C6C6F");
+        });
+        it("should handle empty strings", () => {
+            const memo = createMemo("");
+            expect(memo[0]?.Memo.MemoData).toBe("");
+        });
+        it("should handle unicode characters", () => {
+            const memo = createMemo("🚀");
+            expect(memo[0]?.Memo.MemoData).toBeTruthy();
+        });
+    });
+    describe("decodeMemo", () => {
+        it("should decode hex memo data to string", () => {
+            // "Hello" in hex
+            expect(decodeMemo("48656C6C6F")).toBe("Hello");
+        });
+        it("should handle non-hex input gracefully", () => {
+            // Buffer.from with 'hex' encoding returns empty buffer for invalid hex
+            const result = decodeMemo("zzzz");
+            expect(typeof result).toBe("string");
+        });
+        it("should handle empty strings", () => {
+            expect(decodeMemo("")).toBe("");
+        });
+    });
+});
+//# sourceMappingURL=utils.test.js.map

package/dist/__tests__/utils.test.js.map

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