How the Object Generator Works
The Object Generator is a dynamic, interactive tool that produces unique 3D digital objects based on an XRP account’s balance of OBJECT.
Each object evolves in size, complexity, and visual style as one's OBJECT balance increases—reflecting our commitment to growing an ecosystem of objects, as detailed in our whitepaper.
Privacy & Trust: No data is stored on our site. The XRP address is used solely to generate your object and is not saved or shared. This ensures complete privacy and security.
Overview
The Object Generator is designed with a modular architecture that combines responsive UI design with advanced 3D graphics. The system:
Seeds the generation process using the user's public XRP address.
Calculates a chaos factor based on the token balance, ensuring that higher balances yield larger and more intricate objects.
Simulates real-world physics: non-legendary objects fall and land, while legendary objects (balances ≥ 75,000) float.
Displays key information (truncated XRP address, object total, and object name) and allows users to download or refresh their generated object.
Architecture
UI Components
The menu is implemented as a blurred glass card with a bluish-gray gradient:
Resting State:
Title: "Object Generator" (in title case for clarity)
Input Row: Combines an XRP address input field with the "Generate My Object" button on the same horizontal line for optimal space use.
Footer Text: "10M+ Unique Forms" is displayed at the bottom, indicating the vast number of possible objects.
Post-Generation State: Once an object is generated, the menu transforms:
The input row is replaced with a compact display of the truncated XRP address (showing the first five characters, ellipsis, then the last four).
Additional rows display the object total and object name.
Download and Refresh buttons become visible, allowing users to save or regenerate their object.
Responsive Design
The layout adjusts dynamically for desktop and mobile devices:
On mobile, the address input and generate button are placed side by side to conserve vertical space.
Font sizes and padding are optimized for readability and ease of interaction on smaller screens.
3D Object Generation
Procedural Generation & Chaos Factor
The generator uses the XRP address and balance to seed a pseudo-random number generator. Key steps include:
Seed Calculation: A hash-like seed is created from the XRP address and token balance, ensuring that the same address always produces the same object.
Geometry Selection: The system randomly selects from various geometry types (Icosahedron, Torus Knot, Box, Cone, Cylinder, Sphere, and Torus). The selection probabilities are tuned to produce both smooth, organic shapes and sharp, shard-like forms.
Chaos Factor: For balances ≥ 50,000, a chaos factor (calculated logarithmically) is applied to increase both the distortion amplitude and the scale of the object. This results in objects that are dramatically larger and more unpredictable, reflecting higher levels of ownership.
Physics Simulation
Falling Animation: Non-legendary objects (balance < 75,000) are initially placed at a high starting position and then fall under simulated gravity until they settle on the ground.
Floating Effect: Legendary objects float at a predetermined height, with additional orbiting elements that enhance their visual prominence.
Address Truncation & UX Enhancements
Once the object is generated, the system automatically truncates the XRP address in the input field for a cleaner presentation:
The full address is shortened to display the first five characters, an ellipsis, and the last four characters (e.g.,
r12345...abcd).On refreshing, the original input field is restored for new entries.
Technical Considerations
Validated vs. Current Ledger
Our Object Generator fetches the XRP balance by querying the XRPL using the account_lines method with "ledger_index": "validated". This means that the balance is taken from the most recently validated ledger, ensuring that the data is confirmed and reliable. However, if you have very recent transactions, those updates may not be reflected immediately because they haven't been validated yet.
For users noticing a 0 balance despite holding OBJECT, it’s likely due to this slight delay in validation.
An alternative is to query the "ledger_index": "current" ledger, which would return more real-time data. However, this can lead to transient values and less consistent data, so we opted for the validated ledger for trust and stability.
xrplcluster.com
We use the public endpoint provided by xrplcluster.com to interact with the XRP Ledger. This service offers a reliable way to fetch ledger data (such as trust lines and balances) using standard API methods. By using xrplcluster.com, our application benefits from:
Data Consistency: Ensuring that balance data is fetched from a trusted, validated source.
Reliability: Reducing the chances of errors in data retrieval, although minor delays can occur with very recent transactions due to rate limits or caching. If a 0 balance persists, waiting a few hours is recommended for the updated balance to appear.
Integration and Ecosystem
The tool serves not only for creating unique digital collectibles but also as a visual representation of our commitment to building an ecology of objects on the XRP Ledger.
By reflecting token holdings in the generated 3D objects, we encourage community engagement and highlight the value of increasing one's stake in the ecosystem.
Conclusion
The Object Generator combines advanced 3D graphics, procedural generation, and responsive design to deliver a unique, interactive experience. It’s designed to evolve with its users—growing in complexity as token balances increase—and aligns with our vision for a robust, sustainable ecosystem of digital objects.
For further details, please refer to our Whitepaper.
Last updated