JSONRPC-parity_accounts-module.md

The parity_accounts Module

JSON-RPC methods

• parity_allAccountsInfo
• parity_changePassword
• parity_deriveAddressHash
• parity_deriveAddressIndex
• parity_exportAccount
• parity_getDappAddresses
• parity_getDappDefaultAddress
• parity_getNewDappsAddresses
• parity_getNewDappsDefaultAddress
• parity_importGethAccounts
• parity_killAccount
• parity_listGethAccounts
• parity_listRecentDapps
• parity_newAccountFromPhrase
• parity_newAccountFromSecret
• parity_newAccountFromWallet
• parity_removeAddress
• parity_setAccountMeta
• parity_setAccountName
• parity_setDappAddresses
• parity_setDappDefaultAddress
• parity_setNewDappsAddresses
• parity_setNewDappsDefaultAddress
• parity_testPassword

JSON-RPC API Reference

parity_allAccountsInfo

returns a map of accounts as an object.

Parameters

None

Returns

• Array - Account metadata.
  • name: String - Account name.
  • meta: String - Encoded JSON string the defines additional account metadata.
  • uuid: String - The account Uuid, or null if not available/unknown/not applicable.

Example

Request

curl --data '{"method":"parity_allAccountsInfo","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "0x00a289b43e1e4825dbedf2a78ba60a640634dc40": {
      "meta": "{}",
      "name": "Foobar",
      "uuid": "0b9e70e6-235b-682d-a15c-2a98c71b3945"
    }
  }
}

---

parity_changePassword

Change the password for a given account.

Parameters

0. Address - Address of the account.
1. String - Old password.
2. String - New password.

params: [
  "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
  "hunter2",
  "bazqux5"
]

Returns

• Boolean - true if the call was successful.

Example

Request

curl --data '{"method":"parity_changePassword","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1","hunter2","bazqux5"],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": true
}

---

parity_deriveAddressHash

Derive new address from given account address using specific hash.

Parameters

0. Address - Account address to derive from.
1. String - Password to the account.
2. Object - Derivation hash and type (soft or hard). E.g. { hash: "0x123..123", type: "hard" }.
3. Boolean - Flag indicating if the account should be saved.

params: [
  "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
  "hunter2",
  {
    "hash": "0x2547ea3382099c7c76d33dd468063b32d41016aacb02cbd51ebc14ff5d2b6a43",
    "type": "hard"
  },
  false
]

Returns

• Address - 20 Bytes new derived address.

Example

Request

curl --data '{"method":"parity_deriveAddressHash","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1","hunter2",{"hash":"0x2547ea3382099c7c76d33dd468063b32d41016aacb02cbd51ebc14ff5d2b6a43","type":"hard"},false],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0x407d73d8a49eeb85d32cf465507dd71d507100c1"
}

---

parity_deriveAddressIndex

Derive new address from given account address using hierarchical derivation (sequence of 32-bit integer indices).

Parameters

0. Address - Account address to export.
1. String - Password to the account.
2. Array - Hierarchical derivation sequence of index and type (soft or hard). E.g. [{index:1,type:"hard"},{index:2,type:"soft"}].
3. Boolean - Flag indicating if the account should be saved.

params: [
  "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
  "hunter2",
  [
    {
      "index": 1,
      "type": "hard"
    },
    {
      "index": 2,
      "type": "soft"
    }
  ],
  false
]

Returns

• Address - 20 Bytes new derived address.

Example

Request

curl --data '{"method":"parity_deriveAddressIndex","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1","hunter2",[{"index":1,"type":"hard"},{"index":2,"type":"soft"}],false],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0x407d73d8a49eeb85d32cf465507dd71d507100c1"
}

---

parity_exportAccount

Returns a standard wallet file for given account if password matches.

Parameters

0. Address - Account address to export.
1. String - Password to the account.

params: [
  "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
  "hunter2"
]

Returns

• Object - Standard wallet JSON.

Example

Request

