@t-0/provider-starter-ts 0.1.0

package/README.md

@@ -0,0 +1,204 @@
+# t-0 Network Provider Starter
+
+CLI tool to quickly bootstrap a Node.js TypeScript integration service for the t-0 Network.
+
+## Overview
+
+This CLI tool scaffolds a complete TypeScript project configured to integrate with the t-0 Network as a provider. It automatically generates secp256k1 cryptographic key pairs, sets up your development environment, and includes all necessary dependencies to get started immediately.
+
+## Prerequisites
+
+Before using this tool, ensure you have:
+
+- **Node.js** >= 14.0.0
+- **npm** >= 6.0.0
+- **OpenSSL** (for cryptographic key generation)
+
+## Quick Start
+
+### Using npx (Recommended)
+
+Run the following command to create a new t-0 Network integration:
+
+```bash
+npx @t-0/provider-starter-ts
+```
+
+### Alternative: Global Installation
+
+```bash
+npm install -g @t-0/provider-starter-ts
+provider-starter-ts
+```
+
+## What It Does
+
+When you run the CLI tool, it performs the following steps automatically:
+
+1. **Interactive Prompt** - Asks for your project name
+2. **Project Directory** - Creates a new directory with your project name
+3. **Template Setup** - Copies pre-configured TypeScript project structure
+4. **Key Generation** - Generates a secp256k1 cryptographic key pair using OpenSSL
+5. **Environment Configuration** - Creates `.env` file with:
+   - Generated private key (`PROVIDER_PRIVATE_KEY`)
+   - Generated public key (as comment for reference)
+   - t-0 Network public key (`NETWORK_PUBLIC_KEY`)
+   - Server configuration (`PORT`, `NODE_ENV`)
+   - Optional quote publishing interval
+6. **Git Initialization** - Initializes git repository with `.gitignore`
+7. **Dependency Installation** - Runs `npm install` to install all dependencies
+
+## Generated Project Structure
+
+After running the CLI, your new project will have the following structure:
+
+```
+your-project-name/
+├── src/
+│   ├── index.ts              # Main entry point
+│   ├── service.ts            # Provider service implementation
+│   ├── publish_quotes.ts     # Quote publishing logic
+│   ├── get_quote.ts          # Quote retrieval logic
+│   ├── submit_payment.ts     # Payment submission logic
+│   └── lib.ts                # Utility functions
+├── .env                      # Environment variables (with generated keys)
+├── .env.example              # Example environment file
+├── .eslintrc.json           # ESLint configuration
+├── .gitignore               # Git ignore rules
+├── package.json             # Project dependencies
+└── tsconfig.json            # TypeScript configuration
+```
+
+## Environment Variables
+
+The generated `.env` file includes:
+
+| Variable | Description |
+|----------|-------------|
+| `NETWORK_PUBLIC_KEY` | t-0 Network's public key (pre-configured) |
+| `PROVIDER_PRIVATE_KEY` | Your generated private key (keep secret!) |
+| `PORT` | Server port (default: 3000) |
+| `NODE_ENV` | Environment mode (default: development) |
+| `TZERO_ENDPOINT` | t-0 Network API endpoint (default: sandbox) |
+| `QUOTE_PUBLISHING_INTERVAL` | Quote publishing frequency in ms (optional) |
+
+## Available Scripts
+
+In your generated project, you can run:
+
+### `npm run dev`
+
+Runs the service in development mode using `ts-node`.
+
+### `npm run build`
+
+Compiles TypeScript to JavaScript in the `dist/` directory.
+
+### `npm start`
+
+Runs the compiled production build from `dist/`.
+
+### `npm run lint`
+
+Lints TypeScript files in the `src/` directory using ESLint.
+
+## Getting Started with Your Integration
+
+After creating your project:
+
+1. **Navigate to project directory:**
+   ```bash
+   cd your-project-name
+   ```
+
+2. **Review the generated keys:**
+   - Open `.env` file
+   - Your private key is stored in `PROVIDER_PRIVATE_KEY`
+   - Your public key is shown as a comment (you'll need to share this)
+
+3. **Share your public key with t-0 team:**
+   - Find your public key in the `.env` file (marked as "Step 1.2")
+   - Contact the t-0 team to register your provider
+
+4. **Implement quote publishing:**
+   - Edit `src/publish_quotes.ts` to implement your quote publishing logic
+   - This determines how you provide exchange rate quotes to the network
+
+5. **Start development server:**
+   ```bash
+   npm run dev
+   ```
+
+6. **Test your integration:**
+   - Follow the TODO comments in `src/index.ts` for step-by-step guidance
+   - Test quote retrieval
+   - Test payment submission
+   - Verify payout endpoint
+
+
+## Key Features
+
+- **Type Safety** - Full TypeScript support with strict mode enabled
+- **Automatic Key Generation** - Secure secp256k1 key pairs generated via OpenSSL
+- **Pre-configured SDK** - t-0 Provider SDK integrated and ready to use
+- **Development Ready** - Hot reload support with ts-node
+- **Production Ready** - Optimized build configuration
+- **Security First** - `.env` automatically excluded from git
+- **Code Quality** - ESLint configured with TypeScript rules
+
+
+## Security Considerations
+
+- **Never commit `.env` file** - It's automatically added to `.gitignore`
+- **Keep private key secure** - The `PROVIDER_PRIVATE_KEY` must remain confidential
+- **Share only public key** - Only the public key should be shared with t-0 team
+- **Use environment-specific configs** - Different keys for dev/staging/production
+
+## Deployment
+
+When ready to deploy:
+
+1. **Build your project:**
+   ```bash
+   npm run build
+   ```
+
+2. **Set environment variables** on your hosting platform
+
+3. **Provide your base URL to t-0 team** for network registration
+
+4. **Start the service:**
+   ```bash
+   npm start
+   ```
+
+## Troubleshooting
+
+### "Directory already exists" Error
+The project directory name is already taken. Choose a different project name.
+
+### "OpenSSL not found" Error
+Install OpenSSL:
+- **macOS:** `brew install openssl`
+- **Ubuntu/Debian:** `sudo apt-get install openssl`
+- **Windows:** Download from [openssl.org](https://www.openssl.org/)
+
+### Key Generation Fails
+Ensure OpenSSL is installed and accessible in your PATH. Try running:
+```bash
+openssl version
+```
+
+### npm install Fails
+Check your Node.js and npm versions:
+```bash
+node --version  # Should be >= 14
+npm --version   # Should be >= 6
+```
+
+## Support
+
+For issues or questions:
+- Review the generated code comments and TODO markers
+- Check the [t-0 Network documentation](https://t-0.network)
+- Contact the t-0 team for integration support

package/bin/cli.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+const create = require('../dist/create').default;
+
+create();

package/dist/create.d.ts

@@ -0,0 +1,3 @@
+declare function create(): Promise<void>;
+export default create;
+//# sourceMappingURL=create.d.ts.map

package/dist/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../src/create.ts"],"names":[],"mappings":"AAeA,iBAAe,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAkGrC;AAkCD,eAAe,MAAM,CAAC"}

package/dist/create.js

@@ -0,0 +1,121 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const path_1 = __importDefault(require("path"));
+const child_process_1 = require("child_process");
+const inquirer_1 = __importDefault(require("inquirer"));
+const chalk_1 = __importDefault(require("chalk"));
+async function create() {
+    console.log(chalk_1.default.blue('\n🚀 Create Your Service\n'));
+    // Prompt for project name
+    const answers = await inquirer_1.default.prompt([
+        {
+            type: 'input',
+            name: 'projectName',
+            message: 'Project name:',
+            validate: (input) => {
+                if (!input)
+                    return 'Project name is required';
+                if (!/^[a-z0-9-_]+$/.test(input)) {
+                    return 'Project name can only contain lowercase letters, numbers, hyphens and underscores';
+                }
+                return true;
+            }
+        }
+    ]);
+    const projectName = answers.projectName;
+    const projectPath = path_1.default.join(process.cwd(), projectName);
+    // Check if directory exists
+    if (fs_extra_1.default.existsSync(projectPath)) {
+        console.log(chalk_1.default.red(`\n❌ Directory "${projectName}" already exists!`));
+        process.exit(1);
+    }
+    console.log(chalk_1.default.green(`\n✨ Creating project in ${projectPath}...\n`));
+    try {
+        // Create project directory
+        fs_extra_1.default.mkdirSync(projectPath);
+        // Copy template files
+        const templatePath = path_1.default.join(__dirname, '../template');
+        fs_extra_1.default.copySync(templatePath, projectPath);
+        // Generate key pair
+        console.log(chalk_1.default.cyan('🔐 Generating key pair...'));
+        const keys = generateKeyPair();
+        // Create .env file with keys
+        const envContent = `
+NETWORK_PUBLIC_KEY=0x0436a6bba96086e02bcc8ea3700b82b4722f84b2b7489f36e4490f9a9342b77abfb6428b4a447824e0a6f5abd89098c985f4e506c65b5e9ae64a92810e1a1c0e79
+
+# Private Key (secp256k1)    
+PROVIDER_PRIVATE_KEY=${keys.privateKey}
+# TODO: Step 1.2 Share this Public Key with t-0 team
+# ${keys.publicKey}
+
+# Server Configuration
+PORT=3000
+NODE_ENV=development
+
+# QUOTE_PUBLISHING_INTERVAL=5000
+
+`;
+        fs_extra_1.default.writeFileSync(path_1.default.join(projectPath, '.env'), envContent);
+        // Update package.json with project name
+        const packageJsonPath = path_1.default.join(projectPath, 'package.json');
+        let packageJson = fs_extra_1.default.readFileSync(packageJsonPath, 'utf8');
+        packageJson = packageJson.replace('{{PROJECT_NAME}}', projectName);
+        fs_extra_1.default.writeFileSync(packageJsonPath, packageJson);
+        // Create .gitignore
+        const gitignoreContent = `node_modules/
+dist/
+.env
+.env.local
+.env.*.local
+*.log
+.DS_Store
+`;
+        fs_extra_1.default.writeFileSync(path_1.default.join(projectPath, '.gitignore'), gitignoreContent);
+        // Git init
+        console.log(chalk_1.default.cyan('📦 Initializing git repository...'));
+        (0, child_process_1.execSync)('git init', { cwd: projectPath, stdio: 'ignore' });
+        // npm install
+        console.log(chalk_1.default.cyan('📥 Installing dependencies...'));
+        (0, child_process_1.execSync)('npm install', { cwd: projectPath, stdio: 'inherit' });
+        console.log(chalk_1.default.green('\n✅ Project created successfully!\n'));
+        console.log(chalk_1.default.white(`  cd ${projectName}`));
+        console.log(chalk_1.default.white(`  npm run dev\n`));
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        console.error(chalk_1.default.red('\n❌ Error creating project:'), errorMessage);
+        // Cleanup on error
+        if (fs_extra_1.default.existsSync(projectPath)) {
+            //fs.removeSync(projectPath);
+        }
+        process.exit(1);
+    }
+}
+function generateKeyPair() {
+    const tempDir = fs_extra_1.default.mkdtempSync('/tmp/keygen-');
+    const privateKeyPath = path_1.default.join(tempDir, 'private_key.pem');
+    try {
+        // Generate private key
+        (0, child_process_1.execSync)(`openssl ecparam -genkey -name secp256k1 -noout -out ${privateKeyPath}`, {
+            stdio: 'ignore'
+        });
+        // Extract private key hex
+        const privateKeyHex = (0, child_process_1.execSync)(`openssl ec -in ${privateKeyPath} -text -noout 2>/dev/null | grep -A 3 'priv:' | tail -n +2 | tr -d '\\n: ' | sed 's/[^0-9a-f]//g'`, { encoding: 'utf8' }).trim();
+        // Extract public key hex
+        const publicKeyHex = (0, child_process_1.execSync)(`openssl ec -in ${privateKeyPath} -text -noout 2>/dev/null | grep -A 5 'pub:' | tail -n +2 | tr -d '\\n: ' | sed 's/[^0-9a-f]//g'`, { encoding: 'utf8' }).trim();
+        return {
+            privateKey: privateKeyHex,
+            publicKey: publicKeyHex
+        };
+    }
+    finally {
+        // Cleanup temp files
+        fs_extra_1.default.removeSync(tempDir);
+    }
+}
+exports.default = create;
+//# sourceMappingURL=create.js.map

package/dist/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../src/create.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@t-0/provider-starter-ts",
+  "version": "0.1.0",
+  "description": "CLI tool to scaffold a Node.js t-0 Network integration service",
+  "main": "dist/create.js",
+  "bin": {
+    "provider-starter-ts": "./bin/cli.js"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "template"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "release": "npm run build && npm publish --access public"
+  },
+  "keywords": [
+    "cli",
+    "scaffold",
+    "template",
+    "nodejs"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git@github.com:t-0-network/provider-starter-ts.git"
+  },
+  "author": "New Settlement Technologies Inc.",
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "inquirer": "^8.2.5",
+    "fs-extra": "^11.1.1"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/inquirer": "^8.2.10",
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.2"
+  }
+}

package/template/.dockerignore

@@ -0,0 +1,43 @@
+# Dependencies
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Build output
+dist/
+
+# Environment files (should be provided at runtime)
+.env
+.env.local
+.env.*.local
+
+# IDE and editor files
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Git
+.git/
+.gitignore
+
+# Testing
+coverage/
+*.test.ts
+*.spec.ts
+
+# Documentation
+README.md
+*.md
+
+# Logs
+logs/
+*.log
+
+# Temporary files
+tmp/
+temp/
+*.tmp

package/template/.env

@@ -0,0 +1,11 @@
+# Private Key (secp256k1)
+PROVIDER_PRIVATE_KEY=0x53f99e67385faa2f4bf29f8e4cb26a22741039e9f749a2e4932e63efd78176a1
+
+# Public Key (secp256k1)
+# your_public_key_here
+
+# Server Configuration
+PORT=3000
+NODE_ENV=development
+TZERO_ENDPOINT=https://api-sandbox.t-0.network
+NETWORK_PUBLIC_KEY=0x0436a6bba96086e02bcc8ea3700b82b4722f84b2b7489f36e4490f9a9342b77abfb6428b4a447824e0a6f5abd89098c985f4e506c65b5e9ae64a92810e1a1c0e79

package/template/.env.example

@@ -0,0 +1,14 @@
+# Private Key (secp256k1)
+PRIVATE_KEY=your_private_key_here
+
+# Public Key (secp256k1)
+# your_public_key_here
+
+# Server Configuration
+PORT=3000
+NODE_ENV=development
+TZERO_ENDPOINT=https://api-sandbox.t-0.network
+
+# Quote Publishing Interval in milliseconds
+# QUOTE_PUBLISHING_INTERVAL=5000
+NETWORK_PUBLIC_KEY=0x0436a6bba96086e02bcc8ea3700b82b4722f84b2b7489f36e4490f9a9342b77abfb6428b4a447824e0a6f5abd89098c985f4e506c65b5e9ae64a92810e1a1c0e79

package/template/.eslintrc.json

@@ -0,0 +1,20 @@
+{
+  "parser": "@typescript-eslint/parser",
+  "extends": [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/recommended"
+  ],
+  "parserOptions": {
+    "ecmaVersion": 2020,
+    "sourceType": "module"
+  },
+  "env": {
+    "node": true,
+    "es6": true
+  },
+  "rules": {
+    "@typescript-eslint/no-unused-vars": ["error", { "argsIgnorePattern": "^_" }],
+    "@typescript-eslint/explicit-function-return-type": "off",
+    "@typescript-eslint/no-explicit-any": "warn"
+  }
+}

package/template/Dockerfile

@@ -0,0 +1,56 @@
+# Multi-stage build for optimal image size
+
+# Stage 1: Build
+FROM node:24-alpine AS builder
+
+# Set working directory
+WORKDIR /app
+
+# Copy package files
+COPY package*.json ./
+
+# Install all dependencies (including devDependencies for build)
+RUN npm ci
+
+# Copy source code and config files
+COPY tsconfig.json ./
+COPY src ./src
+
+# Build TypeScript to JavaScript
+RUN npm run build
+
+# Stage 2: Production
+FROM node:24-alpine
+
+# Set working directory
+WORKDIR /app
+
+# Copy package files
+COPY package*.json ./
+
+# Install only production dependencies
+RUN npm ci --only=production && \
+    npm cache clean --force
+
+# Copy built files from builder stage
+COPY --from=builder /app/dist ./dist
+
+# Create a non-root user
+RUN addgroup -g 1001 -S nodejs && \
+    adduser -S nodejs -u 1001
+
+# Change ownership of app directory
+RUN chown -R nodejs:nodejs /app
+
+# Switch to non-root user
+USER nodejs
+
+# Expose the port (default 3000, can be overridden)
+EXPOSE 3000
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=3s --start-period=40s --retries=3 \
+    CMD node -e "require('http').get('http://localhost:' + (process.env.PORT || 3000) + '/health', (r) => {process.exit(r.statusCode === 200 ? 0 : 1)})" || exit 1
+
+# Start the application
+CMD ["node", "dist/index.js"]