Xyxyx
  • Overview
  • Introduction
  • Technology
  • Xyxyx Text-Based Tokenization Architecture (XTBTA)
    • Data Encoding
    • Data Architecture
  • Text-Based Tokens (TBTs)
  • Tokenization Models
    • 1x1
      • Specifications
    • A4
      • Specifications
  • Token Standards
    • ERC-721F
      • Parameters
    • ERC-404
      • Parameters
    • ERC-721
      • Parameters
  • Products & Services
    • API
      • Boilerplate
    • Launchpad
      • Using Launchpad
        • Usage Policies
      • Xy
      • Changelog
    • Tokenizer
  • Explorer
  • Protocol
    • XYXYX
      • Tokenomics
      • Xyxyx Issuer Nodes (XINs)
      • XYHASH
    • Governance
      • Xyxyx Improvement Proposals (XIPs)
      • Treasury Management Proposals (TMPs)
      • Resubmit a proposal
    • Treasury
  • Miscellaneous
    • Ecosystem
    • Addresses
    • Links
    • Brand Assets
Powered by GitBook
On this page
  • Overview
  • Key Features
  • Functionality
  • Fundamentals
  • On-Chain Data Storage
  1. Xyxyx Text-Based Tokenization Architecture (XTBTA)

Data Encoding

PreviousXyxyx Text-Based Tokenization Architecture (XTBTA)NextData Architecture

Last updated 8 days ago

Overview

The incorporates an entirely blockchain-based framework for the generation and lifecycle management of.

Instead of relying on IPFS or centralized servers for metadata storage and retrieval, XTBTA stores all relevant information — including the token’s visual representation — entirely within the Ethereum blockchain.

TBTs are visually rendered using SVG (Scalable Vector Graphics), encoded in Base64, and embedded in the smart contract’s metadata delivery. As a result, this ensures each token is fully self-contained, tamper-proof, and persistently accessible.


Key Features

Base64-Encoded SVG Outputs

TBTs utilize SVG to represent token visuals in a scalable, resolution-independent manner.

These SVG documents are programmatically generated and encoded in Base64. XTBTA proposes the encoding of each TBT's SVG output into a Base64 string that is embedded in a JSON object, which is itself Base64-encoded and returned as a tokenURI.


On-Chain Data Delivery

Each TBT implements the tokenURI() function as defined by the ERC-721 standard. However, unlike conventional implementations that return a pointer to external JSON metadata, TBTs contracts return a fully self-contained, Base64-encoded metadata object. This object includes the encoded SVG visual and any relevant descriptive fields — delivered entirely from within the smart contract; without the need for off-chain servers.

As a result, XTBTA ensures that front-ends, indexers, and explorers can interpret and render the token without accessing any external infrastructure.


Functionality

Through XTBTA, each token’s metadata is programmatically constructed and encoded directly within the smart contract. This approach ensures that all descriptive and visual elements — such as the token’s name, description, and image — are embedded on-chain in a self-contained format.

The following example illustrates the step-by-step process through which a token’s metadata is constructed, encoded, and prepared for delivery via the tokenURI function:

  1. Base64-Encoded Token URI

