> For the complete documentation index, see [llms.txt](https://docs.zetrix.com/en/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zetrix.com/en/developer-resources/blockchain-as-a-services-baas/zetrix-service/models.md).

# Models

## The HsmCreateAccountReqDto object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"HsmCreateAccountReqDto":{"type":"object","description":"Request to create an HSM-backed Ed25519 key pair","properties":{"label":{"type":"string","description":"Optional caller-supplied label suffix. Final key label = ZETRIX_<label> if provided, else ZETRIX_<uuid>."},"purpose":{"type":"string","description":"Optional purpose description for this key"},"password":{"type":"string","description":"User password used to encrypt the HSM key label in DB storage","minLength":8,"maxLength":128}},"required":["password"]}}}}
```

## The HsmCreateAccountRespDto object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"HsmCreateAccountRespDto":{"type":"object","description":"Response for HSM key pair creation","properties":{"publicKeyHex":{"type":"string","description":"Raw Ed25519 public key as hex string (64 hex chars = 32 bytes)"},"zetrixAddress":{"type":"string","description":"Zetrix blockchain address derived from the public key (e.g. ZTX3...). Use this as the identifier in subsequent sign requests."}}}}}}
```

## The HsmBlobDataReqDto object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"HsmBlobDataReqDto":{"type":"object","description":"Request to sign a transaction blob using the HSM","properties":{"blob":{"type":"string","description":"Hex-encoded transaction blob to sign (obtained from /tx/generate-blob or /contract/generate-blob)"},"password":{"type":"string","description":"User password used to decrypt the stored HSM key label","minLength":8,"maxLength":128},"address":{"type":"string","description":"Zetrix address returned by /hsm/create-account"}},"required":["blob","password","address"]}}}}
```

## The HsmMessageDataReqDto object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"HsmMessageDataReqDto":{"type":"object","description":"Request to sign a UTF-8 message using the HSM","properties":{"message":{"type":"string","description":"UTF-8 message to sign"},"password":{"type":"string","description":"User password used to decrypt the stored HSM key label","minLength":8,"maxLength":128},"address":{"type":"string","description":"Zetrix address returned by /hsm/create-account"}},"required":["message","password","address"]}}}}
```

## The ResponseWrapperHsmCreateAccountRespDto object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"ResponseWrapperHsmCreateAccountRespDto":{"type":"object","properties":{"object":{"$ref":"#/components/schemas/HsmCreateAccountRespDto"},"messages":{"type":"array","items":{"$ref":"#/components/schemas/ResponseMessage"}},"success":{"type":"boolean"},"timestamp":{"type":"string","format":"date-time"},"traceId":{"type":"string"}}},"HsmCreateAccountRespDto":{"type":"object","description":"Response for HSM key pair creation","properties":{"publicKeyHex":{"type":"string","description":"Raw Ed25519 public key as hex string (64 hex chars = 32 bytes)"},"zetrixAddress":{"type":"string","description":"Zetrix blockchain address derived from the public key (e.g. ZTX3...). Use this as the identifier in subsequent sign requests."}}},"ResponseMessage":{"type":"object","description":"A response message indicating informational, warning, or error details.","properties":{"type":{"type":"string","description":"Severity: `INFO`, `WARNING`, or `ERROR`.","enum":["INFO","ERROR","WARNING"]},"errorCode":{"type":"integer","format":"int32","description":"Numeric error code (0 = no error)."},"message":{"type":"string","description":"Human-readable description."}}}}}}
```

## The SignerEntity object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"SignerEntity":{"type":"object","description":"A signer object containing a signature and public key pair. Used in transaction/contract submission requests.","properties":{"signBlob":{"type":"string","description":"Hex-encoded Ed25519 signature of the transaction blob."},"publicKey":{"type":"string","description":"Hex-encoded Ed25519 public key of the signer. Must be exactly 76 characters.","minLength":76,"maxLength":76}}}}}}
```

## The SubmitTxReqDto object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"SubmitTxReqDto":{"type":"object","description":"Request body for submitting a signed transaction.","required":["blob","listSigner"],"properties":{"blob":{"type":"string","description":"Hex-encoded transaction blob from `/tx/generate-blob`. Must not be modified."},"listSigner":{"type":"array","description":"List of signers. At least one entry required.","minItems":1,"items":{"$ref":"#/components/schemas/SignerEntity"}}}},"SignerEntity":{"type":"object","description":"A signer object containing a signature and public key pair. Used in transaction/contract submission requests.","properties":{"signBlob":{"type":"string","description":"Hex-encoded Ed25519 signature of the transaction blob."},"publicKey":{"type":"string","description":"Hex-encoded Ed25519 public key of the signer. Must be exactly 76 characters.","minLength":76,"maxLength":76}}}}}}
```

## The BlobDataReqDto object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"BlobDataReqDto":{"type":"object","description":"Request body for server-side blob signing.","properties":{"blob":{"type":"string","description":"Hex-encoded transaction blob to sign."},"hash":{"type":"string","description":"64-character transaction hash associated with the blob.","minLength":64,"maxLength":64},"privateKeys":{"type":"array","description":"List of Ed25519 private keys (each exactly 56 characters). One `SignerEntity` is returned per key.","minItems":1,"items":{"type":"string","minLength":56,"maxLength":56}}}}}}}
```

## The PaymasterSubmitReqDto object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"PaymasterSubmitReqDto":{"type":"object","description":"Request body for submitting a paymaster-sponsored transaction or contract invocation.","required":["blob","blobId","listSigner"],"properties":{"blobId":{"type":"string","description":"Unique ID of the paymaster blob reservation from generate-blob."},"blob":{"type":"string","description":"The hex-encoded transaction blob returned during blob generation."},"listSigner":{"type":"array","description":"User's signature(s) on the blob.","items":{"$ref":"#/components/schemas/SignerEntity"}}}},"SignerEntity":{"type":"object","description":"A signer object containing a signature and public key pair. Used in transaction/contract submission requests.","properties":{"signBlob":{"type":"string","description":"Hex-encoded Ed25519 signature of the transaction blob."},"publicKey":{"type":"string","description":"Hex-encoded Ed25519 public key of the signer. Must be exactly 76 characters.","minLength":76,"maxLength":76}}}}}}
```

## The PaymasterSubmitRespDto object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"PaymasterSubmitRespDto":{"type":"object","description":"Response after queuing a paymaster-sponsored transaction.","properties":{"txHash":{"type":"string","description":"Transaction hash. Poll `/tx/query` with this for final status."},"blobId":{"type":"string","description":"Paymaster blob reservation ID."},"nonce":{"type":"integer","format":"int64","description":"Nonce used from the paymaster pool."},"paymasterAddress":{"type":"string","description":"Paymaster address sponsoring the gas fee."},"status":{"type":"string","description":"Processing status. Initially `QUEUED`; becomes `SUCCESS` or `FAILED` after processing."},"submittedAt":{"type":"string","format":"date-time","description":"Timestamp when queued."},"blockNumber":{"type":"integer","format":"int64","description":"Block number confirmed in (populated post-confirmation)."},"gasUsed":{"type":"integer","format":"int64","description":"Actual gas units consumed."},"gasFeePaid":{"type":"integer","format":"int64","description":"Total gas fee paid by paymaster in drops."}}}}}}
```

## The OperationsEntity object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"OperationsEntity":{"type":"object","description":"A single operation to execute in a transaction. The fields used depend on the operation `type`.","properties":{"type":{"type":"string","description":"Operation type as a numeric string. `1` = Create Account, `2` = Built-in points transfer, `3` = Call contract, `4` = Create contract, `5` = Set up account metadata, `6` = Set account privilege, `7` = Upgrade contract content, `8` = Upgrade contract owner.","enum":["1","2","3","4","5","6","7","8"]},"toAddress":{"type":"string","description":"Destination Zetrix address for transfer-type operations."},"fromAddress":{"type":"string","description":"Source address override (defaults to `txInitiator` if omitted)."},"amount":{"type":"string","description":"Amount in drops (1 ZETRIX = 10^6 drops)."},"inputStr":{"type":"string","description":"JSON-encoded input for contract invocation operations."},"payload":{"type":"string","description":"Contract payload or bytecode (used in contract deployment)."},"precision":{"type":"string","description":"Asset precision (used in asset issuance)."},"metadata":{"type":"string","description":"Optional arbitrary metadata string attached to the operation."}}}}}}
```

## The PaymasterGenerateBlobReqDto object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"PaymasterGenerateBlobReqDto":{"type":"object","description":"Request to generate a paymaster-sponsored transaction blob (gas-free for users).","required":["operations","userAddress"],"properties":{"userAddress":{"type":"string","description":"Zetrix address of the user initiating the transaction. Gas covered by the Paymaster."},"operations":{"type":"array","description":"List of operations to execute.","items":{"$ref":"#/components/schemas/OperationsEntity"}},"chainCode":{"type":"string","description":"Chain code identifier. Defaults to `\"0\"`.","default":"0"},"paymasterPoolId":{"type":"integer","format":"int64","description":"Specific paymaster pool ID. Auto-selected if not provided."},"operationType":{"type":"string","description":"Operation type label for tracking."},"targetAddress":{"type":"string","description":"Target address for tracking purposes."},"amount":{"type":"string","description":"Transaction amount for tracking (optional)."},"metadata":{"type":"object","additionalProperties":{},"description":"Additional metadata for tracking."},"timeoutMinutes":{"type":"integer","format":"int32","description":"Minutes the nonce reservation is valid. Defaults to 10.","default":10},"minPoolBalance":{"type":"integer","format":"int64","description":"Minimum required pool balance in drops (optional)."},"poolType":{"type":"string","description":"Preferred paymaster pool type.","enum":["NORMAL","PREMIUM","CORPORATE"]}}},"OperationsEntity":{"type":"object","description":"A single operation to execute in a transaction. The fields used depend on the operation `type`.","properties":{"type":{"type":"string","description":"Operation type as a numeric string. `1` = Create Account, `2` = Built-in points transfer, `3` = Call contract, `4` = Create contract, `5` = Set up account metadata, `6` = Set account privilege, `7` = Upgrade contract content, `8` = Upgrade contract owner.","enum":["1","2","3","4","5","6","7","8"]},"toAddress":{"type":"string","description":"Destination Zetrix address for transfer-type operations."},"fromAddress":{"type":"string","description":"Source address override (defaults to `txInitiator` if omitted)."},"amount":{"type":"string","description":"Amount in drops (1 ZETRIX = 10^6 drops)."},"inputStr":{"type":"string","description":"JSON-encoded input for contract invocation operations."},"payload":{"type":"string","description":"Contract payload or bytecode (used in contract deployment)."},"precision":{"type":"string","description":"Asset precision (used in asset issuance)."},"metadata":{"type":"string","description":"Optional arbitrary metadata string attached to the operation."}}}}}}
```

## The PaymasterGenerateBlobRespDto object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"PaymasterGenerateBlobRespDto":{"type":"object","description":"Response for paymaster transaction blob generation.","required":["blob","blobId","expiresAt","hash","paymasterAddress","paymasterNonce","paymasterPoolId","timeoutMinutes"],"properties":{"blob":{"type":"string","description":"Hex-encoded transaction blob. Sign and submit via `/tx/paymaster/submit`."},"hash":{"type":"string","description":"Transaction hash. Required when calling `/tx/sign-blob`."},"blobId":{"type":"string","description":"Unique ID for this paymaster reservation. Required in `/tx/paymaster/submit`."},"paymasterAddress":{"type":"string","description":"Paymaster address that will sponsor the gas fee."},"paymasterNonce":{"type":"integer","format":"int64","description":"Nonce allocated from the paymaster pool."},"paymasterPoolId":{"type":"integer","format":"int64","description":"ID of the paymaster pool used."},"actualFee":{"type":"integer","format":"int64","description":"Estimated fee in gas units (1 ZETRIX = 10^6 units)."},"expiresAt":{"type":"string","format":"date-time","description":"Nonce reservation expiry. Submit before this time."},"timeoutMinutes":{"type":"integer","format":"int32","description":"Duration in minutes the reservation is valid."},"platformSignData":{"$ref":"#/components/schemas/PlatformSignDataEntity"}}},"PlatformSignDataEntity":{"type":"object","description":"Optional platform co-signature data, present when the platform pre-signs the blob.","properties":{"publicKey":{"type":"string","description":"Platform's public key."},"signBlob":{"type":"string","description":"Platform's signature of the blob."}}}}}}
```

