SettleMint
Developer guidesPlatform setup

Platform setup overview

API-based platform setup, administrator role management, and system configuration.

This overview covers platform setup through the API, administrator role management, and key concepts for configuring your asset tokenization platform programmatically. Use this as a reference when automating platform administration, integrating with provisioning systems, or building custom tooling.

Platform dashboard after initial setup

For the web interface approach, see Platform Overview (User Guide).

Setup workflow

The platform setup follows this sequence:

  1. First administrator setup - Initialize platform and create first admin
  2. Add administrators - Grant roles to team members
  3. Change admin roles - Modify permissions as needed
  4. Configure compliance - Set up verification framework and policies
  5. Create assets - Begin tokenizing real-world assets

Key concepts

Platform vs asset administration

  • Platform administrators - Manage system-wide operations and configuration
  • Asset administrators - Control individual token operations (assigned per asset)
  • Platform roles - Apply across the entire platform
  • Asset roles - Specific to individual tokens

Permission model

  • On-chain permissions - All roles stored in smart contracts
  • Principle of least privilege - Grant minimum necessary permissions
  • Separation of duties - Divide critical functions among multiple admins
  • Immediate effect - Role changes take effect instantly

Platform vs Asset roles

This overview covers platform administrator roles only. Asset-specific roles (like Asset Operator, Custodian, Supply Management) are assigned per token and covered in asset creation guides.

Available platform roles

RoleDescriptionKey Permissions
Permission managerPermission managementManage other administrators' roles and permissions
System managerSystem configurationDeploy contracts, manage system settings
Asset managerAsset creation and managementCreate tokens, configure asset properties
Identity managerUser administrationInvite users, manage user identities
Verification issuerIssue verificationsCreate and manage verification records
Verification policy managerTrust framework configurationConfigure trusted issuers and verification topics
Compliance managerGlobal compliance rulesSet platform-wide compliance policies
Addon managerPlatform extension managementInstall and configure platform addons

Setup guides

Platform initialization

  • First Admin Setup - Create first administrator and initialize platform infrastructure

Administrator management

On this page