data:application/json;base64,eyJuYW1lIjogIlh5eHl4ICMxIiwgImRlc2NyaXB0aW9uIjogIiIsICJpbWFnZSI6ICJkYXRhOmltYWdlL3N2Zyt4bWw7YmFzZTY0LFBITjJaeUI0Yld4dWN6MGlhSFIwY0RvdkwzZDNkeTUzTXk1dmNtY3ZNakF3TUM5emRtY2lJSGRwWkhSb1BTSXpNREFpSUdobGFXZG9kRDBpTXpBd0lqNDhiV1YwWVdSaGRHRStRblZwYkhRZ2IyNGdXSGw0ZVhnOFpHVnpZejROQ25zTkNpQWdJblJ2YTJWdVgybGtJam9nSWxSQ1NVeE1MVGt4TWpjNU5sZFJOQ0lzRFFvZ0lDSnBjM04xWlhJaU9pQWlTaTVVTGlJc0RRb2dJQ0pwYm5OMGNuVnRaVzUwWDNSNWNHVWlPaUFpVkhKbFlYTjFjbmtnUW1sc2JDSXNEUW9nSUNKMFpYSnRJam9nSWpFeklIZGxaV3R6SWl3TkNpQWdJbU4xYzJsd0lqb2dJamt4TWpjNU5sZFJOQ0lzRFFvZ0lDSnBjM04xWlY5a1lYUmxJam9nSWpJd01qVXRNRFV0TURFaUxBMEtJQ0FpYldGMGRYSnBkSGxmWkdGMFpTSTZJQ0l5TURJMUxUQTNMVE14SWl3TkNpQWdJbVJwYzJOdmRXNTBYM0poZEdVaU9pQWlOUzR4TWlVaUxBMEtJQ0FpWm1GalpWOTJZV3gxWlY5MWMyUWlPaUF4TURBd0xBMEtJQ0FpY0hWeVkyaGhjMlZmY0hKcFkyVmZkWE5rSWpvZ09UZzNMakl3TEEwS0lDQWlkR2x0WlhOMFlXMXdJam9nSWpJd01qVXRNRFV0TVRGVU1UVTZOREk2TURCYUlnMEtmUTBLUEM5a1pYTmpQand2YldWMFlXUmhkR0UrUEhKbFkzUWdkMmxrZEdnOUlqRXdNQ1VpSUdobGFXZG9kRDBpTXpBd2NIZ2lJR1pwYkd3OUlpTm1abVptWm1ZaUlHSnZjbVJsY2xKaFpHbDFjejBpTVRCd2VDSWdjbmc5SWpFd0lpQnllVDBpTVRBaVBqd3ZjbVZqZEQ0OGRHVjRkQ0I0UFNJeE1DSWdlVDBpTWpBaUlHWnZiblF0YzJsNlpUMGlNVEJ3ZUNJZ1ptbHNiRDBpSXpBd01EQXdNQ0krUEhSemNHRnVJSGc5SWpFd0lpQmtlVDBpTUNJZ1ptOXVkQzFtWVcxcGJIazlJaWRCY21saGJDY3NJSE5oYm5NdGMyVnlhV1lpSUdadmJuUXRjMmw2WlQwaU1UQndlQ0krVkZKRlFWTlZVbGtnUWtsTVRDQlNSVU5QVWtROEwzUnpjR0Z1UGp4MGMzQmhiaUI0UFNJeE1DSWdaSGs5SWpFdU1tVnRJaUJtYjI1MExXWmhiV2xzZVQwaUowRnlhV0ZzSnl3Z2MyRnVjeTF6WlhKcFppSWdabTl1ZEMxemFYcGxQU0l4TUhCNElqNHRMUzB0TFMwdExTMHRMUzB0TFMwdExTMHRMUzB0TFMwdExTMHRMUzB0TFMwdExTMHRMUzB0SUNBOEwzUnpjR0Z1UGp4MGMzQmhiaUI0UFNJeE1DSWdaSGs5SWpFdU1tVnRJaUJtYjI1MExXWmhiV2xzZVQwaUowRnlhV0ZzSnl3Z2MyRnVjeTF6WlhKcFppSWdabTl1ZEMxemFYcGxQU0l4TUhCNElqNUpjM04xWlhJNklFb3VWQzQ4TDNSemNHRnVQangwYzNCaGJpQjRQU0l4TUNJZ1pIazlJakV1TW1WdElpQm1iMjUwTFdaaGJXbHNlVDBpSjBGeWFXRnNKeXdnYzJGdWN5MXpaWEpwWmlJZ1ptOXVkQzF6YVhwbFBTSXhNSEI0SWo1SmJuTjBjblZ0Wlc1ME9pQXhNeTFYWldWcklGUXRRbWxzYkNBZ1BDOTBjM0JoYmo0OGRITndZVzRnZUQwaU1UQWlJR1I1UFNJeExqSmxiU0lnWm05dWRDMW1ZVzFwYkhrOUlpZEJjbWxoYkNjc0lITmhibk10YzJWeWFXWWlJR1p2Ym5RdGMybDZaVDBpTVRCd2VDSStRMVZUU1ZBNklEa3hNamM1TmxkUk5DQWdQQzkwYzNCaGJqNDhkSE53WVc0Z2VEMGlNVEFpSUdSNVBTSXhMakpsYlNJZ1ptOXVkQzFtWVcxcGJIazlJaWRCY21saGJDY3NJSE5oYm5NdGMyVnlhV1lpSUdadmJuUXRjMmw2WlQwaU1UQndlQ0krU1hOemRXVWdSR0YwWlRvZ01qQXlOUzB3TlMwd01TQWdQQzkwYzNCaGJqNDhkSE53WVc0Z2VEMGlNVEFpSUdSNVBTSXhMakpsYlNJZ1ptOXVkQzFtWVcxcGJIazlJaWRCY21saGJDY3NJSE5oYm5NdGMyVnlhV1lpSUdadmJuUXRjMmw2WlQwaU1UQndlQ0krVFdGMGRYSnBkSGtnUkdGMFpUb2dNakF5TlMwd055MHpNU0FnUEM5MGMzQmhiajQ4ZEhOd1lXNGdlRDBpTVRBaUlHUjVQU0l4TGpKbGJTSWdabTl1ZEMxbVlXMXBiSGs5SWlkQmNtbGhiQ2NzSUhOaGJuTXRjMlZ5YVdZaUlHWnZiblF0YzJsNlpUMGlNVEJ3ZUNJK1JHbHpZMjkxYm5RZ1VtRjBaVG9nTlM0eE1pVWdJRHd2ZEhOd1lXNCtQSFJ6Y0dGdUlIZzlJakV3SWlCa2VUMGlNUzR5WlcwaUlHWnZiblF0Wm1GdGFXeDVQU0luUVhKcFlXd25MQ0J6WVc1ekxYTmxjbWxtSWlCbWIyNTBMWE5wZW1VOUlqRXdjSGdpUGtaaFkyVWdWbUZzZFdVNklDUXhMREF3TUNBZ1BDOTBjM0JoYmo0OGRITndZVzRnZUQwaU1UQWlJR1I1UFNJeExqSmxiU0lnWm05dWRDMW1ZVzFwYkhrOUlpZEJjbWxoYkNjc0lITmhibk10YzJWeWFXWWlJR1p2Ym5RdGMybDZaVDBpTVRCd2VDSStVSFZ5WTJoaGMyVWdVSEpwWTJVNklDUTVPRGN1TWpBOEwzUnpjR0Z1UGp3dmRHVjRkRDQ4TDNOMlp6ND0ifQ==