## The PlatformSignDataEntity object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"PlatformSignDataEntity":{"type":"object","description":"Optional platform co-signature data, present when the platform pre-signs the blob.","properties":{"publicKey":{"type":"string","description":"Platform's public key."},"signBlob":{"type":"string","description":"Platform's signature of the blob."}}}}}}
```

## The GenerateBlobReqDto object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"GenerateBlobReqDto":{"type":"object","description":"Request to generate a transaction blob where the user pays gas fees.","required":["operations","txInitiator"],"properties":{"txInitiator":{"type":"string","description":"Zetrix address of the account initiating and paying gas for the transaction."},"operations":{"type":"array","description":"List of operations to execute.","items":{"$ref":"#/components/schemas/OperationsEntity"}},"chainCode":{"type":"string","description":"Chain code identifier. Defaults to `\"0\"`.","default":"0"}}},"OperationsEntity":{"type":"object","description":"A single operation to execute in a transaction. The fields used depend on the operation `type`.","properties":{"type":{"type":"string","description":"Operation type as a numeric string. `1` = Create Account, `2` = Built-in points transfer, `3` = Call contract, `4` = Create contract, `5` = Set up account metadata, `6` = Set account privilege, `7` = Upgrade contract content, `8` = Upgrade contract owner.","enum":["1","2","3","4","5","6","7","8"]},"toAddress":{"type":"string","description":"Destination Zetrix address for transfer-type operations."},"fromAddress":{"type":"string","description":"Source address override (defaults to `txInitiator` if omitted)."},"amount":{"type":"string","description":"Amount in drops (1 ZETRIX = 10^6 drops)."},"inputStr":{"type":"string","description":"JSON-encoded input for contract invocation operations."},"payload":{"type":"string","description":"Contract payload or bytecode (used in contract deployment)."},"precision":{"type":"string","description":"Asset precision (used in asset issuance)."},"metadata":{"type":"string","description":"Optional arbitrary metadata string attached to the operation."}}}}}}
```

## The GenerateBlobRespDto object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"GenerateBlobRespDto":{"type":"object","description":"Response for transaction blob generation.","required":["blob","hash"],"properties":{"blob":{"type":"string","description":"Hex-encoded serialized transaction blob. Sign before submitting."},"hash":{"type":"string","description":"SHA-256 transaction hash. Required when calling `/tx/sign-blob`."},"actualFee":{"type":"integer","format":"int64","description":"Estimated transaction fee in gas units."},"platformSignData":{"$ref":"#/components/schemas/PlatformSignDataEntity"}}},"PlatformSignDataEntity":{"type":"object","description":"Optional platform co-signature data, present when the platform pre-signs the blob.","properties":{"publicKey":{"type":"string","description":"Platform's public key."},"signBlob":{"type":"string","description":"Platform's signature of the blob."}}}}}}
```

## The ParseBlobReqDto object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"ParseBlobReqDto":{"type":"object","description":"Request to parse a transaction blob.","required":["blob"],"properties":{"blob":{"type":"string","description":"Hex-encoded transaction blob to decode."}}}}}}
```

## The ContractInvokeGenerateBlobReqDto object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"ContractInvokeGenerateBlobReqDto":{"type":"object","description":"Request to generate a blob for a smart contract invocation.","required":["method"],"properties":{"contractKey":{"type":"string","description":"Registered contract alias. Either this or `contractAddress` must be provided."},"contractAddress":{"type":"string","description":"On-chain contract address. Takes precedence over `contractKey` if both are given."},"method":{"type":"string","description":"Contract method to invoke."},"inputParameters":{"type":"object","additionalProperties":{},"description":"Method input parameters. Structure depends on the contract's ABI."},"txInitiator":{"type":"string","description":"Address of the transaction initiator (pays gas).","minLength":37,"maxLength":37},"sourceAddress":{"type":"string","description":"Optional source address override."},"value":{"type":"integer","format":"int64","description":"ZTX value in drops to send with the invocation. Use `0` for non-payable methods."}}}}}}
```

