Kontratlar

Mainnet Alpha

Bunlar güncel Hypercall Mainnet Alpha kontrat adresleridir. Platform genişletilirken lansman kapsamı kasıtlı olarak sınırlı tutulmaktadır.

Hypercall'un zincir üstü bileşenleri Hyperliquid L1 (HyperEVM) üzerinde dağıtılmıştır. Sistem, hesap yönetimi, emir işleme ve opsiyon token yönetimi için ayrı kontratlar içeren modüler bir mimari kullanır.

Mimari Genel Bakış

Kontrat Sorumlulukları

Exchange

Exchange ana giriş noktasıdır ve yükseltilebilir bir proxy deseni kullanır.

Sorumluluklar:

• BeaconProxy deseni ile kullanıcı Hesapları (Account) oluşturur
• HyperCore üzerinde yatırılan USDC'yi saklar (sigorta fonu + opsiyon pozisyonları)
• Zincir üstü işlemler/istekler için RSM Sequencer'ın giriş noktasıdır
• Opsiyon ERC20 yatırma ve çekme işlemlerini yönetir (HyperEVM ile RSM defteri arasında köprüleme)
• Tam likidasyon açık artırmalarını takip eder ve sonuçlandırır
• Ham ActionCaster işlemleriyle olaylar (events) yayınlar

Temel Fonksiyonlar:

• createAccount() - Çağıranı yönetici olarak atayarak yeni bir hesap oluşturur
• deposit(account, token, amount) - Bir hesaba token yatırır
• addApiWallet(account, apiWallet) - İşlem için bir API cüzdanını yetkilendirir
• hlRequestOrder(...) - ActionCaster aracılığıyla HyperLiquid perp/spot emirleri verir
• hlRequestCancel(...) - HyperLiquid emirlerini iptal eder
• hlActionSendAsset(...) - Hesaptan alıcıya varlık gönderir
• hcActionWithdrawToken(...) - Exchange'den Hesaba token çeker
• hcActionWithdrawOption(...) - Opsiyonları HyperEVM alıcısına çeker
• rsmCommandRebalance(...) - RSM tarafından başlatılan yalnızca pozisyon azaltıcı emirler
• rsmCommandRepay(...) - RSM tarafından başlatılan borç geri ödemesi

Account

Her kullanıcının kendi Account kontratı vardır (ortak implementasyona işaret eden BeaconProxy).

Sorumluluklar:

• USDC dışı varlık kullanan trader'lar/piyasa yapıcılar için HyperCore tarafında teminatı saklar
• Birden fazla ajan anahtarı ekleyebilen tek bir yöneticiye sahiptir
• Ajan anahtarları yalnızca emirleri/iptalleri imzalayabilir; diğer işlemler yönetici imzası gerektirir
• Hesapla ilişkili tüm işlemler için yöneticilerin giriş noktasıdır

Temel Kavramlar:

• Yönetici (Manager): Ajanları yetkilendirebilen ve çekim işlemlerini imzalayabilen hesap sahibi
• Ajan Anahtarları (Agent Keys): Yalnızca emir verme/iptal etme için yetkili imzalayıcılar
• API Cüzdanları: Hesap adına emir gönderebilen yetkili adresler

Yatırma İşlemleri:

• Opsiyon ERC20'leri Exchange.deposit() çağrılarak yatırılır
• Diğer varlıklar, varlığın HyperEVM → HyperCore köprüsü kullanılarak HyperCore'a aktarılır
• "Opsiyon USDC pozisyonuna" USDC yatırma işlemleri, Hesaptan Exchange'e HyperCore transferi ile yapılır

Processor

Processor, imza doğrulaması ve işlem kodlamasını yönetir.

Sorumluluklar:

• İmzalardan imzalayıcı adreslerini yeniden oluşturur
• İşlemleri ActionCaster formatına kodlar
• Yatırma hesaplamaları için USD tutarlarını HYPE'a dönüştürür

Temel Fonksiyonlar:

• hlRequestOrder(...) - Emir isteklerini işler
• hlRequestCancel(...) - İptal isteklerini işler
• hlActionSendAsset(...) - Varlık gönderme işlemlerini işler
• rsmCommandRebalance(...) - RSM yeniden dengeleme komutlarını işler
• rsmCommandRepay(...) - RSM geri ödeme komutlarını işler
• usdToHype(amountUsd) - Spot fiyata göre USD'yi HYPE'a dönüştürür

Registry

Registry, opsiyon token dağıtımını ve doğrulamasını yönetir.

Sorumluluklar:

• Opsiyon ERC20 tokenlarını dağıtır
• "Bu ERC20 desteklenen bir opsiyon tokenı mı" sorusu için doğruluk kaynağıdır
• Beyaz listeye alınmış adresler yeni opsiyon tokenları dağıtabilir

