Frequently Asked Questions

Common questions and answers about using Inodra.

General Questions

What is Inodra?

Inodra is a comprehensive blockchain infrastructure platform designed specifically for Sui developers. We provide multiple ways to interact with the Sui blockchain through REST APIs, JSON-RPC, GraphQL, and gRPC gateways.

How is Inodra different from other blockchain APIs?

• Sui-focused: Built specifically for the Sui ecosystem
• Multiple protocols: Choose the best integration method for your needs
• Indexed + Live data: Fast indexed data with automatic RPC fallback
• Event notifications: Real-time webhooks for blockchain events
• Developer dashboard: Comprehensive tools for API key and team management

Do I need to run my own Sui node?

No! Inodra handles all the infrastructure complexity for you. We maintain high-performance Sui nodes and provide multiple access methods to blockchain data.

Getting Started

How do I get an API key?

1. Sign up at inodra.com
2. Complete email verification
3. Navigate to the API Keys section
4. Click "Generate New Key"
5. Copy and securely store your key

Which gateway should I use?

• REST API: Best for applications needing indexed, structured data
• JSON-RPC: Perfect for existing Sui applications (drop-in replacement)
• GraphQL: Ideal for flexible queries and real-time subscriptions
• gRPC: High-performance option for latency-sensitive applications

Can I use multiple gateways simultaneously?

Yes! You can use the same API key across all gateways. Many developers use different gateways for different use cases within the same application.

Technical Questions

What data is indexed vs. live?

Indexed Data (REST API):

• Transactions, checkpoints, objects, events
• Optimized for filtering, searching, and analytics
• Typically 1-2 seconds behind network

Live Data (JSON-RPC/GraphQL/gRPC):

• Direct node access for latest state
• Real-time transaction execution
• Used automatically as fallback when indexed data isn't available

How does the RPC fallback work?

When our indexed data doesn't have the information you're requesting, our APIs automatically query live Sui nodes to provide comprehensive support. This happens transparently - you don't need to handle fallback logic.

What's the difference between mainnet and testnet?

• Mainnet: Production Sui network with real assets and value
• Testnet: Development network for testing with free test tokens
• Both are fully supported with the same API endpoints

Pricing & Access

What pricing plans are available?

Inodra offers five tiers to match your needs:

Plan	Price	Compute Units	RPS	Best For
Free	$0/month	1M/month	5	Testing and hobby projects
Team	$99/month	10M/month	25	Small teams and growing projects
Professional	$499/month	50M/month	50	Growing applications
Business	$999/month	100M/month	100	Production apps with high volume
Enterprise	Custom	Custom	Custom	Large-scale custom solutions

Annual billing is available with 2 months free (pay for 10 months, get 12).

What's included in each tier?

Free Tier:

• 1M Compute Units/month
• 5 requests per second
• 1 webhook endpoint
• Community support
• Up to 2 team members

Team Tier ($99/month):

• 10M Compute Units/month
• 25 requests per second
• 3 webhook endpoints
• 7-day log retention
• Analytics dashboard
• Email support (24-48h response)
• Up to 5 team members

Professional Tier ($499/month):

• 50M Compute Units/month
• 50 requests per second
• 15 webhook endpoints
• 30-day log retention
• Advanced analytics
• Priority email support (< 8h)
• Up to 10 team members

Business Tier ($999/month):

• 100M Compute Units/month
• 100 requests per second
• 25 webhook endpoints
• 90-day log retention
• Webhook replay on-demand
• Advanced analytics
• Priority support (< 4h)
• Dedicated Slack channel
• Direct engineering access
• Up to 15 team members

Enterprise Tier (Custom):

• Custom Compute Units
• Custom RPS (1000+)
• Unlimited webhook endpoints
• Custom log retention
• All features included
• Dedicated account manager
• SLA guarantee (99.9%)
• Custom integrations
• Unlimited team members

What are Compute Units?

Compute Units (CUs) are a unified measure of API usage that accounts for the computational cost of different operations. Simple queries use fewer CUs, while complex operations use more. This ensures fair pricing based on actual resource consumption.

How do I upgrade my plan?

You can upgrade your plan at any time through the dashboard billing page. When upgrading:

• Your new limits take effect immediately
• You'll be charged a prorated amount for the remainder of your billing period

Is there a free trial for paid plans?

The Free tier is available indefinitely for testing and small projects. For paid plans, contact our sales team to discuss trial options for your specific use case.

Authentication & Security

How do I authenticate API requests?

Include your API key in the x-api-key header:

curl -H "x-api-key: YOUR_API_KEY" https://api.inodra.com/v1/checkpoints

Are API keys secure?

• API keys are encrypted in transit and at rest
• Keys can be rotated anytime through the dashboard
• Set expiration dates for additional security
• Monitor key usage for suspicious activity

Can I restrict API key permissions?

Currently, API keys provide full access to your organization's quota. Granular permissions are coming soon. Use separate organizations for different access levels.

Webhooks & Events

How do webhook notifications work?

1. Configure webhook endpoints in your dashboard
2. Select event types and filters
3. Inodra sends HTTP POST requests to your endpoint
4. Process events in your application

What events can I track?

• Transaction confirmations and status changes
• Balance and ownership updates
• Object creation, modification, deletion
• Smart contract events and function calls
• Custom filters by address, object type, or package

How reliable are webhook deliveries?

• Multiple retry attempts with exponential backoff
• 10-second timeout per delivery attempt
• Delivery status tracking in the dashboard

Troubleshooting

I'm getting 401 Unauthorized errors

• Check that your API key is correct
• Ensure the key hasn't expired
• Verify the x-api-key header is properly set
• Check that your organization has active billing

I'm sending a lot of requests

• Implement exponential backoff retry logic
• Use batch operations when possible
• Cache frequently accessed data

My webhook isn't receiving events

• Verify your endpoint is publicly accessible
• Check that it responds with HTTP 200 status
• Ensure it handles POST requests with JSON payload
• Review webhook logs in the dashboard
• Test with webhook signature validation disabled temporarily

API responses are slow

• Use the appropriate gateway for your use case
• Implement response caching for frequently accessed data
• Use pagination to limit response sizes
• Check our status page for any service issues

Data & Coverage

How fresh is the indexed data?

Indexed data is typically 1-2 seconds behind the live network. For the absolute latest state, use JSON-RPC methods which query live nodes.

Can I query historical data?

Yes, our indexed APIs provide complete historical data from genesis. Use checkpoint ranges, timestamp filters, or sequence numbers to query specific time periods.

Support

How can I get help?

• Check this FAQ for common issues
• Review our comprehensive documentation
• Join our Discord community
• Contact support at [email protected]

Do you provide technical support?

• Community support via Discord and documentation

Can you help with integration?

Yes! Our team can provide:

• Architecture review and recommendations
• Code review and optimization suggestions
• Custom integration assistance for enterprise customers
• Training sessions for development teams

Still have questions? Don't hesitate to contact our support team - we're here to help!