x402charity 0.1.0

package/bin/cli.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../dist/index.js';

package/dist/commands/config.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const configCommand: Command;

package/dist/commands/config.js

@@ -0,0 +1,36 @@
+import { Command } from 'commander';
+import { saveCliConfig, loadCliConfig } from '../config.js';
+export const configCommand = new Command('config')
+    .description('Configure x402charity CLI');
+configCommand
+    .command('set-key <privateKey>')
+    .description('Set your wallet private key')
+    .action((privateKey) => {
+    const config = loadCliConfig();
+    config.privateKey = privateKey;
+    saveCliConfig(config);
+    console.log('Private key saved to ~/.x402charity/config.json');
+});
+configCommand
+    .command('set-network <network>')
+    .description('Set default network (base or base-sepolia)')
+    .action((network) => {
+    if (network !== 'base' && network !== 'base-sepolia') {
+        console.error('Network must be "base" or "base-sepolia"');
+        process.exit(1);
+    }
+    const config = loadCliConfig();
+    config.network = network;
+    saveCliConfig(config);
+    console.log(`Default network set to ${network}`);
+});
+configCommand
+    .command('show')
+    .description('Show current configuration')
+    .action(() => {
+    const config = loadCliConfig();
+    console.log('\nCurrent configuration:\n');
+    console.log(`  Network:     ${config.network || 'base-sepolia (default)'}`);
+    console.log(`  Private Key: ${config.privateKey ? '****' + config.privateKey.slice(-4) : 'not set'}`);
+    console.log(`  Config File: ~/.x402charity/config.json\n`);
+});

package/dist/commands/donate.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const donateCommand: Command;

package/dist/commands/donate.js

@@ -0,0 +1,29 @@
+import { Command } from 'commander';
+import { X402CharityClient } from '@x402charity/core';
+import { getPrivateKey, getNetwork } from '../config.js';
+export const donateCommand = new Command('donate')
+    .description('Donate USDC to a charity')
+    .argument('<cause>', 'Charity ID or name')
+    .argument('[amount]', 'Amount in USDC (default: 0.0001)')
+    .option('-n, --network <network>', 'Network: base or base-sepolia')
+    .action(async (cause, amount, options) => {
+    amount = amount || '0.0001';
+    try {
+        const privateKey = getPrivateKey();
+        const network = (options.network || getNetwork());
+        const client = new X402CharityClient({ privateKey, network });
+        console.log(`\nDonating ${amount} USDC to "${cause}" on ${network}...\n`);
+        const receipt = await client.donate(cause, amount);
+        console.log('Donation successful!\n');
+        console.log(`  Charity:  ${receipt.charity.name}`);
+        console.log(`  Amount:   ${receipt.amount} ${receipt.currency}`);
+        console.log(`  Tx Hash:  ${receipt.txHash}`);
+        console.log(`  Chain:    ${receipt.chain}`);
+        console.log(`  From:     ${receipt.from}`);
+        console.log(`  To:       ${receipt.to}\n`);
+    }
+    catch (error) {
+        console.error(`\nError: ${error.message}\n`);
+        process.exit(1);
+    }
+});

package/dist/commands/list.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const listCommand: Command;

package/dist/commands/list.js

@@ -0,0 +1,19 @@
+import { Command } from 'commander';
+import { listCharities } from '@x402charity/core';
+export const listCommand = new Command('list')
+    .description('List available charities')
+    .action(() => {
+    const charities = listCharities();
+    console.log('\nAvailable charities:\n');
+    for (const charity of charities) {
+        const badge = charity.verified ? ' [verified]' : '';
+        console.log(`  ${charity.id}${badge}`);
+        console.log(`    ${charity.name}`);
+        console.log(`    ${charity.description}`);
+        console.log(`    Wallet: ${charity.walletAddress}`);
+        console.log(`    Chain:  ${charity.chain}`);
+        if (charity.website)
+            console.log(`    Web:    ${charity.website}`);
+        console.log('');
+    }
+});

package/dist/config.d.ts

