İhraç
Bloom, bir ihraç etmenize olanak tanır izinli gerçek dünya varlığı Rome zincirinde sıradan bir Solidity sözleşmesi olarak ve her varlık için ayrı bir konsoldan yönetebilirsiniz. Varlığa hem EVM hem de Solana cüzdanlarından erişilebilir, ancak ihraç etme yalnızca EVM'de mümkündür — bir Solana cüzdanı varlıkları tutar; onları oluşturmaz. Bu kılavuz, ihraççı konsolunu, oluşturma sihirbazını, konsol oturum açma kapısını ve altı yönetim sekmesinin her birini kapsar.
Bloom'a herhangi bir belge veya kişisel veri vermezsiniz; yatırımcınız da vermez. Bloom, şunu kaydeder sonuç uyum kararınızın ...; zincir adres başına bir boolean kaydeder. KYC/AML süreciniz — tedarikçileriniz, dosyalarınız, saklama süreniz — tamamen kendi sisteminizde kalır. Tam model şuradadır COMPLIANCE.md; bu kılavuz onu yeniden anlatmak yerine oraya yönlendirir.
Yapabilecekleriniz
Bir varlığın yöneticisi olarak, aşağıdaki her şeyi konsoldan siz yaparsınız — ve bunların her biri zincir üstünde gerçek bir işlemdir; bağlantısı ... üzerinde yer alır Kanıt sayfasında:
Bir varlık ihraç et — sihirbaz onu üç sözleşme olarak dağıtır (aşağıda).
Başvuruları incele — her birini onayla veya reddet (reddetme, başvuru sahibine verilmesi gereken bir gerekçe içerir) ve onaylanan bir adresi izin listesine ekle.
İzin listesini yönet — bir adres ekle, ekle tek bir işlemde bir grup adres (
batchAddToWhitelist), ya da bir adresi kaldır; token her transferde listeyi uygular.Varlığı kısıtla — transferleri izin listesiyle kısıtla (bu arzı nihai hale getirir) ya da kısıtlamayı kaldır.
Arzı yönet — toplamı oku ve rolü aldığınızda mint et veya yak.
Satışı yürüt — bir satış aç (birimler ve fiyat), kapat, satılmayan envanteri geri çağır ve gelirleri çek.
Getiriyi ayarla ve dağıt — ödeme para birimini ayarla, ardından bir ödeme dağıt; bu, sahipler üzerinde birer işlem halinde ilerler; hariç tutulan sahipler atlanır.
Rolleri yönet — bir adrese rol ver, birini geri al veya kendi rolünden vazgeç.
Her biri aşağıda, zincirin neyi zorunlu kıldığıyla birlikte, ait olduğu sekmede ayrıntılı olarak açıklanmıştır.
İhraççı konsolu

/issuer bu zincirde ihraç ettiğiniz varlıkları listeler ve yeni bir tane başlatmanıza izin verir.
Bir cüzdan bağlayın EVM cüzdanı. Bağlantısı olmayan bir ziyaretçi ya da bir Solana cüzdanı, boş bir konsol yerine doğru türde cüzdanı bağlaması için bir istem görür — bir Solana cüzdanı ihraç yapamaz; bu, zincirin ikinci ve bağımsız bir koruma olarak uyguladığı bir ürün sınırıdır.
Tabloda her varlığın ad ve sembolünü, yaşam döngüsü aşamasını, ve Satış durumunu (bir Açın rozet ya da Kapalı).
İki sütun — Sahipler ve İncelemek için — tire gösterilir. Sahip sayısı, izin listesinin numaralandırılmasını gerektirir ve inceleme kuyruğu, her varlık için giriş yaptığınız çevrimdışı bir depodur; tire sorulmadı bir 0 uygulamanın okumadığı bir gerçeği iddia ederdi.
Basın Bir varlık ihraç et sihirbazı açmak için ya da o varlığın konsolunu açmak için bir satır seçin.
Bir varlık oluşturma: sihirbaz

