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

  • DIVIDEND requires a fee. The fee may be paid in XCHAIN (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_RECIPIENT for each holder actually paid (see the exclusions below). UNIFIED_FEES is 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. A DIVIDEND emitted 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 TICK to a large number of users, see the AIRDROP or SEND commands
  • If TICK is divisible and DIVIDEND_TICK is non-divisble, quantities whose calculated share rounds to 0 will receive no DIVIDEND_TICK. Such holders are excluded from the recipient list entirely, so they do not count toward the per-recipient fee charged to SOURCE
  • SOURCE address is excluded from receiving dividends
  • If DIVIDEND_TICK carries a non-empty ALLOW_LIST, only holders on that list receive the dividend, and holders on its non-empty BLOCK_LIST are excluded. The lists consulted are those of the payment token (DIVIDEND_TICK), not the share token (TICK). At or above the DIVIDEND_EMPTY_ALLOW_LIST_DENIES_ACTIVATION height an attached ALLOW_LIST with no members admits no holder, so the DIVIDEND pays 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 with XC_DIVIDEND_EMPTY_ALLOW_LIST_DENIES_REGTEST_ACTIVATION. Excluded holders do not count toward the per-recipient fee charged to SOURCE
  • Any ADDRESS may pay out a DIVIDEND on any TICK
  • Use ^ (caret) as prefix when passing TICK_ID for TICK field (^1234 = TICK_ID 1234)

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.

Edit this page on GitHub ↗