@steemit/steem-js 1.0.14 → 1.0.16

package/dist/index.umd.js

@@ -17463,151 +17463,116 @@
 		validate: validate
 	});
 
+	/**
+	 * Registry of JSON-RPC methods exposed as steem.api.* helpers.
+	 *
+	 * Each entry's `api` field is the Steem node plugin namespace sent on the wire
+	 * (legacy HTTP transport uses JSON-RPC `call` with [api, method, params]).
+	 *
+	 * Routing policy (aligned with steemit/steem):
+	 * - condenser_api: legacy read helpers (get_accounts, get_content, discussions, …)
+	 * - database_api: chain/validation APIs still on the modern database_api plugin
+	 * - follow_api, network_broadcast_api, market_history_api, etc.: other plugins
+	 *
+	 * Methods removed from this list in v1.0.16 are no longer served by current nodes
+	 * (e.g. websocket subscriptions, category listings, proposed-transaction getters).
+	 */
 	const methods = [
 	    {
-	        api: 'database_api',
-	        method: 'set_subscribe_callback',
-	        params: ['callback', 'clearFilter']
-	    },
-	    {
-	        api: 'database_api',
-	        method: 'set_pending_transaction_callback',
-	        params: ['cb']
-	    },
-	    {
-	        api: 'database_api',
-	        method: 'set_block_applied_callback',
-	        params: ['cb']
-	    },
-	    {
-	        api: 'database_api',
-	        method: 'cancel_all_subscriptions'
-	    },
-	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_trending_tags',
 	        params: ['afterTag', 'limit']
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_tags_used_by_author',
 	        params: ['author']
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_post_discussions_by_payout',
 	        params: ['query']
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_comment_discussions_by_payout',
 	        params: ['query']
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_discussions_by_trending',
 	        params: ['query']
 	    },
 	    {
-	        api: 'database_api',
-	        method: 'get_discussions_by_trending30',
-	        params: ['query']
-	    },
-	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_discussions_by_created',
 	        params: ['query']
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_discussions_by_active',
 	        params: ['query']
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_discussions_by_cashout',
 	        params: ['query']
 	    },
 	    {
-	        api: 'database_api',
-	        method: 'get_discussions_by_payout',
-	        params: ['query']
-	    },
-	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_discussions_by_votes',
 	        params: ['query']
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_discussions_by_children',
 	        params: ['query']
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_discussions_by_hot',
 	        params: ['query']
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_discussions_by_feed',
 	        params: ['query']
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_discussions_by_blog',
 	        params: ['query']
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_discussions_by_comments',
 	        params: ['query']
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_discussions_by_promoted',
 	        params: ['query']
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_block_header',
 	        params: ['blockNum']
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_block',
 	        params: ['blockNum']
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_ops_in_block',
 	        params: ['blockNum', 'onlyVirtual']
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_state',
 	        params: ['path']
 	    },
-	    {
-	        api: 'database_api',
-	        method: 'get_trending_categories',
-	        params: ['after', 'limit']
-	    },
-	    {
-	        api: 'database_api',
-	        method: 'get_best_categories',
-	        params: ['after', 'limit']
-	    },
-	    {
-	        api: 'database_api',
-	        method: 'get_active_categories',
-	        params: ['after', 'limit']
-	    },
-	    {
-	        api: 'database_api',
-	        method: 'get_recent_categories',
-	        params: ['after', 'limit']
-	    },
 	    {
 	        api: 'database_api',
 	        method: 'get_config'
@@ -17617,7 +17582,7 @@
 	        method: 'get_dynamic_global_properties'
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_chain_properties'
 	    },
 	    {
@@ -17625,7 +17590,7 @@
 	        method: 'get_feed_history'
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_current_median_history_price'
 	    },
 	    {
@@ -17633,11 +17598,11 @@
 	        method: 'get_witness_schedule'
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_hardfork_version'
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_next_scheduled_hardfork'
 	    },
 	    {
@@ -17646,46 +17611,46 @@
 	        params: ['key']
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_accounts',
 	        params: ['names']
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_account_references',
 	        params: ['accountId']
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'lookup_account_names',
 	        params: ['accountNames']
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'lookup_accounts',
 	        params: ['lowerBoundName', 'limit']
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_account_count'
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_conversion_requests',
 	        params: ['accountName']
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_account_history',
 	        params: ['account', 'from', 'limit']
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_owner_history',
 	        params: ['account']
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_recovery_request',
 	        params: ['account']
 	    },
