register_leased_network
Call v290 → current #110Creates a new subnet under lease terms.
View calls on chainCall Workflow
Click items to navigate. Pan and zoom to explore.
The Big Picture
Not everyone wants to commit to a permanent subnet with locked capital. Leased networks offer time-limited subnet access - you pay a lease fee for a duration, and the subnet operates normally during that period. When the lease expires, the subnet may be dissolved or require renewal. Good for testing ideas or running temporary projects.
Why This Matters
The full lock cost for a subnet can be substantial. Leasing lets you try before you buy - run a subnet for a month or quarter, see if it gains traction, then decide whether to commit to permanent ownership or let it expire.
Example Scenario
You want to test a new validation mechanism for 3 months. Call register_leased_network(lease_duration=3 months, lease_fee=300 TAO). Your subnet operates normally for 3 months. If successful, you can renew or convert to permanent. If not, the lease expires and you haven't locked 1000+ TAO indefinitely.
Common Questions
- What happens when the lease expires?
- Depends on lease terms - typically the subnet is dissolved or enters a grace period for renewal. Miners are warned before expiration.
- Can I extend a lease?
- Usually yes - call terminate_lease and re-register, or there may be a renewal call. Check network documentation for renewal procedures.
- Is leasing cheaper than owning?
- Short-term: possibly yes, lower upfront cost. Long-term: ownership is cheaper since you get your lock back when dissolving. Leasing is for flexibility, not savings.
Use Cases
- Create a temporary subnet for a specific project
- Lower-commitment subnet experimentation
- Time-limited events or competitions
- Evaluation period before full subnet commitment
From Chain Metadata
Register a new leased network. The crowdloan's contributions are used to compute the share of the emissions that the contributors will receive as dividends. The leftover cap is refunded to the contributors and the beneficiary.
Input Parameters
Permissions
Permission data inferred from metadata. May be incomplete.
Requirements
- Lease terms agreed
- Required payments made (lease fee)
- Lease duration and terms valid
Effects
Events Emitted
Storage Modified
Postconditions
- Subnet created with lease parameters
- Lease info recorded on-chain
- Lease timer started
Side Effects
- Subnet operates under lease conditions
- Lease expires automatically after duration
Possible Errors
Code Examples
// ----------------------------------------------------------------------
// HEADS UP: 1 arg below has a complex type with no usable default.
// Look for `undefined as any` and replace it with real value
// before running — the snippet compiles, but will fail at runtime as-is.
// ----------------------------------------------------------------------
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);
// Build register_leased_network call (typed, named args)
const emissions_share = undefined as any /* Percent — replace with real value */;
const end_block = undefined;
const tx = api.tx.SubtensorModule.register_leased_network({
emissions_share,
end_block,
});Runtime Info
View Source- Pallet Index
- 7
- Call Index
- 110
- First Version
- v290
- Current Version
- v411