我们如何为 Marketplace 合作伙伴代理 RPC 请求
- QuickNode
- 发布于 2025-05-07 19:15
- 阅读 215
本文档面向QuickNode插件开发者，介绍了QuickNode如何为每个客户创建唯一的ID（Sha256哈希），并在插件的provisioning过程中共享此ID。
概述
如果你正在构建一个使用 JSON-RPC 方法的 QuickNode 插件，那么本指南适合你。在本文中，我们将介绍 QuickNode 如何创建和共享用于计费的标识符，以及在插件的给定 RPC 方法的请求/响应周期中，如何使用这些 ID。
了解 QuickNode ID
我们为 QuickNode 上的每个客户创建一个唯一的 ID，其形式为 Sha256 哈希。在插件配置过程中，我们会与你共享此 ID，以便你可以存储哪些客户应该获得你提供的哪些服务的访问权限。它会在配置、更新和取消配置的 payload 中传递过来，如 市场合作伙伴的配置工作原理 一文中所述。
该 ID 对于客户是唯一的，客户可能多次安装你的插件，这些插件按账户计费。
请求/响应生命周期
我们创建了一个方便你的图表，如下所示，但是当请求进入 QuickNode 基础设施时，我们对 RPC 插件的处理方式如下（从高层角度看）：
- 客户发送带有 RPC 方法的请求。
- QuickNode 发送带有自定义 header 的 JSON-RPC 请求，其中包含 quicknode id。
- 合作伙伴验证客户是否有权发出请求，处理请求并返回响应。
- QuickNode 将合作伙伴响应捆绑到适当的 slot 中，以返回给客户。
作为合作伙伴，你应该专注于确认客户的插件是否仍然处于活动状态，然后尽快处理响应。QuickNode 将强制执行插件计划的每秒请求数限制 (RPS Limit) 和客户的每月请求数限制，如果你已经设置了这些限制。
| 你设置的条件 | QuickNode 执行 |
|---|---|
| 同时设置了 RPS 限制和每月限制 | 同时执行这两个限制 |
| 仅设置了 RPS 限制 | 仅执行 RPS 限制 |
| 仅设置了每月请求数限制 | 仅执行每月请求数限制 |
| 未设置任何限制 | 不执行任何限制 |
考虑到这一点，我们将专门研究我们发送的自定义 header。
Headers
每当我们向你的上游发送请求时，你绝对应该检查这个 header：
X-QUICKNODE-ID: 969d539bf782b561aeff148b2a94cc3705720f3d38e147e475912e53b4e96a85注意 - 任何在 header 中包含 X-QN-TESTING 的传入请求都来自 QuickNode 开发团队或测试工具。
这个 ID 代表一个单一的付费客户，你应该在我们发送配置请求时将其存储在你的数据库中。
我们还将发送一个 `X-INSTANCE-ID` header，它代表端点的 id。
你还可以期望在 `X-QN-CHAIN` header 中找到链 (以下之一)：
algorand
aptos
arbitrum
arbitrum-nova
avalanche
base
bitcoin
bnb-smart-chain
celo
ethereum
fantom
flow
gnosis
harmony
near
optimistic-ethereum
optimistic-ethereum
palm
polkadot
polygon
polygon-zkevm
scroll
solana
stacks
stellar
tron
xrp-ledger
zksync最后，我们还在 `X-QN-NETWORK` header 中发送网络 (以下之一):
algorand-betanet
algorand-mainnet
algorand-testnet
aptos-mainnet
aptos-testnet
arbitrum-goerli
arbitrum-mainnet
arbitrum-testnet
avalanche-mainnet
avalanche-testnet
base-goerli
base-mainnet
base-sepolia
bsc
bsc-testnet
btc
btc-testnet
celo-mainnet
dot-mainnet
ethereum-goerli
fantom
flow-mainnet
flow-testnet
harmony-mainnet
harmony-testnet
kovan
mainnet
matic
matic-testnet
near-mainnet
near-testnet
nova-mainnet
optimism
optimism
optimism-goerli
optimism-kovan
optimism-sepolia
palm-mainnet
palm-testnet
rinkeby
ropsten
scroll-mainnet
scroll-testnet
solana-devnet
solana-mainnet
solana-testnet
stacks-mainnet
stacks-testnet
stellar-mainnet
stellar-testnet
tron-mainnet
xdai
xrp-mainnet
xrp-testnet
zkevm-mainnet
zkevm-testnet
zksync-mainnet
zksync-sepolia
zksync-testnet就是这样！ 如果你有任何问题，请与我们联系。
订阅我们的 时事通讯 以获取更多关于 Web3 和区块链的文章和指南。 如果你有任何问题或需要进一步的帮助，请随时加入我们的 Discord 服务器或使用下面的表格提供反馈。 通过在 Twitter (@QuickNode) 和我们的 Telegram 公告频道 上关注我们来了解最新信息。
我们 ❤️ 反馈！
如果你有任何反馈或新主题的请求，请告诉我们。 我们很乐意听取你的意见。
- 原文链接： quicknode.com/guides/mar...
- 登链社区 AI 助手，为大家转译优秀英文文章，如有翻译不通的地方，还请包涵～
