Getting Started

Welcome to Inodra! This guide will help you get up and running with the Sui blockchain infrastructure platform in just a few minutes.

Prerequisites

• A basic understanding of blockchain concepts
• Familiarity with API usage
• A development environment set up for your preferred programming language

Step 1: Create Your Account

1. Visit inodra.com
2. Sign up for a free account
3. Verify your email address
4. Complete your profile setup

Step 2: Set Up Your Organization

Organizations help you manage API keys, team members, and billing:

1. Navigate to the Organization section in your dashboard
2. Create a new organization or join an existing one
3. Invite team members if needed

Step 3: Create a Project

Projects organize your resources by Sui network:

1. A default Mainnet project is created automatically
2. Go to Projects in your dashboard to create additional projects
3. Select the network (Mainnet or Testnet) for each project
4. Use separate projects for development vs production

Learn more about Projects and how to organize your resources.

Step 4: Generate Your First API Key

API keys are required to access all Inodra services:

1. Go to the API Keys section in your dashboard
2. Select your project from the dropdown
3. Click "Generate New Key"
4. Provide a descriptive name (e.g., "Development Key")
5. Choose an expiration date or set it to never expire
6. Copy and securely store your API key

⚠️ Important: Your API key will only be shown once. Make sure to copy it to a secure location immediately.

Note: API keys are project-specific and will only work with endpoints for that project's network.

🚀 Don't have an account yet? Sign up free - it takes less than a minute.

Step 5: Make Your First Request

Test your setup with a simple API call:

curl -X POST https://mainnet-api.inodra.com/v1/jsonrpc \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "sui_getLatestCheckpointSequenceNumber",
    "params": []
  }'

Replace YOUR_API_KEY with the API key you generated in Step 4.

Step 6: Choose Your Integration Method

Inodra offers multiple ways to interact with the Sui blockchain:

JSON-RPC Gateway

Perfect for existing Sui applications that use RPC calls.

const response = await fetch('https://mainnet-api.inodra.com/v1/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'sui_getLatestCheckpointSequenceNumber',
    params: []
  })
})

GraphQL Gateway

Ideal for flexible data querying with a single endpoint.

const query = `
  query {
    checkpoints(first: 10) {
      nodes {
        sequenceNumber
        timestamp
        networkTotalTransactions
      }
    }
  }
`

const response = await fetch('https://mainnet-api.inodra.com/v1/graphql', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY'
  },
  body: JSON.stringify({ query })
})

gRPC Gateway

High-performance option for applications requiring low latency. See the gRPC Gateway documentation for setup instructions and the migration guide if you're transitioning from JSON-RPC.

# Get the latest checkpoint (server reflection enabled - no proto files needed)
grpcurl -H "x-api-key: YOUR_API_KEY" \
  -d '{}' \
  mainnet-grpc.inodra.com:443 \
  sui.rpc.v2.LedgerService/GetCheckpoint

🔜 Official SDKs Coming Soon

We're building official SDKs to make integration even easier:

• TypeScript/JavaScript - Full-featured client library
• Python - Async-ready Python client
• Go - High-performance Go library
• Rust - Native Rust implementation

For now, use our gateways directly with standard HTTP clients.

Next Steps

Now that you have your API key set up, explore these resources:

• API Reference - Complete documentation for every gateway, in your browser
• API Reference - Complete documentation of all available methods
• Webhooks - Set up webhook notifications for blockchain events
• Pricing and Plans - View our subscription tiers and features
• Status Page - Check real-time service status and uptime

Need Help?

• Check our FAQ for common questions
• Having issues? See our Troubleshooting Guide for solutions to common problems
• Join our Discord community for support
• Contact our support team at [email protected]

Ready to build something amazing? Let's go! 🚀