Screenshoot hasil

🐜 AnTS Groups (ATG) Token Ecosystem

AnTS Groups (ATG) adalah proyek aset digital berbasis Blockchain Solana yang terintegrasi dengan sistem backend Flask. Proyek ini bertujuan untuk mendemonstrasikan implementasi tokenisasi aset, manajemen supply, dan integrasi API Web3 yang efisien, cepat, dan transparan.

---

📋 Table of Contents (TOC)

1. Project Overview
2. Tokenomics & Specifications
3. Technical Architecture
4. Prerequisites
5. Installation & Setup
6. Environment Configuration
7. Running the Application
8. API Documentation
9. Blockchain Deployment History
10. Troubleshooting
11. License & Contact

---

🚀 Project Overview

Proyek ini menjembatani dunia Web2 (REST API) dengan Web3 (Solana Blockchain). Sistem ini memungkinkan aplikasi eksternal untuk berinteraksi dengan Token ATG tanpa perlu berinteraksi langsung dengan node RPC yang kompleks.

Fitur Utama:

• Real-time Supply Tracking: Memantau total supply ATG yang beredar.
• Wallet Balance Check: Memeriksa saldo ATG pengguna melalui API.
• Devnet Deployment: Dideploy di jaringan Solana Devnet untuk pengujian skalabilitas tanpa biaya gas riil.
• Metadata Integration: Mendukung tampilan Logo dan Nama Token pada wallet standar seperti Phantom.

---

💎 Tokenomics & Specifications

Detail teknis aset crypto yang dideploy:

Parameter	Detail
Token Name	AnTS Groups
Ticker/Symbol	ATG
Blockchain Network	Solana Devnet
Mint Address	GvkpfMKBMhMKmyhMTqqVbhWMtHDyZaneKajAaDNhNERV
Decimals	9 (Standard SOL)
Standard	SPL Token (Legacy)
Total Supply	1,000,000,000 (1 Billion)
Authority Wallet	Protected (Server-Side)

---

🏗 Technical Architecture

Sistem dibangun dengan tumpukan teknologi berikut:

• Blockchain Layer: Solana (High throughput, Low latency).

• Middleware: Flask (Python Microframework).

• SDK/Library:

• solana-py: Interaksi RPC Node.

• solders: Manajemen Keypair & Pubkey.

• spl-token-cli: Manajemen Token Command Line.

• Infrastructure: Ubuntu/WSL Environment.

---

🛠 Prerequisites

Sebelum menjalankan proyek, pastikan sistem Anda memiliki:

1. Python 3.8+
2. Solana CLI Tools (v1.18+)
3. Node.js (Opsional, untuk tools metadata)
4. Phantom Wallet (Browser Extension)

---

⚙️ Installation & Setup

Ikuti langkah-langkah ini untuk menjalankan server lokal:

1. Clone Repository

git clone https://github.com/username/ants-groups-token.git
cd ants-groups-token

2. Virtual Environment Setup

Disarankan menggunakan virtual environment agar dependencies tidak bentrok.

# Windows
python -m venv venv
venv\Scripts\activate

# Linux/Mac/WSL
python3 -m venv venv
source venv/bin/activate

3. Install Dependencies

pip install -r requirements.txt

Pastikan requirements.txt berisi: flask, python-dotenv, solana, solders, requests.

---

🔐 Environment Configuration

Keamanan adalah prioritas utama. Buat file .env di root folder proyek dan isi konfigurasi berikut:

# File: .env

# Jalur koneksi ke Blockchain (Devnet)
RPC_URL=https://api.devnet.solana.com

# Alamat Smart Contract Token ATG
ATG_MINT_ADDRESS=GvkpfMKBMhMKmyhMTqqVbhWMtHDyZaneKajAaDNhNERV

# (Opsional) Private Key Authority - JANGAN SHARE INI
# Format Array JSON: [12, 44, 21, ...]
AUTHORITY_PRIVATE_KEY=[ISI_KEYPAIR_ARRAY_ANDA_DISINI]

---

▶️ Running the Application

Jalankan server Flask:

python app.py

Jika sukses, terminal akan menampilkan:

🚀 AnTS Groups (ATG) Server Berjalan...
🔗 Terhubung ke Token: GvkpfMKBMhMKmyhMTqqVbhWMtHDyZaneKajAaDNhNERV
 * Running on http://0.0.0.0:5000

---

📡 API Documentation

Berikut adalah endpoint yang tersedia untuk integrasi Frontend:

1. Health Check

Memastikan sistem berjalan dan terhubung ke token yang benar.

• URL: /
• Method: GET
• Response:

{
  "project": "AnTS Groups (ATG)",
  "status": "Active on Solana Devnet",
  "mint_address": "Gvkpf..."
}

2. Get Token Supply

Mendapatkan total supply token yang beredar saat ini.

• URL: /api/supply
• Method: GET
• Response:

{
  "token": "ATG",
  "total_supply": 1000000000.0,
  "decimals": 9
}

3. Check User Balance

Mengecek saldo ATG milik user tertentu.

• URL: /api/holders/<WALLET_ADDRESS>
• Method: GET
• Example: /api/holders/2QvE3rLgUne8S1PWoWpDy8j4P3QdLDzSA2CHDoMpx5TD
• Response:

{
  "wallet": "2QvE3r...",
  "atg_balance": 1000.0
}

---

📜 Blockchain Deployment History

Dokumentasi perintah CLI yang digunakan untuk mendeploy token ini (untuk referensi audit):

1. Create Token:

spl-token create-token --decimals 9 atg-mint.json

2. Create Account:

spl-token create-account GvkpfMKBMhMKmyhMTqqVbhWMtHDyZaneKajAaDNhNERV

3. Initial Minting:

spl-token mint GvkpfMKBMhMKmyhMTqqVbhWMtHDyZaneKajAaDNhNERV 1000000000

4. Metadata Update: Dilakukan via Metaplex Token Standard dengan URI: https://api.npoint.io/5af50af27a1ffcf0c4bf

---

🔧 Troubleshooting

Q: Token muncul sebagai "Unknown Token" di Phantom.

• A: Metadata belum terindeks. Lakukan "Update Metadata" menggunakan tool seperti Guarnic atau Metaplex dan pastikan URI JSON valid.

Q: Error "Unfunded Recipient" saat transfer.

• A: Wallet penerima belum memiliki saldo SOL. Lakukan solana airdrop 1 <ALAMAT_PENERIMA> atau gunakan flag --allow-unfunded-recipient.

Q: Koneksi API Lambat.

• A: Solana Devnet publik sering mengalami rate-limit. Untuk produksi, gunakan RPC privat (Helius/QuickNode).

---

📄 License & Contact

License: APACHE 2 License. Free for educational and commercial use.

Developed by:

• Name: Ananda Rauf Maududi
• Role: Blockchain Developer & Founder
• Organization: PT Ananda Technology Solution
• Certification: BNSP Blockchain Expert

---