Gelecekteki Güvenlik Önlemleri:

• İzin verilen dayanak varlık kümesi
• İzin verilen vade sonu zaman damgaları
• İzin verilen kullanım fiyatı aralık hassasiyeti

İşlem Türleri

HyperLiquid İstekleri

HyperLiquid'in emir defteriyle etkileşen istekler:

İşlem	İmzalayıcı	Açıklama
hlRequestOrder	Ajan/API Cüzdanı	Perp/spot emirleri verir
hlRequestCancel	Ajan/API Cüzdanı	Emirleri OID ile iptal eder
hlRequestCancelByCloid	Ajan/API Cüzdanı	Emirleri CLOID ile iptal eder

Yönetici İşlemleri

Hesap yöneticisinin imzasını gerektiren işlemler:

İşlem	Açıklama
hlActionSendAsset	Hesaptan alıcıya varlık gönderir
hcActionWithdrawToken	Exchange'den Hesaba token çeker
hcActionWithdrawOption	Opsiyonları HyperEVM adresine çeker

RSM Komutları

RSM imzalayıcısı tarafından imzalanan komutlar (yönetici onayı gerekmez):

Komut	Açıklama
rsmCommandRebalance	USDC bakiyesini artırmak için yalnızca pozisyon azaltıcı emirler gönderir
rsmCommandRepay	Hesaptan Exchange'e zorunlu USDC transferi yapar

İmza Doğrulaması

• Exchange, RSM imzalayıcı imzalarını doğrular
• Account, yönetici ve ajan imzalarını doğrular
• RSM komutları yönetici imzası olmadan iletilir (RSM imzalayıcısı güvenilirdir)

Likidasyon Açık Artırmaları

Bir hesabın teminatı yetersiz kaldığında:

1. RSM Sequencer tam bir likidasyon açık artırması başlatır
2. Herkes talep edilen USDC tutarını sağlayarak teklif verebilir
3. Kazanan, yeni Hesap yöneticisi olur
4. Koşullar değişirse RSM Sequencer devam eden açık artırmaları durdurabilir

Dağıtılmış Adresler

Mainnet Alpha

Kontrat	Adres	Açıklama
Exchange	0xE6b7FaA216cabb2b38B392f577C9c826378b2240	Ana borsa kontratı
Exchange Implementation	0xeEf31f6c8F2EFABba61C99d9efBEf4e6429024Cf	Proxy'nin arkasındaki Exchange implementasyonu
Account Implementation	0xa8E861eAE5Bc47beDcF4896C7c5c676f563F5f1C	Account implementasyonu
Account Beacon	0x1b96D6a48d1fB34dC45953697414656D2851Ca93	Account beacon
Fetcher	0x8654912Eae1554662665C13EeD4f1D8A4b028aDB	Okuma yardımcı kontratı
Option Token Implementation	0x6D0C7a116f9561A8De692c23c4C11682738ed206	Opsiyon token implementasyonu
Option Token Beacon	0xfb320352B25Dba7f139EA9Bf8966891CCa12dC35	Opsiyon token beacon
Factory	0x2CeeAC2E032e4cCb05FF744619BfAb8cC75efE1b	Hesap fabrikası
Router	0xF41FF41B6F007dE851ACc9F43Bd2f597Da741E2D	Fonlama ve yönlendirme yardımcısı
Option Registry	0x8C8efdd5F78C25215d03c8BbD5D1f6f0F1BB0598	Opsiyon token kayıt defteri
Option Registry Implementation	0xF222421a93df1086E329503723b3cC4c30546C46	Proxy'nin arkasındaki Option Registry implementasyonu

Ana Ağ Yapılandırması

Parametre	Adres veya Değer	Açıklama
USDC	0xb88339CB7199b77E23DB6E890353E22632Ba630f	Hypercall tarafından kullanılan HyperEVM USDC
Core Deposit	0x6B9E773128f453f5c2C60935Ee2DE2CBc5390A24	HyperCore yatırma yardımcısı
RSM Signer	0x502E7fAbF34E84EeB115C34FE947b79A94dF886E	Operatör kontrolündeki güncel RSM imzalayıcısı
Sequencer	0x56a2924217C91EB4d6989Cf4C7b4dF03020E8944	Güncel sequencer
Legacy Sequencer	0x8640A393730Fa671CF1C71CF5fcD2F8E299C44f7	Eski sequencer

Kaynak Kodu

Kontrat kaynak kodu, denetim tamamlandıktan sonra erişime açılacaktır.

İlgili Konular

• EIP-712 İmzalama - Mesaj formatları ve imzalama
• Ajan Yetkilendirmesi - API cüzdanı kurulumu
• Katılım Süreci - Hesap oluşturma ve yatırma işlemleri
• API Kimlik Doğrulaması - İsteklerin imzalanması