Get Network Options

POST

https://ada.nownodes.io/network/options

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

CHANGELOG — Cardano Rosetta Java 2.3.3 → 2.4.0 Add allow.call_methods (including resolve_smart_wallet_addr), document CIP-113 error codes 5062-5067, and update 2.4.0 middleware version example.

This endpoint returns the version information and allowed network-specific types for a NetworkIdentifier. Any NetworkIdentifier returned by /network/list should be accessible here. Because options are retrievable in the context of a NetworkIdentifier, it is possible to define unique options for each network.

Cardano Rosetta Java 2.4.0: allow.call_methods includes resolve_smart_wallet_addr; allow.errors also includes CIP-113 validation errors 5062-5067. version.middleware_version is 2.4.0 when that release is deployed.

Body

application/json

Request value.

network_identifierobjectrequired

Rosetta network identifier.

Show child attributes

blockchainstringrequired

Blockchain name, always "cardano".

networkstringrequired

Network name matching the node configuration (mainnet, preprod, preview).

Response

200OK

HTTP 200 response for networkOptions.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or backend failed while processing the request.

Get Network Options

curl -X POST 'https://ada.nownodes.io/network/options' \
  -H 'Content-Type: application/json' \
  -d '{
    "network_identifier": {
      "blockchain": "cardano",
      "network": "mainnet"
    }
  }'

const response = await fetch('https://ada.nownodes.io/network/options', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "network_identifier": {
        "blockchain": "cardano",
        "network": "mainnet"
      }
    }),
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://ada.nownodes.io/network/options')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
    "network_identifier": {
      "blockchain": "cardano",
      "network": "mainnet"
    }
  }'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

import requests

payload = {
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet"
  }
}

response = requests.post('https://ada.nownodes.io/network/options', json=payload)
data = response.json()

const response = await fetch('https://ada.nownodes.io/network/options', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "network_identifier": {
        "blockchain": "cardano",
        "network": "mainnet"
      }
    }),
});

const data = await response.json();

const endpoint = "https://ada.nownodes.io/network/options";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({
    "network_identifier": {
      "blockchain": "cardano",
      "network": "mainnet"
    }
  });
console.log(result);

const response = await fetch('https://ada.nownodes.io/network/options', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "network_identifier": {
        "blockchain": "cardano",
        "network": "mainnet"
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet"
  }
}

response = requests.post('https://ada.nownodes.io/network/options', json=payload)
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://ada.nownodes.io/network/options')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
    "network_identifier": {
      "blockchain": "cardano",
      "network": "mainnet"
    }
  }'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

Request Body

{
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet"
  }
}

{
  "version": {
    "rosetta_version": "1.4.13",
    "node_version": "11.1.3",
    "middleware_version": "2.4.0"
  },
  "allow": {
    "operation_statuses": [
      {
        "status": "success",
        "successful": true
      },
      {
        "status": "invalid",
        "successful": false
      }
    ],
    "operation_types": [
      "input",
      "output",
      "stakeKeyRegistration"
    ],
    "errors": [
      {
        "code": 4000,
        "message": "Invalid Network configuration",
        "retriable": false
      },
      {
        "code": 5062,
        "message": "metadata.staking_credential is not allowed for CIP-113 address derivation",
        "retriable": false
      }
    ],
    "call_methods": [
      "get_parse_error_blocks",
      "mark_parse_error_block_checked",
      "resolve_smart_wallet_addr"
    ]
  }
}

{
  "code": 4000,
  "message": "Invalid request",
  "retriable": false
}

{
  "status_code": 400,
  "message": "Bad Request",
  "error": "bad_request"
}

Unknown API_key

Missing API_key

{
  "status_code": 500,
  "message": "Internal Server Error",
  "error": "internal_server_error"
}