Deprecated API Calls

This page lists API methods, arguments and responses that are deprecated and will be removed or modified in a future release.

P-Chain API

getCurrentValidators

In v1.0.0, the signature was:

platform.getCurrentValidators({subnetID: string}) ->
{
validators: []{
startTime: string,
endTime: string,
stakeAmount: string, //optional
nodeID: string,
weight: string, //optional
rewardOwner: {
locktime: string,
threshold: string,
addresses: string[]
},
potentialReward: string,
delegationFee: string,
uptime: string,
connected: boolean
},
delegators: []{
startTime: string,
endTime: string,
stakeAmount: string, //optional
nodeID: string,
rewardOwner: {
locktime: string,
threshold: string,
addresses: string[]
},
potentialReward: string,
}
}

In later versions, the signature was as follows. Note that each validator contains a list of its delegators. Please see the next note for current behavior.

platform.getCurrentValidators({subnetID: string}) ->
{
validators: []{
startTime: string,
endTime: string,
stakeAmount: string, //optional
nodeID: string,
weight: string, //optional
rewardOwner: {
locktime: string,
threshold: string,
addresses: string[]
},
potentialReward: string,
delegationFee: string,
uptime: string,
connected: boolean,
delegators: []{
startTime: string,
endTime: string,
stakeAmount: string, //optional
nodeID: string,
rewardOwner: {
locktime: string,
threshold: string,
addresses: string[]
},
potentialReward: string,
}
},
delegators: []{
startTime: string,
endTime: string,
stakeAmount: string, //optional
nodeID: string,
rewardOwner: {
locktime: string,
threshold: string,
addresses: string[]
},
potentialReward: string,
}
}

Since v1.0.6, top level delegators field is removed. The signature is now:

platform.getCurrentValidators({subnetID: string}) ->
{
validators: []{
startTime: string,
endTime: string,
stakeAmount: string, //optional
nodeID: string,
weight: string, //optional
rewardOwner: {
locktime: string,
threshold: string,
addresses: string[]
},
potentialReward: string,
delegationFee: string,
uptime: string,
connected: boolean,
delegators: []{
startTime: string,
endTime: string,
stakeAmount: string, //optional
nodeID: string,
rewardOwner: {
locktime: string,
threshold: string,
addresses: string[]
},
potentialReward: string,
}
}
}

getTxStatus

Before v1.0.4, the signature was:

platform.getTxStatus({txID: string} -> status: string

v1.0.4 added an argument includeReason. If false or not provided, this method's response was the same as before. If true, this method's response had this new format:

{
status: string,
reason: string //optional
}

Where reason is the reason the transaction was dropped. reason is only present if status is "Dropped".

Since v1.0.6, the includeReason argument is ignored, and this method's response is always in the new format.