@ecency/hive-tx 7.1.0

package/dist/cjs/helpers/call.js

@@ -0,0 +1,498 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.callWithQuorum = exports.callRPCBroadcast = exports.callRPC = exports.RPCError = void 0;
+exports.callREST = callREST;
+const config_1 = require("../config");
+const sleep_1 = require("./sleep");
+// ── Error Types ─────────────────────────────────────────────────────────────
+class RPCError extends Error {
+    constructor(rpcError) {
+        super(rpcError.message);
+        this.name = 'RPCError';
+        this.stack = undefined;
+        this.code = rpcError.code;
+        if ('data' in rpcError) {
+            this.data = rpcError.data;
+        }
+    }
+}
+exports.RPCError = RPCError;
+/**
+ * Transport-level error thrown by jsonRPCCall for HTTP status errors (429, 503).
+ * Carries node identity and rate-limit info so callers can record health
+ * exactly once without double-counting.
+ */
+class NodeError extends Error {
+    constructor(node, message, rateLimitMs = 0) {
+        super(message);
+        this.node = node;
+        this.rateLimitMs = rateLimitMs;
+    }
+}
+/** Errors that indicate the request definitely never reached the server. */
+const PRE_CONNECTION_ERRORS = ['ECONNREFUSED', 'ENOTFOUND', 'EHOSTUNREACH', 'EAI_AGAIN'];
+/**
+ * Check if an error is a pre-connection error (request never reached server).
+ *
+ * Node.js fetch wraps connection failures as TypeError('fetch failed') with
+ * the real error code nested in the cause chain: e.cause.code, e.cause.cause.code, etc.
+ * We walk up to 5 levels deep to find the actual code.
+ */
+function isPreConnectionError(e) {
+    if (!e)
+        return false;
+    const parts = [String(e.message || ''), String(e.code || '')];
+    let cause = e.cause;
+    for (let depth = 0; cause && depth < 5; depth++) {
+        parts.push(String(cause.code || ''), String(cause.message || ''));
+        cause = cause.cause;
+    }
+    const combined = parts.join(' ');
+    return PRE_CONNECTION_ERRORS.some((code) => combined.includes(code));
+}
+class NodeHealthTracker {
+    constructor() {
+        this.health = new Map();
+    }
+    getOrCreate(node) {
+        let h = this.health.get(node);
+        if (!h) {
+            h = { consecutiveFailures: 0, lastFailureTime: 0, rateLimitedUntil: 0 };
+            this.health.set(node, h);
+        }
+        return h;
+    }
+    recordSuccess(node) {
+        const h = this.getOrCreate(node);
+        h.consecutiveFailures = 0;
+    }
+    recordFailure(node) {
+        const h = this.getOrCreate(node);
+        h.consecutiveFailures++;
+        h.lastFailureTime = Date.now();
+    }
+    recordRateLimit(node, retryAfterMs = 10000) {
+        const h = this.getOrCreate(node);
+        h.rateLimitedUntil = Date.now() + retryAfterMs;
+        h.consecutiveFailures++;
+        h.lastFailureTime = Date.now();
+    }
+    isNodeHealthy(node) {
+        const h = this.health.get(node);
+        if (!h)
+            return true; // unknown nodes assumed healthy
+        // Rate-limited and cooldown hasn't expired
+        if (h.rateLimitedUntil > Date.now())
+            return false;
+        // Too many consecutive failures within the last 30 seconds
+        if (h.consecutiveFailures >= 3 && Date.now() - h.lastFailureTime < 30000)
+            return false;
+        return true;
+    }
+    /** Return nodes sorted: healthy first (preserving order), unhealthy appended. */
+    getOrderedNodes(nodes) {
+        const healthy = [];
+        const unhealthy = [];
+        for (const node of nodes) {
+            if (this.isNodeHealthy(node)) {
+                healthy.push(node);
+            }
+            else {
+                unhealthy.push(node);
+            }
+        }
+        return [...healthy, ...unhealthy];
+    }
+}
+const rpcHealthTracker = new NodeHealthTracker();
+const restHealthTracker = new NodeHealthTracker();
+// ── Internal helpers ────────────────────────────────────────────────────────
+/** Record a caught error on the health tracker (handles NodeError to avoid double-counting). */
+function recordError(tracker, node, e) {
+    if (e instanceof NodeError) {
+        if (e.rateLimitMs > 0) {
+            tracker.recordRateLimit(node, e.rateLimitMs);
+        }
+        else {
+            tracker.recordFailure(node);
+        }
+    }
+    else {
+        tracker.recordFailure(node);
+    }
+}
+/**
+ * Low-level JSON-RPC call to a single node. No failover.
+ * Throws RPCError for blockchain rejections, NodeError for HTTP 429/503,
+ * and generic Error for other transport failures.
+ * @param shouldRetry - If true, retries once on the same node for transient errors.
+ */
+const jsonRPCCall = async (url, method, params, timeout = config_1.config.timeout, shouldRetry = false) => {
+    const id = Math.floor(Math.random() * 100000000);
+    const body = {
+        jsonrpc: '2.0',
+        method,
+        params,
+        id
+    };
+    try {
+        const res = await fetch(url, {
+            method: 'POST',
+            body: JSON.stringify(body),
+            headers: { 'Content-Type': 'application/json' },
+            signal: AbortSignal.timeout(timeout)
+        });
+        // Handle HTTP-level errors before parsing JSON.
+        // Throw NodeError so callers can record health exactly once.
+        if (res.status === 429) {
+            const retryAfter = res.headers.get('Retry-After');
+            const cooldownMs = retryAfter ? parseInt(retryAfter, 10) * 1000 : 10000;
+            throw new NodeError(url, `HTTP 429 Rate Limited`, cooldownMs);
+        }
+        if (res.status === 503) {
+            throw new NodeError(url, `HTTP 503 Service Unavailable`);
+        }
+        const result = (await res.json());
+        if (!result ||
+            typeof result.id === 'undefined' ||
+            result.id !== id ||
+            result.jsonrpc !== '2.0') {
+            throw new Error('JSONRPC id mismatch');
+        }
+        if ('result' in result) {
+            return result.result;
+        }
+        if ('error' in result) {
+            const e = result.error;
+            if ('message' in e && 'code' in e) {
+                throw new RPCError(e);
+            }
+            throw result.error;
+        }
+        // No result and no error?
+        throw result;
+    }
+    catch (e) {
+        if (e instanceof RPCError) {
+            throw e;
+        }
+        // NodeError should not be retried on the same node - it's an HTTP status issue
+        if (e instanceof NodeError) {
+            throw e;
+        }
+        if (shouldRetry) {
+            return jsonRPCCall(url, method, params, timeout, false);
+        }
+        throw e;
+    }
+};
+/** Small jitter delay between failover attempts to prevent thundering herd. */
+function jitterDelay() {
+    return (0, sleep_1.sleep)(50 + Math.random() * 50);
+}
+// ── Public API: callRPC ─────────────────────────────────────────────────────
+/**
+ * Makes API calls to Hive blockchain nodes with automatic retry and failover support.
+ * Uses per-request retry counters, node health tracking, jitter between retries,
+ * and HTTP status awareness (429 rate limiting, 503).
+ *
+ * If the current node fails, it will automatically try the next healthy node.
+ * When all nodes have been tried, wraps around to give earlier nodes another chance
+ * until the full retry budget (config.retry) is exhausted.
+ * RPCErrors (valid blockchain rejections) are never retried.
+ *
+ * @param method - The API method name (e.g., 'condenser_api.get_accounts')
+ * @param params - Parameters for the API method as array or object
+ * @param timeout - Request timeout in milliseconds (default: config.timeout)
+ * @param retry - Maximum number of retry attempts (default: config.retry)
+ * @returns Promise resolving to the API response
+ * @throws {RPCError} On blockchain-level errors (bad params, missing authority, etc.)
+ * @throws {Error} If all retry attempts fail
+ *
+ * @example
+ * ```typescript
+ * import { callRPC } from 'hive-tx'
+ *
+ * // Get account information
+ * const accounts = await callRPC('condenser_api.get_accounts', [['alice']])
+ *
+ * // Custom timeout and retry settings
+ * const data = await callRPC('condenser_api.get_content', ['alice', 'test-post'], 10_000, 5)
+ * ```
+ */
+const callRPC = async (method, params = [], timeout = config_1.config.timeout, retry = config_1.config.retry) => {
+    if (!Array.isArray(config_1.config.nodes)) {
+        throw new Error('config.nodes is not an array');
+    }
+    if (config_1.config.nodes.length === 0) {
+        throw new Error('config.nodes is empty');
+    }
+    // Track nodes tried in the current round. When all nodes have been tried,
+    // clear the set to allow a second round (wrap-around) using the retry budget.
+    const triedInRound = new Set();
+    let lastError;
+    for (let attempt = 0; attempt <= retry; attempt++) {
+        // Re-evaluate node order each attempt so health changes are respected.
+        const orderedNodes = rpcHealthTracker.getOrderedNodes(config_1.config.nodes);
+        // Pick the healthiest untried node. If all tried, start a new round.
+        let node = orderedNodes.find((n) => !triedInRound.has(n));
+        if (!node) {
+            triedInRound.clear();
+            node = orderedNodes[0];
+        }
+        triedInRound.add(node);
+        try {
+            const res = await jsonRPCCall(node, method, params, timeout);
+            rpcHealthTracker.recordSuccess(node);
+            return res;
+        }
+        catch (e) {
+            // RPCErrors are valid blockchain rejections - never retry
+            if (e instanceof RPCError) {
+                throw e;
+            }
+            recordError(rpcHealthTracker, node, e);
+            lastError = e;
+            // Add jitter before trying next node
+            if (attempt < retry) {
+                await jitterDelay();
+            }
+        }
+    }
+    throw lastError;
+};
+exports.callRPC = callRPC;
+// ── Public API: callRPC for broadcasts ──────────────────────────────────────
+/**
+ * Broadcast-safe RPC call. Only retries on pre-connection errors where the
+ * request definitively never reached the server (ECONNREFUSED, ENOTFOUND, etc.).
+ * On timeouts, HTTP errors, or any ambiguous failure, throws immediately to
+ * prevent double-broadcasting transactions.
+ *
+ * Tries each node once (no wrap-around) since broadcast retries are dangerous.
+ *
+ * @internal Used by Transaction.broadcast()
+ */
+const callRPCBroadcast = async (method, params = [], timeout = config_1.config.timeout) => {
+    if (!Array.isArray(config_1.config.nodes)) {
+        throw new Error('config.nodes is not an array');
+    }
+    if (config_1.config.nodes.length === 0) {
+        throw new Error('config.nodes is empty');
+    }
+    // Track which nodes we've already tried - broadcasts must never retry the same node
+    const triedNodes = new Set();
+    let lastError;
+    for (let attempt = 0; attempt < config_1.config.nodes.length; attempt++) {
+        // Re-evaluate order each attempt so health changes are respected
+        const orderedNodes = rpcHealthTracker.getOrderedNodes(config_1.config.nodes);
+        const node = orderedNodes.find((n) => !triedNodes.has(n));
+        if (!node)
+            break;
+        triedNodes.add(node);
+        try {
+            const res = await jsonRPCCall(node, method, params, timeout);
+            rpcHealthTracker.recordSuccess(node);
+            return res;
+        }
+        catch (e) {
+            // RPCErrors are valid blockchain rejections - never retry
+            if (e instanceof RPCError) {
+                throw e;
+            }
+            recordError(rpcHealthTracker, node, e);
+            lastError = e;
+            // Only retry broadcasts on pre-connection errors where the request
+            // definitely never reached the server. On timeouts or HTTP errors,
+            // the server may have received and processed the transaction.
+            if (!isPreConnectionError(e)) {
+                throw e;
+            }
+        }
+    }
+    throw lastError;
+};
+exports.callRPCBroadcast = callRPCBroadcast;
+// ── Public API: callREST ────────────────────────────────────────────────────
+const apiMethods = {
+    balance: '/balance-api',
+    hafah: '/hafah-api',
+    hafbe: '/hafbe-api',
+    hivemind: '/hivemind-api',
+    hivesense: '/hivesense-api',
+    reputation: '/reputation-api',
+    'nft-tracker': '/nft-tracker-api',
+    hafsql: '/hafsql',
+    status: '/status-api'
+};
+/**
+ * Makes REST API calls to Hive blockchain REST endpoints with automatic retry and failover support.
+ * Uses per-request retry counters, node health tracking, and timeout support.
+ * Wraps around the node list to honor the full retry budget.
+ *
+ * @template Api - The REST API method type (e.g., 'balance', 'hafah', 'hivemind', etc.)
+ * @template P - The endpoint path type for the specified API
+ *
+ * @param api - The REST API method name to call
+ * @param endpoint - The specific endpoint path within the API
+ * @param params - Optional parameters for path and query string replacement
+ * @param timeout - Request timeout in milliseconds (default: config.timeout)
+ * @param retry - Number of retry attempts before throwing an error (default: config.retry)
+ *
+ * @returns Promise resolving to the API response data with proper typing
+ * @throws Error if all retry attempts fail
+ *
+ * @example
+ * ```typescript
+ * import { callREST } from 'hive-tx'
+ *
+ * // Get account balance
+ * const balance = await callREST('balance', '/accounts/{account-name}/balances', { "account-name": 'alice' })
+ *
+ * // Custom timeout and retry settings
+ * const data = await callREST('status', '/status', undefined, 10_000, 3)
+ * ```
+ */
+async function callREST(api, endpoint, params, timeout = config_1.config.timeout, retry = config_1.config.retry) {
+    if (!Array.isArray(config_1.config.restNodes)) {
+        throw new Error('config.restNodes is not an array');
+    }
+    if (config_1.config.restNodes.length === 0) {
+        throw new Error('config.restNodes is empty');
+    }
+    const triedInRound = new Set();
+    let lastError;
+    // Track whether the error was already recorded by the HTTP status handler
+    let alreadyRecorded = false;
+    for (let attempt = 0; attempt <= retry; attempt++) {
+        // Re-evaluate node order each attempt so health changes are respected.
+        const orderedNodes = restHealthTracker.getOrderedNodes(config_1.config.restNodes);
+        let node = orderedNodes.find((n) => !triedInRound.has(n));
+        if (!node) {
+            triedInRound.clear();
+            node = orderedNodes[0];
+        }
+        triedInRound.add(node);
+        const baseUrl = node + apiMethods[api];
+        let path = endpoint;
+        const paramObj = params || {};
+        const processedPathParams = new Set();
+        // Replace path params ONLY
+        Object.entries(paramObj).forEach(([key, value]) => {
+            if (path.includes(`{${key}}`)) {
+                path = path.replace(`{${key}}`, encodeURIComponent(String(value)));
+                processedPathParams.add(key);
+            }
+        });
+        const url = new URL(baseUrl + path);
+        // Add ONLY remaining params as query (if any)
+        Object.entries(paramObj).forEach(([key, value]) => {
+            if (!processedPathParams.has(key)) {
+                if (Array.isArray(value)) {
+                    value.forEach((v) => url.searchParams.append(key, String(v)));
+                }
+                else {
+                    url.searchParams.set(key, String(value));
+                }
+            }
+        });
+        alreadyRecorded = false;
+        try {
+            const response = await fetch(url.toString(), {
+                signal: AbortSignal.timeout(timeout)
+            });
+            if (response.status === 404) {
+                throw new Error('HTTP 404 - Hint: can happen on wrong params');
+            }
+            if (response.status === 429) {
+                const retryAfter = response.headers.get('Retry-After');
+                const cooldownMs = retryAfter ? parseInt(retryAfter, 10) * 1000 : 10000;
+                restHealthTracker.recordRateLimit(node, cooldownMs);
+                alreadyRecorded = true;
+                throw new Error(`HTTP 429 Rate Limited by ${node}`);
+            }
+            if (response.status === 503) {
+                restHealthTracker.recordFailure(node);
+                alreadyRecorded = true;
+                throw new Error(`HTTP 503 Service Unavailable from ${node}`);
+            }
+            restHealthTracker.recordSuccess(node);
+            return response.json();
+        }
+        catch (e) {
+            // 404 is not a node issue, don't failover
+            if (e?.message?.includes('HTTP 404')) {
+                throw e;
+            }
+            // Only record if not already recorded by 429/503 handler above
+            if (!alreadyRecorded) {
+                restHealthTracker.recordFailure(node);
+            }
+            lastError = e;
+            if (attempt < retry) {
+                await jitterDelay();
+            }
+        }
+    }
+    throw lastError;
+}
+// ── Public API: callWithQuorum ───────────────────────────────────────────────
+/**
+ * Make a JSONRPC call with quorum. The method will cross-check the result
+ * with `quorum` number of nodes before returning the result.
+ * @param method - The API method name (e.g., 'condenser_api.get_accounts')
+ * @param params - Parameters for the API method as array or object
+ * @param quorum - Default: 2 (recommended)
+ */
+const callWithQuorum = async (method, params = [], quorum = 2) => {
+    if (!Array.isArray(config_1.config.nodes)) {
+        throw new Error('config.nodes is not an Array');
+    }
+    if (quorum > config_1.config.nodes.length) {
+        throw new Error('quorum > config.nodes.length');
+    }
+    // We call random nodes for better security
+    const shuffleNodes = (arr) => [...arr].sort(() => Math.random() - 0.5);
+    let allNodes = shuffleNodes(config_1.config.nodes);
+    let currentBatchSize = Math.min(quorum, allNodes.length);
+    let allResults = [];
+    while (currentBatchSize > 0 && allNodes.length > 0) {
+        // Take next batch of nodes
+        const batchNodes = allNodes.splice(0, currentBatchSize);
+        const promises = [];
+        const batchResults = [];
+        // Launch batch calls in parallel
+        for (let i = 0; i < batchNodes.length; i++) {
+            promises.push(jsonRPCCall(batchNodes[i], method, params, undefined, true)
+                .then((data) => batchResults.push(data))
+                .catch(() => { }));
+        }
+        await Promise.all(promises);
+        allResults.push(...batchResults);
+        // Check for consensus in successful results
+        const consensusResult = findConsensus(allResults, quorum);
+        if (consensusResult) {
+            return consensusResult;
+        }
+        // Prepare next batch
+        currentBatchSize = Math.min(quorum, allNodes.length);
+        if (currentBatchSize === 0) {
+            throw new Error('No more nodes available.');
+        }
+    }
+    throw new Error("Couldn't reach quorum.");
+};
+exports.callWithQuorum = callWithQuorum;
+function findConsensus(results, quorum) {
+    const resultGroups = new Map();
+    for (const result of results) {
+        const key = JSON.stringify(result);
+        if (!resultGroups.has(key)) {
+            resultGroups.set(key, []);
+        }
+        resultGroups.get(key).push(result);
+    }
+    const consensusGroup = Array.from(resultGroups.values()).find((group) => group.length >= quorum);
+    return consensusGroup ? consensusGroup[0] : null;
+}
+//# sourceMappingURL=call.js.map

