GET/infokamu
SEP-6 transfer sunucusu hakkında özellik açıklaması ve içerik bilgisi içeren bir nesne döndürür. Burada açıklanan resmi Stellar SEP-6 tanımlarına uygundur.
GET
/info
GET
/deposit
GET
/withdraw
GET
/transaction
GET
/transactions
Whalestack is retiring its SEP-6 Service for BTC and LTC.
Withdraw your funds before January 15th, 2025.
Stellar'ın SEP-6'sı (Stellar Ecosystem Proposal 6), Stellar ağı ile diğer blok zincirleri veya banka ağları arasında uyumlu bir köprü oluşturmaya yönelik protokolü tanımlar. Bu, Stellar tabanlı varlıkların, düzenli blok zinciri veya banka işlemleri kullanılarak kullanıcının Stellar hesabına kolayca yatırılabilmesini ve bu hesaptan çekilebilmesini sağlar.
SEP-6, bu süreçlerin standartlaştırılmasını sağlayarak cüzdan geliştiricilerinin ve diğer Stellar entegratörlerinin, her biri için uygulamalarını ayarlamak zorunda kalmadan birden fazla anchor için destek eklemelerini kolaylaştırıyor. Belirli bir API uç nokta seti ve beklenen davranışlar sağlar, ayrıca varlıkların nasıl temsil edileceğine dair bir spesifikasyon sunar.
SEP-6'nın, her biri Stellar ekosisteminin belirli bir bileşenini tanımlayan ve tüm ağın birlikte çalışabilir ve standartlaştırılmış kalmasını sağlamayı amaçlayan daha geniş bir Stellar Ekosistem Önerileri paketinin parçası olduğunu belirtmekte fayda var.
Bu Stellar SEP-6 transfer hizmeti, Stellar Ağı üzerinde Bitcoin ve Litecoin'i tokenleştirmenize (yatırmanıza) ve detokenize etmenize (çekmenize) olanak tanır. Buna programatik olarak erişin veya web arayüzümüzü kullanarak para yatırın ve çekin.
Stellar Ağı'ndaki varlıklar, değer taşıyan herhangi bir şeyin dijital (tokenize edilmiş) temsilleridir.
Whalestack, aşağıda listelenen varlıklar için Bitcoin ve Litecoin ihraç eder. Daha fazlasını göstermek için daha fazlayazınız.
Whalestack, SEP-6 transfer sunucusuyla tam şeffaflığa öncelik veriyor. Tüm işlemler açıkça denetlenebilir. Zihninizin rahat olması için, dolaşımdaki arz, sıcak ve soğuk cüzdan adresleri, hesap detayları, blok zinciri işlem kimlikleri ve bakiyeler gibi detayları açıklıyoruz. Koruma altındaki fonlarımız, yalnızca SEP-6 transferleri için kullanılan sıcak veya soğuk cüzdanlarımızda güvenli bir şekilde kalır.
Stellar SEP-6, cüzdanlar, borsalar veya son kullanıcılar gibi çeşitli Stellar uygulamalarının varlık ihraççılarıyla sorunsuz etkileşimde bulunabileceği standartlaştırılmış bir yol sunar - bunlar ankorlar, köprüler veya rampalar olarak adlandırılsın. Whalestack'in SEP-6 uygulamasının kapsamlı bir şekilde incelenmesi için geliştirici belgelerimize bakın.
Whalestack'in varlıkları, ödeme işleme platformumuza bütünsel olarak entegre edilmiştir. Bu, likidite havuzlarına sürekli bir trafik akışını sağlar, böylece dönüşüm ücretleri oluşturur ve arbitraj fırsatlarını teşvik eder. Daha fazla bilgi için likidite havuzu belgelerimize göz atın veya bizimle iletişime geçin.
SEP-6 transfer sunucumuzla etkileşime geçmek için finanse edilmiş bir Stellar hesabınızın olduğundan ve istenen varlık için güven hattı oluşturduğunuzdan emin olun. Özellikle, SEP-6 hizmetimiz izin gerektirmeyen bir yapıya sahiptir, bu nedenle başlamak için kimlik doğrulamasına veya hatta Whalestack hesabına bile ihtiyaç yoktur.
Varlıklar, Stellar Ağındaki değerli herhangi bir şeyin dijital (tokenize edilmiş) temsilleridir. Genellikle fiat veya kripto para birimleri ile desteklenirler. Whalestack, Bitcoin ve Litecoin için aşağıda listelenen varlıkları çıkarır. Whalestack'in tek resmi ve geçerli veren web alan adının whalestack.com
olduğunu lütfen unutmayın.
BTC:GCQVEST7KIWV3KOSNDDUJKEPZLBFWKM7DUS4TCLW2VNVPCBGTDRVTEIT
Para Yatırma Bilgileri | Para Çekme Bilgileri |
Minimum miktar: 0.0005 BTC Maksimum miktar: 100 BTC Ücret (sabit): 0 BTC Ücret (yüzde): 0 % |
Minimum miktar: 0.0005 BTC Maksimum miktar: 100 BTC Ücret (sabit): 0 BTC Ücret (yüzde): 0 % |
Stellar ağında, bir SEP-6 varlığı kullandığınızda, esasen Whalestack gibi hizmet sağlayıcıya para yatırma işlemlerinizi güvenli bir şekilde yönetmesi ve para çekme işlemlerinizi yerine getirmesi için güven vermiş olursunuz. Bu güven kavramı Stellar'da güven hatları kavramı aracılığıyla şekillendirilmiştir. Güven hatları, Stellar hesabınıza eklenen ve belirli bir tokeni tutmanıza olanak tanıyan işaretlerdir. Elinizde tutmaya hazır olduğunuz maksimum token miktarını belirtirler.
Stellar ağında herhangi bir varlığın alım satımını yapmak, almak ve hatta elde tutmak için, varlığın düzenleyen hesabı ile bir güven hattı zorunludur. Bu düzenleyici hesap, varlığı oluşturan hizmet sağlayıcının Stellar hesabıyla ilgilidir. Güven hatları değişim güven işlemi aracılığıyla oluşturulur ve her biri 0,5 XLM'lik bir temel rezerv ücretine tabidir. Esasen, oluşturduğunuz her güven hattı için, güven hattı feshedilene kadar 0,5 XLM'lik harcanamayan bir rezerv zorunludur.
Güven hatları kurmak için, aşağıda belirtildiği gibi varlık koduna, düzenleyici hesabına ve bazen düzenleyici etki alanına ihtiyacınız olacaktır.
BTC:GCQVEST7KIWV3KOSNDDUJKEPZLBFWKM7DUS4TCLW2VNVPCBGTDRVTEIT
Birçok Stellar cüzdanı ve değişimi, çeşitli varlıklar için güven hatlarının eklenmesini ve kaldırılmasını kolaylaştıran sezgisel arayüzlere sahiptir. Tanınmış Stellar platformları arasında Freighter, Albedo, xBull, StellarX, Rabet, Lumenswap, Scopuly, LOBSTR ve StellarTerm bulunmaktadır. Özel bir yaklaşım arayanlar için Stellar Laboratory, kişiselleştirilmiş değişim güveni operasyonlarını güvenli bir şekilde oluşturmak için araçlar sağlar.
Herhangi bir harici hizmeti desteklemediğimizi belirtmekte fayda var. Programatik yaklaşımları (aşağıda ayrıntılı olarak açıklanmıştır) veya Stellar Laboratuvarının kullanımını savunuyoruz.
Programlı olarak bir güven hattı eklemek istiyorsanız, Stellar Yazılım Geliştirme Kitlerinden(SDK) birine, gizli anahtarıyla birlikte yeterince finanse edilmiş bir Stellar hesabına ve güven değiştirme işlemini uygulamak için kod satırlarına erişiminiz olduğundan emin olun. İşte Whalestack'in Bitcoin ve Litecoin Stellar varlıkları için güven hatlarının eklenmesini örnekleyen bir JavaScript kod parçacığı. Unutmayın, bir güven hattını daha sonra silmeyi amaçlıyorsanız, işleminizdeki güven hattı limiti parametresini 0 olarak ayarlayın ve varlık bakiyelerini (varsa) temizleyin.
const sdk = require('stellar-sdk');
const server = new sdk.Horizon.Server('https://horizon.stellar.org');
// Whalestack's Assets
const BtcAsset = new sdk.Asset('BTC', 'GCQVEST7KIWV3KOSNDDUJKEPZLBFWKM7DUS4TCLW2VNVPCBGTDRVTEIT');
const LtcAsset = new sdk.Asset('LTC', 'GCQVEST7KIWV3KOSNDDUJKEPZLBFWKM7DUS4TCLW2VNVPCBGTDRVTEIT');
(async function main() {
const keyPair = sdk.Keypair.fromSecret(process.env.secretKey);
const account = await server.loadAccount(keyPair.publicKey());
const fee = await server.fetchBaseFee();
const transaction = new sdk.TransactionBuilder(account, {
fee, networkPassphrase: sdk.Networks.PUBLIC
})
.addOperation(
sdk.Operation.changeTrust({
source: keyPair.publicKey(),
asset: BtcAsset,
amount: "922337203685.4775807"
})
)
.addOperation(
sdk.Operation.changeTrust({
source: keyPair.publicKey(),
asset: LtcAsset,
amount: "922337203685.4775807"
})
)
.setTimeout(30)
.build();
// sign the transaction
transaction.sign(keyPair);
try {
const transactionResult = await server.submitTransaction(transaction);
console.log(transactionResult);
} catch (e) {
console.error(e.message);
}
})()
Likidite havuzlarına katılım açık ve izne tabidir. Whalestack'in birincil likidite havuzları XLM/BTC
ve BTC/LTC
'dir. Bu havuzlar ağırlıklı olarak Whalestack'teki varlık değişim işlemleri sırasında devreye girer. Bu çiftleri seçmemiz iki yönlüdür: İlk olarak, bunlar ana akım merkezi borsalarda tanınan işlem çiftleridir ve arbitraj eşlemesini kolaylaştırır. İkinci olarak, bu seçim BTC ve LTC'nin XLM aracılığıyla ağdaki diğer önemli varlıklara her zaman bir rotaya sahip olmasını sağlar.
84cf93f8d1c22e150b8f0022b3c9a39d03976da6b5143818327bf298358ce5e7
Whalestack platformunda, ödeme, mevduat, takas ve para çekme gibi işlemler, her varlık değişimi olduğunda yukarıda belirtilen havuzların likiditesinden yararlanır. Daha sıklıkla bu takas Bitcoin veya Litecoin ile USDC gibi fiat bir sabit coin arasında gerçekleşir. Sonuç olarak, Whalestack platformu sürekli olarak tek yönlü havuz trafiği oluşturarak arbitraj fırsatlarının önünü açıyor. Bunun yanı sıra, Stellar Ağındaki genel halka açık ticaret de likidite tüketir ve hacme katkıda bulunur. Eğer bir piyasa yapıcısı veya arbitrajcıysanız, sizi daha derinlere inmeye ve bizimle iletişime geçmeye davet ediyoruz.
Bu konuya girmeden önce, likidite havuzu kavramlarına aşina olmanızı ve geçici kayıp ile ilişkili riskleri anlamanızı öneririz. Bazı bilgilendirici kaynaklar şunlardır: Liquidity, Liquidity, Liquidity, Introducing Automated Market Makers on Stellar ve AMMs in the Stellar Ecosystem.
Likidite havuzlarına katılım herhangi bir izin gerektirmez. Etkin bir şekilde devreye girmek için varlıklar ve ilgili likidite havuzları için güven hatları oluşturmalısınız. xBull, Lumenswap, LOBSTR ve StellarX gibi çeşitli Stellar cüzdanları, para yatırma ve çekme işlemlerini kolaylaştırmak için arayüzler sunar. Ancak, herhangi bir üçüncü taraf platformunu resmi olarak desteklemiyoruz. Anahtarlar, güvenlik ve özelleştirme üzerinde tam kontrol sahibi olmak için programatik olarak veya Stellar Laboratuvarı aracılığıyla doğrudan havuzlarla etkileşim kurmanızı öneririz.
Stellar Geliştirme Vakfı, programatik likidite havuzu katılımının nüanslarını titizlikle belgelemiştir. Bu kapsamlı kılavuza başvurmanızı öneririz. Bu, likidite havuzu oluşturma ve yatırımlarından para çekmelere ve likidite havuzu izlenimine kadar örnekleri kapsar.
Bitcoin veya Litecoin'i tokenize eder ve Stellar Ağına yatırır.
Stellar'daki Bitcoin veya Litecoin varlıklarını detokenize eder ve bunları kendi yerel blok zincirlerine geri döndürür.
Belirli bir transfer talebi veya blok zinciri işlem kimliği için SEP-6 transfer durumunu sorgular.
Whalestack'in SEP-6 Transfer Uygulama Programlama Arayüzü(API'si), Stellar Ağı üzerinde Bitcoin ve Litecoin'i sorunsuz bir şekilde tokenize etmenize (yatırmanıza) ve detokenize etmenize (çekmenize) olanak tanır. Bu kılavuzda, bunu başarmak için gerekli adımlar ele alınmaktadır.
Stellar SEP-6, cüzdanlar, dövizler, son kullanıcılar ve Stellar uygulamalarının Whalestack gibi genellikle anchor, köprü veya rampa olarak adlandırılan varlık ihraççılarıyla sorunsuz bir şekilde arayüz oluşturması için standartlaştırılmış bir yaklaşım oluşturur. Daha kapsamlı bir şekilde anlamak için resmi dokümantasyonunu inceleyebilirsiniz. Ancak, kısa ve öz bir başlangıç noktası arıyorsanız, aşağıda sizin için temel unsurları bir araya getirdik.
Whalestack SEP-6 transfer sunucusu sep6.whalestack.com
adresinde barındırılmaktadır. Etkileşim oldukça basittir: HTTP GET istekleri gönderin ve yanıtları yorumlayın. Bunu kolaylaştırmak için, tercih ettiğiniz programlama diline göre uyarlanmış bir REST istemcisi (PHP, NodeJS ve Ruby için uygulamalar sunuyoruz) veya cURL veya wget gibi yardımcı programlar kullanın. Özellikle, tüm SEP-6 uç noktalarına HTTP GET yoluyla erişildiğinden, temel etkileşimler için bir tarayıcı penceresi yeterli olabilir. Whalestack whalestack.com
alan adı altında faaliyet göstermektedir. stellar.toml ayarlarımızı buradan görüntüleyebilirsiniz.
Dalış yapmadan önce, işlem yapmayı düşündüğünüz varlığa kurulmuş güven hatları ile fonlanmış bir Stellar hesabına sahip olduğunuzdan emin olun. SEP-6 uygulamamız izinsizdir, kimlik doğrulama veya hatta bir Whalestack hesabı ihtiyaç duyulmaz.
Transfer sunucusu, tümü SEP-6 spesifikasyonuna uyan ve HTTP GET yoluyla erişilebilen beş uç nokta sunar. Bu uç noktalar için ayrıntılı özellikler burada keşfedilebilir.
/info
SEP-6 transfer sunucusunun özelliklerini ve içeriğini detaylandıran açıklayıcı bir nesne sağlar./deposit
Temel para yatırma bilgilerini içeren bir nesne sunarak, Stellar'da fon transferi ve tokenize varlıkları alma adımlarını ortaya koyar./withdraw
Varlıkların kendi blok zincirlerine nasıl geri alınacağı da dahil olmak üzere para çekme işlemlerini detaylandıran bir nesne sunar./transaction
Belirli bir SEP-6 para yatırma veya çekme işlemi hakkında bilgi alır./transactions
SEP-6 transfer sunucusu ile ilişkili tüm işlemleri listeler.
const Sep6Client = require('sep6-client');
const client = new Sep6Client('sep6.whalestack.com');
let response = await client.get('/deposit', {
'asset_code': 'BTC',
'account': 'GDONUHZKLSYLDOZWR2TDW25GFXOBWCCKTPK34DLUVSOMFHLGURX6FNU6',
'memo': 'Sent via SEP-6',
'memo_type': 'text'
});
// console.log(response.data) -> {"how":"bc1qj633nx575jm28smgcp3mx6n3gh0zg6ndr0ew23","id":"f2118ef4115642870638616a4372","eta":600,"min_amount":"0.00001","max_amount":"100.0000000","extra_info":{}}
Burada belgelenmiş bazı ek içerik bilgileriyle birlikte bir Bitcoin yatırma adresi döndürür. Alınan para yatırma adresine gönderilen Bitcoin, Stellar üzerinde tokenize edilir ve yukarıdaki hesaba gönderilir. Tokenlaştırılmış Bitcoin, Stellar Ağı üzerinde gönderilip alınabilir, SDEX üzerindeki diğer varlıklarla değiştirilebilir veya Stellar'ın likidite havuzlarına yatırılabilir.
const Sep6Client = require('sep6-client');
const client = new Sep6Client('sep6.whalestack.com');
let response = await client.get('/withdraw', {
'asset_code': 'BTC',
'dest': 'bc1qj633nx575jm28smgcp3mx6n3gh0zg6ndr0ew23'
});
// console.log(response.data) -> {"account_id":"GCQVESTEG3MY2AA4LFF2J5K77IQP4G5WZCUDOJ5RUIPA6ZKRGQ7XXKBR","memo_type":"text","memo":"010cdf0a41410d75b2797a6fa38f","id":"010cdf0a41410d75b2797a6fa38f","min_amount":"0.0005000","max_amount":"100.0000000","fee_fixed":0.0002,"fee_percent":0.2,"extra_info":{"message":"An amount above 100.0000000 will take longer to complete"}}
Burada belgelenen bazı ek içerik bilgilerinin yanı sıra bir Stellar hesabı ve notu döndürür. Verilen hesaba gönderilen tokenize Bitcoin, Stellar Ağında yakılır ve talepte verilen Bitcoin adresine bırakılır.
SEP-6 transfer sunucusu, herhangi bir programlama dilindeki herhangi bir REST istemcisi ile çalışır ve hızlı bir şekilde başlamanıza yardımcı olmak için GitHub adresimizde PHP, Ruby ve NodeJS için Yazılım Geliştirme Kitleri (SDK) yayınladık.
SEP-6 transfer sunucusu hakkında özellik açıklaması ve içerik bilgisi içeren bir nesne döndürür. Burada açıklanan resmi Stellar SEP-6 tanımlarına uygundur.
curl 'https://sep6.whalestack.com/info'
{ "deposit":{ "BTC":{ "enabled":true, "min_amount":0.0001, "max_amount":100, "fee_fixed":0, "fee_percent":0, "authentication_required":false }, "LTC":{ "enabled":true, "min_amount":0.00001, "max_amount":10000, "fee_fixed":0, "fee_percent":0, "authentication_required":false } }, "withdraw":{ "BTC":{ "enabled":true, "min_amount":0.0005, "max_amount":100, "fee_fixed":0.0002, "fee_percent":0.2, "authentication_required":false, "types":{ "crypto":{ "fields":{ "dest":{ "description":"The Bitcoin target address in any format, i.e. native SegWit (bech32), SegWit (P2SH), or legacy (P2PKH).", "optional":false } } } } }, "LTC":{ "enabled":true, "min_amount":0.0005, "max_amount":10000, "fee_fixed":0.0002, "fee_percent":0.2, "authentication_required":false, "types":{ "crypto":{ "fields":{ "dest":{ "description":"The Litecoin target address in any format, i.e. native SegWit (bech32), SegWit (P2SH), or legacy (P2PKH).", "optional":false } } } } } }, "transaction":{ "enabled":true, "authentication_required":false }, "transactions":{ "enabled":true, "authentication_required":false }, "features":{ "account_creation":false, "claimable_balances":false }, "fee":{ "enabled":false }, "deposit-exchange":{ "enabled":false }, "withdraw-exchange":{ "enabled":false }, "supply":{ "BTC":{ "circulating_supply":5.671082, "circulating_supply_components":{ "amount":1.0399347, "claimable_balances_amount":0, "liquidity_pools_amount":4.6311473 }, "hotwallet_reserves":1.6826130, "coldwallet_reserves":4.0000000, "total_reserves":5.6826130 }, "LTC":{ "circulating_supply":318.5104129, "circulating_supply_components":{ "amount":136.3382091, "claimable_balances_amount":0, "liquidity_pools_amount":182.1722038 }, "hotwallet_reserves":118.6363572, "coldwallet_reserves":200.0000000, "total_reserves":318.6363572 } } }
İsim | Tür | Açıklama | Boş olabilen değer |
---|---|---|---|
deposit |
object | An object containing an associative list of assets available for deposit and additional context information about the assets. Each asset is identified by its key, which is the asset code. | false |
.ASSET_CODE |
object | An object containing context information about the asset identified in the deposit object's key attribute. | false |
.enabled |
boolean | Indicates whether deposit transactions are enabled. If set to false then this is the only attribute of the object. |
false |
.min_amount |
float | Indicates the minimum deposit amount on the /deposit endpoint. |
false |
.max_amount |
float | Indicates the maximum deposit amount on the /deposit endpoint. |
false |
.fee_fixed |
float | Indicates the fixed fee on the /deposit endpoint. In units of the deposited asset. |
false |
.fee_percent |
float | Indicates the percentage fee on the /deposit endpoint. In units of percentage points. |
false |
.authentication_required |
boolean | Indicates whether authentication for this asset is required on the /deposit endpoint. If set to true then requests must be authenticated via SEP-10. |
false |
withdraw |
object | An object containing an associative list of assets available for withdrawal and additional context information about the assets. Each asset is identified by its key, which is the asset code. | false |
.ASSET_CODE |
object | An object containing context information about the asset identified in the withdraw object's key attribute. | false |
.enabled |
boolean | Indicates whether withdrawal transactions are enabled. If set to false then this is the only attribute of the object. |
false |
.min_amount |
float | Indicates the minimum withdrawal amount on the /withdraw endpoint. |
false |
.max_amount |
float | Indicates the maximum withdrawal amount on the /withdraw endpoint. |
false |
.fee_fixed |
float | Indicates the fixed fee on the /withdraw endpoint. In units of the deposited asset. |
false |
.fee_percent |
float | Indicates the percentage fee on the /withdraw endpoint. In units of percentage points. |
false |
.authentication_required |
boolean | Indicates whether authentication for this asset is required on the /withdraw endpoint. If set to true then requests must be authenticated via SEP-10. |
false |
.types |
object | An object containing instructions for `dest` parameter on the /withdraw endpoint. |
false |
transaction |
object | An object containing information about the /transaction endpoint. |
false |
.enabled |
boolean | Indicates whether the /transaction is enabled. If set to false then this is the only attribute of the object. |
false |
.authentication_required |
boolean | Indicates whether the /transaction requires authentication. If set to true then requests must be authenticated via SEP-10. |
false |
transactions |
object | An object containing information about the /transactions endpoint. |
false |
.enabled |
boolean | Indicates whether the /transactions is enabled. If set to false then this is the only attribute of the object. |
false |
.authentication_required |
boolean | Indicates whether the /transactions requires authentication. If set to true then requests must be authenticated via SEP-10. |
false |
features |
object | An object containing information about possible additional features provided by the SEP-6 server. | false |
.account_creation |
boolean | Indicates whether the SEP-6 transfer server supports creating accounts for users requesting deposits (Whalestack does not). | false |
.claimable_balances |
boolean | Indicates whether the SEP-6 transfer server supports sending deposits as claimable balances to accounts that do not have a trustline established (Whalestack does not, a trustline is required prior to receiving a deposit address). | false |
fee |
object | An object containing information about the optional SEP-6 /fee endpoint. | false |
.enabled |
boolean | Indicates whether the /fee endpoint is enabled (in Whalestack SEP-6 it is not because we use the fee_fixed and fee_percent above in lieu of a dedicated fee endpoint). If set to false then this is the only attribute of the object. |
false |
.authentication_required |
boolean | Indicates whether the /fee requires authentication. If set to true then requests must be authenticated via SEP-10. |
false |
deposit-exchange |
object | An object containing information about the optional SEP-6 /deposit-exchange endpoint. | false |
.enabled |
boolean | Indicates whether the /deposit-exchange endpoint is enabled (in Whalestack SEP-6 it is not). If set to false then this is the only attribute of the object. |
false |
.authentication_required |
boolean | Indicates whether the /deposit-exchange requires authentication. If set to true then requests must be authenticated via SEP-10. |
false |
withdraw-exchange |
object | An object containing information about the optional SEP-6 /withdraw-exchange endpoint. | false |
.enabled |
boolean | Indicates whether the /withdraw-exchange endpoint is enabled (in Whalestack SEP-6 it is not). If set to false then this is the only attribute of the object. |
false |
.authentication_required |
boolean | Indicates whether the /withdraw-exchange requires authentication. If set to true then requests must be authenticated via SEP-10. |
false |
supply |
object | An object containing circulating supplies, hot wallet, and cold wallet reserves for above-mentioned assets. Cached five minutes. | false |
{ "status":"400", "error":"invalid request (and more information explaining the error"" }
İsim | Tür | Açıklama | Boş olabilen değer |
---|---|---|---|
status |
string | The issued HTTP status code. | false |
error |
string | A human readable string explaining the error. | false |
Stellar'da ödeme yapmak ve tokenize edilmiş varlıkları almak için gereken tüm bilgileri içeren para yatırma bilgilerini içeren bir nesne döndürür. Burada açıklanan resmi Stellar SEP-6 tanımlarına uygundur.
curl 'https://sep6.whalestack.com/deposit?asset_code=BTC&account=GDONUHZKLSYLDOZWR2TDW25GFXOBWCCKTPK34DLUVSOMFHLGURX6FNU6'
Key | Tür | Açıklama | Boş olabilen değer | Zorunlu |
---|---|---|---|---|
asset_code |
string | The asset code of the asset you wish to deposit. | false | mandatory |
account |
string | The Stellar account to which you wish to deposit. As a prerequisite for receiving tokenized funds the account must have a trustline for the desired asset. | false | mandatory |
type |
string | Requests a specific Bitcoin or Litecoin address type. Allowed types are p2sh-segwit , bech32 , legacy . Defaults to bech32 . |
false | optional |
memo |
string | An optional memo to be sent to the above Stellar account. If a memo is given its type must also be specified in memo_type . |
false | optional |
memo_type |
string | A string specifying the given memo type. Valid options are text , id , and hash . |
false | optional |
email_address |
string | Reserved for future use. An optional email address for receiving email updates related to this deposit transfer. | false | optional |
on_change_callback |
string | An optional URL listening for status updates related to this deposit transfer. The callback sends an HTTP POST request with a JSON object conforming to the one described in /transaction .Your server should respond with a 200 OK HTTP status code upon to acknowledge the callback. If we don't see a 200 OK response we will keep re-sending the callback for a while until we encounter one and eventually give up (after 48 hours or so). Callbacks are signed via an HTTP header, as documented here. |
false | optional |
{ "how":"bc1qj633nx575jm28smgcp3mx6n3gh0zg6ndr0ew23", "id":"085a2e4aca82edd52d12b37388da", "eta":600, "min_amount":"0.0001000", "max_amount":"100.0000000", "fee_fixed":"0.0000000", "fee_fixed":"0.0000000", "extra_info":{} }
İsim | Tür | Açıklama | Boş olabilen değerNullable |
---|---|---|---|
how |
string | The blockchain address to which the deposit should be sent. | false |
id |
string | A unique identifier given by Whalestack. Save this client-side to reference and query this deposit and related blockchain transactions using the /transaction endpoint. |
false |
eta |
integer | An estimated time of fund transfer in seconds. The actual time can vary depending on underlying blockchain speed and used fees. | false |
min_amount |
string | The minimum deposit amount for the fund transfer to trigger. Deposits below the minimum threshold stay pending until the sum of all made deposits matches or exceeds this amount. | false |
max_amount |
string | The maximum deposit amount. | false |
fee_fixed |
string | Indicates the fixed fee for this deposit. In units of the deposited asset. | false |
fee_percent |
string | Indicates the percentage fee for this deposit. In units of percentage points. | false |
extra_info |
object | An object optionally containing exactly one field message containing a human readable text string with additional information. |
false |
{ "status":"400", "error":"Account does not have a trustline for BTC-GCQVEST7KIWV3KOSNDDUJKEPZLBFWKM7DUS4TCLW2VNVPCBGTDRVTEIT." }
İsim | Tür | Açıklama | Boş olabilen değer |
---|---|---|---|
status |
string | The issued HTTP status code. | false |
error |
string | A human readable string explaining the error. | false |
Varlıkları altta yatan blok zincirinde kullanmak için gereken tüm bilgileri içeren para çekme bilgilerine sahip bir öğeyi döndürür. Burada açıklanan resmi Stellar SEP-6 tanımlarına uygundur.
curl 'https://sep6.whalestack.com/withdraw?asset_code=BTC&dest=bc1qj633nx575jm28smgcp3mx6n3gh0zg6ndr0ew23'
Key | Tür | Açıklama | Boş olabilen değer | Zorunlu |
---|---|---|---|---|
asset_code |
string | The asset code of the asset you wish to redeem. | false | mandatory |
dest |
string | The Bitcoin (or Litecoin) target address in any format, i.e. native SegWit (bech32), SegWit (P2SH), or legacy (P2PKH). | false | mandatory |
email_address |
string | Reserved for future use. An optional email address for receiving email updates related to this withdrawal transfer. | false | optional |
on_change_callback |
string | An optional URL listening for status updates related to this withdrawal transfer. The callback sends an HTTP POST request with a JSON object conforming to the one described in /transaction .Your server should respond with a 200 OK HTTP status code upon to acknowledge the callback. If we don't see a 200 OK response we will keep re-sending the callback for a while until we encounter one and eventually give up (after 48 hours or so). Callbacks are signed via an HTTP header, as documented here. |
false | optional |
type |
string | Optional parameter indicating the type of withdrawal. The only currently allowed value is crypto . |
false | optional |
{ "account_id":"GCQVESTEG3MY2AA4LFF2J5K77IQP4G5WZCUDOJ5RUIPA6ZKRGQ7XXKBR", "memo_type":"text", "memo":"cf86a99b3e6ecd1359a0d2992e70", "id":"cf86a99b3e6ecd1359a0d2992e70", "min_amount":"0.0005000", "max_amount":"100.0000000", "fee_fixed":0.0002, "fee_percent":0.2, "extra_info":{ "message":"An amount above 100.0000000 BTC will take longer to complete" } }
İsim | Tür | Açıklama | Boş olabilen değer |
---|---|---|---|
account_id |
string | The Stellar account to which the funds should be sent. | false |
memo |
string | A mandatory memo to be included in the Stellar withdrawal transaction. It is vital to include the memo. Funds sent without the memo might not be able to be resolved or refunded. | false |
memo_type |
integer | The memo type (always text ). |
false |
id |
string | A unique identifier given by Whalestack. Save this client-side to reference and query this withdrawal and related blockchain transactions using the /transaction endpoint. |
false |
min_amount |
string | The minimum withdrawal amount for the fund transfer to trigger. Payment operations below the minimum threshold stay pending until the sum of all made payments matches or exceeds this amount. | false |
max_amount |
string | The maximum withdrawal amount. | false |
fee_fixed |
string | Indicates the fixed fee for this withdrawal. In units of the transferred asset. | false |
fee_percent |
string | Indicates the percentage fee for this withdrawal. In units of percentage points. | false |
extra_info |
object | An object optionally containing exactly one field message containing a human readable text string with additional information. |
false |
{ "status":"400", "error":"Invalid destination address." }
İsim | Tür | Açıklama | Boş olabilen değer |
---|---|---|---|
status |
string | The issued HTTP status code. | false |
error |
string | A human readable string explaining the error. | false |
Bir SEP-6 para yatırma veya çekme işlemine ilişkin işlem bilgilerini içeren bir nesne döndürür. Burada açıklanan resmi Stellar SEP-6 tanımlarına uygundur.
Bir depozito, çekme veya işlem isteğine yapılan HTTP yanıtında Whalestack tarafından verilen bir id
, bir stellar_transaction_id
veya bir external_transaction_id
(yani Bitcoin veya Litecoin işlem kimliği) gerektirir.
curl 'https://sep6.whalestack.com/transaction?external_transaction_id=914f2fe1175101d5d1b3fc75c053cc090590bb0e251b938c255598c828742c43'
Key | Tür | Açıklama | Boş olabilen değer | Zorunlu |
---|---|---|---|---|
id |
string | A transfer id as given by Whalestack in the HTTP response to a /deposit , /withdraw , or /transactions request. |
true | optional |
stellar_transaction_id |
string | A Stellar transaction id related to a SEP-6 deposit or withdrawal. | true | optional |
external_transaction_id |
string | An external transaction id (i.e. a Bitcoin or Litecoin transaction id) related to a SEP-6 deposit or withdrawal. | true | optional |
{ "transaction":{ "id":"085a2e4aca82edd52d12b37388da-814f2fe117-0", "status":"completed", "message":"Transaction fully completed.", "kind":"deposit", "amount_in":"0.0001000", "amount_in_asset":"iso-24165:BTC", "amount_out":"0.0001000", "amount_out_asset":"stellar:BTC:GCQVEST7KIWV3KOSNDDUJKEPZLBFWKM7DUS4TCLW2VNVPCBGTDRVTEIT", "amount_fee":"0.0000000", "from":"bc1qj633nx575jm28smgcp3mx6n3gh0zg6ndr0ew23", "started_at":"2022-10-04T20:50:18.307Z", "completed_at":"2022-10-04T20:51:20.032Z", "stellar_transaction_id":"a426a057aaba5a5811d5ee243f76c767a6756df89f417610a4ebd114e162596a", "external_transaction_id":"814f2fe1175101d5d1b3fc75c053cc090590bb0e251b938c255598c828742c43", } }
İsim | Tür | Açıklama | Boş olabilen değer |
---|---|---|---|
transaction |
object | An object containing information about the transfer transaction. | false |
.id |
string | A composite id combining the SEP-6 transfer id as given by Whalestack in the HTTP response to a deposit or withdrawal request with a conditional unique suffix in the format -[a-z0-9]{10}-[0-9] identifying a single SEP-6 transfer explicitly. |
false |
.status |
string |
A transaction state as documented here.
Possible states:
completed , pending_external , pending_anchor , pending_stellar , pending_trust , pending_user , pending_user_createaccount , pending_user_transfer_start , pending_user_transfer_complete , pending_customer_info_update , incomplete , expired , too_small , too_large , error .
|
false |
.message |
string | A human-readable text string explaining the status given above. |
false |
.kind |
string | The transaction type. Possible values are deposit and withdrawal . |
false |
.amount_in |
string | Amount received by transfer server at the start of the transaction. A string with up to 7 decimals. Excludes any fees charged before the transfer server received the funds. | true |
.amount_in_asset |
string | The asset received or to be received by the transfer server. The value is in SEP-38 Asset Identification format. | true |
.amount_out |
string | Amount sent by the transfer server to the user at end of transaction. A string with up to 7 decimals. | true |
.amount_out_asset |
string | The asset delivered or to be delivered to the user. The value is in SEP-38 Asset Identification format. | true |
.amount_fee |
string | Amount of fee charged by the transfer server. | true |
.from |
string | A Stellar account in the case of withdrawal transactions or a comma-separated string with all UTXO inputs in the case of deposits. | true |
.started_at |
string | Start date and time of transaction (UTC ISO 8601). | true |
.completed_at |
string | Completion date and time of transaction (UTC ISO 8601). | true |
.stellar_transaction_id |
string | Id on Stellar Network indicating the transaction that either completed the deposit or started the withdrawal. | true |
.external_transaction_id |
string | Id of the blockchain transaction on the external network that either started the deposit or completed the withdrawal. | true |
.withdraw_anchor_account |
string | If this is a withdrawal, this is the anchor's Stellar account that the user transferred (or will transfer) their issued asset to. | true |
.withdraw_memo |
string | Mandatory withdrawal memo given by the transfer server. | true |
.withdraw_memo_type |
string | Mandatory withdrawal memo type given by the transfer server. | true |
related_transactions |
object | An optional list of additional transaction objects for situations in which more than one blockchain transaction is associated with a deposit or withdrawal. | true |
{ "status":"404", "error":"not found" }
İsim | Tür | Açıklama | Boş olabilen değer |
---|---|---|---|
status |
string | The issued HTTP status code. | false |
error |
string | A human readable string explaining the error. | false |
/transaction
içinde açıklandığı gibi işlem öğelerinin bir listesini döndürür. Burada açıklanan resmi Stellar SEP-6 tanımlarına uygundur.
curl 'https://sep6.whalestack.com/transactions?asset_code=BTC&account=GACK3ODRMGCTRH6HNVETEOF2ZK5G5QUIGLDFFZQSLM6RZJ2LFY3VWQBT'
Key | Tür | Açıklama | Boş olabilen değer | Zorunlu |
---|---|---|---|---|
asset_code |
string | The asset code of interest, e.g. BTC or LTC . |
false | mandatory |
account |
string | The stellar account id involved in the transactions. Without this filter the entire transaction history of the transfer server is queried. | false | optional |
no_older_than |
string | The response should only contain transactions starting on or after this date and time (UTC ISO 8601). | true | optional |
limit |
string | The response should contain at most limit transactions. | true | optional |
kind |
string | A comma-separated list containing the desired transaction kinds. Possible values are deposit and withdrawal . |
true | optional |
paging_id |
string | The response should contain transactions starting prior to this ID (exclusive). | true | optional |
{ "transactions":[ { "id": "30978809351d5e145b8a9bce49a8", "kind": "deposit", "status": "pending_user_transfer_start", "message": "Please initiate your transfer." }, { "id":"085a2e4aca82edd52d12b37388da-814f2fe117-0", "status":"completed", "message":"Transaction fully completed.", "kind":"deposit", "amount_in":"0.0001000", "amount_in_asset":"iso-24165:BTC", "amount_out":"0.0001000", "amount_out_asset":"stellar:BTC:GCQVEST7KIWV3KOSNDDUJKEPZLBFWKM7DUS4TCLW2VNVPCBGTDRVTEIT", "amount_fee":"0.0000000", "from":"bc1qj633nx575jm28smgcp3mx6n3gh0zg6ndr0ew23", "started_at":"2022-10-04T20:50:18.307Z", "completed_at":"2022-10-04T20:51:20.032Z", "stellar_transaction_id":"a426a057aaba5a5811d5ee243f76c767a6756df89f417610a4ebd114e162596a", "external_transaction_id":"814f2fe1175101d5d1b3fc75c053cc090590bb0e251b938c255598c828742c43" }, { "id":"9f5762bbbe11dc58be299b8d68e3-8348091630-0", "status":"completed", "message":"Transaction fully completed.", "kind":"withdraw", "amount_in":"0.0005000", "amount_in_asset":"stellar:LTCTEST:GBSY6HJZLWBUUNJHHDLDE3AIBSQCHI6UMIMWOLZ6GUWI3NPPLP6QNGI2", "amount_out":"0.0002990", "amount_out_asset":"iso24165:LTC", "amount_fee":"0.0002010", "from":"GACK3ODRMGCTRH6HNVETEOF2ZK5G5QUIGLDFFZQSLM6RZJ2LFY3VWQBT", "started_at":"2022-10-05T00:04:02.168Z", "completed_at":"2022-10-05T00:12:30.284Z", "stellar_transaction_id":"83480916303afa78b93831e3964eec748b6265148823d27fecb7c7648a9c87ec#184545592135122945", "external_transaction_id":"f09c0f9fcf7cf88727b20275b2b231b2a0dbb2563e3ad19fe97b839fe50dff50", "withdraw_memo":"9f5762bbbe11dc58be299b8d68e3", "withdraw_memo_type":"text", "withdraw_anchor_account":"GCQVEST7KIWV3KOSNDDUJKEPZLBFWKM7DUS4TCLW2VNVPCBGTDRVTEIT" } ] }
İsim | Tür | Açıklama | Boş olabilen değer |
---|---|---|---|
transactions |
array | An array of transaction objects as described in /transaction . |
false |
{ "status":"500", "error":"internal server error" }
İsim | Tür | Açıklama | Boş olabilen değer |
---|---|---|---|
status |
string | The issued HTTP status code. | false |
error |
string | A human readable string explaining the error. | false |
https://github.com/whalestackhq/sep6-client-php |
This client communicates with Whalestack's Stellar SEP-6 transfer server documented here. It lets you on- and off-ramp Bitcoin on the Stellar Network. This client is written in PHP but we also provide clients in different programming languages.
Read our stellar.toml to inspect available Whalestack assets on the Stellar Network. At the time of writing we support wrapped Bitcoin and Litecoin.
Copy the contents of src
into the include path of your project.
Usage Client
include('SEP6Client.class.php');
$client = new SEP6Client();
Deposit Bitcoin onto Stellar
$response = $client->get('/deposit', array(
'asset_code' => 'BTC',
'account' => 'GDONUHZKLSYLDOZWR2TDW25GFXOBWCCKTPK34DLUVSOMFHLGURX6FNU6',
'memo' => 'Sent via SEP-6',
'memo_type' => 'text'
));
// $response->responseBody -> {"how":"bc1qj633nx575jm28smgcp3mx6n3gh0zg6ndr0ew23","id":"f2118ef4115642870638616a4372","eta":600,"min_amount":"0.00001","max_amount":"100.0000000","extra_info":{}}
Returns a Bitcoin deposit address alongside some additional context information documented here. Bitcoin sent to the received deposit address is tokenized onto Stellar and sent to above account. The tokenized Bitcoin can be sent and received on the Stellar Network, exchanged for other assets on the SDEX, or be deposited into Stellar's liquidity pools.
Withdraw Bitcoin from Stellar
$response = $client->get('/withdraw', array(
'asset_code' => 'BTC',
'dest' => 'bc1qj633nx575jm28smgcp3mx6n3gh0zg6ndr0ew23'
));
// $response->responseBody -> {"account_id":"GCQVEST7KIWV3KOSNDDUJKEPZLBFWKM7DUS4TCLW2VNVPCBGTDRVTEIT","memo_type":"text","memo":"010cdf0a41410d75b2797a6fa38f","id":"010cdf0a41410d75b2797a6fa38f","min_amount":"0.0005000","max_amount":"100.0000000","fee_fixed":0.0002,"fee_percent":0.2,"extra_info":{"message":"An amount above 100.0000000 will take longer to complete"}}
Returns a Stellar account and memo alongside some additional context information documented here. Tokenized Bitcoin sent to the given account is burned on the Stellar Network and released into the Bitcoin address given in the request.
Please inspect our SEP-6 API docs or email us at service [at] whalestack.com if you have questions.
We'd love to hear your feedback. If you have specific problems or bugs with this SDK, please file an issue on GitHub. For general feedback and support requests please email service [at] whalestack.com.
git checkout -b my-new-feature
)git commit -am 'Add some feature'
)git push origin my-new-feature
)https://github.com/whalestackhq/sep6-client-nodejs |
This client communicates with Whalestack's Stellar SEP-6 transfer server documented here. It lets you on- and off-ramp Bitcoin on the Stellar Network. This client is written in Node JS but we also provide clients in different programming languages.
Read our stellar.toml to inspect available Whalestack assets on the Stellar Network. At the time of writing we support wrapped Bitcoin and Litecoin.
npm install sep6-client
Usage Client
const Sep6Client = require('sep6-client');
const client = new Sep6Client();
Deposit Bitcoin onto Stellar
let response = await client.get('/deposit', {
'asset_code': 'BTC',
'account': 'GDONUHZKLSYLDOZWR2TDW25GFXOBWCCKTPK34DLUVSOMFHLGURX6FNU6',
'memo': 'Sent via SEP-6',
'memo_type': 'text'
});
// console.log(response.data) -> {"how":"bc1qj633nx575jm28smgcp3mx6n3gh0zg6ndr0ew23","id":"f2118ef4115642870638616a4372","eta":600,"min_amount":"0.00001","max_amount":"100.0000000","extra_info":{}}
Returns a Bitcoin deposit address alongside some additional context information documented here. Bitcoin sent to the received deposit address is tokenized onto Stellar and sent to above account. The tokenized Bitcoin can be sent and received on the Stellar Network, exchanged for other assets on the SDEX, or be deposited into Stellar's liquidity pools.
Withdraw Bitcoin from Stellar
let response = await client.get('/withdraw', {
'asset_code': 'BTC',
'dest': 'bc1qj633nx575jm28smgcp3mx6n3gh0zg6ndr0ew23'
});
// console.log(response.data) -> {"account_id":"GCQVEST7KIWV3KOSNDDUJKEPZLBFWKM7DUS4TCLW2VNVPCBGTDRVTEIT","memo_type":"text","memo":"010cdf0a41410d75b2797a6fa38f","id":"010cdf0a41410d75b2797a6fa38f","min_amount":"0.0005000","max_amount":"100.0000000","fee_fixed":0.0002,"fee_percent":0.2,"extra_info":{"message":"An amount above 100.0000000 will take longer to complete"}}
Returns a Stellar account and memo alongside some additional context information documented here. Tokenized Bitcoin sent to the given account is burned on the Stellar Network and released into the Bitcoin address given in the request.
Please inspect our SEP-6 API docs or email us at service [at] whalestack.com if you have questions.
We'd love to hear your feedback. If you have specific problems or bugs with this SDK, please file an issue on GitHub. For general feedback and support requests please email service [at] whalestack.com.
git checkout -b my-new-feature
)git commit -am 'Add some feature'
)git push origin my-new-feature
)https://github.com/whalestackhq/sep6-client-ruby |
This client communicates with Whalestack's Stellar SEP-6 transfer server documented here. It lets you on- and off-ramp Bitcoin on the Stellar Network. This client is written in Ruby but we also provide clients in different programming languages.
Read our stellar.toml to inspect available Whalestack assets on the Stellar Network. At the time of writing we support wrapped Bitcoin and Litecoin.
gem install sep6_client
Usage Client
require 'sep_client/client'
client = Sep6Client::Client.new()
Deposit Bitcoin onto Stellar
response = client.get('/deposit', {
:asset_code => 'BTC',
:account => 'GDONUHZKLSYLDOZWR2TDW25GFXOBWCCKTPK34DLUVSOMFHLGURX6FNU6',
:memo => 'Sent via SEP-6',
:memo_type => 'text',
})
// print response.body -> {"how":"bc1qj633nx575jm28smgcp3mx6n3gh0zg6ndr0ew23","id":"f2118ef4115642870638616a4372","eta":600,"min_amount":"0.00001","max_amount":"100.0000000","extra_info":{}}
Returns a Bitcoin deposit address alongside some additional context information documented here. Bitcoin sent to the received deposit address is tokenized onto Stellar and sent to above account. The tokenized Bitcoin can be sent and received on the Stellar Network, exchanged for other assets on the SDEX, or be deposited into Stellar's liquidity pools.
Withdraw Bitcoin from Stellar
response = client.get('/withdraw', {
:asset_code => 'BTC',
:dest => 'bc1qj633nx575jm28smgcp3mx6n3gh0zg6ndr0ew23'
})
// print response.body -> {"account_id":"GCQVEST7KIWV3KOSNDDUJKEPZLBFWKM7DUS4TCLW2VNVPCBGTDRVTEIT","memo_type":"text","memo":"010cdf0a41410d75b2797a6fa38f","id":"010cdf0a41410d75b2797a6fa38f","min_amount":"0.0005000","max_amount":"100.0000000","fee_fixed":0.0002,"fee_percent":0.2,"extra_info":{"message":"An amount above 100.0000000 will take longer to complete"}}
Returns a Stellar account and memo alongside some additional context information documented here. Tokenized Bitcoin sent to the given account is burned on the Stellar Network and released into the Bitcoin address given in the request.
Please inspect our SEP-6 API docs or email us at service [at] whalestack.com if you have questions.
We'd love to hear your feedback. If you have specific problems or bugs with this SDK, please file an issue on GitHub. For general feedback and support requests please email service [at] whalestack.com.
git checkout -b my-new-feature
)git commit -am 'Add some feature'
)git push origin my-new-feature
)
Whalestack'in SEP-6 transfer sunucusu şeffaf ve denetlenebilirdir. Aşağıda SEP-6 transfer sunucusunun son para yatırma ve çekme geçmişine ilişkin ayrıntılı bir liste yer almaktadır. Tüm transfer sunucusu geçmişini sorgulayıp kontrol edin ve belirtilen cüzdan rezervlerini doğrulamak için /transactions
uç noktasını kullanın.