Skip to content

This content is available in Polish only. A translation is in preparation.

Knowledge base

On-chain i off-chain w tokenizacji - jak podzielić odpowiedzialność systemu, żeby Twój projekt działał naprawdę

8 min
Table of contents (9)
  1. Wprowadzenie
  2. On-chain off-chain tokenizacja - co tu tak naprawdę „żyje”?
  3. Architektura projektu tokenowego - jak podzielić system na warstwy
  4. Dane blockchain a dokumenty - kto co przechowuje i za co odpowiada
  5. Most między on-chain i off-chain - gdzie najczęściej rodzi się ryzyko
  6. Jak praktycznie zaprojektować system tokenizacji krok po kroku
  7. Porozmawiajmy o Twoim projekcie
  8. Źródła
  9. Najczęstsze pytania

W tokenizacji kluczowy jest mądry podział odpowiedzialności między warstwę on-chain i off-chain. Smart kontrakt to tylko fragment układanki – równie ważne są dokumenty, procesy i most łączący dane blockchain z realnymi aktywami.

W skrócie

  • Podział na on-chain i off-chain określa, co w projekcie tokenizacji zapisuje się w blockchainie, co zostaje poza nim i kto odpowiada za połączenie obu warstw.
  • Na łańcuchu zapisuje się tylko reprezentację aktywa, czyli stan tokenów, historię transferów i reguły emisji, a same aktywa, prawa, dokumenty i KYC pozostają off-chain.
  • Najwięcej ryzyk pojawia się na granicy warstw, dlatego przed pisaniem kontraktu trzeba zdefiniować roszczenie inwestora, ułożyć macierz odpowiedzialności i wskazać osoby odpowiedzialne za procedury.

Wprowadzenie

Powiedzieli: „Wrzucimy aktywa na blockchain i będzie po problemie”. Brzmiało nieźle, dopóki pierwszy inwestor nie zapytał: „A gdzie w dokumentach jest napisane, co ja naprawdę kupuję?”. W tym momencie stało się jasne, że bez mądrego podziału odpowiedzialności między on-chain i off-chain cała magia Web3 zamienia się w cyfrową iluzję.

W świecie, w którym prawa do nieruchomości, wierzytelności, licencji czy przepływów z biznesu można zapisać w tokenie, kluczowe pytanie brzmi już nie „jak napisać smart kontrakt”, tylko: jak zaprojektować system tokenizacji, żeby dane na blockchainie i dokumenty w kancelarii mówiły to samo.

„Inwestowanie powinno być bardziej jak oglądanie farby, która schnie, lub trawy, która rośnie. Jeśli chcesz emocji… weź 800 dolarów i jedź do Las Vegas.”

- Paul Samuelson

W Tokenuj patrzymy na tokeny właśnie w ten „nudny” sposób: jako inżynierię procesów, a nie fajerwerki. W tym tekście pokażemy Ci, jak podzielić odpowiedzialność systemu między on-chain i off-chain tak, żeby Twoja emisja była nie tylko ciekawa, ale przede wszystkim spójna, zrozumiała i gotowa na poważnych inwestorów.

On-chain off-chain tokenizacja - co tu tak naprawdę „żyje”?

Zacznijmy od brutalnie prostego faktu: żaden budynek, maszyna, umowa najmu ani udział w spółce nie „mieszka” na blockchainie. Na łańcuchu zapisujemy tylko reprezentację - cyfrowy rekord, który odnosi się do czegoś w świecie prawnym lub fizycznym.

W praktyce:

  • On-chain - to, co istnieje w smart kontraktach i ledgerze: stan tokenów, historia transferów, reguły emisji i wykupu, czasem skróty (hash) dokumentów.
  • Off-chain - to, co istnieje poza blockchainem: realne aktywa, struktura prawna, dokumenty, KYC, procesy operacyjne, custodia, obsługa inwestorów.

Dlatego gdy mówimy „on-chain off-chain tokenizacja”, tak naprawdę projektujemy relację:

  • między rekordem (token, eventy w kontrakcie),
  • a rzeczywistością (aktywa, prawa, umowy, przepływy pieniężne).

