Skip to main content

Everscale

WC JSON-RPC for Everscale

ever_sign​

Signature of a random message for authentication.

Parameters:​
  1. message - some message in base64;
  2. withSignatureId - bool or number
  3. hashData - bool
Returns:​
  1. signature - string signature in base64;
  2. pubkey - public key of the wallet's address;
Example:​
// Request
{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "ever_sign",
  "params": {
        "message": "some message in base64",
        "withSignatureId": true,
        "hashData": true
    }
}

// Result
{
  "id": 1,
  "jsonrpc": "2.0",
  "result":  {
        "signature": "0xa3f207... in base64",
        "pubkey": "0x07bf94e...37e3"
    }
}

ever_sendMessage​

Creates message, sends it to the network, monitors its processing and returns transaction's id.

Parameters:​
  1. value - amount of coins attached to the message;
  2. bounce - should the answer message be generated in case of an error;
  3. destAddress - message destination address;
  4. destPayload - message destination payload; 4.1. abi - destination contract ABI; 4.2. method - destination contract method; 4.3. params - destination contract method params
Returns:​
  1. txId - transaction's id in blockchain;
Example:​
// Request
{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "ever_sendMessage",
  "params": {
        "source_address": "0:695e42...b8d",
        "value": 1000000000,
        "bounce": False,
        "destAddress": "0:b38d96...708",
        "destPayload": {
            "abi": "",
            "method": "",
            "params": {}
        },
    }
}

// Result
{
  "id": 1,
  "jsonrpc": "2.0",
  "result":  {
        "txId": "743e1c0046b82a48a2cf8cbe9a2059ce6f3862cfae377c77d9f1b4efd88d7acb"
    }
}

ever_signMessage​

Message that can then be sent to the blockchain.

Parameters:​
  1. value - amount of coins attached to the message;
  2. bounce - should the answer message be generated in case of an error;
  3. destAddress - message destination address;
  4. destPayload - message destination payload; 4.1. abi - destination contract ABI; 4.2. method - destination contract method; 4.3. params - destination contract method params
Returns:​
  1. signedExtMessage - signed external message;
  2. expireAt - мessage expiration timestamp
Example:​
// Request
{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "ever_processMessage",
  "params": {
        "source_address": "0:695e42...b8d",
        "value": 1000000000,
        "bounce": False,
        "destAddress": "0:b38d96...708",
        "destPayload": {
            "abi": "",
            "method": "",
            "params": {}
        },
    }
}

// Result
{
  "id": 1,
  "jsonrpc": "2.0",
  "result":  {
        "signedExtMessage": "c0b0996a9f0ea8e472041857ff2da9cf8086a78603f823a7170891f43a217ff1",
        "expireAt": 1685594678
    }
}

ever_sendExternalMessage​

Sends an external message to the contract.

Parameters:​
  1. destAddress - message destination address;
  2. destPayload - message destination payload; 2.1. abi - destination contract ABI; 2.2. method - destination contract method; 2.3. params - destination contract method params
Returns:​
  1. txId - transaction's id in blockchain;
Example:​
// Request
{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "ever_sendExternalMessage",
  "params": {
        "sourceAddress": "0:695e42...b8d",
        "destAddress": "0:b38d96...708",
        "destPayload": {
            "abi": "",
            "method": "",
            "params": {}
        },
    }
}

// Result
{
  "id": 1,
  "jsonrpc": "2.0",
  "result":  {
        "txId": "743e1c0046b82a48a2cf8cbe9a2059ce6f3862cfae377c77d9f1b4efd88d7acb"
    }
};

ever_broadcastMessage​

Sends an internal message from the user account without waiting for the transaction.

Parameters:​
  1. value - amount of coins attached to the message;
  2. bounce - should the answer message be generated in case of an error;
  3. destAddress - message destination address;
  4. destPayload - message destination payload; 4.1. abi - destination contract ABI; 4.2. method - destination contract method; 4.3. params - destination contract method params
Returns:​
  1. hash: string - external message hash;
  2. account: string - destination account address (equals to source_address);
  3. expireAt: number - мessage expiration timestamp
Example:​
// Request
{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "ever_broadcastMessage",
  "params": {
        "sourceAddress": "0:695e42...b8d",
        "value": 1000000000,
        "bounce": False,
        "destAddress": "0:b38d96...708",
        "destPayload": {
            "abi": "",
            "method": "",
            "params": {}
        },
    }
}

