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, request 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's members are function-typed, so an implementation is checked strictly. Every provider has an id, a label (its name in SDP's messages), declared rail support, checkCredentials, rail discovery/distillation, counterparty validation and fetchTransferStatus. A direction the provider runs has both of its members (estimateOnramp + createOnrampQuote, estimateOfframp + createOfframpQuote); a direction it doesn't run has neither, plus empty declared/discovered support and a typed unsupported requirement. supportsRampDirection and rampClientFor read member presence, and the contract suite fails a provider with half a direction. cancelOfframpSale is optional. fetchTransferStatus makes one request per lookup and returns the events the provider's webhook would carry, oldest first, through the package status mapping the webhook parser also calls; an empty answer must mean the provider holds no transaction, never that SDP could not ask.