Add utils module with script to display top address balances

* feat: add utils module, get first balances

* fix: add dummy node balance for now

* fix: consider block height

* feat: allow querying node addr balance by block height

* feat: query nodes for balances via RPC

* feat: calculate absolute balance delta

* fix: consider locked node balance

* fix: ignore utils dir on main lint config

* chore: print usage

Author: rafaelcr

.eslintignore

@@ -15,3 +15,4 @@ src/tests-rosetta-cli/
 src/tests-bns/
 client/src/
 config/
+utils/src/

.eslintrc.js

@@ -9,7 +9,7 @@ module.exports = {
     ecmaVersion: 2020,
     sourceType: 'module',
   },
-  ignorePatterns: ['lib/*', 'client/*'],
+  ignorePatterns: ['lib/*', 'client/*', 'utils/*'],
   rules: {
     'prettier/prettier': 'error',
 

src/core-rpc/client.ts

@@ -8,6 +8,7 @@ export interface CoreRpcAccountInfo {
   balance: string;
   /** Hex-prefixed binary blob. */
   balance_proof: string;
+  locked: string;
   nonce: number;
   /** Hex-prefixed binary blob. */
   nonce_proof: string;
@@ -150,7 +151,11 @@ export class StacksCoreRpcClient {
     return result;
   }
 
-  async getAccount(principal: string, atUnanchoredChainTip = false): Promise<CoreRpcAccountInfo> {
+  async getAccount(
+    principal: string,
+    atUnanchoredChainTip = false,
+    indexBlockHash?: string
+  ): Promise<CoreRpcAccountInfo> {
     const requestOpts: RequestOpts = {
       method: 'GET',
       queryParams: {
@@ -160,6 +165,8 @@ export class StacksCoreRpcClient {
     if (atUnanchoredChainTip) {
       const info = await this.getInfo();
       requestOpts.queryParams!.tip = info.unanchored_tip;
+    } else if (indexBlockHash) {
+      requestOpts.queryParams!.tip = indexBlockHash;
     }
     const result = await this.fetchJson<CoreRpcAccountInfo>(
       `v2/accounts/${principal}`,

utils/.eslintrc.js

@@ -0,0 +1,19 @@
+module.exports = {
+  root: true,
+  extends: ['@stacks/eslint-config', 'prettier'],
+  parser: '@typescript-eslint/parser',
+  plugins: ['@typescript-eslint', 'prettier'],
+  parserOptions: {
+    tsconfigRootDir: __dirname,
+    project: './tsconfig.json',
+    ecmaVersion: 2017,
+    sourceType: 'module',
+  },
+  ignorePatterns: ['lib/*', 'test/*', '.eslintrc.js'],
+  rules: {
+    'prettier/prettier': 'error',
+    '@typescript-eslint/no-non-null-assertion': 'off',
+    '@typescript-eslint/explicit-module-boundary-types': 'off',
+    '@typescript-eslint/restrict-template-expressions': 'off',
+  },
+};