Authorized converters
Add or remove converter addresses for conversion-minter assets before running governed conversion workflows.
Authorized converters are conversion feature addresses that a conversion-minter asset is allowed to use. Add a converter when a programme needs a governed route from a source asset into its target asset. Remove it when the route is retired, replaced, or no longer approved.
Use this guide when the asset already has conversion behaviour configured. It covers the converter list only, not trigger setup or holder conversion. For the wider feature model, read Conversion. For mandatory holder conversion, use Forced conversion.
Converter management is an asset-servicing control
Adding a converter does not create a trigger, move holder balances, or approve the business event. It only updates which conversion feature address the asset can use for its configured workflow.
Before you start
Confirm these points before changing the converter list:
- The target asset has the conversion-minter feature attached.
- The converter address belongs to a contract that exposes the conversion feature interface.
- The operator has the governance authority required to update the asset.
- The approval record names the asset, converter address, reason for the change, and expected route.
- Wallet verification is available for the submitting operator.
How the check works
The Asset Console checks a converter address before it submits the add workflow. If the address is not a conversion feature contract, the console stops the submission.
API integrations should call the probe endpoint before sending an add request. A direct add request queues the update and relies on the contract to reject an invalid converter.
Add an authorized converter
Open the conversion feature page
Open the asset detail page, then open the Conversion feature page. Confirm that the conversion-minter details are visible for the target asset.
Start the add workflow
Choose Add Converter. Enter the converter address that should be allowed for the asset.
Review the converter check
DALP checks whether the address exposes the expected conversion feature interface. If the check fails, stop and verify that you selected the conversion feature address for the intended route.
Submit with wallet verification
Review the confirmation screen, complete wallet verification, and submit the update. Keep the transaction result with the approval record for the converter change.
Remove an authorized converter
Remove a converter when the conversion route is no longer approved, the converter has been replaced, or the operating policy requires the asset to stop using that route.
Open the conversion feature page
Open the asset detail page and review the current authorized converter list on the Conversion feature page.
Start the remove workflow
Choose Remove Converter, then enter the converter address to remove.
Verify the operating impact
Before submission, confirm that no open conversion process depends on the converter address you are removing. Removing a converter can stop future conversion requests that rely on that route.
Submit and record the result
Complete wallet verification, submit the update, and retain the transaction result with the reason for removal.
API integration
Use the API path when an operator system manages converters instead of the Asset Console:
GET /api/v2/tokens/{tokenAddress}/conversion-feature-probe?converterAddress={converterAddress}
POST /api/v2/tokens/{tokenAddress}/features/conversion-minter/authorized-converters
DELETE /api/v2/tokens/{tokenAddress}/features/conversion-minter/authorized-convertersUse the probe response before submitting an add request. Add and remove requests use the target token address in the path and the converter address in the request body.
Troubleshooting
| Issue | Check |
|---|---|
| Add workflow rejects the address | Confirm the address is a conversion feature contract, not a token address or unrelated contract. |
| Workflow is not visible | Confirm the asset has conversion-minter behaviour attached and that your operator has governance role. |
| Wallet verification fails | Complete the required verification method before retrying the update. |
| Conversion later fails | Confirm the relevant trigger, conversion window, holder balance, and converter list are still valid. |
Related guides
- Conversion for roles, triggers, conversion windows, and events
- Forced conversion for mandatory conversion workflows
- Token lifecycle API integration for conversion endpoints
- Per-asset RBAC for governance role context