← Common Credo

For holders

A holder is the person or business a record is about. Your records are yours. They live on your own device, not in anyone's database. You decide who to show them to, and you can dispute a cancellation or withdraw a record entirely — without needing anyone else's permission.

The wallet holds the records issuers give you, lets you gather a selection into a bundle to show a verifier, and lets you file a dispute or a withdrawal, each published at an address only you control.

On your phone

The wallet runs in your phone's web browser and installs to your home screen — there is nothing to download from an app store, and no account to create.

iPhone (Safari)

  1. Open this page in Safari (not another app).
  2. Tap the Share icon at the bottom of the screen (a square with an arrow pointing up).
  3. Scroll down and tap "Add to Home Screen".
  4. Tap "Add" to confirm.
  5. Open the new icon from your home screen — that is when you set up your wallet for the first time (see below).

Android (Chrome)

  1. Open this page in Chrome.
  2. Tap the menu (the three dots in the top-right corner).
  3. Tap "Add to Home screen" (it may say "Install app"). If a bar offering to install appears at the bottom of the screen, you can tap that instead.
  4. Tap "Add" (or "Install") to confirm.
  5. Open the new icon from your home screen — that is when you set up your wallet for the first time (see below).

On a computer

You can also run the wallet as a program on a computer. This is the same tool; use it if you prefer a computer, or if your phone browser cannot install the wallet.

Each download is about 22–28 MB, because the program it needs to run is bundled inside so there is nothing else to install. The first time you run it, your operating system will warn you that it is from an "unidentified developer" — because the program is not yet signed, not because anything is wrong. On Windows, click "More info" then "Run anyway"; on macOS, right-click the program, choose "Open", then "Open" again. A key set up on the phone wallet and one set up on the computer use the same encrypted key file, so you can move between them.

Setting up and using it

  1. Set up your wallet once: it makes your own key, shows you a backup, and asks you to confirm you saved it. Set a password to protect the key on this device.
  2. Back up your key. There is no recovery for a lost key — no one can reset it for you. Save the secret key it shows you, and also use "Export key file" to keep an encrypted copy in your phone's Files (or on your computer). A phone can clear a website's stored data if it runs low on space; the exported key file is how you get your identity back if that happens, or when you move to a new phone.
  3. Import a record. When an issuer gives you a record file, choose "Import a record" and select or paste it. The wallet checks the seal before adding it.
  4. Show a bundle. Choose which records to include, and the wallet produces a single file (or a share) you can hand to a verifier. You choose what to show; you can leave anything out.
  5. Dispute or withdraw. If an issuer cancels a record and you disagree, file a dispute (with a reason). If you want a record out of circulation for any reason, withdraw it. Both take effect on their own, with no issuer involved — and both are permanent and public, so the wallet warns you before you confirm.

Still early, stated plainly. The phone wallet is new. It has been tested in a browser but not yet across the full range of real phones; if you depend on it, keep your exported key file safe and let us know what breaks. It needs a connection to publish and to check status; it opens and shows your saved records offline, but cannot reach the relays without one.

Common Credo · the wallet is AGPL-3.0.