Wallet API command line functions

encryptwallet

Encrypts the wallet with passphrase, instead of lock wallet

Parameters

passphrase password

Returns

encrypt - true:encrypt successful， false:encrypt failed

Example

// Request
curl -u Waykichain:admin -d '{"jsonrpc":"2.0","id":"curltext","method":"encryptwallet","params":["12345678"]}' -H 'content-type:application/json;' http://127.0.0.1:6967

// Response
{
  "result":
  {
    "encrypt":true
  },
  "error": null,
  "id": "curltext"
}

---

walletlock

locking the wallet. After calling this method, you will need to call walletpassphrase again before being able to call any methods which require the wallet to be unlocked.

Parameters

none

Returns

walletlock - true:locked successful，false:locked failed

Example

// Request
curl -u Waykichain:admin -d '{"jsonrpc":"2.0","id":"curltext","method":"walletlock","params":[]}' -H 'content-type:application/json;' http://127.0.0.1:6967

// Response
{
  "result":
  {
    "walletlock":true
  },
  "error": null,
  "id": "curltext"
}

---

walletpassphrase

Unlock wallet for seconds.

Parameters

passphrase password

timeout The time in which the state is unlocked, unit is second

Returns

passphrase - true:unlocked successful，false:unlocked failed

Example

// Request
curl -u Waykichain:admin -d '{"jsonrpc":"2.0","id":"curltext","method":"walletpassphrase","params":["12345678",1000]}' -H 'content-type:application/json;' http://127.0.0.1:6967

// Response
{
  "result":
  {
    "passphrase":true
  },
  "error":null,
  "id":"curltext"
}

---

walletpassphrasechange

change wallet password

Parameters

oldpassphrase old password

newpassphrase new password

Returns

chgpwd the change status of password.

Example

// Request
curl -u Waykichain:admin -d '{"jsonrpc":"2.0","id":"curltext","method":"walletpassphrasechange","params":["123456789","1234567890"]}' -H 'content-type:application/json;' http://127.0.0.1:6967

// Response
{
    "result": {
        "chgpwd": true
    },
    "error": null,
    "id": "curltext"
}

---

dumpwallet

Dump all wallet keys in a human-readable format dnd write to

Parameters

filename the path+filename to dump wallet

Returns

info result

key size the size of address in dumpwallet

Example

// Request
curl -u Waykichain:admin -d '{"jsonrpc":"2.0","id":"curltext","method":"dumpwallet","params":["/opt/wicc/walletfilename"]}' -H 'content-type:application/json;' http://127.0.0.1:6967

// Response
{
  "result":
  {
    "info":"dump ok",
    "key size":14
  },
  "error": null,
  "id": "curltext"
}

---

importwallet

Import a wallet

Parameters

filename the path+filename to import wallet, dumpwallet from dumpwallet

Returns

info the result info in import wallet

count the size of address in import wallet

Example

// Request
curl -u Waykichain:admin -d '{"jsonrpc":"2.0","id":"curltext","method":"importwallet","params":["/opt/wicc/walletfilename"]}' -H 'content-type:application/json;' http://127.0.0.1:6967

// Response
{
  "result":
  {
     "info": "succeed to import wallet",
     "count": 10
  },
  "error": null,
  "id": "curltext"
}

---

backupwallet

backup wallet file wallet.dat to local

Parameters

destination the path + name to backup wallet

Returns

Example

// Request
curl -u waykichain:wicc123 -d '{"jsonrpc":"2.0","id":"curltext","method":"backupwallet","params":["/opt/wicc/walletfilename"]}' -H 'content-type:application/json;' http://127.0.0.1:6967

// Response
{
    "result": null,
    "error": null,
    "id": "curltext"
}

---

getwalletinfo

Get an object containing various wallet state info

Parameters

none

Returns

wallet_version the wallet version

wallet_balance the total Coin balance of the wallet

wallet_encrypted (boolean) whether the wallet is encrypted or not

unlocked_until (boolean) whether the wallet is locked or not

coinfirmed_tx_num the size of transactions in the wallet

unconfirmed_tx_num the size of unconfirmtx transactions in the wallet

Example

// Request
curl -u Waykichain:admin -d '{"jsonrpc":"2.0","id":"curltext","method":"getwalletinfo"}' -H 'content-type:application/json;' http://127.0.0.1:6967

// Response
{
    "result": {
        "wallet_version": 0,
        "wallet_balance": 207899994.89999995,
        "wallet_encrypted": false,
        "wallet_locked": false,
        "unlocked_until": 0,
        "coinfirmed_tx_num": 3189,
        "unconfirmed_tx_num": 0
    },
    "error": null,
    "id": "curltext"
}

---