@ecency/hive-tx 7.1.0

package/dist/esm/helpers/aes.js

@@ -0,0 +1,81 @@
+import { ByteBuffer } from './ByteBuffer';
+import { cbc as AESCBC } from '@noble/ciphers/aes.js';
+import { secp256k1 } from '@noble/curves/secp256k1.js';
+import { sha256, sha512 } from '@noble/hashes/sha2.js';
+export const encrypt = (privateKey, publicKey, message, nonce = uniqueNonce()) => crypt(privateKey, publicKey, nonce, message);
+export const decrypt = (privateKey, publicKey, nonce, message, checksum) => {
+    const d = crypt(privateKey, publicKey, nonce, message, checksum);
+    return d.message;
+};
+/**
+ * @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(ByteBuffer.DEFAULT_CAPACITY, ByteBuffer.LITTLE_ENDIAN);
+    ebuf.writeUint64(nonceL);
+    ebuf.append(S);
+    ebuf.flip();
+    const encryptionKey = 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 = sha256(encryptionKey).subarray(0, 4);
+    const cbuf = new ByteBuffer(ByteBuffer.DEFAULT_CAPACITY, 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 = 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 = AESCBC(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
+ */
+export const cryptoJsEncrypt = (message, tag, iv) => {
+    let messageBuffer = message;
+    const cipher = AESCBC(tag, iv);
+    messageBuffer = cipher.encrypt(messageBuffer);
+    // return Uint8Array.from(messageBuffer)
+    return messageBuffer;
+};
+/** @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.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/esm/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/esm/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/esm/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"}