solana-developer-platform: Skill for Claude Code

Integrate off-ramp

Off-ramp = a counterparty sells crypto from an SDP wallet for fiat paid to a payout account. Implement createOfframpQuote and add a branch to the API dispatch. There is no executeOfframp method in the current provider contract.

createOfframpQuote is required on RampProvider (unlike createOnrampQuote, which is optional) — even a provider that doesn't support off-ramp must implement it; the dispatch case for that provider can throw instead of calling it (several registered providers do exactly that today rather than reaching the client method).

Choose the closest package client under packages/sdp-payments/src/ramps/providers/ by delivery mode: manual instructions with payout provisioning, a hosted widget, or a session widget.

Contract

Read the current RampOfframpQuoteInput from packages/sdp-payments/src/ramps/types.ts. The handler resolves the SDP wallet address, counterparty, provider customer/account ids, and any caller-defined transfer reference before calling the package client.

Output PaymentRampQuote is closed by provider and deliveryMode; add the provider quote/instruction arm in packages/sdp-types/src/payments.ts as described by integrate-onramp.

Two off-ramp-specific resolutions (handler-side)

1. Source wallet. The shared policy extraction resolves sourceWallet to an SDP wallet/address and gates the value-moving operation through policyGate. Do not accept a provider account id in place of the SDP source wallet.

2. Payout account. The fiat needs a destination bank account, and a counterparty may hold several active accounts per corridor (per rail). The quote request takes an optional providerAccountId (the counterparty_provider_accounts row id): when present, the handler resolves it parent-scoped and rejects a mismatched corridor; when absent, it lists the corridor's active rows and applies the provider's selection helper. Accounts are JIT-created by the requirements advance flow — the raw bank details are sent to the provider and never stored. Missing/inactive account throws counterpartyNotProvisioned; the transfer records the chosen row id as payoutProviderAccountId in its provider data.