本文档面向QuickNode插件开发者,介绍了QuickNode如何为每个客户创建唯一的ID(Sha256哈希),并在插件的provisioning过程中共享此ID。
如果你正在构建一个使用 JSON-RPC 方法的 QuickNode 插件,那么本指南适合你。在本文中,我们将介绍 QuickNode 如何创建和共享用于计费的标识符,以及在插件的给定 RPC 方法的请求/响应周期中,如何使用这些 ID。
我们为 QuickNode 上的每个客户创建一个唯一的 ID,其形式为 Sha256 哈希。在插件配置过程中,我们会与你共享此 ID,以便你可以存储哪些客户应该获得你提供的哪些服务的访问权限。它会在配置、更新和取消配置的 payload 中传递过来,如 市场合作伙伴的配置工作原理 一文中所述。
该 ID 对于客户是唯一的,客户可能多次安装你的插件,这些插件按账户计费。
我们创建了一个方便你的图表,如下所示,但是当请求进入 QuickNode 基础设施时,我们对 RPC 插件的处理方式如下(从高层角度看):
作为合作伙伴,你应该专注于确认客户的插件是否仍然处于活动状态,然后尽快处理响应。QuickNode 将强制执行插件计划的每秒请求数限制 (RPS Limit) 和客户的每月请求数限制,如果你已经设置了这些限制。
你设置的条件 | QuickNode 执行 |
---|---|
同时设置了 RPS 限制和每月限制 | 同时执行这两个限制 |
仅设置了 RPS 限制 | 仅执行 RPS 限制 |
仅设置了每月请求数限制 | 仅执行每月请求数限制 |
未设置任何限制 | 不执行任何限制 |
考虑到这一点,我们将专门研究我们发送的自定义 header。
每当我们向你的上游发送请求时,你绝对应该检查这个 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 助手,为大家转译优秀英文文章,如有翻译不通的地方,还请包涵~
如果觉得我的文章对您有用,请随意打赏。你的支持将鼓励我继续创作!