/create toplar dört alanı ve ardından varlığınızı dağıtır.
Ad
Gerekli.
Sembol
Gerekli.
Arz
Sıfırdan büyük tam sayı.
Ondalıklar
0 ile 18 arasında tam sayı.
Basın Başlat. Bir alan geçersizse, sihirbaz size hangisinin neden geçersiz olduğunu söyler; devre dışı bırakılmış bir düğmenin arkasında beklemez. Taslak geçerli olduğunda, cüzdanınız her adımı sırayla imzalamanız için ister.
Neden parça parça dağıtılır
Bir token, birkaç işlem boyunca üç sözleşme olarak dağıtılır — asla tek bir işlemde değil. Arc'ın tek işlem
createTokenşuna ihtiyaç duyardı 77 hesap kilidine, ve Rome tek bir işlemi şunda sınırlar: 62 kilittir.ArcTokenFactoryV2.registerToken. Bu, görünür hale getirilmiş bir Rome kısıtıdır, isteğe bağlı bir optimizasyon değil — ve korumalar Arc'ın yukarı akış güvenlik modelini tam olarak korur (kanonik proxy, beyaz listedeki uygulama, çağıran token'ın yönetici rolünü taşır, kayıt yalnızca bir kez yapılır). Bkz. COMPLIANCE.md.
Altı kart
Sihirbaz, dağıtımın ilerleyişini izleyen altı kart gösterir. Bir kart şuradan döner: Bekliyor şuraya İmzalanıyor… şuraya Tamamlandı (veya Başarısız) işlemi zincire düştüğünde.
1
Uygulama
Bu zincir için paylaşılan varlık uygulaması — çözümlenmiş, imzalanacak bir şey yok. (Herhangi bir adım çalışmadan önce tamamlanır.)
2
Varlık
Varlığınızı dağıtır ve adını, sembolünü, arzını ve ondalıklarını tek bir adımda ayarlar.
3
Kimler tutabilir
Bu varlığın kendi izin modülünü dağıtır; yöneticisi olarak sizsiniz.
4
Transferlerde bunu uygulayın
Varlığı o modüle işaret eder; böylece her transferin kontrolü varlığın kendisi tarafından yapılır.
5
Getiri kuralları
Kimin ödeme alacağına karar veren modülü dağıtır ve bağlar.
6
Kayıt
Varlığı kaydeder — satışın açılmasını ve daha sonra yükseltmenizi sağlayan şey budur.
Altı kart, dağıtımın sekiz temel adımını kapsar; dolayısıyla tek bir Başlat şuna yol açar: sekiz imza. Düğmenin altındaki notta şu yazıyor: «Cüzdanınız her adımı imzalamanızı isteyecek. İstediğiniz noktada durup kaldığınız yerden devam edebilirsiniz — hiçbir şey kaybolmaz.» Kaydın son adım olması, durmanın güvenli olmasının nedenidir: varlık her aşamada gerçek bir dağıtımdır, en sonunda kaydedilir.
Çalışma tamamlandığında, sihirbaz şunu okur: «İhraç edildi. Varlığınız şu adreste yayında: …» ve varlığın konsoluna şu adresten bir bağlantı: /token/[address].
başlatsize tüm rolleri verir. Sihirbazı yöneten kişi — EVM adresiniz — token'ın yönetici, basma/yakma, getiri-yöneticisi/dağıtıcı ve yükseltici rollerini, ayrıca izin listesi modülünün yönetici rolünü alır. Dolayısıyla anahtar saklama durumu, varlığın uyum duruşunun bir parçasıdır: kaybolan bir yatırımcı cüzdanı yalnızca sizin yönetici işleminizle kurtarılabilir ve konsolun Haklar sekmesi her gücün sahibini görünür kılar. (UPGRADER_ROLEşu değil fabrikaya otomatik olarak verilir — fabrika aracılı yükseltmeler istiyorsanız onu açıkça verin.)
Varlık başına konsol ve oturum açma kapısı