Dojrzały projekt nigdy nie udaje, że token „sam z siebie” daje prawo do czegokolwiek. Jasno opisuje:

  • co token reprezentuje,
  • co rejestrujemy on-chain,
  • jak i gdzie dochodzi się praw wynikających z tokena off-chain.

To właśnie różni projekty gotowe na pytania inwestorów instytucjonalnych od tych, które kończą jako ciekawostka z ładną grafiką.

Architektura projektu tokenowego - jak podzielić system na warstwy

Najprostszy sposób, żeby uporządkować odpowiedzialność, to spojrzeć na architekturę projektu tokenowego jako na trzy warstwy, które współpracują, ale mają różne zadania.

  • Warstwa off-chain aktywa i prawa - realny biznes, spółka, SPV, umowy, rejestry właścicielskie, księgowość, KYC.
  • Warstwa mostu (bridge) - dokumenty i procedury, które mówią, w jaki sposób token odzwierciedla to, co jest off-chain.
  • Warstwa on-chain - smart kontrakty, logika emisji, transfery, blokady, zdarzenia na blockchainie.

W oparciu o analizowane materiały da się z tego ułożyć praktyczną matrycę podziału zadań:

ObszarCo dzieje się on-chainCo dzieje się off-chainTypowy odpowiedzialny

Reprezentacja aktywa

ID tokena, typ tokena, podaż, reguły emisji/spalania

Umowy, statut, struktura SPV, tytuły prawne

Emitent, kancelaria prawna

Transfery i obrót

Transfery, blokady, logika whitelist/blacklist

Rejestry inwestorów, KYC/AML, ograniczenia jurysdykcyjne

Emitent, dostawca KYC

Dochody i wykup

Eventy dystrybucji, burn przy wykupie

Przelewy fiat/stablecoin, rozliczenia podatkowe, cashflow z aktywa

Emitent, księgowość, operator płatności

Dowody i audyt

Hash dokumentów, logi zdarzeń

Pełne dokumenty, raporty audytowe, kontrole

Emitent, audytor, depozytariusz

Zauważ jedną rzecz: żaden wiersz nie jest „czysto on-chain”. Zawsze jest para: zapis w kontrakcie plus konsekwencja prawna lub finansowa poza nim. W projektach, w których pomagamy klientom zaprojektować tworzenie tokenów, ta matryca staje się fundamentem - zanim powstanie pierwsza linijka kodu.

Dane blockchain a dokumenty - kto co przechowuje i za co odpowiada

Pytanie „czy wszystko da się wrzucić na blockchain?” pojawia się w każdym projekcie prędzej czy później. Odpowiedź brzmi: technicznie czasem tak, biznesowo i prawnie - bardzo rzadko warto.

Dane blockchain są świetne do:

  • utrwalania stanu posiadania (kto ile tokenów ma),
  • zapisywania historii zdarzeń (emisje, transfery, wykupy),
  • egzekwowania prostych reguł (limity, lock-up, whitelist).

Dokumenty i systemy off-chain są niezastąpione, gdy:

  • definiujesz prawa inwestorów (umowa, regulamin, statut),
  • musisz spełnić wymagania regulacyjne i podatkowe,
  • przetwarzasz dane wrażliwe (RODO, dane osobowe, KYC).

Rozsądne połączenie wygląda zwykle tak:

  • pełna treść dokumentu jest przechowywana w bezpiecznym repozytorium off-chain,
  • na blockchainie trzymasz hash dokumentu (dowód, że określona wersja istniała w konkretnym momencie),
  • w warstwie aplikacji inwestor może zobaczyć aktualny dokument i powiązane zdarzenia on-chain w jednym miejscu.

W praktyce oznacza to, że system tokenizacji musi łączyć świat ledgerów z dobrze uporządkowanym światem dokumentów. Token bez dokumentów jest bezużyteczny, ale dokumenty bez czytelnych danych on-chain tracą na przejrzystości i zaufaniu. Dlatego warstwę dokumentów projektujemy równolegle z kontraktem - w ramach doradztwa prawnego i zgodności z regulacjami sprawdzamy, czy to, co token obiecuje w kodzie, ma pokrycie w umowie, regulaminie i wymogach regulacyjnych.

