SettleMint
User guidesUser management

Register user

Register users in the identity registry for compliance tracking and token eligibility.

This guide explains how to register users in the identity registry - a required step for compliance tracking and token eligibility.

Prerequisites

  • Identity Manager role or equivalent permissions
  • Users must have completed onboarding with on-chain identity
  • Understanding of user jurisdiction requirements

About identity registry

The identity registry is an on-chain system that:

  • Tracks all verified identities for your organization
  • Links wallet addresses to identity contracts
  • Enforces jurisdictional rules

Identity states

StateDescriptionCan receive assets
Pending RegistrationOnboarded but not in registryNo
RegisteredIn registry, awaiting verificationDepends on rules
VerifiedHas required verificationsYes

Registering users

Access user management

Navigate to Participants > Users. You'll see all users with their name, email, EOA (wallet address), type, identity address, and status.

Select unregistered user

Find and click on a user you want to register. The user details page shows their information, identity contract details, current registration status, and available actions.

Unregistered user profile

Initiate registration

Click Register Identity (top right button) to begin the registration process. This opens the registration flow.

Select jurisdiction

Choose the user's country from the dropdown. Jurisdiction determines applicable regulatory requirements, compliance rules, investment limits, and verification requirements.

Jurisdiction importance

Country selection can be used in compliance rules but doesn't automatically apply specific rules. Choose based on user's legal residence or incorporation, not temporary location.

Complete registration

Click Continue after selecting jurisdiction, review the summary, then click Register identity. Enter your PIN when prompted and wait for blockchain confirmation. The registry contract adds the user's identity to the registry and links it to their wallet address.

Verify registration

After transaction confirmation, the user status changes to "Registered". The user is now in the identity registry and ready to receive verifications.

Best practices

Enrollment timing

  • Enroll users promptly after onboarding completion
  • Verify user information before enrollment
  • Document enrollment decisions for audit

Jurisdiction selection

  • Use user's legal residence or incorporation
  • Verify jurisdiction through documentation
  • Consider tax and regulatory implications
  • Update if user's status changes

Security considerations

  • Verify identity before enrollment
  • Monitor for duplicate enrollments
  • Audit enrollment activities
  • Maintain enrollment records

Integration with compliance

Token transfers

  • Enrolled identities can receive assets (with proper verifications)
  • Non-enrolled identities are blocked from asset transactions
  • Different assets may have different enrollment requirements

Compliance modules

  • Identity verification module checks registry enrollment
  • Transfer restrictions enforce enrollment requirements
  • Compliance reporting tracks enrolled vs. non-enrolled users

Verification process

  • Enrollment is prerequisite for issuing verifications
  • Verifications can only be added to enrolled identities
  • Multiple verifications can be issued per enrolled identity

Troubleshooting

IssueSolution
Cannot see Register button• Verify you have Identity Manager role
• Check user has completed onboarding
• Ensure user has on-chain identity
Registration transaction fails• Check wallet has sufficient gas
• Verify correct user is selected
• Ensure network connectivity
User still shows as Pending• Wait for blockchain confirmation
• Refresh the page
• Check transaction was successful
Cannot select jurisdiction• Ensure valid country is available
• Check compliance settings
• Verify no existing registration

On this page