{"id":21336802,"url":"https://github.com/dan-da/coinparams","last_synced_at":"2025-10-15T13:29:44.803Z","repository":{"id":55477791,"uuid":"138526990","full_name":"dan-da/coinparams","owner":"dan-da","description":"provides crypto currency specific information such as key prefixes, DNS seeds, bip32, bip44, etc, available in JSON format.","archived":false,"fork":false,"pushed_at":"2022-02-21T13:28:09.000Z","size":1027,"stargazers_count":34,"open_issues_count":3,"forks_count":27,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-11-14T20:47:21.760Z","etag":null,"topics":["altcoins","bch","bitcoin","cryptocurrencies","doge","ethereum","ltc","multicoin"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dan-da.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":"2018-06-25T00:53:36.000Z","updated_at":"2024-02-27T13:31:12.000Z","dependencies_parsed_at":"2022-08-15T01:10:59.110Z","dependency_job_id":null,"html_url":"https://github.com/dan-da/coinparams","commit_stats":null,"previous_names":[],"tags_count":18,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dan-da%2Fcoinparams","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dan-da%2Fcoinparams/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dan-da%2Fcoinparams/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dan-da%2Fcoinparams/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dan-da","download_url":"https://codeload.github.com/dan-da/coinparams/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225820222,"owners_count":17529139,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["altcoins","bch","bitcoin","cryptocurrencies","doge","ethereum","ltc","multicoin"],"created_at":"2024-11-21T23:55:19.668Z","updated_at":"2025-10-15T13:29:39.770Z","avatar_url":"https://github.com/dan-da.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# coinparams\n\nThis project provides crypto currency specific information such\nas key prefixes, DNS seeds, network ports, etc.\n\nData is available in JSON format and human readable tables.  Language\nbindings are available for JS and PHP.\n\nIt is intended for use as a quick reference or in any software that is working\nwith multiple cryptocurrencies, no matter the programming language.\n\n## Here's the data.\n\n\u003ctable\u003e\u003ctr\u003e\n\u003ctd\u003e\u003ca href=\"coinmeta.md\"\u003eMeta\u003c/a\u003e\u003c/td\u003e\n\u003ctd\u003e\u003ca href=\"coinprefixes.md\"\u003ePrefixes\u003c/a\u003e\u003c/td\u003e\n\u003ctd\u003e\u003ca href=\"coinnetworking.md\"\u003eNetworking\u003c/a\u003e\u003c/td\u003e\n\u003ctd\u003e\u003ca href=\"coingenesis.md\"\u003eGenesis Blocks\u003c/a\u003e\u003c/td\u003e\n\u003ctd\u003e\u003ca href=\"coinparams.json\"\u003eJSON\u003c/a\u003e\u003c/td\u003e\n\u003c/tr\u003e\u003c/table\u003e\n\nThe above files contain data mainly for bitcoin-derived coins.\n\nSome additional metadata for coins and tokens not listed can be found\nin [coinmeta.json](coins/meta/coinmeta.json).\n\n## How to use\n\n### For any language\n\nJust copy coinparams.json into your project and read it as you would\nread any JSON file.\n\n### JS\n\nFirst, install the package using npm:\n\n    npm install coinparams --save\n\nThen, require the package and use it like so:\n    \n    var coinparams = require('coinparams');\n\n    console.log(coinparams.get_coin('BTC'));\n    console.log(coinparams.get_coin_network('DASH', 'test'));\n    \n    // console.log(coinparams.get_all_coins());\n    // console.log(coinparams.get_raw_json());\n\n### PHP\n\n    $ cd yourproject\n    $ composer require dan-da/coinparams\n    \ninclude in your code and use via:\n\n    require_once 'path/to/vendor/autoload.php';\n    \n    // get all info for single coin\n    $info = coinParams::get_coin('BTC');\n    \n    // get info for a coin + network (main, test, regest)\n    $info = coinParams::get_coin_network('DOGE', 'main');\n\n    // get info for all coins\n    $info = coinParams::get_all_coins();\n    \n    // get raw json text for all coins\n    $buf = coinParams::get_raw_json();\n\n\n\n## How values are obtained\n\nFor bitcoin and bitcoin derivates, values have been \nautomatically parsed directly from the original source code of each \ncryptocurrency repo on github.  The script gen-masters-from-coin-src.php \nperforms this task.\n\nFor non bitcoin derivates (eg eth, monero, decred, etc) the values are\nmanually obtained.\n\nMetadata such as website urls and max supply have been scraped from\ncoinmarketcap.com.\n\n## How values are tested\n\nThere is a simple validation script that checks for any problems in the\njson tree structure, ie missing or empty fields.  It does not ensure \ncorrectness of values.\n\nAdvanced testing such as generating addresses or connecting to a\na running instance of each altcoin has not been attempted.\n\n## Contributions welcome.\n\nIf you wish to add new coins or update an existing one, please submit a pull request.\nThere is one file per coin in the ./coins directory.  Just use an existing file such\nas BTC.json as a template.\n\nIf you are adding a bitcoin derivative, you can try adding it to the list in\ngen-masters-from-coin-src.php.  Then run the script.  If successful, validate\nwith check-masters-valid.php then submit a pull request for the script and \nthe new coin.json file.\n\nIf you wish to add new language bindings, please see the example under\nbindings/php or bindings/js and try to keep the api similar.  Also, please try\nto use no more than one file (eg for package manager) in the project root\ndirectory per language.\n\n### Pull Requests\n\nPlease include the output of running:\n\n    $ ./check-masters-valid.php \u003cyourcoin-symbol\u003e\n\nThe file should fully validate (main, test, regtest) for the \npull request to be accepted.\n \n\n## Todos\n\n* Add more coins.  esp top 20 by market cap.  many are non bitcoin codebase.\n* Add bindings for other languages, to easily install and use the list as a class.\n* add meta fields for hashing algorithm, POW, POS, mineable, etc...\n* add seed node list (maybe: btc mainnet has more than 1500)\n* Use a json5 parser when reading the individual JSON files for each coin.  This will allow comments to be used in them.\n* document the schema/format used.\n* add better tests.\n\n\n## Use at your own risk.\n\nThe author makes no claims or guarantees of correctness.\n\nBy using this software you agree to take full responsibility for any losses\nincurred before, during, or after the usage, whatsoever the cause, and not to\nhold the software author liable in any manner.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdan-da%2Fcoinparams","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdan-da%2Fcoinparams","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdan-da%2Fcoinparams/lists"}