Submit a legacy Zilliqa transaction (migration escrow only)

deprecated

POST

https://zil.nownodes.io/

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

DEPRECATED / RESTRICTED.

CreateTransaction submits legacy Zilliqa transactions signed with the legacy Schnorr scheme.

In zq2 v0.21.9 the method is still registered in the RPC surface; it is not removed.

Behaviour depends on the migration state:

Before the escrow migration flag is active, the handler rejects the call with JSON-RPC error code -32 (RpcMethodDeprecated) and message "CreateTransaction is disabled".
After the escrow migration flag is active, the handler processes the legacy transaction, but network validation only accepts transactions addressed to the designated migration escrow contract.
A legacy transaction targeting any other address is rejected with JSON-RPC error code -26 (RpcVerifyRejected) and message "Zilliqa transactions are only accepted when addressed to the escrow contract".

For normal Zilliqa EVM transaction submission, use eth_sendRawTransaction.

This entry documents a behavioural migration change. It does not represent removal of the CreateTransaction RPC method.

Body

application/json

jsonrpcstring2.0required

JSON-RPC version.

methodstringCreateTransactionrequired

RPC method name.

idinteger<int64>required

JSON-RPC request ID.

paramsArray<LegacyZilliqaTransaction>required

Legacy Zilliqa transaction parameters.

Show child attributes

versioninteger<int64>required

Legacy Zilliqa transaction version. zq2 derives the Zilliqa chain ID from the upper 16 bits and expects transaction version 1 in the lower 16 bits.

nonceinteger<int64>>= 1required

Legacy Zilliqa transaction nonce. Zero is rejected.

toAddrstringrequired

Destination address in hexadecimal form, with or without the 0x prefix. After escrow migration activation this must be the designated migration escrow contract address.

amountstringrequired

Amount in Qa, encoded as a decimal string.

pubKeystringrequired

Compressed secp256k1 public key as a hexadecimal string.

gasPricestringrequired

Gas price in Qa, encoded as a decimal string.

gasLimitstringrequired

Scilla gas limit, encoded as a decimal string.

codestring

Optional legacy Scilla contract code. Not used for a normal migration transfer.

datastring

Optional legacy transaction data payload.

signaturestringrequired

Schnorr transaction signature as a hexadecimal string.

Response

200OK

Native zq2 JSON-RPC response. Application-level success and rejection responses are returned as JSON-RPC envelopes.

400Bad Request

Gateway-level response observed on the NOWNodes endpoint on 2026-09-14: {"error":"ECONNREFUSED"}.

This is not the native zq2 CreateTransaction JSON-RPC error contract and should not be treated as the permanent response of the RPC method.

Submit a legacy Zilliqa transaction (migration escrow only)

curl -X POST 'https://zil.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "CreateTransaction",
    "id": 1,
    "params": [
      {
        "version": 65537,
        "nonce": 10,
        "toAddr": "1111111111111111111111111111111111111111",
        "amount": "1000000000000",
        "pubKey": "02aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
        "gasPrice": "2000000000",
        "gasLimit": "50",
        "code": "",
        "data": "",
        "signature": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
      }
    ]
  }'

import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider("https://zil.nownodes.io/");
const result = await provider.send("CreateTransaction", [
  {
    "version": 65537,
    "nonce": 10,
    "toAddr": "1111111111111111111111111111111111111111",
    "amount": "1000000000000",
    "pubKey": "02aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
    "gasPrice": "2000000000",
    "gasLimit": "50",
    "code": "",
    "data": "",
    "signature": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  }
]);
console.log(result);

require 'eth'
require 'json'
require 'net/http'

uri = URI('https://zil.nownodes.io/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
  "jsonrpc": "2.0",
  "method": "CreateTransaction",
  "params": [
    {
      "version": 65537,
      "nonce": 10,
      "toAddr": "1111111111111111111111111111111111111111",
      "amount": "1000000000000",
      "pubKey": "02aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "gasPrice": "2000000000",
      "gasLimit": "50",
      "code": "",
      "data": "",
      "signature": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
    }
  ],
  "id": 1
}'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts JSON.parse(response.body)

