Neptune Router Adapter

Cross-chain lending quotes and rate comparison for Neptune Finance on Injective.

Features

• Lending Quotes — Get optimal lending/borrowing paths across Neptune markets
• Competitive Rates — Auto-refreshed rates from Neptune, Aave, Compound, Morpho
• Cross-Chain Swaps — EVM → Injective via Skip Go API
• Analytics — Track volume, usage, and performance

Quick Start

# Install
npm install @neptune-finance/router-adapter

# Configure
cp node_modules/@neptune-finance/router-adapter/.env.example .env
# Edit .env with your settings

# Run
npm start --prefix .

Or run directly:

npm install
cp .env.example .env
npm run dev

Configuration

| Variable | Default | Description | |----------|---------|-------------| | PORT | 8787 | Server port | | HOST | 127.0.0.1 | Server host | | NEPTUNE_API_BASE | https://dev.api-v2.nept.finance | Neptune API | | ROUTER_API_KEY | (none) | Bearer token auth | | SKIP_API_BASE | https://api.skip.build | Skip Go API | | SKIP_AFFILIATE_FEE_BPS | 5 | Affiliate fee (bps) | | SKIP_AFFILIATE_WALLET | (none) | Fee receiver address | | RATES_REFRESH_INTERVAL | 60000 | Rate refresh (ms) |

API Endpoints

Health

GET /health

Quotes

POST /v1/quote
{
  "chain": "injective",
  "mode": "lend",        // or "borrow"
  "asset_id": "native;inj",
  "amount": "1000000000000000000",
  "amount_usd": "25000"
}

Competitive Rates

GET /v1/rates                    # All rates
GET /v1/rates/compare?asset=USDC # Cross-protocol comparison

Cross-Chain (Skip)

GET /v1/bridge/config           # Fee config
GET /v1/bridge/routes           # Available routes
POST /v1/bridge/route          # Get swap quote
POST /v1/bridge/swap            # Execute swap

Analytics

GET /v1/analytics              # Full stats
GET /v1/analytics/health       # Health check
GET /v1/analytics/volume      # Volume tracking

Docker

FROM node:20-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY . .
EXPOSE 8787
CMD ["npm", "start"]

License

MIT