Tokenized Protocol primary sources
Reviewed: 2026-05-13 UTC
Core project framing
- https://github.com/tokenized
- Official GitHub organization page for Tokenized; useful as the canonical project root and for linking the docs and specification repositories.
- https://github.com/tokenized/docs
- Main protocol documentation repository.
- https://github.com/tokenized/specification
- Versioned protocol-specification repository with generated language bindings and serialization details.
Protocol and serialization layer
- https://raw.githubusercontent.com/tokenized/docs/master/protocol-intro.md
- Best short source for how Tokenized actions are wrapped in the Tokenized envelope protocol and encoded as protobuf payloads inside Bitcoin OP_RETURN data.
- https://raw.githubusercontent.com/tokenized/specification/master/README.md
- Best source for the specification repository’s purpose: YAML-defined message structures, generated bindings, and the protocol identifiers / serialization flow used for Tokenized messages.
Identity-oracle and compliance layer
- https://raw.githubusercontent.com/tokenized/docs/master/concepts-oracles.md
- Strongest source for the identity-oracle model, including contract approval signatures, transfer approval signatures, identity verification signatures, recent-block-hash expiry, and the idea that multiple identity oracles can coexist for one smart contract.
Governance and permissions layer
- https://raw.githubusercontent.com/tokenized/docs/master/concepts-permissions.md
- Best source for the WXYZ-plus-voting-system permission encoding that controls which fields can be changed unilaterally, by referendum, by initiative, or by administrator-only governance.
- https://raw.githubusercontent.com/tokenized/docs/master/concepts-governance.md
- Best source for proposal / vote / ballot / result flow, including the distinction between administration-led referendums and token-holder initiatives.
Enforcement and operating rules
- https://raw.githubusercontent.com/tokenized/docs/master/concepts-enforcement.md
- Strongest source for freeze, thaw, confiscation, and reconciliation actions, including legal-order hash references and authority-signature hooks.
- https://raw.githubusercontent.com/tokenized/docs/master/concepts-rules.md
- Useful global rules source for request/response action structure, contract-address anchoring, and lifecycle constraints for contract, instrument, transfer, governance, and enforcement actions.
Transfer and settlement workflow
- https://raw.githubusercontent.com/tokenized/docs/master/concepts-instrument-transfers.md
- Best source for transfer-versus-settlement decomposition, multi-recipient settlement, token-for-bitcoin sales, and cross-contract atomic-swap workflow.
Main takeaways from this pass
- Tokenized Protocol is best understood as a full tokenized-asset operating environment, not just a Bitcoin token format.
- The most useful lower-layer split is between the message grammar itself and the issuer/governance/compliance logic carried inside that grammar.
- Identity approval sits in signed oracle responses rather than only in token-local policy state, which makes oracle trust and oracle plurality first-class control surfaces.
- Governance is unusually field-specific: amendment authority can be configured per field and tied to different vote mechanisms rather than only to one global admin role.
- Enforcement is explicit and protocol-native. Freeze, thaw, confiscation, and reconciliation are described as named action families rather than informal admin capabilities.
- Tokenized belongs in comparison sets with ERC-3643, ONCHAINID, Tokeny, Chainlink ACE, and Dusk because it exposes a different architecture for the same broader problem: how regulated asset control, identity gating, governance, and settlement get composed.