پرش به محتوای اصلی
Beancount.io LogoBeancount.io
الگوها و مثال‌های ارز دیجیتال

الگوها و مثال‌های ارز دیجیتال

الگوهای کاربردی Beancount و مثال‌های واقعی برای سناریوهای رایج ارز دیجیتال شامل معاملات، استخراج، استیکینگ، ایردراپ‌ها و فعالیت‌های DeFi.

این راهنما الگوهای کاربردی Beancount و مثال‌های واقعی برای سناریوهای رایج ارز دیجیتال را ارائه می‌دهد. این الگوها را کپی کرده و برای نیازهای حسابداری ارز دیجیتال خود تطبیق دهید.

یک نمونه زنده از دفتر کل ارز دیجیتال را کاوش کنید:

الگوی راه‌اندازی اولیه

الگوی ساختار حساب

; =============================================================================
; الگوی راه‌اندازی حساب ارز دیجیتال
; =============================================================================
 
; حساب‌های صرافی
1970-01-01 open Assets:Crypto:Coinbase:USD
1970-01-01 open Assets:Crypto:Coinbase:BTC
1970-01-01 open Assets:Crypto:Coinbase:ETH
1970-01-01 open Assets:Crypto:Binance:USD
1970-01-01 open Assets:Crypto:Binance:BTC
1970-01-01 open Assets:Crypto:Binance:ETH
1970-01-01 open Assets:Crypto:Binance:BNB
 
; حساب‌های کیف پول
1970-01-01 open Assets:Crypto:Wallet:Ledger:BTC
1970-01-01 open Assets:Crypto:Wallet:Ledger:ETH
1970-01-01 open Assets:Crypto:Wallet:MetaMask:ETH
1970-01-01 open Assets:Crypto:Wallet:MetaMask:USDC
 
; حساب‌های پروتکل DeFi
1970-01-01 open Assets:DeFi:Uniswap:ETH-USDC-LP
1970-01-01 open Assets:DeFi:Compound:cUSDC
1970-01-01 open Assets:Staking:Ethereum:ETH
 
; حساب‌های درآمد
1970-01-01 open Income:Crypto:Staking:ETH
1970-01-01 open Income:Crypto:Mining:BTC
1970-01-01 open Income:Crypto:Airdrops
1970-01-01 open Income:Crypto:DeFi:Yield
1970-01-01 open Income:CapitalGains:Crypto
 
; حساب‌های هزینه
1970-01-01 open Expenses:Crypto:Fees:Trading
1970-01-01 open Expenses:Crypto:Fees:Network
1970-01-01 open Expenses:Crypto:Fees:Withdrawal
 
; تعاریف کالا
1970-01-01 commodity BTC
  name: "Bitcoin"
  asset-class: "cryptocurrency"
 
1970-01-01 commodity ETH
  name: "Ethereum"
  asset-class: "cryptocurrency"
 
1970-01-01 commodity USDC
  name: "USD Coin"
  asset-class: "stablecoin"

الگوهای معاملاتی

خرید اولیه ارز دیجیتال

; الگو: خرید ارز دیجیتال در صرافی
YYYY-MM-DD * "خرید [AMOUNT] [CRYPTO] در [EXCHANGE]"
  Assets:Crypto:[EXCHANGE]:[CRYPTO]     [AMOUNT] [CRYPTO] {[PRICE] USD}
  Assets:Crypto:[EXCHANGE]:USD         -[TOTAL_COST] USD
  Expenses:Crypto:Fees:Trading          [FEE] USD
  Assets:Crypto:[EXCHANGE]:USD         -[FEE] USD
 
; مثال: خرید 1 BTC در Coinbase
2024-01-15 * "خرید 1 BTC در Coinbase"
  Assets:Crypto:Coinbase:BTC      1.0 BTC {45000.00 USD}
  Assets:Crypto:Coinbase:USD  -45000.00 USD
  Expenses:Crypto:Fees:Trading    50.00 USD
  Assets:Crypto:Coinbase:USD     -50.00 USD

فروش ارز دیجیتال

; الگو: فروش ارز دیجیتال در صرافی
YYYY-MM-DD * "فروش [AMOUNT] [CRYPTO] در [EXCHANGE]"
  Assets:Crypto:[EXCHANGE]:[CRYPTO]    -[AMOUNT] [CRYPTO] {[COST_BASIS] USD}
  Assets:Crypto:[EXCHANGE]:USD          [PROCEEDS] USD
  Expenses:Crypto:Fees:Trading          [FEE] USD
  Assets:Crypto:[EXCHANGE]:USD         -[FEE] USD
  Income:CapitalGains:Crypto            [GAIN] USD  ; یا Expenses:CapitalLoss:Crypto
 
