SettleMint
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.

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

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.

StateWhat it meansCan receive regulated assets
Pending registrationThe user has a wallet and OnchainID, but the registry does not yet mark the identity as active.No
RegisteredThe 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 assetThe 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

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

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

Start identity registration

Click Register Identity. The registration sheet opens for the selected identity and wallet.

Select the user's 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.

Jurisdiction controls eligibility checks

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 country and wallet address shown in the confirmation step. If either value is wrong, go back before signing.

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

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

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

  • 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

  • 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

  • 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

IssueWhat to check
Cannot see Register IdentityConfirm your role includes identity registration, the user has completed onboarding, and the user has an OnchainID.
Registration transaction failsCheck the signing wallet, wallet verification prompt, gas or network availability, and whether the selected identity is already registered.
User still shows as pendingWait for blockchain confirmation and indexing, refresh the page, then confirm the transaction succeeded.
Cannot select jurisdictionConfirm a valid country is available and that the user does not already have an active registration.
Registered user still cannot receive an assetCheck the asset's required claim topics, trusted issuer configuration, country rules, and transfer restrictions. Registration alone does not satisfy every asset rule.

On this page