@ecency/hive-tx 7.1.0

package/dist/esm/Transaction.js

@@ -0,0 +1,195 @@
+import { bytesToHex, hexToBytes } from '@noble/hashes/utils.js';
+import { ByteBuffer } from './helpers/ByteBuffer';
+import { Serializer } from './helpers/serializer';
+import { sha256 } from '@noble/hashes/sha2.js';
+import { config } from './config';
+import { callRPC, callRPCBroadcast, RPCError } from './helpers/call';
+import { sleep } from './helpers/sleep';
+const chainId = hexToBytes(config.chain_id);
+export class Transaction {
+    constructor(options) {
+        this.expiration = 60000;
+        /**
+         * Creates the transaction structure and initializes it with blockchain data.
+         * Retrieves current head block information and sets up reference block data.
+         * @private
+         * @param expiration Transaction expiration in milliseconds
+         */
+        this.createTransaction = async (expiration) => {
+            const props = await callRPC('condenser_api.get_dynamic_global_properties', []);
+            const bytes = hexToBytes(props.head_block_id);
+            const refBlockPrefix = Number(new Uint32Array(bytes.buffer, bytes.byteOffset + 4, 1)[0]);
+            const expirationIso = new Date(Date.now() + expiration).toISOString().slice(0, -5);
+            this.transaction = {
+                expiration: expirationIso,
+                extensions: [],
+                operations: [],
+                ref_block_num: props.head_block_number & 0xffff,
+                ref_block_prefix: refBlockPrefix,
+                signatures: []
+            };
+        };
+        if (options?.transaction) {
+            if (options.transaction instanceof Transaction) {
+                this.transaction = options.transaction.transaction;
+                this.expiration = options.transaction.expiration;
+            }
+            else {
+                this.transaction = options.transaction;
+            }
+            this.txId = this.digest().txId;
+        }
+        if (options?.expiration) {
+            this.expiration = options.expiration;
+        }
+    }
+    /**
+     * Adds an operation to the transaction. If no transaction exists, creates one first.
+     * @template O Operation name type for type safety
+     * @param operationName The name/type of the operation to add (e.g., 'transfer', 'vote', 'comment')
+     * @param operationBody The operation data/body for the specified operation type
+     * @returns Promise that resolves when the operation is added
+     * @throws Error if transaction creation fails or global properties cannot be retrieved
+     */
+    async addOperation(operationName, operationBody) {
+        if (!this.transaction) {
+            await this.createTransaction(this.expiration);
+        }
+        this.transaction.operations.push([operationName, operationBody]);
+    }
+    /**
+     * Signs the transaction with the provided key(s), supporting both single and multi-signature transactions.
+     * For multi-signature, you can sign with all keys at once or sign individually by calling this method multiple times.
+     * @param keys Single PrivateKey or array of PrivateKeys to sign the transaction with
+     * @returns The signed transaction
+     * @throws Error if no transaction exists to sign
+     */
+    sign(keys) {
+        if (!this.transaction) {
+            throw new Error('First create a transaction by .addOperation()');
+        }
+        if (this.transaction) {
+            const { digest, txId } = this.digest();
+            if (!Array.isArray(keys)) {
+                keys = [keys];
+            }
+            for (const key of keys) {
+                const signature = key.sign(digest);
+                this.transaction.signatures.push(signature.customToString());
+            }
+            this.txId = txId;
+            return this.transaction;
+        }
+        else {
+            throw new Error('No transaction to sign');
+        }
+    }
+    /**
+     * Broadcasts the signed transaction to the Hive network.
+     * Automatically handles retries and duplicate transaction detection.
+     * @param checkStatus By default (false) the transaction is not guaranteed to be included in a block.
+     * For example the transaction can expire while waiting in mempool.
+     * If you pass true here, the function will wait for the transaction to be either included or dropped
+     * before returning a result.
+     * @returns Promise resolving to broadcast result
+     * @throws Error if no transaction exists or transaction is not signed or transaction got rejected
+     */
+    async broadcast(checkStatus = false) {
+        if (!this.transaction) {
+            throw new Error('Attempted to broadcast an empty transaction. Add operations by .addOperation()');
+        }
+        if (this.transaction.signatures.length === 0) {
+            throw new Error('Attempted to broadcast a transaction with no signatures. Sign using .sign(keys)');
+        }
+        try {
+            await callRPCBroadcast('condenser_api.broadcast_transaction', [this.transaction]);
+        }
+        catch (e) {
+            if (e instanceof RPCError && e.message.includes('Duplicate transaction check failed')) {
+                // ignore duplicate transaction error as this can happen when we retry the broadcast
+            }
+            else {
+                throw e;
+            }
+        }
+        if (!this.txId) {
+            this.txId = this.digest().txId;
+        }
+        if (!checkStatus) {
+            return { tx_id: this.txId, status: 'unknown' };
+        }
+        // Poll until the transaction reaches a final state or max attempts exceeded.
+        // With 60 attempts: delays grow from 1.3s to 19s, total wait ~10 minutes.
+        const maxPollAttempts = 60;
+        await sleep(1000);
+        let status = await this.checkStatus();
+        let i = 1;
+        while (status?.status !== 'within_irreversible_block' &&
+            status?.status !== 'expired_irreversible' &&
+            status?.status !== 'too_old' &&
+            i < maxPollAttempts) {
+            await sleep(1000 + i * 300);
+            status = await this.checkStatus();
+            i++;
+        }
+        return {
+            tx_id: this.txId,
+            status: (status?.status ?? 'unknown')
+        };
+    }
+    /**
+     * Returns the transaction digest containing the transaction ID and hash.
+     * The digest can be used to verify signatures and for transaction identification.
+     * @returns DigestData containing transaction ID and hash
+     * @throws Error if no transaction exists
+     */
+    digest() {
+        if (!this.transaction) {
+            throw new Error('First create a transaction by .addOperation()');
+        }
+        const buffer = new ByteBuffer(ByteBuffer.DEFAULT_CAPACITY, ByteBuffer.LITTLE_ENDIAN);
+        const temp = { ...this.transaction };
+        try {
+            Serializer.Transaction(buffer, temp);
+        }
+        catch (cause) {
+            throw new Error('Unable to serialize transaction: ' + cause);
+        }
+        buffer.flip();
+        const transactionData = new Uint8Array(buffer.toBuffer());
+        const txId = bytesToHex(sha256(transactionData)).slice(0, 40);
+        const digest = sha256(new Uint8Array([...chainId, ...transactionData]));
+        return { digest, txId };
+    }
+    /**
+     * Adds a signature to an already created transaction. Useful when signing with external tools.
+     * Multiple signatures can be added one at a time for multi-signature transactions.
+     * @param signature The signature string in hex format (must be exactly 130 characters)
+     * @returns The transaction with the added signature
+     * @throws Error if no transaction exists or signature format is invalid
+     */
+    addSignature(signature) {
+        if (!this.transaction) {
+            throw new Error('First create a transaction by .create(operations)');
+        }
+        if (typeof signature !== 'string') {
+            throw new Error('Signature must be string');
+        }
+        if (signature.length !== 130) {
+            throw new Error('Signature must be 130 characters long');
+        }
+        this.transaction.signatures.push(signature);
+        return this.transaction;
+    }
+    /** Get status of this transaction. Usually called internally after broadcasting. */
+    async checkStatus() {
+        if (!this.txId) {
+            this.txId = this.digest().txId;
+        }
+        return callRPC('transaction_status_api.find_transaction', {
+            transaction_id: this.txId,
+            expiration: this.transaction?.expiration
+        });
+    }
+}
+//# sourceMappingURL=Transaction.js.map

