Dashboard Guide

This guide walks you through the complete Veil user flow — from installing a Midnight wallet to minting your identity pass and sharing your Veil DID with apps that support Veil credit checks.

Overview

The Veil dashboard is the primary interface for end users. Through it, you will:

1. Connect your Midnight wallet (1AM or Lace)
2. Create your Veil ID — derives a private key used by the scoring system
3. Create your credit profile — initializes your private score entry on Midnight
4. Connect your CKB wallet and mint an identity pass on CKB
5. Receive your Veil DID (did:veil:0x…) — a portable identity you share with apps
6. Run a credit check to see your current score band

Each step is a separate action on the dashboard with a visual progress tracker. You can complete them one at a time and return later. Your progress is persisted in your browser's local storage, linked to your Midnight wallet and the current Veil contract address.

Step 1: Install a Midnight Wallet

Veil supports two Midnight browser wallets. 1AM is the preferred wallet; Lace is also fully supported. Both store your private key locally, sign Midnight transactions, and communicate with apps via the Midnight DApp Connector API.

1. Install your chosen wallet extension from midnight.network.
2. Open the extension, choose "Create a new wallet" or "Import existing," and follow the seed phrase setup flow.
3. Ensure the wallet is connected to the correct Midnight network for the Veil deployment you are using (Preview for testnet, mainnet when live).

Step 2: Connect Wallet to the Veil Dashboard

Open the Veil Protocol dashboard in your browser. You will see a wallet selection screen on the dashboard page.

1. Click the wallet button for your Midnight wallet (1AM or Lace).
2. A popup from your wallet extension will ask for permission to connect. Click Connect.
3. The dashboard will load with your Midnight wallet address shown in the session bar at the top.

If the connection popup does not appear, ensure your wallet extension is active (click the puzzle icon in your browser toolbar to find and pin it) and try again.

Step 3: Create Veil ID

This step derives a private key from your Midnight wallet that the scoring system uses to find and update your credit profile. It does not create an on-chain transaction — it only prepares local browser data.

1. On the dashboard, locate the Create Veil ID section and click Create Veil ID.
2. Wait while the dashboard sets up your private browser data. This typically takes a few seconds.
3. When complete, the progress tracker advances and your Veil Key becomes visible in the panel.

Step 4: View Your Veil Key

After creating your Veil ID, the dashboard shows your Veil Key — a public key that the scoring system uses to locate your private credit profile. Think of it as your scoring system handle, separate from any wallet address you use on other chains.

• The Veil Key is also called userPk in the API. Protocols that submit behavioral data for you use this key to key those events to your profile.
• The Veil Key itself is not your Veil DID. Your DID (did:veil:0x…) is derived from a hash of this key and is created when you mint your identity pass.
• The Veil Key cannot be used to recover your Midnight private key, and it does not reveal your wallet addresses on Ethereum, Polygon, or any other chain.

Step 5: Create a Credit Profile

Creating a credit profile submits a transaction on Midnight that reserves a private score slot for your Veil Key. Until this step is done, apps cannot run a credit check for you, and behavioral events submitted by protocols cannot be applied to your score.

1. Make sure your CKB wallet is connected first (see Step 6 below). The dashboard needs your CKB address to prepare the identity pass mint at the same time.
2. Click Create Credit Profile.
3. Wait for confirmation. The dashboard will show Confirmed next to Credit Profile when the Midnight transaction settles (this may take 30–90 seconds while the ZK proof is generated).

At this point your score is unranked. As supported apps submit repayment and usage history for your Veil Key, your score improves over time.

Step 6: Connect Your CKB Wallet

A CKB wallet is required to mint your identity pass. The identity pass is a small record stored permanently on the CKB blockchain that proves your Veil DID belongs to your CKB wallet — without revealing your score or Midnight details.

1. Click Connect CKB in the top bar or the CKB wallet button in the action panel.
2. Select your CKB wallet from the list. Supported options include JoyID, MetaMask with CKB support, and other CCC-compatible wallets.
3. Follow the connection flow for your wallet. For JoyID, scan the QR code with your phone. For MetaMask, install the CKB snap if prompted.
4. Confirm that a CKB address appears in the session bar at the top of the dashboard.

