# Console

Source: https://docs.settlemint.com/docs/architects/components/platform/console
The Console is DALP's authenticated web interface for asset lifecycle
operations. It gives operators a guided view over asset design, holdings,
compliance checks, and theme configuration while keeping execution, policy,
and audit evidence in the platform services behind it.




## Overview [#overview]

The Console is DALP's authenticated web interface. Operators and compliance reviewers use it to work with digital asset workflows. The Console is not a separate ledger or policy engine.

It sits above the Platform API, Workflow Engine, contract runtime, and indexer. You work with governed asset data through it. Platform services keep execution controls, policy checks, and audit evidence intact.

<Mermaid
  chart="`flowchart TB
  subgraph UI[&#x22;Console&#x22;]
    DASH(Dashboard and navigation)
    DESIGN(Asset Designer)
    PORT(Portfolio and asset views)
    BRAND(Branding and localization)
  end

  subgraph API[&#x22;Platform API and platform services&#x22;]
    PROC(API procedures and validation)
    DOCS(Document and evidence workflows)
    IDX(Indexer and read models)
  end

  subgraph EXEC[&#x22;Execution layer&#x22;]
    ENGINE(DALP Workflow Engine)
    CHAIN(Contract runtime)
  end

  DASH --> PROC
  DESIGN --> PROC
  PORT --> IDX
  BRAND --> PROC
  PROC --> DOCS
  PROC --> ENGINE
  ENGINE --> CHAIN
  CHAIN --> IDX

  style DASH fill:#5fc9bf,stroke:#3a9d96,stroke-width:2px,color:#fff
  style DESIGN fill:#5fc9bf,stroke:#3a9d96,stroke-width:2px,color:#fff
  style PORT fill:#5fc9bf,stroke:#3a9d96,stroke-width:2px,color:#fff
  style BRAND fill:#5fc9bf,stroke:#3a9d96,stroke-width:2px,color:#fff
  style PROC fill:#6ba4d4,stroke:#4a7ba8,stroke-width:2px,color:#fff
  style DOCS fill:#6ba4d4,stroke:#4a7ba8,stroke-width:2px,color:#fff
  style IDX fill:#6ba4d4,stroke:#4a7ba8,stroke-width:2px,color:#fff
  style ENGINE fill:#8571d9,stroke:#654bad,stroke-width:2px,color:#fff
  style CHAIN fill:#8571d9,stroke:#654bad,stroke-width:2px,color:#fff`"
/>

The same platform controls apply whether a user works in the Console or an application calls the Platform API. The interface helps users complete work safely. The backing services validate and authorize each request before executing it. Indexing and evidence retrieval stay there as well.

## What the Console owns [#what-the-console-owns]

The Console owns the operator experience. Operators complete asset work through its guided screens and forms. Status views and previews give them the context they need, with no API calls required for routine workflows.

| Console surface                    | What it helps users do                                                                                                     | Backing platform responsibility                                                       |
| ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| Dashboard and navigation           | Find asset, token, onboarding, and operational surfaces                                                                    | Route users to authenticated application areas                                        |
| Asset Designer                     | Define an asset through guided steps for class, basics, instrument template, compliance template, permissions, and summary | Validate payloads and pass executable requests to platform services                   |
| Portfolio and asset views          | Inspect holdings, asset state, and indexed transaction information                                                         | Reconstruct confirmed state from indexed chain and platform events                    |
| Branding and language controls     | Render tenant-specific logos, images, colors, fonts, and translated interface text                                         | Store and validate theme payloads and language resources                              |
| Document and evidence entry points | Link users to KYC, token-document, and operational evidence workflows                                                      | Enforce document authorization and retrieve protected files through the relevant APIs |

The Console does not replace the API's role in the architecture. Use the [Platform API](/docs/architects/components/platform/platform-api) when your system needs repeatable programmatic access.

## Asset design workflow [#asset-design-workflow]

The Asset Designer is the Console workflow for preparing an asset before execution. Its steps cover:

* asset class choice
* asset basics
* instrument template selection
* instrument-specific details
* compliance template choice
* initial asset permissions
* summary review

![Asset Designer workflow](/docs/screenshots/asset-designer/asset-designer.webp)

The design flow guides operators from business shape to implementation details, then to a final review. Platform services validate and execute the requested lifecycle change after the interface hands off the request.

The Console can also surface missing prerequisites. For example, a template step can direct users to create or register a required asset shape before continuing.

## Security and tenancy responsibilities [#security-and-tenancy-responsibilities]

The Console is an authenticated client. Treat it as a user-facing control surface, not as your source of authority for business rules.

Production deployments require these controls:

* Users authenticate before reaching private Console routes.
* Roles and tenant membership determine which records and operations a user can reach.
* Sensitive documents flow through protected document workflows, not through public branding URLs.
* Execution requests pass through the same validation and authorization path used by API clients.
* Confirmed state comes from the indexer and platform read models rather than from browser-local assumptions.

This separation matters for audits. Reviewers can distinguish between four records: what the Console displayed, what the API accepted, what the execution layer submitted, and what the indexer reconstructed from event history.

## Branding and public assets [#branding-and-public-assets]

Enterprise deployments can apply tenant branding through the theme system. Submit a theme payload that covers logo variants, authentication-screen imagery, background images, favicons, Apple touch icons, font settings, and color tokens for light and dark modes. Include update metadata with the payload.

| Theme key                          | Controls                                                                                                                                       |
| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `logo`                             | Primary, compact, and authentication logo URLs such as `lightUrl`, `darkUrl`, `lightIconUrl`, `darkIconUrl`, `authLightUrl`, and `authDarkUrl` |
| `images`                           | Authentication overlays, background images, favicons, Apple touch images, and favicon variants                                                 |
| `fonts`                            | `sans` and `mono` font family, source, weight, preload, and custom URL settings                                                                |
| `cssVars.light` and `cssVars.dark` | Light-mode and dark-mode color tokens                                                                                                          |
| `metadata`                         | Version, updater, update timestamp, and preview metadata used around theme changes                                                             |

Theme asset URLs support direct browser rendering. Asset fields accept app-hosted paths starting with `/` or HTTP/HTTPS URLs, so the active theme loads logos and images without a separate document-download flow.

Do not use public theme asset URLs for investor files, token documents, KYC evidence, or operational attachments. Those records stay behind the relevant document workflows. Your authorized users retrieve them through the matching document APIs.

## Localization and accessibility [#localization-and-accessibility]

The Console uses translated interface resources for English (`en-US`), German (`de-DE`), Arabic (`ar-SA`), and Japanese (`ja-JP`). English is the fallback when a requested language or translation key is unavailable. Arabic uses right-to-left document direction through the i18n provider.

The interface uses component-level labels, semantic text, focus states, and localized formatting helpers for dates, currency values, and numbers. Treat accessibility and localization as production requirements. At rollout, review tenant branding and custom imagery against keyboard use, readable contrast, translated copy length, and RTL layout behavior.

## Before production use [#before-production-use]

Before you use the Console in production, confirm:

* Tenant authentication is configured, including roles and user membership.
* Required asset templates, compliance templates, and permissions are in place.
* Theme colors and logos render in both light and dark modes. Favicons and custom fonts do too.
* Public branding assets are separate from protected investor and token documents.
* Language fallback and RTL behavior are acceptable for enabled locales.
* Operational teams know which evidence comes from the Console, the API, the execution layer, and the indexer.

## See also [#see-also]

* [Authentication and security](/docs/compliance-security/security/authentication) for identity management
* [Roles and tenancy](/docs/compliance-security/security/authorization) for access control and multi-tenant configuration
* [Platform API](/docs/architects/components/platform/platform-api) for programmatic access
* [DALP Workflow Engine](/docs/architects/components/infrastructure/workflow-engine) for operation processing
* [Reporting and audit access](/docs/api-reference/observability/reporting-audit-access) for indexed evidence retrieval