DEV Community

Daniel Ioni
Daniel Ioni

Posted on

📘 MyZubster Gateway - Developer Guide Complete Technical Documentation for Tari + Monero Asset Tokenization

#tari #guide #documentation #myzubster

Complete Technical Documentation for Tari + Monero Asset Tokenization
📚 Table of Contents

Project Overview

System Architecture

Technology Stack

Development Setup

Project Structure

API Reference

Token Management

Bounty System - "Spiccioli"

Docker Deployment

Database Management

Known Issues & TODOs

Contributing Guide

Useful Commands

Useful Links
Enter fullscreen mode Exit fullscreen mode
  1. Project Overview {#overview}

MyZubster Gateway is a complete infrastructure for tokenizing real-world assets on the Tari blockchain (a Layer 2 solution built on Monero).
🎯 Core Features

Asset Tokenization — Create and manage tokens representing real-world assets

Privacy First — All transactions inherit Monero's privacy features

Spiccioli Bounty System — Automated micro-bounties paid in Monero (XMR)

RWA Support — Real Estate, Art, Commodities, and more

Docker Native — Easy deployment with Docker Compose

GitHub Automation — Fully automated bounty workflow
Enter fullscreen mode Exit fullscreen mode

📊 Current Status
Component Status Port
Gateway API ✅ Running 3001
Dashboard UI ✅ Running 8080
MongoDB ✅ Running 27018
nginx ⚠️ Partial 80
MRE Token ✅ Active -
SRE Token ✅ Active -

  1. System Architecture {#architecture} text

┌─────────────────────────────────────────────────────────────────────────────┐
│ MyZubster Gateway │
│ │
│ ┌─────────────┐ ┌─────────────────────┐ ┌───────────────────┐ │
│ │ MONERO │──────│ TARI │──────│ TOKENIZED │ │
│ │ (Privacy) │ │ (Layer 2) │ │ ASSETS │ │
│ └─────────────┘ └─────────────────────┘ └───────────────────┘ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ ┌─────────────┐ ┌─────────────────────┐ ┌───────────────────┐ │
│ │ SPICCIOLI │──────│ MyZubster │──────│ INVESTORS │ │
│ │ (Bounty) │ │ Gateway (API) │ │ (Token Holders)│ │
│ └─────────────┘ └─────────────────────┘ └───────────────────┘ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ ┌─────────────┐ ┌─────────────────────┐ ┌───────────────────┐ │
│ │ DEVELOPERS │ │ DASHBOARD (UI) │ │ MONGODB │ │
│ │ (Contributors) │ (Node.js Proxy) │ │ (Database) │ │
│ └─────────────┘ └─────────────────────┘ └───────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────────┘

  1. Technology Stack {#stack} Layer Technology Blockchain Tari (Layer 2) · Monero (Privacy Layer) Backend Node.js · Express.js Database MongoDB Frontend HTML5 · CSS3 · Vanilla JS Infrastructure Docker · nginx · Cloudflare Tunnel CI/CD GitHub Actions Languages JavaScript · YAML · Shell

  2. Development Setup {#setup}
    📦 Prerequisites

    Node.js (v20+)

    Docker & Docker Compose

    MongoDB

    nginx

    Git

🚀 Quick Start
bash

1. Clone the repository

git clone https://github.com/yourusername/my-monero-bounty.git
cd my-monero-bounty

2. Start Docker containers

docker-compose up -d

3. Install dependencies

npm install

4. Start the dashboard server

node simple-server.js &

5. Access the dashboard

open http://localhost:8080

🐳 Docker Services
bash

Gateway container

docker run -d --name myzubster-gateway -p 3001:3000 myzubstergateway-gateway

MongoDB container

docker run -d --name myzubster-mongodb -p 27018:27017 mongo:7-jammy

Check status

docker ps

  1. Project Structure {#structure} text

my-monero-bounty/
├── .github/
│ ├── ISSUE_TEMPLATE/
│ │ └── spicciolo-issue.yml # Bounty issue template
│ └── workflows/
│ └── bounty.yml # GitHub Actions automation
├── static/
│ └── index.html # Dashboard UI
├── simple-server.js # Proxy server for dashboard
├── server.js # Main gateway (in Docker)
├── FUNDING.md # Funding documentation
├── PRIVACY.md # Privacy policy
├── CONTRIBUTING.md # Contributing guidelines
└── README.md # Project overview

  1. API Reference {#api}

Base URL: http://localhost:3001/api/ (Gateway) or http://localhost:8080/api/ (Proxy)
📡 Endpoints
GET /api/tokens

List all tokens
bash

curl -s http://localhost:3001/api/tokens | jq '.[] | {_id, name, symbol}'

GET /api/tokens/:id

Get token details by ID
bash

curl -s http://localhost:3001/api/tokens/6a5fd5ac6a0e1edf13e20a2b | jq '.'

GET /api/health

Health check endpoint
bash

curl -s http://localhost:3001/api/health | jq '.'

POST /api/tokens

Create a new token
bash

curl -X POST http://localhost:3001/api/tokens \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Singapore Real Estate",
"symbol": "SRE",
"totalSupply": 2000000,
"assetValue": 2000000,
"tokenPrice": 1,
"assetType": "realestate",
"assetLocation": "Singapore, Asia"
}' | jq '.'

  1. Token Management {#tokens} 📦 Current Tokens Token Symbol Value Supply Location Milano Real Estate MRE €1,000,000 1,000,000 Milano, Italy Singapore Real Estate SRE €2,000,000 2,000,000 Singapore, Asia 🔍 Token Operations

Get token details:
bash

curl -s http://localhost:3001/api/tokens/6a5fd5ac6a0e1edf13e20a2b | jq '.'

Create token via MongoDB:
bash

docker exec -it myzubster-mongodb mongosh -u admin -p '5Tz1FIrvGyoKfOT5Z1pe' --authenticationDatabase admin
use myzubster
db.tokens.insertOne({
name: "Singapore Real Estate",
symbol: "SRE",
totalSupply: 2000000,
assetValue: 2000000,
tokenPrice: 1,
contractAddress: "0x2e7bdaef39ac",
blockchain: "tari",
assetType: "realestate",
assetDescription: "Token che rappresenta un immobile a Singapore",
assetLocation: "Singapore, Asia",
issuer: "6a5f742332b226d34448d39c",
status: "active",
createdAt: new Date(),
updatedAt: new Date()
})

  1. Bounty System — "Spiccioli" {#bounty}

Spiccioli (Italian for "small change") is an automated micro-bounty system that pays contributors in Monero (XMR).
📂 File Structure
text

.github/
├── ISSUE_TEMPLATE/
│ └── spicciolo-issue.yml # Issue template for bounties
└── workflows/
└── bounty.yml # GitHub Actions automation

💰 Bounty Map
Label Bounty (XMR) Approx (USD)
good-first-issue 0.01 XMR ~$25
documentation 0.02 XMR ~$50
bug 0.05 XMR ~$125
feature 0.10 XMR ~$250
security 0.20 XMR ~$500
🔄 How It Works

User opens an issue using the "Spicciolo" template

Label is applied (e.g., "bug", "feature")

GitHub Action automatically adds a comment with the bounty amount

Developer claims: "I'll take this!"

Developer completes the task and submits a PR

After review and merge, the developer receives XMR payment
Enter fullscreen mode Exit fullscreen mode
  1. Docker Deployment {#docker} 🐳 Current Containers bash

docker ps

Container Image Ports Status
myzubster-gateway 7f73dbfd80b6 3001:3000 Up (healthy)
myzubster-mongodb mongo:7-jammy 27018:27017 Up (healthy)
🔧 Useful Docker Commands
bash

View logs

docker logs myzubster-gateway --tail 50
docker logs myzubster-mongodb --tail 50

Restart containers

docker restart myzubster-gateway myzubster-mongodb

Stop containers

docker stop myzubster-gateway myzubster-mongodb

Access container shell

docker exec -it myzubster-gateway /bin/bash
docker exec -it myzubster-mongodb /bin/bash

Inspect container

docker inspect myzubster-gateway
docker inspect myzubster-mongodb

  1. Database Management {#database} 🔑 MongoDB Credentials Variable Value Username admin Password 5Tz1FIrvGyoKfOT5Z1pe Database myzubster Host localhost Port 27018 📊 Connect to MongoDB bash

docker exec -it myzubster-mongodb mongosh -u admin -p '5Tz1FIrvGyoKfOT5Z1pe' --authenticationDatabase admin

📝 Common MongoDB Commands
javascript

// Show databases
show dbs

// Use database
use myzubster

// Show collections
show collections

// Find all tokens
db.tokens.find().pretty()

// Find specific token
db.tokens.find({ symbol: "SRE" }).pretty()

// Count tokens
db.tokens.count()

// Insert token
db.tokens.insertOne({
name: "Token Name",
symbol: "TKN",
totalSupply: 1000000,
// ...
})

// Delete token
db.tokens.deleteOne({ symbol: "SRE" })

// Update token
db.tokens.updateOne(
{ symbol: "SRE" },
{ $set: { status: "inactive" } }
)

  1. Known Issues & TODOs {#issues}
    ⚠️ Current Issues
    Issue Status Workaround
    Token Balance API not implemented 🔴 High Use MongoDB directly
    nginx configuration incomplete 🟡 Medium Use port 8080 directly
    Rate limiting active on myzubster.com 🟡 Medium Use localhost
    GitHub SSH key missing passphrase 🟡 Medium Re-add SSH key
    /api/tokens returns empty with auth 🔴 High Use MongoDB
    🔧 TODOs

    ☑

    Dashboard UI created and working on port 8080
    ☑

    MRE token created and active
    ☑

    SRE token created and active
    ☑

    Spiccioli bounty system configured
    □

    Fix nginx configuration
    □

    Implement /api/tokens/balance endpoint
    □

    Add wallet integration for XMR payments
    □

    Create mobile-responsive UI
    □

    Add authentication (JWT, OAuth)
    □

    Implement token transfer functionality
    □

    Add more asset types (Art, Commodities, etc.)

  2. Contributing Guide {#contributing}
    🤝 How to Contribute

    Fork the repository

    Claim an issue with the 🪙 bounty label

    Work on the task and submit a Pull Request

    Earn Monero (XMR) when your PR is merged

📝 Code Style

JavaScript: ES6+ with async/await

Follow the existing code structure

Write meaningful commit messages

Include tests if possible
Enter fullscreen mode Exit fullscreen mode

🔒 Security

Never expose API keys or secrets

Use environment variables for configuration

All sensitive data should be encrypted

Follow the privacy guidelines in PRIVACY.md
Enter fullscreen mode Exit fullscreen mode
  1. Useful Commands {#commands} 🔍 Quick Commands bash

Check all services

docker ps
ss -tlnp | grep -E "80|3001|8080|27018"

Test dashboard

curl -I http://localhost:8080

Test API

curl -s http://localhost:3001/api/health
curl -s http://localhost:3001/api/tokens

Test proxy

curl -s http://localhost:8080/api/tokens

View logs

sudo journalctl -u nginx -f
docker logs myzubster-gateway --tail 50
docker logs myzubster-mongodb --tail 50

Restart services

sudo systemctl restart nginx
docker restart myzubster-gateway myzubster-mongodb
pkill -f simple-server.js && node simple-server.js &

🛠️ Development Commands
bash

Start dashboard

cd /root/my-monero-bounty
node simple-server.js &

Enter MongoDB

docker exec -it myzubster-mongodb mongosh -u admin -p '5Tz1FIrvGyoKfOT5Z1pe' --authenticationDatabase admin

View tokens in MongoDB

use myzubster
db.tokens.find().pretty()

Create token via API (if working)

curl -X POST http://localhost:3001/api/tokens \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "New Token",
"symbol": "NTK",
"totalSupply": 1000000,
"assetValue": 1000000
}'

  1. Useful Links {#links} Resource URL Dashboard http://localhost:8080 API Gateway http://localhost:3001 Health Check http://localhost:3001/api/health Tokens List http://localhost:3001/api/tokens MongoDB mongodb://localhost:27018 GitHub https://github.com Tari https://tari.com Monero https://getmonero.org 📌 Quick Reference Card bash

Connect to server

ssh root@188.213.161.186

Dashboard

http://localhost:8080

API

http://localhost:3001

MongoDB Credentials

Username: admin
Password: 5Tz1FIrvGyoKfOT5Z1pe
Database: myzubster

Docker

docker ps
docker logs myzubster-gateway --tail 50
docker restart myzubster-gateway myzubster-mongodb

Proxy Server

cd /root/my-monero-bounty
node simple-server.js &

Happy coding! 🚀

Built with ❤️ on Tari · Powered by Monero

Top comments (0)