Kontratlar

Ana Ağ Alfa

Bunlar, Hypercall Ana Ağ Alfa sürümünün güncel kontrat adresleridir. Platform genişledikçe lansman kapsamı bilinçli olarak sınırlı tutulmaktadır.

Hypercall'ın zincir üstü bileşenleri HyperEVM üzerinde (zincir kimliği 999) çalışır. Her kullanıcıya bir Account kontratı verilir. Exchange, platformun USDC bakiyesini ve opsiyon saklamasını tutar ve imzalı direktifleri Account'lar üzerinde yürütür. Factory, Account'ları oluşturur. Option Registry ise opsiyon token'larını dağıtır ve tanır.

Kontrat Sorumlulukları

Exchange

Yükseltilebilir proxy. Ana ağda sürüm 0.6.1.

• Platform adına HyperCore üzerinde yatırılan USDC'yi tutar (depositUsdcFor, depositPmLiquidityFor).
• Yatırma sırasında opsiyon ERC20'lerini yakar ve motorun hesaba alacak kaydetmesi için Deposit olayını yayar (depositOption).
• Factory tarafından oluşturulan Account'ları kaydeder ve her Account'ın yöneticisini takip eder (getAccounts, getAccount, managers).
• İmzalı direktifleri yürütür. executeUserDirective, yönetici veya API cüzdanı tarafından imzalanmış bir direktifi Account'a iletir. executeRsmDirective, RSM tarafından imzalanmış bir sistem direktifini (alacak kayıtları, çekimler, likidasyon durumu) çalıştırır. Her ikisi de yalnızca Hypercall'ın sıralayıcısı (sequencer) tarafından çağrılabilir. Kullanıcılar imzalar, Hypercall gönderir.
• İmzalayan başına kullanılmış nonce'ları takip eder (isNonceUsed).

Account

Kullanıcı başına bir adet, BeaconProxy olarak dağıtılır. Ana ağda sürüm 0.2.4.

• Kullanıcının HyperCore bakiyelerine ve pozisyonlarına sahiptir. Perp ve spot varlıklar, Account'ın HyperCore defterinde yer alır.
• Bir yöneticisi (onu oluşturan EOA) ve istenen sayıda adlandırılmış API cüzdanı vardır.
• Direktif imzalarını doğrular. API cüzdanları emir ve iptal imzalayabilir. Diğer her şey yönetici imzası gerektirir. Bkz. EIP-712 İmzalama.
• Yalnızca yöneticinin yapabileceği doğrudan çağrılar: transferTo(recipient, token, amount) HyperEVM token'larını Account dışına taşır, approveZeroFeeBuilder(builder) ise bir Hyperliquid builder'ını %0 azami ücretle onaylar. Hypercall perp emirleri Hypercall builder kodunu taşıdığından, ilk perp emrinden önce bu onayın bir kez verilmesi gerekir.
• depositSpot, HYPE'ı veya desteklenen bir spot token'ı HyperEVM'den HyperCore üzerindeki Account'a köprüler.

Factory

createAccount(uint96 salt) ile Account oluşturur. Adres, yönetici ve salt başına deterministiktir. predictAccount(manager, salt) bu adresi oluşturmadan önce döndürür. Bkz. Hesap Açılışı.

Router

Fonlama yardımcısı. deposit(account, token, amount, isPerp), USDC'yi Circle'ın CoreDepositWallet'ı üzerinden, spot token'ları Account üzerinden, opsiyon token'larını ise Exchange üzerinden HyperCore'a yönlendirir. depositHype(account) yerel HYPE'ı köprüler.

Option Registry

Opsiyon ERC20'lerini dağıtır ve bir token'ın desteklenen bir opsiyon olup olmadığı konusunda doğruluk kaynağıdır (isSupportedOption).

Direktif Türleri