; مثال: فروش 0.5 BTC با سود
2024-03-20 * "فروش 0.5 BTC در Coinbase"
  Assets:Crypto:Coinbase:BTC    -0.5 BTC {45000.00 USD}
  Assets:Crypto:Coinbase:USD   24000.00 USD
  Expenses:Crypto:Fees:Trading    30.00 USD
  Assets:Crypto:Coinbase:USD     -30.00 USD
  Income:CapitalGains:Crypto    1470.00 USD  ; 24000 - 22500 - 30

معامله ارز دیجیتال به ارز دیجیتال

; الگو: معامله یک ارز دیجیتال با ارز دیجیتال دیگر
YYYY-MM-DD * "معامله [AMOUNT1] [CRYPTO1] برای [AMOUNT2] [CRYPTO2]"
  Assets:Crypto:[EXCHANGE]:[CRYPTO1]   -[AMOUNT1] [CRYPTO1] {[COST_BASIS] USD}
  Assets:Crypto:[EXCHANGE]:[CRYPTO2]    [AMOUNT2] [CRYPTO2] {[NEW_PRICE] USD}
  Income:CapitalGains:Crypto            [GAIN] USD  ; رویداد مشمول مالیات
  Expenses:Crypto:Fees:Trading          [FEE] USD
  Assets:Crypto:[EXCHANGE]:USD         -[FEE] USD
 
; مثال: معامله BTC برای ETH
2024-02-10 * "معامله 1 BTC برای 20 ETH در Binance"
  Assets:Crypto:Binance:BTC     -1.0 BTC {46000.00 USD}
  Assets:Crypto:Binance:ETH      20 ETH {2400.00 USD}
  Income:CapitalGains:Crypto   2000.00 USD  ; 48000 - 46000
  Expenses:Crypto:Fees:Trading    40.00 USD
  Assets:Crypto:Binance:USD      -40.00 USD

الگوهای انتقال

انتقال از صرافی به کیف پول

; الگو: انتقال ارز دیجیتال از صرافی به کیف پول
YYYY-MM-DD * "انتقال [AMOUNT] [CRYPTO] از [EXCHANGE] به [WALLET]"
  Assets:Crypto:[EXCHANGE]:[CRYPTO]      -[AMOUNT] [CRYPTO] {[COST_BASIS] USD}
  Assets:Crypto:Wallet:[WALLET]:[CRYPTO]  [AMOUNT] [CRYPTO] {[COST_BASIS] USD}
  Expenses:Crypto:Fees:Withdrawal         [FEE] [CRYPTO] {[COST_BASIS] USD}
  Assets:Crypto:[EXCHANGE]:[CRYPTO]      -[FEE] [CRYPTO] {[COST_BASIS] USD}
 
; مثال: انتقال BTC به Ledger
2024-01-20 * "انتقال 1 BTC از Coinbase به Ledger"
  Assets:Crypto:Coinbase:BTC      -1.0 BTC {45000.00 USD}
  Assets:Crypto:Wallet:Ledger:BTC  1.0 BTC {45000.00 USD}
  Expenses:Crypto:Fees:Withdrawal  0.0005 BTC {45000.00 USD}
  Assets:Crypto:Coinbase:BTC      -0.0005 BTC {45000.00 USD}

انتقال بین صرافی‌ها

; الگو: انتقال بین صرافی‌ها
YYYY-MM-DD * "انتقال [AMOUNT] [CRYPTO] از [EXCHANGE1] به [EXCHANGE2]"
  Assets:Crypto:[EXCHANGE1]:[CRYPTO]  -[AMOUNT] [CRYPTO] {[COST_BASIS] USD}
  Assets:Crypto:[EXCHANGE2]:[CRYPTO]   [AMOUNT] [CRYPTO] {[COST_BASIS] USD}
  Expenses:Crypto:Fees:Network         [FEE] [CRYPTO] {[COST_BASIS] USD}
  Assets:Crypto:[EXCHANGE1]:[CRYPTO]  -[FEE] [CRYPTO] {[COST_BASIS] USD}
 
; مثال: انتقال ETH از Coinbase به Binance
2024-02-05 * "انتقال 10 ETH از Coinbase به Binance"
  Assets:Crypto:Coinbase:ETH   -10 ETH {2500.00 USD}
  Assets:Crypto:Binance:ETH     10 ETH {2500.00 USD}
  Expenses:Crypto:Fees:Network  0.01 ETH {2500.00 USD}
  Assets:Crypto:Coinbase:ETH   -0.01 ETH {2500.00 USD}

