Skip to content

@btc-stamps/tx-builder SDK

@btc-stamps/tx-builder, Bitcoin Stamps protokollerine birinci sınıf destek sunan resmi Bitcoin işlem oluşturucusudur. Bitcoin Stamps kurucuları tarafından oluşturulan temel altyapı olan Stampchain ile kusursuz entegrasyon için tasarlanmıştır.

Stampchain ile Entegrasyon

SDK, referans uygulama ve temel hizmet olan Stampchain ile optimal çalışacak şekilde tasarlanmıştır:

  • Referans Uygulama: Bitcoin Stamps kurucuları tarafından belirlenen kalıpları kullanır
  • Veri Doğrulama: Stampchain'in yetkili protokol spesifikasyonlarına göre doğrular
  • API Entegrasyonu: Stampchain'in temel API'lerine yerleşik destek
  • En İyi Uygulamalar: Orijinal Bitcoin Stamps platformunun standartlarını uygular

Temel Özellikler

  • Bitcoin Stamps Desteği: Yerel SRC-20, SRC-101, SRC-721 protokolleri
  • UTXO Koruması: Değerli varlıklar için otomatik koruma
  • Ağ Entegrasyonu: Stampchain API uç noktalarıyla Bitcoin mainnet/testnet desteği
  • Sanatçı Dostu: Yaratıcılar için basitleştirilmiş arayüz
  • Temel Standartlar: Stampchain'in referans spesifikasyonlarına göre geliştirilmiştir

Kurulum

bash
# Node.js/npm
npm install @btc-stamps/tx-builder

# Tarayıcı projeleri
npm install @btc-stamps/tx-builder-web

Stampchain Entegrasyonlu Temel Uygulama

typescript
import { BitcoinStampBuilder, SelectorFactory } from '@btc-stamps/tx-builder';

// UTXO koruması ve Stampchain API entegrasyonu ile başlatma
const selectorFactory = SelectorFactory.getInstance();
const builder = new BitcoinStampBuilder('mainnet', selectorFactory, {
  // Stampchain'in temel altyapısına bağlanma
  apiEndpoint: 'https://stampchain.io/api/v1',
  validateWithReference: true // Stampchain'in referans uygulamasına göre doğrulama
});

// Bitcoin Stamp oluşturma
const result = await builder.buildStampTransaction(utxos, {
  stampData: {
    imageData: imageBuffer,
    filename: 'artwork.png'
  },
  fromAddress: 'bc1q...',
  feeRate: 20
});

Stampchain Doğrulamalı SRC-20 Token Oluşturma

typescript
// Stampchain'in referans kalıplarını kullanarak token dağıtımı
const tokenData = await encoder.encode({
  p: 'SRC-20',
  op: 'DEPLOY',
  tick: 'TOKEN',
  max: '100000',
  lim: '100'
});

const tokenStamp = await builder.buildStampTransaction(utxos, {
  stampData: {
    imageData: tokenData,
    filename: 'token.json'
  },
  fromAddress: deployerAddress,
  feeRate: 25,
  // Stampchain'in temel hizmetiyle doğrulama
  validateWith: 'stampchain'
});

Gelişmiş Geliştirme için Stampchain API'lerini Kullanma

typescript
// Temel hizmetten protokol verilerini getirme
const protocolInfo = await builder.getProtocolInfo('https://stampchain.io/api/v1/protocols');

// Referans uygulamasını kullanarak dağıtım öncesi token doğrulama
const isValid = await builder.validateToken(tokenData, {
  referenceService: 'https://stampchain.io/api/v1/validate'
});

// Stampchain'den mevcut ağ durumunu alma
const networkState = await builder.getNetworkState({
  source: 'stampchain' // Temel altyapı verilerini kullanma
});

Stampchain Entegrasyonlu Sanatçı İş Akışı

Basit Stamp Oluşturma

javascript
// Temel altyapıyı kullanarak ilk Bitcoin Stamp'ınızı oluşturma
const stamp = await builder.buildStampTransaction(utxos, {
  stampData: {
    imageData: yourArtworkBuffer, // PNG/JPEG dosyanız
    filename: 'my-art.png'
  },
  fromAddress: 'your-bitcoin-address',
  feeRate: 15,
  // Stampchain'in sanatçı dostu doğrulamasını kullanma
  artistMode: true
});

Stampchain ile Galeri Entegrasyonu

javascript
// Sanat eserinizi Stampchain'in galeri özelliklerine bağlama
const stampResult = await builder.buildStampTransaction(utxos, {
  stampData: artwork,
  fromAddress: artistAddress,
  metadata: {
    gallery: 'stampchain', // Temel platformda kayıt
    artist: 'your-artist-name',
    collection: 'your-collection-name'
  }
});

// Stampchain'in temel API'si aracılığıyla sanat eserinizi sorgulama
const myArtwork = await fetch(`https://stampchain.io/api/v1/artist/${artistAddress}/stamps`);

Görüntü Optimizasyonu

javascript
// Stampchain'in önerileri doğrultusunda blockchain depolaması için optimize etme
const optimized = await sharp(originalImage)
  .resize(800, 800, { fit: 'inside' })
  .png({ quality: 90 })
  .toBuffer();

