Account deposit pre validation

PreValidate deposit of resources to an account

Helper endpoint that allows pre-validation if a deposit of certain resources to a given account can succeed or not. It is only meant for pre-validation usage, it does not guarantee that execution will succeed.

POSThttps://xrd-gateway.nownodes.io/transaction/account-deposit-pre-validation

Header parameters

Body

application/json

account_address*Address (string)

Bech32m-encoded human readable version of the address.

resource_addresses*array of Address (string)

badgeTransactionAccountDepositPreValidationAuthorizedDepositorBadge (object)

Response

2004XX

Pre-validation response, including all deciding factors that were used to generate that response.

Body

application/json

ledger_state*LedgerState (object)

The ledger state against which the response was generated. Can be used to detect if the Network Gateway is returning up-to-date information.

allows_try_deposit_batch*boolean

resource_specific_behaviourarray of AccountDepositPreValidationResourceSpecificBehaviourItem (object)

The fully resolved try_deposit_* ability of each resource (which takes all the inputs into account, including the authorized depositor badge, the default deposit rule and the resource-specific details).

deciding_factors*AccountDepositPreValidationDecidingFactors (object)

Deciding factors used to calculate response.

Request

JavaScriptCurlPython

const response = await fetch('https://xrd-gateway.nownodes.io/transaction/account-deposit-pre-validation', {
    method: 'POST',
    headers: {
      "api-key": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "account_address": "<account-address>",
      "resource_addresses": [
        "resource_rdx1tknxxxxxxxxxradxrdxxxxxxxxx009923554798xxxxxxxxxradxrd"
      ]
    }),
});
const data = await response.json();

Response

2004XX

{
  "ledger_state": {
    "network": "mainnet",
    "proposer_round_timestamp": "text"
  },
  "allows_try_deposit_batch": false,
  "resource_specific_behaviour": [
    {
      "resource_address": "text",
      "allows_try_deposit": false
    }
  ],
  "deciding_factors": {
    "is_badge_authorized_depositor": false,
    "default_deposit_rule": "Accept",
    "resource_specific_details": [
      {
        "resource_address": "text",
        "vault_exists": false,
        "is_xrd": false,
        "resource_preference_rule": "Allowed"
      }
    ]
  }
}