Instrument templates
Create, reuse, and publish instrument templates for the Asset Designer.
Instrument templates help asset teams reuse the same issuance setup across assets. A template groups the asset class, deployable asset type, required token features, feature defaults, and metadata fields that the Asset Designer should collect during issuance.
Use instrument templates when you want repeatable setup for a family of assets, such as bonds with a maturity feature, stable-value instruments with required metadata, or organization-specific asset classes.
Template types
DALP uses templates at different points in asset setup:
| Template type | What it configures | When to use it |
|---|---|---|
| Instrument template | Asset class, deployable asset type, required token features, feature defaults, and metadata fields for the Asset Designer. | Reuse a complete issuance pattern for assets that share the same business and operational shape. |
| Token template settings | Token-level behaviors that are attached during issuance, such as maturity redemption, yield, fees, conversion, or permit support. | Make a behavior mandatory for every asset created from the instrument template. |
| Metadata schema | Fields the Asset Designer must collect, including field key, label, type, mutability, required status, and constraints. | Collect repeatable product, regulatory, or reporting data during asset creation. |
| Compliance template | Compliance modules, jurisdiction scope, required controls, and whether selected controls remain configurable in the designer. | Reuse policy controls for assets that follow the same regulatory or organization-specific ruleset. |
These templates compose rather than replace each other. An instrument template handles the asset setup, token template settings handle token behavior, metadata fields handle asset-specific information, and a compliance template can be selected in the compliance step when the asset needs reusable policy controls.
Where templates fit
An instrument template does not issue an asset by itself. It defines reusable defaults and requirements that the Asset Designer applies when an operator creates an asset.
Template sources and statuses
The instrument template list separates templates by source and status:
| Field | Meaning |
|---|---|
| Source | DALP library templates are system-provided. Organisation templates are created by your organization. |
| Status | Draft templates can still be prepared before use. Published templates are ready for operators to select. |
| Asset class | The business category used to group and filter templates. |
| Required features | Token features that the template attaches to assets created from it. |
The list page supports search, source filtering, status filtering, and asset-class filtering. Template cards show the template name, description, source, status, and any required feature badges.
Create a template
Open Platform settings → Templates → Instrument templates, then choose one of the creation modes:
- From existing copies an existing template's name, description, asset class, required token features, metadata schema, feature configuration, and base asset type into a new draft.
- From scratch starts a new draft where you select the asset class and configure the template manually.
When creating or editing a template draft, configure:
- Name and description so operators can pick the right template later.
- Asset class to connect the template to a managed asset category.
- Required features to attach token-level behavior such as maturity, yield, fees, conversion, or other installed token features.
After the template draft exists, use the template detail page to add metadata fields and adjust feature-specific settings before publishing it.
Template names must be unique within the organization. If a duplicate name is entered, DALP keeps the form open and shows an inline validation message.
Work with required features
Required features are shown as badges on template cards and as active features on the template detail page when the matching feature is available in the environment.
On the template detail page, users with template management permissions can:
- add available features,
- remove active features,
- adjust feature configuration,
- choose which configured feature settings remain editable in the Asset Designer.
Configurable feature settings are controlled per setting. For example, a template can keep a fee recipient fixed while allowing an operator to enter the fee value during asset creation. Settings that are not configurable stay on the template as defaults and do not appear as editable inputs in the Asset Designer.
During asset creation, configurable settings from the selected template are grouped by token feature. Each feature card has its own heading and can be expanded or collapsed independently, so operators can complete maturity, yield, fee, conversion, and metadata fields without mixing the controls together.
If a copied template references a feature that is not deployed in the current environment, DALP warns the operator while preparing the new draft instead of silently treating that draft as fully ready.
Define metadata fields
The Metadata tab appears when a template has metadata fields or when the current user can manage the template. Each metadata field has a field key, type, mutability, label, and optional constraints.
Supported metadata field types include text, number, date, enum, ISIN, and address fields. Required fields must be completed during asset creation. Fields marked immutable are locked on the issued asset after deployment; fields that are not immutable can still be managed through the supported metadata update flow, subject to permissions and governance controls.
Publish, duplicate, edit, and delete
Template actions are available from the template detail page.
| Action | When to use it |
|---|---|
| Edit | Update an organization-owned template before or after publication. System templates are read-only. |
| Duplicate | Start a new draft from an existing template while preserving the original. |
| Publish | Move an organization-owned draft template to the published state so it can be selected for issuance. |
| Delete | Remove an organization-owned template after explicit confirmation. |
DALP library templates are read-only. They can be duplicated when your organization needs a similar template with its own asset class, feature choices, or metadata fields.
How templates affect asset creation
When an operator selects a template in the Asset Designer:
- required feature badges explain which token behaviors are included,
- template-specific metadata fields are added to the details step,
- required metadata fields must be completed before the wizard continues,
- template defaults are applied for feature-specific settings,
- feature-specific fields are grouped into separate cards when the selected template includes more than one configurable feature,
- the selected template determines which asset class and base asset behavior the deployed asset uses.
Some required token features also need another token before the operator can select the template. Templates that use maturity redemption, fixed treasury yield, or external transaction fee behaviour need an ERC-20 token in the tenant. Templates that use conversion need an equity-class target token.
Templates can also have feature dependencies:
- Include
conversionwhen a template includesconversion-minter. - The minter must be paired with the conversion behaviour it serves.
If a required token is missing, the Asset Designer disables the affected template and shows the missing token type. The operator can create or register the required token, then return to the wizard and select the template after the token is available.
Feature dependencies belong to the template configuration itself. If a template feature dependency is missing, update the template's feature selection before publishing or updating the template.
Examples
Use these examples as patterns for how template parts affect issuance:
- A bond-style instrument template can require maturity redemption and fixed treasury yield features. During asset creation, the operator sees those token behaviors as required feature badges and completes any configurable settings before deployment.
- A real-world asset template can require metadata such as an ISIN, valuation date, address, or reporting category. Required metadata fields block wizard progress until completed. Immutable metadata fields are locked on the issued asset, while restricted-mutable fields can still follow the supported metadata update flow.
- A compliance template can group reusable controls such as country lists, identity checks, holding limits, and transfer approvals. In the compliance step, the Asset Designer filters published templates by the asset context and carries selected controls into the asset's initial compliance setup.
- Operators can also skip a compliance template and configure compliance modules manually when the asset needs one-off policy setup instead of a reusable template.
For the end-to-end issuance flow, see Create asset. For the conceptual model behind templates, see Asset model.