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}