Wallets

Nora only allows mints and burns to flow through wallets your organization has explicitly authorized. You can also register minter wallets through the Wallets API. On Solana, whitelister registration happens only on this page; on the EVM chains Nora provisions the whitelister for you. The Wallets page is where an org admin adds those wallets, picks a role, and signs the on-chain transaction that actually grants permission. Expect to visit this page twice in setup (once to add a whitelister, once to add a destination wallet) and then only when your destinations change.

The walkthrough from Add the first whitelister to Prepare again is Solana. For an EVM chain read Where to find it, then jump to Ethereum, Base and Polygon.

Where to find it

Sidebar → Wallets. Organization owners and admins only — the backend requireOrgAdmin check means members see a locked state and the item doesn't even render in their sidebar.

The page is environment-scoped: the instance picker at the top chooses Sandbox or Production, and your whitelist lives separately in each.

Add the first whitelister

A whitelister is the root-of-trust wallet that can authorize other wallets. You need at least one active whitelister before you can add a Minter/Burner wallet.

A whitelister can only grant roles — it cannot mint or burn itself, and a single wallet holds exactly one role. If you need both a whitelister and a Minter/Burner, use two separate wallets: one address cannot be registered under a second role.

1. On the Whitelisters tab (shown by default when the list is empty), click Add whitelister.
2. Pick Wallet address (paste a Solana public key) or Existing party (choose one from the dropdown of parties with Solana wallets on file).
3. Confirm Role is set to whitelister.
4. Click Continue. The backend grants the whitelister role directly; no signature is required for the first whitelister in this environment.

Add another wallet (Minter/Burner)

Once you have an active whitelister, you can authorize destination wallets.

1. Click Add wallet in the top right (or switch to the Approved Wallets tab and click Add wallet in the empty state).
2. Choose Wallet address or Existing party as the source.
3. Confirm Role is set to Minter/Burner. On-chain, minting and burning are a single permission — a wallet authorized to mint can also burn, and vice versa. There is no way to grant one without the other.
4. Pick a Signing whitelister — one of your active whitelister wallets will do the on-chain grant.
5. Click Continue. Nora prepares a Solana transaction and moves the dialog to the signing step.

Sign prepared transaction

1. The signing step shows the Required signer address and a Connect wallet button.
2. Connect the Solana wallet whose address matches the required signer. A mismatch surfaces a yellow Switch wallets to continue banner with a Switch wallet button.
3. Click Sign and submit. Your wallet extension (Phantom, Backpack, etc.) prompts you to approve the transaction.
4. Approve in the extension. Nora submits the signed transaction on-chain (idempotency-keyed, so duplicate submits are safe).
5. The dialog closes with a success toast; the wallet's state moves to active.

Prepare again

If a prepared transaction sits too long, the network blockhash expires. When that happens:

1. On a pending wallet row, click Prepare again.
2. The dialog reopens with the wallet pre-filled at the signing step — or, if the prepared transaction is already gone, at the form step so you can regenerate it.
3. Proceed through Sign and submit as above.

You can also click Prepare new transaction in the signing step itself if your wallet extension times out.

Copy wallet address

Each wallet row has a Copy button that puts the full base58 address on your clipboard — handy when you need to paste it into an intent, a support ticket, or a block explorer.

Gotchas

• Admin only. Org members without owner or admin role see DashboardLockedState with a message to ask an admin. There's no way for them to reach the add dialog.
• Wallet states are active, pending, revoked or banned. Pending wallets are stuck waiting on a signature; revoked wallets lost their on-chain grant; banned wallets have been rejected by the backend and can't be reused.
• Reconciliation status matters. Wallets carry a reconciliation flag: synced (matches on-chain), drifted (on-chain state diverged — warning banner, admin review needed before trusting), or missing_onchain (no on-chain status yet).
• The signing wallet adapter must match exactly. Nora refuses the submit if the connected wallet's public key differs from the prepared signer.
• Sandbox and production whitelists are separate. Switching instances shows a different set of wallets; approvals don't carry across.

Ethereum, Base and Polygon

The Chain selector at the top of the page switches between Solana and the EVM chains: Ethereum (Sepolia in sandbox, mainnet in production), Base (Base Sepolia / Base mainnet) and Polygon (Polygon Amoy / Polygon mainnet). The EVM view has the same layout — Whitelisters and Approved Wallets tabs, the same badges — and the same Add wallet button, which works on the chain you have selected.

• The whitelister row is your organization's BRSWhitelister contract on that chain, provisioned by Nora. Contact Nora if it is missing; you cannot add one here.
• Add wallet registers a Minter/Burner with Nora, then asks the whitelister's owner wallet to sign the grant. You enter the wallet's daily limit in BRS; if the contract already holds a different limit for it, that one wins and the dialog says so. Connect the owner wallet in your browser; the dialog switches it to the right network. If the owner is a Safe or a cold wallet, click Register and sign elsewhere, copy the to and data the dialog then shows, and sign there; the row activates on its own once the transaction confirms.
• The same registration is available from your backend with POST /v2/wallets and the chain's chainId; the calldata flow is Path C of the whitelisting guide.
• Once the on-chain grant lands the wallet shows active and becomes selectable as a mint destination in Mint / Burn. A pending row is still awaiting its grant.

See also

• Addresses — BRS addresses and explorers per chain.
• Mint / Burn intents — where an unauthorized destination wallet is refused.
• Parties setup (integrators) — how wallets bind to parties on the integrator side.