Troubleshooting blocked transactions

When a transaction is blocked, you need to perform a manual action to resume processing.

Could not increase gas price

The message "Could not increase gas price" is displayed when the settings for gas price on your transaction were too low to process your transactions. Starton Relayer, our transaction's engine, was unable to increase the gas price. To solve this issue you can either:

• Wait. If the gas price to process transaction is too high right now, you can wait for it to decrease.
• Increase the maximum gas price parameter on API enabling Starton to unlock transactions. See Understanding gas.
• Use the API to replace a transaction by another if you changed your mind and want to cancel the transfer.

Could not unstuck nonce

Your transaction is stuck because another transaction with a lower nonce is missing. We tried to create it for you, but we could not. To solve this issue:

• You can send a new unrelated transaction to replace the stuck transaction.
• In settings, you can use API to authorize Starton to unstuck the nonce.

Managing stuck nonces

When sending a transaction without having the correct nonce, the next nonce available in database and the nonce of the blockchain might be desynchronized. To solve this issue, you can resynchronize your nonce for your wallet on a KMS.

info

Nonce management works for a specific address and network at a time. Please make sure you specify the right network in your request.

You can make the following request, by replacing parameters with:

• YOUR_API_KEY: a Starton API Key
• address: the address of your key on your KMS
• network: the network on which you wish to resynchronize nonces

const axios = require("axios")

const startonAPI = axios.create({
	baseURL: "https://api.starton.com",
	headers: {
		"x-api-key": "YOUR_API_KEY",
	},
})

startonAPI
	.get("/v3/kms/wallet/0x694F07CEEc0869aa0dB5E8157FA538268F28B23f/avalanche-fuji/nonce/available")
	.then((res) => console.log(res.data))
	.catch((e) => console.log(e))

startonAPI
	.post("/v3/kms/wallet/0x694F07CEEc0869aa0dB5E8157FA538268F28B23f/avalanche-fuji/nonce/resync")
	.then((res) => console.log(res.data))
	.catch((e) => console.log(e))

If your request is successful, the next nonce available will be returned.

To avoid dealing with stuck nonces manually, you can set the strategy of your Relayer to allow Starton to manage them for you. Learn more in the Setting a transaction management strategy

Maximum gas price reached

The maximum gas price set in the project was reached (+-15%). Starton Relayer, our transaction's engine, was unable to increase the gas price. To solve this issue you can either:

• Wait. If the gas price to process transaction is too high right now, you can wait for it to decrease.
• Increase the maximum gas price parameter on API enabling Starton to unlock transactions. See Understanding gas.
• Use the API to replace a transaction by another if you changed your mind and want to cancel the transfer.

Insufficient funds after broadcast

Your transaction was broadcasted successfully but is now stuck because your funds are insufficient. You need to add funds to your wallet to process this and all the following transactions. To solve this issue, you can:

• Add funds to your wallet.
• If the transaction is too costly, cancel the transaction by replacing it with an empty transaction.