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 dapp.
Addon workspaces are operating pages for installed system addons. Use them to confirm the selected factory address, see the workflow DALP exposes for that addon type, and continue into settlement or offering detail pages without mixing factories from different environments.
Each workspace is scoped to one addon factory address. DALP reads the factory metadata, builds the breadcrumb from the addon category and type, and shows the workflow for that addon type. If the address does not resolve to an installed addon factory, the workspace surfaces a route error instead of showing an empty operations page.
An addon workspace does not make a transaction eligible by itself. The workspace gives the operator the correct factory and instance context. Asset rules, role permissions, custody approvals, compliance checks, and active EVM network state still decide the available actions. Those controls also decide whether submitted transactions complete.
Before you start
- You need access to the DALP dapp in the environment that contains the addon.
- The addon must already be installed. Install missing addons from Install addons.
- For XvP settlement creation, your account needs owner, administrator, system administrator, or XvP create permission.
- For token sale workspaces, the environment must enable token sales.
Choose the right workspace
Start from the sidebar area that matches the addon type you need to operate.
| Operator goal | Workspace | DALP view | Use next |
|---|---|---|---|
| Create or continue an XvP settlement | Settlement, then the installed XvP addon | A settlement table for the selected factory, with status, warnings, timing, flows, approvals, and row actions | Create a settlement, open an existing settlement, or use the dedicated XvP action guides linked below |
| Review an offering created through a token sale | Offerings, then the installed token sale addon | A token sale table for the selected factory, with token, status, start time, end time, progress, and row actions | Open the offering detail page and compare the sale state with the DAIO offering flow |
| Confirm another installed addon | The matching addon entry | An overview card with the addon address, type, and category | Copy or record the factory address before using the addon in another workflow |
Confirm the page header and breadcrumb after you open the workspace. They should match the addon type and category before you start an action.
Work from the selected factory
- Open the installed addon workspace.
- Check the factory address, addon type, and breadcrumb.
- For XvP settlement, use Settlement Wizard when the button is visible and you need to create a settlement.
- To continue an existing XvP settlement, select it from the settlement table or use the row action menu.
- For token sale, select the sale from the token sale table when token sales are enabled in the environment.
- For another installed addon type, use the overview card to copy the addon address and confirm the addon type and category.
DALP reads the installed addon before loading the table. An XvP workspace preloads settlements for that factory. A token sale workspace preloads sales for that factory, and the token sale table renders only when token sales are enabled in the environment.
The Settlement Wizard button appears only when your account can create XvP settlements. DALP grants that workspace action to owners, administrators, users with system administrator permissions, or users with the XvP create permission.
Use instance detail pages
Selecting an XvP settlement or token sale opens an instance page under the selected addon factory path. DALP first reads the addon factory for the page, then loads the settlement or sale by instance address. Factory and instance read failures surface through the page error boundary instead of showing an empty detail page. Token sale instance pages return a not-found state when token sales are disabled in the environment.
| Instance type | Detail page shows | Common next action |
|---|---|---|
| XvP settlement | Settlement header, warnings, available actions, approvals, secret handling when external flows exist, and flows | Approve, reveal a secret, execute, cancel, revoke approval, or withdraw using the matching action guide |
| Token sale | Offering header, status banner, overview, purchases, payment currencies, whitelist, and vesting tabs for managers | Review funding and sale configuration, manage eligible buyers, or inspect purchases |
For XvP settlement actions, use the dedicated action guides:
- Create XvP settlement
- Approve XvP settlement
- Reveal the HTLC secret
- Execute XvP settlement
- Cancel a settlement
- Revoke settlement approval
- Withdraw from expired settlements
Production notes
- The addon factory address in the URL must be a valid EVM address for an installed addon. If DALP cannot read the addon factory, the route surfaces an error state.
- The XvP settlement workspace requires the XvP settlement addon type. The Settlement Wizard button appears only when the current user can manage settlement creation.
- The token sale workspace appears only for token sale addons when the environment enables token sales. If token sales are disabled, token sale instance routes return a not-found state.
- Instance detail pages require a valid instance address. If DALP cannot read the settlement or sale, the route surfaces an error state.
- Addon pages are navigation and operations surfaces. Contract roles, compliance rules, custody controls, and settlement state still determine which actions are available and whether submitted transactions succeed.
When the page does not show the expected workflow
Use these checks before treating the workspace as a product issue:
| What you see | What to check |
|---|---|
| Not-found state | For token sale instance pages, confirm token sales are enabled in the environment. |
| Error state | Confirm the factory address is an installed addon factory. For instance pages, confirm the instance address is a readable settlement or sale. |
| Overview card instead of an operations table | Confirm the installed addon type is XvP settlement or token sale. If the addon type is token sale, confirm token sales are enabled. Other addon types show the overview card. |
| No Settlement Wizard button | Confirm your account has an owner, administrator, system administrator, or XvP create permission path. |
| No token sale table | Confirm the addon type is token sale and token sales are enabled for the environment. |
Related
Install addons
Install visible system addons from the on-chain Directory registry. The Add-ons settings page lists the addon types your environment exposes for administrator installation.
Overview
XvP Settlement coordinates multi-party asset exchanges for DALP assets. Local settlements execute all local flows in one transaction; external-flow settlements use hashlocks and secrets to coordinate with a leg that stays outside the local execution.