Struct SessionStorage 

pub struct SessionStorage;

Persistent session key storage using Soroban contract storage.

Session keys are stored in the contract’s persistent storage, keyed by account address. This allows session keys to survive across contract invocations (unlike ContractAccount’s in-memory storage).

Example

use cougr_core::accounts::{SessionKey, SessionScope, SessionStorage};
use soroban_sdk::{symbol_short, testutils::Address as _, Address, BytesN, Env, Vec};

let env = Env::default();
let player_address = Address::generate(&env);
let key_id = BytesN::from_array(&env, &[7u8; 32]);
let session_key = SessionKey {
    key_id: key_id.clone(),
    scope: SessionScope {
        allowed_actions: Vec::from_array(&env, [symbol_short!("move")]),
        max_operations: 10,
        expires_at: 1_000,
    },
    created_at: 0,
    operations_used: 0,
    next_nonce: 0,
};

SessionStorage::store(&env, &player_address, &session_key);
let loaded = SessionStorage::load(&env, &player_address, &key_id);
assert!(loaded.is_some());

Implementations

impl SessionStorage

pub fn store(env: &Env, account: &Address, key: &SessionKey)

Store a session key for an account.

If a key with the same key_id already exists, it is overwritten.

pub fn load( env: &Env, account: &Address, key_id: &BytesN<32>, ) -> Option<SessionKey>

Load a specific session key by ID.

pub fn load_all(env: &Env, account: &Address) -> Vec<SessionKey>

Load all session keys for an account.

pub fn remove(env: &Env, account: &Address, key_id: &BytesN<32>) -> bool

Remove a session key by ID. Returns true if found and removed.

pub fn increment_usage( env: &Env, account: &Address, key_id: &BytesN<32>, ) -> Result<(), AccountError>

Increment the usage count of a session key.

pub fn consume_authorized_session( env: &Env, account: &Address, key_id: &BytesN<32>, ) -> Result<SessionKey, AccountError>

Consume one authorized session action and advance its nonce.

pub fn cleanup_expired(env: &Env, account: &Address) -> u32

Remove all expired session keys for an account. Returns the number of keys removed.