# 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: `SEND_GAS`, `TRANSFER`, `CONTRACT_INVOKE`, `CREATE_ACCOUNT`, `ISSUE_ASSET`, `SEND_ASSET`."},"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: `SEND_GAS`, `TRANSFER`, `CONTRACT_INVOKE`, `CREATE_ACCOUNT`, `ISSUE_ASSET`, `SEND_ASSET`."},"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: `SEND_GAS`, `TRANSFER`, `CONTRACT_INVOKE`, `CREATE_ACCOUNT`, `ISSUE_ASSET`, `SEND_ASSET`."},"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."}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.zetrix.com/en/developer-resources/blockchain-as-a-services-baas/zetrix-service/models.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.