快速开始

安装

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}`); // e.g. "coinbase"
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);