Review addon workspaces
Open an installed addon workspace, confirm the selected factory, and continue into XvP settlement, token sale, or token governance instance pages from the DALP Console.
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, offering, or governance vote detail pages without mixing factories from different environments.
Each workspace is scoped to one factory address. DALP reads the factory metadata, builds the breadcrumb from the addon category and type, and shows the matching workflow. An unresolvable address produces a route error.
An addon workspace does not make a transaction eligible. It gives the operator the correct factory and instance context so the right operations appear. Asset rules, role permissions, custody approvals, compliance checks, and active EVM network state still decide which operations are available and whether submitted transactions complete.
Before you start
- You need access to the DALP Console 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.
- For token governance vote creation, your account needs owner, administrator, or token manager permission so the Create vote button is visible. You also need the
governancerole on the selected token to submit the creation, because the create route checks that role before queueing the transaction. The button and the submit gate are separate: the button is shown by system-level permission, but the creation itself requires the token-level governance role.
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 operations | Create a settlement, open an existing settlement, or use the dedicated XvP 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 operations | Open the offering detail page and review the sale state, purchases, and payment currencies |
| Create or continue a token governance vote | Governance, then the installed token governance addon | A governance votes table for the current system, with each vote and its row operations | Create a vote when the button is visible, or open a vote to review status, queue, execute, or cancel it |
| 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.
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 menu.
- For token sale, select the sale from the token sale table when token sales are enabled in the environment.
- For token governance, use Create vote when the button is visible to start a new vote, or select a vote from the governance votes table to open it.
- For another installed addon type, use the overview card to copy the address and confirm the 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. A token governance workspace loads the governance votes table, which lists proposals across all token-governance factories in the current system, not only the selected factory.
The Settlement Wizard button appears only when your account can create XvP settlements. DALP shows that button to owners, administrators, users with system administrator permissions, or users with the XvP create permission. The Create vote button appears only when your account can create token governance votes. DALP shows that button to owners, administrators, or users with token manager permission.
Use instance detail pages
Selecting an XvP settlement, token sale, or token governance vote opens a detail page under the selected addon factory path. DALP first reads the factory for the page, then loads the settlement, sale, or vote by its instance reference. Read failures for the factory or the instance surface through the page error boundary instead of showing an empty detail page. Token sale pages return a not-found state when token sales are disabled in the environment.
| Instance type | Detail page shows | Next step |
|---|---|---|
| XvP settlement | Settlement header, warnings, available operations, approvals, secret handling when external flows exist, and flows | Approve, reveal a secret, execute, cancel, revoke approval, or withdraw using the matching 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 |
| Token governance vote | Vote header, type, schedule, quorum, outcome, and the participation surface for eligible holders | Queue or execute an approved proposal, or cancel a vote using the governance votes runbook. Eligible holders cast ballots from the work queue or the token's Governance tab, not from the vote detail page. |
For XvP settlement operations, use the dedicated guides:
- Create XvP settlement
- Approve XvP settlement
- Reveal the HTLC secret
- Execute XvP settlement
- Cancel a settlement
- Revoke settlement approval
- Withdraw from expired settlements
For token governance vote operations, including creating votes, managing record dates and quorum, casting ballots, and executing approved proposals through the timelock, use the Governance votes runbook.
Production notes
- The factory address in the URL must be a valid EVM address for an installed addon. If DALP cannot read the 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.
- The token governance workspace requires the token governance addon type. The Create vote button appears only when the current user can manage governance vote creation.
- Instance detail routes require a valid instance reference. If DALP cannot read the settlement, sale, or vote, the route surfaces an error.
- Addon workspaces are navigation and operations surfaces. Contract roles, compliance rules, custody controls, and settlement status still determine which operations 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. For token governance instance pages, confirm the vote reference resolves to a readable vote. |
| Error state | Confirm the factory address is an installed addon factory. For instance pages, confirm the instance reference is a readable settlement, sale, or vote. |
| Overview card instead of an operations table | Confirm the installed addon type is XvP settlement, token sale, or token governance. 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. |
| No Create vote button | Confirm the addon type is token governance and your account has an owner, administrator, or token manager permission path. |
Related
Installing system 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.
Review token sale offerings
Open a token sale offering in the Console, check sale status, funding, purchases, payment currencies, whitelist entries, and vesting settings before taking the next operator step.