Açılıyor /token/[address] şu anda değil konsolu hemen gösterir. Şunu gösterir: oturum açma kapısı:
«Bu varlığı yönetmek için oturum açın. Cüzdanınızla bir mesaj imzalayın — parola yok. Yetkiniz varlığın kendisinden gelir ve her işlemde yeniden kontrol edilir; bu yüzden iptal edildiğinde hemen yürürlüğe girer.»
Basın Cüzdanınızla oturum açın. İşte tam olarak olanlar:
Cüzdanınızdan şunu imzalamanız istenir:
personal_signkısa, insanlarca okunabilir bir ifade (başlığı «Bloom — bu varlığı yönettiğinizi kanıtlayın») — yetki verdiği tek eylemi adlandırır: bu varlığın başvuru kuyruğunu okumak — ayrıca varlık adresini, zincir kimliğini ve bir zaman damgasını içerir.Uygulama bu imzalı ifadeyi şuraya gönderir:
GET /api/applications.Şu sunucu doğrular: imzadan adresinizi geri alır, ifadenin bu zincir için olduğunu ve hâlâ yeni olduğunu teyit eder (bir oturum için değil, iki dakikalık bir pencere için yetki verir), token'ın kendi izin listesi modülünü zincirden okur ve adresinizin izin listesi yazısının gerçekten gerektirdiği rolü taşıdığını kontrol eder — o modülde. token'ın kendi izin listesi modülü zincirden
MANAGER_ROLEüzerinde.Eğer o role sahipseniz, kuyruk döndürülür ve konsol görüntülenir. Sahip değilseniz, sunucu şununla reddeder:
403ve bir gerekçe.

Varlığın kim tarafından yönetilebileceğine varlığın kendisi karar verir — bu uygulama değil. Rol, token'da değil, izin listesinde kontrol edilir modül, ve token üzerinde aynı adlı bir role sahip olmak değil kalıcı hale gelmez — bunlar farklı yetkilerdir. Hesap yoktur ve oturum yoktur: sonrasında gelen her istek kendi yeni imzasını taşır; “her işlemde yeniden kontrol edilir” ifadesi de tam olarak bunu anlatır. Zincirde bir cüzdanın rolünü kaldırın, o cüzdan hemen oturum açamaz hale gelir. “her işlemde yeniden kontrol edilir” anlamına gelir. Zincirde bir cüzdanın rolünü kaldırın ve o cüzdan hemen oturum açamaz hale gelir.
Ret, gerekçeyi gösterir alıntılanmış — Bloom, bir cüzdanın neden reddedildiğine dair bir cümle yazmaz. İmzayı cüzdanınızda reddederseniz, bu sizin «hayır», varlığın değil, ve bu bir ret olarak raporlanmaz.
Bu kapı, kimin konsolu olduğu ile ilgilidir; neyin gizli olduğu ile değil. Arz, satış durumu, izin listesi ve roller genel zincir okuma verileridir; herhangi bir explorer bunlara cevap verebilir. İmzayla kazanılan şey başvuru kuyruğu — başkalarının beyanları — ve konsolun size hiç gösterilme hakkıdır.
Konsol üst bilgisi
Oturum açıldıktan sonra, üst bilgi varlığın adını ve onun aşamasını — sahip olduğu en önemli gerçeği — gösterir:
Taslak
Henüz hiçbir izin modülü bağlanmadı, bu yüzden bunu kimin tutabileceğini hiçbir şey kısıtlamıyor.
Açın
Transferler açıktır ve arz hâlâ değişebilir. Varlığı kısıtlamak arzını nihai hale getirir ve bu geri alınamaz.
Kısıtlandı
Yalnızca izin listesine alınmış adresler bunu tutabilir, ve arzı nihai hale gelmiştir — artık daha fazla basılamaz ya da yakılamaz, kalıcı olarak.
Sekmelerin üstünde, bir özet dört gösterge sunar — Sahipler · İncelenecek · Satılan · Ödenen getiri. İkisi zincirden ve depodan okunur (İncelemek için oturum açtıktan sonra; Satıldı mağazadan); Sahipler getiri önizlemesinin sahip sayısını bekler ve Ödenen getiri henüz gelmemiş olan ödeme geçmişi imlecini bekler. Her bekleyen hücre bir tire gösterir ve neye ihtiyaç duyduğunu açıklar; bir 0 hiç kimsenin zincire sormadığı bir gerçeği iddia ederdi.
Altı sekme
Konsolun altı sekmesi vardır, şu sırayla: Başvurular · Kim tutabilir · Arz · Satış · Getiri · Haklar.
Bu sekmelerdeki her yazma işlemi, yazmanın isimlendirilmiş önkoşullarını ve sonuçlarını önce düğmeden önce ve çalışırken aşamasını adlandıran ortak bir kontrol kullanır ("Cüzdanınızı bekliyor…", "Zincire ulaşıyor…"). Bir şeyin önce neyin kontrol edilebileceğini öğretmek için geri dönmesi gerekmez.
Başvurular — inceleme kuyruğu

