Install addons
Addons are installed by converging your system to the on-chain Directory. Onboarding installs every available component, and System updates installs anything added to the Directory later.
Addons are no longer installed one at a time. DALP installs every token factory, addon, and compliance module that the on-chain Directory exposes by converging your system to that Directory. Onboarding does this automatically for a new environment, and System updates installs anything the Directory gains afterwards.
How addons get installed
There is one source of truth — the on-chain Directory — and one action that brings your system in line with it.
| When | What installs | Where |
|---|---|---|
| Platform onboarding | Every available factory, addon, and compliance module the Directory exposes | The onboarding flow, automatically |
| After onboarding | Any component added to the Directory since your system was last converged | Organisation settings > Operations > System updates |
Because onboarding installs everything, you only return to System updates when the Directory itself gains a new addon, factory, or compliance module — for example after a platform upgrade.
Install through System updates
Go to Organisation settings > Operations > System updates.
The page compares your system against the Directory and lists every component that is missing or out of date, grouped by category. Use search and the show-up-to-date toggle to narrow the list.
Select Update to converge your system to the Directory. This installs every missing component and updates every out-of-date one in a single guided action. You do not pick addons individually.
System updates can include on-chain transactions. Follow the wizard to completion — closing the dialog mid-run does not roll back a transaction that has already been submitted.
Experimental components
Components marked experimental are excluded by default. Turn on Show experimental before running the update if you intend to install them. Running System updates requires system manager permission.
Addons available through the Directory
The Directory is the source of truth for which components exist. The platform registry groups known addon types for the UI and hides contract-level capabilities that are not meant to surface as their own components.
| Category | Addon types | Used for |
|---|---|---|
| Distribution | Push airdrop, vesting airdrop, time-bound airdrop, token sale, historical balances, voting power, permit | The workflow distributes tokens, tracks voting or historical balances, or supports permissioned approval patterns. |
| Income and fees | Fixed yield schedule, maturity redemption, transaction fee, transaction fee accounting, external transaction fee, fixed treasury yield, AUM fee | The asset needs scheduled income, redemption, treasury yield, or fee accounting behavior. |
| Exchange | XvP settlement, conversion, conversion minter | The workflow exchanges assets, settles against another leg, or converts between supported token forms. |
| Data | Scalar feed aggregator adapter, issuer-signed scalar feed, price resolver | The workflow depends on data feeds or price resolution. |
| Infrastructure | Paymaster signer | The workflow uses advanced accounts for sponsored transaction execution. |
What an installed addon gives you
Installing a component makes its capability available platform-wide. It does not grant operating rights or change asset rules.
- The Directory determines which components exist; System updates installs them; the platform registry controls how known types appear in the UI.
- Hidden components sync silently and never appear as their own row, even when the contract factory exists.
- Users still need the right asset roles and workflow permissions to operate an installed addon.
- Use the addon-specific guide after installation. Each addon surface has its own operating rules.
Troubleshooting
| Issue | What to check |
|---|---|
| An addon you expected is not available | Run System updates. If it still does not appear, the addon type is not registered in the Directory for this environment. |
| System updates shows nothing to install | Your system already matches the Directory. Newly experimental components only appear with Show experimental on. |
| Cannot run System updates | Confirm you are signed in with system manager permission. |
| Addon installed but unavailable in a workflow | Check that the asset flow, roles, and addon-specific permissions match the addon. |
Related
System addons overview
Understand how DALP system addons are discovered, installed, and operated across settlement, distribution, yield, fee, feed, conversion, and infrastructure workflows.
Review addon workspaces
Open an installed addon workspace, confirm the selected factory, and continue into XvP settlement or token sale instance pages from the DALP Console.