@@ -0,0 +1,9 @@
+interface CliConfig {
+    privateKey?: string;
+    network?: 'base' | 'base-sepolia';
+}
+export declare function loadCliConfig(): CliConfig;
+export declare function saveCliConfig(config: CliConfig): void;
+export declare function getPrivateKey(): string;
+export declare function getNetwork(): 'base' | 'base-sepolia';
+export {};

package/dist/config.js

@@ -0,0 +1,31 @@
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+const CONFIG_DIR = join(homedir(), '.x402charity');
+const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+export function loadCliConfig() {
+    if (!existsSync(CONFIG_FILE))
+        return {};
+    return JSON.parse(readFileSync(CONFIG_FILE, 'utf-8'));
+}
+export function saveCliConfig(config) {
+    mkdirSync(CONFIG_DIR, { recursive: true });
+    writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), { mode: 0o600 });
+}
+export function getPrivateKey() {
+    const envKey = process.env.X402_PRIVATE_KEY;
+    if (envKey)
+        return envKey;
+    const config = loadCliConfig();
+    if (config.privateKey)
+        return config.privateKey;
+    console.error('No private key found. Set X402_PRIVATE_KEY env var or run:\n  x402charity config set-key <key>');
+    return process.exit(1);
+}
+export function getNetwork() {
+    const envNetwork = process.env.X402_NETWORK;
+    if (envNetwork === 'base' || envNetwork === 'base-sepolia')
+        return envNetwork;
+    const config = loadCliConfig();
+    return config.network || 'base-sepolia';
+}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.js

@@ -0,0 +1,13 @@
+import { Command } from 'commander';
+import { donateCommand } from './commands/donate.js';
+import { listCommand } from './commands/list.js';
+import { configCommand } from './commands/config.js';
+const program = new Command();
+program
+    .name('x402charity')
+    .description('Donate to charities via x402 stablecoin payments')
+    .version('0.1.0');
+program.addCommand(donateCommand);
+program.addCommand(listCommand);
+program.addCommand(configCommand);
+program.parse();

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "x402charity",
+  "version": "0.1.0",
+  "type": "module",
+  "bin": {
+    "x402charity": "./bin/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@x402charity/core": "workspace:*",
+    "commander": "^12.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.3",
+    "typescript": "^5.4.0"
+  },
+  "license": "MIT"
+}

package/src/commands/config.ts

@@ -0,0 +1,40 @@
+import { Command } from 'commander';
+import { saveCliConfig, loadCliConfig } from '../config.js';
+
+export const configCommand = new Command('config')
+  .description('Configure x402charity CLI');
+
+configCommand
+  .command('set-key <privateKey>')
+  .description('Set your wallet private key')
+  .action((privateKey: string) => {
+    const config = loadCliConfig();
+    config.privateKey = privateKey;
+    saveCliConfig(config);
+    console.log('Private key saved to ~/.x402charity/config.json');
+  });
+
+configCommand
+  .command('set-network <network>')
+  .description('Set default network (base or base-sepolia)')
+  .action((network: string) => {
+    if (network !== 'base' && network !== 'base-sepolia') {
+      console.error('Network must be "base" or "base-sepolia"');
+      process.exit(1);
+    }
+    const config = loadCliConfig();
+    config.network = network as 'base' | 'base-sepolia';
+    saveCliConfig(config);
+    console.log(`Default network set to ${network}`);
+  });
+
+configCommand
+  .command('show')
+  .description('Show current configuration')
+  .action(() => {
+    const config = loadCliConfig();
+    console.log('\nCurrent configuration:\n');
+    console.log(`  Network:     ${config.network || 'base-sepolia (default)'}`);
+    console.log(`  Private Key: ${config.privateKey ? '****' + config.privateKey.slice(-4) : 'not set'}`);
+    console.log(`  Config File: ~/.x402charity/config.json\n`);
+  });

package/src/commands/donate.ts