Step 7: Mint Your Identity Pass

Your identity pass is a permanent, public record on the CKB blockchain that links your Veil DID to your CKB wallet. Minting it also registers your DID on the Midnight DID Registry, making it resolvable by any protocol that wants to run a credit check.

1. Click Mint Identity Pass in CKB Wallet. The dashboard will prepare the CKB transaction with the identity data shown below.

{
  "protocol": "Veil",
  "objectType": "VeilIdentity",
  "veilIdHash": "0x...",
  "ownerCkbLockHash": "0x...",
  "midnightNetwork": "preprod",
  "midnightContract": "7c7d7b78ebcf6a67862fde64d5717f08109cadf0666b90b3b8179aef15ec1b9e",
  "version": "1"
}

2. Review the transaction in your CKB wallet. You pay a small amount of CKB to cover the cell storage cost (typically 150–250 CKB) plus a small miner fee.
3. Confirm the transaction in your wallet. It usually confirms on CKB testnet within 30–60 seconds.
4. Once confirmed, the dashboard shows your minted identity pass card with:
   • Your Veil ID — this is your did:veil:0x… identifier
   • Record ID — the CKB Spore object ID
   • ID Hash — the veilIdHash stored inside the pass
   • A View Transaction link to the CKB explorer

Step 8: Check Your Credit

Once your identity pass is minted, you can run a credit check. This uses your Veil DID to look up your private Midnight score and returns a result without ever revealing the raw score value.

1. Click Check My Credit on the dashboard.
2. Your CKB wallet signs a short authorization message. This proves you control the identity pass without sending any private keys to the backend.
3. When complete, your current credit band is shown: Unranked, Bronze, Silver, Gold, or Platinum.

The authorization message your CKB wallet signs:

Veil credit decision authorization
did:<your-veil-did>
challenge:<challengeHex>
verificationMethod:<your-veil-did>#ckb-owner-1
registryVersion:1
purpose:credit-decision

You can run a new check at any time to refresh your status with the latest activity submitted by partner protocols.

Sharing Your Veil DID

After minting your identity pass, the dashboard shows two convenient ways to share your Veil DID with apps:

• Copy ID — copies your full did:veil:0x… identifier to your clipboard. Paste this into any app that requests your Veil DID.
• QR code panel — on the left side of the dashboard, a QR code appears that encodes a verification URL. Apps can scan this QR to resolve your DID and request a credit decision without you typing anything.
• Copy Verify Link — copies the full DID resolution URL to your clipboard, which points to GET /api/v1/dids/resolve?did=did:veil:0x…. Send this link to an app or developer who wants to verify your identity programmatically.

Frequently Asked Questions

Does Veil know my wallet address?

Veil's scoring system uses private identifiers — your Veil Key and Veil DID — that do not reveal your wallet addresses on Ethereum, Polygon, or any other chain. Your CKB wallet address is associated with your identity pass on the public CKB blockchain, but only in the context of Veil and only if you choose to connect that wallet.

What is the difference between my Veil Key and my Veil DID?

Your Veil Key (userPk) is an internal scoring system identifier derived from your Midnight wallet. Protocols use it to submit behavioral events for your score. Your Veil DID (did:veil:0x…) is a public, portable identity identifier built from a hash of your Veil Key. The DID is what you share with apps to authorize credit checks — protocols only need the DID, not the raw Veil Key.

Can I lose my credit score?

Your score is stored in private state on Midnight, linked to your Veil Key. As long as you keep your Midnight wallet (or its seed phrase), your Veil Key stays the same and your score is intact. Your browser's local storage also caches your completed dashboard flow, so returning to the dashboard with the same wallet restores your identity pass view without reloading ZK assets.

What happens if I lose my CKB wallet?

Your identity pass on CKB is permanent. If you lose your CKB wallet, you cannot sign new credit check requests for that pass. Your Midnight score still exists, but you would need to use a new CKB wallet and mint a fresh identity pass, which creates a new Veil DID.

Which DeFi protocols currently submit behavioral data to Veil?

Veil is currently in beta. Partner protocols can submit behavioral data through the API. Check the project GitHub or community channels for the current list of integrated partners.