HomeDocumentationAPI Reference
Log In
API Reference

Register Scoped Session Key

Method Name

private/register_scoped_session_key

Registers a new session key bounded to a scope without a transaction attached.
If you want to register an admin key, you must provide a signed raw transaction.
Required minimum session key permission level is account

Parameters

expiry_sec  integer required
Expiry of the session key

public_session_key  string required
Session key in the form of an Ethereum EOA

wallet  string required
Ethereum wallet address of account

ip_whitelist  array of strings
List of whitelisted IPs, if empty then any IP is allowed.

label  string
User-defined session key label

scope  string
Scope of the session key. Defaults to READ_ONLY level permissions.
enum admin account read_only

signed_raw_tx  string
A signed RLP encoded ETH transaction in form of a hex string (same as w3.eth.account.sign_transaction(unsigned_tx, private_key).rawTransaction.hex()) Must be included if the scope is ADMIN.

Response

id  string or integer required

result  object required

result. expiry_sec  integer required
Session key expiry timestamp in sec

result. ip_whitelist  array of strings or null required
List of whitelisted IPs, if empty then any IP is allowed.

result. label  string or null required
User-defined session key label

result. public_session_key  string required
Session key in the form of an Ethereum EOA

result. scope  string required
Session key permission level scope
enum admin account read_only

result. transaction_id  string or null required
ID to lookup status of transaction if signed_raw_tx is provided

Example

{request_example_shell}
{request_example_javascript}
{request_example_python}

The above command returns JSON structured like this:

{response_example_json}