@@ -17735,42 +17700,27 @@
 	        params: ['author', 'permlink']
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_content',
 	        params: ['author', 'permlink']
 	    },
 	    {
-	        api: 'database_api',
-	        method: 'get_account_notifications',
-	        params: ['account', 'from', 'limit']
-	    },
-	    {
-	        api: 'database_api',
-	        method: 'get_account_reputation',
-	        params: ['account']
-	    },
-	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_escrow',
 	        params: ['from', 'escrowId']
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_withdraw_routes',
 	        params: ['account', 'withdrawRouteType']
 	    },
 	    {
-	        api: 'database_api',
-	        method: 'get_account_bandwidth',
-	        params: ['account', 'bandwidthType']
-	    },
-	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_savings_withdraw_from',
 	        params: ['account']
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_savings_withdraw_to',
 	        params: ['account']
 	    },
@@ -17780,22 +17730,17 @@
 	        params: ['limit']
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_open_orders',
 	        params: ['owner']
 	    },
-	    {
-	        api: 'database_api',
-	        method: 'get_liquidity_queue',
-	        params: ['startAccount', 'limit']
-	    },
 	    {
 	        api: 'database_api',
 	        method: 'get_transaction_hex',
 	        params: ['trx']
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_transaction',
 	        params: ['trxId']
 	    },
@@ -17820,52 +17765,52 @@
 	        params: ['nameOrId', 'signers']
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_active_votes',
 	        params: ['author', 'permlink']
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_account_votes',
 	        params: ['voter']
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_content_replies',
 	        params: ['author', 'permlink']
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_discussions_by_author_before_date',
 	        params: ['author', 'startPermlink', 'beforeDate', 'limit']
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_replies_by_last_update',
 	        params: ['startAuthor', 'startPermlink', 'limit']
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_witnesses',
 	        params: ['witnessIds']
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_witness_by_account',
 	        params: ['accountName']
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_witnesses_by_vote',
 	        params: ['from', 'limit']
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'lookup_witness_accounts',
 	        params: ['lowerBoundName', 'limit']
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_witness_count'
 	    },
 	    {
@@ -17873,16 +17818,12 @@
 	        method: 'get_active_witnesses'
 	    },
 	    {
-	        api: 'database_api',
-	        method: 'get_miner_queue'
-	    },
-	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_reward_fund',
 	        params: ['name']
 	    },
 	    {
-	        api: 'database_api',
+	        api: 'condenser_api',
 	        method: 'get_vesting_delegations',
 	        params: ['account', 'from', 'limit']
 	    },
@@ -18003,81 +17944,6 @@
 	        params: ['account'],
 	        is_object: true
 	    },
-	    {
-	        api: 'database_api',
-	        method: 'get_escrow_by_from',
-	        params: ['from', 'escrowId']
-	    },
-	    {
-	        api: 'database_api',
-	        method: 'get_escrow_by_to',
-	        params: ['to', 'escrowId']
-	    },
-	    {
-	        api: 'database_api',
-	        method: 'get_escrow_by_agent',
-	        params: ['agent', 'escrowId']
-	    },
-	    {
-	        api: 'database_api',
-	        method: 'get_account_bandwidth_by_type',
-	        params: ['account', 'bandwidthType']
-	    },
-	    {
-	        api: 'database_api',
-	        method: 'get_account_bandwidth_by_type_and_time',
-	        params: ['account', 'bandwidthType', 'time']
-	    },
-	    {
-	        api: 'database_api',
-	        method: 'get_proposed_transactions',
-	        params: ['account']
-	    },
-	    {
-	        api: 'database_api',
-	        method: 'get_proposed_transaction',
-	        params: ['account', 'proposalId']
-	    },
-	    {
-	        api: 'database_api',
-	        method: 'get_proposed_transaction_expirations',
-	        params: ['account']
-	    },
-	    {
-	        api: 'database_api',
-	        method: 'get_proposed_transaction_approvals',
-	        params: ['account']
-	    },
-	    {
-	        api: 'database_api',
-	        method: 'get_proposed_transaction_approvals_by_id',
-	        params: ['proposalId']
-	    },
-	    {
-	        api: 'database_api',
-	        method: 'get_proposed_transaction_approvals_by_account',
-	        params: ['account']
-	    },
-	    {
-	        api: 'database_api',
-	        method: 'get_proposed_transaction_approvals_by_account_and_id',
-	        params: ['account', 'proposalId']
-	    },
-	    {
-	        api: 'database_api',
-	        method: 'get_proposed_transaction_approvals_by_account_and_time',
-	        params: ['account', 'time']
-	    },
-	    {
-	        api: 'database_api',
-	        method: 'get_proposed_transaction_approvals_by_account_and_time_and_id',
-	        params: ['account', 'time', 'proposalId']
-	    },
-	    {
-	        api: 'database_api',
-	        method: 'get_proposed_transaction_approvals_by_account_and_time_and_id_and_approver',
-	        params: ['account', 'time', 'proposalId', 'approver']
-	    }
 	];
 
 	var retry$2 = {};