## The ContractInvokeSignBlobReqDto object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"ContractInvokeSignBlobReqDto":{"type":"object","description":"Request to sign a contract invocation blob using a single private key.","properties":{"blob":{"type":"string","description":"Hex-encoded contract invocation blob to sign."},"privateKey":{"type":"string","description":"56-character Ed25519 private key of the transaction initiator.","minLength":56,"maxLength":56}}}}}}
```

## The ContractInvokeSubmitReqDto object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"ContractInvokeSubmitReqDto":{"type":"object","description":"Request to submit a signed contract invocation blob to the blockchain.","properties":{"blob":{"type":"string","description":"Hex-encoded signed blob from `/contract/generate-blob`."},"hash":{"type":"string","description":"64-character transaction hash from the generate step.","minLength":64,"maxLength":64},"initiator":{"type":"string","description":"37-character Zetrix address of the transaction initiator.","minLength":37,"maxLength":37},"listSigner":{"type":"array","description":"Signers with their signatures and public keys.","items":{"$ref":"#/components/schemas/SignerEntity"}}}},"SignerEntity":{"type":"object","description":"A signer object containing a signature and public key pair. Used in transaction/contract submission requests.","properties":{"signBlob":{"type":"string","description":"Hex-encoded Ed25519 signature of the transaction blob."},"publicKey":{"type":"string","description":"Hex-encoded Ed25519 public key of the signer. Must be exactly 76 characters.","minLength":76,"maxLength":76}}}}}}
```

## The ContractQueryReqDto object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"ContractQueryReqDto":{"type":"object","description":"Request for a read-only smart contract query.","properties":{"contractKey":{"type":"string","description":"Registered contract alias in the Zetrix platform."},"method":{"type":"string","description":"Read-only contract method to call."},"inputParameters":{"type":"object","additionalProperties":{},"description":"Input parameters for the method. Structure depends on the contract's ABI."}}}}}}
```

## The ContractPaymasterGenerateBlobReqDto object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"ContractPaymasterGenerateBlobReqDto":{"type":"object","description":"Request to generate a paymaster-sponsored contract invocation blob.","required":["method","userAddress"],"properties":{"contractKey":{"type":"string","description":"Registered contract alias. Either this or `contractAddress` must be provided."},"contractAddress":{"type":"string","description":"On-chain contract address. Takes precedence over `contractKey` if both are given."},"method":{"type":"string","description":"Contract method to invoke."},"inputParameters":{"type":"object","additionalProperties":{},"description":"Method input parameters as key-value map."},"userAddress":{"type":"string","description":"User's Zetrix address (initiator). Gas covered by the Paymaster.","minLength":37,"maxLength":37},"value":{"type":"integer","format":"int64","description":"ZTX value in drops. Use `0` for non-payable methods."},"chainCode":{"type":"string","description":"Chain code identifier. Defaults to `\"0\"`.","default":"0"},"paymasterPoolId":{"type":"integer","format":"int64","description":"Specific paymaster pool ID. Auto-selected if not provided."},"timeoutMinutes":{"type":"integer","format":"int32","description":"Nonce reservation timeout in minutes. Defaults to 10.","default":10},"minPoolBalance":{"type":"integer","format":"int64","description":"Minimum required paymaster pool balance in drops."},"poolType":{"type":"string","description":"Preferred paymaster pool type.","enum":["NORMAL","PREMIUM","CORPORATE"]},"metadata":{"type":"object","additionalProperties":{},"description":"Additional metadata for tracking."}}}}}}
```

## The ContractPaymasterGenerateBlobRespDto object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"ContractPaymasterGenerateBlobRespDto":{"type":"object","description":"Response for paymaster-sponsored contract invocation blob generation.","required":["blob","blobId","expiresAt","hash","paymasterAddress","paymasterNonce","paymasterPoolId","timeoutMinutes"],"properties":{"blob":{"type":"string","description":"Hex-encoded blob. Sign and submit via `/contract/paymaster/submit`."},"hash":{"type":"string","description":"Transaction hash."},"blobId":{"type":"string","description":"Paymaster reservation ID. Required in `/contract/paymaster/submit`."},"paymasterAddress":{"type":"string","description":"Paymaster address sponsoring gas."},"paymasterNonce":{"type":"integer","format":"int64","description":"Reserved nonce."},"paymasterPoolId":{"type":"integer","format":"int64","description":"Paymaster pool ID."},"contractAddress":{"type":"string","description":"Resolved on-chain contract address."},"method":{"type":"string","description":"Contract method being invoked."},"actualFee":{"type":"integer","format":"int64","description":"Estimated fee in gas units."},"expiresAt":{"type":"string","format":"date-time","description":"Nonce reservation expiry. Submit before this time."},"timeoutMinutes":{"type":"integer","format":"int32","description":"Timeout duration in minutes."},"platformSignData":{"$ref":"#/components/schemas/PlatformSignDataEntity"}}},"PlatformSignDataEntity":{"type":"object","description":"Optional platform co-signature data, present when the platform pre-signs the blob.","properties":{"publicKey":{"type":"string","description":"Platform's public key."},"signBlob":{"type":"string","description":"Platform's signature of the blob."}}}}}}
```

## The ResponseMessage object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"ResponseMessage":{"type":"object","description":"A response message indicating informational, warning, or error details.","properties":{"type":{"type":"string","description":"Severity: `INFO`, `WARNING`, or `ERROR`.","enum":["INFO","ERROR","WARNING"]},"errorCode":{"type":"integer","format":"int32","description":"Numeric error code (0 = no error)."},"message":{"type":"string","description":"Human-readable description."}}}}}}
```

## The TxSubmitRespDto object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"TxSubmitRespDto":{"type":"object","properties":{"hash":{"type":"string","description":"Transaction hash confirming successful broadcast."}}}}}}
```

## The ContractSubmitRespDto object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"ContractSubmitRespDto":{"type":"object","properties":{"hash":{"type":"string","description":"Transaction hash confirming contract invocation was broadcast."}}}}}}
```

## The ContractGenerateBlobRespDto object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"ContractGenerateBlobRespDto":{"type":"object","description":"Response for contract invocation blob generation.","properties":{"blob":{"type":"string","description":"Hex-encoded contract invocation blob."},"hash":{"type":"string","description":"Transaction hash."},"actualFee":{"type":"integer","format":"int64","description":"Estimated fee in gas units."},"platformSignData":{"$ref":"#/components/schemas/PlatformSignDataEntity"}}},"PlatformSignDataEntity":{"type":"object","description":"Optional platform co-signature data, present when the platform pre-signs the blob.","properties":{"publicKey":{"type":"string","description":"Platform's public key."},"signBlob":{"type":"string","description":"Platform's signature of the blob."}}}}}}
```

## The TxQueryRespDto object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"TxQueryRespDto":{"type":"object","description":"Transaction query result.","properties":{"txStatus":{"type":"string","description":"Numeric transaction lifecycle status code. See [Zetrix WebSocket Error Codes](https://docs.zetrix.com/en/developer-resources/api/websocket#error-codes)."},"txContent":{"$ref":"#/components/schemas/TransactionHistory"}}},"TransactionHistory":{"type":"object","description":"Full on-chain transaction record.","properties":{"hash":{"type":"string","description":"Transaction hash."},"ledgerSeq":{"type":"integer","format":"int64","description":"Block number the transaction was confirmed in."},"actualFee":{"type":"string","description":"Actual fee paid in drops."},"errorCode":{"type":"integer","format":"int32","description":"On-chain execution error code. See [Zetrix WebSocket Error Codes](https://docs.zetrix.com/en/developer-resources/api/websocket#error-codes)."},"errorDesc":{"type":"string","description":"Error description if the transaction failed."},"closeTime":{"type":"integer","format":"int64","description":"Block close timestamp in milliseconds."},"txSize":{"type":"integer","format":"int64","description":"Transaction size in bytes."},"transaction":{"$ref":"#/components/schemas/TransactionInfo"},"signatures":{"type":"array","items":{"$ref":"#/components/schemas/Signature"}},"contractTxHashes":{"type":"array","items":{"type":"string"},"description":"Internal hashes from contract execution."}}},"TransactionInfo":{"type":"object","properties":{"sourceAddress":{"type":"string"},"feeLimit":{"type":"integer","format":"int64"},"gasPrice":{"type":"integer","format":"int64"},"nonce":{"type":"integer","format":"int64"},"chainId":{"type":"integer","format":"int64"}}},"Signature":{"type":"object","properties":{"signData":{"type":"string"},"publicKey":{"type":"string"}}}}}}
```

## The TransactionHistory object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"TransactionHistory":{"type":"object","description":"Full on-chain transaction record.","properties":{"hash":{"type":"string","description":"Transaction hash."},"ledgerSeq":{"type":"integer","format":"int64","description":"Block number the transaction was confirmed in."},"actualFee":{"type":"string","description":"Actual fee paid in drops."},"errorCode":{"type":"integer","format":"int32","description":"On-chain execution error code. See [Zetrix WebSocket Error Codes](https://docs.zetrix.com/en/developer-resources/api/websocket#error-codes)."},"errorDesc":{"type":"string","description":"Error description if the transaction failed."},"closeTime":{"type":"integer","format":"int64","description":"Block close timestamp in milliseconds."},"txSize":{"type":"integer","format":"int64","description":"Transaction size in bytes."},"transaction":{"$ref":"#/components/schemas/TransactionInfo"},"signatures":{"type":"array","items":{"$ref":"#/components/schemas/Signature"}},"contractTxHashes":{"type":"array","items":{"type":"string"},"description":"Internal hashes from contract execution."}}},"TransactionInfo":{"type":"object","properties":{"sourceAddress":{"type":"string"},"feeLimit":{"type":"integer","format":"int64"},"gasPrice":{"type":"integer","format":"int64"},"nonce":{"type":"integer","format":"int64"},"chainId":{"type":"integer","format":"int64"}}},"Signature":{"type":"object","properties":{"signData":{"type":"string"},"publicKey":{"type":"string"}}}}}}
```