package/dist/esm/Transaction.js.map

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

package/dist/esm/config.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Configuration object for customizing hive-tx library behavior.
+ * Modify these values to change the default node endpoints, timeout, and other settings.
+ */
+export declare const config: {
+    /**
+     * Array of Hive API node endpoints for load balancing and failover.
+     * @default Array of multiple Hive API endpoints
+     */
+    nodes: string[];
+    /**
+     * Array Hive API node endpoints that support REST APIs
+     * Note: Without the trailing /
+     */
+    restNodes: string[];
+    /**
+     * The Hive blockchain chain ID for transaction signing and verification.
+     * @default Mainnet chain ID
+     */
+    chain_id: string;
+    /**
+     * Address prefix used for public key formatting (STM for mainnet).
+     * @default 'STM'
+     */
+    address_prefix: string;
+    /**
+     * Timeout in milliseconds for individual API calls.
+     * @default 10000
+     */
+    timeout: number;
+    /**
+     * Number of retry attempts for failed API calls before throwing an error.
+     * @default 8
+     */
+    retry: number;
+};
+//# sourceMappingURL=config.d.ts.map

package/dist/esm/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,MAAM;IACjB;;;OAGG;;IAWH;;;OAGG;;IASH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;CAEJ,CAAA"}

package/dist/esm/config.js

