Jump to

• Request
• Response

Deploy Contract

post

/walletservice/v1/wallets/{walletId}/deploy-contract

Deploy a smart contract from a wallet.

Request

Path Parameters

• walletId(required): integer(int64)
  Wallet identifier.

  Example:

  101

Supported Media Types

• application/json

Request Body - application/json ()

Root Schema : schema

Type: object

Show Source

• abi(required): array abi
• byteCode(required): string
  Compiled contract bytecode.

  Example: 1619025984
• constructorArgs: array constructorArgs
• gasLimit: string
  Example: 3000000
• rpcUrl: string (uri)
  Example: http://127.0.0.1:8545
• value: string
  Example: 0

{
    "type":"object",
    "properties":{
        "abi":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ContractAbiEntry"
            }
        },
        "byteCode":{
            "type":"string",
            "description":"Compiled contract bytecode.",
            "example":1619025984
        },
        "constructorArgs":{
            "type":"array",
            "items":{
                "type":"string"
            },
            "example":[
                "0xA677B9e1ac1f24773275C3ca9a4d9Bc0f6510d54",
                "0xA677B9e1ac1f24773275C3ca9a4d9Bc0f6510d54"
            ]
        },
        "gasLimit":{
            "type":"string",
            "nullable":true,
            "example":"3000000"
        },
        "value":{
            "type":"string",
            "nullable":true,
            "example":"0"
        },
        "rpcUrl":{
            "type":"string",
            "format":"uri",
            "nullable":true,
            "example":"http://127.0.0.1:8545"
        }
    },
    "required":[
        "abi",
        "byteCode"
    ]
}

Nested Schema : abi

Type: array

Show Source

• Array of: object ContractAbiEntry
  Additional Properties Allowed: true

  ABI entry.

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/ContractAbiEntry"
    }
}

Nested Schema : constructorArgs

Type: array

Show Source

• Array of: string

{
    "type":"array",
    "items":{
        "type":"string"
    },
    "example":[
        "0xA677B9e1ac1f24773275C3ca9a4d9Bc0f6510d54",
        "0xA677B9e1ac1f24773275C3ca9a4d9Bc0f6510d54"
    ]
}

Example:

[
    "0xA677B9e1ac1f24773275C3ca9a4d9Bc0f6510d54",
    "0xA677B9e1ac1f24773275C3ca9a4d9Bc0f6510d54"
]

Nested Schema : ContractAbiEntry

Type: object

Additional Properties Allowed: true

ABI entry.

Security

• bearerAuth: http
  Type: http

Back to Top

Response

Supported Media Types

• application/json

200 Response

Contract deployment submitted successfully.

Body ()

Root Schema : ContractDeploymentResponse

Type: object

Show Source

• contractAddress: string
  Example: 0x9a626f29784501056687dc267966dae6414cc91f
• from: string
  Example: 0xFE3B557E8Fb62b89F4916B721be55cEb828dBd73
• gasLimit: string
  Example: 3000000
• nonce: string
  Example: 12
• partitionId: string
  Example: 1
• submittedAt: string
  Example: 2026-05-27T14:00:00Z
• txHash: string
  Example: 0x111122223333444455556666777788889999aaaabbbbccccddddeeeeffff0000
• value: string
  Example: 0
• walletId: string
  Example: 101

{
    "type":"object",
    "properties":{
        "txHash":{
            "type":"string",
            "example":"0x111122223333444455556666777788889999aaaabbbbccccddddeeeeffff0000"
        },
        "walletId":{
            "type":"string",
            "example":"101"
        },
        "partitionId":{
            "type":"string",
            "example":"1"
        },
        "from":{
            "type":"string",
            "example":"0xFE3B557E8Fb62b89F4916B721be55cEb828dBd73"
        },
        "nonce":{
            "type":"string",
            "example":"12"
        },
        "gasLimit":{
            "type":"string",
            "example":"3000000"
        },
        "value":{
            "type":"string",
            "example":"0"
        },
        "submittedAt":{
            "type":"string",
            "example":"2026-05-27T14:00:00Z"
        },
        "contractAddress":{
            "type":"string",
            "example":"0x9a626f29784501056687dc267966dae6414cc91f"
        }
    }
}

500 Response

Internal server error.

Body ()

Root Schema : Error

Type: object

Show Source

• code: string
  Example: bad_request
• details: array details
• message(required): string
  Example: The request could not be processed.

{
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "example":"bad_request"
        },
        "message":{
            "type":"string",
            "example":"The request could not be processed."
        },
        "details":{
            "type":"array",
            "items":{
                "type":"string"
            }
        }
    },
    "required":[
        "message"
    ]
}

Nested Schema : details

Type: array

Show Source

• Array of: string

{
    "type":"array",
    "items":{
        "type":"string"
    }
}

Back to Top