## The TransactionInfo object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"TransactionInfo":{"type":"object","properties":{"sourceAddress":{"type":"string"},"feeLimit":{"type":"integer","format":"int64"},"gasPrice":{"type":"integer","format":"int64"},"nonce":{"type":"integer","format":"int64"},"chainId":{"type":"integer","format":"int64"}}}}}}
```

## The Signature object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"Signature":{"type":"object","properties":{"signData":{"type":"string"},"publicKey":{"type":"string"}}}}}}
```

## The TransactionParseBlobResult object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"TransactionParseBlobResult":{"type":"object","description":"Decoded contents of a transaction blob.","properties":{"sourceAddress":{"type":"string","description":"Address that initiated the transaction."},"feeLimit":{"type":"integer","format":"int64","description":"Maximum gas fee allowed."},"gasPrice":{"type":"integer","format":"int64","description":"Gas price per unit."},"nonce":{"type":"integer","format":"int64","description":"Transaction sequence number."},"chainId":{"type":"integer","format":"int64","description":"Zetrix chain identifier."},"operations":{"type":"array","items":{"$ref":"#/components/schemas/OperationFormat"}}}},"OperationFormat":{"type":"object","description":"Decoded operation from a parsed blob.","properties":{"type":{"type":"string"},"sourceAddress":{"type":"string"},"metadata":{"type":"string"},"sendGas":{"$ref":"#/components/schemas/GasSendInfo"},"sendAsset":{"$ref":"#/components/schemas/AssetSendInfo"},"setMetadata":{"$ref":"#/components/schemas/AccountSetMetadataInfo"},"log":{"$ref":"#/components/schemas/LogInfo"}}},"GasSendInfo":{"type":"object","properties":{"destAddress":{"type":"string"},"amount":{"type":"integer","format":"int64"},"input":{"type":"string"}}},"AssetSendInfo":{"type":"object","properties":{"destAddress":{"type":"string"},"input":{"type":"string"}}},"AccountSetMetadataInfo":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"},"version":{"type":"integer","format":"int64"},"deleteFlag":{"type":"boolean"}}},"LogInfo":{"type":"object","properties":{"topic":{"type":"string"},"datas":{"type":"array","items":{"type":"string"}}}}}}}
```

## The OperationFormat object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"OperationFormat":{"type":"object","description":"Decoded operation from a parsed blob.","properties":{"type":{"type":"string"},"sourceAddress":{"type":"string"},"metadata":{"type":"string"},"sendGas":{"$ref":"#/components/schemas/GasSendInfo"},"sendAsset":{"$ref":"#/components/schemas/AssetSendInfo"},"setMetadata":{"$ref":"#/components/schemas/AccountSetMetadataInfo"},"log":{"$ref":"#/components/schemas/LogInfo"}}},"GasSendInfo":{"type":"object","properties":{"destAddress":{"type":"string"},"amount":{"type":"integer","format":"int64"},"input":{"type":"string"}}},"AssetSendInfo":{"type":"object","properties":{"destAddress":{"type":"string"},"input":{"type":"string"}}},"AccountSetMetadataInfo":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"},"version":{"type":"integer","format":"int64"},"deleteFlag":{"type":"boolean"}}},"LogInfo":{"type":"object","properties":{"topic":{"type":"string"},"datas":{"type":"array","items":{"type":"string"}}}}}}}
```

## The GasSendInfo object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"GasSendInfo":{"type":"object","properties":{"destAddress":{"type":"string"},"amount":{"type":"integer","format":"int64"},"input":{"type":"string"}}}}}}
```

## The AssetSendInfo object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"AssetSendInfo":{"type":"object","properties":{"destAddress":{"type":"string"},"input":{"type":"string"}}}}}}
```

## The AccountSetMetadataInfo object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"AccountSetMetadataInfo":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"},"version":{"type":"integer","format":"int64"},"deleteFlag":{"type":"boolean"}}}}}}
```

## The LogInfo object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"LogInfo":{"type":"object","properties":{"topic":{"type":"string"},"datas":{"type":"array","items":{"type":"string"}}}}}}}
```

## The ContractUsageHistoryRespDto object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"ContractUsageHistoryRespDto":{"type":"object","description":"A single contract invocation history record.","properties":{"id":{"type":"integer","format":"int64","description":"Internal record ID."},"address":{"type":"string","description":"Contract on-chain address."},"contractKey":{"type":"string","description":"Contract alias key."},"txInitiator":{"type":"string","description":"Address that initiated the transaction."},"method":{"type":"string","description":"Contract method called."},"inputParameters":{"type":"string","description":"JSON-serialized input parameters."},"txHash":{"type":"string","description":"Transaction hash."},"status":{"type":"string","enum":["INITIATED","SUBMITTED"],"description":"Invocation status."},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}}}}}
```

## The ResponsePaginatedContractUsageHistoryRespDto object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"ResponsePaginatedContractUsageHistoryRespDto":{"type":"object","properties":{"page":{"type":"integer","format":"int64"},"pageSize":{"type":"integer","format":"int64"},"totalPages":{"type":"integer","format":"int32"},"totalElements":{"type":"integer","format":"int64"},"content":{"type":"array","items":{"$ref":"#/components/schemas/ContractUsageHistoryRespDto"}}}},"ContractUsageHistoryRespDto":{"type":"object","description":"A single contract invocation history record.","properties":{"id":{"type":"integer","format":"int64","description":"Internal record ID."},"address":{"type":"string","description":"Contract on-chain address."},"contractKey":{"type":"string","description":"Contract alias key."},"txInitiator":{"type":"string","description":"Address that initiated the transaction."},"method":{"type":"string","description":"Contract method called."},"inputParameters":{"type":"string","description":"JSON-serialized input parameters."},"txHash":{"type":"string","description":"Transaction hash."},"status":{"type":"string","enum":["INITIATED","SUBMITTED"],"description":"Invocation status."},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}}}}}
```