@@ -0,0 +1,51 @@
+/**
+ * Configuration object for customizing hive-tx library behavior.
+ * Modify these values to change the default node endpoints, timeout, and other settings.
+ */
+export const config = {
+    /**
+     * Array of Hive API node endpoints for load balancing and failover.
+     * @default Array of multiple Hive API endpoints
+     */
+    nodes: [
+        'https://api.hive.blog',
+        'https://api.deathwing.me',
+        'https://api.openhive.network',
+        'https://rpc.mahdiyari.info',
+        'https://techcoderx.com',
+        'https://hiveapi.actifit.io',
+        'https://api.c0ff33a.uk'
+    ],
+    /**
+     * Array Hive API node endpoints that support REST APIs
+     * Note: Without the trailing /
+     */
+    restNodes: [
+        'https://api.hive.blog',
+        'https://rpc.mahdiyari.info',
+        'https://techcoderx.com',
+        'https://hiveapi.actifit.io',
+        'https://api.c0ff33a.uk'
+    ],
+    /**
+     * The Hive blockchain chain ID for transaction signing and verification.
+     * @default Mainnet chain ID
+     */
+    chain_id: 'beeab0de00000000000000000000000000000000000000000000000000000000',
+    /**
+     * Address prefix used for public key formatting (STM for mainnet).
+     * @default 'STM'
+     */
+    address_prefix: 'STM',
+    /**
+     * Timeout in milliseconds for individual API calls.
+     * @default 10000
+     */
+    timeout: 10000,
+    /**
+     * Number of retry attempts for failed API calls before throwing an error.
+     * @default 8
+     */
+    retry: 8
+};
+//# sourceMappingURL=config.js.map

package/dist/esm/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB;;;OAGG;IACH,KAAK,EAAE;QACL,uBAAuB;QACvB,0BAA0B;QAC1B,8BAA8B;QAC9B,4BAA4B;QAC5B,wBAAwB;QACxB,4BAA4B;QAC5B,wBAAwB;KACzB;IAED;;;OAGG;IACH,SAAS,EAAE;QACT,uBAAuB;QACvB,4BAA4B;QAC5B,wBAAwB;QACxB,4BAA4B;QAC5B,wBAAwB;KACzB;IAED;;;OAGG;IACH,QAAQ,EAAE,kEAAkE;IAE5E;;;OAGG;IACH,cAAc,EAAE,KAAK;IAErB;;;OAGG;IACH,OAAO,EAAE,KAAM;IAEf;;;OAGG;IACH,KAAK,EAAE,CAAC;CACT,CAAA"}

package/dist/esm/helpers/Asset.d.ts

@@ -0,0 +1,21 @@
+/** Class representing a hive asset,
+ * e.g. `1.000 HIVE` or `12.112233 VESTS`. */
+export declare class Asset {
+    amount: number;
+    symbol: string;
+    constructor(amount: number, symbol: string);
+    /** Create a new Asset instance from a string, e.g. `42.000 HIVE`. */
+    static fromString(string: string, expectedSymbol?: string | null): Asset;
+    /**
+     * Convenience to create new Asset.
+     * @param symbol Symbol to use when created from number. Will also be used to validate
+     *               the asset, throws if the passed value has a different symbol than this.
+     */
+    static from(value: number | string | Asset, symbol?: string | null): Asset;
+    /** Return asset precision. */
+    getPrecision(): 3 | 6;
+    /** Return a string representation of this asset, e.g. `42.000 HIVE`. */
+    toString(): string;
+    toJSON(): string;
+}
+//# sourceMappingURL=Asset.d.ts.map

