Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/mrz1836/sigil

🔮 Personal multi-chain wallet CLI — unlock your BSV, BTC, and ETH
https://github.com/mrz1836/sigil

bitcoin bitcoinsv bsv btc cli crypto eth multi-chain wallet

Last synced: 3 months ago
JSON representation

🔮 Personal multi-chain wallet CLI — unlock your BSV, BTC, and ETH

Awesome Lists containing this project

README 

          



# 🔮  Sigil



**Terminal-based multi-chain cryptocurrency wallet for power users**







Release

Go Version

License







  

    

       CI / CD   

    

    

       Build

       Last Commit

    

    

            Quality   

    

    

       Go Report

       Coverage

    

  



  

    

       Security   

    

    

       Scorecard

       Security

    

    

            Community   

    

    

       Contributors

       Bitcoin

    

  
















### Project Navigation






  

    

       🚀 Installation

    

    

       ⚡ Quick Start

    

    

       📚 Documentation

    

  

  

    

       🔐 Security

    

    

      🛠️ Code Standards

    

    

      🧪 Examples & Tests

    

  

  

    

      🤖 AI Usage

    

    

       ⚖️ License

    

    

       🤝 Contributing

    

  

  

    

       👥 Maintainers

    

  







### 🎥 Demo



Sigil Demo







## 🚀 Installation