الگوهای استیکینگ

استیکینگ Ethereum

; الگو: استیک ETH
YYYY-MM-DD * "استیک [AMOUNT] ETH"
  Assets:Crypto:Wallet:MetaMask:ETH    -[AMOUNT] ETH {[PRICE] USD}
  Assets:Staking:Ethereum:ETH           [AMOUNT] ETH {[PRICE] USD}
  Expenses:Crypto:Fees:Network          [FEE] ETH {[PRICE] USD}
  Assets:Crypto:Wallet:MetaMask:ETH    -[FEE] ETH {[PRICE] USD}
 
; مثال: استیک 32 ETH
2024-01-10 * "استیک 32 ETH در Ethereum 2.0"
  Assets:Crypto:Wallet:MetaMask:ETH    -32 ETH {2500.00 USD}
  Assets:Staking:Ethereum:ETH           32 ETH {2500.00 USD}
  Expenses:Crypto:Fees:Network          0.01 ETH {2500.00 USD}
  Assets:Crypto:Wallet:MetaMask:ETH    -0.01 ETH {2500.00 USD}

پاداش‌های استیکینگ

; الگو: دریافت پاداش‌های استیکینگ
YYYY-MM-DD * "[CRYPTO] پاداش‌های استیکینگ - [PERIOD]"
  Assets:Staking:[PROTOCOL]:[CRYPTO]    [AMOUNT] [CRYPTO] {[PRICE] USD}
  Income:Crypto:Staking:[CRYPTO]        [VALUE] USD
 
; مثال: پاداش‌های استیکینگ ETH
2024-02-01 * "پاداش‌های استیکینگ ETH - ژانویه"
  Assets:Staking:Ethereum:ETH     0.08 ETH {2600.00 USD}
  Income:Crypto:Staking:ETH      208.00 USD

الگوهای DeFi

تامین نقدینگی Uniswap

; الگو: افزودن نقدینگی به استخر Uniswap
YYYY-MM-DD * "افزودن نقدینگی به استخر [TOKEN1]-[TOKEN2]"
  Assets:Crypto:Wallet:MetaMask:[TOKEN1]    -[AMOUNT1] [TOKEN1] {[PRICE1] USD}
  Assets:Crypto:Wallet:MetaMask:[TOKEN2]    -[AMOUNT2] [TOKEN2] {[PRICE2] USD}
  Assets:DeFi:Uniswap:[TOKEN1]-[TOKEN2]-LP   [LP_AMOUNT] [LP_TOKEN] {[LP_PRICE] USD}
  Expenses:Crypto:Fees:Network               [FEE] ETH {[ETH_PRICE] USD}
  Assets:Crypto:Wallet:MetaMask:ETH         -[FEE] ETH {[ETH_PRICE] USD}
 
; مثال: افزودن نقدینگی ETH-USDC
2024-01-15 * "افزودن نقدینگی به استخر ETH-USDC"
  Assets:Crypto:Wallet:MetaMask:ETH     -10 ETH {2500.00 USD}
  Assets:Crypto:Wallet:MetaMask:USDC  -25000 USDC
  Assets:DeFi:Uniswap:ETH-USDC-LP        100 UNI-V3-ETH-USDC {500.00 USD}
  Expenses:Crypto:Fees:Network          0.02 ETH {2500.00 USD}
  Assets:Crypto:Wallet:MetaMask:ETH    -0.02 ETH {2500.00 USD}

وام‌دهی Compound

; الگو: تامین دارایی‌ها به Compound
YYYY-MM-DD * "تامین [AMOUNT] [TOKEN] به Compound"
  Assets:Crypto:Wallet:MetaMask:[TOKEN]  -[AMOUNT] [TOKEN]
  Assets:DeFi:Compound:c[TOKEN]           [C_AMOUNT] c[TOKEN] {[C_PRICE] USD}
  Expenses:Crypto:Fees:Network            [FEE] ETH {[ETH_PRICE] USD}
  Assets:Crypto:Wallet:MetaMask:ETH      -[FEE] ETH {[ETH_PRICE] USD}
 
; مثال: تامین USDC به Compound
2024-01-20 * "تامین 10000 USDC به Compound"
  Assets:Crypto:Wallet:MetaMask:USDC  -10000 USDC
  Assets:DeFi:Compound:cUSDC             500 cUSDC {20.00 USD}
  Expenses:Crypto:Fees:Network          0.008 ETH {2500.00 USD}
  Assets:Crypto:Wallet:MetaMask:ETH    -0.008 ETH {2500.00 USD}

