速率限制和配额

本指南解释了 TheRPC 的速率限制系统，并提供管理 API 使用的最佳实践。

# 请求限制

速率限制应用于多个层面：

每秒请求数
每分钟请求数
每天请求数
并发连接数

具体限制取决于您的订阅计划。查看您的控制面板了解当前限制。

# 错误响应

当您超出速率限制时，您将收到：

{
	"jsonrpc": "2.0",
	"error": {
		"code": -32029,
		"message": "Rate limit exceeded"
	},
	"id": 1
}

HTTP 响应将包含以下头信息：

X-RateLimit-Limit: 10
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1628696400

# 最佳实践

实施重试

async function callWithRetry(method, params, maxRetries = 3) {
	for (let i = 0; i < maxRetries; i++) {
		try {
			const response = await makeRequest(method, params);
			return response;
		} catch (error) {
			if (error.code === -32029) {
				// 超出速率限制
				const backoffTime = Math.pow(2, i) * 1000;
				await new Promise((resolve) => setTimeout(resolve, backoffTime));
				continue;
			}
			throw error;
		}
	}
	throw new Error('Max retries exceeded');
}

批量请求

将多个调用合并为单个请求：

[
	{
		"jsonrpc": "2.0",
		"method": "eth_getBalance",
		"params": ["0x742d35Cc6634C0532925a3b844Bc454e4438f44e", "latest"],
		"id": 1
	},
	{
		"jsonrpc": "2.0",
		"method": "eth_blockNumber",
		"params": [],
		"id": 2
	}
]

使用 WebSocket 订阅

对于实时数据，使用 eth_subscribe 而不是轮询。

# 监控

通过以下方式监控您的使用情况：

控制面板指标
速率限制头信息
使用警报

# 配额管理

跟踪使用情况

function trackApiUsage(response) {
	const limits = {
		limit: response.headers['X-RateLimit-Limit'],
		remaining: response.headers['X-RateLimit-Remaining'],
		reset: response.headers['X-RateLimit-Reset'],
	};

	// 记录或监控使用情况
	console.log(`API 调用剩余: ${limits.remaining}/${limits.limit}`);
}

实施缓存

const cache = new Map();

async function getCachedBlockNumber(cacheTime = 5000) {
	const cached = cache.get('blockNumber');
	if (cached && Date.now() - cached.timestamp < cacheTime) {
		return cached.value;
	}

	const newValue = await web3.eth.getBlockNumber();
	cache.set('blockNumber', {
		value: newValue,
		timestamp: Date.now(),
	});

	return newValue;
}