sdp-explorer

SDK and CLI explorer for the Solana Developer Platform (SDP) — Solana Foundation's enterprise API for stablecoin issuance, payments, and trading.

Modules

| Module | Description | Status | |--------|-------------|--------| | Issuance | Create stablecoins, tokenized deposits, RWAs | Sandbox | | Payments | On-ramp, off-ramp, stablecoin transfers | Sandbox | | Trading | Atomic swaps, vaults, onchain FX | Coming later 2026 |

Installation

git clone <repo-url> && cd sdp-explorer
npm install
npm run build

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | SDP_API_KEY | Yes | — | Your SDP API key | | SDP_API_URL | No | https://api.platform.solana.com | API base URL | | SDP_NETWORK | No | devnet | Network: devnet, testnet, mainnet-beta |

Copy .env.example to .env and fill in your API key:

cp .env.example .env

SDK Usage

import { SdpSdk } from "sdp-explorer";

const sdk = new SdpSdk({
  apiKey: process.env.SDP_API_KEY!,
  network: "devnet",
});

// Health check
const health = await sdk.healthCheck();

// Create a stablecoin
const coin = await sdk.issuance.createStablecoin({
  name: "Test Dollar",
  symbol: "TUSD",
  decimals: 6,
  initialSupply: 1_000_000,
});

// On-ramp fiat
const onramp = await sdk.payments.createOnramp({
  amount: 1000,
  currency: "USD",
  destinationWallet: "Your11Wa11etPubkey...",
});

// Swap tokens
const quote = await sdk.trading.getSwapQuote({
  fromToken: "USDC",
  toToken: "SOL",
  amount: 100,
});
const swap = await sdk.trading.executeSwap(quote.quoteId);

CLI Usage

# Build first
npm run build

# Health check
npx sdp health

# Issuance
npx sdp issuance create-stablecoin --name "Test Dollar" --symbol TUSD --decimals 6
npx sdp issuance list
npx sdp issuance get <tokenId>
npx sdp issuance mint --token-id <id> --amount 1000 --recipient <pubkey>
npx sdp issuance burn --token-id <id> --amount 500

# Payments
npx sdp payments onramp --amount 1000 --currency USD --wallet <pubkey>
npx sdp payments offramp --amount 500 --currency USD --wallet <pubkey> --bank-account ****1234
npx sdp payments status <paymentId>
npx sdp payments list
npx sdp payments estimate-fees --type onramp --amount 1000 --currency USD

# Trading
npx sdp trading quote --from USDC --to SOL --amount 100
npx sdp trading swap <quoteId>
npx sdp trading vaults list
npx sdp trading vaults create --name "USDC Yield" --strategy yield --tokens USDC
npx sdp trading vaults get <vaultId>
npx sdp trading fx-rate --from USDC --to SOL

Examples

Run any example with tsx:

SDP_API_KEY=<key> npx tsx src/examples/create-stablecoin.ts
SDP_API_KEY=<key> npx tsx src/examples/onramp-flow.ts
SDP_API_KEY=<key> npx tsx src/examples/offramp-flow.ts
SDP_API_KEY=<key> npx tsx src/examples/swap-tokens.ts
SDP_API_KEY=<key> npx tsx src/examples/create-vault.ts

Project Structure

sdp-explorer/
├── src/
│   ├── sdk/           # Core SDK (fetch-based HTTP client + typed modules)
│   │   ├── client.ts  # SdpSdk class, auth, transport
│   │   ├── issuance.ts
│   │   ├── payments.ts
│   │   ├── trading.ts
│   │   ├── types.ts   # Full type definitions
│   │   └── index.ts   # Barrel export
│   ├── cli/           # Commander-based CLI
│   │   ├── index.ts   # Entry point, .env loader
│   │   ├── issuance.ts
│   │   ├── payments.ts
│   │   └── trading.ts
│   └── examples/      # Runnable example scripts
├── package.json
├── tsconfig.json
└── .env.example

License

MIT