{"id":36573172,"url":"https://github.com/ostdotcom/ost-block-scanner","last_synced_at":"2026-01-12T07:20:24.632Z","repository":{"id":57134002,"uuid":"166982820","full_name":"ostdotcom/ost-block-scanner","owner":"ostdotcom","description":"OST Block Scanner parses Ethereum-based chains and stores data in DynamoDB","archived":false,"fork":false,"pushed_at":"2024-03-01T17:19:58.000Z","size":410,"stargazers_count":15,"open_issues_count":1,"forks_count":1,"subscribers_count":14,"default_branch":"develop","last_synced_at":"2025-08-15T11:02:32.098Z","etag":null,"topics":["block-parser","block-scanner","ethereum","openst","ost"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ostdotcom.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-01-22T11:31:55.000Z","updated_at":"2024-02-17T05:46:22.000Z","dependencies_parsed_at":"2025-08-15T11:02:37.184Z","dependency_job_id":"e6d781f6-3251-47f3-a3c3-e0057c694e07","html_url":"https://github.com/ostdotcom/ost-block-scanner","commit_stats":null,"previous_names":["openstfoundation/openst-block-scanner"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/ostdotcom/ost-block-scanner","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ostdotcom%2Fost-block-scanner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ostdotcom%2Fost-block-scanner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ostdotcom%2Fost-block-scanner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ostdotcom%2Fost-block-scanner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ostdotcom","download_url":"https://codeload.github.com/ostdotcom/ost-block-scanner/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ostdotcom%2Fost-block-scanner/sbom","scorecard":{"id":106435,"data":{"date":"2025-08-04","repo":{"name":"github.com/ostdotcom/ost-block-scanner","commit":"bda66bc58417e310db5cd4a86aff3a13a0fad17e"},"scorecard":{"version":"v5.2.1-28-gc1d103a9","commit":"c1d103a9bb9f635ec7260bf9aa0699466fa4be0e"},"score":4.8,"checks":[{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/c1d103a9bb9f635ec7260bf9aa0699466fa4be0e/docs/checks.md#token-permissions"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/c1d103a9bb9f635ec7260bf9aa0699466fa4be0e/docs/checks.md#packaging"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/c1d103a9bb9f635ec7260bf9aa0699466fa4be0e/docs/checks.md#dangerous-workflow"}},{"name":"Code-Review","score":9,"reason":"Found 9/10 approved changesets -- score normalized to 9","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/c1d103a9bb9f635ec7260bf9aa0699466fa4be0e/docs/checks.md#code-review"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/c1d103a9bb9f635ec7260bf9aa0699466fa4be0e/docs/checks.md#maintained"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/c1d103a9bb9f635ec7260bf9aa0699466fa4be0e/docs/checks.md#binary-artifacts"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/c1d103a9bb9f635ec7260bf9aa0699466fa4be0e/docs/checks.md#cii-best-practices"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/c1d103a9bb9f635ec7260bf9aa0699466fa4be0e/docs/checks.md#pinned-dependencies"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/c1d103a9bb9f635ec7260bf9aa0699466fa4be0e/docs/checks.md#security-policy"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/c1d103a9bb9f635ec7260bf9aa0699466fa4be0e/docs/checks.md#vulnerabilities"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: GNU General Public License v3.0: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/c1d103a9bb9f635ec7260bf9aa0699466fa4be0e/docs/checks.md#license"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/c1d103a9bb9f635ec7260bf9aa0699466fa4be0e/docs/checks.md#fuzzing"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/c1d103a9bb9f635ec7260bf9aa0699466fa4be0e/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":-1,"reason":"internal error: error during branchesHandler.setup: internal error: githubv4.Query: Resource not accessible by integration","details":null,"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/c1d103a9bb9f635ec7260bf9aa0699466fa4be0e/docs/checks.md#branch-protection"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 30 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/c1d103a9bb9f635ec7260bf9aa0699466fa4be0e/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-15T11:11:33.826Z","repository_id":57134002,"created_at":"2025-08-15T11:11:33.826Z","updated_at":"2025-08-15T11:11:33.826Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28336500,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-12T06:09:07.588Z","status":"ssl_error","status_checked_at":"2026-01-12T06:05:18.301Z","response_time":98,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["block-parser","block-scanner","ethereum","openst","ost"],"created_at":"2026-01-12T07:20:22.151Z","updated_at":"2026-01-12T07:20:24.626Z","avatar_url":"https://github.com/ostdotcom.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# OST Block Scanner\n\n\n[![Latest version](https://img.shields.io/npm/v/@ostdotcom/ost-block-scanner.svg?maxAge=3600)][npm]\n[![Downloads per month](https://img.shields.io/npm/dm/@ostdotcom/ost-block-scanner.svg?maxAge=3600)][npm]\n\n[npm]: https://www.npmjs.com/package/@ostdotcom/ost-block-scanner\n\nOST Block Scanner parses Ethereum-based chains and stores data in DynamoDB. It supports multiple chains, as well.\n\n\n## Install\n\n```bash\n  npm install @ostdotcom/ost-block-scanner --save\n```\n\n## Setup\n\n### 1. Install Prerequisites \n- [nodejs](https://nodejs.org/) \u003e= 8.0.0\n- [Geth](https://github.com/ethereum/go-ethereum/) \u003e=1.8.17\n- [Memcached](https://memcached.org/)\n- AWS DynamoDB Service OR [DynamoDBLocal.jar](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DynamoDBLocal.DownloadingAndRunning.html)\n- [Java](https://www.java.com/) \u003e= 6.0, if using DynamoDBLocal.jar\n- [DB Browser for SQLite](https://sqlitebrowser.org/) optionally to browse DynamoDB\n    \n### 2. Run DynamoDBLocal.jar, if you are not using AWS DynamoDB Service\n\n```bash\n  # NOTE: Make sure to change DYNAMODB_PATH\n  export DYNAMODB_PATH=~/dynamodb_local_latest\n  java -Djava.library.path=$DYNAMODB_PATH/DynamoDBLocal_lib/ -jar $DYNAMODB_PATH/DynamoDBLocal.jar -sharedDb -dbPath $DYNAMODB_PATH/\n```\n\n### 3. Create OST Block Scanner config file\nRefer to [config.json.example](config.json.example) to create a new configuration file.\n\nSet `CONFIG_STRATEGY_PATH` environment variable to the path of the configuration file just created.\n\n### 4. Create Global DynamoDB tables: \n\n```bash\n  node ./node_modules/@ostdotcom/ost-block-scanner/tools/initialSetup.js --configFile $CONFIG_STRATEGY_PATH\n```\n\n### 5. Add a new chain and create chain-specific shared DynamoDB tables:\n  * Mandatory parameters: `chainId`, `networkId`, `configFile`\n  * Optional parameters (each defaults to 1):\n    * `blockShardCount`: number of block shards to be created\n    * `economyAddressShardCount`: number of economy address shards to be created\n    * `transactionShardCount`: number of transaction shards to be created\n  \n```bash\n  # NOTE:\n  # Make sure chain configuration is present in config file before starting this step. \n  # Optional parameters are used to create entity-specific sharded tables. \n  # By default only one shard is created for each entity. \n  node ./node_modules/@ostdotcom/ost-block-scanner/tools/addChain.js --configFile $CONFIG_STRATEGY_PATH --chainId 2000 --networkId 1 --blockShardCount 2 --economyAddressShardCount 2 --transactionShardCount 2\n```\n\n### 6. Add additional shards to existing chains (optional)\n\n* Additional block specific data shards:\n\n```bash\n  node ./node_modules/@ostdotcom/ost-block-scanner/tools/createShards/byBlock.js --configFile $CONFIG_STRATEGY_PATH --chainId 2000 --shardNumber 1\n```\n\n* Additional economy user(s) specific data shards:\n\n```bash\n  node ./node_modules/@ostdotcom/ost-block-scanner/tools/createShards/byEconomyAddress.js --configFile $CONFIG_STRATEGY_PATH --chainId 2000 --shardNumber 1\n```\n\n* Additional transaction specific data shards:\n\n```bash\n  node ./node_modules/@ostdotcom/ost-block-scanner/tools/createShards/byTransaction.js --configFile $CONFIG_STRATEGY_PATH --chainId 2000 --shardNumber 1\n```\n    \n## Start Block Scanner\n  * Mandatory parameters: `chainId`, `configFile`\n  * Optional parameters: `startBlockNumber`, `endBlockNumber`\n```bash\n  node ./node_modules/@ostdotcom/ost-block-scanner/executables/blockScanner.js --configFile $CONFIG_STRATEGY_PATH --chainId 2000 --startBlockNumber 0 --endBlockNumber 100\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fostdotcom%2Fost-block-scanner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fostdotcom%2Fost-block-scanner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fostdotcom%2Fost-block-scanner/lists"}