@ecency/hive-tx 7.1.0

package/dist/cjs/helpers/aes.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cryptoJsEncrypt = exports.decrypt = exports.encrypt = void 0;
+const ByteBuffer_1 = require("./ByteBuffer");
+const aes_js_1 = require("@noble/ciphers/aes.js");
+const secp256k1_js_1 = require("@noble/curves/secp256k1.js");
+const sha2_js_1 = require("@noble/hashes/sha2.js");
+const encrypt = (privateKey, publicKey, message, nonce = uniqueNonce()) => crypt(privateKey, publicKey, nonce, message);
+exports.encrypt = encrypt;
+const decrypt = (privateKey, publicKey, nonce, message, checksum) => {
+    const d = crypt(privateKey, publicKey, nonce, message, checksum);
+    return d.message;
+};
+exports.decrypt = decrypt;
+/**
+ * @arg message - Encrypted or plain text message (see checksum)
+ * @arg checksum - shared secret checksum (null to encrypt, non-null to decrypt)
+ */
+const crypt = (privateKey, publicKey, nonce, message, checksum) => {
+    const nonceL = typeof nonce === 'bigint' ? nonce : BigInt(nonce);
+    const S = privateKey.getSharedSecret(publicKey);
+    let ebuf = new ByteBuffer_1.ByteBuffer(ByteBuffer_1.ByteBuffer.DEFAULT_CAPACITY, ByteBuffer_1.ByteBuffer.LITTLE_ENDIAN);
+    ebuf.writeUint64(nonceL);
+    ebuf.append(S);
+    ebuf.flip();
+    const encryptionKey = (0, sha2_js_1.sha512)(new Uint8Array(ebuf.toBuffer()));
+    const iv = encryptionKey.subarray(32, 48);
+    const tag = encryptionKey.subarray(0, 32);
+    // check if first 64 bit of sha256 hash treated as uint64_t truncated to 32 bits.
+    const check = (0, sha2_js_1.sha256)(encryptionKey).subarray(0, 4);
+    const cbuf = new ByteBuffer_1.ByteBuffer(ByteBuffer_1.ByteBuffer.DEFAULT_CAPACITY, ByteBuffer_1.ByteBuffer.LITTLE_ENDIAN);
+    cbuf.append(check);
+    cbuf.flip();
+    const check32 = cbuf.readUint32();
+    if (checksum) {
+        if (check32 !== checksum) {
+            throw new Error('Invalid key');
+        }
+        message = cryptoJsDecrypt(message, tag, iv);
+    }
+    else {
+        message = (0, exports.cryptoJsEncrypt)(message, tag, iv);
+    }
+    return { nonce: nonceL, message, checksum: check32 };
+};
+/**
+ * This method does not use a checksum, the returned data must be validated some other way.
+ * @arg {string|Uint8Array} ciphertext - binary format
+ * @return {Uint8Array} the decrypted message
+ */
+const cryptoJsDecrypt = (message, tag, iv) => {
+    let messageBuffer = message;
+    const decipher = (0, aes_js_1.cbc)(tag, iv);
+    messageBuffer = decipher.decrypt(messageBuffer);
+    // return Uint8Array.from(messageBuffer)
+    return messageBuffer;
+};
+/**
+ * This method does not use a checksum, the returned data must be validated some other way.
+ * @arg {string|Uint8Array} plaintext - binary format
+ * @return {Uint8Array} binary
+ */
+const cryptoJsEncrypt = (message, tag, iv) => {
+    let messageBuffer = message;
+    const cipher = (0, aes_js_1.cbc)(tag, iv);
+    messageBuffer = cipher.encrypt(messageBuffer);
+    // return Uint8Array.from(messageBuffer)
+    return messageBuffer;
+};
+exports.cryptoJsEncrypt = cryptoJsEncrypt;
+/** @return {string} unique 64 bit unsigned number string.  Being time based,
+ * this is careful to never choose the same nonce twice.  This value could
+ * clsbe recorded in the blockchain for a long time.
+ */
+let uniqueNonceEntropy = null;
+const uniqueNonce = () => {
+    if (uniqueNonceEntropy === null) {
+        const randomPrivateKey = secp256k1_js_1.secp256k1.utils.randomSecretKey();
+        uniqueNonceEntropy = Math.round((randomPrivateKey[0] << 8) | randomPrivateKey[1]);
+    }
+    let long = BigInt(Date.now());
+    const entropy = ++uniqueNonceEntropy % 0xffff;
+    long = (long << BigInt(16)) | BigInt(entropy);
+    return long;
+};
+// const toLongObj = (o) => (o ? (Long.isLong(o) ? o : Long.fromString(o)) : o)
+//# sourceMappingURL=aes.js.map

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

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

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

