Marigold is digital cash in fixed notes. A note of 1, 10, 100 or 1,000 is yours when you hold its key, changes hands as a code, and never sits in an account. The testnet is open: take some from the faucet, pay a friend, be paid back, mine a few with spare CPU, and tell us what broke.
Three steps
From nothing to a wallet with money in it
Get the wallet
The Marigold wallet is an app for your computer. Pick your system and download it; the page guesses from your browser.
- Double-click the .dmg file you downloaded. A new window opens.
- Drag the Marigold icon onto the Applications icon.
- Go to Applications and double-click Marigold.
The first time you open it, your Mac will say the app is damaged. It is not: the app is not yet signed with Apple, and on an Apple-silicon Mac that is the message you get. One command fixes it, once.
- Click Cancel on the message.
- Open Terminal (press ⌘ Space, type Terminal, press Enter) and paste this line, then press Enter:
xattr -dr com.apple.quarantine "/Applications/Marigold.app"
- Open Marigold from Applications again.
The Mac's Gatekeeper refuses the app's ad-hoc signature; the command removes the quarantine mark it set on the download. Nothing else changes. The signatures come soon, and the step with them goes away.
The first time you open it, your Mac will refuse. That is us, not malware: the app is not yet signed with Apple, and the Mac says so. It happens once.
- Click Done on the message.
- Open System Settings, then Privacy & Security, and scroll down.
- Click Open Anyway next to Marigold, then open Marigold again.
The first time you start the installer, Windows will show a blue screen. That is us, not malware: the installer is not yet signed with a certificate, and Windows says so. It happens once.
- Click More info on the blue screen.
- Click Run anyway.
Linux asks nothing. Install the package the way you install any other: double-click it, or in a terminal in your Downloads folder:
sudo apt install ./marigold-wallet-VERSION-linux-x86_64.deb
Marigold then appears in your applications menu, and the package manager keeps it.
Linux asks nothing. Install the package the way you install any other: double-click it, or in a terminal in your Downloads folder:
sudo dnf install ./marigold-wallet-VERSION-linux-x86_64.rpm
On openSUSE, sudo zypper install with the same file. Marigold then appears in your applications menu.
Linux asks nothing, but an AppImage has to be allowed to run. Right-click the downloaded file, choose Properties, and tick "Allow executing file as program" (or "Executable as Program"), then double-click it. In a terminal, the same is:
chmod +x marigold-wallet-VERSION-linux-x86_64.AppImage
./marigold-wallet-VERSION-linux-x86_64.AppImage
Nothing is installed; the file is the app. Keep it where you like. If it refuses to start with a message about FUSE, install libfuse2 from your package manager once.
What you install is exactly what our public build made; from then on the app updates itself after asking you. The signatures come with marigold.cash Ltd, the company behind Marigold.
Other ways: the terminal wallet, Docker, a Raspberry Pi
The same wallet as commands in a terminal, one file and no install, for Linux, macOS, Windows and the Raspberry Pi: the marigold-cli files on the release page. It updates itself too: type update.
Or the Docker image, if you would rather not run a downloaded program:
mkdir -p ~/.marigold
curl -fsSLO https://raw.githubusercontent.com/marigoldcash/marigold-wallet/main/docker-compose.yml
docker compose run --rm wallet
Make a wallet, write down the words
Open the app and choose Create one: a name and a password. The app then shows 24 words and asks two of them back. Write them on paper or put them in your password manager, never a screenshot: they are the key to everything, and the only thing that opens a backup.
Then choose how to reach the network. A public computer works at once; Sync here, inside the app keeps a copy of the network on your computer so nobody sees which notes are yours, and takes a while the first time.
Take a note
The faucet hands out three real bearer notes, 10, 1 and 0.1, once an hour. Copy each code, open the Pay tab in the app ("A code you were given"), paste it and press Take it, the big one first, and it is yours alone. The Balance tab shows it.
Then
Things worth trying
Pay someone
pay 5 prints a code and a QR. Whoever you give it to types receive and the code; the notes are theirs the moment it lands, and nobody, you included, can spend them after.
Be paid while you are away
receive key makes a key of yours to hand out. A payment to it is locked: the sender cannot touch it, only you can take it, and if you never do it goes back to them by itself.
Mine with spare CPU
mine start in a wallet that syncs its own copy, or marigold-cli mine-to <address> 50 as a service. The threads run at the lowest priority the machine has; you will not feel them.
Your phone
Make a Telegram bot of your own, pair it with telegram link (the Backup tab in the app), and your wallet answers it: balance, pay, receive, a QR to scan. The keys never leave your machine.
Read
Why notes, and how they hold up
For companies
Prove your records were there
If your business signs contracts, attendance sheets, invoices or reports, you will one day have to prove that a record existed on a particular day and has not been altered since. Marigold gives your company a lane of its own on the chain to make that proof, and a way to check it that depends on nobody, us included.
The testnet