mppx.validateCredential

Validates a Credential without settling, reserving, or broadcasting payment.

Usage

Use validateCredential before a later broadcastCredential call when your application needs a non-mutating payment check.

import { Mppx, tempo } from 'mppx/server'
 
const mppx = Mppx.create({ methods: [tempo.charge()] })
 
const validation = await mppx.validateCredential('Payment credential="..."', {
  request: {
    amount: '0.10',
    currency: '0x20c0000000000000000000000000000000000000',
    recipient: '0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266',
  },
  scope: 'GET /v1/report',
})
 
console.log(validation.source)

validateCredential is an advisory pre-check. Call broadcastCredential to accept payment.

Return type

type ReturnType = Promise<Method.Validation>

Parameters

capturedRequest (optional)

• Type: Method.CapturedRequest

Authoritative request snapshot used by method hooks.

credential

• Type: string | Credential

Serialized Authorization header value or parsed Credential object.

meta (optional)

• Type: Record<string, string>

Expected Challenge metadata.

realm (optional)

• Type: string

Expected Challenge realm.

request (optional)

• Type: Record<string, unknown>

Expected method request parameters.

scope (optional)

• Type: string

Expected route or resource scope bound to the Challenge.