How to Use the Sui TypeScript SDK

Sui is the chain of the moment, and although Move is the holy grail for writing smart contracts on Sui, the TypeScript support is significant. You can interact with and use Sui and most of the DeFi apps on the ecosystem with TypeScript.

In this tutorial, I’ll teach you how to interact with the Sui network via TypeScript. You’ll learn how to read the state of the blockchain, write transactions to the chain from your TypeScript programs.

Getting Started With Sui and TypeScript

The only prerequisite is that you’ll need basic JS/TS knowledge to run this tutorial smoothly. I’ll walk you through everything else.

First, create a new TypeScript project in your terminal and initialize a new Node.js project.

mkdir SuiTS
cd SuiTS
npm init -y

Install TypeScript as a development dependency if you don’t have it already.

npm install typescript --save-dev
npm install ts-node //runs TS without the need for transpiling

Now, you can initialize a new TypeScript project. This command will create a tsconfig.json file with default options that you can customize for your project.

npx tsc --init

Open the tsconfig.json and paste these configurations.

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "CommonJS",
    "outDir": "./dist",
    "rootDir": "./src",
    "strict": true,
    "esModuleInterop": true,
    "types": ["node"],
    "resolveJsonModule": true
  },
  "exclude": ["node_modules"],

  "scripts": {
    "build": "tsc",
    "start": "node dist/index.js"
  }
}

Create a src directory where you’ll add your TypeScript files.

mkdir src
touch src/index.ts

Finally, install the Sui TypeScript SDK with this command.

npm i @mysten/sui.js

You’re all set. You can start writing TypeScript programs that interact with the Sui blockchain.

Connecting to the Sui Blockchain

You must connect to a Sui blockchain to interact with the chain.

First, import getFullnodeUrl and SuiClient from the SDK client module.

import { getFullnodeUrl, SuiClient } from '@mysten/sui/client';

Now, depending on your desired connection, you can use getFullnodeUrl to retrieve the full node URL of the Sui testnet, mainnet, localnet, or devnet; then, use the SuiClient to connect to the client instance.

import { getFullnodeUrl, SuiClient } from '@mysten/sui/client';

const rpcUrl = getFullnodeUrl('mainnet');

const client = new SuiClient({ url: rpcUrl });

To test your connection, You can use the getLatestSuiSystemState to retrieve the latest state of the network.

// index.ts
import { getFullnodeUrl, SuiClient } from '@mysten/sui/client';

const rpcUrl = getFullnodeUrl("mainnet");

const client = new SuiClient({ url: rpcUrl });

async function getNetworkStatus() {
    const currentEpoch = await client.getLatestSuiSystemState();
    console.log(currentEpoch)
}

getNetworkStatus();

Now, transpile the TypeScript code to JavaScript and run it with this command:

ts-node index.ts

You should expect an output similar to this when you execute the command.

Creating a Sui Wallet

Creating a wallet is another popular operation that might be handy if you build on the Sui Network.

Here’s how to generate Sui wallet keypairs and retrieve the private and public keys from the Keypair.

import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
import { getFullnodeUrl, SuiClient } from '@mysten/sui/client';

const rpcUrl = getFullnodeUrl("mainnet");

const client = new SuiClient({ url: rpcUrl });

// random Keypair
const keypair = new Ed25519Keypair();

const publicKey = keypair.getPublicKey();
const privatekey = keypair.getSecretKey();

console.log(privatekey.toString());
console.log(publicKey.toSuiAddress());

The Ed25519Keypair function creates a new key pair. The getPublicKey and getPrivateKey methods give you access to the public and private keys, respectively.

Here’s the string output of the private and public keys I generated with the program:

mkdir SuiTS
cd SuiTS
npm init -y

I’m funding this wallet with 0.25 Sui for the next set of operations. Feel free to verify and scan the wallet. Do not send any funds; it’s just a dummy wallet.

Reading Sui Wallet Balances

You can use the getCoins function on your client instance to retrieve details on the coins in a wallet address.

npm install typescript --save-dev
npm install ts-node //runs TS without the need for transpiling

The function returns details on the Sui coin alone and the details. The output is in MIST, the Sui gas token. 1 SUI equals 1 billion MIST.

The getAllCoins function can be used in the same way to get a list of all the coins in a wallet.

npx tsc --init

For this example, I traded some Sui for $FUD on Hop Aggregator, and here’s the output after running the program.

Send Coins or Objects

Finally, the interesting part is that you’ll learn to send transactions on the blockchain.

Let’s send some $FUD tokens to another wallet. This works for any coins on the Sui Network.

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "CommonJS",
    "outDir": "./dist",
    "rootDir": "./src",
    "strict": true,
    "esModuleInterop": true,
    "types": ["node"],
    "resolveJsonModule": true
  },
  "exclude": ["node_modules"],

  "scripts": {
    "build": "tsc",
    "start": "node dist/index.js"
  }
}

First, I checked that the wallet had some $FUD and split it for the transfer. The tx.transferObjects transfer the split coin to the specified address.

Finally, you need to sign the transaction with the client.signAndExecuteTransaction, and you can wait for the transaction with waitForTransaction to confirm the transaction went through

Conclusion

You’ve learned to interact with the Sui blockchain using the official TypeScript SDK. There’s so much you can build on Sui with your newly acquired knowledge, such as building wallets and bots.

You can take this further by learning how to interact with Move contracts on Sui to build more sophisticated dApps

The above is the detailed content of How to Use the Sui TypeScript SDK. For more information, please follow other related articles on the PHP Chinese website!