package/dist/esm/helpers/Asset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Asset.d.ts","sourceRoot":"","sources":["../../../src/helpers/Asset.ts"],"names":[],"mappings":"AAAA;6CAC6C;AAC7C,qBAAa,KAAK;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;gBAEF,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAK1C,qEAAqE;IACrE,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,GAAE,MAAM,GAAG,IAAW,GAAG,KAAK;IAe9E;;;;OAIG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,KAAK;IAiB1E,8BAA8B;IAC9B,YAAY;IAgBZ,wEAAwE;IACxE,QAAQ;IAIR,MAAM;CAGP"}

package/dist/esm/helpers/Asset.js

@@ -0,0 +1,70 @@
+/** Class representing a hive asset,
+ * e.g. `1.000 HIVE` or `12.112233 VESTS`. */
+export class Asset {
+    constructor(amount, symbol) {
+        this.amount = amount;
+        this.symbol = symbol === 'HIVE' ? 'STEEM' : symbol === 'HBD' ? 'SBD' : symbol;
+    }
+    /** Create a new Asset instance from a string, e.g. `42.000 HIVE`. */
+    static fromString(string, expectedSymbol = null) {
+        const [amountString, symbol] = string.split(' ');
+        if (['STEEM', 'VESTS', 'SBD', 'TESTS', 'TBD', 'HIVE', 'HBD'].indexOf(symbol) === -1) {
+            throw new Error(`Invalid asset symbol: ${symbol}`);
+        }
+        if (expectedSymbol && symbol !== expectedSymbol) {
+            throw new Error(`Invalid asset, expected symbol: ${expectedSymbol} got: ${symbol}`);
+        }
+        const amount = Number.parseFloat(amountString);
+        if (!Number.isFinite(amount)) {
+            throw new Error(`Invalid asset amount: ${amountString}`);
+        }
+        return new Asset(amount, symbol);
+    }
+    /**
+     * Convenience to create new Asset.
+     * @param symbol Symbol to use when created from number. Will also be used to validate
+     *               the asset, throws if the passed value has a different symbol than this.
+     */
+    static from(value, symbol) {
+        if (value instanceof Asset) {
+            if (symbol && value.symbol !== symbol) {
+                throw new Error(`Invalid asset, expected symbol: ${symbol} got: ${value.symbol}`);
+            }
+            return value;
+        }
+        else if (typeof value === 'number' && Number.isFinite(value)) {
+            return new Asset(value, symbol || 'STEEM');
+        }
+        else if (typeof value === 'string') {
+            return Asset.fromString(value, symbol);
+        }
+        else {
+            throw new Error(`Invalid asset '${String(value)}'`);
+        }
+    }
+    // We convert HIVE & HBD strings to STEEM & SBD because the serialization should be based on STEEM & SBD
+    /** Return asset precision. */
+    getPrecision() {
+        switch (this.symbol) {
+            case 'TESTS':
+            case 'TBD':
+            case 'STEEM':
+            case 'SBD':
+            case 'HBD':
+            case 'HIVE':
+                return 3;
+            case 'VESTS':
+                return 6;
+            default:
+                return 3;
+        }
+    }
+    /** Return a string representation of this asset, e.g. `42.000 HIVE`. */
+    toString() {
+        return `${this.amount.toFixed(this.getPrecision())} ${this.symbol}`;
+    }
+    toJSON() {
+        return this.toString();
+    }
+}
+//# sourceMappingURL=Asset.js.map

package/dist/esm/helpers/Asset.js.map

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

package/dist/esm/helpers/ByteBuffer.d.ts

