{"id":13419093,"url":"https://github.com/bitshares/bitshares1-core","last_synced_at":"2025-03-15T04:32:06.021Z","repository":{"id":14891951,"uuid":"17615687","full_name":"bitshares/bitshares1-core","owner":"bitshares","description":"Software to run the old chain (before 2015-10-13). Code for current chain is https://github.com/bitshares/bitshares-core","archived":true,"fork":false,"pushed_at":"2018-03-19T09:57:36.000Z","size":183105,"stargazers_count":217,"open_issues_count":94,"forks_count":174,"subscribers_count":82,"default_branch":"master","last_synced_at":"2024-07-31T22:45:42.571Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://bitshares.org/","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bitshares.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-03-11T02:21:45.000Z","updated_at":"2024-04-14T00:29:22.000Z","dependencies_parsed_at":"2022-08-19T19:10:29.520Z","dependency_job_id":null,"html_url":"https://github.com/bitshares/bitshares1-core","commit_stats":null,"previous_names":[],"tags_count":97,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitshares%2Fbitshares1-core","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitshares%2Fbitshares1-core/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitshares%2Fbitshares1-core/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitshares%2Fbitshares1-core/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bitshares","download_url":"https://codeload.github.com/bitshares/bitshares1-core/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243685506,"owners_count":20330980,"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":[],"created_at":"2024-07-30T22:01:11.225Z","updated_at":"2025-03-15T04:32:06.016Z","avatar_url":"https://github.com/bitshares.png","language":"C++","funding_links":[],"categories":["TODO scan for Android support in followings"],"sub_categories":[],"readme":"BitShares\n=========\nBitShares is a software platform designed to help coordinate voluntary free market operations amongst a set of social actors.\n\nThese social actors together maintain a replicated deterministic state machine which defines the state of a free market. This state machine unambigiously defines the ownership of resources amongst market participants, the rules by which resources are reallocated through market operations, and the history of all market operations. Social actors are free to voluntarily enter and exit the market as desired.\n\nReplicas of the state machine are kept consistent using the [Delegated Proof-of-Stake](http://wiki.bitshares.org/index.php/DPOS_or_Delegated_Proof_of_Stake) distributed consensus protocol, which depends on market operations by a special class of market participants colloquially known as shareholders. Resource ownership is secured using digital signatures and inputs to the state machine are shared amongst actors using a peer-to-peer mesh network.\n\nFeatures\n--------\nThe system is designed to ensure the following properties:\n- Fault-Tolerance: the market should be resilient to bad actors\n- Immutability: the historical intent of all market participants should be preserved\n- Transparency: any actor can inspect the market to verify that it is operating correctly\n- Censorship Resistance: no actor can be kept from performing valid market operations\n- Flexibility: the rules of the market should be able to change given sufficient shareholder approval\n- Self-Sustainability: the market should be be able to fund its own continued operation\n\nAdditional information is available at [BitShares.org](http://bitshares.org/) and the [BitShares Wiki](http://wiki.bitshares.org/index.php/Main_Page). Community discussion occurs at [BitSharesTalk.org](https://bitsharestalk.org/).\n\nBuilding\n--------\nDifferent platforms have different build instructions:\n* [OS X](https://github.com/BitShares/bitshares/blob/master/BUILD_OSX.md)\n* [Ubuntu](https://github.com/BitShares/bitshares/blob/master/BUILD_UBUNTU.md)\n* [Windows](https://github.com/BitShares/bitshares/blob/master/BUILD_WIN32.md)\n\n\nUsing the RPC server\n--------------------\n\nFor many applications, it is useful to execute BitShares commands from scripts.  The BitShares client includes RPC server functionality to allow programs to submit JSON-formatted commands and retrieve JSON-formatted results over an HTTP connection.  To enable the RPC server, you can edit the `rpc` section of `config.json` as follows:\n\n      \"rpc\": {\n        \"enable\": true,\n        \"rpc_user\": \"USERNAME\",\n        \"rpc_password\": \"PASSWORD\",\n        \"rpc_endpoint\": \"127.0.0.1:1775\",\n        \"httpd_endpoint\": \"127.0.0.1:1776\",\n\nHere, `USERNAME` and `PASSWORD` are authentication credentials which must be presented by a client to gain access to the RPC interface.  These parameters may also be specified on the command line, but this is not recommended because some popular multi-user operating systems (Linux in particular) allow command line parameters of running programs to be visible to all users.\n\nAfter editing the configuration file and (re)starting the BitShares client, you can use any HTTP client to POST a JSON object and read the JSON response.  Here is an example using the popular `curl` command line HTTP client:\n\n    curl --user USERNAME:PASSWORD http://127.0.0.1:1776/rpc -X POST -H 'Content-Type: application/json' -d '{\"method\" : \"blockchain_get_account\", \"params\" : [\"dev0.theoretical\"], \"id\" : 1}'\n\nThe POST request returns a JSON result like this (some data elided for brevity):\n\n    {\"id\":1,\"result\":{\"id\":31427,\"name\":\"dev0.theoretical\",\"public_data\":{\"version\":\"v0.4.27.1\"},\"owner_key\":\"BTS75vj8aaDWFwg7Wd6WinAAqVddUcSRJ1hSMDNayLAbCuxsmoQTf\", ...},\"meta_data\":{\"type\":\"public_account\",\"data\":\"\"}}}\n\nSince HTTP basic authentication is used, the authentication credentials are sent over the socket in unencrypted plaintext.\nFor this reason, binding to an interface other than localhost in the configuration file is not recommended.\nIf you wish to access the RPC interface from a remote system, you should establish a secure connection using SSH port forwarding (the `-L` option in OpenSSH) or a reverse proxy SSL/TLS tunnel (typically supported by general-purpose webservers such as `nginx`).\n\nPlease keep in mind that anyone able to connect to the RPC socket with the correct username and password will be able to access all funds, accounts and private keys in any open wallet (including wallets opened manually or by another RPC client connected to the same `bitshares_client` instance).\nThus, your security procedures should protect the username, password, and socket accordingly (including `config.json` since it contains the username and password)!\n\nContributing\n------------\nThe source code can always be found at the [BitShares GitHub Repository](https://github.com/BitShares/bitshares). There are four main branches:\n- `master` - official BitShares releases are tagged from here; this should only change for a new release\n- `bitshares` - updates to BitShares are staged here in preparation for the next official release\n- `develop` - all new development happens here; this is what is used for internal BitShares XTS test networks\n- `toolkit` - this is the most recent common ancestor between master and develop; forks of BitShares should base from here\n\nSome technical documentation is available at the [BitShares GitHub Wiki](https://github.com/BitShares/bitshares/wiki).\n\nSupport\n-------\nBugs can be reported directly to the [BitShares Issue Tracker](https://github.com/BitShares/bitshares/issues).\n\nTechnical support can be obtained from the [BitSharesTalk Technical Support Forum](https://bitsharestalk.org/index.php?board=45.0).\n\nLicense\n-------\nThe BitShares source code is in the public domain under the Unlicense. See the [LICENSE](https://github.com/BitShares/bitshares/blob/master/LICENSE.txt) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbitshares%2Fbitshares1-core","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbitshares%2Fbitshares1-core","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbitshares%2Fbitshares1-core/lists"}