Injection

Injection block

post

Inject a block in the node and broadcast it. The operations embedded in blockHeader might be pre-validated using a contextual RPCs from the latest block (e.g. '/blocks/head/context/preapply'). Returns the ID of the block. By default, the RPC will wait for the block to be validated before answering. If ?async is true, the function returns immediately. Otherwise, the block will be validated before the result is returned. If ?force is true, it will be injected even on non strictly increasing fitness. An optional ?chain parameter can be used to specify whether to inject on the test chain or the main chain.

Authorizations

api-keyAuth

api-keystringRequired

Query parameters

asyncstringOptional

forcestringOptional

chainstringOptional

A chain identifier. This is either a chain hash in Base58Check notation or a one the predefined aliases: 'main', 'test'.

Body

application/json

datastringRequiredPattern: ^([a-zA-Z0-9][a-zA-Z0-9])*$

Responses

200

Valid response

application/json

stringOptional

or

400

Bad Request - missing or invalid parameters

application/json

404

Not Found error

application/json

500

Internal server error

application/json

post

/injection/block

HTTPcURLJavaScriptPython

POST /injection/block HTTP/1.1
Host: xtz.nownodes.io
api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 64

{
  "data": "text",
  "operations": [
    [
      {
        "branch": "text",
        "data": "text"
      }
    ]
  ]
}

text

Injection operation

post

Inject an operation in node and broadcast it. Returns the ID of the operation. The signedOperationContents should be constructed using contextual RPCs from the latest block and signed by the client. The injection of the operation will apply it on the current mempool context. This context may change at each operation injection or operation reception from peers. By default, the RPC will wait for the operation to be (pre-)validated before returning. However, if ?async is true, the function returns immediately. The optional ?chain parameter can be used to specify whether to inject on the test chain or the main chain.

Authorizations

api-keyAuth

api-keystringRequired

Query parameters

asyncstringOptional

chainstringOptional

A chain identifier. This is either a chain hash in Base58Check notation or a one the predefined aliases: 'main', 'test'.

Body

application/json

stringOptionalPattern: ^([a-zA-Z0-9][a-zA-Z0-9])*$

Responses

200

Valid response

application/json

stringOptional

or

400

Bad Request - missing or invalid parameters

application/json

404

Not Found error

application/json

500

Internal server error

application/json

post

/injection/operation

HTTPcURLJavaScriptPython

POST /injection/operation HTTP/1.1
Host: xtz.nownodes.io
api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 6

"text"

text

Injection protocol

post

Inject a protocol in node. Returns the ID of the protocol. If ?async is true, the function returns immediately. Otherwise, the protocol will be validated before the result is returned.

Authorizations

api-keyAuth

api-keystringRequired

Query parameters

asyncstringOptional

Body

application/json

The environment a protocol relies on and the components a protocol is made of.

expected_env_versioninteger · max: 65535Required

Responses

200

Valid response

application/json

stringOptional

or

400

Bad Request - missing or invalid parameters

application/json

404

Not Found error

application/json

500

Internal server error

application/json

post

/injection/protocol

HTTPcURLJavaScriptPython

POST /injection/protocol HTTP/1.1
Host: xtz.nownodes.io
api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 100

{
  "expected_env_version": 1,
  "components": [
    {
      "name": "text",
      "interface": "text",
      "implementation": "text"
    }
  ]
}

text