@@ -0,0 +1,75 @@
+/**
+ * @license bytebuffer.ts (c) 2015 Daniel Wirtz <dcode@dcode.io>
+ * Backing buffer: ArrayBuffer, Accessor: DataView
+ * Released under the Apache License, Version 2.0
+ * see: https://github.com/dcodeIO/bytebuffer.ts for details
+ * modified by @xmcl/bytebuffer
+ * And customized for hive-tx
+ */
+export declare class ByteBuffer {
+    static LITTLE_ENDIAN: boolean;
+    static BIG_ENDIAN: boolean;
+    static DEFAULT_CAPACITY: number;
+    static DEFAULT_ENDIAN: boolean;
+    buffer: ArrayBufferLike;
+    view: DataView;
+    offset: number;
+    markedOffset: number;
+    limit: number;
+    littleEndian: boolean;
+    constructor(capacity?: number, littleEndian?: boolean);
+    static allocate(capacity?: number, littleEndian?: boolean): ByteBuffer;
+    static concat(buffers: Array<ByteBuffer | ArrayBuffer | Uint8Array | number[]>, littleEndian?: boolean): ByteBuffer;
+    static wrap(buffer: ByteBuffer | ArrayBuffer | Uint8Array | number[], littleEndian?: boolean): ByteBuffer;
+    writeBytes(source: ByteBuffer | ArrayBuffer | Uint8Array | number[], offset?: number): ByteBuffer;
+    writeInt8(value: number, offset?: number): ByteBuffer;
+    writeByte(value: number, offset?: number): ByteBuffer;
+    writeUint8(value: number, offset?: number): ByteBuffer;
+    writeUInt8(value: number, offset?: number): ByteBuffer;
+    readUint8(offset?: number): number;
+    readUInt8(offset?: number): number;
+    writeInt16(value: number, offset?: number): ByteBuffer;
+    writeShort(value: number, offset?: number): ByteBuffer;
+    writeUint16(value: number, offset?: number): ByteBuffer;
+    writeUInt16(value: number, offset?: number): ByteBuffer;
+    writeInt32(value: number, offset?: number): ByteBuffer;
+    writeInt(value: number, offset?: number): ByteBuffer;
+    writeUint32(value: number, offset?: number): ByteBuffer;
+    writeUInt32(value: number, offset?: number): ByteBuffer;
+    readUint32(offset?: number): number;
+    readUInt32: (offset?: number) => number;
+    append(source: ByteBuffer | ArrayBuffer | Uint8Array | number[], offset?: number): ByteBuffer;
+    clone(copy?: boolean): ByteBuffer;
+    copy(begin?: number, end?: number): ByteBuffer;
+    copyTo(target: ByteBuffer, targetOffset?: number, sourceOffset?: number, sourceLimit?: number): ByteBuffer;
+    ensureCapacity(capacity: number): ByteBuffer;
+    flip(): ByteBuffer;
+    resize(capacity: number): ByteBuffer;
+    skip(length: number): ByteBuffer;
+    writeInt64(value: number | bigint, offset?: number): ByteBuffer;
+    writeLong(value: number | bigint, offset?: number): ByteBuffer;
+    readInt64(offset?: number): bigint;
+    readLong(offset?: number): bigint;
+    writeUint64(value: number | bigint, offset?: number): ByteBuffer;
+    writeUInt64(value: number | bigint, offset?: number): ByteBuffer;
+    readUint64(offset?: number): bigint;
+    readUInt64(offset?: number): bigint;
+    toBuffer(forceCopy?: boolean): ArrayBufferLike;
+    toArrayBuffer(forceCopy?: boolean): ArrayBufferLike;
+    writeVarint32(value: number, offset?: number): ByteBuffer | number;
+    readVarint32(offset?: number): number | {
+        value: number;
+        length: number;
+    };
+    calculateVarint32(value: number): number;
+    writeVString(str: string, offset?: number): ByteBuffer | number;
+    readVString(offset?: number): string | {
+        string: string;
+        length: number;
+    };
+    readUTF8String(length: number, offset?: number): string | {
+        string: string;
+        length: number;
+    };
+}
+//# sourceMappingURL=ByteBuffer.d.ts.map

package/dist/esm/helpers/ByteBuffer.d.ts.map

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