{"id":41173639,"url":"https://github.com/chainpoint/chainpoint-core","last_synced_at":"2026-01-22T19:50:17.032Z","repository":{"id":39035848,"uuid":"169478647","full_name":"chainpoint/chainpoint-core","owner":"chainpoint","description":null,"archived":false,"fork":false,"pushed_at":"2022-11-01T14:59:14.000Z","size":33010,"stargazers_count":11,"open_issues_count":2,"forks_count":3,"subscribers_count":8,"default_branch":"master","last_synced_at":"2024-06-19T05:56:46.965Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chainpoint.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-02-06T21:20:05.000Z","updated_at":"2024-03-11T07:31:10.000Z","dependencies_parsed_at":"2022-09-02T13:40:42.070Z","dependency_job_id":null,"html_url":"https://github.com/chainpoint/chainpoint-core","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/chainpoint/chainpoint-core","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chainpoint%2Fchainpoint-core","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chainpoint%2Fchainpoint-core/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chainpoint%2Fchainpoint-core/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chainpoint%2Fchainpoint-core/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chainpoint","download_url":"https://codeload.github.com/chainpoint/chainpoint-core/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chainpoint%2Fchainpoint-core/sbom","scorecard":{"id":273058,"data":{"date":"2025-08-11","repo":{"name":"github.com/chainpoint/chainpoint-core","commit":"bc662400dc7eb8c575d94eceacae9f1ce073f96d"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":1.6,"checks":[{"name":"Code-Review","score":0,"reason":"Found 0/22 approved changesets -- score normalized to 0","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/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"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/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"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/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"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/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"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/f6ed084d17c9236477efd66e5b258b9d4cc7b389/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/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"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/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: downloadThenRun not pinned by hash: config/install_deps.sh:4","Info:   0 out of   1 downloadThenRun dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/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/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"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/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: GNU Affero General Public License v3.0: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"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/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/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 11 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Vulnerabilities","score":0,"reason":"45 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GO-2024-2818 / GHSA-3jgf-r68h-xfqm","Warn: Project is vulnerable to: GO-2024-3189 / GHSA-27vh-h6mc-q6g8","Warn: Project is vulnerable to: GO-2022-0771 / GHSA-69v6-xc2j-r2jf","Warn: Project is vulnerable to: GO-2021-0105 / GHSA-xw37-57qp-9mm4","Warn: Project is vulnerable to: GO-2022-0392 / GHSA-m6gx-rhvj-fh52","Warn: Project is vulnerable to: GO-2022-0775 / GHSA-v592-xf75-856p","Warn: Project is vulnerable to: GO-2021-0063 / GHSA-r33q-22hv-j29q","Warn: Project is vulnerable to: GO-2022-0254","Warn: Project is vulnerable to: GO-2022-0256 / GHSA-59hh-656j-3p7v","Warn: Project is vulnerable to: GO-2022-0456 / GHSA-wjxw-gh3m-7pm5","Warn: Project is vulnerable to: GO-2023-2046 / GHSA-ppjg-v974-84cm","Warn: Project is vulnerable to: GO-2024-2819 / GHSA-4xc9-8hmq-j652","Warn: Project is vulnerable to: GHSA-5m8f-chrv-7rw5","Warn: Project is vulnerable to: GHSA-pvx3-gm3c-gmpr","Warn: Project is vulnerable to: GHSA-rqmg-hrg4-fm69","Warn: Project is vulnerable to: GHSA-v9jh-j8px-98vq","Warn: Project is vulnerable to: GHSA-vmf7-hmh6-vv57","Warn: Project is vulnerable to: GHSA-vrcc-g6vj-mh5w","Warn: Project is vulnerable to: GO-2024-2606 / GHSA-7jwh-3vrq-q3m8 / GHSA-mrww-27vc-gghv","Warn: Project is vulnerable to: GO-2024-2605 / GHSA-m7wr-2xf7-cm9p","Warn: Project is vulnerable to: GO-2023-1859 / GHSA-rm8v-mxj3-5rmq","Warn: Project is vulnerable to: GO-2023-2379 / GHSA-7f9x-gw85-8grf","Warn: Project is vulnerable to: GO-2024-2632 / GHSA-hj3v-m684-v259","Warn: Project is vulnerable to: GO-2025-3605 / GHSA-7vpp-9cxj-q8gv","Warn: Project is vulnerable to: GO-2024-2698 / GHSA-rhh4-rh7c-7r5v","Warn: Project is vulnerable to: GO-2022-0322 / GHSA-cg3q-j54f-5p7p","Warn: Project is vulnerable to: GO-2023-2331 / GHSA-8pgv-569h-w5rw","Warn: Project is vulnerable to: GO-2021-0356 / GHSA-8c26-wmh5-6g9v","Warn: Project is vulnerable to: GO-2024-2961","Warn: Project is vulnerable to: GO-2023-2402 / GHSA-45x7-px36-x8w8","Warn: Project is vulnerable to: GO-2024-3321 / GHSA-v778-237x-gjrc","Warn: Project is vulnerable to: GO-2025-3487 / GHSA-hcg3-q754-cr77","Warn: Project is vulnerable to: GO-2022-0969 / GHSA-69cg-p879-7622","Warn: Project is vulnerable to: GO-2022-1144 / GHSA-xrjj-mj9h-534m","Warn: Project is vulnerable to: GO-2023-1571 / GHSA-vvpx-j8f3-3w6h","Warn: Project is vulnerable to: GO-2023-1988 / GHSA-2wrh-6pvc-2jm9","Warn: Project is vulnerable to: GO-2023-2102 / GHSA-4374-p667-p6c8","Warn: Project is vulnerable to: GO-2023-2153 / GHSA-m425-mq94-257g / GHSA-qppj-fm5r-hxr3","Warn: Project is vulnerable to: GO-2024-2687 / GHSA-4v7x-pqxf-cx7m","Warn: Project is vulnerable to: GO-2024-3333","Warn: Project is vulnerable to: GO-2025-3503 / GHSA-qxp5-gwg8-xv66","Warn: Project is vulnerable to: GO-2025-3595 / GHSA-vvgc-356p-c3xw","Warn: Project is vulnerable to: GO-2022-1059 / GHSA-69ch-w2m2-3vjp","Warn: Project is vulnerable to: GO-2024-2611 / GHSA-8r3f-844c-mc37","Warn: Project is vulnerable to: GO-2022-0603 / GHSA-hp87-p4gw-j4gq"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-17T13:50:21.031Z","repository_id":39035848,"created_at":"2025-08-17T13:50:21.031Z","updated_at":"2025-08-17T13:50:21.031Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28669720,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-22T19:36:09.361Z","status":"ssl_error","status_checked_at":"2026-01-22T19:36:05.567Z","response_time":144,"last_error":"SSL_read: 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":[],"created_at":"2026-01-22T19:50:16.237Z","updated_at":"2026-01-22T19:50:17.020Z","avatar_url":"https://github.com/chainpoint.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Chainpoint Core\n\n[![License](https://img.shields.io/badge/license-GPL-blueg)](https://www.gnu.org/licenses/agpl-3.0.en.html)\n\nSee [Chainpoint Start](https://github.com/chainpoint/chainpoint-start) for an overview of the Chainpoint Network.\n\n![Draft Chainpoint Architecture Diagram](https://github.com/chainpoint/chainpoint-start/blob/master/imgs/Chainpoint-Network-Overview-Diagram.png)\n\nChainpoint Core runs as a node on a distributed network. Cores aggregate hashes received from Gateways, maintain the Chainpoint Calendar, and periodically anchor data to the Bitcoin blockchain.\n\nEach Core has an integrated Lightning Node running [LND](https://github.com/lightningnetwork/lnd). Cores receive `anchor fee` payments from Gateways via Lightning. The default `anchor fee` is 2 [satoshis](\u003chttps://en.bitcoin.it/wiki/Satoshi_(unit)\u003e). Core operators can set their anchor fee to adapt to changing market conditions and compete to earn fees from Gateways.\n\nWhen joining the network, new Cores automatically open Lightning channels with the existing Cores. Each channel must have a minimum capacity of 1,000,000 satoshis. This provides a measure of Sybil resistance and helps ensure Cores have sufficient liquidity to receive Lightning payments from Gateways.\n\nOnce per hour, a Core is elected to anchor data to Bitcoin. As more Cores join the network, each Core anchors less frequently, thus reducing each Core’s cost of paying Bitcoin transaction fees.\n\nYou do not need to run Chainpoint Core to use the Chainpoint protocol. Chainpoint Core is for operators that want to participate in running the anchoring service, and earn fees from Gateways.\n\n## Installing Chainpoint Core\n\n### Requirements\n\n#### Software\n\nAn Ubuntu or MacOS system with Git, Make, and BASH are required for operation. A bash script to install all other dependencies (docker, openssl, nodejs, yarn) can be run from `make install-deps`.\n\nThe following tcp ports need to be open:\n\n- Web: 80, 443\n- Lightning: 8080, 9735, 10009\n- Tendermint: 26656, 26657\n\nIt _is_ possible to run Core from home, but you must have a static IP and have publicly forwarded the ports above.\n\n#### Hardware\n\nChainpoint Core has been tested with a couple of different hardware configurations.\n\nMinimum:\n\n- `\u003e= 4GB RAM`\n- `\u003e= 2 CPU Cores`\n- `100+ GB SSD`\n- `Public IPv4 address`\n\nRecommended (high usage):\n\n- `\u003e= 8GB RAM`\n- `\u003e= 4 CPU Cores`\n- `\u003e= 500 GB SSD`\n- `Public IPv4 address`\n\n### Quick Start\n\nTo start up a Core node and connect to the Chainpoint Network:\n\n#### Install Dependencies\n\n```$bash\n$ sudo apt-get install make git\n$ git clone https://github.com/chainpoint/chainpoint-core.git\n$ cd chainpoint-core\n$ make install-deps    # installs go and cleveldb\n$ source ~/.bashrc     # reload path after dependency installation\n$ make install         # compiles core binary\n$ chainpoint-core      # Run setup\n```\n\nIf you wish to daemonize the service with systemd, the following\ncommands are available:\n```\n$ make install-daemon  # install systemd if necessary\n$ make start-daemon    # start systemd daemon\n$ make log-daemon      # print daemon logs\n```\n\nBy default the resulting binary will be placed in `~/go/bin`.\n\n#### Configure Core\n\nBefore running the binary for the first time, ensure you have contacted Tierion with your public IP \nso your traffic is allowed through the seed node's firewall. \n\n```\n$ ssh user@\u003cyour_ip\u003e #Log back into your server\n$ chainpoint-core\n\n ██████╗██╗  ██╗ █████╗ ██╗███╗   ██╗██████╗  ██████╗ ██╗███╗   ██╗████████╗     ██████╗ ██████╗ ██████╗ ███████╗\n██╔════╝██║  ██║██╔══██╗██║████╗  ██║██╔══██╗██╔═══██╗██║████╗  ██║╚══██╔══╝    ██╔════╝██╔═══██╗██╔══██╗██╔════╝\n██║     ███████║███████║██║██╔██╗ ██║██████╔╝██║   ██║██║██╔██╗ ██║   ██║       ██║     ██║   ██║██████╔╝█████╗\n██║     ██╔══██║██╔══██║██║██║╚██╗██║██╔═══╝ ██║   ██║██║██║╚██╗██║   ██║       ██║     ██║   ██║██╔══██╗██╔══╝\n╚██████╗██║  ██║██║  ██║██║██║ ╚████║██║     ╚██████╔╝██║██║ ╚████║   ██║       ╚██████╗╚██████╔╝██║  ██║███████╗\n ╚═════╝╚═╝  ╚═╝╚═╝  ╚═╝╚═╝╚═╝  ╚═══╝╚═╝      ╚═════╝ ╚═╝╚═╝  ╚═══╝   ╚═╝        ╚═════╝ ╚═════╝ ╚═╝  ╚═╝╚══════╝\n\n\n? Will this Core use Bitcoin mainnet or testnet? testnet\n? Enter your Core's Public IP Address: 3.17.78.45\n```\n\n#### Auto-Initialize Lightning\n\n```\nYou will need at least 3000000 Satoshis (0.03 BTC) to join the Chainpoint Network!\n\nInitializing Lightning wallet...\nCreate new address for wallet...\n****************************************************\nLightning initialization has completed successfully.\n****************************************************\nLND Wallet Password: rjcOgYehDmthuurduuriAMsr\nLND Wallet Seed: absorb behind drop safe like herp derp celery galaxy wait orient sign suit castle awake gadget pass pipe sudden ethics hill choose six orphan\nLND Wallet Address: tb1qfvjr20txm464fxcr0n9d4j2gkr5w4xpl55kl6u\n******************************************************\nYou should back up this information in a secure place.\n******************************************************\n\nPlease fund your Lightning address with at least [staking requirement] Satoshis (0.0X BTC) to join the Chainpoint Network`\n\nChainpoint Core Setup Complete. Run with chainpoint-core -config ~/.chainpoint/core/core.conf\n\n$ chainpoint-core -config ~/.chainpoint/core/core.conf\n```\n\nThe staking requirement is determined by the number of cores on the Chainpoint Network multiplied by 1,000,000 satoshis.\n\nIf startup is successful, the log output will show the log message `Executed block` every minute after the binary connects to the Chainpoint Network, and going to `\u003cyour ip\u003e/status` in a browser will show the Core status in JSON format.\n\nDuring startup, lnd and tendermint will initialize in separate background threads. During this time you may see errors or warnings related to `GetStatus` or `BlockSyncMonitor`; these can be ignored.\n\nThe process can be daemonized with systemd by running `make install-daemon \u0026\u0026 make start-daemon`.\nAdditionally, `make log-daemon` will use journald to parse the process logs and `make stop-daemon` will shut down the daemon.\n\n\n### Joining another Network\n\nBy default, the init process will join either the Chainpoint Testnet or Mainnet, depending on user choice. However, peering with custom networks is also possible:\n\n1. Specify peers by adding a comma-delimited list of Tendermint URIs, such as `peers=087186cd1d631c5e709c4afa15a1ce218c6a28c1@3.133.119.65:26656` to the .conf file in the config directory (by default `~/.chainpoint/core`)\n\n2. Run `chainpoint-core -config ~/.chainpoint/core/core.conf` to start Core. In order to obtain permission to submit hashes to the network, your Core will automatically stake bitcoin by opening lightning channels with the existing network validators.\n\n### Upgrade\n\nCore can be upgraded by pulling the latest main branch from this repository and recompiling with `make install`.\n\n### Troubleshooting\n\nIf setup fails and the Lightning wallet hasn't yet been generated and funded, run `rm -rf ~/.chainpoint/core`, then run `chainpoint-core` again.\n\nTo reset the core chain state if the Lightning wallet has already been generated and funded, run `make clean-tendermint`, then `chainpoint-core` again.\n\nFor further help, [submit an issue](https://github.com/chainpoint/chainpoint-core/issues) to the Chainpoint Core repo.\n\n### Configuration\n\nRunning chainpoint-core for the first time will perform the configuration process for you. However, you may wish to setup a custom Core or Network. To do this, you will need to set up a configuration and secrets (lightning wallet) before running.\n\nChainpoint Core currently uses a config file, which by default is at `~/.chainpoint/core/core.conf`. Running `chainpoint-core` without arguments for the first time will initialize this file. \nModifying these settings may be invaluable for setting up a private Chainpoint Network with different parameters, for example by configuring more frequent bitcoin anchoring.\n\nA full list of configuration parameters is located at abci/config.go or by running `chainpoint-core -h`.                                                                            |\n\n## Development\n\nWe encourage anyone interested in contributing to fork this repo and submit a pull-request with desired changes. Please be sure to use gofmt (go) to check/fix any style issues.\n\n### Build\n\n`make build` will build a production application, provided `go` has been installed via install-deps. `make build-dev` will compile a core instance \nwith tendermint and lightning node geared toward production.\n\n### Run\n\nAfter running `chainpoint-core` with test parameters, API will be accessible by default on port 80, while Tendermint is accessible on ports 26656-26657.\n\n### Documentation\n\nA description of the Chainpoint Network is available in the [chainpoint-start](https://github.com/chainpoint/chainpoint-start) repository.\n\nThe README for the Core application in this repo is available [here](https://github.com/chainpoint/chainpoint-core/blob/master/README.md).\n\n## License\n\nThis is Open Source software released under [AGPLv3](./LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchainpoint%2Fchainpoint-core","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchainpoint%2Fchainpoint-core","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchainpoint%2Fchainpoint-core/lists"}