## The DSMonitoringBlockchain object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"DSMonitoringBlockchain":{"type":"object","description":"Comprehensive blockchain network statistics.","properties":{"chainId":{"type":"integer","format":"int64"},"chainName":{"type":"string"},"blockchainHeight":{"type":"integer","format":"int64"},"transactionNum":{"type":"integer","format":"int64"},"accountNum":{"type":"integer","format":"int64"},"txTpsMax":{"type":"integer","format":"int32"},"currentTps":{"type":"integer","format":"int32"},"txNumLastDay":{"type":"integer","format":"int64"},"blockAverageGeneTime":{"type":"integer","format":"int32"},"netStatus":{"type":"string"},"lastLedgerList":{"type":"array","items":{"$ref":"#/components/schemas/DSMonitoringLedger"}},"lastTxList":{"type":"array","items":{"$ref":"#/components/schemas/DSMonitoringTx"}}}},"DSMonitoringLedger":{"type":"object","properties":{"seq":{"type":"integer","format":"int64","description":"Block sequence number."},"txNum":{"type":"integer","format":"int64","description":"Transactions in this block."},"ledgerAge":{"type":"integer","format":"int64","description":"Age in milliseconds."}}},"DSMonitoringTx":{"type":"object","properties":{"senderAddress":{"type":"string"},"txHash":{"type":"string"},"txTime":{"type":"integer","format":"int64"}}}}}}
```

## The DSMonitoringLedger object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"DSMonitoringLedger":{"type":"object","properties":{"seq":{"type":"integer","format":"int64","description":"Block sequence number."},"txNum":{"type":"integer","format":"int64","description":"Transactions in this block."},"ledgerAge":{"type":"integer","format":"int64","description":"Age in milliseconds."}}}}}}
```

## The DSMonitoringTx object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"DSMonitoringTx":{"type":"object","properties":{"senderAddress":{"type":"string"},"txHash":{"type":"string"},"txTime":{"type":"integer","format":"int64"}}}}}}
```

## The DSMonitoringNodeStatWrapper object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"DSMonitoringNodeStatWrapper":{"type":"object","properties":{"total":{"type":"integer","format":"int32","description":"Total nodes across all types."},"validatorNodeStat":{"$ref":"#/components/schemas/DSMonitoringNodeStat"},"synchronousNodeStat":{"$ref":"#/components/schemas/DSMonitoringNodeStat"}}},"DSMonitoringNodeStat":{"type":"object","properties":{"total":{"type":"integer","format":"int32"},"onlineCount":{"type":"integer","format":"int32"},"offlineCount":{"type":"integer","format":"int32"},"warnCount":{"type":"integer","format":"int32"}}}}}}
```

## The DSMonitoringNodeStat object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"DSMonitoringNodeStat":{"type":"object","properties":{"total":{"type":"integer","format":"int32"},"onlineCount":{"type":"integer","format":"int32"},"offlineCount":{"type":"integer","format":"int32"},"warnCount":{"type":"integer","format":"int32"}}}}}}
```

## The DSMonitoringPagination object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"DSMonitoringPagination":{"type":"object","properties":{"pageNum":{"type":"integer","format":"int32"},"pageSize":{"type":"integer","format":"int32"},"total":{"type":"integer","format":"int32"},"content":{"type":"array","items":{"$ref":"#/components/schemas/DSMonitoringNodeList"}}}},"DSMonitoringNodeList":{"type":"object","description":"Details of an individual blockchain node.","properties":{"nodeName":{"type":"string","description":"Human-readable node name."},"nodeAddress":{"type":"string","description":"Zetrix address of the node."},"consensusAddress":{"type":"string"},"nodeType":{"type":"string","description":"`VALIDATOR` or `SYNCHRONOUS`."},"nodeStatus":{"type":"string","description":"`ONLINE`, `OFFLINE`, or `WARN`."},"operatingSystem":{"type":"string"},"blockSeq":{"type":"string","description":"Latest synced block number."},"blockHash":{"type":"string"},"expirationTime":{"type":"string"},"certEndTime":{"type":"string"},"licenseEndTime":{"type":"string"}}}}}}
```

## The DSMonitoringNodeList object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"DSMonitoringNodeList":{"type":"object","description":"Details of an individual blockchain node.","properties":{"nodeName":{"type":"string","description":"Human-readable node name."},"nodeAddress":{"type":"string","description":"Zetrix address of the node."},"consensusAddress":{"type":"string"},"nodeType":{"type":"string","description":"`VALIDATOR` or `SYNCHRONOUS`."},"nodeStatus":{"type":"string","description":"`ONLINE`, `OFFLINE`, or `WARN`."},"operatingSystem":{"type":"string"},"blockSeq":{"type":"string","description":"Latest synced block number."},"blockHash":{"type":"string"},"expirationTime":{"type":"string"},"certEndTime":{"type":"string"},"licenseEndTime":{"type":"string"}}}}}}
```

## The DSMonitoringNode object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"DSMonitoringNode":{"type":"object","description":"Node count for a geographic region.","properties":{"geographyCode":{"type":"integer","format":"int32","description":"Numeric ISO country/region code."},"total":{"type":"integer","format":"int32","description":"Number of nodes in this region."}}}}}}
```

## The MultiValueMapStringString object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"MultiValueMapStringString":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}},"description":"Multi-value map for flexible filter parameters."}}}}
```

## The ResponseWrapperTxSubmitRespDto object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"ResponseWrapperTxSubmitRespDto":{"type":"object","properties":{"object":{"$ref":"#/components/schemas/TxSubmitRespDto"},"messages":{"type":"array","items":{"$ref":"#/components/schemas/ResponseMessage"}},"success":{"type":"boolean"},"timestamp":{"type":"string","format":"date-time"},"traceId":{"type":"string"}}},"TxSubmitRespDto":{"type":"object","properties":{"hash":{"type":"string","description":"Transaction hash confirming successful broadcast."}}},"ResponseMessage":{"type":"object","description":"A response message indicating informational, warning, or error details.","properties":{"type":{"type":"string","description":"Severity: `INFO`, `WARNING`, or `ERROR`.","enum":["INFO","ERROR","WARNING"]},"errorCode":{"type":"integer","format":"int32","description":"Numeric error code (0 = no error)."},"message":{"type":"string","description":"Human-readable description."}}}}}}
```

## The ResponseWrapperListSignerEntity object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"ResponseWrapperListSignerEntity":{"type":"object","properties":{"object":{"type":"array","items":{"$ref":"#/components/schemas/SignerEntity"}},"messages":{"type":"array","items":{"$ref":"#/components/schemas/ResponseMessage"}},"success":{"type":"boolean"},"timestamp":{"type":"string","format":"date-time"},"traceId":{"type":"string"}}},"SignerEntity":{"type":"object","description":"A signer object containing a signature and public key pair. Used in transaction/contract submission requests.","properties":{"signBlob":{"type":"string","description":"Hex-encoded Ed25519 signature of the transaction blob."},"publicKey":{"type":"string","description":"Hex-encoded Ed25519 public key of the signer. Must be exactly 76 characters.","minLength":76,"maxLength":76}}},"ResponseMessage":{"type":"object","description":"A response message indicating informational, warning, or error details.","properties":{"type":{"type":"string","description":"Severity: `INFO`, `WARNING`, or `ERROR`.","enum":["INFO","ERROR","WARNING"]},"errorCode":{"type":"integer","format":"int32","description":"Numeric error code (0 = no error)."},"message":{"type":"string","description":"Human-readable description."}}}}}}
```

## The ResponseWrapperPaymasterSubmitRespDto object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"ResponseWrapperPaymasterSubmitRespDto":{"type":"object","properties":{"object":{"$ref":"#/components/schemas/PaymasterSubmitRespDto"},"messages":{"type":"array","items":{"$ref":"#/components/schemas/ResponseMessage"}},"success":{"type":"boolean"},"timestamp":{"type":"string","format":"date-time"},"traceId":{"type":"string"}}},"PaymasterSubmitRespDto":{"type":"object","description":"Response after queuing a paymaster-sponsored transaction.","properties":{"txHash":{"type":"string","description":"Transaction hash. Poll `/tx/query` with this for final status."},"blobId":{"type":"string","description":"Paymaster blob reservation ID."},"nonce":{"type":"integer","format":"int64","description":"Nonce used from the paymaster pool."},"paymasterAddress":{"type":"string","description":"Paymaster address sponsoring the gas fee."},"status":{"type":"string","description":"Processing status. Initially `QUEUED`; becomes `SUCCESS` or `FAILED` after processing."},"submittedAt":{"type":"string","format":"date-time","description":"Timestamp when queued."},"blockNumber":{"type":"integer","format":"int64","description":"Block number confirmed in (populated post-confirmation)."},"gasUsed":{"type":"integer","format":"int64","description":"Actual gas units consumed."},"gasFeePaid":{"type":"integer","format":"int64","description":"Total gas fee paid by paymaster in drops."}}},"ResponseMessage":{"type":"object","description":"A response message indicating informational, warning, or error details.","properties":{"type":{"type":"string","description":"Severity: `INFO`, `WARNING`, or `ERROR`.","enum":["INFO","ERROR","WARNING"]},"errorCode":{"type":"integer","format":"int32","description":"Numeric error code (0 = no error)."},"message":{"type":"string","description":"Human-readable description."}}}}}}
```

