leasing precompile | Bittensor EVM

Summary (bittensor.ai, not from the source code)

Subnet leasing: creates a lease crowdloan (Crowdloan::create wrapping SubtensorModule::register_leased_network), starts or terminates a lease (SubtensorModule::start_call / terminate_lease), and reads lease state and dividends.

Signature	Selector	Mutability	Runtime
`createLeaseCrowdloan(uint64,uint64,uint64,uint32,uint8,bool,uint32)`	Selector `0xafed65f9`	Mutability payable	Since runtime 298
Create a lease crowdloan. Parameters `crowdloanDeposit` (uint64) The deposit from the creator. `crowdloanMinContribution` (uint64) The minimum contribution required to contribute to the crowdloan. `crowdloanCap` (uint64) The maximum amount of funds that can be raised. `crowdloanEnd` (uint32) The block number at which the crowdloan will end. `leasingEmissionsShare` (uint8) The share of the emissions that the contributors will receive. `hasLeasingEndBlock` (bool) Whether the lease has an end block. `leasingEndBlock` (uint32) The block number at which the lease will end.
`getAccumulatedLeaseDividends(uint32)`	Selector `0x5476deb6`	Mutability view	Since runtime 444
No documentation in the source. Parameters `leaseId` (uint32) Returns `return` (uint64)
`getContributorShare(uint32,bytes32)`	Selector `0x3175bd98`	Mutability view	Since runtime 298
Retrieves the contributor share for a given lease id and contributor. The share is returned as a tuple of two uint128 values, where the first value is the integer part and the second value is the fractional part. Parameters `leaseId` (uint32) The id of the lease to get contributor share for. `contributor` (bytes32) The contributor to get share for. Returns `return 1` (uint128) The contributor share. `return 2` (uint128)
`getLease(uint32)`	Selector `0xda2d4c2b`	Mutability view	Since runtime 298
Retrieves the lease info for a given lease id. Parameters `leaseId` (uint32) The id of the lease to get info for. Returns `return` (tuple(bytes32 beneficiary, bytes32 coldkey, bytes32 hotkey, uint8 emissions_share, bool has_end_block, uint32 end_block, uint16 netuid, uint64 cost)) The lease info.
`getLeaseIdForSubnet(uint16)`	Selector `0xe42363d5`	Mutability view	Since runtime 298
Retrieves the lease id for a given subnet. Parameters `netuid` (uint16) The subnet to get lease id for. Returns `return` (uint32) The lease id.
`getNextLeaseId()`	Selector `0x0d8dc643`	Mutability view	Since runtime 444
No documentation in the source. Returns `return` (uint32)
`startCall(uint16)`	Selector `0x6f2c5e62`	Mutability nonpayable	Since runtime 444
No documentation in the source. Parameters `netuid` (uint16)
`terminateLease(uint32,bytes32)`	Selector `0x90cfa75b`	Mutability payable	Since runtime 298
Terminates a lease and transfers the ownership to the beneficiary. Parameters `leaseId` (uint32) The id of the lease to terminate. `hotkey` (bytes32) The hotkey of beneficiary, it must be owned by the beneficiary coldkey.

Signature

Selector

Mutability

Runtime

createLeaseCrowdloan(uint64,uint64,uint64,uint32,uint8,bool,uint32)

Selector 0xafed65f9

Mutability payable

Since runtime 298

Create a lease crowdloan.

Parameters

crowdloanDeposit (uint64) The deposit from the creator.
crowdloanMinContribution (uint64) The minimum contribution required to contribute to the crowdloan.
crowdloanCap (uint64) The maximum amount of funds that can be raised.
crowdloanEnd (uint32) The block number at which the crowdloan will end.
leasingEmissionsShare (uint8) The share of the emissions that the contributors will receive.
hasLeasingEndBlock (bool) Whether the lease has an end block.
leasingEndBlock (uint32) The block number at which the lease will end.

getAccumulatedLeaseDividends(uint32)

Selector 0x5476deb6

Mutability view

Since runtime 444

No documentation in the source.

Parameters

leaseId (uint32)

Returns

return (uint64)

getContributorShare(uint32,bytes32)

Selector 0x3175bd98

Mutability view

Since runtime 298

Retrieves the contributor share for a given lease id and contributor. The share is returned as a tuple of two uint128 values, where the first value is the integer part and the second value is the fractional part.

Parameters

leaseId (uint32) The id of the lease to get contributor share for.
contributor (bytes32) The contributor to get share for.

Returns

return 1 (uint128) The contributor share.
return 2 (uint128)

getLease(uint32)

Selector 0xda2d4c2b

Mutability view

Since runtime 298

Retrieves the lease info for a given lease id.

Parameters

leaseId (uint32) The id of the lease to get info for.

Returns

return (tuple(bytes32 beneficiary, bytes32 coldkey, bytes32 hotkey, uint8 emissions_share, bool has_end_block, uint32 end_block, uint16 netuid, uint64 cost)) The lease info.

getLeaseIdForSubnet(uint16)

Selector 0xe42363d5

Mutability view

Since runtime 298

Retrieves the lease id for a given subnet.

Parameters

netuid (uint16) The subnet to get lease id for.

Returns

return (uint32) The lease id.

getNextLeaseId()

Selector 0x0d8dc643

Mutability view

Since runtime 444

No documentation in the source.

Returns

return (uint32)

startCall(uint16)

Selector 0x6f2c5e62

Mutability nonpayable

Since runtime 444

No documentation in the source.

Parameters

netuid (uint16)

terminateLease(uint32,bytes32)

Selector 0x90cfa75b

Mutability payable

Since runtime 298

Terminates a lease and transfers the ownership to the beneficiary.

Parameters

