solana-developer-platform: Skill for Claude Code

Register a ramp provider

Build the smallest honest skeleton for the capabilities the provider supports. Registration spans three ownership boundaries:

• packages/sdp-payments: HTTP adapter and normalized ramp contract.
• apps/sdp-api: auth, policy gates, DB orchestration, provider availability, schemas, and webhooks.
• packages/sdp-types / apps/sdp-web: shared public shapes and provider presentation.

1. Add the closed provider id

Add the lowercase id to RAMP_PROVIDERS in packages/sdp-types/src/provider-access.ts. GENERAL_PROVIDER_DEFAULTS.ramps currently enables every registered ramp for every organization; availability still fails closed when deployment credentials are absent. Registration is therefore a launch decision, not a hidden stub. Do not add the id until the implemented capability is safe to surface.

Run these immediately and follow every exhaustive error:

pnpm --filter @sdp/payments typecheck
pnpm --filter @sdp/api typecheck
pnpm --filter sdp-web typecheck

The compiler is only part of the checklist; Zod unions, translations, and ordered UI lists may not fail automatically.

2. Add the package adapter

Create packages/sdp-payments/src/ramps/providers/<id>/client.ts and export/register it in packages/sdp-payments/src/ramps/index.ts:

export class <Id>RampClient implements RampProvider {
  readonly id = "<id>";
  readonly declaredRailSupport = <ID>_DECLARED_RAIL_SUPPORT;
  // Implement the methods required by packages/sdp-payments/src/ramps/types.ts.
}

RampProvider currently requires both estimates, rail discovery/distillation, counterparty validation, and an off-ramp method. An unsupported direction must use empty declared/discovered support plus a typed unsupported requirement or payments error; it must not pretend to work. createOnrampQuote and listExternalAccountDetails are optional — implement the latter when the provider JIT-creates external accounts, so the provider-accounts list endpoint and the offramp payout tree can show display info (bankName, masked accountNumberLast4; fetched per request, never persisted).