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=="
   }
};