Portföy Teminatına Geçiş

Portföy Teminatı (Portfolio Margin, PM) üretim ortamında yayında ve tüm hesaplara açık. Opsiyonlarınızı ve Hyperliquid perp pozisyonlarınızı, portföyün en kötü senaryo riskine göre birlikte teminatlandırır. Bu sayede hedge edilmiş bir portföy, Standart Teminat altında gerekenden çok daha az teminat ister. Bu sayfa PM'e nasıl geçeceğinizi anlatır. Teminatın nasıl hesaplandığı için Portföy Teminatı sayfasına bakın.

Kısaca: yeni bir yönetici cüzdanı kullanın, bu cüzdanın Hypercall hesabını oluşturun, HyperCore birleşik hesap modunu açın, Portföy moduna geçin ve ancak bundan sonra para yatırın.

Neden yeni bir cüzdanla başlıyorsunuz

Bakiyesi veya açık pozisyonu olan bir Standart Teminat (SM) hesabı, yerinde Portföy Teminatına dönüştürülemez. Hypercall, Portföy moduna geçişi yalnızca yönetici cüzdanı için aşağıdaki koşulların tümü sağlandığında kabul eder:

Gereksinim	Anlamı
Tam olarak bir Hypercall hesabı	Yönetici tek bir Account kontratını kontrol eder. Hiç hesap olmaması veya birden fazla hesap olması reddedilir.
Sıfır Standart bakiye	Cüzdanın Standart Teminat nakit bakiyesi sıfırdır. Çekilebilir herhangi bir bakiye geçişi engeller.
Pozisyonsuz	Yönetici cüzdanında veya Account'unda açık pozisyon ve açık emir yoktur.

Bu kurallar, iki modun tek bir hesabın ayarı değil, farklı türde hesaplar olmasından kaynaklanır:

• Teminatınız farklı şekilde tutulur. Standart Teminattan Portföy Teminatına geçmek bir düğmeye basmak değil, fonlarınızı taşımak demektir.
• Pozisyonlar farklı kurallarla teminatlandırılır. Açık bir pozisyonun bir kural setinden diğerine yeniden teminatlandırılması gerekirdi.
• Bu yüzden geçiş boş bir hesaptan yapılır. Her ikisini tek adımda güvenli şekilde yapmak desteklenmez. Hesabın önce pozisyonsuz ve boş olması gerekmesinin nedeni budur.

Teminat modu yönetici cüzdanı bazında belirlenir, yani tek bir cüzdan iki modu birlikte çalıştıramaz. En basit yol PM için yeni bir yönetici cüzdanı kullanmaktır. Böylece kurulum sırasında mevcut SM hesabınız kotasyon vermeye devam edebilir. Mevcut cüzdanınızı da boşaltıp (tüm pozisyonları kapatıp, tüm emirleri iptal edip, tüm Standart nakdi çekip) geçiş yapabilirsiniz, ancak bu süre boyunca SM portföyünüzü çalışır durumda tutamazsınız.

Başlamadan önce

• Yeni bir yönetici cüzdanı (kontrolünüzdeki bir EOA, tercihen donanım cüzdanında veya başka şekilde güvenceye alınmış bir anahtarda).
• Hesap oluşturma depozitosu ve gas için bu cüzdanda HyperEVM üzerinde HYPE.
• Teminat olarak kullanmayı planladığınız USDC.

Kurulum adımları

Adımları sırasıyla uygulayın. 4. adım 5. adımdan önce gelmelidir.

1. Yeni bir yönetici cüzdanı oluşturun. SM yönetici cüzdanınızı, bir API cüzdanını veya bir agent anahtarını yeniden kullanmayın.

2. Hypercall hesabınızı oluşturun. Yönetici cüzdanından, Factory kontratı üzerinde HYPE oluşturma depozitosuyla birlikte createAccount(salt) çağrısı yapın. Bu işlem Account kontratınızı deploy eder ve HyperCore üzerinde etkinleştirir. Bkz. Onboarding (kontratlar). Bu yönetici için yalnızca bir hesap oluşturun.

3. Account için HyperCore birleşik hesap modunu açın. Yönetici cüzdanıyla imzalanmış, user alanı Account adresiniz ve abstraction alanı 2 (birleşik hesap) olan hl_set_abstraction aksiyonunu gönderin. POST /v1/actions/hl_set_abstraction/typed-data imzalanacak typed data'yı birebir döndürür, POST /v1/actions/hl_set_abstraction ise onu gönderir. HyperCore'un Account'u unifiedAccount olarak raporlamasını bekleyin. Hyperliquid'in kendi portföy teminatı modu dahil diğer hesap modları desteklenmez.