Most między on-chain i off-chain - gdzie najczęściej rodzi się ryzyko

Jeśli gdzieś coś ma „strzelić”, to najczęściej w warstwie, która łączy dane blockchain z realnym aktywem. W materiałach źródłowych ta warstwa nazywana jest często bridge layer lub warstwą „connection”. My w Tokenuj nazywamy ją po prostu: „tu albo będzie porządek, albo będzie pozew”.

Ten most obejmuje:

  • opis w dokumentach, co dokładnie reprezentuje token,
  • procedury aktualizacji danych off-chain, gdy zmienia się stan aktywa,
  • role i uprawnienia - kto może zarządzać zmianami (np. wykup, restrukturyzacja),
  • integracje techniczne (API, orakle, synchronizacje danych).

Typowe scenariusze ryzyka:

  • dokumenty mówią jedno, komunikacja marketingowa drugie, smart kontrakt milczy,
  • brak jasnej procedury, co się dzieje z tokenami, gdy aktywo zostaje sprzedane lub zniszczone,
  • jeden klucz prywatny daje komuś za dużo władzy nad całym systemem,
  • nikt nie odpowiada operacyjnie za „manualne” skutki zmian on-chain (np. przelew środków, aktualizacja rejestru).

W projektach opartych o real world assets ta warstwa jest w praktyce ważniejsza niż sam standard tokena. Dlatego zanim wybierzemy ERC-20 czy ERC-721, dopisujemy do systemu odpowiedzialności konkretne nazwiska i procedury. Token może działać automatycznie, ale aktywo i pieniądze nigdy nie robią się „same”.

Jak praktycznie zaprojektować system tokenizacji krok po kroku

Żeby nie zostać w teorii, spójrzmy na prosty schemat projektowania, który możesz zastosować do swojej firmy.

  1. Najpierw definiujesz roszczenie, dopiero potem token
    Zaczynasz od pytania: czego dokładnie będzie dotyczył udział inwestora? Strumienia przychodów, akcji PSA lub S.A., udziału w zysku z projektu, prawa do wykupu? To opisujesz w dokumentach prawnych, nie w kodzie. Smart kontrakt ma tylko odzwierciedlić ten model, nie go tworzyć.
  2. Ustalasz, co ma żyć on-chain, a co off-chain
    Patrzysz na każdy element systemu i zadajesz trzy pytania:
    - czy to musi być publiczne i niezmienne,
    - czy zawiera dane wrażliwe,
    - czy będzie się często zmieniać.
    Dane nieosobowe, krytyczne dla zaufania i relatywnie stabilne - świetni kandydaci na on-chain. Dane osobowe, podatkowe, rozproszone dokumenty - spokojnie zostają off-chain, spięte hashami i procedurami.
  3. Budujesz prostą matrycę odpowiedzialności
    Dla każdego obszaru (emisja, obrót, dystrybucja dochodów, wykup, komunikacja z inwestorem) wpisujesz:
    - który komponent on-chain bierze udział,
    - który system off-chain bierze udział,
    - kto podpisuje się imieniem i nazwiskiem pod procesem.
    Taka macierz jest później bezcenna przy audytach, due diligence i rozmowach z poważnymi inwestorami.
  4. Projektujesz integracje i „plan B” na błędy
    Zakładasz, że coś kiedyś pójdzie nie tak: transakcja nie dojdzie, orakl przestanie działać, ktoś wyśle środki na zły adres. Architektura projektu tokenowego powinna już na starcie uwzględniać:
    - jak wykrywasz rozjazd on-chain/off-chain,
    - jak przywracasz spójność,
    - kto ma mandat, żeby to zrobić.
  5. Ostatni etap - implementacja smart kontraktów i panelu
    Dopiero gdy wiesz, co ma gdzie żyć i kto za to odpowiada, ma sens pisać kontrakt i dashboard. Wtedy tokenizacja przestaje być eksperymentem technologii, a staje się przewidywalnym procesem emisji i zarządzania inwestorami.