The tokenURI is composed of a Base64-encoded JSON object that contains all the metadata associated with the token.


  1. Base64 Decoded to JSON

{"name": "TBILL-912796WQ4 #4", "description": "", "image": "data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIzMDAiIGhlaWdodD0iMzAwIj48bWV0YWRhdGE+QnVpbHQgb24gWHl4eXg8ZGVzYz4NCnsNCiAgInRva2VuX2lkIjogIlRCSUxMLTkxMjc5NldRNCIsDQogICJpc3N1ZXIiOiAiSi5ULiIsDQogICJpbnN0cnVtZW50X3R5cGUiOiAiVHJlYXN1cnkgQmlsbCIsDQogICJ0ZXJtIjogIjEzIHdlZWtzIiwNCiAgImN1c2lwIjogIjkxMjc5NldRNCIsDQogICJpc3N1ZV9kYXRlIjogIjIwMjUtMDUtMDEiLA0KICAibWF0dXJpdHlfZGF0ZSI6ICIyMDI1LTA3LTMxIiwNCiAgImRpc2NvdW50X3JhdGUiOiAiNS4xMiUiLA0KICAiZmFjZV92YWx1ZV91c2QiOiAxMDAwLA0KICAicHVyY2hhc2VfcHJpY2VfdXNkIjogOTg3LjIwLA0KICAidGltZXN0YW1wIjogIjIwMjUtMDUtMTFUMTU6NDI6MDBaIg0KfQ0KPC9kZXNjPjwvbWV0YWRhdGE+PHJlY3Qgd2lkdGg9IjEwMCUiIGhlaWdodD0iMzAwcHgiIGZpbGw9IiNmZmZmZmYiIGJvcmRlclJhZGl1cz0iMTBweCIgcng9IjEwIiByeT0iMTAiPjwvcmVjdD48dGV4dCB4PSIxMCIgeT0iMjAiIGZvbnQtc2l6ZT0iMTBweCIgZmlsbD0iIzAwMDAwMCI+PHRzcGFuIHg9IjEwIiBkeT0iMCIgZm9udC1mYW1pbHk9IidBcmlhbCcsIHNhbnMtc2VyaWYiIGZvbnQtc2l6ZT0iMTBweCI+VFJFQVNVUlkgQklMTCBSRUNPUkQ8L3RzcGFuPjx0c3BhbiB4PSIxMCIgZHk9IjEuMmVtIiBmb250LWZhbWlseT0iJ0FyaWFsJywgc2Fucy1zZXJpZiIgZm9udC1zaXplPSIxMHB4Ij4tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tICA8L3RzcGFuPjx0c3BhbiB4PSIxMCIgZHk9IjEuMmVtIiBmb250LWZhbWlseT0iJ0FyaWFsJywgc2Fucy1zZXJpZiIgZm9udC1zaXplPSIxMHB4Ij5Jc3N1ZXI6IEouVC48L3RzcGFuPjx0c3BhbiB4PSIxMCIgZHk9IjEuMmVtIiBmb250LWZhbWlseT0iJ0FyaWFsJywgc2Fucy1zZXJpZiIgZm9udC1zaXplPSIxMHB4Ij5JbnN0cnVtZW50OiAxMy1XZWVrIFQtQmlsbCAgPC90c3Bhbj48dHNwYW4geD0iMTAiIGR5PSIxLjJlbSIgZm9udC1mYW1pbHk9IidBcmlhbCcsIHNhbnMtc2VyaWYiIGZvbnQtc2l6ZT0iMTBweCI+Q1VTSVA6IDkxMjc5NldRNCAgPC90c3Bhbj48dHNwYW4geD0iMTAiIGR5PSIxLjJlbSIgZm9udC1mYW1pbHk9IidBcmlhbCcsIHNhbnMtc2VyaWYiIGZvbnQtc2l6ZT0iMTBweCI+SXNzdWUgRGF0ZTogMjAyNS0wNS0wMSAgPC90c3Bhbj48dHNwYW4geD0iMTAiIGR5PSIxLjJlbSIgZm9udC1mYW1pbHk9IidBcmlhbCcsIHNhbnMtc2VyaWYiIGZvbnQtc2l6ZT0iMTBweCI+TWF0dXJpdHkgRGF0ZTogMjAyNS0wNy0zMSAgPC90c3Bhbj48dHNwYW4geD0iMTAiIGR5PSIxLjJlbSIgZm9udC1mYW1pbHk9IidBcmlhbCcsIHNhbnMtc2VyaWYiIGZvbnQtc2l6ZT0iMTBweCI+RGlzY291bnQgUmF0ZTogNS4xMiUgIDwvdHNwYW4+PHRzcGFuIHg9IjEwIiBkeT0iMS4yZW0iIGZvbnQtZmFtaWx5PSInQXJpYWwnLCBzYW5zLXNlcmlmIiBmb250LXNpemU9IjEwcHgiPkZhY2UgVmFsdWU6ICQxLDAwMCAgPC90c3Bhbj48dHNwYW4geD0iMTAiIGR5PSIxLjJlbSIgZm9udC1mYW1pbHk9IidBcmlhbCcsIHNhbnMtc2VyaWYiIGZvbnQtc2l6ZT0iMTBweCI+UHVyY2hhc2UgUHJpY2U6ICQ5ODcuMjA8L3RzcGFuPjwvdGV4dD48L3N2Zz4="}

