Eunomia Docs

Hızlı başlangıç — 5 dakika ​

English version: Try it in 5 minutes

Eunomia nedir? Stellar üzerinde, bir yapay zekâ ajanına gerçek harcama yetkisini güvenle vermeni sağlayan sınırlı bir kasa: günlük limit, ödeme başına limit ve onaylı alıcı listesi kontrat tarafından uygulanır — model ne kadar "ikna edilirse" edilsin, para kuralların dışına çıkamaz.

Eunomia Stellar mainnet'te, beta olarak çalışır: para gerçektir ve beta süresince her kasanın bir yatırma üst sınırı vardır. Küçük tutarlarla başla. Sahip olarak yaptığın her işlemi sen imzalarsın — emanetçi yok, para baştan sona senin kontrolünde.

Uygulama: eunomia.finance

İki giriş yolu ​

Passkey ile (en hızlısı). Face ID, parmak izi ya da cihaz PIN'i. Cüzdan kurmak ya da kurtarma kelimesi yazmak yok — passkey bir Stellar akıllı cüzdanını yönetir, işlem ücretleri karşılanır. Telefonda da aynı şekilde çalışır.

Cüzdan ile. Zaten varsa: masaüstünde Freighter, xBull, Albedo, LOBSTR, Rabet ya da Hana; telefonda WalletConnect destekleyen herhangi bir Stellar cüzdanı. Ücretler için biraz XLM'e ve kasanın tutmasını istediğin USDC ya da XLM'e ihtiyacı var.

Adımlar ​

  1. Giriş yap — Create your treasury with a passkey → yüzün, parmak izin ya da PIN'inle onayla. (Cüzdan mı tercih ediyorsun? I have a wallet → kendininkini seç. Telefonda WalletConnect'i seçip QR'ı okut.)

  2. Kuralları koy ve oluştur — tek imza. Kasa varsayılan olarak USDC tutar; istersen XLM'e çevirirsin. Günlük limiti ve ödeme başına limiti gir → Create treasury → bir kez onayla. İki isteğe bağlı seçenek aynı imzaya katlanır: + Approve a payee now ve + Connect an agent now (7. adım).

    Kurulum: kasanın tuttuğu para birimi, iki limit, ilk alıcı, tek düğme

  3. Para ekle — Overview'da Add funds → tutar → Fund → onayla. Para, kasanın kendi token'ıyla cüzdanından gelir; form imzalamadan önce cüzdanında ne kadar USDC olduğunu gösterir.

  4. Bir alıcıyı onayla — Payments'ta ödeme yapılabilecek bir adres ekle. (USDC kasada G… ile başlayan bir alıcının USDC alabilmesi için trustline'ı olmalı; passkey cüzdanına bir şey gerekmez.)

  5. Ödeme gönder — Pay by hand → onayladığın adres, limitler içinde bir tutar → zincire düşer ✓ ve kanıtıyla birlikte defterde görünür.

  6. Asıl gösteriyi izle — ödeme başına limitin üstünde bir tutar ya da hiç onaylamadığın bir adrese ödeme dene: kontrat bunu reddeder, para yerinden oynamaz. O ret, ürünün çalıştığı andır. 🔴

    Overview: son karar reddedilmiş, izin verilen ve reddedilen ödemelerin defteri, bütçe sayacı, Leash

  7. Ajana devret (artık onay penceresi yok) — Agent sayfasının yazdığı komutu kopyala — npx -y eunomia-mcp init --treasury <kasa kimliğin> — ve ajanın çalıştığı makinede, EUNOMIA_RPC_URL'yi bir Stellar mainnet RPC'sine ayarlayarak çalıştır. Yazdırdığı açık anahtarı yapıştır, bir üst sınır ve süre gir, Authorise agent. Ajanın gizli anahtarı kendi makinesinden hiç çıkmaz. Komut, MCP istemcine ekleyeceğin ayarı da yazdırır; ondan sonra ajanın elinde check_budget, pay, request_exception ve diğerleri olur — retler ona kontratın kendi hata kodlarıyla döner. Revoke Leash kontrolü anında geri alır.

    Agent: üst sınırı ve geri sayımıyla aktif bir Leash, dış ajan bağlama komutu

  8. Sahip kontrolleri — Settings'te: Pause spending (ajanı dondurur; para çekme yine çalışır), Withdraw ile parayı bir adrese geri çek, Update limits ile limitleri canlı değiştir. Sahibin her zaman bir çıkışı vardır. Kasan Stellar üzerinde yedeklenir; aynı passkey ya da cüzdanla başka bir cihazdan girdiğinde kendiliğinden açılır.

Bir şey ters giderse ​

  • Hatalar uygulamanın içinde sade bir dille gösterilir (yetersiz bakiye, imza reddedildi vb.).
  • Sağ alttaki Share feedback düğmesi kısa bir form açar — oraya yazacağın iki cümle yol haritasını doğrudan şekillendirir. 🙏

Daha fazlası ​

  • Ana README — mimari ve kontratlar
  • eunomia-mcp — ajanın eline geçen bütün araçlar