SubnetLeaseDividendsDistributed

Event v361 → v362, v365 → v367, v372 → v377, v385 → v385, v391 → v402, v411 → current Changed in v411 #119

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 LeaseId	lease_id: Lease identifier
1	contributor	AccountId	contributor: Account address (32 bytes, SS58-encoded) (hex -> SS58)
2	alpha	u64 AlphaBalance	alpha: Alpha amount in alpha-RAO (÷10⁹ for alpha) (RAO -> TAO (/ 10^9))

Code Examples

import { createClient, Binary } from "polkadot-api";
import { getWsProvider } from "polkadot-api/ws";
import { sub } from "@polkadot-api/descriptors"; // generated by: npx papi add sub -w wss://entrypoint-finney.opentensor.ai:443

const client = createClient(getWsProvider("wss://entrypoint-finney.opentensor.ai:443"));
const api = client.getTypedApi(sub);

// Subscribe to SubnetLeaseDividendsDistributed events
client.finalizedBlock$.subscribe(async (block) => {
  const events = await api.event.SubtensorModule.SubnetLeaseDividendsDistributed.get(block.hash);
  for (const evt of events) {
    console.log("SubnetLeaseDividendsDistributed:", evt.payload);
  }
});

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

v391 block 7,782,857 3 args

v411 block 8,283,784 3 args Current

Runtime Info

View Source

Pallet Index: 7
Event Index: 119
First Version: v361
Current Version: v411

Back to SubtensorModule Events