pysui 0.50.0

SUI client Python SDK

pysui

Python Client SDK for Sui blockchain

• Supports SUI 1.16.x RPC API
• Backwards compatable to Sui 1.10.x RPC API

pysui SDK Dependencies

• Rust (stable) for installation of Sui Binaries (optional) and building pysui-fastcrypto Rust wrapper (required)
• Python version >= 3.10

pysui SDK current (github)

Release-0.50.0 BREAKING CHANGES

See CHANGELOG

PyPi current

Release-0.50.0 BREAKING CHANGES

• Latest PyPi Version

Sui GraphQL RPC service beta

MystenLabs announcement can be found Here. This change transitions from JSON RPC to GraphQL RPC.

With pysui 0.50.0 are releasing pysui's initial alignment with MystenLabs strategy. The timeline of changes will keep up with the Timeline as noted in the Sui GraphQL annoucement.

Note: Currently The MystenLabs/Sui GraphQL RPC is beta and operates on a snapshot of data, it is not maintaining beyond:

• testnet data timestamp: "2023-12-16T19:07:30.993Z"
• mainnet data timestamp: "2023-11-21T22:03:27.667Z"

pysui 0.50.0 contains support for our December 2023 target:

1. December 2023: Synchronous and asynchronous GraphQL clients (experimental) with intial 'read' queries parallel to current pysui read Builders. Also expose underlying GraphQL for users to craft their own queries.
2. January 2024: Continue with GraphQL and Builder parity changes. Mysten to roll out live data to devnet, testnet and mainnet.
3. February 2024: Deprecate pysui Builders and existing SuiClients and enable SuiClient GraphQL 'streaming' support.
4. Sometime in 2024: Remove Builders and Obsolete SuiClients and bump pysui to version 1.0.0.

You can read pysui documentation on graphql here

FULL Documentation

• ReadTheDocs

Changelog

See CHANGELOG

Issues and enhancement requests

We would appreciate using the github issue log to let us know!

Release/Publish Strategy

See Strategies

Discord

Discord server click here:

Additions

There is a companion package called pysui-gadgets with a few utilities and ge-gaws that you may find interesting. It is a separate package also on on PyPi.

Local node support

We leverage suibase for our testing and SuiConfig includes an option for interacting directly with local nodes created by suibase

Ready to run

Requires:

• Linux or macos (x86_64 or Mx)
• Rust (stable) which also includes rustup and cargo
• python 3.10 or greater
• pkg-config
• libtool
• sui binaries to support publish Sui move packages

You will need suibase for interacting with local nodes, it is an indispensible addition to Sui developers tools!

Setup environment

python3 -m venv env

If, instead, you want to work with repo latest source code then read DEVELOP from repo

Activate

source env/bin/activate

or

. env/bin/activate

Install pysui

pip install pysui

Samples

See samples