Contract

A Contract Blockchain API allows you to interact with smart contracts on a Zetrix blockchain network programmatically. Smart contracts are agreements that execute automatically when certain conditions are met, and they are stored on the blockchain.

With a Contract Blockchain API, developers can automate the interaction with these smart contracts, allowing them to build decentralized applications (DApps) and more complex blockchain-based systems.

This API typically uses a set of methods to interact with smart contracts, including methods to write data to the blockchain, read data from the blockchain, and execute smart contract functions.

Query Contract

HTTP POST /ztx/contract/query-address

CURL Command

curl POST https://{endpoint}/ztx/contract/query-address

• Function

To query all the contract based contract key.

• The body is in json format

Here body transfer is the transaction data. For specific json format and parameters, see Transaction Structure. Example：

{
    "address": "",
    "method": "",
    "inputParameters": {
    }
}

• Return Value

{
    "object": {
        "result": {
            "type": "string",
            "value": ""
        }
    },
    "messages": [],
    "success": true,
    "timestamp": "",
    "traceId": ""
}

Invoke Contract – History Filter

• Query Parameters

Parameter	Type	Required	Description
address	string	No	Contract address
status	string	No	Transaction status (INITIATED, SUBMITTED, etc.)
contractKey	string	No	Contract key
txInitiator	string	No	Transaction initiator address
txHash	string	No	Transaction hash
method	string	No	Contract method name
createdDateFrom	string	No	Start date (ISO format)
createdDateTo	string	No	End date (ISO format)
page	integer	No	Page number (default: 0)
pageSize	integer	No	Page size (default: 10)
sort	string	No	Field to sort by
isAsc	boolean	No	Sort ascending (true/false)

HTTP GET /ztx/contract/history/filter

CURL Command

curl GET 'https://{endpoint}/ztx/contract/history/filter

• Function

Retrieve contract transaction history with optional filtering and pagination.

• Return Value

{
  "object": {
    "page": 0,
    "pageSize": 10,
    "totalPages": 2,
    "totalElements": 17,
    "content": [
      {
        "id": 1,
        "address": "string",
        "contractKey": "string",
        "txInitiator": "string",
        "method": "string",
        "inputParameters": "string",
        "txHash": "string",
        "status": "string",
        "createdAt": "string",
        "updatedAt": "string"
      }
    ]
  },
  "messages": [],
  "success": true,
  "timestamp": "yyyy-MM-dd HH:mm:ss",
  "traceId": "string"
}

Invoke Contract - Generate Blob

HTTP POST /ztx/contract/generate-blob

CURL Command

curl POST https://{endpoint}/ztx/contract/generate-blob

• Function

Generate a blob.

• The body is in json format

Here body transfer is the transaction data. For specific json format and parameters, see Transaction Structure. Example：

{
  "contractKey": "string",
  "inputParameters": {},
  "method": "string",
  "txInitiator": "string"
}

• Return Value

{
  "messages": [
    {
      "errorCode": 0,
      "message": "string",
      "type": "INFO"
    }
  ],
  "object": {
    "blob": "string",
    "hash": "string",
    "platformSignData": {
      "publicKey": "string",
      "signBlob": "string"
    }
  }
}

Invoke Contract - Sign Blob

HTTP POST /ztx/contract/sign-blob

CURL Command

curl POST https://{endpoint}/ztx/contract/sign-blob

• Function

To sign transaction blob.

• The body is in json format

Here body transfer is the transaction data. For specific json format and parameters, see Transaction Structure. Example：

{
  "privateKey": "",
  "blob": ""
}

• Return Value

{
    "object": [
        {
            "signBlob": "",
            "publicKey": ""
        }
    ],
    "messages": [],
    "success": true,
    "timestamp": "",
    "traceId": ""
}

Invoke Contract - Submit

HTTP POST /ztx/contract/submit

CURL Command

curl POST https://{endpoint}/ztx/contract/submit

• Function

To invoke data to contract.

• The body is in json format

Here body transfer is the transaction data. For specific json format and parameters, see Transaction Structure. Example：

{
  "blob": "string",
  "hash": "string",
  "initiator": "string",
  "listSigner": [
    {
      "publicKey": "string",
      "signBlob": "string"
    }
  ]
}

• Return Value

{
  "messages": [
    {
      "errorCode": 0,
      "message": "string",
      "type": "INFO"
    }
  ],
  "object": {
    "hash": "string"
  }
}