Scripts

This directory contains utility scripts for the Thetanuts SDK.

Available Scripts

run-mainnet-tests.ts

A standalone script that runs mainnet integration tests without the Vitest framework.

Purpose

• Quick verification of SDK functionality

• Simple pass/fail output

• Doesn't require test framework setup

• Useful for CI/CD pipelines

Usage

# Via npm
npm run test:mainnet:standalone

# Directly with tsx
npx tsx scripts/run-mainnet-tests.ts

Output

========================================
  Thetanuts SDK Mainnet Integration Tests
========================================

Initializing client...
[Client] Chain ID: 8453
[Client] OptionBook: 0xd58b814C7Ce700f251722b5555e25aE0fa8169A1
[Client] API URL: https://round-snowflake-9c31.devops-118.workers.dev
[Client] Indexer URL: https://optionbook-indexer.thetanuts.finance/api/v1

--- 1. Client Configuration ---
  [PASS] Client initialized with correct config
  [PASS] Token configurations correct
  [PASS] Implementation addresses configured

--- 2. ERC20 Module ---
  [PASS] USDC decimals = 6
  [PASS] WETH decimals = 18
  [PASS] cbBTC decimals = 8
  [PASS] USDC balance read: 15108.994814 USDC
  [PASS] USDC allowance read: 0.0 USDC

--- 3. API Module ---
  [PASS] Fetched 284 orders from API
  [PASS] Fetched protocol stats from indexer
    Unique Users: 87
    Total Options Tracked: 2582
    Open Positions: 36

--- 4. Utils Module ---
  [PASS] toStrikeDecimals: 100000 -> 10000000000000
  [PASS] fromStrikeDecimals: 10000000000000 -> 100000
  [PASS] toUsdcDecimals: 1000 -> 1000000000
  [PASS] fromUsdcDecimals: 1000000000 -> 1000
  [PASS] toPriceDecimals: 0.05 -> 5000000

--- 5. OptionBook Module ---
  [PASS] computeNonce: 99747721222730232110376224709836831380121251795636040855854444678578159737113
  [PASS] getFees for USDC
    USDC fees: 13930459

--- 6. Pricing Module ---
  [PASS] Pricing URL: https://pricing.thetanuts.finance
  [PASS] Pricing module methods available

========================================
  Test Summary
========================================

Total: 19 tests
Passed: 19
Failed: 0

========================================
  ALL TESTS PASSED
========================================

Exit Codes

Code	Meaning
0	All tests passed
1	One or more tests failed

Configuration

The script uses these addresses (defined at top of file):

const BASE_MAINNET_RPC = 'https://mainnet.base.org';
const BASE_CHAIN_ID = 8453;

const ADDRESSES = {
  OPTION_BOOK: '0xd58b814C7Ce700f251722b5555e25aE0fa8169A1',
  USDC: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
  WETH: '0x4200000000000000000000000000000000000006',
  cbBTC: '0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf',
  SAMPLE_USER: '0xF977814e90dA44bFA03b6295A0616a897441aceC',
};

Tests Performed

Suite	Tests
Client Configuration	Chain ID, OptionBook address, tokens, implementations
ERC20 Module	Decimals for USDC/WETH/cbBTC, balance, allowance
API Module	Fetch orders, protocol stats
Utils Module	Decimal conversions (strike, USDC, price)
OptionBook Module	Compute nonce, get fees
Pricing Module	URL configuration, method availability

NPM Scripts Reference

These scripts are defined in package.json:

{
  "scripts": {
    "build": "tsup",
    "dev": "tsup --watch",
    "test": "vitest run",
    "test:watch": "vitest",
    "test:coverage": "vitest run --coverage",
    "test:mainnet": "vitest run test/integration/mainnet.test.ts",
    "test:mainnet:standalone": "npx tsx scripts/run-mainnet-tests.ts",
    "lint": "eslint src --ext .ts",
    "lint:fix": "eslint src test --ext .ts --fix",
    "typecheck": "tsc --noEmit",
    "clean": "rm -rf dist",
    "prepublishOnly": "npm run build"
  }
}

Build Scripts

Script	Description
npm run build	Build for production (CJS + ESM + types)
npm run dev	Watch mode build for development
npm run clean	Remove dist/ directory

Test Scripts

Script	Description
npm test	Run all unit tests
npm run test:watch	Run tests in watch mode
npm run test:coverage	Generate coverage report
npm run test:mainnet	Run mainnet integration tests (Vitest)
npm run test:mainnet:standalone	Run mainnet tests (standalone)

Code Quality Scripts

Script	Description
npm run lint	Check for linting errors
npm run lint:fix	Fix auto-fixable lint errors
npm run typecheck	Check TypeScript types

Creating New Scripts

When adding new scripts:

1. Create the script in scripts/ directory

2. Use TypeScript with .ts extension

3. Add shebang for direct execution: #!/usr/bin/env npx tsx

4. Add npm script to package.json

5. Document in this README

Example Script Template

#!/usr/bin/env npx tsx
/**
 * Script Name
 *
 * Description of what this script does.
 *
 * Usage: npx tsx scripts/my-script.ts
 */

import { ethers } from 'ethers';
import { ThetanutsClient } from '../src/client/ThetanutsClient.js';

async function main() {
  const provider = new ethers.JsonRpcProvider('https://mainnet.base.org');
  const client = new ThetanutsClient({
    chainId: 8453,
    provider,
  });

  // Script logic here
  console.log('Script completed');
}

main().catch((error) => {
  console.error('Error:', error);
  process.exit(1);
});