Address book

The Rust SDK exposes address-book reads and invalidation streaming. Entry/tag mutations require a JWT/session and are not included.

Methods

use polyester::proto::auth::v1::ListAddressBookEntriesRequest;

let page = client
    .address_book
    .list_entries(ListAddressBookEntriesRequest {
        limit: 50,
        ..Default::default()
    })
    .await?;
for entry in page.entries {
    println!("{} {} {}", entry.address_book_entry_id, entry.label, entry.kind);
}

Whitelists are enforced allowlists: a saved destination does not itself authorize a withdrawal. Re-fetch the relevant view after an invalidation; the event is not a full snapshot.

All calls are authenticated. The invalidation stream additionally requires Account ID and the address-book read permission. The method returns only after the private token and Centrifugo handshake succeed. An HTTP 403 from a test fixture that lacks that permission is an expected policy/configuration denial, not an SDK streaming defect; grant address-book read access before reconnecting.

Related

• Withdrawals
• Streaming

Related Topics