Taki sposób myślenia wymaga trochę więcej pracy na początku, ale bardzo mocno upraszcza wszystko później: od rozmów z prawnikami, przez onboardowanie inwestorów, po skalowanie kolejnych emisji.

Porozmawiajmy o Twoim projekcie

Jeśli czujesz, że Twoja firma jest gotowa na tokenizację, ale chcesz zrobić to mądrze - z jasnym podziałem odpowiedzialności on-chain/off-chain i realnym zaufaniem inwestorów - zróbmy to razem. Porozmawiajmy o Twoim projekcie i zaplanujmy architekturę systemu, zanim ktokolwiek wyśle pierwszą złotówkę.

Źródła

Najczęstsze pytania

  • On-chain to smart kontrakty i dane w blockchainie: stan tokenów, historia transferów i automatyczne reguły. Off-chain to realne aktywa, struktura prawna, dokumenty, KYC, operacje finansowe i obsługa inwestorów. Token odzwierciedla rzeczywiste prawa tylko wtedy, gdy obie warstwy są spójne.

  • Nie. Na blockchainie można zapisać tylko reprezentację aktywa lub praw, a samo aktywo pozostaje osadzone w systemie prawnym i rejestrach off-chain. Tokenizacja łączy rekord on-chain z dokumentami i procedurami.

  • Na łańcuchu warto trzymać dane nieosobowe, które budują zaufanie: stan tokenów, historię transferów, reguły emisji i skróty dokumentów. Dokumenty prawne, KYC, dane podatkowe oraz często zmieniane lub poufne szczegóły aktywów zostają off-chain.

  • W warstwie mostu, która łączy dane blockchain z realnym aktywem. Typowe scenariusze to dokumenty sprzeczne z komunikacją marketingową, brak procedury na wypadek sprzedaży lub zniszczenia aktywa, jeden klucz prywatny z nadmierną władzą nad systemem oraz brak osoby odpowiedzialnej za operacyjne skutki zmian on-chain.

  • Nie. Nawet bezbłędny kod nie naprawi niejasnych dokumentów, słabej struktury prawnej ani braku procedur operacyjnych. Bez spójnej architektury on-chain i off-chain oraz zdefiniowanych odpowiedzialności projekt może pozostawać ryzykowny dla biznesu i inwestorów.

Information only, not legal advice. As of 7 November 2026.

Zespół Tokenuj

Knowledge baseIn Polish

Stan prawny tokenizacji w Polsce

Polska nie ma ustawy o rynku kryptoaktywów i nie wyznaczyła organu nadzoru, a MiCA obowiązuje bezpośrednio. Zbieramy w jednym miejscu, co to znaczy dla emitenta: stanowisko UKNF o white paperze, ścieżkę tokenów objętych MiCA i ścieżkę tokenów dochodowych. Wpis aktualizujemy co miesiąc.

Read the article: Stan prawny tokenizacji w Polsce

Knowledge baseIn Polish

Spółka z o.o. a tokeny: PSA, S.A. lub token oparty na przychodzie. Zobacz praktyczny proces krok po kroku

Spółka z o.o. nie może oferować udziałów nieoznaczonym odbiorcom, a token nie staje się udziałem. Zobacz krok po kroku, jak w polskich realiach zaplanować strukturę opartą na PSA, S.A. lub tokenie opartym na przychodzie i jakie ryzyka ocenić przed decyzją.

Read the article: Spółka z o.o. a tokeny: PSA, S.A. lub token oparty na przychodzie. Zobacz praktyczny proces krok po kroku

Free consultation

Let's talk about tokenizing your asset

Tell us about your project. Within 24 hours we will come back with a time for a call where we assess the tokenization potential, the issuance model and the next steps.

  • Reply within 24h
  • No obligation
  • Confidential (NDA)
Michał Chodzynski – Founder
You will talk to MichałMichał Chodzynski · Founder

Your choice is stored for 12 months in the essential cookie “tk_consent”. Privacy policy