## The ResponseWrapperPaymasterGenerateBlobRespDto object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"ResponseWrapperPaymasterGenerateBlobRespDto":{"type":"object","properties":{"object":{"$ref":"#/components/schemas/PaymasterGenerateBlobRespDto"},"messages":{"type":"array","items":{"$ref":"#/components/schemas/ResponseMessage"}},"success":{"type":"boolean"},"timestamp":{"type":"string","format":"date-time"},"traceId":{"type":"string"}}},"PaymasterGenerateBlobRespDto":{"type":"object","description":"Response for paymaster transaction blob generation.","required":["blob","blobId","expiresAt","hash","paymasterAddress","paymasterNonce","paymasterPoolId","timeoutMinutes"],"properties":{"blob":{"type":"string","description":"Hex-encoded transaction blob. Sign and submit via `/tx/paymaster/submit`."},"hash":{"type":"string","description":"Transaction hash. Required when calling `/tx/sign-blob`."},"blobId":{"type":"string","description":"Unique ID for this paymaster reservation. Required in `/tx/paymaster/submit`."},"paymasterAddress":{"type":"string","description":"Paymaster address that will sponsor the gas fee."},"paymasterNonce":{"type":"integer","format":"int64","description":"Nonce allocated from the paymaster pool."},"paymasterPoolId":{"type":"integer","format":"int64","description":"ID of the paymaster pool used."},"actualFee":{"type":"integer","format":"int64","description":"Estimated fee in gas units (1 ZETRIX = 10^6 units)."},"expiresAt":{"type":"string","format":"date-time","description":"Nonce reservation expiry. Submit before this time."},"timeoutMinutes":{"type":"integer","format":"int32","description":"Duration in minutes the reservation is valid."},"platformSignData":{"$ref":"#/components/schemas/PlatformSignDataEntity"}}},"PlatformSignDataEntity":{"type":"object","description":"Optional platform co-signature data, present when the platform pre-signs the blob.","properties":{"publicKey":{"type":"string","description":"Platform's public key."},"signBlob":{"type":"string","description":"Platform's signature of the blob."}}},"ResponseMessage":{"type":"object","description":"A response message indicating informational, warning, or error details.","properties":{"type":{"type":"string","description":"Severity: `INFO`, `WARNING`, or `ERROR`.","enum":["INFO","ERROR","WARNING"]},"errorCode":{"type":"integer","format":"int32","description":"Numeric error code (0 = no error)."},"message":{"type":"string","description":"Human-readable description."}}}}}}
```

## The ResponseWrapperGenerateBlobRespDto object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"ResponseWrapperGenerateBlobRespDto":{"type":"object","properties":{"object":{"$ref":"#/components/schemas/GenerateBlobRespDto"},"messages":{"type":"array","items":{"$ref":"#/components/schemas/ResponseMessage"}},"success":{"type":"boolean"},"timestamp":{"type":"string","format":"date-time"},"traceId":{"type":"string"}}},"GenerateBlobRespDto":{"type":"object","description":"Response for transaction blob generation.","required":["blob","hash"],"properties":{"blob":{"type":"string","description":"Hex-encoded serialized transaction blob. Sign before submitting."},"hash":{"type":"string","description":"SHA-256 transaction hash. Required when calling `/tx/sign-blob`."},"actualFee":{"type":"integer","format":"int64","description":"Estimated transaction fee in gas units."},"platformSignData":{"$ref":"#/components/schemas/PlatformSignDataEntity"}}},"PlatformSignDataEntity":{"type":"object","description":"Optional platform co-signature data, present when the platform pre-signs the blob.","properties":{"publicKey":{"type":"string","description":"Platform's public key."},"signBlob":{"type":"string","description":"Platform's signature of the blob."}}},"ResponseMessage":{"type":"object","description":"A response message indicating informational, warning, or error details.","properties":{"type":{"type":"string","description":"Severity: `INFO`, `WARNING`, or `ERROR`.","enum":["INFO","ERROR","WARNING"]},"errorCode":{"type":"integer","format":"int32","description":"Numeric error code (0 = no error)."},"message":{"type":"string","description":"Human-readable description."}}}}}}
```

## The ResponseWrapperTransactionParseBlobResult object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"ResponseWrapperTransactionParseBlobResult":{"type":"object","properties":{"object":{"$ref":"#/components/schemas/TransactionParseBlobResult"},"messages":{"type":"array","items":{"$ref":"#/components/schemas/ResponseMessage"}},"success":{"type":"boolean"},"timestamp":{"type":"string","format":"date-time"},"traceId":{"type":"string"}}},"TransactionParseBlobResult":{"type":"object","description":"Decoded contents of a transaction blob.","properties":{"sourceAddress":{"type":"string","description":"Address that initiated the transaction."},"feeLimit":{"type":"integer","format":"int64","description":"Maximum gas fee allowed."},"gasPrice":{"type":"integer","format":"int64","description":"Gas price per unit."},"nonce":{"type":"integer","format":"int64","description":"Transaction sequence number."},"chainId":{"type":"integer","format":"int64","description":"Zetrix chain identifier."},"operations":{"type":"array","items":{"$ref":"#/components/schemas/OperationFormat"}}}},"OperationFormat":{"type":"object","description":"Decoded operation from a parsed blob.","properties":{"type":{"type":"string"},"sourceAddress":{"type":"string"},"metadata":{"type":"string"},"sendGas":{"$ref":"#/components/schemas/GasSendInfo"},"sendAsset":{"$ref":"#/components/schemas/AssetSendInfo"},"setMetadata":{"$ref":"#/components/schemas/AccountSetMetadataInfo"},"log":{"$ref":"#/components/schemas/LogInfo"}}},"GasSendInfo":{"type":"object","properties":{"destAddress":{"type":"string"},"amount":{"type":"integer","format":"int64"},"input":{"type":"string"}}},"AssetSendInfo":{"type":"object","properties":{"destAddress":{"type":"string"},"input":{"type":"string"}}},"AccountSetMetadataInfo":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"},"version":{"type":"integer","format":"int64"},"deleteFlag":{"type":"boolean"}}},"LogInfo":{"type":"object","properties":{"topic":{"type":"string"},"datas":{"type":"array","items":{"type":"string"}}}},"ResponseMessage":{"type":"object","description":"A response message indicating informational, warning, or error details.","properties":{"type":{"type":"string","description":"Severity: `INFO`, `WARNING`, or `ERROR`.","enum":["INFO","ERROR","WARNING"]},"errorCode":{"type":"integer","format":"int32","description":"Numeric error code (0 = no error)."},"message":{"type":"string","description":"Human-readable description."}}}}}}
```

## The ResponseWrapperTxQueryRespDto object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"ResponseWrapperTxQueryRespDto":{"type":"object","properties":{"object":{"$ref":"#/components/schemas/TxQueryRespDto"},"messages":{"type":"array","items":{"$ref":"#/components/schemas/ResponseMessage"}},"success":{"type":"boolean"},"timestamp":{"type":"string","format":"date-time"},"traceId":{"type":"string"}}},"TxQueryRespDto":{"type":"object","description":"Transaction query result.","properties":{"txStatus":{"type":"string","description":"Numeric transaction lifecycle status code. See [Zetrix WebSocket Error Codes](https://docs.zetrix.com/en/developer-resources/api/websocket#error-codes)."},"txContent":{"$ref":"#/components/schemas/TransactionHistory"}}},"TransactionHistory":{"type":"object","description":"Full on-chain transaction record.","properties":{"hash":{"type":"string","description":"Transaction hash."},"ledgerSeq":{"type":"integer","format":"int64","description":"Block number the transaction was confirmed in."},"actualFee":{"type":"string","description":"Actual fee paid in drops."},"errorCode":{"type":"integer","format":"int32","description":"On-chain execution error code. See [Zetrix WebSocket Error Codes](https://docs.zetrix.com/en/developer-resources/api/websocket#error-codes)."},"errorDesc":{"type":"string","description":"Error description if the transaction failed."},"closeTime":{"type":"integer","format":"int64","description":"Block close timestamp in milliseconds."},"txSize":{"type":"integer","format":"int64","description":"Transaction size in bytes."},"transaction":{"$ref":"#/components/schemas/TransactionInfo"},"signatures":{"type":"array","items":{"$ref":"#/components/schemas/Signature"}},"contractTxHashes":{"type":"array","items":{"type":"string"},"description":"Internal hashes from contract execution."}}},"TransactionInfo":{"type":"object","properties":{"sourceAddress":{"type":"string"},"feeLimit":{"type":"integer","format":"int64"},"gasPrice":{"type":"integer","format":"int64"},"nonce":{"type":"integer","format":"int64"},"chainId":{"type":"integer","format":"int64"}}},"Signature":{"type":"object","properties":{"signData":{"type":"string"},"publicKey":{"type":"string"}}},"ResponseMessage":{"type":"object","description":"A response message indicating informational, warning, or error details.","properties":{"type":{"type":"string","description":"Severity: `INFO`, `WARNING`, or `ERROR`.","enum":["INFO","ERROR","WARNING"]},"errorCode":{"type":"integer","format":"int32","description":"Numeric error code (0 = no error)."},"message":{"type":"string","description":"Human-readable description."}}}}}}
```

