SuiClientBuilder

Struct SuiClientBuilder 

Source
pub struct SuiClientBuilder { /* private fields */ }
Available on crate feature client only.
Expand description

A Sui client builder for connecting to the Sui network

By default the maximum concurrent requests is set to 256 and the request timeout is set to 60 seconds. These can be adjusted using the max_concurrent_requests function, and the request_timeout function. If you use the WebSocket, consider setting the ws_ping_interval field to a value of your choice to prevent the inactive WS subscription being disconnected due to proxy timeout.

§Examples

use sui_jsonrpc::client::SuiClientBuilder;
#[tokio::main]
async fn main() -> Result<(), color_eyre::eyre::Error> {
    let sui = SuiClientBuilder::default()
        .build("http://127.0.0.1:9000")
        .await?;

    println!("Sui local network version: {:?}", sui.api_version());
    Ok(())
}

Implementations§

Source§

impl SuiClientBuilder

Source

pub const fn request_timeout(self, request_timeout: Duration) -> Self

Set the request timeout to the specified duration

Source

pub fn ws_url(self, url: impl AsRef<str>) -> Self

👎Deprecated: JSON-RPC subscriptions have been deprecated since at least mainnet-v1.28.3. See https://github.com/MystenLabs/sui/releases/tag/mainnet-v1.28.3

Set the WebSocket URL for the Sui network

Source

pub const fn ws_ping_interval(self, duration: Duration) -> Self

👎Deprecated: JSON-RPC subscriptions have been deprecated since at least mainnet-v1.28.3. See https://github.com/MystenLabs/sui/releases/tag/mainnet-v1.28.3

Set the WebSocket ping interval

Source

pub fn basic_auth( self, username: impl AsRef<str>, password: impl AsRef<str>, ) -> Self

Set the basic auth credentials for the HTTP client

Source

pub async fn build_localnet(self) -> SuiClientResult<SuiClient>

Returns a SuiClient object that is ready to interact with the local development network (by default it expects the Sui network to be up and running at 127.0.0.1:9000).

Source

pub async fn build_devnet(self) -> SuiClientResult<SuiClient>

Returns a SuiClient object that is ready to interact with the Sui devnet.

Source

pub async fn build_testnet(self) -> SuiClientResult<SuiClient>

Returns a SuiClient object that is ready to interact with the Sui testnet.

Source

pub async fn build(self, http: impl AsRef<str>) -> SuiClientResult<SuiClient>

Returns a SuiClient object connected to the Sui network running at the URI provided.

Trait Implementations§

Source§

impl Default for SuiClientBuilder

Source§

fn default() -> Self

Returns the “default value” for a type. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<U> As for U

Source§

fn as_<T>(self) -> T
where T: CastFrom<U>,

Casts self to type T. The semantics of numeric casting with the as operator are followed, so <T as As>::as_::<U> can be used in the same way as T as U for numeric conversions. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

impl<T> ErasedDestructor for T
where T: 'static,

Source§

impl<T> MaybeSend for T
where T: Send,