الگوهای استخراج

پاداش‌های استخراج

; الگو: دریافت پاداش‌های استخراج
YYYY-MM-DD * "[CRYPTO] پاداش استخراج - [POOL/SOLO]"
  Assets:Crypto:Mining:[CRYPTO]     [AMOUNT] [CRYPTO] {[PRICE] USD}
  Income:Crypto:Mining:[CRYPTO]     [VALUE] USD
 
; مثال: پاداش استخراج Bitcoin
2024-01-15 * "پاداش استخراج BTC - استخر Slush"
  Assets:Crypto:Mining:BTC    0.01 BTC {45000.00 USD}
  Income:Crypto:Mining:BTC   450.00 USD

هزینه‌های استخراج

; الگو: هزینه‌های عملیاتی استخراج
YYYY-MM-DD * "استخراج [EXPENSE_TYPE] - [PERIOD]"
  Expenses:Crypto:Mining:[EXPENSE_TYPE]  [AMOUNT] USD
  Assets:Checking                       -[AMOUNT] USD
 
; مثال: هزینه‌های برق استخراج
2024-01-31 * "برق استخراج - ژانویه"
  Expenses:Crypto:Mining:Electricity  800.00 USD
  Assets:Checking                    -800.00 USD

الگوهای ایردراپ

ایردراپ‌های توکن

; الگو: دریافت ایردراپ توکن
YYYY-MM-DD * "[TOKEN] ایردراپ از [PROJECT]"
  Assets:Crypto:Wallet:[WALLET]:[TOKEN]  [AMOUNT] [TOKEN] {[PRICE] USD}
  Income:Crypto:Airdrops                 [VALUE] USD
 
; مثال: ایردراپ توکن UNI
2024-03-01 * "ایردراپ UNI از Uniswap"
  Assets:Crypto:Wallet:MetaMask:UNI  400 UNI {8.00 USD}
  Income:Crypto:Airdrops            3200.00 USD

الگوهای پیشرفته

آربیتراژ وام فلش

; الگو: آربیتراژ وام فلش
YYYY-MM-DD * "آربیتراژ وام فلش - [STRATEGY]"
  ; وام فلش
  Assets:Crypto:Temp:FlashLoan       [LOAN_AMOUNT] [TOKEN]
  Liabilities:DeFi:[PROTOCOL]:Flash -[LOAN_AMOUNT] [TOKEN]
  
  ; اجرای آربیتراژ
  Assets:Crypto:Temp:FlashLoan      -[LOAN_AMOUNT] [TOKEN]
  Assets:Crypto:Temp:Arbitrage       [RETURN_AMOUNT] [TOKEN]
  
  ; بازپرداخت وام فلش
  Liabilities:DeFi:[PROTOCOL]:Flash  [LOAN_AMOUNT] [TOKEN]
  Assets:Crypto:Temp:Arbitrage      -[LOAN_PLUS_FEE] [TOKEN]
  
  ; سود
  Assets:Crypto:Wallet:[WALLET]:[TOKEN]  [PROFIT] [TOKEN]
  Income:Crypto:Arbitrage               [PROFIT_USD] USD

پل زنجیره‌ای

; الگو: پل زدن دارایی‌ها بین زنجیره‌ها
YYYY-MM-DD * "پل زدن [AMOUNT] [TOKEN] از [CHAIN1] به [CHAIN2]"
  Assets:Crypto:[CHAIN1]:[TOKEN]     -[AMOUNT] [TOKEN] {[PRICE] USD}
  Assets:Crypto:[CHAIN2]:[TOKEN]      [AMOUNT] [TOKEN] {[PRICE] USD}
  Expenses:Crypto:Bridge:Fees         [FEE] [TOKEN] {[PRICE] USD}
  Assets:Crypto:[CHAIN1]:[TOKEN]     -[FEE] [TOKEN] {[PRICE] USD}
 
; مثال: پل زدن ETH به Polygon
2024-02-05 * "پل زدن 5 ETH از Ethereum به Polygon"
  Assets:Crypto:Ethereum:ETH     -5 ETH {2600.00 USD}
  Assets:Crypto:Polygon:ETH       5 ETH {2600.00 USD}
  Expenses:Crypto:Bridge:Fees    0.01 ETH {2600.00 USD}
  Assets:Crypto:Ethereum:ETH    -0.01 ETH {2600.00 USD}

الگوهای بهینه‌سازی مالیات

برداشت زیان مالیاتی

