Kaia

Kaia

Authentication

All requests to TheRPC API require authentication using an API key. This guide explains how to obtain and use your API key securely.

# Getting an API Key

1. Sign up at TheRPC.io
2. Navigate to the Dashboard
3. Go to API Keys section
4. Generate a new API key

# Using Your API Key

HTTP Headers

Include your API key in every request using the Bearer authentication scheme:

1Authorization: Bearer YOUR_API_KEY

Example Requests

Using curl:

1curl --request POST 'YOUR_API_ENDPOINT' \
2  --header 'Content-Type: application/json' \
3  --header 'Authorization: Bearer YOUR_API_KEY' \
4  --data '{
5    "jsonrpc": "2.0",
6    "method": "eth_blockNumber",
7    "params": [],
8    "id": 1
9  }'

Using JavaScript:

1const response = await fetch('YOUR_API_ENDPOINT', {
2	method: 'POST',
3	headers: {
4		'Content-Type': 'application/json',
5		Authorization: `Bearer ${API_KEY}`,
6	},
7	body: JSON.stringify({
8		jsonrpc: '2.0',
9		method: 'eth_blockNumber',
10		params: [],
11		id: 1,
12	}),
13});

# Security Best Practices

1. Keep Keys Secret

• Never commit API keys to source control
• Don't share keys in public forums
• Use environment variables or secure vaults

2. Key Rotation

• Rotate keys periodically
• Immediately revoke compromised keys
• Use different keys for different environments

3. Access Control

• Use separate keys for different applications
• Monitor key usage through dashboard
• Implement proper key management

# Error Handling

Common authentication errors:

1{
2	"jsonrpc": "2.0",
3	"error": {
4		"code": -32001,
5		"message": "Invalid authentication credentials"
6	},
7	"id": 1
8}

• Missing API key
• Invalid API key format
• Expired or revoked key
• Rate limit exceeded

# Environment Setup

Environment Variables

1# .env file
2THERPC_API_KEY=your_api_key_here

Configuration Examples

Node.js:

1require('dotenv').config();
2const API_KEY = process.env.THERPC_API_KEY;

Python:

1import os
2from dotenv import load_dotenv
3 
4load_dotenv()
5API_KEY = os.getenv('THERPC_API_KEY')

See also

• Rate Limits - Understand Usage Quotas
• Quick Start Guide - Basic Implementation
• Basic Operations - Common Operations
• FAQ - Common Questions and Answers