개요

Quicknode MPP(Machine Payments Protocol) Quicknode 지원되는 모든 네트워크에 걸쳐 블록체인 엔드포인트에 대한 요청당 과금 방식의 액세스를 Quicknode . MPP는 Tempo Stripe가 개발한 개방형 프로토콜로, IETF 인터넷 초안( Internet-Draft)으로 제출되었으며, 표준 HTTP 인증 헤더를 통해 기계 간 스테이블코인 소액 결제를 가능하게 합니다.

지갑을 agent 모든 애플리케이션이나 AI agent 즉시 RPC 호출을 시작할 수 있습니다. 계정, API 키 또는 구독이 필요하지 않습니다.

MPP는 추가형 액세스 방식입니다. 이는 Quicknode 표준 요금제를 대체하지 않습니다. 프로덕션 워크로드를 운영하는 팀은 SLA, 전용 지원, 더 높은 요청 한도가 제공되는 표준 요금제의 혜택을 누릴 수 있습니다. MPP는 AI agents, 신속한 프로토타이핑, 그리고 허가 없이 요청 단위로 액세스하는 것이 우선시되는 사용 사례를 위해 설계되었습니다.

요약

• MPP는 두 가지 방식으로 사용할 수 있습니다. 하나는 잔액이 충전된 지갑을 사용하고 계정이 없는 상태에서 일회성 RPC 호출을 하는 방식(이 페이지에서 다루고 있음)이고, 다른 하나는 Agent 결제하여 Quicknode 생성하고 전체 제품군을 이용할 수 있는 플랫폼 API 키를 받는 방식입니다.
• 두 가지 일회성 과금 방식: Charge(요청당 $0.001, 호출당 온체인 정산 1회) 및 Session(요청당 $0.00001, 에스크로 예치금 및 일괄 오프체인 바우처 정산)
• 설치 mppx, 이는 다음을 폴리필합니다 가져오기 402 응답을 가로채고 결제 협상을 자동으로 처리하기 위해

정보

Quicknode 의 MPP는 현재 알파 단계에 Quicknode .

# Fetch machine-readable MPP documentation for AI agents
curl https://mpp.quicknode.com/llms.txt

빠른 시작

다음 항목을 설치하십시오. mppx 패키지:

npm 설치 mppx viem

이 예제에서는 PathUSD와 함께 Tempo 방식을 사용합니다. 요청을 보내기 전에 지갑에 자금을 충전해 주세요.

import { Mppx, tempo } from 'mppx/client'
import { privateKeyToAccount } from 'viem/accounts'

const account = privateKeyToAccount(process.env.PRIVATE_KEY as `0x${string}`)

// Polyfills globalThis.fetch to handle 402 challenges automatically
Mppx.create({
  methods: [tempo({ account })],
})

// Replace /tempo-mainnet with any supported network slug
const response = await fetch('https://mpp.quicknode.com/tempo-mainnet', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'eth_blockNumber',
    params: [],
  }),
})

const { result } = await response.json()
console.log('Block number:', BigInt(result))

폴리필이 활성화된 상태에서, 표준 가져오기 호출은 결제 협상을 자동으로 처리합니다. 클라이언트는 402 응답을 감지하면 필요한 결제에 서명하고 요청을 재시도합니다. 결제 방식은 쿼리하는 체인과 무관하므로, 다음을 mainnet URL에 아무 것이나 지원되는 네트워크 다른 체인을 호출하기 위한 슬러그.

다른 설정 옵션을 찾고 계신가요?

다음의 mppx CLI 터미널에서 직접 유료 RPC 호출을 수행하려면. 대신 Solana 결제하는 방법은 다음을 참조하세요. Solana.

지원되는 프로토콜

MPP 엔드포인트는 다음 프로토콜을 지원합니다:

• JSON-RPC
• REST

가격

MPP는 결제 구조를 결정하는 두 가지 청구 방식(인텐트)을 지원합니다:

	요금	세션