; الگو: برداشت زیان مالیاتی
YYYY-MM-DD * "برداشت زیان مالیاتی - فروش [CRYPTO] با ضرر"
  Assets:Crypto:[EXCHANGE]:[CRYPTO]    -[AMOUNT] [CRYPTO] {[HIGH_COST_BASIS] USD}
  Assets:Crypto:[EXCHANGE]:USD          [PROCEEDS] USD
  Expenses:Crypto:Fees:Trading          [FEE] USD
  Assets:Crypto:[EXCHANGE]:USD         -[FEE] USD
  Expenses:CapitalLoss:Crypto           [LOSS] USD
 
; مثال: برداشت زیان ADA
2024-12-15 * "برداشت زیان مالیاتی - فروش ADA با ضرر"
  Assets:Crypto:Binance:ADA      -1000 ADA {0.60 USD}
  Assets:Crypto:Binance:USD       445.00 USD
  Expenses:Crypto:Fees:Trading      5.00 USD
  Assets:Crypto:Binance:USD        -5.00 USD
  Expenses:CapitalLoss:Crypto     150.00 USD

سود سرمایه بلندمدت

; الگو: فروش سود سرمایه بلندمدت
YYYY-MM-DD * "فروش بلندمدت - [CRYPTO] نگهداری شده > 1 سال"
  date-acquired: "[PURCHASE_DATE]"
  holding-period: "[DAYS] days"
  Assets:Crypto:[EXCHANGE]:[CRYPTO]    -[AMOUNT] [CRYPTO] {[COST_BASIS] USD}
  Assets:Crypto:[EXCHANGE]:USD          [PROCEEDS] USD
  Expenses:Crypto:Fees:Trading          [FEE] USD
  Assets:Crypto:[EXCHANGE]:USD         -[FEE] USD
  Income:CapitalGains:LongTerm          [GAIN] USD
 
; مثال: فروش بلندمدت BTC
2025-02-01 * "فروش بلندمدت - BTC نگهداری شده 382 روز"
  date-acquired: "2024-01-15"
  holding-period: "382 days"
  Assets:Crypto:Coinbase:BTC    -1.0 BTC {45000.00 USD}
  Assets:Crypto:Coinbase:USD   55000.00 USD
  Expenses:Crypto:Fees:Trading    50.00 USD
  Assets:Crypto:Coinbase:USD     -50.00 USD
  Income:CapitalGains:LongTerm  9950.00 USD

الگوهای تطبیق

تأیید ماهانه موجودی

; الگو: ادعاهای تراز ماهانه
YYYY-MM-DD balance Assets:Crypto:[EXCHANGE]:[CRYPTO]  [EXPECTED_BALANCE] [CRYPTO]
YYYY-MM-DD balance Assets:Crypto:Wallet:[WALLET]:[CRYPTO]  [EXPECTED_BALANCE] [CRYPTO]
 
; مثال: تأیید تراز ژانویه
2024-01-31 balance Assets:Crypto:Coinbase:BTC    2.5 BTC
2024-01-31 balance Assets:Crypto:Binance:ETH    15.0 ETH
2024-01-31 balance Assets:Crypto:Wallet:Ledger:BTC  1.0 BTC

به‌روزرسانی قیمت

; الگو: به‌روزرسانی روزانه قیمت
YYYY-MM-DD price [CRYPTO] [PRICE] USD
 
; مثال: قیمت‌های روزانه
2024-01-15 price BTC 45000.00 USD
2024-01-15 price ETH 2500.00 USD
2024-01-15 price ADA 0.50 USD

دستورالعمل استفاده

  1. کپی کردن الگوی مربوطه برای نوع تراکنش شما
  2. جایگزینی Placeholders (نشان داده شده در [براکت‌ها]) با مقادیر واقعی
  3. تنظیم نام حساب‌ها برای مطابقت با ساختار حساب شما
  4. اضافه کردن فراداده (Metadata) در صورت نیاز برای گزارش مالیاتی یا ردیابی
  5. تأیید محاسبات قبل از نهایی کردن ورودی‌ها

بهترین روش‌ها

  • از قراردادهای نامگذاری سازگار استفاده کنید
  • شناسه‌های تراکنش را در فراداده‌ها (Metadata) قرار دهید
  • تراکنش‌های پیچیده را به طور کامل مستند کنید
  • نرخ ارز و قیمت‌ها را تأیید کنید
  • پشتیبان گیری منظم از فایل‌های خود را حفظ کنید

این الگوها یک پایه محکم برای حسابداری ارز دیجیتال در Beancount.io فراهم می‌کنند. آن‌ها را بر اساس نیازهای خاص و الگوهای معاملاتی خود سفارشی کنید.