zattera-js 0.1.0

package/dist/node/client/index.js

@@ -0,0 +1,838 @@
+import { generateChainId } from "../utils/chain-id.js";
+class ZatteraClient {
+  endpoint;
+  chainId;
+  timeout;
+  retries;
+  requestId;
+  constructor(config) {
+    this.endpoint = config.endpoint;
+    this.chainId = generateChainId(config.networkName || "zattera");
+    this.timeout = config.timeout ?? 3e4;
+    this.retries = config.retries ?? 3;
+    this.requestId = 0;
+  }
+  getNextId() {
+    return ++this.requestId;
+  }
+  /**
+   * Get the configured chain ID
+   */
+  getChainId() {
+    return this.chainId;
+  }
+  /**
+   * Internal method to make JSON-RPC 2.0 requests with retry logic
+   */
+  async request(method, params = {}) {
+    const request = {
+      jsonrpc: "2.0",
+      method,
+      params,
+      id: this.getNextId()
+    };
+    let lastError = null;
+    for (let attempt = 0; attempt <= this.retries; attempt++) {
+      try {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        const response = await fetch(this.endpoint, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json"
+          },
+          body: JSON.stringify(request),
+          signal: controller.signal
+        });
+        clearTimeout(timeoutId);
+        if (!response.ok) {
+          throw new Error(`HTTP error! status: ${response.status}`);
+        }
+        const data = await response.json();
+        if (data.error) {
+          throw new Error(
+            `RPC error ${data.error.code}: ${data.error.message}`
+          );
+        }
+        if (data.result === void 0) {
+          throw new Error("No result in RPC response");
+        }
+        return data.result;
+      } catch (error) {
+        lastError = error instanceof Error ? error : new Error(String(error));
+        if (attempt < this.retries) {
+          await new Promise(
+            (resolve) => setTimeout(resolve, 1e3 * Math.pow(2, attempt))
+          );
+        }
+      }
+    }
+    throw lastError ?? new Error("Request failed");
+  }
+  /**
+   * Make batch JSON-RPC requests
+   */
+  async batch(requests) {
+    const batchRequest = requests.map((req) => ({
+      jsonrpc: "2.0",
+      method: req.method,
+      params: req.params ?? {},
+      id: this.getNextId()
+    }));
+    let lastError = null;
+    for (let attempt = 0; attempt <= this.retries; attempt++) {
+      try {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        const response = await fetch(this.endpoint, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json"
+          },
+          body: JSON.stringify(batchRequest),
+          signal: controller.signal
+        });
+        clearTimeout(timeoutId);
+        if (!response.ok) {
+          throw new Error(`HTTP error! status: ${response.status}`);
+        }
+        const data = await response.json();
+        return data.map((item) => {
+          if (item.error) {
+            throw new Error(
+              `RPC error ${item.error.code}: ${item.error.message}`
+            );
+          }
+          if (item.result === void 0) {
+            throw new Error("No result in RPC response");
+          }
+          return item.result;
+        });
+      } catch (error) {
+        lastError = error instanceof Error ? error : new Error(String(error));
+        if (attempt < this.retries) {
+          await new Promise(
+            (resolve) => setTimeout(resolve, 1e3 * Math.pow(2, attempt))
+          );
+        }
+      }
+    }
+    throw lastError ?? new Error("Batch request failed");
+  }
+  // ============================================================================
+  // Generic RPC Call
+  // ============================================================================
+  /**
+   * Generic RPC call method for custom or new API methods
+   */
+  async call(method, params = {}) {
+    return this.request(method, params);
+  }
+  // ============================================================================
+  // Database API - Global Properties
+  // ============================================================================
+  /**
+   * Get compile-time chain configuration constants
+   */
+  async getConfig() {
+    return this.request("database_api.get_config", {});
+  }
+  /**
+   * Get current dynamic global properties (head block, supply, etc.)
+   */
+  async getDynamicGlobalProperties() {
+    return this.request(
+      "database_api.get_dynamic_global_properties",
+      {}
+    );
+  }
+  /**
+   * Get active witness schedule
+   */
+  async getWitnessSchedule() {
+    return this.request(
+      "database_api.get_witness_schedule",
+      {}
+    );
+  }
+  /**
+   * Get hardfork properties and version information
+   */
+  async getHardforkProperties() {
+    return this.request(
+      "database_api.get_hardfork_properties",
+      {}
+    );
+  }
+  /**
+   * Get reward fund details
+   */
+  async getRewardFunds() {
+    const result = await this.request("database_api.get_reward_funds", {});
+    return result.funds;
+  }
+  /**
+   * Get current median price feed
+   */
+  async getCurrentPriceFeed() {
+    return this.request(
+      "database_api.get_current_price_feed",
+      {}
+    );
+  }
+  /**
+   * Get price feed history
+   */
+  async getFeedHistory() {
+    return this.request("database_api.get_feed_history", {});
+  }
+  // ============================================================================
+  // Database API - Witnesses
+  // ============================================================================
+  /**
+   * List witnesses by specified order
+   */
+  async listWitnesses(params) {
+    const result = await this.request("database_api.list_witnesses", params);
+    return result.witnesses;
+  }
+  /**
+   * Find specific witnesses by account names
+   */
+  async findWitnesses(owners) {
+    const result = await this.request("database_api.find_witnesses", {
+      owners
+    });
+    return result.witnesses;
+  }
+  /**
+   * List witness votes
+   */
+  async listWitnessVotes(start, limit, order) {
+    return this.request("database_api.list_witness_votes", {
+      start,
+      limit,
+      order
+    });
+  }
+  /**
+   * Get currently active witnesses
+   */
+  async getActiveWitnesses() {
+    const result = await this.request(
+      "database_api.get_active_witnesses",
+      {}
+    );
+    return result.witnesses;
+  }
+  // ============================================================================
+  // Database API - Accounts
+  // ============================================================================
+  /**
+   * List accounts by specified order
+   */
+  async listAccounts(params) {
+    const result = await this.request("database_api.list_accounts", params);
+    return result.accounts;
+  }
+  /**
+   * Find specific accounts by names
+   */
+  async findAccounts(params) {
+    const result = await this.request("database_api.find_accounts", params);
+    return result.accounts;
+  }
+  /**
+   * List account owner authority change history
+   */
+  async listOwnerHistories(start, limit) {
+    return this.request(
+      "database_api.list_owner_histories",
+      { start, limit }
+    );
+  }
+  /**
+   * Find owner history for specific account
+   */
+  async findOwnerHistories(owner) {
+    return this.request(
+      "database_api.find_owner_histories",
+      { owner }
+    );
+  }
+  /**
+   * List account recovery requests
+   */
+  async listAccountRecoveryRequests(start, limit, order) {
+    return this.request(
+      "database_api.list_account_recovery_requests",
+      { start, limit, order }
+    );
+  }
+  /**
+   * Find account recovery requests
+   */
+  async findAccountRecoveryRequests(accounts) {
+    return this.request(
+      "database_api.find_account_recovery_requests",
+      { accounts }
+    );
+  }
+  /**
+   * List escrows
+   */
+  async listEscrows(start, limit, order) {
+    return this.request("database_api.list_escrows", {
+      start,
+      limit,
+      order
+    });
+  }
+  /**
+   * Find escrows
+   */
+  async findEscrows(from) {
+    return this.request("database_api.find_escrows", { from });
+  }
+  /**
+   * List vesting delegations
+   */
+  async listVestingDelegations(start, limit, order) {
+    return this.request(
+      "database_api.list_vesting_delegations",
+      { start, limit, order }
+    );
+  }
+  /**
+   * Find vesting delegations
+   */
+  async findVestingDelegations(account) {
+    return this.request(
+      "database_api.find_vesting_delegations",
+      { account }
+    );
+  }
+  /**
+   * List SBD conversion requests
+   */
+  async listDollarConversionRequests(start, limit, order) {
+    return this.request(
+      "database_api.list_dollar_conversion_requests",
+      { start, limit, order }
+    );
+  }
+  /**
+   * Find SBD conversion requests
+   */
+  async findDollarConversionRequests(account) {
+    return this.request(
+      "database_api.find_dollar_conversion_requests",
+      { account }
+    );
+  }
+  // ============================================================================
+  // Database API - Comments
+  // ============================================================================
+  /**
+   * List comments by specified order
+   */
+  async listComments(start, limit, order) {
+    return this.request("database_api.list_comments", {
+      start,
+      limit,
+      order
+    });
+  }
+  /**
+   * Find specific comments
+   */
+  async findComments(comments) {
+    return this.request("database_api.find_comments", {
+      comments
+    });
+  }
+  /**
+   * List votes
+   */
+  async listVotes(start, limit, order) {
+    return this.request("database_api.list_votes", {
+      start,
+      limit,
+      order
+    });
+  }
+  /**
+   * Find specific votes
+   */
+  async findVotes(author, permlink) {
+    return this.request("database_api.find_votes", {
+      author,
+      permlink
+    });
+  }
+  // ============================================================================
+  // Database API - Market
+  // ============================================================================
+  /**
+   * List limit orders
+   */
+  async listLimitOrders(start, limit, order) {
+    return this.request("database_api.list_limit_orders", {
+      start,
+      limit,
+      order
+    });
+  }
+  /**
+   * Find limit orders
+   */
+  async findLimitOrders(account) {
+    return this.request("database_api.find_limit_orders", {
+      account
+    });
+  }
+  /**
+   * Get current order book
+   */
+  async getOrderBook(limit = 50) {
+    return this.request("database_api.get_order_book", {
+      limit
+    });
+  }
+  // ============================================================================
+  // Database API - Authority & Validation
+  // ============================================================================
+  /**
+   * Get transaction as hex string
+   */
+  async getTransactionHex(trx) {
+    return this.request("database_api.get_transaction_hex", { trx });
+  }
+  /**
+   * Get required signatures for transaction
+   */
+  async getRequiredSignatures(trx, availableKeys) {
+    return this.request(
+      "database_api.get_required_signatures",
+      { trx, available_keys: availableKeys }
+    );
+  }
+  /**
+   * Get all potential signatures for transaction
+   */
+  async getPotentialSignatures(trx) {
+    return this.request(
+      "database_api.get_potential_signatures",
+      { trx }
+    );
+  }
+  /**
+   * Verify transaction has required authority
+   */
+  async verifyAuthority(trx) {
+    return this.request(
+      "database_api.verify_authority",
+      { trx }
+    );
+  }
+  /**
+   * Verify account has authority from signers
+   */
+  async verifyAccountAuthority(account, signers) {
+    return this.request(
+      "database_api.verify_account_authority",
+      { account, signers }
+    );
+  }
+  /**
+   * Verify arbitrary signatures
+   */
+  async verifySignatures(hash, signatures, requiredOwner, requiredActive, requiredPosting, requiredOther) {
+    return this.request(
+      "database_api.verify_signatures",
+      {
+        hash,
+        signatures,
+        required_owner: requiredOwner,
+        required_active: requiredActive,
+        required_posting: requiredPosting,
+        required_other: requiredOther
+      }
+    );
+  }
+  // ============================================================================
+  // Network Broadcast API
+  // ============================================================================
+  /**
+   * Broadcast transaction to the network
+   */
+  async broadcastTransaction(trx, maxBlockAge = -1) {
+    return this.request(
+      "network_broadcast_api.broadcast_transaction",
+      { trx, max_block_age: maxBlockAge }
+    );
+  }
+  /**
+   * Broadcast block to the network
+   */
+  async broadcastBlock(block) {
+    return this.request("network_broadcast_api.broadcast_block", {
+      block
+    });
+  }
+  // ============================================================================
+  // Block API
+  // ============================================================================
+  /**
+   * Get block header by block number
+   */
+  async getBlockHeader(blockNum) {
+    const result = await this.request("block_api.get_block_header", {
+      block_num: blockNum
+    });
+    return result.header;
+  }
+  /**
+   * Get full block by block number
+   */
+  async getBlock(blockNum) {
+    const result = await this.request("block_api.get_block", {
+      block_num: blockNum
+    });
+    return result.block;
+  }
+  // ============================================================================
+  // Account History API
+  // ============================================================================
+  /**
+   * Get operations in a specific block
+   */
+  async getOpsInBlock(params) {
+    return this.request("account_history_api.get_ops_in_block", params);
+  }
+  /**
+   * Get transaction by ID
+   */
+  async getTransaction(id) {
+    return this.request(
+      "account_history.get_transaction",
+      { id }
+    );
+  }
+  /**
+   * Get account operation history
+   */
+  async getAccountHistory(params) {
+    return this.request(
+      "account_history.get_account_history",
+      params
+    );
+  }
+  /**
+   * Enumerate virtual operations in block range
+   */
+  async enumVirtualOps(blockRangeBegin, blockRangeEnd) {
+    return this.request("account_history_api.enum_virtual_ops", {
+      block_range_begin: blockRangeBegin,
+      block_range_end: blockRangeEnd
+    });
+  }
+  // ============================================================================
+  // Tags/Discussion API
+  // ============================================================================
+  /**
+   * Get trending tags
+   */
+  async getTrendingTags(startTag = "", limit = 100) {
+    const result = await this.request("tags_api.get_trending_tags", {
+      start_tag: startTag,
+      limit
+    });
+    return result.tags;
+  }
+  /**
+   * Get tags used by author
+   */
+  async getTagsUsedByAuthor(author) {
+    return this.request("tags_api.get_tags_used_by_author", {
+      author
+    });
+  }
+  /**
+   * Get single discussion/post
+   */
+  async getDiscussion(author, permlink) {
+    return this.request("tags_api.get_discussion", {
+      author,
+      permlink
+    });
+  }
+  /**
+   * Get replies to a post
+   */
+  async getContentReplies(author, permlink) {
+    const result = await this.request("tags_api.get_content_replies", {
+      author,
+      permlink
+    });
+    return result.discussions;
+  }
+  /**
+   * Get discussions by trending
+   */
+  async getDiscussionsByTrending(query) {
+    return this.request("tags_api.get_discussions_by_trending", query);
+  }
+  /**
+   * Get discussions by creation time
+   */
+  async getDiscussionsByCreated(query) {
+    return this.request("tags_api.get_discussions_by_created", query);
+  }
+  /**
+   * Get discussions by activity
+   */
+  async getDiscussionsByActive(query) {
+    return this.request("tags_api.get_discussions_by_active", query);
+  }
+  /**
+   * Get discussions by cashout time
+   */
+  async getDiscussionsByCashout(query) {
+    return this.request("tags_api.get_discussions_by_cashout", query);
+  }
+  /**
+   * Get discussions by votes
+   */
+  async getDiscussionsByVotes(query) {
+    return this.request("tags_api.get_discussions_by_votes", query);
+  }
+  /**
+   * Get discussions by children count
+   */
+  async getDiscussionsByChildren(query) {
+    return this.request("tags_api.get_discussions_by_children", query);
+  }
+  /**
+   * Get hot discussions
+   */
+  async getDiscussionsByHot(query) {
+    return this.request("tags_api.get_discussions_by_hot", query);
+  }
+  /**
+   * Get discussions from follower feed
+   */
+  async getDiscussionsByFeed(query) {
+    return this.request("tags_api.get_discussions_by_feed", query);
+  }
+  /**
+   * Get discussions from blog
+   */
+  async getDiscussionsByBlog(query) {
+    return this.request("tags_api.get_discussions_by_blog", query);
+  }
+  /**
+   * Get discussions by comment count
+   */
+  async getDiscussionsByComments(query) {
+    return this.request("tags_api.get_discussions_by_comments", query);
+  }
+  /**
+   * Get promoted discussions
+   */
+  async getDiscussionsByPromoted(query) {
+    return this.request("tags_api.get_discussions_by_promoted", query);
+  }
+  /**
+   * Get active votes on a post
+   */
+  async getActiveVotes(author, permlink) {
+    return this.request("tags_api.get_active_votes", {
+      author,
+      permlink
+    });
+  }
+  // ============================================================================
+  // Follow API
+  // ============================================================================
+  /**
+   * Get followers of an account
+   */
+  async getFollowers(params) {
+    const result = await this.request("follow_api.get_followers", params);
+    return result.followers;
+  }
+  /**
+   * Get accounts that an account is following
+   */
+  async getFollowing(params) {
+    const result = await this.request("follow_api.get_following", params);
+    return result.following;
+  }
+  /**
+   * Get follower and following counts
+   */
+  async getFollowCount(account) {
+    return this.request("follow_api.get_follow_count", { account });
+  }
+  /**
+   * Get feed entries
+   */
+  async getFeedEntries(account, startEntryId = 0, limit = 100) {
+    return this.request("follow_api.get_feed_entries", {
+      account,
+      start_entry_id: startEntryId,
+      limit
+    });
+  }
+  /**
+   * Get feed with full comments
+   */
+  async getFeed(account, startEntryId = 0, limit = 100) {
+    return this.request("follow_api.get_feed", {
+      account,
+      start_entry_id: startEntryId,
+      limit
+    });
+  }
+  /**
+   * Get blog entries
+   */
+  async getBlogEntries(account, startEntryId = 0, limit = 100) {
+    return this.request("follow_api.get_blog_entries", {
+      account,
+      start_entry_id: startEntryId,
+      limit
+    });
+  }
+  /**
+   * Get blog with full comments
+   */
+  async getBlog(account, startEntryId = 0, limit = 100) {
+    return this.request("follow_api.get_blog", {
+      account,
+      start_entry_id: startEntryId,
+      limit
+    });
+  }
+  /**
+   * Get account reputation scores
+   */
+  async getAccountReputations(accountLowerBound = "", limit = 100) {
+    return this.request("follow_api.get_account_reputations", {
+      account_lower_bound: accountLowerBound,
+      limit
+    });
+  }
+  /**
+   * Get accounts that reblogged a post
+   */
+  async getRebloggedBy(author, permlink) {
+    return this.request("follow_api.get_reblogged_by", {
+      author,
+      permlink
+    });
+  }
+  /**
+   * Get blog author statistics
+   */
+  async getBlogAuthors(blogAccount) {
+    return this.request("follow_api.get_blog_authors", {
+      blog_account: blogAccount
+    });
+  }
+  // ============================================================================
+  // Market History API
+  // ============================================================================
+  /**
+   * Get market ticker
+   */
+  async getTicker() {
+    return this.request("market_history_api.get_ticker", {});
+  }
+  /**
+   * Get market volume
+   */
+  async getVolume() {
+    return this.request("market_history_api.get_volume", {});
+  }
+  /**
+   * Get market order book
+   */
+  async getMarketOrderBook(limit = 50) {
+    return this.request("market_history_api.get_order_book", {
+      limit
+    });
+  }
+  /**
+   * Get trade history
+   */
+  async getTradeHistory(start, end, limit = 100) {
+    return this.request("market_history_api.get_trade_history", {
+      start,
+      end,
+      limit
+    });
+  }
+  /**
+   * Get recent trades
+   */
+  async getRecentTrades(limit = 100) {
+    return this.request("market_history_api.get_recent_trades", {
+      limit
+    });
+  }
+  /**
+   * Get market history buckets
+   */
+  async getMarketHistory(bucketSeconds, start, end) {
+    return this.request(
+      "market_history_api.get_market_history",
+      {
+        bucket_seconds: bucketSeconds,
+        start,
+        end
+      }
+    );
+  }
+  /**
+   * Get available bucket sizes
+   */
+  async getMarketHistoryBuckets() {
+    const result = await this.request(
+      "market_history_api.get_market_history_buckets",
+      {}
+    );
+    return result.bucket_sizes;
+  }
+  // ============================================================================
+  // Account By Key API
+  // ============================================================================
+  /**
+   * Get accounts that can sign with given public keys
+   */
+  async getKeyReferences(keys) {
+    return this.request("account_by_key_api.get_key_references", {
+      keys
+    });
+  }
+  // ============================================================================
+  // JSON-RPC Meta API
+  // ============================================================================
+  /**
+   * Get list of all available RPC methods
+   */
+  async getMethods() {
+    return this.request("jsonrpc.get_methods", {});
+  }
+  /**
+   * Get signature (parameters and return type) for an RPC method
+   */
+  async getSignature(method) {
+    return this.request("jsonrpc.get_signature", { method });
+  }
+}
+export {
+  ZatteraClient
+};
+//# sourceMappingURL=index.js.map