Utilities Endpoint

Get Chain ID

Get Chain ID

GET

API_URL/api/contract/utils/chain-id

HEADERS

client_id   9b16ae5638534ae1961fb370f874b6cc*

client_secret   sk_9b16ae5638534ae1961fb370f874b6cc*

The returned values will be in the format of

Sample Result

{
    "message": "Success",
    "result": 2207
}

Get Gas Price

Get Gas Price

GET

API_URL/api/contract/utils/gas-price

HEADERS

client_id   9b16ae5638534ae1961fb370f874b6cc*

client_secret   sk_9b16ae5638534ae1961fb370f874b6cc*

The returned values will be in the format of

Sample Result

{
    "message": "Success",
    "result": 0
}

List Supported Compiler Versions

List Supported Compiler Versions

GET

API_URL/api/contract/utils/compiler-versions

HEADERS

client_id   9b16ae5638534ae1961fb370f874b6cc*

client_secret   sk_9b16ae5638534ae1961fb370f874b6cc*

The returned values will be in the format of

Sample Result

{
    "message": "Success",
    "result": [
        "0.8.28",
        "0.8.27",
        "0.8.26",
        ...
    ]
}

Encode ABI - Contract Deploy

Encode Contract Deployment Parameters

POST

API_URL/api/contract/utils/deploy-encode

HEADERS

client_id   9b16ae5638534ae1961fb370f874b6cc*

client_secret   sk_9b16ae5638534ae1961fb370f874b6cc*

Params

Name	Required	Description
abi	Yes	The contract abi
bytecode	Yes	The contract bytecode
params	Required if contract have deployment parameters	Key-value array list of parameters required for the contract deployment

Sample Request Body (Custodial Wallet)

{
    "abi": [
        {
            "name": "increment",
            "type": "function",
            "inputs": [],
            "outputs": [],
            "stateMutability": "nonpayable"
        },
        ...
    ],
    "bytecode": "0x60806040526000805560006001...",
    "params": {
        "fieldA": "Testing"
    }
}

The returned values will be in the format of

Sample Result

{
    "message": "Success",
    "result": "encodedAbiString"
}

Encode ABI - Contract Execution

Encode Contract Execution Parameters

POST

API_URL/api/contract/utils/execute-encode

HEADERS

client_id   9b16ae5638534ae1961fb370f874b6cc*

client_secret   sk_9b16ae5638534ae1961fb370f874b6cc*

Params

Name	Required	Description
abi	Yes	The contract abi
contract_address	Yes	The contract address
method_name	Yes	The contract method name to execute
params	Required if contract method require parameters	Key-value array list of parameters required for the contract deployment

Sample Request Body

{
    "abi": [
        {
            "name": "increment",
            "type": "function",
            "inputs": [],
            "outputs": [],
            "stateMutability": "nonpayable"
        },
        ...
    ],
    "contract_address": "0x9F7A94cEA78652479...",
    "method_name": "increment",
    "params": {
        "fieldA": "Testing"
    }
}

The returned values will be in the format of

Sample Result

{
    "message": "Success",
    "result": "encodedAbiString"
}

Estimate Gas

Estimate Gas for Transaction

POST

API_URL/api/contract/utils/estimate-gas

HEADERS

client_id   9b16ae5638534ae1961fb370f874b6cc*

client_secret   sk_9b16ae5638534ae1961fb370f874b6cc*

Params

Name	Required	Description
from	At least one of the listed fields is required	The sender address
to	At least one of the listed fields is required	The target/receiver address
value	At least one of the listed fields is required	Amount to transfer with the transaction
data	At least one of the listed fields is required	ABI encoded transaction data
nonce	No	Nonce

Sample Request Body (Contract Execution)

{
    "from": "0x9db65D81AB6c2B6E7Ca354864f9e5b4c6eE303C5",
    "to": "0x9F7A94cEA7865247958aEbF34039AD78AF4b0C80",
    "data": "0xd09de08a"
}

The returned values will be in the format of

Sample Result

{
    "message": "Success",
    "result": 47648
}

Simulate Transaction

Simulate Transaction Execution

**Note: The revert reason returned from this API depends on the underlying smart contract. If no revert reason was included, there will be no revert reason included in the response as well.

POST

API_URL/api/contract/utils/simulate-transaction

HEADERS

client_id   9b16ae5638534ae1961fb370f874b6cc*

client_secret   sk_9b16ae5638534ae1961fb370f874b6cc*

Params

Name	Required	Description
from	At least one of the listed fields is required	The sender address. If transaction expects specific sender, the corresponding from address shall be included
to	At least one of the listed fields is required	The target/receiver address
value	At least one of the listed fields is required	Amount to transfer with the transaction
data	At least one of the listed fields is required	ABI encoded transaction data
nonce	No	Nonce

Sample Request Body (Contract Execution)

{
    "from": "0x4D377Ac7de73F399B8418F1e22c86920aF0B445F",
    "to": "0xf099a210E8B7D77B73E840c46cfB8aE4A40F25e8",
    "data": "0xa0ab965300000000000000000...",
    "value": 0,
    "gasPrice": 0,
    "nonce": 1
}

The returned values will be in the format of

Sample Result (Error)

{
    "message": "Success",
    "result": {
        "success": false, // Indicator if the transaction is successful
        "message": "Returned error: VM Exception while processing transaction: revert Invalid signature provided" // Revert reason if any
    }
}