## The ResponseWrapperContractSubmitRespDto object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"ResponseWrapperContractSubmitRespDto":{"type":"object","properties":{"object":{"$ref":"#/components/schemas/ContractSubmitRespDto"},"messages":{"type":"array","items":{"$ref":"#/components/schemas/ResponseMessage"}},"success":{"type":"boolean"},"timestamp":{"type":"string","format":"date-time"},"traceId":{"type":"string"}}},"ContractSubmitRespDto":{"type":"object","properties":{"hash":{"type":"string","description":"Transaction hash confirming contract invocation was broadcast."}}},"ResponseMessage":{"type":"object","description":"A response message indicating informational, warning, or error details.","properties":{"type":{"type":"string","description":"Severity: `INFO`, `WARNING`, or `ERROR`.","enum":["INFO","ERROR","WARNING"]},"errorCode":{"type":"integer","format":"int32","description":"Numeric error code (0 = no error)."},"message":{"type":"string","description":"Human-readable description."}}}}}}
```

## The ResponseWrapperContractGenerateBlobRespDto object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"ResponseWrapperContractGenerateBlobRespDto":{"type":"object","properties":{"object":{"$ref":"#/components/schemas/ContractGenerateBlobRespDto"},"messages":{"type":"array","items":{"$ref":"#/components/schemas/ResponseMessage"}},"success":{"type":"boolean"},"timestamp":{"type":"string","format":"date-time"},"traceId":{"type":"string"}}},"ContractGenerateBlobRespDto":{"type":"object","description":"Response for contract invocation blob generation.","properties":{"blob":{"type":"string","description":"Hex-encoded contract invocation blob."},"hash":{"type":"string","description":"Transaction hash."},"actualFee":{"type":"integer","format":"int64","description":"Estimated fee in gas units."},"platformSignData":{"$ref":"#/components/schemas/PlatformSignDataEntity"}}},"PlatformSignDataEntity":{"type":"object","description":"Optional platform co-signature data, present when the platform pre-signs the blob.","properties":{"publicKey":{"type":"string","description":"Platform's public key."},"signBlob":{"type":"string","description":"Platform's signature of the blob."}}},"ResponseMessage":{"type":"object","description":"A response message indicating informational, warning, or error details.","properties":{"type":{"type":"string","description":"Severity: `INFO`, `WARNING`, or `ERROR`.","enum":["INFO","ERROR","WARNING"]},"errorCode":{"type":"integer","format":"int32","description":"Numeric error code (0 = no error)."},"message":{"type":"string","description":"Human-readable description."}}}}}}
```

## The ResponseWrapperContractPaymasterGenerateBlobRespDto object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"ResponseWrapperContractPaymasterGenerateBlobRespDto":{"type":"object","properties":{"object":{"$ref":"#/components/schemas/ContractPaymasterGenerateBlobRespDto"},"messages":{"type":"array","items":{"$ref":"#/components/schemas/ResponseMessage"}},"success":{"type":"boolean"},"timestamp":{"type":"string","format":"date-time"},"traceId":{"type":"string"}}},"ContractPaymasterGenerateBlobRespDto":{"type":"object","description":"Response for paymaster-sponsored contract invocation blob generation.","required":["blob","blobId","expiresAt","hash","paymasterAddress","paymasterNonce","paymasterPoolId","timeoutMinutes"],"properties":{"blob":{"type":"string","description":"Hex-encoded blob. Sign and submit via `/contract/paymaster/submit`."},"hash":{"type":"string","description":"Transaction hash."},"blobId":{"type":"string","description":"Paymaster reservation ID. Required in `/contract/paymaster/submit`."},"paymasterAddress":{"type":"string","description":"Paymaster address sponsoring gas."},"paymasterNonce":{"type":"integer","format":"int64","description":"Reserved nonce."},"paymasterPoolId":{"type":"integer","format":"int64","description":"Paymaster pool ID."},"contractAddress":{"type":"string","description":"Resolved on-chain contract address."},"method":{"type":"string","description":"Contract method being invoked."},"actualFee":{"type":"integer","format":"int64","description":"Estimated fee in gas units."},"expiresAt":{"type":"string","format":"date-time","description":"Nonce reservation expiry. Submit before this time."},"timeoutMinutes":{"type":"integer","format":"int32","description":"Timeout duration in minutes."},"platformSignData":{"$ref":"#/components/schemas/PlatformSignDataEntity"}}},"PlatformSignDataEntity":{"type":"object","description":"Optional platform co-signature data, present when the platform pre-signs the blob.","properties":{"publicKey":{"type":"string","description":"Platform's public key."},"signBlob":{"type":"string","description":"Platform's signature of the blob."}}},"ResponseMessage":{"type":"object","description":"A response message indicating informational, warning, or error details.","properties":{"type":{"type":"string","description":"Severity: `INFO`, `WARNING`, or `ERROR`.","enum":["INFO","ERROR","WARNING"]},"errorCode":{"type":"integer","format":"int32","description":"Numeric error code (0 = no error)."},"message":{"type":"string","description":"Human-readable description."}}}}}}
```

## The ResponseWrapperJSONObject object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"ResponseWrapperJSONObject":{"type":"object","properties":{"object":{"type":"object","additionalProperties":{},"description":"Dynamic JSON response from the smart contract method."},"messages":{"type":"array","items":{"$ref":"#/components/schemas/ResponseMessage"}},"success":{"type":"boolean"},"timestamp":{"type":"string","format":"date-time"},"traceId":{"type":"string"}}},"ResponseMessage":{"type":"object","description":"A response message indicating informational, warning, or error details.","properties":{"type":{"type":"string","description":"Severity: `INFO`, `WARNING`, or `ERROR`.","enum":["INFO","ERROR","WARNING"]},"errorCode":{"type":"integer","format":"int32","description":"Numeric error code (0 = no error)."},"message":{"type":"string","description":"Human-readable description."}}}}}}
```