When the Base64-encoded JSON object is decoded, it reveals a JSON structure in which the "image" field contains another Base64-encoded string — representing an embedded SVG image.


  1. JSON Base64 Decoded to XML

<svg xmlns="http://www.w3.org/2000/svg" width="300" height="300"><metadata>Built on Xyxyx<desc>
{
  "token_id": "TBILL-912796WQ4",
  "issuer": "J.T.",
  "instrument_type": "Treasury Bill",
  "term": "13 weeks",
  "cusip": "912796WQ4",
  "issue_date": "2025-05-01",
  "maturity_date": "2025-07-31",
  "discount_rate": "5.12%",
  "face_value_usd": 1000,
  "purchase_price_usd": 987.20,
  "timestamp": "2025-05-11T15:42:00Z"
}
</desc></metadata><rect width="100%" height="300px" fill="#ffffff" borderRadius="10px" rx="10" ry="10"></rect><text x="10" y="20" font-size="10px" fill="#000000"><tspan x="10" dy="0" font-family="'Arial', sans-serif" font-size="10px">TREASURY BILL RECORD</tspan><tspan x="10" dy="1.2em" font-family="'Arial', sans-serif" font-size="10px">----------------------------------------  </tspan><tspan x="10" dy="1.2em" font-family="'Arial', sans-serif" font-size="10px">Issuer: J.T.</tspan><tspan x="10" dy="1.2em" font-family="'Arial', sans-serif" font-size="10px">Instrument: 13-Week T-Bill  </tspan><tspan x="10" dy="1.2em" font-family="'Arial', sans-serif" font-size="10px">CUSIP: 912796WQ4  </tspan><tspan x="10" dy="1.2em" font-family="'Arial', sans-serif" font-size="10px">Issue Date: 2025-05-01  </tspan><tspan x="10" dy="1.2em" font-family="'Arial', sans-serif" font-size="10px">Maturity Date: 2025-07-31  </tspan><tspan x="10" dy="1.2em" font-family="'Arial', sans-serif" font-size="10px">Discount Rate: 5.12%  </tspan><tspan x="10" dy="1.2em" font-family="'Arial', sans-serif" font-size="10px">Face Value: $1,000  </tspan><tspan x="10" dy="1.2em" font-family="'Arial', sans-serif" font-size="10px">Purchase Price: $987.20</tspan></text></svg>