Bu sekme, varlığı tutmak için kimlerin başvurduğunu listeler. Her satırda başvuranın adresi, yargı bölgesi, sahip türü, bir Kontroller sütun (Geçti sağlayıcınız bir sonuç kaydettiyse, yoksa Beyan edildi), ve bir Durum (İncelemek için, Onaylandı, Reddedildi). Bir satırı genişleterek gerçeklerini ve iki denetimi görün: Onayla — tutabilir ve Reddet. Bir ret, başvuru sahibinin yanıtı olacak bir gerekçe gerektirir.
Onaylamak iki ayrı eylemdir ve sekme bunların dürüst kalmasını sağlar. Basmak Onayla kaydeder kararınızı başvuru deposuna. Adresi zincir üstünde varlığın izin listesine koymak ikinci bir imza —
batchAddToWhitelist— ve gerçekleşene kadar satır bunu söyler. Kayıtlı karar ile zincir uyuşmadığında, sekme farkı adlandırır ve onu kapatan yazmayı sunar: Kabul et onaylanmış bir adresi izin listesine eklemek için ya da (hâlâ listede olan reddedilmiş bir adres için) onu kaldırma denetimi. İzin listesi yazısı gerçekleşene kadar adres varlığı tutamaz.
Bu sekmedeki sabit not — uyum kesişimi — kendi sürecinizin nereye bağlandığını belirtir:
«Burada belge istenmez ya da tutulmaz — kontroller sizin kendi kontrollerinizdir. Sağlayıcınızı
Başvurulararayüzünün arkasına bağlayın ya da daha önce verdiğiniz kararları içe aktarın. Bloom sonucu kaydeder ve zincir adres için bir evet ya da hayır kaydeder.»
Bu, kendi barındıran bir ihraççının değiştirdiği arayüzdür: başvuru deposunun uygulamasını kendi kalıcı sürümünüzle değiştirin ve hiçbir çağıran değişmez. Bloom hiçbir kontrol yapmaz ve hiçbir belge tutmaz.
Kim tutabilir — transfer kapısı

Bu sekme, varlıkta izin listesine alınmış kaç adres olduğunu bildirir ve izin listesinin uygulanıp uygulanmadığını:
Transferler kısıtlanmamışken, şunu kısıtlamayı teklif eder: transferleri izin listesiyle kısıtla. Yazmanın sonuçları, bunu yapmanın arzı nihai hale getirdiğini ve yönetici olmayanlar için tek yönlü bir kapı olduğunu belirtir.
Transferler kısıtlı, şunu kısıtlamayı teklif eder: kısıtlamayı kaldır. Sonuçları açıkça bunun bir geri alma olmadığını belirtir.
Bir kapısızdır (taslak) varlıkta herhangi bir izin modülü bağlanmamışsa, sekme bunu söyler — «Henüz hiçbir izin modülü bağlanmadı, bu yüzden bunu kimin tutabileceğini hiçbir şey kısıtlamıyor» — ve geçiş düğmesi görünmez.
Token, her transferin iki tarafını da kontrol eder. Varlık kısıtlandığında, taraflardan biri izin listesinde değilse transfer zincir üzerinde tipli bir hata ile geri döner. Aynı kapı bir EVM cüzdan transferi, Solana imzalı transfer, mağaza satışı ve ilk likidite hareketi için de geçerlidir — kendi yönetici yetkileriniz dışında bunun etrafından dolaşmanın yolu yoktur.
Arz

Bu sekme, mevcut toplam arzı tam birim cinsinden bildirir.
Satış — aç, kapat ve gelirleri al

Bu sekme birincil satışı mağaza sözleşmesi üzerinden yürütür.
Hiç satış açık değilken, bir tane açmayı teklif eder: girin Satılacak birimler ve Birim başına fiyat (içinde
wUSDC), ardından şuna basın Satışı açın. Yazmanın önkoşulları önce gösterilir — token kaydedilmiş olmalı, mağaza satış envanterini elinde tutmalı ve mağazanın kendisi de sattığı token üzerinde izinli olmalı — bu yüzden henüz açılabilir olmayan bir satış tam olarak neye ihtiyaç duyduğunu söyler.Bir satış açıkken, tekliften kaç birim kaldığını gösterir ve şunu sunar: Bu satışı kapat.
Satılmayan birimleri geri çağır satılmayan envanteri mağazadan bir alıcıya geri taşır (varsayılan olarak size). Bu değil bir kapatma değildir — satış etkin kalır ve yazmanın sonucu bunu söyler; böylece geri çağırma, geri alma olarak yanlış okunamaz.
Gelirleri çek mağazanın kazancını bir adrese gönderir (varsayılan olarak size). Gelirler, satışın durumundan bağımsız olarak birikir; bu yüzden satış açıkken de kapalıyken de çekilebilir.
Getiri — sahipleri, her işlemde bir tane ödeme yap

