SubnetLeaseDividendsDistributed

Event Re-added v361 → v362, v365 → v367, v372 → v377, v385 → current #118

Emitted when lease dividends are distributed to stakeholders.

Useful for: subnet ownersvalidatorsstakersanalytics

The Big Picture

Subnet leases typically involve regular payments or dividend distributions. The lessee operates the subnet, and various stakeholders (owner, investors, etc.) receive their share of the value generated. This event marks each dividend distribution - it's payday for lease participants.

Why This Matters

If you're receiving dividends from a subnet lease (as owner, investor, or other beneficiary), this event confirms your payment. Tracking these helps you verify the lease is performing as expected and payments are consistent.

Example Scenario

You leased your subnet for monthly payments. At the end of the month, SubnetLeaseDividendsDistributed fires showing 100 TAO distributed - 70 TAO to you (owner), 30 TAO to the lease facilitator. Your passive income from the lease is confirmed.

Common Questions

Who receives lease dividends?: Depends on the lease structure. Typically the owner gets the largest share, but there may be investors, facilitators, or other beneficiaries defined in the lease terms.
How often are dividends distributed?: Depends on the lease terms. Could be per-epoch, daily, weekly, monthly. Check the lease configuration or track NextDividendBlock for timing.
What if dividends stop?: The lease might be terminated, the lessee might be in breach, or there might be a dispute. Investigate if expected dividends don't appear.

Use Cases

Track lease dividend distributions
Verify lease payments are being made
Monitor lease economics over time
Build lease income tracking dashboards

How to Use This Event

→ Track dividend timing and amounts for leased subnets
→ Monitor lease payment compliance
→ Build lease income tracking tools

From Chain Metadata

Subnet lease dividends have been distributed.

Triggers

Preconditions

Active lease exists
Dividend distribution block reached

Effects

Postconditions

Dividends transferred to beneficiaries
NextDividendBlock updated

Side Effects

Lease participants receive rewards

Event Data

#	Name	Type	Description
0	lease_id	u32	lease_id (u32)
1	contributor	AccountId	contributor (AccountId) (hex -> SS58)
2	alpha	u64	alpha (u64) (RAO -> TAO (/ 10^9))

Code Examples

import { ApiPromise, WsProvider } from "@polkadot/api";
import { stringCamelCase } from "@polkadot/util";

const provider = new WsProvider("wss://entrypoint-finney.opentensor.ai:443");
const api = await ApiPromise.create({ provider });

// Subscribe to SubnetLeaseDividendsDistributed events
api.query.system.events((events) => {
  events
    .filter(({ event }) =>
      event.section === stringCamelCase("SubtensorModule") &&
      event.method === "SubnetLeaseDividendsDistributed"
    )
    .forEach(({ event }) => {
      console.log("SubnetLeaseDividendsDistributed:", event.data.toHuman());
    });
});

Version History

Version:

v361 block 7,063,679 3 args

v365 block 7,135,419 3 args

v372 block 7,430,358 3 args

v385 block 7,782,670 3 args Current

Runtime Info

View Source

Pallet Index: 7
Event Index: 118
First Version: v361
Current Version: v393

Back to SubtensorModule Events