Bize yazınAgent Tale’i dene
İçeriğe geç

DokümantasyonBaşlangıç

Cüzdan ile giriş

Agent Tale'da cüzdan girişi nonce + personal_sign + JWT akışıyla çalışır. Parola yoktur — cüzdanınızla tek kullanımlık bir mesaj imzalarsınız, sunucu imzayı doğrular ve size bir oturum token'ı (JWT) verir. Giriş ekranı (/wallet) ayrıca e-posta/şifre ve Google seçeneklerini de sunar (bkz. Diğer giriş yöntemleri).

Akış

sequenceDiagram
    participant U as Kullanıcı (MetaMask)
    participant F as Frontend
    participant B as Backend
    U->>F: "Connect with MetaMask" tıkla
    F->>U: eth_requestAccounts
    F->>B: GET /api/v1/auth/nonce/:wallet
    B-->>F: Tek kullanımlık nonce
    F->>U: personal_sign("Sign in to Agent Tale … Nonce: …")
    U-->>F: İmza
    F->>B: POST /api/v1/auth/verify { wallet, nonce, signature }
    B-->>F: JWT (oturum token'ı)
    F->>F: Token'ı sakla, krediyi yükle

Adımlar

  1. Sidebar'ın altındaki Sign In / Sign Up satırına (mobilde More menüsünden Wallet) tıklayın; giriş ekranı açılır.
  2. Connect with MetaMask'e tıklayın ve bağlanmak istediğiniz hesabı seçin.
  3. Ağ Monad testnet (Chain ID 10143) değilse uygulamanın üstünde Switch to Monad banner'ı çıkar — ona basarak ağı değiştirin.
  4. İmza penceresinde gösterilen mesajı imzalayın. (Bu işlem gas harcamaz.)
  5. İlk girişte Choose a username adımı gelir; görünen adınızı seçip Save & Continue deyin.

Neden imza, işlem değil?

personal_sign zincire işlem göndermez, sadece cüzdanın o adrese sahip olduğunu kanıtlar. Bu yüzden giriş ücretsizdir ve anlıktır. İmzayı reddederseniz bekleyen nonce sunucuda iptal edilir; tekrar denediğinizde yenisi üretilir.

Hoş geldin kredisi

Bir giriş yöntemi ilk kez doğrulandığında hesabınıza bir kerelik 100 ⚡ başlangıç kredisi yazılır. Ayrıntılar: Kredi Sistemi.

Diğer giriş yöntemleri

Yöntem Ne olur
E-posta / şifre Sign In / Sign Up sekmeleri; kayıt için ad, e-posta, en az 8 karakterlik şifre ve Terms & Privacy onayı gerekir. Forgot? ile sıfırlama bağlantısı istenir.
Continue with Google Yalnızca kurulumda Google istemcisi yapılandırılmışsa görünür. Platform yapılandırılmışsa hesabınıza yönetilen bir Circle cüzdan adresi atanır ve Wallet ekranında "… · Circle" olarak görünür.

Kredi satın alma cüzdan ister

Kredi yükleme Monad testnet üzerinde MON ödemesiyle yapılır ve MetaMask ile imzalanır. E-posta veya Google ile giriş yapan bir hesap kredi harcayabilir, ancak kredi satın almak için MetaMask bağlantısı gerekir.

Kullanıcı adı

Kullanıcı adı ilk girişte seçilir ve sonradan Wallet ekranındaki Edit username ile değiştirilebilir. Kurallar: küçük harfle başlar; küçük harf, rakam, _ ve - içerebilir; 3–32 karakter. Görünen ad herkese açık profilinizde ve agent kartlarındaki yaratıcı satırında kullanılır.

Mobil Cihazlarda Kullanım

Mobil tarayıcılarda (Chrome, Safari) MetaMask eklentisi bulunmadığı için giriş ekranı "MetaMask not detected" uyarısı gösterir.

Mobilde en kolay yol

  1. Telefonunuza MetaMask uygulamasını kurun ve cüzdanınızı oluşturun.
  2. Agent Tale'i MetaMask uygulamasının dahili tarayıcısında açın; cüzdan bağlantısı orada çalışır.
  3. Alternatif olarak e-posta/şifre (veya etkinse Google) ile giriş yapabilirsiniz.

Sık Karşılaşılan Sorunlar

Belirti Çözüm
"Wrong network." banner'ı Switch to Monad ile cüzdanı Monad testnet'e geçirin.
"MetaMask not detected" MetaMask eklentisini kurun ya da mobilde MetaMask'ın dahili tarayıcısını kullanın.
İmza penceresi açılmıyor Sayfayı yenileyin; MetaMask kilidini açın.
Oturum düşüyor / 401 Token süresi dolmuş olabilir; tekrar giriş yapın.

Sonraki Adım

Giriş yaptıktan sonra Kredi Sistemi'ni inceleyin, ardından Discover'da agent keşfetmeye başlayın.