Bu sekme, getiriyi sahipler arasında dağıtır.
Bir dağıtım bir tıklama değil, bir yürüyüştür. Rome'da,
distributeYieldWithLimitöder işlem başına bir sahibi (hesap sınırı), bu yüzden bir ödeme kendi imzası olan bir pencere dizisidir. Tutarı bir kez, ödeme para biriminin tam birimleri cinsinden girersiniz ve yürüyüş başladığında kilitlenir. önce Pencere tüm ödemeyi sizden çeker ve ilk sahibine öder; sonraki her pencere yalnızca token sözleşmesinin içindeki parayı hareket ettirir. Bloom, her pencereden sonra imleci zincirden yeniden okur — sahip kümesi bakiyeler değiştikçe yeniden sıralanır ve eski bir indeks göndermek sıfırdan yeniden başlatır ve paranızı ikinci kez çeker.
Sekme ilerlemeyi gösterir — «M sahibinden N numaralı sahibine ödeme yapılıyor» — ve imleç döngüyü tamamladığında biter. Varlık için ödeme para birimi ayarlanmamışsa, sekme bunu söyler; ödeme para birimini ayarlamak, bir dağıtımda yalnızca sizin seçebileceğiniz tek alandır.
Kısıtlanmış sahiplerin payları sözleşmede kalır. Getiri kara liste modülü tarafından hariç tutulan bir adres atlanır ve orantılı payı ödenmek yerine token sözleşmesinde kalır.
Geçmiş ödemeler henüz gösterilmiyor — bunları okumak, dağıtım olaylarını varlığın ilk bloğuna kadar geri götürür; bunun için henüz gelmemiş bir geçmiş imleci gerekir. Sekme bunu içeride söyler, bir 0.
Haklar — roller

Bu sekme, token'ın beyan ettiği her rolü ve tutulup tutulmadığını listeler; her biri tek bir hasRole çağrısıyla token'a karşı okunur. Bir rol değil tutuluyorsa bunu gösterilir; atlanmaz — bir haklar sekmesinde, eksik bir satır ile bir «hayır» farklı gerçeklerdir.
Listenin altında, bir denetim rolleri değiştirir:
Bir hesaba ver
Girdiğiniz bir adres
DEFAULT_ADMIN_ROLE
Bir hesaptan geri al
Girdiğiniz bir adres
DEFAULT_ADMIN_ROLE
Kendi rolünden vazgeç
Kendiniz (OpenZeppelin onaylamanın çağıran kişi olmasını gerektirir)
Siz
Rol seçenekleri token'ın kendi seçenekleridir; bu yüzden denetim token'ın sahip olmadığı bir rolü asla sunamaz. Her yazmada olduğu gibi, yetki satırı ve sonucu düğmeden önce gösterilir; böylece kapı ve tek yönlülüğü imzadan önce belirtilmiş olur.
Bloom'a veya zincire asla dokunmayanlar
Uyumun nerede yaşadığı konusunda net olmak için:
KYC/AML belgeleri ve kişisel tanımlayıcı bilgiler
Kendi sisteminizde, kendi tedarikçileriniz ve saklama sürenizle — asla bu uygulama ya da zincir
Bir adresi kabul etme kararınız
Zincir dışı bir kayıt; depoyu siz yönetirsiniz
Bu kararın zincir üstündeki etkisi
Tek bir boolean — isWhitelisted(address) — tarafından yazılır batchAddToWhitelist
Kuralın uygulanması
Varlık sözleşmesi, her transferde
Varlığı kim yönetebilir
Varlığın izin listesi modülünde tutulan, her istekte kontrol edilen rol
Tam uyum modeli için okuyun COMPLIANCE.md; sahiplerinizin kullandığı iki hatlı (EVM ve Solana) mekanik için okuyun LANES.md.
Son güncelleme
Bu yararlı oldu mu?