{"id":14980072,"url":"https://github.com/benwestgate/bails","last_synced_at":"2025-03-17T15:12:48.687Z","repository":{"id":65232882,"uuid":"586405374","full_name":"BenWestgate/Bails","owner":"BenWestgate","description":"CipherStick is a Bitcoin solution protecting against surveillance, censorship, and confiscation. It installs Bitcoin Core to Tails encrypted Persistent Storage, creates and recovers Bitcoin Core wallets from Codex32 (BIP93) seed backups, and creates backup CipherSticks and shareable blank CipherSticks. Learn more in README.md.","archived":false,"fork":false,"pushed_at":"2025-01-30T01:00:27.000Z","size":2902,"stargazers_count":55,"open_issues_count":0,"forks_count":8,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-17T15:12:42.538Z","etag":null,"topics":["anonymous","bash","bip85","bitcoin","bitcoin-core","bitcoin-wallet","bootable-usb","codex32","cryptography","gtk","install-script","linux","luks","privacy","python","qrcode","security","shamir-secret-sharing","tails","tor"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/BenWestgate.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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},"funding":{"github":"BenWestgate","patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":null}},"created_at":"2023-01-08T02:22:26.000Z","updated_at":"2025-03-12T07:03:53.000Z","dependencies_parsed_at":"2023-02-15T14:11:06.569Z","dependency_job_id":"76154277-9096-446f-8eee-72c3d08ae38e","html_url":"https://github.com/BenWestgate/Bails","commit_stats":{"total_commits":757,"total_committers":3,"mean_commits":"252.33333333333334","dds":0.1373844121532365,"last_synced_commit":"7552a070e19989d7834d2635b238f99971b07a88"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BenWestgate%2FBails","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BenWestgate%2FBails/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BenWestgate%2FBails/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BenWestgate%2FBails/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BenWestgate","download_url":"https://codeload.github.com/BenWestgate/Bails/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244056425,"owners_count":20390719,"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":["anonymous","bash","bip85","bitcoin","bitcoin-core","bitcoin-wallet","bootable-usb","codex32","cryptography","gtk","install-script","linux","luks","privacy","python","qrcode","security","shamir-secret-sharing","tails","tor"],"created_at":"2024-09-24T14:01:15.070Z","updated_at":"2025-03-17T15:12:48.656Z","avatar_url":"https://github.com/BenWestgate.png","language":"Shell","funding_links":["https://github.com/sponsors/BenWestgate"],"categories":[],"sub_categories":[],"readme":"# ![image](https://github.com/BenWestgate/Bails/raw/master/docs/banner2.png)\n\n# CipherStick (formerly known as \"Bails\")\n\nCipherStick is the most private way to transact and store bitcoin. It ensures your money is protected from surveillance, censorship, and confiscation, leaving no trace of your Bitcoin use on the computer or the Internet. Combining Bitcoin Core and Tails, CipherStick offers strong anonymity for transactions and secure encrypted storage.\n\n## Bitcoin Core on Tails\n\nBitcoin Core and Tails are relied upon by millions to safeguard their online privacy and security, particularly in sensitive and high-risk situations. This repository provides a script to install Bitcoin Core on Tails and create a wallet backup.\n\nBitcoin Core connects to the Bitcoin network to download and validate blocks and transactions, featuring a user-friendly interface and built-in wallet.\n- [Bitcoin Core :: About](https://bitcoincore.org/en/about/)\n\n\nTails is a portable operating system that defends against surveillance and censorship, exclusively utilizing the Tor anonymity network.\n- [Tails - How Tails works](https://tails.net/about/index.en.html)\n\n\n## Why use Bitcoin Core?\n\n### Full Validation\n\nBitcoin Core ensures the validity of every block and transaction, this protects you from counterfieting and **prevents miners and banks from seizing control of Bitcoin**.\n\n[Learn about full validation](https://bitcoin.org/en/bitcoin-core/features/validation)\n\n### Excellent Privacy\n\nBitcoin Core provides **exclusive privacy features**, making it challenging for anyone to link your transactions to you.\n\n[Discover the privacy advantages](https://bitcoin.org/en/bitcoin-core/features/privacy)\n\n# How to Install\n\n## You need\n- **1 USB stick** or memory card, 32 GB minimum\n    - If you need a USB stick, see our [recommended USB sticks](https://github.com/BenWestgate/Bails/blob/master/docs/FAQ.md#what-type-of-flash-drive-should-i-get) for top speed\n- **2 GB of RAM** computer made in the last 15 years\n    - If you need a computer, see our [recommended computers](https://github.com/BenWestgate/Bails/blob/master/docs/FAQ.md#i-dont-have-a-computer-what-type-should-i-get) to save money\n- **A smartphone** to follow the instructions\n- **Pen or pencil**\n- **Couple pieces of paper**\n- **Hard surface** to write on\n- **1 hour in total** 1.4 GB to download, ½ hour to install Tails, ¼ hour to setup CipherStick\n\n## Your steps\n\nFirst, open these instructions on another device. \n\n![image](https://user-images.githubusercontent.com/73506583/203773811-b157925d-404f-4b91-bd86-6d2e6b454a59.png)\n\nIn the next steps, you will shut down the computer. To be able to follow the rest of the instructions afterwards, you can either:\n- Scan this QR code on your smartphone or tablet:    \n   ![image](https://github.com/BenWestgate/Bails/assets/73506583/72496200-fa4f-4ce3-94de-06cc88296e73)\n- Print these instructions on paper.\n- Take note of the URL of this page:\n   ```\n   https://github.com/benwestgate/bails#install-steps\n   ```\n\n### Install steps\n\n1. [Install Tails](https://tails.net/install/index.en.html) to a USB stick or memory card (minimum 32 GB of capacity).\n   - If you know someone you trust who uses CipherStick already, you can [install by cloning](https://github.com/BenWestgate/Bails/tree/master#cipherstick-is-shareware) their CipherStick.\n1. [Start Tails](https://tails.net/doc/first_steps/start/index.en.html).\n   - At the [Welcome Screen](https://tails.net/doc/first_steps/welcome_screen/index.en.html), ignore \"Create Persistent Storage\" and click \"Start Tails\".\n     - CipherStick will help you set up Persistent Storage later.\n   - If you installed by cloning from another CipherStick, enter your temporary [Persistent Storage](https://tails.net/doc/first_steps/welcome_screen/index.en.html#index3h1) passphrase, click \"Unlock Encryption\", and then click \"Start Tails\".\n1. [Connect to a local network](https://tails.net/doc/anonymous_internet/networkmanager/index.en.html#index1h1).\n1. [Connect to Tor](https://tails.net/doc/anonymous_internet/tor/index.en.html) when the _Tor Connection_ window appears.\n   - If you cloned CipherStick, skip to step 7.\n1. Open a terminal. Choose **Applications** ▸ **Utilities** ▸ **Terminal**.\n1.  Type or Paste the following in Terminal, then press Enter:\n    ```bash\n    git clone https://github.com/benwestgate/bails; */b\n    ```\n    ![image](https://github.com/BenWestgate/Bails/assets/73506583/0522b2fe-5f7e-4548-a74e-e78ce6c52c53)\n1. Follow the instructions on Screen.\n1. You're Done!\n   - [Share your feedback, questions and suggestions](https://github.com/BenWestgate/Bails/issues/new) to make CipherStick even better!\n   \n### CipherStick is [shareware](https://en.wikipedia.org/wiki/Samizdat).\n\n- To share this free open-source software with family and friends, choose **Applications** ▸ **Office** ▸ **CipherStick** ▸ **Clone**.\n\n#### Why clone CipherSticks?\n\n- Sharing hand-to-hand prevents censorship and surveillance.\n- Cloning CipherStick saves them considerable setup time and boosts your backup resillience. A win-win situation!\n\n# Support resources\n\nFor support and discussion join our [telegram channel](https://t.me/bails_support).\n\nFor more reading checkout our [Frequently Asked Questions](docs/FAQ.md).\n\nTo contact Ben Westgate by email `benwestgate@protonmail.com`.\n\n## Advantages and Disadvantages\n\nFor a discussion on the pros and cons of using CipherStick, refer to the [detailed document](docs/Advantages_and_Disadvantages.md). It describes the unique features and limitations of the CipherStick platform.\n\n### CipherStick is the First Codex32-enabled (BIP93) Wallet\n\nFind more information on [Codex32](https://secretcodex32.com/index.html) and [BIP93](https://github.com/bitcoin/bips/blob/master/bip-0093.mediawiki).\n\n### Compliant with Auditable Bitcoin Wallets Standard\n\nRefer to the [Auditable Bitcoin Wallets Standard](https://github.com/oleganza/bitcoin-papers/blob/master/AuditableBitcoinWallets.md) for compliance details. All necessary information to audit `bails-wallet` is displayed by the terminal.\n\n## Source Code Headers\n\nEvery file containing source code must include copyright and license\ninformation. This includes any JS/CSS files that you might be serving out to\nbrowsers. (This is to help well-intentioned people avoid accidental copying that\ndoesn't comply with the license.)\n\nMIT header:\n\n    Copyright (c) 2025 Ben Westgate\n    \n    Permission is hereby granted, free of charge, to any person obtaining a copy\n    of this software and associated documentation files (the \"Software\"), to deal\n    in the Software without restriction, including without limitation the rights\n    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n    copies of the Software, and to permit persons to whom the Software is\n    furnished to do so, subject to the following conditions:\n    \n    The above copyright notice and this permission notice shall be included in\n    all copies or substantial portions of the Software.\n    \n    THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n    THE SOFTWARE.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbenwestgate%2Fbails","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbenwestgate%2Fbails","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbenwestgate%2Fbails/lists"}