Sui Blockchain RPC API Documentation

Enterprise-Grade Infrastructure for Sui's Object-Centric Blockchain

Sui represents a paradigm shift in blockchain architecture, introducing an object-centric data model that enables parallel transaction execution and horizontal scaling. Dwellir provides enterprise-grade RPC infrastructure for Sui, empowering developers to build high-performance decentralized applications with unprecedented throughput and sub-second finality.

Why Choose Dwellir for Sui Development?

Lightning-Fast Performance

• Sub-second finality: Experience near-instant transaction confirmation
• Parallel execution: Leverage Sui's unique ability to process independent transactions simultaneously
• Optimized routing: Global infrastructure ensures minimal latency worldwide
• High throughput: Support for Sui's capability of 120,000+ TPS

Enterprise Reliability

• 99.99% uptime SLA: Industry-leading service level agreement
• Redundant infrastructure: Multiple node clusters across geographic regions
• Automatic failover: Seamless switching between nodes for uninterrupted service
• 24/7 monitoring: Proactive issue detection and resolution

Developer-First Features

• Full JSON-RPC support: Complete implementation of Sui's JSON-RPC API
• High-performance gRPC: Binary Protocol Buffers for 5-10x faster serialization
• WebSocket subscriptions: Real-time event streaming for responsive applications
• Batch requests: Optimize performance with multi-call support
• Detailed analytics: Monitor usage patterns and optimize your applications

Sui's Unique Architecture

Object-Centric Model

Unlike traditional blockchains that organize data around accounts, Sui revolutionizes blockchain architecture with its object-centric approach:

• Objects as first-class citizens: Every piece of data is an object with unique identifiers
• Direct object manipulation: Transactions directly reference and modify objects
• Ownership types: Shared, owned, and immutable objects enable different consensus paths
• Composability: Objects can contain other objects, enabling complex data structures

Move Programming Language

Sui utilizes Move, a resource-oriented programming language designed for safe asset management:

• Resource safety: Prevents duplication and accidental deletion of digital assets
• Formal verification: Mathematical proofs ensure contract correctness
• Module system: Reusable code components for efficient development
• Native asset handling: Built-in support for fungible and non-fungible tokens

Consensus Innovation

Sui's consensus mechanism optimizes for different transaction types:

• Simple transactions: Skip consensus for single-owner object modifications
• Complex transactions: Narwhal and Bullshark consensus for shared objects
• Causal ordering: Maintains transaction dependencies without total ordering
• Byzantine fault tolerance: Secure against malicious actors

API Options

Dwellir provides two high-performance API options for accessing Sui:

JSON-RPC API

Traditional HTTP-based JSON-RPC interface with broad compatibility:

• Standard JSON request/response format
• Native browser support
• Extensive tooling ecosystem
• WebSocket event subscriptions

gRPC API

High-performance binary protocol for demanding applications:

• 5-10x faster serialization with Protocol Buffers
• 70% smaller payloads through binary encoding
• HTTP/2 multiplexing for concurrent requests
• Server streaming for real-time blockchain monitoring

Learn more about gRPC

API Reference

Sui exposes both JSON-RPC and gRPC methods through the reference tree above, covering transaction execution, object queries, balance lookups, event indexing, and validator-system data.

View all JSON-RPC methods

Getting Started

Connection Details

# Mainnet endpoint
https://api-sui-mainnet-full.n.dwellir.com/YOUR_API_KEY

Testnet access is currently provisioned through dedicated nodes. Reach out to our team if you need a Sui testnet endpoint.

Quick Start Example

// Initialize connection
const provider = new JsonRpcProvider(
  'https://api-sui-mainnet-full.n.dwellir.com/YOUR_API_KEY'
);

// Query account balance
const balance = await provider.getBalance({
  owner: '0x...',
  coinType: '0x2::sui::SUI'
});

// Execute a transaction
const result = await provider.executeTransactionBlock({
  transactionBlock: signedTx,
  options: {
    showEffects: true,
    showEvents: true
  }
});

Use Cases

DeFi Applications

Build sophisticated financial protocols leveraging Sui's performance:

• High-frequency trading: Sub-second settlement for optimal execution
• Automated market makers: Efficient liquidity provision with minimal slippage
• Lending protocols: Real-time collateral management and liquidations
• Yield aggregators: Complex multi-protocol strategies

Gaming & NFTs

Create immersive gaming experiences with true digital ownership:

• On-chain gaming: Real-time gameplay with instant state updates
• Dynamic NFTs: Evolving digital assets with programmable attributes
• Gaming economies: Complex in-game economies with tradeable assets
• Metaverse applications: Scalable virtual worlds with millions of objects

Social & Creator Platforms

Develop next-generation social applications:

• Decentralized social: User-owned content and relationships
• Creator monetization: Direct fan engagement without intermediaries
• Content distribution: Efficient media delivery with proof of ownership
• Reputation systems: Portable identity and achievement tracking

Network Specifications

Best Practices

Optimize Performance

• Batch requests: Combine multiple calls for efficiency
• Object caching: Store frequently accessed objects locally
• Event filtering: Use precise filters to reduce data transfer
• Connection pooling: Reuse connections for better throughput

Handle Errors Gracefully

• Implement retries: Automatic retry with exponential backoff
• Monitor rate limits: Track usage to avoid throttling
• Validate inputs: Check object versions and ownership before submission
• Error classification: Distinguish between temporary and permanent failures

Security Considerations

• Secure key management: Never expose private keys in code
• Transaction validation: Verify transaction effects before confirmation
• Input sanitization: Validate all user inputs before processing
• Access control: Implement proper authentication for sensitive operations

Support & Resources

Developer Resources

• API Reference: Complete method documentation with examples
• Integration Guides: Step-by-step tutorials for common use cases
• Code Samples: Production-ready examples in multiple languages
• SDK Support: Official libraries for seamless integration

Get Help

• Email: support@dwellir.com
• Documentation: Comprehensive guides and API references
• Dashboard: dashboard.dwellir.com

Related Reading

• Best Sui RPC Providers 2025

Ready to build on Sui? Get your API key and start developing with Dwellir's enterprise-grade infrastructure today.

Need assistance? Contact our support team for expert guidance on Sui development.