4. Portföy moduna geçin. wallet alanı yönetici adresiniz ve margin_mode alanı portfolio olan, yönetici cüzdanıyla imzalanmış bir POST /margin-mode isteği gönderin (bkz. Kimlik Doğrulama). Yanıt, Account adresinizi PM cüzdanı olarak döndürür. Bunu para yatırmadan önce yapın: bir cüzdan hâlâ Standart moddayken yapılan Hypercall yatırımı Standart nakit olarak kaydedilir ve bu bakiye, siz onu tekrar çekene kadar geçişi engeller.

5. Account'unuza USDC yatırın. Teminat moduna göre yönlendirme yapan uygulama üzerinden yatırın ya da HyperCore üzerinde Account adresinize USDC gönderin. Fonlar, Hypercall'un bir sonraki HyperCore snapshot'ında göründüğü anda teminata sayılır.

6. İmzalama anahtarlarınızı ayarlayın. Eski SM cüzdanınızdaki onaylar yeni cüzdana taşınmaz.

   • Opsiyonlar (REST): işlem anahtarınızı yeni yönetici cüzdanı için POST /approve-agent ile onaylayın. Bkz. Agent Yetkilendirmesi.
   • Perp'ler (zincir üstü direktifler): yönetici tarafından imzalanan hc_update_api_wallet aksiyonuyla Account'unuza bir API cüzdanı kaydedin. Bir API cüzdanı aynı anda yalnızca tek bir Account üzerinde aktif olabilir. Bkz. EIP-712 İmzalama.

7. İşlem yapın. Opsiyon isteklerinde wallet olarak yönetici adresinizi göndermeye devam edin; Hypercall bunları PM hesabınıza yönlendirir. Emir türleri, emir API'si ve imzalama Standart Teminattakiyle aynıdır. Uygulama üzerinden Hyperliquid perp'leri için bkz. Hypercall'da Perp'ler.

Uygulamada Settings > Margin Mode altında Portfolio seçeneğini seçmek 2. ile 4. adımları sizin yerinize yürütür: hesabınız yoksa oluşturur, birleşik hesap modunu açar ve modu değiştirir.

Birleşik hesap modunu atlarsanız

Hypercall bir PM hesabını, HyperCore'un yalnızca birleşik hesap modundaki Account'lar için yayınladığı HyperCore özkaynağı üzerinden değerler. Account bu modda değilse 4. adım 400 pm_account_not_unified ile reddedilir. 3. adımı tamamlayın, HyperCore'un modu onaylamasını bekleyin ve tekrar deneyin.

Bir Account daha sonra birleşik hesap modundan çıkarsa, portföy okumaları 503 pm_account_equity_pending döndürür (HyperCore bu hesap için hiç özkaynak yayınlamadıysa 409 pm_account_not_unified) ve emirler missing HyperCore account equity for PM wallet 0x... benzeri bir hatayla başarısız olur. Sorunu gidermek için birleşik hesap modunu yeniden açın. Bkz. Hatalar ve Ret Nedenleri.

SSS

Standart Teminat hesabımı çalışır durumda tutabilir miyim? Evet. PM'e yeni bir yönetici cüzdanıyla geçin ve SM hesabınızı olduğu gibi bırakın.

Teminat modu geçişim neden reddedildi? Hata mesajı ihlal edilen kuralı belirtir: cüzdanın Account'u yok (veya birden fazla var), Standart bakiyesi var, açık pozisyonları veya emirleri var ya da Account henüz HyperCore birleşik hesap modunda değil (pm_account_not_unified). Bkz. Neden yeni bir cüzdanla başlıyorsunuz.

Geçişten önce para yatırdım. Şimdi ne yapmalıyım? Yatırım Standart nakit olarak kaydedildi. Bunu çekin, ardından Portföy moduna geçin ve Account'unuza yatırın.

Yeni API anahtarlarına ihtiyacım var mı? Yeni onaylara ihtiyacınız var. Opsiyon agent onayları yönetici cüzdanına bağlıdır, bu yüzden anahtarınızı yeni cüzdan için tekrar onaylayın. Bir perp API cüzdanı aynı anda yalnızca tek bir Account üzerinde aktif olabilir, bu yüzden yeni bir anahtar kullanın ya da önce anahtarı eski Account'unuzdan kaldırın (6. adım).

PM teminatının, likidasyonun ve uzlaşmanın nasıl işlediğini nereden öğrenebilirim? Bkz. Portföy Teminatı, PM Teminat Hesaplama Örnekleri, Teminat Tabanı, Likidasyon ve Uzlaşma.