@suimpp/discovery

Sui-specific discovery validation for MPP servers. Validate OpenAPI documents, check x-payment-info extensions, and probe 402 payment challenges.

CLI

# Full validation — OpenAPI + live 402 probe
npx @suimpp/discovery check mpp.t2000.ai

# List paid endpoints only
npx @suimpp/discovery discover mpp.t2000.ai

# Machine-readable JSON
npx @suimpp/discovery check mpp.t2000.ai --json

Example output

t2000 MPP Gateway v1.0.0
https://mpp.t2000.ai/openapi.json

  Endpoints: 88 total, 88 paid

  POST   /openai/v1/chat/completions  $0.01
  POST   /openai/v1/embeddings        $0.001
  ...

  Discovery
  ✓ OpenAPI valid

  Probe https://mpp.t2000.ai/openai/v1/chat/completions
  ✓ 402 with Sui payment challenge
    Recipient: 0x...
    Currency:  0xdba...::usdc::USDC
    Realm:     mpp.t2000.ai

  ✓ All checks passed

Programmatic Usage

import { check, discover, probe } from '@suimpp/discovery';

// Full validation
const result = await check('mpp.t2000.ai');
console.log(result.ok);              // true
console.log(result.summary.errors);  // 0

// Discovery only (no probe)
const disc = await discover('mpp.t2000.ai');
for (const ep of disc.endpoints) {
  console.log(ep.method, ep.path, ep.paymentInfo.price);
}

// Probe a specific endpoint
const probeResult = await probe(
  'https://mpp.t2000.ai/openai/v1/chat/completions',
  'https://mpp.t2000.ai',
);
console.log(probeResult.hasSuiPayment); // true
console.log(probeResult.recipient);     // 0x...

What it validates

OpenAPI checks

OpenAPI 3.1.x version
x-payment-info on paid operations
protocols includes "mpp"
402 response defined
requestBody on POST/PUT/PATCH
Price format for fixed pricing
x-guidance or x-service-info present
Route count warning (>80)

Probe checks (Sui-specific)

Server returns 402 Payment Required
Payment challenge extractable (body or WWW-Authenticate header)
Recipient is a valid Sui address (0x...)
Currency is recognized Sui USDC type
Realm matches the server's public domain

Validation codes

Code	Severity	Description
`OPENAPI_FETCH_FAILED`	error	Could not fetch `/openapi.json`
`OPENAPI_VERSION_INVALID`	error	Not OpenAPI 3.1.x
`NO_PAID_ENDPOINTS`	error	No operations with `x-payment-info`
`MISSING_402_RESPONSE`	error	Paid operation missing 402 response
`MISSING_REQUEST_BODY`	warning	POST/PUT/PATCH without requestBody
`MISSING_PROTOCOLS`	warning	No protocols field in x-payment-info
`PROTOCOL_NOT_MPP`	error	protocols does not include "mpp"
`MISSING_PRICING`	error	Fixed pricing with no price
`HIGH_ROUTE_COUNT`	warning	>80 paid routes
`PROBE_NOT_402`	error	Endpoint did not return 402
`PROBE_INVALID_RECIPIENT`	error	Not a valid Sui address
`PROBE_UNKNOWN_CURRENCY`	warning	Unrecognized Sui token type
`PROBE_REALM_MISMATCH`	error	Realm doesn't match origin

Testing

pnpm --filter @suimpp/discovery test       # 19 tests
pnpm --filter @suimpp/discovery typecheck

License

MIT