// Result
{
  "id": 1,
  "jsonrpc": "2.0",
  "result":  {
        "hash": "743e1c0046b82a48a2cf8cbe9a2059ce6f3862cfae377c77d9f1b4efd88d7acb",
        "account": "0:695e42...b8d",
        "expireAt": 1684327417543
    }
};

ever_broadcastExternalMessage​

Sends an external message to the contract without waiting for the transaction.

Parameters:​
  1. destAddress - message destination address;
  2. destPayload - message destination payload; 2.1. abi - destination contract ABI; 2.2. method - destination contract method; 2.3. params - destination contract method params
Returns:​
  1. hash: string - external message hash;
  2. account: string - destination account address (equals to source_address);
  3. expireAt: number - мessage expiration timestamp
Example:​
// Request
{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "ever_broadcastExternalMessage",
  "params": {
        "sourceAddress": "0:695e42...b8d",
        "destAddress": "0:b38d96...708",
        "destPayload": {
            "abi": "",
            "method": "",
            "params": {}
        },
    }
}

// Result
{
  "id": 1,
  "jsonrpc": "2.0",
  "result":  {
        "hash": "743e1c0046b82a48a2cf8cbe9a2059ce6f3862cfae377c77d9f1b4efd88d7acb",
        "account": "0:b38d96...708",
        "expireAt": 1684327417543
    }
}

ever_addTokenAsset​

Adds asset (TIP-3 or native tokens) to the selected account.

Parameters:​
  1. rootContract - asset root address. Note: you can add native coin by leaving this field empty
Returns:​
  1. newAsset: bool - returns true if the account did not have this asset before
Example:​
// Request
{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "ever_addTokenAsset",
  "params": {
        "sourceAddress": "0:695e42...b8d",
        "rootContract": "0:b38d96...708"
    }
}

// Result
{
  "id": 1,
  "jsonrpc": "2.0",
  "result":  {
        "newAsset": true
    }
}

ever_encryptData​

Encrypts arbitrary data with specified algorithm for each specified recipient.

Parameters:​
  1. recipientPublicKeys - public keys of recipients. Hex encoded;
  2. algorithm - encryption algorithm. Currently supports only “ChaCha20Poly1305”
  3. data - base64 encoded data;
Returns:​
  1. encryptedData - encrypted data for each recipient 1.1. algorithm - encryption algorithm 1.2. sourcePublicKey - hex encoded encryptor's public key 1.3. recipientPublicKey - hex encoded recipient public key 1.4. data - base64 encoded data 1.5. nonce - base64 encoded nonce
Example:​
// Request
{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "ever_encryptData",
  "params": {
       "sourceAddress": "0:695e42...b8d",
       "recipientPublicKeys": ["0x6e74...4e95", "0x9532...403f"],
       "algorithm": "ChaCha20Poly1305",
       "data": "ZGF0YQ=="
  }
}

// Result
{
  "id": 1,
  "jsonrpc": "2.0",
  "result":  {
        "encryptedData": [
           {
            "algorithm": "ChaCha20Poly1305",
            "sourcePublicKey": "0x209f...d08f",
	      "recipientPublicKey": "0x6e74...4e95",
            "data": "ZW5jRGF0YTE=",
            "nonce": "bm9uY2Ux"
           },
           {
            "algorithm": "ChaCha20Poly1305",
            "sourcePublicKey": "0x209f...d08f",
            "recipientPublicKey": "0x6e74...4e95",
            "data":"ZW5jRGF0YTI=",
            "nonce":"bm9uY2Uy"
           }
        ]
    }
};

ever_decryptData​

Decrypts encrypted data.

Parameters:​
  1. algorithm - encryption algorithm. Currently supports only “ChaCha20Poly1305”
  2. recipientPublicKey - hex encoded recipient public key
  3. data - base64 encoded data
  4. nonce - base64 encoded nonce
Returns:​
  1. data - base64 encoded decrypted data
Example:​
// Request
{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "ever_decryptData",
  "params": {
       "sourceAddress": "0:695e42...b8d",
       "algorithm": "ChaCha20Poly1305",
       "recipientPublicKey": "0x6e74...4e95",
       "data": "ZW5jRGF0YTE=",
       "nonce": "bm9uY2Ux"
  }
}

// Result
{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
       "data": "ZGF0YQ=="
   }
};