@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