curl --data '{"method":"parity_exportAccount","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1","hunter2"],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "address": "0042e5d2a662eeaca8a7e828c174f98f35d8925b",
    "crypto": {
      "cipher": "aes-128-ctr",
      "cipherparams": {
        "iv": "a1c6ff99070f8032ca1c4e8add006373"
      },
      "ciphertext": "df27e3db64aa18d984b6439443f73660643c2d119a6f0fa2fa9a6456fc802d75",
      "kdf": "pbkdf2",
      "kdfparams": {
        "c": 10240,
        "dklen": 32,
        "prf": "hmac-sha256",
        "salt": "ddc325335cda5567a1719313e73b4842511f3e4a837c9658eeb78e51ebe8c815"
      },
      "mac": "3dc888ae79cbb226ff9c455669f6cf2d79be72120f2298f6cb0d444fddc0aa3d"
    },
    "id": "6a186c80-7797-cff2-bc2e-7c1d6a6cc76e",
    "meta": "{\"passwordHint\":\"parity-export-test\",\"timestamp\":1490017814987}",
    "name": "parity-export-test",
    "version": 3
  }
}

---

parity_getDappAddresses

Returns the list of accounts available to a specific dapp.

Parameters

0. String - Dapp Id.

params: ["web"]

Returns

• Array - The list of available accounts.

Example

Request

curl --data '{"method":"parity_getDappAddresses","params":["web"],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": ["0x407d73d8a49eeb85d32cf465507dd71d507100c1"]
}

---

parity_getDappDefaultAddress

Returns a default account available to a specific dapp.

Parameters

0. String - Dapp Id.

params: ["web"]

Returns

• Address - Default Address

Example

Request

curl --data '{"method":"parity_getDappDefaultAddress","params":["web"],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0x407d73d8a49eeb85d32cf465507dd71d507100c1"
}

---

parity_getNewDappsAddresses

Returns the list of accounts available to a new dapps.

Parameters

None

Returns

• Array - The list of available accounts, can be null.

Example

Request

curl --data '{"method":"parity_getNewDappsAddresses","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": ["0x407d73d8a49eeb85d32cf465507dd71d507100c1"]
}

---

parity_getNewDappsDefaultAddress

Returns a default account available to dapps.

Parameters

None

Returns

• Address - Default Address

Example

Request

curl --data '{"method":"parity_getNewDappsDefaultAddress","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0x407d73d8a49eeb85d32cf465507dd71d507100c1"
}

---

parity_importGethAccounts

Imports a list of accounts from Geth.

Parameters

0. Array - List of the Geth addresses to import.

params: [
  ["0x407d73d8a49eeb85d32cf465507dd71d507100c1"]
]

Returns

• Array - Array of the imported addresses.

Example

Request

curl --data '{"method":"parity_importGethAccounts","params":[["0x407d73d8a49eeb85d32cf465507dd71d507100c1"]],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": ["0x407d73d8a49eeb85d32cf465507dd71d507100c1"]
}

---

parity_killAccount

Deletes an account.

Parameters

0. Address - The account to remove.
1. String - Account password.

params: [
  "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
  "hunter2"
]

Returns

• Boolean - true if the call was successful.

Example

Request

curl --data '{"method":"parity_killAccount","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1","hunter2"],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": true
}

---

parity_listGethAccounts

Returns a list of the accounts available from Geth.

Parameters

None

Returns

• Array - 20 Bytes addresses owned by the client.

Example

Request

curl --data '{"method":"parity_listGethAccounts","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": ["0x407d73d8a49eeb85d32cf465507dd71d507100c1"]
}

---

parity_listRecentDapps

Returns a list of the most recent active dapps.

Parameters

None

Returns

• Array - Array of Dapp Ids.

Example

Request

curl --data '{"method":"parity_listRecentDapps","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": ["web"]
}

---

parity_newAccountFromPhrase

Creates a new account from a recovery phrase.

Parameters

0. String - Recovery phrase.
1. String - Password.

params: [
  "stylus outing overhand dime radial seducing harmless uselessly evasive tastiness eradicate imperfect",
  "hunter2"
]

Returns

• Address - The created address.

Example

Request

curl --data '{"method":"parity_newAccountFromPhrase","params":["stylus outing overhand dime radial seducing harmless uselessly evasive tastiness eradicate imperfect","hunter2"],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0x407d73d8a49eeb85d32cf465507dd71d507100c1"
}

---

parity_newAccountFromSecret

Creates a new account from a private ethstore secret key.

Parameters

0. Data - Secret, 32-byte hex
1. String - Password

