Як перенести історію криптовалютних транзакцій з одного трекера в інший
Зміна трекера портфеля може здаватися простим перенесенням файлу. Найскладніше — зберегти деталі, які пояснюють кожен запис: з якого гаманця він надійшов, чи був переказ внутрішнім і яку примітку ви до нього додали. CSV-файл може містити видимі транзакції, але не зберігати мітки чи інший контекст. Якщо все перенести уважно, у новому трекері ви матимете придатну до використання історію та надійне джерело для звірки, якщо щось не збігатиметься.
Якщо ви шукаєте, як перенести історію криптовалютних транзакцій в інший трекер, сприймайте це як міграцію, а не імпорт одним натисканням. Цільовий сервіс може інтерпретувати ті самі рядки інакше, особливо якщо його поля чи правила відрізняються від тих, що використовує стара програма. Наведені нижче перевірки допоможуть виявити відмінності, перш ніж ви почнете покладатися на новий трекер.
1. Визначте, що потрібно перенести
Спершу визначте обсяг перенесення. Запишіть потрібний діапазон дат, усі гаманці й акаунти на біржах, додані до старого трекера, а також записи, які мають з’явитися в новому. Не обмежуйтеся угодами: важливими можуть бути також депозити, виведення коштів, комісії, винагороди за стейкінг, аірдропи й перекази між вашими власними гаманцями.
Перевірте не лише список транзакцій. Якщо ви користувалися мітками, власними примітками, коригуваннями собівартості чи назвами акаунтів, визначте, чи потрібно перенести й ці дані. Переказ із позначкою «між моїми гаманцями» означає не те саме, що виведення на невідому адресу, навіть якщо в обох рядках зазначено вихідний рух активу. Щоб з’ясувати, як зберегти мітки та примітки під час перенесення криптопортфеля, перевірте, чи входять вони до експорту, і за потреби збережіть їх окремо.
Перш ніж експортувати дані, складіть короткий перелік. Наприклад, до нього можуть увійти два акаунти на біржах, три гаманці та всі записи від дня початку користування старим трекером до останнього повністю завершеного дня. Цей перелік стане контрольним списком для нового сервісу й допоможе виявити акаунт, який було підключено, але не включено до міграції.
2. Перевірте, що може імпортувати новий трекер
Перш ніж готувати файли, ознайомтеся з актуальною документацією щодо імпорту в новому трекері. Перевірте, які формати він підтримує, які типи транзакцій розпізнає та яких стовпців очікує. Функції сервісів можуть змінюватися, тож звіряйтеся з актуальною документацією трекера щодо обмежень, підтримуваних полів і принципів імпорту, а не покладайтеся на застарілий посібник.
Порівняйте ці відомості з доступними способами експорту зі старого трекера. Одна програма може формувати загальний CSV-файл, а інша — окремі файли для угод, переказів і винагород. Новий трекер може приймати CSV, але вимагати певних назв стовпців, або ж дозволяти підключення до біржі, не імпортуючи старі примітки. Якщо вам потрібно розібратися, як імпортувати криптотранзакції з CSV, спершу перевірте вимоги до формату й назв стовпців у цільовому сервісі. Ці прогалини слід усунути до початку перенесення.
Особливу увагу приділіть типам транзакцій. Якщо в новому трекері немає відповідної категорії для певної винагороди чи коригування, не позначайте їх без пояснень як угоду. Перевірте рекомендації сервісу або запитайте його службу підтримки, як позначити такий запис. Неправильна категорія може вплинути на подальші звіти, навіть якщо кількість активу відображається правильно.
3. Збережіть записи зі старого трекера, перш ніж щось змінювати
Перш ніж редагувати дані або щось від’єднувати, збережіть локальну копію вихідних даних. Покладіть оригінальні файли експорту в папку з чіткою назвою, а в імені кожного файлу вкажіть трекер і діапазон дат. Якщо стара програма дає змогу окремо експортувати транзакції, мітки, примітки чи налаштування акаунтів, збережіть і їх.
Не перезаписуйте оригінальні файли, коли прибираєте стовпці для імпорту. Натомість створіть робочу копію. Якщо ви випадково зміните значення або пакет даних буде відхилено, зможете порівняти відредагований файл із вихідним. Зазвичай достатньо простого архіву лише для читання — головне, щоб незмінена версія залишалася доступною.
Якщо в експорт не потрапляють примітки чи налаштування, збережіть їх іншим способом. Скріншот із датою або короткий письмовий опис можуть стати в пригоді, хоча й не замінять структурованих даних. Наприклад, запишіть, що певна мітка гаманця в старій програмі стосувалася вашого апаратного гаманця, а не біржового акаунта. Збережіть цю інформацію разом з експортом.
4. Зіставте поля вихідного й нового трекерів
Перш ніж імпортувати дані, порівняйте стовпці у вихідному й цільовому файлах один за одним. Щонайменше перевірте часові мітки, позначення активів, кількість, комісії, ідентифікатори транзакцій і мітки. З’ясуйте, чи вимагає новий трекер певного формату дати, окремого поля для комісії або коду активу, відмінного від позначення у вихідному файлі.
Не вгадуйте, якщо поле не має очевидного відповідника. Якщо у вихідному файлі тип транзакції зазначено в одному стовпці, а в новому тип і напрямок розділено, з’ясуйте, як правильно зіставити ці дані. Неправильне зіставлення може перетворити депозит на угоду або зробити вихідний переказ схожим на продаж. Позначте непевні поля й перевірте їх за актуальною документацією.
Уважно перевірте часові мітки. У старому трекері може використовуватися місцевий час, тоді як новий відображає час за UTC або перетворює дати відповідно до налаштувань акаунта. Запис, зроблений близько до півночі, після імпорту може відображатися іншого календарного дня — це не означає, що він зник. Порівнюйте часову мітку й ідентифікатор транзакції, а не лише дату на екрані.
Позначення активів також можуть бути неоднозначними. Якщо два активи мають схожі назви або трекер використовує перейменоване позначення, перш ніж підтверджувати зіставлення, перевірте, що йдеться саме про той актив. Для транзакцій у блокчейні відрізнити записи з однаковою датою та сумою допоможуть ідентифікатор транзакції або адреса гаманця.
5. Імпортуйте дані в контрольованій послідовності
Почніть із невеликої репрезентативної вибірки, а не завантажуйте всі файли одразу. Виберіть кілька записів із різними сценаріями: угоду з комісією, вхідний і вихідний перекази, а також запис із власною міткою. Імпортуйте їх у новий трекер і перевірте, як відобразилися записи, перш ніж продовжувати.
Переконайтеся, що новий трекер правильно інтерпретував кожен тестовий запис. Перевірте актив, кількість, часову мітку, комісію, тип транзакції та всі доступні примітки. Якщо в попередньому перегляді імпорту є попередження або дані потрапили не в ті стовпці, зупиніться й виправте робочий файл. Невеликий тест допоможе уникнути масштабного виправлення помилок.
Коли тестова вибірка виглядатиме правильно, імпортуйте решту історії частинами. Залежно від інструкцій трекера, можна розділити файли за акаунтами чи діапазонами дат. Записуйте назву кожного імпортованого файлу й дату імпорту. Якщо один пакет не завантажиться, цей журнал допоможе визначити, що ще залишилося перенести, і не повторювати весь процес.
Якщо пакет відхилено, збережіть повідомлення про помилку та файл, який не вдалося імпортувати. Не завантажуйте той самий файл знову й знову, доки не з’ясуєте, чи не створив перший запуск частину записів.
6. Уникайте дублікатів і звірте підсумки
Перш ніж імпортувати дані, перевірте, чи не синхронізує новий трекер ті самі гаманці або біржі. Якщо підключення акаунта активне, сервіс міг уже завантажити частину або всю історію. Імпорт файлу поверх синхронізованих записів може створити дублікати, навіть якщо рядки майже однакові.
З’ясуйте, як новий трекер виявляє дублікати. Якщо це незрозуміло, перш ніж завантажувати всю історію, перевірте один відомий запис або зверніться до служби підтримки.
Після кожного пакета порівнюйте дані нового трекера з вихідними. Звірте кількість транзакцій для того самого акаунта й діапазону дат, а потім порівняйте залишки в кількох часових точках. Перевірте типові депозити, виведення коштів, угоди й комісії. Самого збігу підсумків недостатньо: дві відсутні транзакції та два дублікати можуть взаємно компенсуватися.
Перекази між вашими власними гаманцями потребують особливої уваги. Старий трекер може показувати вихідну й вхідну транзакції окремо, тоді як новий — об’єднувати їх в один внутрішній переказ. Переконайтеся, що сума активу не враховується двічі як прибуток чи збиток. Якщо за переказ стягується комісія мережі, перевірте, чи відображається вона окремою витратою, якщо новий трекер підтримує таку можливість.
7. Виправте розбіжності та змінені записи
Перевірте відхилені рядки, попередження про імпорт і записи, які новий трекер класифікував інакше. Відсутність ідентифікатора транзакції може завадити зіставленню; порожнє поле комісії для одного запису може бути допустимим, а для іншого — ні. Виправляйте запис у новому трекері або робочий файл для імпорту лише після перевірки вихідних даних.
Зверніть увагу на зміщення часового поясу та зміну категорій транзакцій. Якщо запис відображається на сусідню дату, перш ніж вважати його відсутнім, порівняйте точну часову мітку та ідентифікатор. Якщо винагорода відображається як звичайний депозит, перевірте, чи є в новому трекері відповідніша категорія та чи вплине її зміна на звіти.
Ведіть журнал міграції із зазначенням назви файлу, дати імпорту, знайдених помилок і внесених виправлень. Наприклад, занотуйте, що один рядок було прив’язано не до того гаманця, оскільки у вихідному файлі експорту не було мітки гаманця. Такий список змін спростить подальшу перевірку й допоможе пояснити, чому дані в новому трекері відрізняються від незміненого вихідного файлу.
8. Перевірте міграцію, перш ніж відмовлятися від старого трекера
Не від’єднуйте старий трекер одразу після завершення імпорту. Спершу перевірте, чи перенесено весь потрібний діапазон дат, чи представлені всі гаманці й біржові акаунти, а також чи збереглися важливі примітки й мітки або чи були вони збережені окремо. Ще раз перевірте записи з тестової вибірки та всі рядки, щодо яких з’являлися попередження.
Збережіть підсумкові файли імпорту та результати звірки разом із вихідними експортами. Якщо ви вносили виправлення, збережіть і незмінений файл, і виправлену робочу версію, надавши їм зрозумілі назви. Так у вас залишиться історія переходу від вихідного запису до запису в новому трекері, якщо через кілька місяців доведеться з’ясовувати причину розбіжності.
Лише після цих перевірок вирішуйте, чи від’єднувати старий трекер або припиняти ним користуватися. Якщо сервіс це дозволяє, можна певний час залишити доступ лише для читання. Якщо ж ви закриваєте акаунт, переконайтеся, що зберегли всі потрібні дані й що ключові транзакції, залишки та примітки доступні для перегляду в новому трекері.
