Agent Skills: SuiClient Skill

SuiClient Skill

A comprehensive Claude Code skill for interacting with the Sui blockchain using the official @mysten/sui SDK.

Instructions

Use this skill when you need to interact with the Sui blockchain. Includes:

1. Network Connection: Connect to mainnet, testnet, devnet, or localnet
2. Data Reading: Get tokens, objects, transactions, and balances
3. Transaction Execution: Build, sign, and execute transactions
4. Network Information: Get system state, gas prices, and protocol configuration
5. Move Package Interactions: Query normalized Move data
6. Event Handling: Query and subscribe to blockchain events
7. Staking Operations: Manage staking positions
8. Error Handling: Implement comprehensive error handling patterns

Quick Start

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

// Connect to mainnet
const client = new SuiClient({
  url: 'https://sui-mainnet.nodeinfra.com'
});

// Get account balance
const balance = await client.getBalance({
  owner: '0x123...',
  coinType: '0x2::sui::SUI'
});

Installation

# Install the skill
claude skills install sui-client

# Install dependencies
bun add @mysten/sui

Features

• Client Management: Connect to mainnet, testnet, devnet, and localnet
• Data Reading: Get tokens, objects, transactions, and balances
• Transaction Execution: Build, sign, and execute transactions
• Network Information: Get system state, gas prices, and protocol configuration
• Move Package Interactions: Query normalized Move data
• Event Handling: Query and subscribe to blockchain events
• Staking Operations: Manage staking positions
• Error Handling: Comprehensive error handling patterns

Examples

Check the examples/ directory for complete usage examples:

• basic-usage.ts - Basic client setup and data reading
• transactions.ts - Transaction building and execution
• advanced.ts - Advanced patterns and error handling

API Reference

This skill provides comprehensive coverage of the SuiClient API including:

• Reading Data: getObject(), getCoins(), getTransactionBlock()
• Writing Data: signAndExecuteTransaction(), executeTransactionBlock()
• Network Information: getLatestSuiSystemState(), getReferenceGasPrice()
• Events: queryEvents(), subscribeEvent()
• Staking: getStakes(), getStakesByIds()

Detailed Documentation

• Source Code - Complete SuiClient API implementation
• Type Definitions - TypeScript type definitions
• Code Templates - Common code templates
• Example Code - Complete usage examples

Dependencies

• @mysten/sui: ^1.45.0 (managed via package.json)

Contributing

Contributions are welcome! Please see the CONTRIBUTING.md file for details.

License

MIT