from web3 import Web3

w3 = Web3(Web3.HTTPProvider("https://zil.nownodes.io/"))
response = w3.provider.make_request("CreateTransaction", [
  {
    "version": 65537,
    "nonce": 10,
    "toAddr": "1111111111111111111111111111111111111111",
    "amount": "1000000000000",
    "pubKey": "02aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
    "gasPrice": "2000000000",
    "gasLimit": "50",
    "code": "",
    "data": "",
    "signature": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  }
])
print(response)

import { createPublicClient, http } from "viem";

const client = createPublicClient({
  transport: http("https://zil.nownodes.io/"),
});

const result = await client.request({
  method: "CreateTransaction",
  params: [
  {
    "version": 65537,
    "nonce": 10,
    "toAddr": "1111111111111111111111111111111111111111",
    "amount": "1000000000000",
    "pubKey": "02aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
    "gasPrice": "2000000000",
    "gasLimit": "50",
    "code": "",
    "data": "",
    "signature": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  }
],
});

console.log(result);

const endpoint = "https://zil.nownodes.io/";
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({ jsonrpc: "2.0", method: "CreateTransaction", params: [
  {
    "version": 65537,
    "nonce": 10,
    "toAddr": "1111111111111111111111111111111111111111",
    "amount": "1000000000000",
    "pubKey": "02aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
    "gasPrice": "2000000000",
    "gasLimit": "50",
    "code": "",
    "data": "",
    "signature": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  }
], id: 1 });
console.log(result);

const response = await fetch('https://zil.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "CreateTransaction",
      "id": 1,
      "params": [
        {
          "version": 65537,
          "nonce": 10,
          "toAddr": "1111111111111111111111111111111111111111",
          "amount": "1000000000000",
          "pubKey": "02aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
          "gasPrice": "2000000000",
          "gasLimit": "50",
          "code": "",
          "data": "",
          "signature": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
        }
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "CreateTransaction",
  "id": 1,
  "params": [
    {
      "version": 65537,
      "nonce": 10,
      "toAddr": "1111111111111111111111111111111111111111",
      "amount": "1000000000000",
      "pubKey": "02aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "gasPrice": "2000000000",
      "gasLimit": "50",
      "code": "",
      "data": "",
      "signature": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
    }
  ]
}

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

require 'net/http'
require 'json'

uri = URI('https://zil.nownodes.io/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
    "jsonrpc": "2.0",
    "method": "CreateTransaction",
    "id": 1,
    "params": [
      {
        "version": 65537,
        "nonce": 10,
        "toAddr": "1111111111111111111111111111111111111111",
        "amount": "1000000000000",
        "pubKey": "02aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
        "gasPrice": "2000000000",
        "gasLimit": "50",
        "code": "",
        "data": "",
        "signature": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
      }
    ]
  }'

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

Request Body

Illustrative request shape. toAddr must be the designated migration escrow contract and the signature must be valid for the supplied transaction.

{
  "jsonrpc": "2.0",
  "method": "CreateTransaction",
  "id": 1,
  "params": [
    {
      "version": 65537,
      "nonce": 10,
      "toAddr": "1111111111111111111111111111111111111111",
      "amount": "1000000000000",
      "pubKey": "02aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "gasPrice": "2000000000",
      "gasLimit": "50",
      "code": "",
      "data": "",
      "signature": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "Info": "Txn processed",
    "TranID": "0x1234abcd5678ef901234abcd5678ef901234abcd5678ef901234abcd5678ef90"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32,
    "message": "CreateTransaction is disabled"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -26,
    "message": "Zilliqa transactions are only accepted when addressed to the escrow contract"
  }
}

{
  "error": "ECONNREFUSED"
}