クイックスタート

インストール

npm

npm install @dtax/tax-engine

pnpm

pnpm add @dtax/tax-engine

yarn

yarn add @dtax/tax-engine

CSV を解析してゲインを計算する

import { parseCsv, computeGains } from '@dtax/tax-engine';
import { readFileSync } from 'fs';

// 1. Parse a Coinbase CSV export
const csv = readFileSync('coinbase-export.csv', 'utf-8');
const { transactions } = parseCsv(csv, { format: 'coinbase' });

// 2. Compute capital gains using FIFO
const result = computeGains(transactions, { method: 'FIFO', taxYear: 2024 });

console.log(`Short-term gains: $${result.shortTermGain}`);
console.log(`Long-term gains:  $${result.longTermGain}`);
console.log(`Total gain/loss:  $${result.totalGain}`);

フォーマットの自動検出

CSV を生成した取引所が不明な場合は、format オプションを省略してください：

const { transactions, summary } = parseCsv(csv);
console.log(`Detected format: ${summary.format}`);
console.log(`Parsed ${summary.parsed} transactions`);

Form 8949 の生成

import { generateForm8949Csv } from '@dtax/tax-engine';

const form8949 = generateForm8949Csv(result.disposals, { taxYear: 2024 });
writeFileSync('form8949.csv', form8949);