Proje

Geliştiriciler için

FAIRDRUM kodu MIT lisansıyla açıktır: sözleşme, site, başlatma betikleri ve testler tek bir depo (bağlantı yayımlandıktan sonra burada görünecek) içinde yer alır. Burada her şeyin nasıl kurulduğu ve kendi kopyanızı nasıl çalıştıracağınız kısaca anlatılır.

Yapı

Klasör	İçinde ne var
`programs/fairdrum/`	Rust ve Anchor 1.2.2 ile yazılmış sözleşme. Oyunun sayıları `consts.rs` dosyasında; hesaplamalar `engine.rs` ve `math.rs` içinde sıradan fonksiyonlar olarak durur, bu yüzden testler ağ olmadan çalışır.
`app/`	Site: Vite ve TypeScript; sayfalar `app/src/pages/` içinde, sözleşme istemcisi ve Switchboard ile çalışma `app/src/chain/` içinde. Sitedeki sayı tabloları `consts.rs` dosyasından üretilir, bu yüzden sözleşmeyle çelişmez.
`scripts/`	Başlatma: tokenın basımı, ilklendirme, kaydedilen ayarların doğrulanması, devnet testi, hizmet ödemeleri, isteğe bağlı “nöbetçi”.
`docs/`	`ARCHITECTURE.md` (her şeyin nasıl kurulduğu), `LAUNCH.md` (adım adım başlatma), `AUDIT.md` (güvenlik öz denetimi ve açık sorular).
`e2e/`	Sitenin gerçek bir tarayıcıda, sahte cüzdan ve sahte ağla yapılan testleri.

Projede sunucu ve veritabanı yoktur: site sıradan dosyalardan oluşur ve verileri doğrudan sözleşmeden okur.

Kendi kopyanızı çalıştırın

Node.js 20.19 veya daha yenisi, sözleşme testleri için de Rust gerekir.

npm install
npm run dev                         # localhost üzerinde site, sözleşmesiz demo modunda
npm test                            # istemci testleri
cargo test -p fairdrum --release    # sözleşme testleri
npm run build                       # dist/ klasöründe site
npm run build:single                # çevrimdışı sürüm: çift tıklamayla açılan ayrı html dosyaları

Devnet ve ana ağda komutlarla adım adım başlatma ve sık hataların çözümü: depodaki docs/LAUNCH.md.

Yeniden derlemeden ayarlar

config.json dosyası sayfaların yanında durur ve her yüklemede okunur; bu sayede sözleşme adresi, ağ düğümü ve bağlantılar derleme yapılmadan değiştirilir. Boş programId demo modunu açar.

{
  "programId": "başlatmadan sonra programın adresi",
  "cluster": "mainnet-beta",
  "rpc": "https://...",
  "swapUrl": "yayımlandığında FAIRDRUM alım satım bağlantısı",
  "links": { "github": "...", "telegram": "...", "x": "...", "audit": "..." }
}

Sitenin adresi, sayfa açıklamaları ve site yöneticisi doğrulamaları app/seo.json ve app/pages.json dosyalarında tanımlanır; npm run gen:html bunlara göre sayfaları, site haritasını ve robots.txt dosyasını yeniden üretir.

Kod doğrulama

Testler

Sözleşmenin mantığı ağ olmadan test edilir; buna on binlerce rastgele işlemden oluşan bir “fırtına” da dahildir: her işlemden sonra kasadaki tokenlar yükümlülüklere tam olarak eşit olmak zorundadır. Test “mutasyonla” doğrulanmıştır: hesaplamada tek bir en küçük birim bile kaydırılırsa test başarısız olur.

Neler doğrulanmadı

Solana için derleme, Switchboard ile canlı çalışma ve bağımsız denetim: proje durumu. İç doğrulama denetimin yerini tutmaz; açık kalan konular docs/AUDIT.md dosyasında listelenir.

Ağla karşılaştırma

Başlatmadan sonra yayımlanan kodu, “Dürüstlüğü doğrula” yönergesine göre ağdaki programla karşılaştırın. Programın ve tokenın adresleri “Resmî bağlantılar” sayfasından okunur.

fairdrum.to sitesi erişilemezse

Tokenlarınız hiçbir yere gitmez.

Oyun bakiyesi sitede değil, sözleşmede saklanır. Site yalnızca kullanışlı bir kabuktur; çekme işlemi sitenin herhangi bir kopyasından yapılabilir.

Adresin doğru yazıldığını kontrol edin ve siteyi yer iminden açın. Yalnızca site erişilemiyorsa bekleyin: barındırmada geçici bir aksaklık olabilir.
Sitenin bir kopyasını açın: depo açıktır ve site sıradan dosyalardan oluşur. Çevrimdışı sürümü indirin ya da kendiniz derleyin (npm run build), yanına gerçek program adresini içeren bir config.json koyun (adresi “Resmî bağlantılar” sayfasından ve blok gezgininden doğrulayabilirsiniz) ve siteyi herhangi bir basit web sunucusuyla açın, örneğin npx vite preview.
Aynı cüzdanı bağlayın. Bakiye, rütbe ve seri sözleşmeden okunur; çekme de ana sitedekiyle aynı şekilde çalışır.
Hiçbir “yansı” sitede gizli kurtarma ifadenizi girmeyin. Site onu asla istemez: isteyen her kopya sahtedir.

Başka bir kaynaktan aldığınız site kopyasını denetleyin: kodunu projenin deposuyla karşılaştırın. Bunu yapmadan tam olarak neyi imzalayacağınızı bilemezsiniz. En güvenlisi kendiniz derlemektir.

Lisans

MIT: kod, lisans metni korunarak okunabilir, kopyalanabilir, değiştirilebilir ve ticari amaçlar dahil çalıştırılabilir. Lisans kodu kapsar; fairdrum.to adını ve adresini kapsamaz: farklı kurallara sahip bir çatal (fork) kendini bu proje gibi gösteremez.