**Sigil** requires a [supported release of Go](https://golang.org/doc/devel/release.html#policy).



### Install via go install



```bash

go install github.com/mrz1836/sigil/cmd/sigil@latest

```



### Build from source



```bash

git clone https://github.com/mrz1836/sigil.git

cd sigil

go build -o bin/sigil ./cmd/sigil

```







## ⚡ Quick Start



Get up and running with these essential commands:







### Create a wallet



```bash

sigil wallet create main

```



Creates a new HD wallet with BIP39 mnemonic phrase.







### Check balances



```bash

sigil balance show --wallet main

```



Displays balances across all supported chains (ETH, USDC, BSV).







### Get a receiving address



```bash

sigil receive --wallet main --chain bsv --qr --label "Re-up time!"

```



Generates a new receiving address for the specified chain.







### Check for incoming funds



```bash

sigil receive --wallet main --chain bsv --check

```

Checks for incoming transactions to your wallet.







### Send a transaction



```bash

sigil tx send --wallet main --to 0x742d35Cc663... --amount 0.00001 --chain eth

sigil tx send --wallet main --to 1A1zP1eP5QGef... --amount 0.00001 --chain bsv

```



Sends cryptocurrency to the specified address.







### Back up your wallet



```bash

sigil backup create --wallet main

```



Creates an encrypted backup of your wallet.







### Keep sigil up to date



```bash

# Check for a new release

sigil upgrade --check



# Install the latest release

sigil upgrade



# If you're running a dev/commit build, add --force

sigil upgrade --force

```



Downloads the latest binary from GitHub, verifies SHA256, and replaces in-place. See [`upgrade`](docs/CLI.md#upgrade) for flags.







> 📖 **For complete command reference and advanced features, see the [CLI Documentation →](docs/CLI.md)**







## 📚 Documentation



View the comprehensive documentation for Sigil:



| Document                        | Description                                          |

|---------------------------------|------------------------------------------------------|

| **[CLI.md](docs/CLI.md)**       | Complete command reference and usage guide           |







> **Heads up!** Sigil is designed with minimal dependencies and maximum security. All cryptographic operations use battle-tested libraries:

> - **filippo.io/age** for encryption

> - **golang.org/x/crypto** for cryptographic primitives

> - **cosmos/go-bip39** for BIP39 mnemonic generation







### Supported Chains



| Chain | Status | Description |

|-------|--------|-------------|

| ✅ Bitcoin SV (BSV) | **Supported** | UTXO-based transaction support |

| ✅ Ethereum (ETH) | **Supported** | Full transaction and balance support |

| ✅ USDC | **Supported** | ERC-20 token on Ethereum network |

| 🚧 Bitcoin (BTC) | **Planned** | Coming in future release |

| 🚧 Bitcoin Cash (BCH) | **Planned** | Coming in future release |







### Key Features



- 🔑 **HD Wallet Support** — BIP39 mnemonic phrases with BIP32/BIP44 derivation

- 🛡️ **Shamir's Secret Sharing** — Split your wallet seed into multiple shares for enhanced security

- 💰 **Multi-Chain Balances** — Check balances across all supported networks

- 📤 **Transaction Management** — Create, sign, and broadcast transactions

- 🔐 **Secure Sessions** — Encrypted session management using OS keychain

- 🤖 **Agent Tokens** — Programmatic access for automation

- 💾 **Encrypted Backups** — Secure wallet backup and restoration

- 🧩 **UTXO Management** — Advanced coin control for Bitcoin-based chains

- 📱 **QR Code Support** — Terminal-based QR code generation and scanning







## 🔐 Security



### Important Disclaimer



> ⚠️ **Experimental Software — Use at Your Own Risk**

>

> Sigil is experimental, open-source software provided "AS-IS" without warranty. By using Sigil, you acknowledge:

>

> - **You control your keys:** Sigil never transmits or stores your private keys. Lost mnemonics are unrecoverable.

> - **Transactions are final:** Cryptocurrency transactions are irreversible.

> - **No formal audit:** This software has not undergone professional security auditing.

> - **No liability:** Authors accept no responsibility for loss of funds or damages.

>

> **Do not use Sigil with funds you cannot afford to lose.**



For security issues, see our [Security Policy](.github/SECURITY.md) or contact: [sigil@mrz1818.com](mailto:sigil@mrz1818.com)







### Additional Documentation & Repository Management



Development Setup (Getting Started)





Install [MAGE-X](https://github.com/mrz1836/go-mage) build tool for development:



```bash

# Install MAGE-X for development and building

go install github.com/magefile/mage@latest

go install github.com/mrz1836/go-mage/magex@latest

magex update:install

```



Wallet Discovery & Migration





Sigil can discover and sweep funds from other BSV wallets by scanning multiple BIP44 derivation paths. This is essential for recovering funds from defunct providers or migrating from other wallets.



### Supported Derivation Schemes



Sigil automatically scans these derivation paths to find your funds:



| Derivation Scheme | Path | Supported Wallets |

|-------------------|------|-------------------|

| **BSV Standard** | `m/44'/236'/0'/...` | [RelayX](https://relayx.com/), [RockWallet](https://rockwallet.com/), [Twetch](https://twetch.com/), [Centbee](https://www.centbee.com/) †, Trezor, Ledger, KeepKey |

| **Bitcoin Legacy** | `m/44'/0'/0'/...` | [MoneyButton](https://www.moneybutton.com/) †, [ElectrumSV](https://electrumsv.io/) |

| **Bitcoin Cash** | `m/44'/145'/0'/...` | [Exodus](https://www.exodus.com/), Simply.Cash †, BCH fork splits |

| **HandCash Legacy** | `m/0'/...` | [HandCash 1.x](https://handcash.io/) (legacy version only) |



† *Service discontinued or shut down*



### Defunct BSV Services Supported



Sigil provides a recovery path for users of these defunct BSV services:



- **[Centbee](https://www.centbee.com/)** — Popular BSV mobile wallet that ceased operations in 2026. Uses BSV Standard derivation (`m/44'/236'/...`) with 4-digit PIN as BIP39 passphrase.

- **[MoneyButton](https://www.moneybutton.com/)** — Popular BSV wallet and identity provider that shut down in 2023. Used Bitcoin Legacy derivation (`m/44'/0'/...`).

- **Simply.Cash** — Mobile BSV wallet that ceased operations. Used Bitcoin Cash derivation path (`m/44'/145'/...`).

- **[HandCash 1.x](https://handcash.io/)** — Early versions of HandCash used a non-standard legacy path (`m/0'/...`). Note: HandCash 2.0+ uses proprietary non-exportable keys and cannot be imported.



### Active Wallets Supported



Sigil also supports migrating from active BSV wallets:



- **[RelayX](https://relayx.com/)** — BSV wallet and token platform

- **[RockWallet](https://rockwallet.com/)** — Multi-chain mobile wallet with BSV support

- **[Twetch](https://twetch.com/)** — BSV social media platform with integrated wallet

- **[ElectrumSV](https://electrumsv.io/)** — Desktop BSV wallet

- **[Exodus](https://www.exodus.com/)** — Multi-chain desktop/mobile wallet



### Hardware Wallets



- **Trezor** — Hardware wallet with BSV support

- **Ledger** — Hardware wallet with BSV support

- **KeepKey** — Hardware wallet with BSV support



### Usage



Discover funds from another wallet's mnemonic:



```bash

sigil wallet discover --mnemonic "your twelve or twenty-four word phrase"

```



For Centbee wallets (uses 4-digit PIN as passphrase):



```bash

sigil wallet discover --mnemonic "your phrase" --passphrase "1234"

```



See the [CLI Documentation](docs/CLI.md#wallet-discover) for complete details on wallet discovery and fund recovery.



Binary Deployment





This project uses [goreleaser](https://github.com/goreleaser/goreleaser) for streamlined binary deployment to GitHub. To get started, install it via:



```bash

brew install goreleaser

```



The release process is defined in the [.goreleaser.yml](.goreleaser.yml) configuration file.



### Supported Platforms



- **Linux:** amd64, arm64

- **macOS:** amd64, arm64

- **Windows:** amd64, arm64



### Release Process



Then create and push a new Git tag using:



```bash

magex version:bump bump=patch push=true

```



This process ensures consistent, repeatable releases with properly versioned artifacts and citation metadata.



Build Commands





View all build commands



```bash script

magex help

```



Common commands:

- `magex build` — Build the binary

- `magex test` — Run test suite

- `magex lint` — Run all linters

- `magex deps:update` — Update dependencies



GitHub Workflows





Sigil uses the **Fortress** workflow system for comprehensive CI/CD:



- **fortress-test-suite.yml** — Complete test suite across multiple Go versions

- **fortress-code-quality.yml** — Code quality checks (gofmt, golangci-lint, staticcheck)

- **fortress-security-scans.yml** — Security vulnerability scanning

- **fortress-coverage.yml** — Code coverage reporting to Codecov

- **fortress-release.yml** — Automated binary releases via GoReleaser



See all workflows in [`.github/workflows/`](.github/workflows/).



Updating Dependencies





To update all dependencies (Go modules, linters, and related tools), run:



```bash

magex deps:update

```



This command ensures all dependencies are brought up to date in a single step, including Go modules and any managed tools. It is the recommended way to keep your development environment and CI in sync with the latest versions.







## 🧪 Examples & Tests



All unit tests run via [GitHub Actions](https://github.com/mrz1836/sigil/actions) and use [Go version 1.25.6](https://go.dev/doc/go1.25). View the [configuration file](.github/workflows/fortress.yml).



Run all tests (fast):



```bash script

magex test

```



Run all tests with race detector (slower):

```bash script

magex test:race

```



### Test Coverage



View coverage report:



```bash script

magex test:coverage

```



Coverage reports are automatically uploaded to [Codecov](https://codecov.io/gh/mrz1836/sigil) on every commit.







## 🛠️ Code Standards

Read more about this Go project's [code standards](.github/CODE_STANDARDS.md).







## 🤖 AI Usage & Assistant Guidelines

Read the [AI Usage & Assistant Guidelines](.github/CLAUDE.md) for details on how AI is used in this project and how to interact with AI assistants.







## 👥 Maintainers

| [MrZ](https://github.com/mrz1836) |

|:------------------------------------------------------------------------------------------------:|

|                                [MrZ](https://github.com/mrz1836)                                 |







## 🤝 Contributing

View the [contributing guidelines](.github/CONTRIBUTING.md) and please follow the [code of conduct](.github/CODE_OF_CONDUCT.md).



### How can I help?

All kinds of contributions are welcome :raised_hands:!

The most basic way to show your support is to star :star2: the project, or to raise issues :speech_balloon:.

You can also support this project by [becoming a sponsor on GitHub](https://github.com/sponsors/mrz1836) :clap:

or by making a [**bitcoin donation**](https://mrz1818.com/?tab=tips&utm_source=github&utm_medium=sponsor-link&utm_campaign=sigil&utm_term=sigil&utm_content=sigil) to ensure this journey continues indefinitely! :rocket:



[![Stars](https://img.shields.io/github/stars/mrz1836/sigil?label=Please%20like%20us&style=social)](https://github.com/mrz1836/sigil/stargazers)







## 📝 License



[![License](https://img.shields.io/github/license/mrz1836/sigil.svg?style=flat&v=2)](LICENSE)