Decoding the Base64 string found in the "image" field of the JSON metadata produces the XML markup that renders the SVG graphic associated with the token.


  1. SVG Output

The XML code, once decoded, generates the final SVG output — a visual representation embedded in the token metadata.


Fundamentals

Immutability

All metadata, visuals, and descriptive content related to TBTs are embedded in Ethereum’s state at the time of contract deployment or token minting. This guarantees the permanence and non-repudiation of each token’s identity and attributes.


Reliability

By eliminating external storage endpoints, XTBTA avoids common points of failure such as broken links, misconfigured servers, or expired hosting plans. The on-chain-only model substantially reduces operational risk.


Transparency

TBTs are fully observable on-chain. Developers and end users can inspect all token attributes, metadata, and rendering logic directly via smart contract interfaces — enabling frictionless auditing and trustless attesting.


Censorship Resistance

TBTs access and visibility cannot be obstructed by third-party services or centralized infrastructure providers.


Data Longevity

As long as the Ethereum network persists, all TBTs data remains accessible and verifiable, ensuring digital persistence without reliance on third-party hosting or re-indexing services.


Auditability

All state changes, token interactions, and logic executions are recorded immutably on-chain. This enables verifiable and reproducible audits by any third party without requiring privileged access.


Attestability

Users and systems can cryptographically attest to the authenticity and provenance of TBTs based solely on their on-chain presence. This trustless verification model removes reliance on off-chain registries or authorities.


Composability

TBTs are designed to be both immutable blockchain records and highly composable data files. Their SVG-based structure allows them to be easily accessed and integrated into other applications or systems, facilitating seamless interoperability and reuse in various contexts.


On-Chain Data Storage

Through XTBTA, 100% of each token’s data is stored fully on-chain, ensuring immutability, transparency, and complete independence from external, off-chain data storage systems such as IPFS.

Below we provide a comparison table between on-chain vs. off-chain data storage:

Criteria
On-Chain Data Storage
Off-Chain Data Storage

Immutability

Fully immutable once minted; embedded in Ethereum state

Content is immutable (via content hash), but links can be changed by referencing new hashes

Availability

Guaranteed as long as the Ethereum network exists

Requires external pinning to ensure persistent availability

Censorship Resistance

Cannot be removed or blocked

Resistant to censorship, but depends on gateway access or node hosting

Reliability

No external dependencies or servers needed

Relies on external nodes and pinning services

Transparency

100% transparent and queryable via smart contracts

Metadata is viewable if hash is known, but less transparent in contract context

Performance

Fast read access on-chain; no external lookups

Requires external fetch, which may introduce latency

Auditability

Fully auditable and verifiable on-chain

Auditable if hash is on-chain, but file contents need off-chain verification

Data Longevity

Data lives as long as Ethereum does

Data longevity depends on pinning and external upkeep

Xyxyx Text-Based Tokenization Architecture (XTBTA)
Text-Based Tokens (TBTs)