ServerWallet API

ServerWallet APIs support HTTP protocol. It uses /wallet path.

Endpoint

Test Server : https://test-api.protx.io/wallet

createAddress

Returns a new address. After generating a new private key in Server Wallet, Address, secretKey, and mnemonic are returned.

Parameters

Name	Type	Description
addInfo	String	Address Information. This can be retrieved using the getAddressInfo API. Max length : 200

Return Value

Name	Type	Description
address	String	Address
secretKey	String	It is used for authentication when requesting SignData to the Server Wallet. It cannot be viewed or exported, so it must be kept well.
mnemonic	String	Used for address recovery if necessary

A new secretKey is created when ImportAddress is called.

Example

{
    "jsonrpc": "2.0",
    "id": "00456",
    "result": {
        "resultCode": "200",
        "resultMessage": "Success",
        "resultData": {
            "address": "0xce808360b37030c29bdf3eacbc6c8cda62c04c39",
            "mnemonic": "bulk tomorrow beauty tag fragile rough quit antique shock river powder ghost",
            "secretKey": "49d274d8fcbd00b862dbfb01a759d233"
        }
    }
}

getAddressInfo

Return an address information.

Parameters

Name	Type	Description
address	String	Address

Return Value

Name	Type	Description
address	String	Address
addInfo	String	Address information saved when creating an address.

Example

{
    "jsonrpc": "2.0",
    "id": "00456",
    "result": {
        "resultCode": "200",
        "resultMessage": "Success",
        "resultData": {
            "address": "0xce808360b37030c29bdf3eacbc6c8cda62c04c39",
            "mnemonic": "My Test Address"
        }
    }
}

exportAddress

Returns the mnemonic of a given address. if hashKey is not correct, it will return error.

Parameters

Name	Type	Description
address	String	Address
languageType	String	mnemonic language (Currently only "en" available)
tempKey	String	tempKey for "exportAddress"
hashKey	String	hash(tempKey | secretKey)

Return Value

Name	Type	Description
mnemonic	String	Used for address recovery if necessary.

Example

{
    "jsonrpc": "2.0",
    "id": "00456",
    "result": {
        "resultCode": "200",
        "resultMessage": "Success",
        "resultData": {
            "mnemonic": "bulk tomorrow beauty tag fragile rough quit antique shock river powder ghost"
        }
    }
}

importAddress

Import an Address using mnemonic. Store private key in Server Wallet, and Address, secretKey, and mnemonic are returned.

Parameters

Name	Type	Description
languageType	String	mnemonic language (Currently only "en" available)
mnemonic	String	Mnemonic String
addInfo	String	Address Information. This can be retrieved using the getAddressInfo API. Max length : 200

Return Value

Name	Type	Description
address	String	Address
secretKey	String	It is used for authentication when requesting SignData to the Server Wallet. It cannot be viewed or exported, so it must be kept well.
mnemonic	String	Address can be restored using Mnemonic.

Example

{
    "jsonrpc": "2.0",
    "id": "00456",
    "result": {
        "resultCode": "200",
        "resultMessage": "Success",
        "resultData": {
            "address": "0xce808360b37030c29bdf3eacbc6c8cda62c04c39",
            "mnemonic": "bulk tomorrow beauty tag fragile rough quit antique shock river powder ghost",
            "secretKey": "49d274d8fcbd00b862dbfb01a759d233"
        }
    }
}

importAddressWithPrivateKey

Import an Address using private key. Store private key in Server Wallet, and Address, secretKey are returned. Unlike importAddress , mnemonic is not returned.

Parameters

Name	Type	Description
privateKey	String	private Key
addInfo	String	Address Information. This can be retrieved using the getAddressInfo API. Max length : 200

Return Value

Name	Type	Description
address	String	Address (0x....)
secretKey	String	It is used for authentication when requesting SignData to the Server Wallet. It cannot be viewed or exported, so it must be kept well.
mnemonic	String	empty.

Example

{
    "jsonrpc": "2.0",
    "id": "00456",
    "result": {
        "resultCode": "200",
        "resultMessage": "Success",
        "resultData": {
            "address": "0xce808360b37030c29bdf3eacbc6c8cda62c04c39",
            "mnemonic": "",
            "secretKey": "49d274d8fcbd00b862dbfb01a759d233"
        }
    }
}

getAddressTokenList

Returns a list of tokens held by address.

Parameters

Name	Type	Description
address	String	Address

Return Value

Name	Type	Description
address	String	Address
contractAddress	String	Contract address of token.
symbol	String	Symbol of token.
tokenType	String	Type of token "ERC20", "ERC721", "ERC1155"
tokenId	BigInteger	tokenId of ERC1155, In case of ERC20, ERC721 token, it is the blank.
balance	BigDecimal	Balance of token. In case of ERC1155 token, it is the balance of tokenId.

Example

{
    "jsonrpc": "2.0",
    "id": "00456",
    "result": {
        "resultCode": "200",
        "resultMessage": "Success",
        "resultData": { 
            [ 
                { 
                    "address": "0x39fdfdsfsdsdfsdf9sd0sfds9fsd0fsdgsd",
                    "contractAddress": "0xce808360b37030c29bdf3eacbc6c8cda62c04c39",
                    "symbol": "TOK1",
                    "tokenType": "ERC20",
                    "tokenId": "",
                    "balance": "10.292"
                },
                { 
                    "address": "0x39fdfdsfsdsdfsdf9sd0sfds9fsd0fsdgsd",
                    "contractAddress": "0xce808360b37030c29bdf3eacbc6c8cda62c04c39",
                    "symbol": "TOK2",
                    "tokenType": "ERC1155",
                    "tokenId": "2",
                    "balance": "10"
                }
            ]
        }
    }
}

signData

Returns data signed with the private key of address to make a transaction.

Parameters

Name	Type	Description
address	String	Address
data	String	Data to be signed. This is probably a hash value.
tempKey	String	tempKey for "signData"
hashKey	String	hash(tempKey | secretKey)

Return Value

Name	Type	Description
signedData	String	Signed data

Example

{
    "jsonrpc": "2.0",
    "id": "00456", 
    "result": {
        "resultCode": "200",
        "resultMessage": "Success",
        "resultData": {
            "signedData": "3043021f6741c7c4ec...ac6d7f7ba8350608"
        }
    }
}