Instrument templates
Create, reuse, and publish instrument templates for the Asset Designer.
Instrument templates help asset teams turn a repeatable product shape into a safe Asset Designer starting point. A template groups the asset class, deployable asset type, required token features, feature defaults, and metadata fields that DALP should collect during issuance.
DALP includes 23 system product templates plus the Configurable Asset starter across fixed income, equity, funds, cash, real assets, and structured instruments. Use From scratch when your product needs a blank template rather than a product-template starting point.
Use instrument templates when you want repeatable setup for a family of assets, such as bonds with maturity and yield settings, stable-value instruments with required metadata, structured notes with maturity settings, or organization-specific asset classes.
Before you create or duplicate a template, decide what should be fixed for every asset in the family and what the issuer should still enter during asset creation. Fixed settings stay on the template as defaults. Configurable settings appear in the Asset Designer as issuer inputs.
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.
DALP library taxonomy
DALP library templates give operators a current starting point for common regulated-asset patterns. The platform provides them as read-only templates. Duplicate a library template when your organization needs a local variant with different feature choices, metadata fields, or wording.
| Asset class | System product templates |
|---|---|
| Fixed income | Corporate Bond, Sovereign Bond, Convertible Note, Syndicated Loan, Treasury Bill, Green Bond, Commercial Paper |
| Equity | Common Equity, Preferred Equity, Employee Equity Award |
| Funds | Mutual Fund, ETF, Money Market Fund, Private Equity Fund |
| Cash | Fiat-Backed Stablecoin, Tokenized Bank Deposit, Certificate of Deposit |
| Real assets | Gold-Backed Token, Commercial Real Estate, Carbon Credit, Tokenized Art |
| Structured | Principal-Protected Note, Autocallable Note, Asset-Backed Token |
Use From scratch for the Configurable Asset starter when the product does not fit a preconfigured system product template. The Asset Designer still guides the flow. DALP does not count this starter as one of the 23 product templates.
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 or duplicate a template
Open Platform settings → Templates → Instrument templates, then choose one of the creation modes:
- From existing copies an existing template into a new draft, including its asset class, required features, metadata schema, feature configuration, and base asset type. Use this when a DALP library template is close to the product you need.
- From scratch starts a new draft where you select the asset class and configure the template manually. Use this when no system product template fits the product shape.
When creating or editing a template draft, configure the reusable parts first:
- 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, permit support, voting power, or historical balances.
After the draft exists, use the template detail page to add metadata fields and adjust feature-specific settings. Publish only after the required features, configurable settings, and required metadata fields match the issuance pattern you want operators to reuse.
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
DALP shows required features as badges on template cards and as active features on the template detail page when the matching feature is available in the environment. These are token features, not compliance modules. Operators select compliance controls separately in the compliance step or through compliance templates.
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.
DALP only asks operators for template settings that remain editable in the Asset Designer. Locked settings stay on the template as defaults. If a fixed-yield template supplies a basis-per-unit default, the operator may leave that field empty while the denomination asset still matches the template. Choosing a different denomination makes the basis-per-unit value required again because the amount must match the new token decimals.
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.
Know which fields the template owns
An instrument template owns the fields that define the reusable issuance pattern. Asset creators supply values only where the template or the Asset Designer leaves an input open.
| Field | Owned by | How it affects asset creation |
|---|---|---|
| Base asset type | Template | Selects the concrete deployable asset behavior behind a custom template, such as a deposit-style or bond-style asset. The asset creation request selects the template, not a different base type. |
| Required features | Template | Determines which token features DALP attaches to assets created from the template. Asset creators can complete configurable feature settings, but they do not remove the template's required features during issuance. |
| Feature configuration | Template, with selected issuer inputs | Supplies default feature settings. Settings marked configurable appear in the Asset Designer and are submitted as featureConfigs; locked settings remain on the template as defaults. |
| Metadata schema | Template | Defines the metadata fields the Asset Designer collects. Required metadata fields must be completed before creation can continue. |
| Metadata values | Asset creator | Provides the values for fields declared by the template metadata schema. Immutable metadata values are locked on the issued asset after deployment. |
| Compliance controls | Compliance template or manual setup | Adds initial compliance modules during the compliance step. If a compliance template is selected, DALP requires the selected controls to be submitted with the create request. |
When the API receives a dalp-asset create request, templateId is required. DALP reads the template and combines its required features with the submitted feature configuration. It checks that incompatible features are not enabled together, then passes the template metadata schema into deployment so immutable metadata fields are encoded as immutable on the issued asset.
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, optional required status, and optional constraints.
Supported metadata field types include string, number, date, enum, ISIN, address, basis points, percentage, currency code, country code, LEI, CUSIP, FIGI, decimal money, and URL fields. Required fields must be completed during asset creation. Fields marked immutable are locked on the issued asset after deployment. Fields marked restricted-mutable can still be managed through the supported metadata update flow, subject to permissions and governance controls.
Publish, duplicate, edit, and delete
Template operations are available from the template detail page.
| Operation | 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.
When an operator switches templates, the Asset Designer clears feature-mapped values and applies the new template defaults. This keeps values from a previous template, such as a maturity date or fee setting, out of the next issuance.
Required token features can depend on other tokens:
- Maturity redemption, fixed treasury yield, and external transaction fee behaviour need an ERC-20 token in the tenant.
- Conversion needs an equity-class target token.
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. Include conversion when a template includes conversion-minter; the minter must be paired with the conversion behaviour it serves. For the current dependency, incompatibility, and feature-closure rules, see Token feature constraints.
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 precious metal template can require metal classification, weight, valuation, and custody context before issuance. See Create a precious metal asset for the operator walkthrough.
- 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 Tokenization modeling.
Create a precious metal asset
Create a gold, silver, platinum, or palladium asset with metal classification, weight-based pricing, custody context, and compliance controls.
Asset detail workspace
Review an issued asset, inspect token tabs, and understand which operator workflows are available for the current token.