Direktif	İmzalayan	Açıklama
hl_limit_order	API cüzdanı	Hyperliquid limit emri
hl_cancel_by_oid	API cüzdanı	Hyperliquid emir kimliğine göre iptal
hl_cancel_by_cloid	API cüzdanı	İstemci emir kimliğine göre iptal
hc_update_api_wallet	Yönetici	Account üzerinde adlandırılmış bir API cüzdanı ekler, değiştirir veya kaldırır
hl_add_api_wallet	Yönetici	HyperCore üzerinde Account için bir Hyperliquid API cüzdanını onaylar
hl_send_asset	Yönetici	HyperCore üzerindeki Account'tan varlık gönderir
hl_set_abstraction	Yönetici	Account'ın HyperCore hesap modunu ayarlar (yalnızca unified)

RSM direktifleri (alacak kayıtları, çekimler, likidasyonun başlatılması ve durdurulması, yalnızca pozisyon azaltan kurtarma emirleri) RSM imzalayıcısı tarafından imzalanır ve sıralayıcı tarafından gönderilir. Kullanıcılar bunları hiçbir zaman imzalamaz. Bkz. RSM Direktifleri.

Likidasyon

Likidasyon, Hypercall motorunda yürütülür. Bkz. Likidasyon. Exchange, bir Account'ın yöneticiliğini kazanan teklif sahibine devretmek üzere zincir üstü bir açık artırma kontratı için kancalar içerir, ancak ana ağda yapılandırılmış bir açık artırmacı yoktur.

Güven ve Yetkiler

Bu bölüm, zincir üzerinde kimin neyi yapabileceğine dair referanstır. Kısa versiyon için bkz. Güven Modeli.

Gönderim

Exchange üzerinde SEQUENCER_ROLE yalnızca Hypercall'un sıralayıcısında bulunur; dolayısıyla executeUserDirective ve executeRsmDirective fonksiyonlarını çağırabilen tek adres odur. Siz imzalarsınız; Hypercall gönderir. Sıralayıcı bir kullanıcı direktifini taklit edemez: Account imzacıyı kendisi geri çıkarır ve yalnızca yöneticisini veya aktif bir API cüzdanını kabul eder.

RSM Direktifleri

Motor durumu zincir içi bir eylem gerektirdiğinde, RSM imzalayıcısı bir direktif imzalar ve sıralayıcı bunu gönderir. Exchange, kayıtlı RSM imzalayıcısı (Exchange.rsmSigner) tarafından imzalanmamış her RSM direktifini reddeder. Mevcut RSM imzalayıcısı operatör kontrolündedir; yol haritası, bu rolün nasıl merkeziyetsizleştirileceğini veya başka şekilde güven gereksinimi en aza indirilmiş hale getirileceğini yayımlayacaktır.

Exchange'in kendisinin çalıştırdığı direktifler:

• Standart USDC çekimleri dahil, Exchange'in HyperCore bakiyesinden USDC veya spot token gönderimleri
• Opsiyonlar çekildiğinde bir adrese opsiyon ERC20'leri basılması
• Bir Account üzerinde likidasyonun başlatılması ve durdurulması

Bir Account'ın RSM'den kabul ettiği, Account kontratı tarafından uygulanan direktifler:

• Account'ın Hyperliquid bakiyesi üzerinde yalnızca azaltan (reduce-only) IOC emirleri veya USDC'ye karşı piyasaya yakın IOC spot satışları
• Account'tan HyperCore üzerinde, yalnızca Exchange'e yapılan varlık gönderimleri (örneğin negatif bir bakiyeyi karşılamak için)
• Emir iptalleri

RSM direktifleri, Account likidasyondayken de çalışmaya devam eder. Opsiyonların vade sonu uzlaşması bir RSM direktifi değildir: motor durumunda nakde uygulanır. RSM imzalayıcı adresi ve her direktif yürütmesi zincir üzerinde görülebilir.

Yükseltmeler

