Skip to main content
POST
/
platform
/
admin
/
smart_contract_implementations_deploy
/
save-deploy-transaction
Save deployment transaction hash
curl --request POST \
  --url https://api.example.com/platform/admin/smart_contract_implementations_deploy/save-deploy-transaction \
  --header 'Content-Type: application/json' \
  --data '{}'
{
  "isSuccess": true,
  "isFailure": false,
  "error": null,
  "value": {
    "id": 42,
    "name": "Example"
  }
}

​
Description

Saves the transaction hash after a smart contract implementation deployment has been submitted to the blockchain. This creates a permanent record linking the implementation to its on-chain deployment, enabling transaction monitoring and contract address resolution once the transaction is confirmed.

​
Input

Expects a JSON request body containing:
  • smartContractImplementationId (long, required) - Unique identifier of the deployed implementation.
  • blockchainId (long, required) - Target blockchain network identifier (1 for Ethereum, 137 for Polygon, etc.).
  • transactionHash (string, required) - The blockchain transaction hash from deployment broadcast (0x… format, 66 characters).

​
Output

Returns a SuccessResponse containing:
  • success (bool) - Indicates if the operation succeeded (true if saved).
  • message (string) - Confirmation message with deployment details.

​
Examples

Request 
{
  "smartContractImplementationId": 1,
  "blockchainId": 137,
  "transactionHash": "0x1a2b3c4d5e6f7890abcdef1234567890abcdef1234567890abcdef1234567890"
}
Response (200 OK) 
{
  "data": {
    "success": true,
    "message": "Deployment transaction hash saved successfully for implementation 1 on blockchain 137"
  }
}

​
Errors

  • 400 Bad Request: Missing required fields, invalid transaction hash format, or malformed request.
  • 401 Unauthorized: Missing or invalid authentication token.
  • 403 Forbidden: User lacks platform administrator privileges.
  • 404 Not Found: Smart contract implementation or blockchain not found.
  • 409 Conflict: Deployment transaction hash already exists for this implementation on the specified blockchain.
  • 500 Internal Server Error: Unexpected system error occurred during save operation.

​
Notes

Requires platform administrator privileges. This endpoint should be called immediately after broadcasting the deployment transaction to the blockchain. The transaction hash must be a valid hexadecimal string starting with “0x” and exactly 66 characters long. Once saved, the system can monitor the transaction for confirmation and extract the deployed contract address. Duplicate transaction hashes for the same implementation and blockchain are rejected to prevent data inconsistency.

Query Parameters

​
api-version
string | null

Body

application/json

Deployment transaction details including implementation ID, blockchain ID, and transaction hash.

Represents the request to save a deploy transaction hash for a smart contract implementation.

​
smartContractImplementationId
integer<int64>

Unique identifier for the smart contract implementation that was deployed.

Example:

1

​
blockchainId
integer<int64>

Identifier of the blockchain network where the deployment occurred.

Example:

137

​
transactionHash
string

Transaction hash from the blockchain deployment transaction.

Example:

"0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"

Response

Transaction hash saved successfully.

Wrapper for API operation results containing success status, error information, and return value.

​
isSuccess
boolean

True if the operation completed successfully, false otherwise.

Example:

true

​
isFailure
boolean

True if the operation failed, false otherwise.

Example:

false

​
error
object

Error information returned when the operation fails.

Example:
{
  "code": "ValidationError",
  "message": "The request parameters failed validation.",
  "info": [
    "The Name field is required.",
    "The Id field must be greater than 0."
  ]
}
​
value
object

The result value returned when the operation is successful.

Example:
{ "success": true }