params: [
  "0x1db2c0cf57505d0f4a3d589414f0a0025ca97421d2cd596a9486bc7e2cd2bf8b",
  "hunter2"
]

Returns

• Address - The created address.

Example

Request

curl --data '{"method":"parity_newAccountFromSecret","params":["0x1db2c0cf57505d0f4a3d589414f0a0025ca97421d2cd596a9486bc7e2cd2bf8b","hunter2"],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0x407d73d8a49eeb85d32cf465507dd71d507100c1"
}

---

parity_newAccountFromWallet

Creates a new account from a JSON import

Parameters

0. String - Wallet JSON encoded to a string.
1. String - Password.

params: [
  "{\"id\": \"9c62e86b-3cf9...\", ...}",
  "hunter2"
]

Returns

• Address - The created address

Example

Request

curl --data '{"method":"parity_newAccountFromWallet","params":["{\"id\": \"9c62e86b-3cf9...\", ...}","hunter2"],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0x407d73d8a49eeb85d32cf465507dd71d507100c1"
}

---

parity_removeAddress

Removes an address from the addressbook.

Parameters

0. Address - The address to remove.

params: ["0x407d73d8a49eeb85d32cf465507dd71d507100c1"]

Returns

• Boolean - trueif the call was successful.

Example

Request

curl --data '{"method":"parity_removeAddress","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1"],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": true
}

---

parity_setAccountMeta

Sets metadata for the account

Parameters

0. Address - Address
1. String - Metadata (JSON encoded)

params: [
  "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
  "{\"foo\":\"bar\"}"
]

Returns

• Boolean - true if the call was successful.

Example

Request

curl --data '{"method":"parity_setAccountMeta","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1","{\"foo\":\"bar\"}"],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": true
}

---

parity_setAccountName

Sets a name for the account

Parameters

0. Address - Address
1. String - Name

params: [
  "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
  "Foobar"
]

Returns

• Boolean - true if the call was successful.

Example

Request

curl --data '{"method":"parity_setAccountName","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1","Foobar"],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": true
}

---

parity_setDappAddresses

Sets the available addresses for a dapp. When provided with non-empty list changes the default account as well.

Parameters

0. String - Dapp Id.
1. Array - Array of available accounts available to the dapp or null for default list.

params: [
  "web",
  ["0x407d73d8a49eeb85d32cf465507dd71d507100c1"]
]

Returns

• Boolean - true if the call was successful.

Example

Request

curl --data '{"method":"parity_setDappAddresses","params":["web",["0x407d73d8a49eeb85d32cf465507dd71d507100c1"]],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": true
}

---

parity_setDappDefaultAddress

Changes dapp default address. Does not affect other accounts exposed for this dapp, but default account will always be retured as the first one.

Parameters

0. String - Dapp Id.
1. Address - Default Address.

params: [
  "web",
  "0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]

Returns

• Boolean - true if the call was successful

Example

Request

curl --data '{"method":"parity_setDappDefaultAddress","params":["web","0x407d73d8a49eeb85d32cf465507dd71d507100c1"],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": true
}

---

parity_setNewDappsAddresses

Sets the list of accounts available to new dapps.

Parameters

0. Array - List of accounts available by default or null for all accounts.

params: [
  ["0x407d73d8a49eeb85d32cf465507dd71d507100c1"]
]

Returns

• Boolean - true if the call was successful

Example

Request

curl --data '{"method":"parity_setNewDappsAddresses","params":[["0x407d73d8a49eeb85d32cf465507dd71d507100c1"]],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": true
}

---

parity_setNewDappsDefaultAddress

Changes global default address. This setting may be overriden for a specific dapp.

Parameters

0. Address - Default Address.

params: ["0x407d73d8a49eeb85d32cf465507dd71d507100c1"]

Returns

• Boolean - true if the call was successful

Example

Request

curl --data '{"method":"parity_setNewDappsDefaultAddress","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1"],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": true
}

---

parity_testPassword

Checks if a given password can unlock a given account, without actually unlocking it.

Parameters

0. Address - Account to test.
1. String - Password to test.

params: [
  "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
  "hunter2"
]

Returns

• Boolean - true if the account and password are valid.

Example

Request

curl --data '{"method":"parity_testPassword","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1","hunter2"],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": true
}