package/dist/cjs/helpers/call.js.map

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

package/dist/cjs/helpers/deserializer.d.ts

@@ -0,0 +1,4 @@
+export declare const Deserializer: {
+    Memo: (buf: Uint8Array) => any;
+};
+//# sourceMappingURL=deserializer.d.ts.map

package/dist/cjs/helpers/deserializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deserializer.d.ts","sourceRoot":"","sources":["../../../src/helpers/deserializer.ts"],"names":[],"mappings":"AAyDA,eAAO,MAAM,YAAY;gBAlCmC,UAAU;CAoCrE,CAAA"}

package/dist/cjs/helpers/deserializer.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Deserializer = void 0;
+const ByteBuffer_1 = require("./ByteBuffer");
+const PublicKey_1 = require("./PublicKey");
+const PublicKeyDeserializer = (buf) => {
+    const c = fixedBuf(buf, 33);
+    return new PublicKey_1.PublicKey(c);
+};
+const UInt64Deserializer = (b) => {
+    return b.readUint64();
+};
+const UInt32Deserializer = (b) => {
+    return b.readUint32();
+};
+const BinaryDeserializer = (b) => {
+    const len = b.readVarint32();
+    const bCopy = b.copy(b.offset, b.offset + len);
+    b.skip(len);
+    return new Uint8Array(bCopy.toBuffer());
+};
+const BufferDeserializer = (keyDeserializers) => (buf) => {
+    const obj = {};
+    const buffer = new ByteBuffer_1.ByteBuffer(ByteBuffer_1.ByteBuffer.DEFAULT_CAPACITY, ByteBuffer_1.ByteBuffer.LITTLE_ENDIAN);
+    buffer.append(buf);
+    buffer.flip();
+    for (const [key, deserializer] of keyDeserializers) {
+        try {
+            obj[key] = deserializer(buffer);
+        }
+        catch (error) {
+            error.message = `${key}: ${error.message}`;
+            throw error;
+        }
+    }
+    return obj;
+};
+function fixedBuf(b, len) {
+    if (!b) {
+        throw Error('No buffer found on first parameter');
+    }
+    else {
+        const bCopy = b.copy(b.offset, b.offset + len);
+        b.skip(len);
+        return new Uint8Array(bCopy.toBuffer());
+    }
+}
+const EncryptedMemoDeserializer = BufferDeserializer([
+    ['from', PublicKeyDeserializer],
+    ['to', PublicKeyDeserializer],
+    ['nonce', UInt64Deserializer],
+    ['check', UInt32Deserializer],
+    ['encrypted', BinaryDeserializer]
+]);
+exports.Deserializer = {
+    Memo: EncryptedMemoDeserializer
+};
+//# sourceMappingURL=deserializer.js.map

