Developer SDK

Build with Modulr

Integrate wallet risk, token launch readiness, and smart contract auditing directly into your app. One SDK, no setup required.

GitHub
npm install @modulr/sdk

Quickstart

Install the SDK and start making calls in minutes. No API key required.

Install

npm install @modulr/sdk

TypeScript / Node.js

import { Modulr } from '@modulr/sdk'

const modulr = new Modulr()

// Wallet risk
const risk = await modulr.walletRisk.analyze('9apA5U8...')
console.log(risk.riskLevel, risk.riskScore)

// Token launch
const launch = await modulr.tokenLaunch.check({
  projectName: 'MyToken',
  chain: 'Solana',
  launchStage: 'Pre-launch',
})
console.log(launch.readinessScore, launch.riskFlags)

// Smart contract audit
const audit = await modulr.audit.scan({
  contractText: '// your contract code',
  language: 'Solidity',
  reviewDepth: 'Standard Review',
})
console.log(audit.riskLevel, audit.findings)

Modules

Each module maps directly to a Modulr tool.

Wallet Risk

Analyze any Solana wallet. Returns risk score, risk level, wallet type, warning signals, activity breakdown and full explainability.

Method

modulr.walletRisk.analyze(address)

Returns

{
  riskLevel: "Low Risk" | "Medium Risk" | "High Risk",
  riskScore: number,          // 0–100
  walletType: string,
  warningSignals: string[],
  positiveSignals: string[],
  scoreBreakdown: { ... },
  generatedAt: string
}
Token Launch

Generate a launch readiness report for any token project. Returns a readiness score, checklist sections, risk flags and next steps.

Method

modulr.tokenLaunch.check(input)

Returns

{
  readinessScore: number,     // 0–100
  readinessLevel: string,
  sections: ChecklistSection[],
  riskFlags: string[],
  nextSteps: string[],
  generatedAt: string
}
Smart Contract Audit

Static analysis on Solidity, Rust/Anchor or Move contracts. Returns findings by severity, a security checklist, and a deploy recommendation.

Method

modulr.audit.scan(input)

Returns

{
  riskLevel: string,
  riskScore: number,          // 0–100
  findings: AuditFinding[],
  securityChecklist: [...],
  deployRecommendation: string,
  suggestedFixes: string[],
  generatedAt: string
}
AI Agent Generator
Soon

Generate complete TypeScript agent scripts for trading, monitoring, alerts and DeFi automation. Coming soon.

Method

modulr.agent.generate(input)

Returns

{
  scriptContent: string,      // complete .ts file
  setupInstructions: string[],
  requiredEnvVars: string[],
  generatedAt: string
}

API Reference

The SDK wraps the Modulr REST API. You can also call the endpoints directly.

POST/api/generate/wallet-riskAnalyze a Solana wallet address
{ "address": "9apA5U8..." }
POST/api/generate/token-launchGenerate a token launch readiness report
{ "projectName": "MyToken", "chain": "Solana", "launchStage": "Pre-launch", ... }
POST/api/audit/smart-contractRun a smart contract audit
{ "contractText": "...", "language": "Solidity", "reviewDepth": "Standard Review" }

Error handling

import { Modulr, ModulrError } from '@modulr/sdk'

const modulr = new Modulr()

try {
  const report = await modulr.walletRisk.analyze('address')
} catch (err) {
  if (err instanceof ModulrError) {
    console.error(err.message)
    console.error(err.status) // 400 | 408 | 503
  }
}

Configuration

All options are optional. The SDK works out of the box with no configuration.

Option
Default
Description
baseUrl
https://modulr402.com
API base URL
timeoutMs
30000
Request timeout in milliseconds
maxRetries
3
Retry attempts on 503 / 529