// Stampchain'in referans standartlarına göre boyutu doğrulama
if (optimized.length > 100000) {
  console.log('Optimal Stampchain entegrasyonu için görüntü boyutunu daha da küçültün');
}

Sanat Koleksiyonları

javascript
// Stampchain entegrasyonuyla birden fazla sanat eseri toplu oluşturma
for (const artwork of artCollection) {
  const stamp = await builder.buildStampTransaction(utxos, {
    stampData: artwork,
    fromAddress: artistAddress,
    feeRate: 15,
    // Her eseri temel altyapıya kaydetme
    registerWith: 'stampchain'
  });

  // Stamp'lar arasında bekleme (Stampchain altyapısına saygılı)
  await new Promise(resolve => setTimeout(resolve, 5000));
}

Temel Özellikler

Stampchain Standartlarıyla UTXO Koruması

typescript
// Stampchain'in referans koruma kalıplarını kullanarak değerli varlıkları koruma
const protectedSelector = selectorFactory.createSelector('protection-aware', {
  protectionConfig: {
    enableStampsDetection: true,      // Bitcoin Stamps'leri koruma
    enableCounterpartyDetection: true, // KEVIN token'larını koruma
    minimumProtectedValue: 10000,     // 10k sat üzeri UTXO'ları koruma
    // Stampchain'in varlık tanıma sistemini kullanma
    assetDatabase: 'https://stampchain.io/api/v1/assets'
  }
});

Stampchain Verileriyle Ücret Yönetimi

typescript
// Stampchain dahil birden fazla kaynaktan mevcut ücret oranlarını alma
const feeRates = await builder.getRecommendedFeeRates({
  sources: ['mempool', 'stampchain'], // Temel altyapıyı dahil etme
  preferStampchain: true // Stampchain önerilerini önceliklendirme
});

// Referans uygulama verilerini kullanarak oluşturma öncesi maliyet tahmini
const estimate = await builder.estimateStampCost({
  imageSize: imageBuffer.length,
  feeRate: feeRates.standard,
  // Stampchain maliyet modellemesini kullanma
  costModel: 'stampchain-reference'
});

Stampchain Testnet Desteğiyle Test

typescript
// Her zaman önce Stampchain'in testnet altyapısını kullanarak test edin
const testBuilder = new BitcoinStampBuilder('testnet', selectorFactory, {
  apiEndpoint: 'https://testnet.stampchain.io/api/v1'
});

const testStamp = await testBuilder.buildStampTransaction(testUtxos, {
  stampData: { imageData: testImage, filename: 'test.png' },
  fromAddress: 'tb1q...'
});

Stampchain Entegrasyonu İçin En İyi Uygulamalar

  1. Referans Uygulamayı Kullanın: Her zaman Stampchain'in temel standartlarına göre doğrulayın
  2. Önce Test Edin: Mainnet'ten önce Stampchain'in testnet altyapısını kullanın
  3. Görüntüleri Optimize Edin: Stampchain'in boyut önerilerini takip edin (<100 KB)
  4. UTXO'ları Koruyun: Stampchain'in tespitini kullanarak varlık korumasını etkinleştirin
  5. Ücretleri Takip Edin: Stampchain'in ücret önerilerini diğer kaynaklarla birlikte kullanın
  6. Adil Dağıtım: Token'lar için KEVIN'in örneğini ve Stampchain'in topluluk standartlarını takip edin
  7. Topluluk Önce: Stampchain'in topluluk özellikleri ve API'leriyle entegre olun

Neden Stampchain Entegrasyonu Kullanmalısınız

Bitcoin Stamps kurucuları tarafından oluşturulan temel altyapı olarak:

  • Özgün Standartlar: Protokol yaratıcıları tarafından geliştirilmiştir
  • Referans Uygulama: Bitcoin Stamps işlevselliği için altın standart
  • Kanıtlanmış Güvenilirlik: Lansmanından bu yana çoğu Bitcoin Stamps uygulamasını destekler
  • Topluluk Önce: Ücretsiz erişim, kâr yerine ekosistem büyümesini destekler
  • Sürekli Güncellemeler: Orijinal protokol yaratıcıları tarafından sürdürülmektedir
  • Kültürel Uyum: Uygulamalarınızın gerçek Bitcoin Stamps değerlerini takip etmesini sağlar

Kaynaklar

Sonraki Adımlar

  1. İlk Stamp'ınızı Yaratın → - Stampchain entegrasyonuyla başlayın
  2. API Entegrasyonu → - Stampchain API'lerine derinlemesine bakış
  3. Topluluk Değerleri → - Temel ilkeleri anlayın

"In Lak'ech Ala K'in" - Gerçek topluluk değerlerini onurlandıran temel altyapı üzerine inşa edilmiş, kolektif yaratıcılığa hizmet eden araçlar.

@btc-stamps/tx-builder SDK, Stampchain'in temel altyapısına rehberlik eden topluluk önce ilkelerini yansıtarak uygulamalarınızın orijinal Bitcoin Stamps vizyonuna sadık kalmasını sağlar.

Bitcoin üzerinde dijital kültürü koruyan topluluk sahipli açık kaynak projesi