package/dist/cjs/helpers/deserializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deserializer.js","sourceRoot":"","sources":["../../../src/helpers/deserializer.ts"],"names":[],"mappings":";;;AAAA,6CAAyC;AACzC,2CAAuC;AAEvC,MAAM,qBAAqB,GAAG,CAAC,GAAe,EAAE,EAAE;IAChD,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;IAC3B,OAAO,IAAI,qBAAS,CAAC,CAAC,CAAC,CAAA;AACzB,CAAC,CAAA;AAED,MAAM,kBAAkB,GAAG,CAAC,CAAa,EAAE,EAAE;IAC3C,OAAO,CAAC,CAAC,UAAU,EAAE,CAAA;AACvB,CAAC,CAAA;AAED,MAAM,kBAAkB,GAAG,CAAC,CAAa,EAAE,EAAE;IAC3C,OAAO,CAAC,CAAC,UAAU,EAAE,CAAA;AACvB,CAAC,CAAA;AAED,MAAM,kBAAkB,GAAG,CAAC,CAAa,EAAE,EAAE;IAC3C,MAAM,GAAG,GAAW,CAAC,CAAC,YAAY,EAAE,CAAA;IACpC,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,CAAA;IAC9C,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACX,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAA;AACzC,CAAC,CAAA;AAED,MAAM,kBAAkB,GAAG,CAAC,gBAAqB,EAAE,EAAE,CAAC,CAAC,GAAe,EAAE,EAAE;IACxE,MAAM,GAAG,GAAQ,EAAE,CAAA;IACnB,MAAM,MAAM,GAAG,IAAI,uBAAU,CAAC,uBAAU,CAAC,gBAAgB,EAAE,uBAAU,CAAC,aAAa,CAAC,CAAA;IACpF,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IAClB,MAAM,CAAC,IAAI,EAAE,CAAA;IACb,KAAK,MAAM,CAAC,GAAG,EAAE,YAAY,CAAC,IAAI,gBAAgB,EAAE,CAAC;QACnD,IAAI,CAAC;YACH,GAAG,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC,CAAA;QACjC,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,KAAK,CAAC,OAAO,GAAG,GAAG,GAAG,KAAK,KAAK,CAAC,OAAO,EAAE,CAAA;YAC1C,MAAM,KAAK,CAAA;QACb,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC,CAAA;AAED,SAAS,QAAQ,CAAC,CAAa,EAAE,GAAW;IAC1C,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,KAAK,CAAC,oCAAoC,CAAC,CAAA;IACnD,CAAC;SAAM,CAAC;QACN,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,CAAA;QAC9C,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACX,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAA;IACzC,CAAC;AACH,CAAC;AAED,MAAM,yBAAyB,GAAG,kBAAkB,CAAC;IACnD,CAAC,MAAM,EAAE,qBAAqB,CAAC;IAC/B,CAAC,IAAI,EAAE,qBAAqB,CAAC;IAC7B,CAAC,OAAO,EAAE,kBAAkB,CAAC;IAC7B,CAAC,OAAO,EAAE,kBAAkB,CAAC;IAC7B,CAAC,WAAW,EAAE,kBAAkB,CAAC;CAClC,CAAC,CAAA;AAEW,QAAA,YAAY,GAAG;IAC1B,IAAI,EAAE,yBAAyB;CAChC,CAAA"}