@@ -18496,6 +18362,10 @@
 	    isBroadcastOperation(method) {
 	        return this.nonRetriableOperations.includes(method);
 	    }
+	    /**
+	     * POST JSON-RPC to the node. Body uses method `call` with params [api, methodName, args]
+	     * for backwards compatibility with steemd; alternatively use Api.call('plugin.method', …).
+	     */
 	    send(api, data, callback) {
 	        if (typeof callback !== 'function') {
 	            callback = () => { };
@@ -26111,7 +25981,7 @@
 	    bb.writeUint16(dataObj.percent_steem_dollars ?? 0);
 	    serializeBool(bb, dataObj.allow_votes);
 	    serializeBool(bb, dataObj.allow_curation_rewards);
-	    serializeExtensions(bb, dataObj.extensions);
+	    serializeCommentOptionsExtensions(bb, dataObj.extensions);
 	}
 	/**
 	 * Serialize custom_json operation
@@ -26188,7 +26058,7 @@
 	 *
 	 * Format: int64 amount (little-endian) + uint8 precision + 7-byte symbol (UTF-8, null-padded).
 	 *
-	 * This helper is reused across all operations中涉及资产字段的地方，例如：
+	 * This helper is reused for asset fields across all operations, e.g.
 	 * - amount / vesting_shares / reward_* / *_pays
 	 */
 	function serializeAsset(bb, amount) {
@@ -26208,7 +26078,7 @@
 	}
 	/**
 	 * Write a string using ByteBuffer's writeVString method.
-	 * 所有字符串字段统一通过该 helper 序列化，避免直接到处调用 ByteBuffer API。
+	 * All string fields are serialized through this helper to avoid calling ByteBuffer API directly everywhere.
 	 */
 	function writeString(bb, str) {
 	    bb.writeVString(str);
@@ -26216,8 +26086,8 @@
 	/**
 	 * Serialize a time_point_sec-style field.
 	 *
-	 * 接受 ISO 字符串 / Date / 秒级数字，最终写入 uint32（自 epoch 起的秒数）。
-	 * 常用于 proposal start/end、escrow_deadline 等字段。
+	 * Accepts ISO string / Date / seconds number; writes uint32 (seconds since epoch).
+	 * Used for proposal start/end, escrow_deadline, and similar fields.
 	 */
 	function serializeTimePointSec(bb, value) {
 	    let seconds;
@@ -26230,7 +26100,7 @@
 	        seconds = Math.floor(value.getTime() / 1000);
 	    }
 	    else if (typeof value === 'number') {
-	        // 这里假定已是秒级时间戳
+	        // Assume value is already in seconds
 	        seconds = value;
 	    }
 	    else {
@@ -26240,29 +26110,61 @@
 	}
 	/**
 	 * Serialize a generic bool flag as uint8(0/1).
-	 * 后续在多处 optional / approve / decline 字段可统一复用。
+	 * Reused for optional / approve / decline and similar fields.
 	 */
 	function serializeBool(bb, value) {
 	    bb.writeUint8(value ? 1 : 0);
 	}
 	/**
-	 * Serialize a future_extensions / extensions 风格字段。
+	 * Serialize comment_options extensions (flat_set<comment_options_extension>).
+	 * Used only for comment_options operation. Supports tag 0 (comment_payout_beneficiaries).
+	 * Beneficiaries are sorted alphabetically by account name before encoding to satisfy Steem protocol.
+	 * Other extension tags are skipped; only tag 0 is serialized.
+	 */
+	function serializeCommentOptionsExtensions(bb, extensions) {
+	    if (!Array.isArray(extensions) || extensions.length === 0) {
+	        bb.writeVarint32(0);
+	        return;
+	    }
+	    // Only serialize tag 0 (comment_payout_beneficiaries); skip unknown tags
+	    const supported = extensions.filter((ext) => {
+	        const tag = Array.isArray(ext) && ext.length >= 1 ? Number(ext[0]) : -1;
+	        return tag === 0;
+	    });
+	    bb.writeVarint32(supported.length);
+	    for (const ext of supported) {
+	        const tag = ext[0];
+	        const value = ext[1];
+	        bb.writeVarint32(tag);
+	        if (tag === 0) {
+	            const beneficiaries = Array.isArray(value?.beneficiaries) ? value.beneficiaries.slice() : [];
+	            beneficiaries.sort((a, b) => String(a.account).localeCompare(String(b.account)));
+	            bb.writeVarint32(beneficiaries.length);
+	            for (const b of beneficiaries) {
+	                writeString(bb, String(b.account ?? ''));
+	                bb.writeUint16(Number(b.weight) & 0xffff);
+	            }
+	        }
+	    }
+	}
+	/**
+	 * Serialize a future_extensions / extensions-style field.
 	 *
-	 * 目前大多数链上交易中 extensions 仍为空集合，协议格式是：
+	 * For most on-chain transactions extensions are still an empty set. Protocol format:
 	 * - varint32 length
-	 * - 后续按约定序列化各元素（当前实现仅支持空或简单 JSON 字符串）
+	 * - then each element serialized per convention (current implementation supports empty only).
 	 *
-	 * 为兼容现有使用场景，这里暂时只写入长度，忽略实际内容；当需要支持
-	 * 具体 extension 类型时，可以在保持签名兼容性的前提下扩展实现。
+	 * To stay compatible with existing usage, we only write length 0 and ignore content here;
+	 * when supporting specific extension types, extend this after verification.
 	 */
 	function serializeExtensions(bb, extensions) {
 	    if (!Array.isArray(extensions) || extensions.length === 0) {
 	        bb.writeVarint32(0);
 	        return;
 	    }
-	    // 协议上 extensions 是 future_extensions，目前主网基本为 0。
-	    // 为避免序列化出与 C++ 节点不兼容的数据，这里保守起见仍写入 0。
-	    // 如果未来需要支持非空 extensions，可在测试验证后放开以下逻辑：
+	    // Protocol-wise extensions are future_extensions; on mainnet they are typically 0.
+	    // To avoid serializing data incompatible with C++ nodes, we still write 0 conservatively.
+	    // To support non-empty extensions in the future, enable the logic below after tests:
 	    //
 	    // bb.writeVarint32(extensions.length);
 	    // for (const ext of extensions) {
@@ -26574,6 +26476,7 @@
 	        this._setTransport(options);
 	        this._setLogger(options);
 	        this.options = options;
+	        // Register steem.api.* from src/api/methods.ts; each call uses method.api as the RPC namespace.
 	        methods.forEach(method => {
 	            const methodName = method.method_name || camelCase(method.method);
 	            const methodParams = method.params || [];
@@ -26707,6 +26610,11 @@
 	        }
 	        return this.transport.stop();
 	    }
+	    /**
+	     * Send a JSON-RPC request via the active transport.
+	     * HTTP uses the legacy `call` wrapper: params are [apiNamespace, methodName, args].
+	     * @param api Plugin namespace (e.g. condenser_api, database_api)
+	     */
 	    send(api, data, callback) {
 	        let cb = callback;
 	        if (this.__logger) {
@@ -27240,7 +27148,8 @@
 	        });
 	    }
 	    /**
-	     * Verify transaction authority.
+	     * Verify transaction authority (database_api.verify_authority on the node).
+	     * Prefer verifyAuthorityAsync; dynamically generated helpers also exist from methods.ts.
 	     * @param trx Transaction object to verify
 	     * @param callback Optional callback function
 	     * @returns Promise with verification result if no callback provided
@@ -27275,7 +27184,7 @@
 	        });
 	    }
 	    /**
-	     * Verify account authority.
+	     * Verify account authority (database_api.verify_account_authority on the node).
 	     * @param nameOrId Account name or ID
 	     * @param signers Array of signer public keys
 	     * @param callback Optional callback function
@@ -29351,7 +29260,7 @@
 	    operations,
 	    utils: utils$n,
 	    ...crypto$1,
-	    version: '1.0.14',
+	    version: '1.0.16',
 	    config: {
 	        set: (options) => {
 	            // If nodes is provided, extract the first node as url for API