요청당 비용	$0.001	$0.00001 (요청 100만 건당 $10)
Endpoint	POST /:network/*	POST /session/:network/*
정산	요청당 온체인 거래 1건	오프체인 바우처, 온체인 일괄 정산
다음에 가장 적합합니다	간편한 연동, 소량 처리	대용량, agents, 계량형 사용

의도 유형

요금

결제 의도는 가장 간단한 방식입니다. 각 요청은 단일 온체인 결제를 유발합니다. 세션 상태도, 에스크로도, 설정 과정도 없습니다. 이 mppx SDK 402 챌린지와 결제 서명 처리를 자동으로 SDK .

세션

세션 인텐트는 빈번한 액세스를 위해 결제 채널을 사용합니다. flow 다음과 같습니다.

1. 고객은 에스크로 계약에 자금을 예치합니다(초기 설정에 약 500ms 소요).
2. 이후의 각 요청은 온체인 트랜잭션 대신 누적된 EIP-712 서명 바우처를 전송합니다.
3. 서버는 각 바우처를 단일 ecrecover 호출 시, RPC나 데이터베이스 조회 과정이 필요하지 않습니다.
4. 서버는 자체 일정에 따라 채널을 종료하며, 온체인에서 일괄적으로 정산합니다.
5. 채널이 종료되면 예치금 중 미사용 금액이 환불됩니다.

import { Mppx, tempo } from 'mppx/client'
import { privateKeyToAccount } from 'viem/accounts'

const account = privateKeyToAccount(process.env.PRIVATE_KEY as `0x${string}`)

// Session-only — payment channels for 100x cheaper requests
Mppx.create({
  methods: [tempo.session({ account })],
})

// First request opens channel on-chain (~500ms),
// subsequent requests use off-chain vouchers (microseconds)
// Replace /tempo-mainnet with any supported network slug
const response = await fetch('https://mpp.quicknode.com/session/tempo-mainnet', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'eth_blockNumber',
    params: [],
  }),
})

console.log(await response.json())

지원되는 결제 네트워크

다음 네트워크에서는 스테이블코인 결제가 가능합니다:

네트워크	토큰
Tempo Testnet 체인 42431)	PathUSD
Tempo Mainnet 체인 4217)	PathUSD / USDC.e
Solana Mainnet	USDC

결제 네트워크는 쿼리하는 체인과 무관합니다. 예를 들어, Tempo PathUSD로 Tempo Ethereum, Solana 또는 기타 지원되는 체인을 쿼리할 수 있습니다.

무료 요금제

각 지갑에는 MPP 및 x402 포함한 Quicknode 에이전트 기반 결제 인터페이스 전반에 걸쳐 월 1,000,000 API 크레딧의 무료 할당량이 제공됩니다. RPC 요청은 건당 1 API 크레딧을 소모하는 반면, SQL Explorer는 쿼리에 사용된 만큼의 API 크레딧을 소모합니다. 이 할당량은 매월 1일에 초기화되며, 무료 할당량이 소진된 후에는 해당 모델별 요율에 따라 유료 사용이 계속됩니다.

Solana

Solana 통합의 경우, 다음을 사용하십시오. solana 패키지:

npm 설치solana mppxsolana.jssolana

import { Mppx, solana } from 'solana-mpp/client'
import { Keypair } from '@solana/web3.js'

const keypair = Keypair.generate()

Mppx.create({ methods: [solana({ wallet: keypair })] })

// Replace /solana-mainnet with any supported network slug
const response = await fetch('https://mpp.quicknode.com/solana-mainnet', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'getSlot',
    params: [],
  }),
})

const { result } = await response.json()
console.log('Slot:', result)

CLI

그 mppx CLI를 사용하면 터미널에서 직접 유료 RPC 호출을 수행할 수 있습니다:

npm install -g mppx

# Create a wallet (stored in keychain)
mppx account create

# Charge intent — $0.001/request (replace /tempo-mainnet with any supported network)
mppx -X POST -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}' \
  https://mpp.quicknode.com/tempo-mainnet

# Session intent — $0.00001/request (replace /session/tempo-mainnet accordingly)
mppx -X POST -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}' \
  https://mpp.quicknode.com/session/tempo-mainnet

요청 제한

MPP 엔드포인트는 IP:네트워크 조합당 10초마다 1,000건의 요청으로 요청 수가 제한됩니다.

지급 영수증

성공적인 응답에는 항상 다음이 포함됩니다. 지급-수령 헤더. 다음을 사용하여 이를 파싱할 수 있습니다. mppx SDK:

import { Receipt } from 'mppx'

const receipt = Receipt.fromResponse(response)
console.log(receipt.status)    // "success"
console.log(receipt.reference) // tx hash (charge) or channelId (session)

작동 원리

그 mppx SDK 전체 결제 flow SDK . 내부적으로는 각 요청이 다음과 같은 순서로 진행됩니다:

1. 요청을 보내세요. 다음 주소로 JSON-RPC 또는 REST 호출을 POST하세요. https://mpp.quicknode.com/:network (요금) 또는 https://mpp.quicknode.com/session/:network (세션).
2. 결제 관련 문제가 발생했습니다. 서버는 HTTP 402 응답과 함께 WWW-Authenticate: 결제 결제 수단, 결제 목적, 금액 및 수취인이 포함된 헤더.
3. 서명하고 다시 시도하세요. 클라이언트는 토큰 전송에 서명한 후, 다음을 사용하여 요청을 다시 시도합니다. 승인: 결제 결제 인증 정보를 포함하는 헤더.
4. 응답을 수신합니다. 서버는 결제를 처리하고, RPC 요청을 중계한 뒤, 결과를 지급-수령 트랜잭션 참조 번호가 포함된 헤더.

# Challenge (server → client, on 402)
WWW-Authenticate: Payment id="...", realm="mpp.quicknode.com",
  method="tempo", intent="charge", request="<base64url JSON>"

# Credential (client → server)
Authorization: Payment <credential>

# Receipt (server → client, on success)
Payment-Receipt: <receipt>

MPP 대 표준 Quicknode

	MPP	표준 요금제
인증	지갑 기반 (HTTP 결제 인증)	계정 기반 (API 키)
청구	요청당 지불 (스테이블코인)	월간/연간 구독
설정이 필요합니다	지갑 + 스테이블코인	계정 + API 키
상태	알파	생산용 SLA
다음에 가장 적합합니다	Agents, 프로토타이핑, 허가 없는 접근	팀, 프로덕션 워크로드

자료

mppx SDK

SDK 공식 TypeScript SDK

→

solana

MPP용 Solana 수단

→

MPP 문서

MPP 프로토콜 전체 문서

→

IETF 인터넷 초안

HTTP 결제 인증 방식 사양

→

Tempo 방법

Tempo 결제 방식 관련 문서

→

mppx CLI 참조

터미널에서 MPP 결제를 처리하기 위한 CLI 도구

→

팁

For managing Quicknode infrastructure through natural language, see Quicknode MCP. To help AI coding agents plan, build, and improve Web3 apps with accurate Quicknode product knowledge, see the Build Web3 plugin. For the x402 payment protocol, see x402 Payments.