Solana의 Machine Payments Protocol

Machine Payments Protocol(MPP)은 HTTP 인증 방식을 결제에 적용합니다. 서버는 결제되지 않은 요청에 챌린지를 보내고, 클라이언트는 결제 자격 증명을 반환하며, 서버는 결제를 수락한 후 영수증을 반환합니다.

MPP는 세 가지 관심사를 분리합니다.

• **인텐트(intent)**는 일회성 charge 또는 사용량 기반 session과 같은 상거래 상호작용을 설명합니다.
• **결제 방식(payment method)**은 가치가 이동하는 방법을 설명합니다. Solana 방식은 charge에 대해 네이티브 SOL과 SPL 토큰을 지원합니다.
• HTTP **트랜스포트(transport)**는 챌린지, 자격 증명, 영수증, 오류를 전달합니다.

MPP는 인터넷 드래프트(Internet-Draft) 모음으로 게시됩니다. 최신 사양을 기준 문서로 삼고, 드래프트가 작업 중인 동안에는 세부 사항이 변경될 수 있음을 염두에 두세요.

HTTP 교환

MPP는 프로토콜 전용 결제 헤더 대신 표준 HTTP 인증 필드를 사용합니다.

챌린지에는 서버가 생성한 ID, realm, 방식, 인텐트, 인코딩된 결제 요청, 만료 시간이 포함됩니다. 자격 증명은 챌린지를 그대로 되돌려 보내고 방식별 결제 증명을 추가합니다. 서버는 두 가지를 모두 검증해야 하며, 다른 챌린지에 속한 유효한 전송으로는 리소스에 대한 접근을 허용해서는 안 됩니다.

Solana 일회성 결제

Solana charge 인텐트는 두 가지 자격 증명 유형을 지원합니다.

• **풀 모드(Pull mode)**는 서명된 트랜잭션을 사용합니다. 클라이언트가 전송에 서명하고 트랜잭션을 서버로 보냅니다. 서버는 이를 검증하고, 필요하면 수수료 지불자 서명을 추가한 뒤 브로드캐스트하고 확인하며, 영수증에 트랜잭션 서명을 담아 반환합니다.
• **푸시 모드(Push mode)**는 트랜잭션 서명을 사용합니다. 클라이언트가 먼저 브로드캐스트한 후 확인된 서명을 서버로 보냅니다. 서버는 리소스를 반환하기 전에 트랜잭션을 가져와 검증합니다.

풀 모드는 서버가 트랜잭션 수수료를 대신 부담하는 방식과 서버 측 재시도 로직을 사용할 수 있게 해줍니다. 푸시 모드는 지갑이 클라이언트가 직접 트랜잭션을 제출하도록 요구할 때 유용하지만, 서버의 수수료 대납은 사용할 수 없습니다.

규범적 필드와 검증 규칙은 Solana charge 사양을 참고하세요.

Express API에 MPP 결제 추가하기

Solana Pay Kit는 MPP와 x402를 위한 최신 TypeScript 통합을 제공합니다. Express와 함께 설치하세요.

pnpm add @solana/pay-kit @solana/kit@^6.9.0 express
pnpm add --save-dev @types/express tsx

이 가장 간단한 예제는 호스팅된 Surfpool 샌드박스와 패키지의 공개 데모 수신자를 사용합니다. 로컬 개발용으로만 사용하세요.

import express from "express";
import { createPayKit, usd } from "@solana/pay-kit";

const pay = await createPayKit({
  accept: ["mpp"],
  rpcUrl: "https://402.surfnet.dev:8899"
});

const app = express();

app.get("/report", pay.express(usd("0.01")), (_req, res) => {
  res.json({ report: "Paid report" });
});

app.listen(4567, () => {
  console.log("Paid API listening on http://127.0.0.1:4567");
});

실행한 다음, 결제되지 않은 요청과 결제를 인식하는 요청을 비교해 보세요.

pnpm tsx server.ts
curl -i http://127.0.0.1:4567/report
pay --sandbox curl http://127.0.0.1:4567/report

라우트 핸들러는 미들웨어가 결제를 수락한 후에만 실행됩니다.

사용량 기반 세션

클라이언트가 관련된 소액 결제를 여러 번 수행할 때는 Solana MPP session을 사용하세요. 세션은 최대 예치금이 설정된 온체인 결제 채널을 열고, 사용량이 늘어남에 따라 누적 서명된 바우처를 사용합니다. 서버는 바우처를 오프체인에서 검증하고, 수락된 최고 금액을 나중에 정산할 수 있습니다.

이 방식은 토큰 단위 과금 추론, 바이트 단위 과금 다운로드, 실시간 데이터, 반복적인 도구 호출에 유용합니다. 모든 이벤트마다 별도의 온체인 결제를 전송하는 것과는 다릅니다.

세션은 세션 결제, 결제 채널, 또는 한도가 있는 반복 승인이라고 부르세요. 서비스와 결제 계약이 실제로 사용량 스트림을 측정하는 경우에만 스트리밍 결제라고 부르세요.

프로덕션 검증

모든 Solana 결제에 대해 서버는 최소한 다음을 검증해야 합니다.

• 챌린지가 진본이고, 만료되지 않았으며, 이 요청에 바인딩되어 있고, 이 realm을 대상으로 한다.
• 트랜잭션이 예상된 네트워크, 자산 또는 민트, 수신자, 금액, Token Program을 사용한다.
• 모든 수수료 지불자 또는 associated token account 인스트럭션이 명시적으로 허용되어 있으며 서버 서명자의 자금을 빼낼 수 없다.
• 트랜잭션이 요구되는 커밋먼트 수준에서 성공했다.
• 트랜잭션 서명이 이미 사용된 적이 없다.
• 리플레이 확인과 소비 작업이 모든 서버 인스턴스에서 원자적으로 이루어진다.

세션의 경우 채널 상태, 수락된 누적 금액, 정산 워터마크도 공유 저장소에 영구 보관하세요. 서버를 사용할 수 없게 되었을 때 클라이언트가 사용하지 않은 자금을 회수하는 방법을 문서화하세요.

관련 리소스

• MPP 사양
• MPP 프로토콜 문서
• Solana Pay Kit
• 에이전트 결제 개요
• 프로덕션 준비 상태