@@ -0,0 +1,119 @@
+import { APIMethods, APIPaths } from '../types';
+export declare class RPCError extends Error {
+    name: string;
+    data?: any;
+    code: number;
+    stack: undefined;
+    constructor(rpcError: {
+        message: string;
+        code: number;
+        data?: any;
+    });
+}
+/**
+ * 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)
+ * ```
+ */
+export declare const callRPC: <T = any>(method: string, params?: any[] | object, timeout?: number, retry?: number) => Promise<T>;
+/**
+ * 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()
+ */
+export declare const callRPCBroadcast: <T = any>(method: string, params?: any[] | object, timeout?: number) => Promise<T>;
+type GetResponse<T> = T extends {
+    responses: {
+        '200'?: {
+            content: {
+                'application/json': infer R;
+            };
+        };
+    };
+} ? R : undefined;
+type SafeGet<T> = T extends {
+    get: infer G;
+} ? G : undefined;
+type SafePathParams<T> = SafeGet<T> extends {
+    parameters: {
+        path: infer P;
+    };
+} ? P : undefined;
+type SafeQueryParams<T> = SafeGet<T> extends {
+    parameters: {
+        query: infer Q;
+    };
+} ? Q : SafeGet<T> extends {
+    parameters: {
+        query?: infer Q;
+    };
+} ? Q : undefined;
+type ParamsForEndpoint<T> = SafePathParams<T> & SafeQueryParams<T> extends undefined ? SafePathParams<T> : SafePathParams<T> & SafeQueryParams<T>;
+/**
+ * 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)
+ * ```
+ */
+export declare function callREST<Api extends APIMethods, P extends keyof APIPaths[Api]>(api: Api, endpoint: P, params?: ParamsForEndpoint<APIPaths[Api][P]>, timeout?: number, retry?: number): Promise<GetResponse<SafeGet<APIPaths[Api][P]>>>;
+/**
+ * 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)
+ */
+export declare const callWithQuorum: <T = any>(method: string, params?: any[] | object, quorum?: number) => Promise<T>;
+export {};
+//# sourceMappingURL=call.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"call.d.ts","sourceRoot":"","sources":["../../../src/helpers/call.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAgB,MAAM,UAAU,CAAA;AAK7D,qBAAa,QAAS,SAAQ,KAAK;IACjC,IAAI,SAAa;IACjB,IAAI,CAAC,EAAE,GAAG,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,SAAS,CAAY;gBAChB,QAAQ,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,GAAG,CAAA;KAAE;CAOpE;AA6MD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,OAAO,GAAU,CAAC,GAAG,GAAG,EACnC,QAAQ,MAAM,EACd,SAAQ,GAAG,EAAE,GAAG,MAAW,EAC3B,gBAAwB,EACxB,cAAoB,KACnB,OAAO,CAAC,CAAC,CA0CX,CAAA;AAID;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,GAAU,CAAC,GAAG,GAAG,EAC5C,QAAQ,MAAM,EACd,SAAQ,GAAG,EAAE,GAAG,MAAW,EAC3B,gBAAwB,KACvB,OAAO,CAAC,CAAC,CAuCX,CAAA;AAgBD,KAAK,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS;IAC9B,SAAS,EAAE;QAAE,KAAK,CAAC,EAAE;YAAE,OAAO,EAAE;gBAAE,kBAAkB,EAAE,MAAM,CAAC,CAAA;aAAE,CAAA;SAAE,CAAA;KAAE,CAAA;CACpE,GACG,CAAC,GACD,SAAS,CAAA;AACb,KAAK,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,GAAG,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,SAAS,CAAA;AAC5D,KAAK,cAAc,CAAC,CAAC,IACnB,OAAO,CAAC,CAAC,CAAC,SAAS;IACjB,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC,CAAA;KAAE,CAAA;CAC9B,GACG,CAAC,GACD,SAAS,CAAA;AACf,KAAK,eAAe,CAAC,CAAC,IACpB,OAAO,CAAC,CAAC,CAAC,SAAS;IACjB,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC,CAAA;KAAE,CAAA;CAC/B,GACG,CAAC,GACD,OAAO,CAAC,CAAC,CAAC,SAAS;IACf,UAAU,EAAE;QACV,KAAK,CAAC,EAAE,MAAM,CAAC,CAAA;KAChB,CAAA;CACF,GACD,CAAC,GACD,SAAS,CAAA;AACjB,KAAK,iBAAiB,CAAC,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,SAAS,SAAS,GAChF,cAAc,CAAC,CAAC,CAAC,GACjB,cAAc,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAA;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,QAAQ,CAAC,GAAG,SAAS,UAAU,EAAE,CAAC,SAAS,MAAM,QAAQ,CAAC,GAAG,CAAC,EAClF,GAAG,EAAE,GAAG,EACR,QAAQ,EAAE,CAAC,EACX,MAAM,CAAC,EAAE,iBAAiB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAC5C,OAAO,SAAiB,EACxB,KAAK,SAAe,GACnB,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAqFjD;AAID;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GAAU,CAAC,GAAG,GAAG,EAC1C,QAAQ,MAAM,EACd,SAAQ,GAAG,EAAE,GAAG,MAAW,EAC3B,eAAU,KACT,OAAO,CAAC,CAAC,CAuCX,CAAA"}