leaseId (uint32) The id of the lease to terminate.
hotkey (bytes32) The hotkey of beneficiary, it must be owned by the beneficiary coldkey.

Summary (bittensor.ai, not from the source code)

Signature	Selector	Mutability	Runtime
`createLeaseCrowdloan(uint64,uint64,uint64,uint32,uint8,bool,uint32)`	Selector `0xafed65f9`	Mutability payable	Since runtime 298
Create a lease crowdloan. Parameters `crowdloanDeposit` (uint64) The deposit from the creator. `crowdloanMinContribution` (uint64) The minimum contribution required to contribute to the crowdloan. `crowdloanCap` (uint64) The maximum amount of funds that can be raised. `crowdloanEnd` (uint32) The block number at which the crowdloan will end. `leasingEmissionsShare` (uint8) The share of the emissions that the contributors will receive. `hasLeasingEndBlock` (bool) Whether the lease has an end block. `leasingEndBlock` (uint32) The block number at which the lease will end.
`getAccumulatedLeaseDividends(uint32)`	Selector `0x5476deb6`	Mutability view	Since runtime 444
No documentation in the source. Parameters `leaseId` (uint32) Returns `return` (uint64)
`getContributorShare(uint32,bytes32)`	Selector `0x3175bd98`	Mutability view	Since runtime 298
Retrieves the contributor share for a given lease id and contributor. The share is returned as a tuple of two uint128 values, where the first value is the integer part and the second value is the fractional part. Parameters `leaseId` (uint32) The id of the lease to get contributor share for. `contributor` (bytes32) The contributor to get share for. Returns `return 1` (uint128) The contributor share. `return 2` (uint128)
`getLease(uint32)`	Selector `0xda2d4c2b`	Mutability view	Since runtime 298
Retrieves the lease info for a given lease id. Parameters `leaseId` (uint32) The id of the lease to get info for. Returns `return` (tuple(bytes32 beneficiary, bytes32 coldkey, bytes32 hotkey, uint8 emissions_share, bool has_end_block, uint32 end_block, uint16 netuid, uint64 cost)) The lease info.
`getLeaseIdForSubnet(uint16)`	Selector `0xe42363d5`	Mutability view	Since runtime 298
Retrieves the lease id for a given subnet. Parameters `netuid` (uint16) The subnet to get lease id for. Returns `return` (uint32) The lease id.
`getNextLeaseId()`	Selector `0x0d8dc643`	Mutability view	Since runtime 444
No documentation in the source. Returns `return` (uint32)
`startCall(uint16)`	Selector `0x6f2c5e62`	Mutability nonpayable	Since runtime 444
No documentation in the source. Parameters `netuid` (uint16)
`terminateLease(uint32,bytes32)`	Selector `0x90cfa75b`	Mutability payable	Since runtime 298
Terminates a lease and transfers the ownership to the beneficiary. Parameters `leaseId` (uint32) The id of the lease to terminate. `hotkey` (bytes32) The hotkey of beneficiary, it must be owned by the beneficiary coldkey.

Signature

Selector

Mutability

Runtime

createLeaseCrowdloan(uint64,uint64,uint64,uint32,uint8,bool,uint32)

Selector 0xafed65f9

Mutability payable

Since runtime 298

Create a lease crowdloan.

Parameters

crowdloanDeposit (uint64) The deposit from the creator.
crowdloanMinContribution (uint64) The minimum contribution required to contribute to the crowdloan.
crowdloanCap (uint64) The maximum amount of funds that can be raised.
crowdloanEnd (uint32) The block number at which the crowdloan will end.
leasingEmissionsShare (uint8) The share of the emissions that the contributors will receive.
hasLeasingEndBlock (bool) Whether the lease has an end block.
leasingEndBlock (uint32) The block number at which the lease will end.

getAccumulatedLeaseDividends(uint32)

Selector 0x5476deb6

Mutability view

Since runtime 444

No documentation in the source.

Parameters

leaseId (uint32)

Returns

return (uint64)

getContributorShare(uint32,bytes32)

Selector 0x3175bd98

Mutability view

Since runtime 298

Parameters

leaseId (uint32) The id of the lease to get contributor share for.
contributor (bytes32) The contributor to get share for.

Returns

return 1 (uint128) The contributor share.
return 2 (uint128)

getLease(uint32)

Selector 0xda2d4c2b

Mutability view

Since runtime 298

Retrieves the lease info for a given lease id.

Parameters

leaseId (uint32) The id of the lease to get info for.

Returns

return (tuple(bytes32 beneficiary, bytes32 coldkey, bytes32 hotkey, uint8 emissions_share, bool has_end_block, uint32 end_block, uint16 netuid, uint64 cost)) The lease info.

getLeaseIdForSubnet(uint16)

Selector 0xe42363d5

Mutability view

Since runtime 298

Retrieves the lease id for a given subnet.

Parameters

netuid (uint16) The subnet to get lease id for.

Returns

return (uint32) The lease id.

getNextLeaseId()

Selector 0x0d8dc643

Mutability view

Since runtime 444

No documentation in the source.

Returns

return (uint32)

startCall(uint16)

Selector 0x6f2c5e62

Mutability nonpayable

Since runtime 444

No documentation in the source.

Parameters

netuid (uint16)

terminateLease(uint32,bytes32)

Selector 0x90cfa75b

Mutability payable

Since runtime 298

Terminates a lease and transfers the ownership to the beneficiary.

Parameters

leaseId (uint32) The id of the lease to terminate.
hotkey (bytes32) The hotkey of beneficiary, it must be owned by the beneficiary coldkey.

leasing

Summary (bittensor.ai, not from the source code)

Functions

leasing

Summary (bittensor.ai, not from the source code)

Functions