پرش به مطلب اصلی

بازپرداخت صندوق

نمای کلی​

این مستندات، پیاده‌سازی بازپرداخت صندوق در سیستم استیبل‌کوین زربان را پوشش می‌دهد. SDK قابلیت‌هایی برای بازپرداخت صندوق‌های موجود، مدیریت تراکنش‌ها و ثبت جزئیات بازپرداخت با استفاده از Web3 و API زربان را فراهم می‌کند.

پیش‌نیازها​

  • نصب Web3
  • نصب Zarban SDK
  • دسترسی به نود اتریوم (آدرس RPC)
  • کلید خصوصی با موجودی کافی

نصب​

pip install zarban

اجزای اصلی​

۱. تبدیل مقادیر​

to_native(amount)​

مقدار قابل خواندن توسط انسان را به فرمت بومی بلاکچین (wei) تبدیل می‌کند.

پارامترها:

  • amount (float): مقداری که باید تبدیل شود

خروجی:

  • str: مقدار به فرمت بومی بلاکچین

مثال:

native_amount = to_native(1.5)

۲. پردازش تراکنش بازپرداخت صندوق​

get_vault_tx_steps(api, wallet_address, vault_id, amount)​

مراحل تراکنش برای بازپرداخت صندوق را بازیابی می‌کند.

پارامترها:

  • api (StableCoinSystemApi): نمونه کلاینت API
  • wallet_address (str): آدرس کیف پول کاربر
  • vault_id (int): شناسه صندوقی که باید بازپرداخت شود
  • amount (float): مقدار بازپرداخت

خروجی:

  • tuple: (تعداد مراحل، شماره مرحله، مراحل)

۳. مدیریت تراکنش​

wait_for_transaction_receipt(w3, tx_hash, max_wait_time=120, check_interval=15)​

منتظر تأیید تراکنش می‌ماند.

پارامترها:

  • w3: نمونه Web3
  • tx_hash: هش تراکنش
  • max_wait_time: حداکثر زمان انتظار به ثانیه
  • check_interval: فاصله بررسی به ثانیه

خروجی:

  • رسید تراکنش یا None

۴. ثبت تراکنش​

save_transaction_details(tx, tx_hash)​

جزئیات تراکنش را در یک فایل JSON ذخیره می‌کند.

پارامترها:

  • tx: شیء تراکنش
  • tx_hash: هش تراکنش

مثال پیاده‌سازی کامل​

#Configuration
HTTPS_RPC_URL = "your_ethereum_node_url"
PRIVATE_KEY = "your_private_key"
WALLET_ADDRESS = get_address_from_private_key(PRIVATE_KEY)

#Setup API client

configuration = Configuration(host="https://testapi.zarban.io")
api_client = ApiClient(configuration)
stable_coin_system_api = StableCoinSystemApi(api_client)

#Setup Web3

w3 = Web3(Web3.HTTPProvider(HTTPS_RPC_URL))

#Vault repayment parameters

VAULT_ID = 123 # Replace with your actual vault ID
REPAYMENT_AMOUNT = 500 # Replace with your actual repayment amount

#Repay vault

num_of_steps, step_number, steps = get_vault_tx_steps(
stable_coin_system_api,
WALLET_ADDRESS,
VAULT_ID,
REPAYMENT_AMOUNT
)

جریان تراکنش​

۱. مقداردهی اولیه

  • راه‌اندازی کلاینت API و اتصال Web3
  • پیکربندی پارامترهای بازپرداخت صندوق

۲. مراحل تراکنش

  • بازیابی مراحل بازپرداخت صندوق
  • پردازش هر مرحله به ترتیب
  • مدیریت امضا و ارسال تراکنش

۳. نظارت بر تراکنش

  • انتظار برای تأیید تراکنش
  • ثبت جزئیات تراکنش

۴. تأیید نتیجه

  • بررسی لاگ‌های تراکنش برای بازپرداخت موفق

مدیریت خطا​

try:
    #Vault repayment code
except ApiException as e:
    print(f"Response body: {beautify_json(e.body)}")
except Exception as e:
    print(f"Unexpected error: {e}")

نکات مهم​

۱. امنیت

  • هرگز کلیدهای خصوصی را در کد قرار ندهید
  • از متغیرهای محیطی برای داده‌های حساس استفاده کنید
  • تمام پارامترهای تراکنش را قبل از امضا تأیید کنید

۲. مدیریت تراکنش

  • همیشه منتظر تأیید تراکنش‌ها بمانید
  • مدیریت خطای مناسب را پیاده‌سازی کنید
  • تمام تراکنش‌ها را برای حسابرسی ثبت کنید

۳. مدیریت گس1

  • از محدودیت‌های گس مناسب استفاده کنید
  • قیمت‌های گس را نظارت کنید
  • مکانیزم‌های تلاش مجدد برای تراکنش‌های ناموفق را پیاده‌سازی کنید

ثبت و نظارت​

سیستم یک فایل ثبت تراکنش (repay_transaction_log.json) را با اطلاعات زیر نگهداری می‌کند:

  • زمان
  • جزئیات تراکنش
  • هش تراکنش

مثال ورودی لاگ:

{
  "timestamp": "2024-03-13T10:00:00",
  "tx": {
    "from": "0x...",
    "to": "0x...",
    "value": "1000000000000000",
    "gas": 200000
  },
  "tx_hash": "0x..."
}

محدودیت‌ها و ملاحظات​

۱. وابستگی‌های شبکه

  • نیاز به اتصال پایدار شبکه دارد
  • وابسته به وضعیت شبکه اتریوم است
  • ممکن است تحت تأثیر ازدحام شبکه قرار گیرد

۲. نیازمندی‌های منابع

  • ETH کافی برای هزینه‌های گس
  • دسترسی معتبر به API

۳. زمان‌بندی تراکنش

  • زمان‌های تأیید تراکنش متغیر است
  • حداکثر زمان انتظار قابل تنظیم است
  • ممکن است نیاز به چندین مرحله داشته باشد

عیب‌یابی​

۱. مشکلات اتصال

if not w3.is_connected():
    print(f"Failed to connect to {HTTPS_RPC_URL}")
    exit(1)

۲. شکست تراکنش‌ها

  • قیمت‌ها و محدودیت‌های گس را بررسی کنید
  • موجودی حساب را تأیید کنید
  • وضعیت شبکه را بررسی کنید

۳. خطاهای API

  • اعتبارنامه‌های API را تأیید کنید
  • پارامترهای درخواست را بررسی کنید
  • پاسخ‌های خطا را بررسی کنید

پشتیبانی​

برای پشتیبانی بیشتر یا گزارش اشکالات، لطفاً با تیم پشتیبانی Zarban تماس بگیرید یا به مستندات API مراجعه کنید.

همچنین ببینید​

  1. gas↩