- Overview
- Setup
- Tutorials
- How Tos
- Reference
- DAR Versions
- API Reference
- Commercials API
- Credential API
- Registry API
- Utility.Registry
- Utility.Registry.V0.Configuration.AppReward
- Utility.Registry.V0.Configuration.Instrument
- Utility.Registry.V0.Holding.Allocation
- Utility.Registry.V0.Holding.Burn
- Utility.Registry.V0.Holding.Lock
- Utility.Registry.V0.Holding.Mint
- Utility.Registry.V0.Holding.Transfer
- Utility.Registry.V0.Holding.Unlock
- Utility.Registry.V0.Rule.Transfer
- Utility.Registry.V0.Types
- Utility.Registry.V0.Util
- Utility.Registry.App
- Utility.Holding
- Utility.Registry
- Settlement Utility API
- Collateral Utility API
- Operator Backend API
Featured Activity Markers¶
Activity markers can be created upon the execution of asset transfers in the context of token standard workflows.
Parties with the provider role which are featured on the network are the main beneficiaries of the marker, unless otherwise configured.
The marker is applied to transactions involving instruments managed by parties onboarded by the featured provider.
For example, consider this scenario:
“P” is a featured party on the Network and has the provider role in the Utility
“P” onboards another party “R” giving them a registrar role
“R” creates an instrument “INST”
“P” will benefit from an activity marker whenever a token on INST is transferred. Part of the marker’s weight might be shared with the operator or with other parties, depending on configuration.
Configuration¶
The configuration for activity markers is defined for a given provider upon acceptance of the
ProviderServiceRequest.
Example Scenario¶
The operator onboards the provider. As part of this process, the operator creates an
AppRewardConfigurationfor the provider, assigning a weight w to the operator and 1-w to the provider.The provider onboards the registrar.
The registrar sets up an instrument.
A mint request by a token holder (sender) of that instrument is accepted by the registrar.
A token holder (sender) transfers tokens of that instrument to a token holder (receiver).
A burn request by the token holder (receiver) of that instrument is being accepted by the registrar.
For each of the steps 4-6, a Splice.Amulet:FeaturedAppActivityMarker is created for the
provider and the operator, with weight 1-w and w, respectively, as specified by the
AppRewardConfiguration in step 1. This results in six markers overall.
Reward Configuration¶
An AppRewardConfiguration is typically created for the provider when a
ProviderServiceRequest is accepted. However, the operator can also create, update, or
archive an AppRewardConfiguration at any time.
A provider can further refine reward sharing for a given instrument by specifying
beneficiaries in the instrument’s InstrumentConfiguration. For example, the provider
could allocate 60% of its own default share 1-w to itself and 40% to the registrar (or other
parties). The provider beneficiary configuration of the instrument configuration would then
be:
Party |
Share |
|---|---|
provider |
0.6 |
registrar |
0.4 |
The resulting reward distribution for activity markers would be:
Party |
Share |
|---|---|
operator |
w |
provider |
(1-w) * 0.6 |
registrar |
(1-w) * 0.4 |
Note
The provider must define beneficiary weights that sum to exactly 1 for the instrument configuration to be valid.
Minor rounding adjustments may be applied to ensure the final distribution totals 1.
If the operator changes its weight to w’ in the AppRewardConfiguration, the distribution will still equal 1, with the provider’s beneficiaries scaled proportionally (e.g., to (1 - w’) * 0.6 and (1 - w’) * 0.4 in the case above).
If you are a provider, please contact Digital Asset to ensure this functionality is enabled for your party with the correct reward split.