package/dist/cjs/helpers/memo.d.ts

@@ -0,0 +1,36 @@
+import { PrivateKey } from './PrivateKey';
+import { PublicKey } from './PublicKey';
+export type Memo = {
+    /**
+     * Encrypts a memo for secure private messaging
+     */
+    encode(privateKey: string | PrivateKey, publicKey: string | PublicKey, memo: string, testNonce?: any): string;
+    /**
+     * Decrypts a memo message
+     */
+    decode(privateKey: string | PrivateKey, memo: string): string;
+};
+/**
+ * Memo utilities for encrypting and decrypting private messages between Hive users.
+ * Uses AES encryption with ECDH key exchange for secure communication.
+ *
+ * Messages must start with '#' to be encrypted/decrypted.
+ * Plain text messages (without '#') are returned unchanged.
+ *
+ * @example
+ * ```typescript
+ * import { Memo, PrivateKey, PublicKey } from 'hive-tx'
+ *
+ * // Encrypt a message
+ * const encrypted = Memo.encode(senderPrivateKey, recipientPublicKey, '#Hello World')
+ *
+ * // Decrypt a message
+ * const decrypted = Memo.decode(recipientPrivateKey, encrypted)
+ * console.log(decrypted) // '#Hello World'
+ * ```
+ */
+export declare const Memo: {
+    decode: (privateKey: string | PrivateKey, memo: string) => string;
+    encode: (privateKey: string | PrivateKey, publicKey: string | PublicKey, memo: string, testNonce?: any) => string;
+};
+//# sourceMappingURL=memo.d.ts.map

package/dist/cjs/helpers/memo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memo.d.ts","sourceRoot":"","sources":["../../../src/helpers/memo.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAGvC,MAAM,MAAM,IAAI,GAAG;IACjB;;OAEG;IACH,MAAM,CACJ,UAAU,EAAE,MAAM,GAAG,UAAU,EAC/B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,IAAI,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,GAAG,GACd,MAAM,CAAA;IAET;;OAEG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;CAC9D,CAAA;AA0GD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,IAAI;yBAzEW,MAAM,GAAG,UAAU,QAAQ,MAAM,KAAG,MAAM;yBAtCxD,MAAM,GAAG,UAAU,aACpB,MAAM,GAAG,SAAS,QACvB,MAAM,cACA,GAAG,KACd,MAAM;CA8GR,CAAA"}