# Install grin-wallet with Homebrew

Official wallet for the cryptocurrency Grin. Version 5.4.1 via Homebrew; verified 2026-06-12.

## Install

```sh
sudo av install brew:grin-wallet
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install grin-wallet
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:grin-wallet
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/grin-wallet>
- **Version:** 5.4.1
- **Source summary:** Official wallet for the cryptocurrency Grin
- **Homepage:** <https://grin.mw>
- **Repository:** <https://github.com/mimblewimble/grin-wallet>
- **Upstream docs:** <https://docs.grin.mw/getting-started/wallet-handbook>
- **License:** Apache-2.0
- **Source archive:** <https://github.com/mimblewimble/grin-wallet/archive/refs/tags/v5.4.1.tar.gz>
- **Last updated:** 2026-06-12T04:09:37Z
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- grin-wallet (cli)
- grin-wallet (alias)

## Build dependencies

- pkgconf
- rust

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 5.4.1
- Package-manager updated: 2026-06-12
- Local data: ok
- Upstream repository: https://github.com/mimblewimble/grin-wallet
- Upstream latest detected: v5.4.1 (current)
## Project history and usage

Grin Wallet is the reference wallet implementation for Grin, the Mimblewimble-based cryptocurrency. In package-manager terms it is the companion CLI to the Grin node: users install it to create wallet seeds, track outputs, construct transactions, and interact with a local or remote Grin node.

### Project history

The wallet grew with Grin rather than as a detached third-party client. Its repository describes two major pieces: wallet APIs for community wallet developers and a reference command-line wallet showing how those APIs are intended to be called. That split made the package both an end-user executable and a reference integration surface for other Grin wallets.

Grin's interactive transaction model shaped the wallet's evolution. Instead of a Bitcoin-style address-only send flow, early Grin transactions required sender and receiver coordination. The wallet therefore became the place where file-based slates, HTTP/Tor flows, payment proofs, and later Slatepack transaction exchange were exposed to users.

### Adoption history

The Grin documentation treats `grin-wallet` as one of the two precompiled command-line binaries used in the quickstart path, alongside the `grin` node. That made it the default CLI wallet for operators and developers following the official documentation.

Slatepack broadened the wallet's role in the ecosystem. Official Grin documentation describes Slatepack as a universal transaction standard, introduced in the 4.0 wallet line and required for ecosystem compatibility by the 5.0 line. Wallets and services therefore had to track the reference wallet's transaction workflow.

### How it is used

A typical package-manager user installs `grin-wallet`, initializes a wallet, stores the recovery phrase, and uses commands such as send, receive, finalize, post, and listen. The official handbook documents manual Slatepack posting and transaction handling, which are especially important for offline or asynchronous exchange.

The package matters less as a graphical wallet and more as a scriptable baseline. Its CLI and JSON-RPC API give developers a stable way to test Grin wallet behavior, while operators use it for node-adjacent wallet administration.

### Why package nerds care

For package nerds, `grin-wallet` is interesting because it packages the complicated half of a privacy coin: local key material, output scanning, transaction state, Tor-mediated interaction, and evolving transaction formats. The package's config and seed files are as operationally important as the executable.

It also illustrates why cryptocurrency formulae often split node and wallet packages. The Grin node can sync and validate the chain without holding user keys; the wallet carries the user state, secrets, and transaction workflow.

### Timeline

- 2016: Grin development began as a minimal Mimblewimble implementation.
- 2019: Grin mainnet launched, making a reference wallet necessary for normal user transactions.
- 2019: Payment proof work was proposed for sender-initiated transactions.
- 2020: Grin Wallet 4.0 introduced the Slatepack format and workflow.
- 2021: The Grin 5.0 compatibility point made Slatepack support mandatory for wallets and services.

### Related projects

- Grin provides the node and consensus implementation that the wallet talks to.
- Grin RFCs document wallet-affecting standards such as payment proofs, wallet lifecycle, compact slates, and Slatepack.
- Grin++ and Niffler are related wallet projects documented by Grin as alternate user-facing wallets.

### Sources

- <https://docs.grin.mw/about-grin/story/>
- <https://docs.grin.mw/getting-started/quickstart/install/>
- <https://docs.grin.mw/getting-started/wallet-handbook/>
- <https://docs.grin.mw/wiki/services/slatepack-integration/>
- <https://docs.grin.mw/wiki/transactions/slatepack/>
- <https://github.com/mimblewimble/grin-wallet>
- <https://github.com/mimblewimble/grin-wallet/issues/456>


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ~/.grin/main/grin-wallet.toml

## Credential files

- Unix: ~/.grin/main/wallet_data/wallet.seed, ~/.grin/main/.owner_api_secret, ~/.grin/main/.foreign_api_secret
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** grin-wallet
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable


## Related links

- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Homebrew utility packages](https://www.automicvault.com/pkg/brew-utility-packages/) - Matched Homebrew package provider.
- [pkgconf](https://www.automicvault.com/pkg/brew/pkgconf/) - Build dependency declared by Homebrew.
- [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew.
- [grin](https://www.automicvault.com/pkg/brew/grin/) - Shares av.db curated category or tags: cli, cryptocurrency, mimblewimble, networking.
- [groestlcoin](https://www.automicvault.com/pkg/brew/groestlcoin/) - Shares av.db curated category or tags: cli, cryptocurrency, networking, wallet.
- [bitcoin](https://www.automicvault.com/pkg/brew/bitcoin/) - Shares av.db curated category or tags: cli, cryptocurrency, networking, wallet.
- [core-lightning](https://www.automicvault.com/pkg/brew/core-lightning/) - Shares av.db curated category or tags: cli, cryptocurrency, networking.
- [btcli](https://www.automicvault.com/pkg/brew/btcli/) - Shares av.db curated category or tags: cli, networking, wallet.
- [oasis](https://www.automicvault.com/pkg/brew/oasis/) - Shares av.db curated category or tags: cli, networking, wallet.
- [ord](https://www.automicvault.com/pkg/brew/ord/) - Shares av.db curated category or tags: cli, networking, wallet.
- [activemq](https://www.automicvault.com/pkg/brew/activemq/) - Shares av.db curated category or tags: cli, networking.

## Combined YAML source

View the package source record on GitHub. [combined/grin-wallet.yml](https://github.com/automic-vault/db/blob/main/combined/grin-wallet.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