## The ResponseWrapperDSMonitoringBlockchain object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"ResponseWrapperDSMonitoringBlockchain":{"type":"object","properties":{"object":{"$ref":"#/components/schemas/DSMonitoringBlockchain"},"messages":{"type":"array","items":{"$ref":"#/components/schemas/ResponseMessage"}},"success":{"type":"boolean"},"timestamp":{"type":"string","format":"date-time"},"traceId":{"type":"string"}}},"DSMonitoringBlockchain":{"type":"object","description":"Comprehensive blockchain network statistics.","properties":{"chainId":{"type":"integer","format":"int64"},"chainName":{"type":"string"},"blockchainHeight":{"type":"integer","format":"int64"},"transactionNum":{"type":"integer","format":"int64"},"accountNum":{"type":"integer","format":"int64"},"txTpsMax":{"type":"integer","format":"int32"},"currentTps":{"type":"integer","format":"int32"},"txNumLastDay":{"type":"integer","format":"int64"},"blockAverageGeneTime":{"type":"integer","format":"int32"},"netStatus":{"type":"string"},"lastLedgerList":{"type":"array","items":{"$ref":"#/components/schemas/DSMonitoringLedger"}},"lastTxList":{"type":"array","items":{"$ref":"#/components/schemas/DSMonitoringTx"}}}},"DSMonitoringLedger":{"type":"object","properties":{"seq":{"type":"integer","format":"int64","description":"Block sequence number."},"txNum":{"type":"integer","format":"int64","description":"Transactions in this block."},"ledgerAge":{"type":"integer","format":"int64","description":"Age in milliseconds."}}},"DSMonitoringTx":{"type":"object","properties":{"senderAddress":{"type":"string"},"txHash":{"type":"string"},"txTime":{"type":"integer","format":"int64"}}},"ResponseMessage":{"type":"object","description":"A response message indicating informational, warning, or error details.","properties":{"type":{"type":"string","description":"Severity: `INFO`, `WARNING`, or `ERROR`.","enum":["INFO","ERROR","WARNING"]},"errorCode":{"type":"integer","format":"int32","description":"Numeric error code (0 = no error)."},"message":{"type":"string","description":"Human-readable description."}}}}}}
```

## The ResponseWrapperDSMonitoringNodeStatWrapper object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"ResponseWrapperDSMonitoringNodeStatWrapper":{"type":"object","properties":{"object":{"$ref":"#/components/schemas/DSMonitoringNodeStatWrapper"},"messages":{"type":"array","items":{"$ref":"#/components/schemas/ResponseMessage"}},"success":{"type":"boolean"},"timestamp":{"type":"string","format":"date-time"},"traceId":{"type":"string"}}},"DSMonitoringNodeStatWrapper":{"type":"object","properties":{"total":{"type":"integer","format":"int32","description":"Total nodes across all types."},"validatorNodeStat":{"$ref":"#/components/schemas/DSMonitoringNodeStat"},"synchronousNodeStat":{"$ref":"#/components/schemas/DSMonitoringNodeStat"}}},"DSMonitoringNodeStat":{"type":"object","properties":{"total":{"type":"integer","format":"int32"},"onlineCount":{"type":"integer","format":"int32"},"offlineCount":{"type":"integer","format":"int32"},"warnCount":{"type":"integer","format":"int32"}}},"ResponseMessage":{"type":"object","description":"A response message indicating informational, warning, or error details.","properties":{"type":{"type":"string","description":"Severity: `INFO`, `WARNING`, or `ERROR`.","enum":["INFO","ERROR","WARNING"]},"errorCode":{"type":"integer","format":"int32","description":"Numeric error code (0 = no error)."},"message":{"type":"string","description":"Human-readable description."}}}}}}
```

## The ResponseWrapperDSMonitoringPagination object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"ResponseWrapperDSMonitoringPagination":{"type":"object","properties":{"object":{"$ref":"#/components/schemas/DSMonitoringPagination"},"messages":{"type":"array","items":{"$ref":"#/components/schemas/ResponseMessage"}},"success":{"type":"boolean"},"timestamp":{"type":"string","format":"date-time"},"traceId":{"type":"string"}}},"DSMonitoringPagination":{"type":"object","properties":{"pageNum":{"type":"integer","format":"int32"},"pageSize":{"type":"integer","format":"int32"},"total":{"type":"integer","format":"int32"},"content":{"type":"array","items":{"$ref":"#/components/schemas/DSMonitoringNodeList"}}}},"DSMonitoringNodeList":{"type":"object","description":"Details of an individual blockchain node.","properties":{"nodeName":{"type":"string","description":"Human-readable node name."},"nodeAddress":{"type":"string","description":"Zetrix address of the node."},"consensusAddress":{"type":"string"},"nodeType":{"type":"string","description":"`VALIDATOR` or `SYNCHRONOUS`."},"nodeStatus":{"type":"string","description":"`ONLINE`, `OFFLINE`, or `WARN`."},"operatingSystem":{"type":"string"},"blockSeq":{"type":"string","description":"Latest synced block number."},"blockHash":{"type":"string"},"expirationTime":{"type":"string"},"certEndTime":{"type":"string"},"licenseEndTime":{"type":"string"}}},"ResponseMessage":{"type":"object","description":"A response message indicating informational, warning, or error details.","properties":{"type":{"type":"string","description":"Severity: `INFO`, `WARNING`, or `ERROR`.","enum":["INFO","ERROR","WARNING"]},"errorCode":{"type":"integer","format":"int32","description":"Numeric error code (0 = no error)."},"message":{"type":"string","description":"Human-readable description."}}}}}}
```

## The ResponseWrapperListDSMonitoringNode object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"ResponseWrapperListDSMonitoringNode":{"type":"object","properties":{"object":{"type":"array","items":{"$ref":"#/components/schemas/DSMonitoringNode"}},"messages":{"type":"array","items":{"$ref":"#/components/schemas/ResponseMessage"}},"success":{"type":"boolean"},"timestamp":{"type":"string","format":"date-time"},"traceId":{"type":"string"}}},"DSMonitoringNode":{"type":"object","description":"Node count for a geographic region.","properties":{"geographyCode":{"type":"integer","format":"int32","description":"Numeric ISO country/region code."},"total":{"type":"integer","format":"int32","description":"Number of nodes in this region."}}},"ResponseMessage":{"type":"object","description":"A response message indicating informational, warning, or error details.","properties":{"type":{"type":"string","description":"Severity: `INFO`, `WARNING`, or `ERROR`.","enum":["INFO","ERROR","WARNING"]},"errorCode":{"type":"integer","format":"int32","description":"Numeric error code (0 = no error)."},"message":{"type":"string","description":"Human-readable description."}}}}}}
```

## The ResponseWrapperLong object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"ResponseWrapperLong":{"type":"object","properties":{"object":{"type":"integer","format":"int64","description":"The numeric value (e.g., block height)."},"messages":{"type":"array","items":{"$ref":"#/components/schemas/ResponseMessage"}},"success":{"type":"boolean"},"timestamp":{"type":"string","format":"date-time"},"traceId":{"type":"string"}}},"ResponseMessage":{"type":"object","description":"A response message indicating informational, warning, or error details.","properties":{"type":{"type":"string","description":"Severity: `INFO`, `WARNING`, or `ERROR`.","enum":["INFO","ERROR","WARNING"]},"errorCode":{"type":"integer","format":"int32","description":"Numeric error code (0 = no error)."},"message":{"type":"string","description":"Human-readable description."}}}}}}
```

## The ResponseWrapperResponsePaginatedContractUsageHistoryRespDto object

```json
{"openapi":"3.1.0","info":{"title":"Zetrix Microservice API","version":"1.0.0"},"components":{"schemas":{"ResponseWrapperResponsePaginatedContractUsageHistoryRespDto":{"type":"object","properties":{"object":{"$ref":"#/components/schemas/ResponsePaginatedContractUsageHistoryRespDto"},"messages":{"type":"array","items":{"$ref":"#/components/schemas/ResponseMessage"}},"success":{"type":"boolean"},"timestamp":{"type":"string","format":"date-time"},"traceId":{"type":"string"}}},"ResponsePaginatedContractUsageHistoryRespDto":{"type":"object","properties":{"page":{"type":"integer","format":"int64"},"pageSize":{"type":"integer","format":"int64"},"totalPages":{"type":"integer","format":"int32"},"totalElements":{"type":"integer","format":"int64"},"content":{"type":"array","items":{"$ref":"#/components/schemas/ContractUsageHistoryRespDto"}}}},"ContractUsageHistoryRespDto":{"type":"object","description":"A single contract invocation history record.","properties":{"id":{"type":"integer","format":"int64","description":"Internal record ID."},"address":{"type":"string","description":"Contract on-chain address."},"contractKey":{"type":"string","description":"Contract alias key."},"txInitiator":{"type":"string","description":"Address that initiated the transaction."},"method":{"type":"string","description":"Contract method called."},"inputParameters":{"type":"string","description":"JSON-serialized input parameters."},"txHash":{"type":"string","description":"Transaction hash."},"status":{"type":"string","enum":["INITIATED","SUBMITTED"],"description":"Invocation status."},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}},"ResponseMessage":{"type":"object","description":"A response message indicating informational, warning, or error details.","properties":{"type":{"type":"string","description":"Severity: `INFO`, `WARNING`, or `ERROR`.","enum":["INFO","ERROR","WARNING"]},"errorCode":{"type":"integer","format":"int32","description":"Numeric error code (0 = no error)."},"message":{"type":"string","description":"Human-readable description."}}}}}}
```