# Register user Source: https://docs.settlemint.com/docs/operators/user-management/register-user Register a user's wallet and OnchainID in the identity registry so DALP can evaluate asset eligibility against trusted issuer claims and country rules. Registering a user links their wallet address, OnchainID identity, and jurisdiction in the identity registry. The registry entry lets DALP resolve the wallet during mint and transfer checks. It does not, by itself, make the user eligible for every regulated asset. Eligibility also depends on the asset's required claim topics, trusted issuers, country rules, and transfer restrictions. KYC evidence stays off-chain with the verifier and operator workflow. DALP records the result on the user's OnchainID as claims, such as KYC or AML topics, plus the issuer that signed them. When a regulated token checks a mint or transfer, DALP resolves the wallet through the identity registry, reads the required claims, verifies that each claim issuer is trusted for the matching topic, and then evaluates the configured compliance modules. Missing claims, claims from issuers that are not trusted for the required topic, or failed country and transfer rules can block eligibility. For the underlying identity model, see [Claims and identity](/docs/architects/concepts/claims-and-identity). ## Prerequisites [#prerequisites] * Identity Manager role or equivalent permissions. * A user with a wallet and OnchainID created during onboarding. * A confirmed jurisdiction for the user. DALP registration routes use ISO 3166 alpha-2 country codes, and the dapp submits the selected country on-chain. * Wallet verification for the signing user. The dapp asks for the wallet approval method before it submits the registration transaction. ## What registration changes [#what-registration-changes] Registration writes the wallet-to-identity relationship into the active identity registry. The user moves from a pending identity state to a registered identity state after the transaction is confirmed and indexed. | State | What it means | Can receive regulated assets | | --------------------- | -------------------------------------------------------------------------------------------------------------------- | ------------------------------------------- | | Pending registration | The user has a wallet and OnchainID, but the registry does not yet mark the identity as active. | No | | Registered | The registry can resolve the user's wallet to an active OnchainID and country. Required claims may still be missing. | Depends on the asset rules | | Verified for an asset | The registered identity has the claim topics required by that asset, signed by trusted issuers for those topics. | Yes, when the other compliance modules pass | Registration is therefore the identity-registry step in a broader compliance flow. Trusted issuer claims, KYC review, country restrictions, and transfer approval rules still control whether a specific asset can be minted or transferred to the user. ## Before you register [#before-you-register] Review these details before submitting the transaction: * The selected user is the intended holder or operator account. * The wallet address shown on the user profile is the wallet you want to bind to the OnchainID. * The OnchainID address belongs to the selected user. * The country selection reflects the user's legal residence or incorporation, not a temporary location. * Any required KYC, KYB, AML, sanctions, accreditation, or other off-chain review is complete before a trusted issuer issues claims. ## Register a user [#register-a-user] ### Open the user profile [#open-the-user-profile] Navigate to **Participants** > **Users** and select the user you want to register. The profile shows the user's name, email, wallet address, identity address, registration status, and available actions. ![Unregistered user profile](/docs/user-management/user-profile-unregistered.webp) ### Start identity registration [#start-identity-registration] Click **Register Identity**. The registration sheet opens for the selected identity and wallet. ### Select the user's jurisdiction [#select-the-users-jurisdiction] Choose the user's country from the dropdown. DALP validates the value as an ISO 3166 alpha-2 country code before the transaction is submitted. Country selection can be used by compliance rules, but it does not automatically apply a legal rule or verification result. Choose the country from the user's legal residence or incorporation evidence. ### Review the summary [#review-the-summary] Review the country and wallet address shown in the confirmation step. If either value is wrong, go back before signing. ### Sign and submit the registration [#sign-and-submit-the-registration] Click **Register identity**, complete the wallet verification prompt, and wait for blockchain confirmation. The registry contract links the user's wallet address to their OnchainID and country code. ### Confirm the registered state [#confirm-the-registered-state] After confirmation and indexing, the user status changes to **Registered**. The user can now receive trusted issuer claims and can pass asset eligibility checks when the required claims and compliance rules also pass. ## Compliance impact [#compliance-impact] ### Token mints and transfers [#token-mints-and-transfers] * Non-registered identities are blocked from regulated asset transactions. * Registered identities are eligible only when the token's compliance rules pass. * An identity-verification rule can require one claim topic, such as KYC, or a logical expression such as KYC and AML. * The required claim must be present on the user's OnchainID and issued by a trusted issuer authorised for that topic. * Different assets can require different claim topics, trusted issuers, country rules, or transfer approvals. ### Compliance modules [#compliance-modules] * Identity verification modules check registry enrolment and required claim topics. * Country and transfer-restriction modules can apply additional rules after identity lookup. * A single failing module blocks the mint or transfer. * Compliance reporting tracks enrolled, verified, and blocked users. ### Verification process [#verification-process] * KYC, KYB, AML, sanctions, accreditation, and document review happen off-chain before a verifier issues a claim. * The on-chain claim records the verification result, topic, issuer, signature, and supporting reference data. * Only issuers trusted for the relevant topic should issue claims used for transfer eligibility. * Multiple verifications can be issued per enrolled identity when different assets require different topics. ## Operational checks [#operational-checks] * Register users after onboarding creates the wallet and OnchainID. * Verify the user's legal residence or incorporation evidence before selecting the country. * Keep the off-chain evidence and approval record in your operating workflow. * Review duplicate or stale user records before registration. * Use the identity recovery workflow when the registered wallet is lost or compromised. A normal profile edit does not replace the registered wallet binding. ## Troubleshooting [#troubleshooting] | Issue | What to check | | --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Cannot see **Register Identity** | Confirm your role includes identity registration, the user has completed onboarding, and the user has an OnchainID. | | Registration transaction fails | Check the signing wallet, wallet verification prompt, gas or network availability, and whether the selected identity is already registered. | | User still shows as pending | Wait for blockchain confirmation and indexing, refresh the page, then confirm the transaction succeeded. | | Cannot select jurisdiction | Confirm a valid country is available and that the user does not already have an active registration. | | Registered user still cannot receive an asset | Check the asset's required claim topics, trusted issuer configuration, country rules, and transfer restrictions. Registration alone does not satisfy every asset rule. | ## Related guides [#related-guides] * [User onboarding](/docs/operators/user-management/user-onboarding) explains how users get a wallet and OnchainID before registration. * [Claims and identity](/docs/architects/concepts/claims-and-identity) explains how wallet registration, OnchainID claims, and trusted issuers work together. * [Identity and compliance](/docs/compliance-security/security/identity-compliance) covers how identity checks fit into the broader compliance architecture. * [Provide KYC data](/docs/operators/user-management/provide-kyc-data) explains how users complete their KYC profile. * [Manage KYC data](/docs/operators/compliance/manage-kyc-data) explains how operators review KYC submissions. * [Verify KYC](/docs/operators/compliance/verify-kyc) explains how verifiers issue claims after review. * [Configure trusted issuers](/docs/operators/compliance/configure-trusted-issuers) explains the issuer and claim-topic framework. * [Recover a user's identity](/docs/operators/user-management/recover-user-identity) covers lost or compromised wallet access.