@@ -0,0 +1,33 @@
+import { Command } from 'commander';
+import { X402CharityClient } from '@x402charity/core';
+import { getPrivateKey, getNetwork } from '../config.js';
+
+export const donateCommand = new Command('donate')
+  .description('Donate USDC to a charity')
+  .argument('<cause>', 'Charity ID or name')
+  .argument('[amount]', 'Amount in USDC (default: 0.0001)')
+  .option('-n, --network <network>', 'Network: base or base-sepolia')
+  .action(async (cause: string, amount: string | undefined, options: { network?: string }) => {
+    amount = amount || '0.0001';
+    try {
+      const privateKey = getPrivateKey();
+      const network = (options.network || getNetwork()) as 'base' | 'base-sepolia';
+
+      const client = new X402CharityClient({ privateKey, network });
+
+      console.log(`\nDonating ${amount} USDC to "${cause}" on ${network}...\n`);
+
+      const receipt = await client.donate(cause, amount);
+
+      console.log('Donation successful!\n');
+      console.log(`  Charity:  ${receipt.charity.name}`);
+      console.log(`  Amount:   ${receipt.amount} ${receipt.currency}`);
+      console.log(`  Tx Hash:  ${receipt.txHash}`);
+      console.log(`  Chain:    ${receipt.chain}`);
+      console.log(`  From:     ${receipt.from}`);
+      console.log(`  To:       ${receipt.to}\n`);
+    } catch (error: any) {
+      console.error(`\nError: ${error.message}\n`);
+      process.exit(1);
+    }
+  });

package/src/commands/list.ts

@@ -0,0 +1,21 @@
+import { Command } from 'commander';
+import { listCharities } from '@x402charity/core';
+
+export const listCommand = new Command('list')
+  .description('List available charities')
+  .action(() => {
+    const charities = listCharities();
+
+    console.log('\nAvailable charities:\n');
+
+    for (const charity of charities) {
+      const badge = charity.verified ? ' [verified]' : '';
+      console.log(`  ${charity.id}${badge}`);
+      console.log(`    ${charity.name}`);
+      console.log(`    ${charity.description}`);
+      console.log(`    Wallet: ${charity.walletAddress}`);
+      console.log(`    Chain:  ${charity.chain}`);
+      if (charity.website) console.log(`    Web:    ${charity.website}`);
+      console.log('');
+    }
+  });

package/src/config.ts

@@ -0,0 +1,42 @@
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+
+const CONFIG_DIR = join(homedir(), '.x402charity');
+const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+
+interface CliConfig {
+  privateKey?: string;
+  network?: 'base' | 'base-sepolia';
+}
+
+export function loadCliConfig(): CliConfig {
+  if (!existsSync(CONFIG_FILE)) return {};
+  return JSON.parse(readFileSync(CONFIG_FILE, 'utf-8'));
+}
+
+export function saveCliConfig(config: CliConfig): void {
+  mkdirSync(CONFIG_DIR, { recursive: true });
+  writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), { mode: 0o600 });
+}
+
+export function getPrivateKey(): string {
+  const envKey = process.env.X402_PRIVATE_KEY;
+  if (envKey) return envKey;
+
+  const config = loadCliConfig();
+  if (config.privateKey) return config.privateKey;
+
+  console.error(
+    'No private key found. Set X402_PRIVATE_KEY env var or run:\n  x402charity config set-key <key>',
+  );
+  return process.exit(1) as never;
+}
+
+export function getNetwork(): 'base' | 'base-sepolia' {
+  const envNetwork = process.env.X402_NETWORK;
+  if (envNetwork === 'base' || envNetwork === 'base-sepolia') return envNetwork;
+
+  const config = loadCliConfig();
+  return config.network || 'base-sepolia';
+}

package/src/index.ts

@@ -0,0 +1,17 @@
+import { Command } from 'commander';
+import { donateCommand } from './commands/donate.js';
+import { listCommand } from './commands/list.js';
+import { configCommand } from './commands/config.js';
+
+const program = new Command();
+
+program
+  .name('x402charity')
+  .description('Donate to charities via x402 stablecoin payments')
+  .version('0.1.0');
+
+program.addCommand(donateCommand);
+program.addCommand(listCommand);
+program.addCommand(configCommand);
+
+program.parse();

package/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "lib": ["ES2022"],
+    "declaration": true,
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src"]
+}