Constructs and prepares an instance of this scheduler.
The arguments passed to the command. Typically, this holds required parameters of commands.
Memory store for the fees asset configuration object. This
object defines which assets are discoverable on dHealth Network
and used to pay for transaction fees.
This asset configuration is referred to as the base asset
used in a specific dApp. The reason for this is that transactions
on the underlying dHealth Network are always paid with one and the
same asset.
A configuration object that determines the total number of referrals
that are necessary to be assigned the corresponding booster.
Note that the keys of this configuration object should contain the
booster asset's identifier as defined inside config/assets.ts.
The internal dApp configuration object. This object is used to configure key functionalities such as the name of a dApp and the enabled scopes of the backend runtime.
Contains the dApp Identifier as attached to contracts on-chain.
Typically, the dApp identifier is created using a slug-format of
the dappName configuration inside config/dapp.ts.
Memory store for the earn asset configuration object. This
object defines which assets are discoverable on dHealth Network
and used to tokenize a particular operation.
This asset configuration is referred to as the earn asset
used in a specific dApp. The reason for this is that individual
dApps may want their end-users to earn a custom asset, or not.
The internal dApp network configuration object. This object is used to configure the access to the underlying blockchain network.
The command scope. This is the scope that must be enabled
through the configuration files for this command to be
available.
This property is required through the extension of
BaseCommand.
Requires state information of the module. This object is typically populated upon first execution and updated any time later.
Memory store for the total number of prepared payouts. This is used in getStateData to update the latest execution state.
This method must return a database collection which
is used to discover subjects for this preparation.
e.g. "activities"
This method must return a command name. Note that
it should use only characters of: A-Za-z0-9:-_.
e.g. "scope:name"
This property is required through the extension of
PayoutCommand.
This method determines whether the payoutState and activityAssets
fields must be set on the payout subject document, or not.
This method must return a command signature that
contains hints on the command name and its required
and optional arguments.
e.g. "command
This property is required through the extension of
PayoutCommand.
Getter for the discovery state identifier, e.g.
"discovery.accounts", "discovery.transactions",
"payout.outputs" etc.
This method is an implementation necessary because
of the extensions of StatefulModule.
This method uses the logger to print debug messages.
This method uses the logger to print error messages.
Optionally, a stack can be passed to print a stack trace.
This method implements the processor logic for this command
that will prepare relevant subjects' payout entities. Subjects
in this command are defined by the PreparePayouts.collection
implementation.
This method returns an array of activities that satisfy the following conditions:
processingState must contain 0 ; andpayoutState must contain 0
createdAt in ascending
direction. A maximum number of 10 activities are returned.This method must return an asset amount which will be
attached to a transfer transaction.
Note that an empty total time elapsed will always
return a 0-amount. The total time elapsed in used
in the formula in a division operation.
This implementation defines the payout formula used to
compute asset amounts depending on the intensity of an
activity. Note that the activityData field must contain
fields including:
calories: Number of kilocalories burned (C || kC).distance: Number of meters distance (D). (* some formula express this in different unit of measure)elevation: Number of meters elevation gain (E || A). This field uses an adjusted value in case it is empty.elapsedTime: Number of seconds spent during activity (T).kilojoules: Number of kilojoules produced during activity (Rides only) (J).
(D / T) x 1.2(D / T) x 1.5(D / T) x 0.8((D*10) / T) x 1.7(D / T) x 1.6The payout subject (activity) of which activityData is used.
The amount multiplier (in case of "boosters"). Defaults to 1.
An amount that is computed and depends on the intensity of an activity.
This method must return an asset identifier which will be used in a transfer transaction.
This method must return a multiplier that is applied to payout amounts. This is used internally to add boosters when users have referred a specific number of accounts.
Booster payouts always return an amount (and multiplier) of 1.
Creates a state query for this discovery service. Each discovery service shall set its own stateIdentifier which is considered the identifier of the discovery module's state document.
This method uses the logger to print info messages.
This method is the entry point of any command line
executed command. nest-commander implements a flow
where this method is called with parameters that are
respectively the raw arguments and the parsed arguments
to this command call.
This method uses the stateService to fetch the
current execution and also uses it to update the state.
Note that the runWithOptions method is called inside
a try-catch block to force the error handling process.
This method is the entry point of this scheduler. Due to
the usage of the Cron decorator, and the implementation
the nest backend runtime is able to discover this when the
processor scope is enabled.
This method is necessary to make sure this command is run
with the correct --signer option.
This scheduler is registered to run every 30 seconds.
This method implements the execution logic for
processor commands that extend this class. Child
classes must implement a process method
that is called in here.
Note that this method is called by BaseCommand
under the hood, which permits to execute and track
failures more consistently at a higher level.
The parsed runtime arguments passed to the command.
This method must update a payout subject document. Note that subjects are the subject of a payout execution.
The document being updated.
The columns and their respective value.
The updated document.
This method prints usage information to the command line
and is used by nest-commander to print a correctly formatted
help message.
Note that usage methods can be overwritten but must always
print a standard command line signature.
Generated using TypeDoc
PAYOUT
The implementation for the payout preparation scheduler. Contains source code for the execution logic of a command with name:
processor:PrepareActivityPayouts.Notably, this command fetches activities that have not been the subject of payouts yet and then creates transactions and signs transactions.
v0.4.0