• Exchange ve Option Registry yükseltilebilir proxy'lerdir.
• Account ve Option Token BeaconProxy'dir. Her Account aynı implementasyonu çalıştırır, dolayısıyla Account Beacon'ın tek bir yükseltmesi tüm Account'ları aynı anda değiştirir. Aynısı opsiyon token'ları ve Option Token Beacon için de geçerlidir.
• Timelock, Exchange proxy yöneticisine ve Account, Option Token ve Option Registry yükseltme yollarına 30 saniyelik asgari gecikmeyle sahiptir.
• Admin Safe multisig'i, Exchange yönetici ve governor rollerini ve Factory sahibi rolünü tutar.
• Admin Safe'in tuttuğu governor rolü, RSM imzacısını ve auctioneer'ı değiştirebilir ve Exchange'in USDC'sini taşıyabilir (rescueUsdcToEvm). Güven planının 1. adımında timelock altına alınacak. Exchange'in varsayılan yöneticisi olarak Safe, SEQUENCER_ROLE ve diğer tüm Exchange rollerini timelock olmadan doğrudan verebilir veya geri alabilir.

Adresleri aşağıdaki Ana Ağ Yapılandırması tablosundadır. Hesap sahipliği yalnızca zincir içi bir işlemle değişir.

Dağıtılmış Adresler

Ana Ağ Alfa

Kontrat	Adres	Açıklama
Exchange	0xE6b7FaA216cabb2b38B392f577C9c826378b2240	Ana borsa kontratı
Exchange Implementation	0xF7F0610aC612d140bdb34DCD2872828Bc67349cD	Proxy arkasındaki Exchange uygulaması
Account Implementation	0xCD87F572bef2855c8Ffb69A6Da3D9785d6017791	Account uygulaması
Account Beacon	0x1b96D6a48d1fB34dC45953697414656D2851Ca93	Account beacon'ı
Fetcher	0x8654912Eae1554662665C13EeD4f1D8A4b028aDB	Okuma yardımcı kontratı
Option Token Implementation	0x6D0C7a116f9561A8De692c23c4C11682738ed206	Opsiyon token uygulaması
Option Token Beacon	0xfb320352B25Dba7f139EA9Bf8966891CCa12dC35	Opsiyon token beacon'ı
Factory	0x2CeeAC2E032e4cCb05FF744619BfAb8cC75efE1b	Account fabrikası
Router	0xF41FF41B6F007dE851ACc9F43Bd2f597Da741E2D	Fonlama ve yönlendirme yardımcısı
Option Registry	0x8C8efdd5F78C25215d03c8BbD5D1f6f0F1BB0598	Opsiyon token kayıt defteri
Option Registry Implementation	0xF222421a93df1086E329503723b3cC4c30546C46	Proxy arkasındaki Option Registry uygulaması
Hypercall Fee Collector	0x406ceBfC7063e55761007D1C4b66B29308016602	Perp emirlerindeki Hyperliquid builder adresi (GET /exchange-info içindeki hl_builder_address ile aynı)

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 sıralayıcı
Timelock	0x96f17e6f7269cA4300a391514c109eBA70661674	Exchange proxy yöneticisine ve Account, Option Token ile Option Registry yükseltme yollarına sahiptir. Asgari gecikme 30 saniyedir.
Admin Safe	0xF741246D2e0ADD4EFa7e88BE0961cccf3562b502	Exchange admin ve governor rollerini ve Factory sahiplik rolünü tutan çoklu imza cüzdanı

Kaynak Kodu

Kontrat kaynak kodu, denetim tamamlandıktan sonra yayımlanacaktır.

İlgili Sayfalar

• EIP-712 İmzalama - Mesaj formatları ve imzalama
• Agent Yetkilendirmesi - API cüzdanı kurulumu
• Hesap Açılışı - Account oluşturma ve para yatırma
• API Kimlik Doğrulaması - İsteklerin imzalanması