The Rampart is a TypeScript library - it has no built-in HTTP server. The patterns on these pages show how to wrap SDK functions in Next.js API routes or Express endpoints to expose them over HTTP for frontends, bots, or external services.
Base URL
All examples in this section assume your deployment is at:
https://your-app.vercel.app/api
http://localhost:3000/api for local development.
Authentication
For production deployments, protect your endpoints with a Bearer token:
// lib/auth.ts
export function requireAuth(req: Request): boolean {
const authHeader = req.headers.get('Authorization')
return authHeader === `Bearer ${process.env.API_SECRET}`
}
GET /api/price?symbol=MON
Authorization: Bearer your-secret-token
interface ApiResponse<T> {
data: T
timestamp: number
error?: string
}
error string and return a 4xx or 5xx HTTP status code.
{
"data": null,
"timestamp": 1713600000000,
"error": "Symbol not found: XYZ"
}
Quick Start: Next.js
Install the SDK:
npm install rampart-monad
// pages/api/price.ts
import { getVerifiedPrice } from 'rampart-monad'
import type { NextApiRequest, NextApiResponse } from 'next'
export default async function handler(req: NextApiRequest, res: NextApiResponse) {
const { symbol = 'MON' } = req.query
try {
const price = await getVerifiedPrice(symbol as string)
res.json({ data: price, timestamp: Date.now() })
} catch (err) {
res.status(500).json({ data: null, timestamp: Date.now(), error: String(err) })
}
}
Quick Start: Express
import express from 'express'
import { getVerifiedPrice, getMarketOverview } from 'rampart-monad'
const app = express()
app.get('/api/price', async (req, res) => {
const { symbol = 'MON' } = req.query
try {
const price = await getVerifiedPrice(symbol as string)
res.json({ data: price, timestamp: Date.now() })
} catch (err) {
res.status(500).json({ data: null, timestamp: Date.now(), error: String(err) })
}
})
app.get('/api/markets', async (_req, res) => {
try {
const overview = await getMarketOverview()
res.json({ data: overview, timestamp: Date.now() })
} catch (err) {
res.status(500).json({ data: null, timestamp: Date.now(), error: String(err) })
}
})
app.listen(3000)
Rate Limiting
The Monad public RPC (https://rpc.monad.xyz) imposes rate limits. To avoid 429 errors in production:
- Cache responses in Redis or a KV store (prices for 10-30 s, TVL for 60 s)
- Use a dedicated RPC endpoint from a node provider
- Run multiple Vitest tests with
singleFork to avoid parallel RPC saturation
Available Endpoints
| Endpoint | Description |
|---|
GET /price | Verified asset price |
GET /markets | Lending market rates |
GET /tvl | TVL by category |
GET /portfolio | Wallet DeFi snapshot |
