@steemit/steem-js 1.0.14 → 1.0.16

package/dist/index.cjs

@@ -14728,151 +14728,116 @@ var rpcAuth = /*#__PURE__*/Object.freeze({
     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'
@@ -14882,7 +14847,7 @@ const methods = [
         method: 'get_dynamic_global_properties'
     },
     {
-        api: 'database_api',
+        api: 'condenser_api',
         method: 'get_chain_properties'
     },
     {
@@ -14890,7 +14855,7 @@ const methods = [
         method: 'get_feed_history'
     },
     {
-        api: 'database_api',
+        api: 'condenser_api',
         method: 'get_current_median_history_price'
     },
     {
@@ -14898,11 +14863,11 @@ const methods = [
         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'
     },
     {
@@ -14911,46 +14876,46 @@ const methods = [
         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']
     },
@@ -15000,42 +14965,27 @@ const methods = [
         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']
     },
@@ -15045,22 +14995,17 @@ const methods = [
         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']
     },
@@ -15085,52 +15030,52 @@ const methods = [
         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'
     },
     {
@@ -15138,16 +15083,12 @@ const methods = [
         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']
     },
@@ -15268,81 +15209,6 @@ const methods = [
         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 = {};
@@ -15786,6 +15652,10 @@ class HttpTransport extends BaseTransport {
     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 = () => { };
@@ -23117,7 +22987,7 @@ function serializeCommentOptions(bb, data) {
     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
@@ -23194,7 +23064,7 @@ function serializeAuthority(bb, auth) {
  *
  * 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) {
@@ -23214,7 +23084,7 @@ function serializeAsset(bb, amount) {
 }
 /**
  * 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);
@@ -23222,8 +23092,8 @@ function writeString(bb, str) {
 /**
  * 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;
@@ -23236,7 +23106,7 @@ function serializeTimePointSec(bb, value) {
         seconds = Math.floor(value.getTime() / 1000);
     }
     else if (typeof value === 'number') {
-        // 这里假定已是秒级时间戳
+        // Assume value is already in seconds
         seconds = value;
     }
     else {
@@ -23246,29 +23116,61 @@ function serializeTimePointSec(bb, value) {
 }
 /**
  * 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) {
@@ -23580,6 +23482,7 @@ class Api extends events.EventEmitter {
         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 || [];
@@ -23713,6 +23616,11 @@ class Api extends events.EventEmitter {
         }
         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) {
@@ -24246,7 +24154,8 @@ class Api extends events.EventEmitter {
         });
     }
     /**
-     * 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
@@ -24281,7 +24190,7 @@ class Api extends events.EventEmitter {
         });
     }
     /**
-     * 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
@@ -26344,7 +26253,7 @@ const steem = {
     memo,
     operations,
     utils: utils$3,
-    version: '1.0.14',
+    version: '1.0.16',
     config: {
         set: (options) => {
             // If nodes is provided, extract the first node as url for API