XChain Platform Action - DIVIDEND
This action pays a dividend to holders of TICK.
PARAMS
| Name | Type | Description |
|---|---|---|
VERSION |
String | Format Version |
TICK |
String | Ticker name or Ticker ID |
DIVIDEND_TICK |
String | The TICK that dividends are paid in |
AMOUNT |
String | Amount of TICK to pay out per UNIT |
MEMO |
String | An optional memo to include |
Formats
Version 0
VERSION|TICK|DIVIDEND_TICK|AMOUNT|MEMO
Examples
DIVIDEND|0|BRRR|BACON|1
This example pays a dividend of 1 BACON token to every holder of 1 BRRR token
DIVIDEND|0|TEST|BACON|0.5
This example pays a dividend of 0.5 BACON token to every holder of 1 TEST token
Rules
Notes
DIVIDENDrequires a fee. The fee may be paid inXCHAIN(deducted from the sender’s balance) or in native coin via a qualified coin output in the same transaction; on Litecoin and Dogecoin the native-coin output is the only accepted form.- The fee is priced on the unified gas schedule as
DIVIDEND_PER_RECIPIENTfor each holder actually paid (see the exclusions below).UNIFIED_FEESis active from genesis on every network; the indexer still carries the earlier per-database-hit model behind that gate, but no current network runs it. See the hub’s gas schedule for the values. ADIVIDENDemitted by a contract pays no separate fee; the dividend paid to holders is still debited. UNIT- A specific unit of measure (1 or 1.0)- To send
TICKto a large number of users, see theAIRDROPorSENDcommands - If
TICKis divisible andDIVIDEND_TICKis non-divisble, quantities whose calculated share rounds to 0 will receive noDIVIDEND_TICK. Such holders are excluded from the recipient list entirely, so they do not count toward the per-recipient fee charged toSOURCE SOURCEaddress is excluded from receiving dividends- If
DIVIDEND_TICKcarries a non-emptyALLOW_LIST, only holders on that list receive the dividend, and holders on its non-emptyBLOCK_LISTare excluded. The lists consulted are those of the payment token (DIVIDEND_TICK), not the share token (TICK). At or above theDIVIDEND_EMPTY_ALLOW_LIST_DENIES_ACTIVATIONheight an attachedALLOW_LISTwith no members admits no holder, so theDIVIDENDpays no one; below the height a configured but empty list admits everyone. A reference the list validity gate rejects counts as no attached list on both sides of the height. The height is armed on testnet at each chain’s own height and unarmed on mainnet, and a regtest venue arms it withXC_DIVIDEND_EMPTY_ALLOW_LIST_DENIES_REGTEST_ACTIVATION. Excluded holders do not count toward the per-recipient fee charged toSOURCE - Any
ADDRESSmay pay out aDIVIDENDon anyTICK - Use
^(caret) as prefix when passingTICK_IDforTICKfield (^1234 =TICK_ID1234)
Copyright © 2025–2026 Dankest, LLC
Based on XChain Platform by Dankest, LLC – https://dankest.llc
Licensed under the GNU Affero General Public License v3.0 (AGPL-3.0-or-later) with a commercial license available for proprietary use.
You may use, modify, and distribute this material under the terms of the License. See LICENSE and NOTICE for full terms. See the licensing overview.