Time to read: 1 min
Personal Module Methods
personal_lockAccount
Locks the given account.
Parameters
DATA, 20 Bytes - address.
Example Parameters
params: ['0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b']
Returns
Boolean - true if the account was successfully locked, otherwise false.
Example
// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"personal_lockAccount","params":["0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b"],"id":73}'
// Result
{
"id":1,
"jsonrpc": "2.0",
"result": true
}
personal_unlockAccount
Unlocks the given account for a given amount of time.
Parameters
DATA, 20 Bytes - address.String- The passphrase of the account.QUANTITY- (optional, default: 1800000 milliseconds) The duration for the account to remain unlocked.
Example Parameters
params: [
"0x11f4d0A3c12e86B4b5F39B213F7E19D048276DAe",
"test passphrase!",
"927C0" // 600000 milliseconds (10 min)
]
Returns
Boolean - true if the account was successfully unlocked, otherwise false.
Example
// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"personal_unlockAccount","params":["0x11f4d0A3c12e86B4b5F39B213F7E19D048276DAe", "test passphrase!",
"927C0"],"id":73}'
// Result
{
"id":1,
"jsonrpc": "2.0",
"result": true
}
personal_sendTransaction
Sends a transaction over the management API.
Parameters
Object- The transaction call object
from:DATA, 20 Bytes - (optional) The address the transaction is sent from.to:DATA, 20 Bytes - The address the transaction is directed to.gas:QUANTITY- (optional) Integer of the gas provided for the transaction execution. eth_call consumes zero gas, but this parameter may be needed by some executions.gasPrice:QUANTITY- (optional) Integer of the gasPrice used for each paid gas.value:QUANTITY- (optional) Integer of the value sent with this transaction.data:DATA- (optional) Hash of the method signature and encoded parameters. For details see Ethereum Contract ABI in the Solidity documentation.
String- The passphrase of the current account.
Example Parameters
params: [{
"from": "0xb60e8dd61c5d32be8058bb8eb970870f07233155",
"to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567",
"gas": "0x76c0", // 30400
"gasPrice": "0x9184e72a000", // 10000000000000
"value": "0x9184e72a", // 2441406250
"data": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
}, "test passphrase!"]
Returns
DATA - The transaction hash.
** Example**
// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"personal_sendTransaction","params":[{see above}],"id":1}'
// Result
{
"id":1,
"jsonrpc": "2.0",
"result": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331"
}
personal_importRawKey
Imports the given private key into the key store, encrypting it with the passphrase.
Parameters
DATA- An unencrypted private key (hex string).String- The passphrase of the current account.
Example Parameters
params: [
"0xcd3376bb711cb332ee3fb2ca04c6a8b9f70c316fcdf7a1f44ef4c7999483295e",
"test passphrase!"
]
Returns
DATA - The address of the new account.
** Example**
// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"personal_importRawKey","params":["0xcd3376bb711cb332ee3fb2ca04c6a8b9f70c316fcdf7a1f44ef4c7999483295e",
"test passphrase!"],"id":1}'
// Result
{
"id":1,
"jsonrpc": "2.0",
"result": "0x8f337bf484b2fc75e4b0436645dcc226ee2ac531"
}
personal_dumpRawKey
Returns an hexadecimal representation of the private key of the given address.
Parameters
DATA, 20 Bytes - The address of the account, said account must be unlocked.
Example Parameters
params: ["0xcd3376bb711cb332ee3fb2ca04c6a8b9f70c316fcdf7a1f44ef4c7999483295e"]
Returns
DATA - A hexadecimal representation of the account's key.
Example
// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"personal_dumpRawKey","params":["0xcd3376bb711cb332ee3fb2ca04c6a8b9f70c316fcdf7a1f44ef4c7999483295e"],"id":1}'
// Result
{
"id":1,
"jsonrpc": "2.0",
"result": "777ebfc1e2b6930b09647e7a2273b3e53f759c751c0056695af466783db3642f"
}
personal_newAccount
Creates a new account.
Parameters
String- The passphrase to encrypt this account with.
Example Parameters
params: ["test passphrase!"]
Returns
DATA - The address of the newly created account.
Example
// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"personal_newAccount","params":["test passphrase!"],"id":1}'
// Result
{
"id":1,
"jsonrpc": "2.0",
"result": "0x8f337bf484b2fc75e4b0436645dcc226ee2ac531"
}
personal_newAccountWithSeed
Creates a new account using a seed phrase.
Parameters
String- The seed phrase to encrypt this account with.
Example Parameters
params: ["seed"]
Returns
DATA - The address of the newly created account.
Example
// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"personal_newAccountWithSeed","params":["seed"],"id":1}'
// Result
{
"id":1,
"jsonrpc": "2.0",
"result": "0x8f337bf484b2fc75e4b0436645dcc226ee2ac531"
}