Web3

Web3 nedir?

Resmî tanım:

“Web3 (also called the distributed web) refers to a set of technologies for hosting content and applications on decentralized networks — where data is stored across many computers rather than on a single server.”

Ürün sayfası “Add-on feature” rozeti taşıyor ve iki geçitten oluşuyor:

“IPFS Gateway. Provides a read-only, HTTP-accessible interface to the Interplanetary File System (IPFS).”

“Ethereum Gateway. Gives you read and write access to the Ethereum network without installing any software on your computer.”

Çözdüğü problem şu: IPFS veya Ethereum içeriğine erişmek için normalde bir düğüm (node) çalıştırman ya da özel bir istemci kurman gerekir. Geçit bunu sıradan bir HTTPS isteğine indirger — üstelik kendi alan adının altında.

Durum etiketi: Hiçbir geçit beta veya GA etiketi taşımıyor. Tüm planlarda satın alınabilen ücretli bir eklenti olarak sunuluyor. Tek durum benzeri ifade Enterprise önizlemesi için: “Enterprise customers can preview this product as a non-contract service, which provides full access, free of metered usage fees, limits, and certain other restrictions.”

Nasıl çalışır?

“When you create a gateway, Cloudflare automatically creates and adds specific DNS records to your Cloudflare account. When the hostname associated with your gateway receives requests, its DNS records route these requests to a Cloudflare Workers script that communicates with the underlying network.”

Yani geçit aslında bir Worker’dır. Okumalar edge’de cache’lenir:

“If cached, the gateway returns the content immediately over HTTP, without contacting the underlying network. If not cached, the gateway fetches the content from Cloudflare’s own IPFS or Ethereum nodes, caches it for future requests.”

Yazma yalnızca Ethereum’da mümkün ve bir Cloudflare düğümünün mempool’una gider.

Oluşturulan DNS kayıtları

Plan farkları

Free, Pro ve Business birebir aynı. Tek gerçek sınır Enterprise ile arasında.

Desteklenen Ethereum ağları

Rinkeby kullanımdan kaldırıldı. Goerli, Holesky ve Hoodi hiç listelenmedi. L2 desteği yok. 31 JSON-RPC metodu destekleniyor.

Ne zaman kullanılır, ne zaman kullanılmaz

Kullanılmaz — ve gerekçesi kanıta dayalı

Bu bölümü olağandışı biçimde uzun yazıyorum, çünkü bu üründe asıl karar noktası burası.

Kanıt 1 — ürünün yarısı resmen kapatıldı.

14 Mayıs 2024 tarihli Cloudflare blog yazısından:

“On May 14th, 2024, we will begin to transition traffic that comes to Cloudflare’s public IPFS gateway to the IPFS Foundation’s gateway at ipfs.io or dweb.link.”

“All traffic using the cloudflare-ipfs.com or cf-ipfs.com hostname(s) will continue to work without interruption and be redirected to ipfs.io or dweb.link until August 14th, 2024, at which time the Cloudflare hostnames will no longer connect to IPFS.”

Kanıt 2 — canlı testler (1 Eylül 2026).

Ama “ayakta” ile “çalışıyor” aynı şey değil. https://cloudflare-eth.com/v1/mainnet üzerinde JSON-RPC testleri:

Desen çok net: sabit değer döndüren her metot çalışıyor, canlı zincir durumu isteyen her metot başarısız. Ayrıca hata sözleşmesi de tutmuyor — dokümanlar desteklenmeyen metotlar için 403 vaat ediyor, gerçekte HTTP 200 ve gövdede JSON-RPC hatası dönüyor.

Kanıt 3 — iki buçuk yılda sıfır changelog kaydı.

Cloudflare’in changelog RSS’i 26 Şubat 2024 – 31 Ağustos 2026 arasını kapsayan 1.186 kayıt taşıyor. web3|ipfs|ethereum|blockchain araması tek bir eşleşme veriyor ve o da “Web3 gateways” ifadesinin bir istisna listesinde geçtiği bir DNS sürüm notu. Changelog’un kapsadığı tüm dönemde hiçbir Web3 ürün kaydı yok.

Kanıt 4 — zamanda donmuş metin.

“Cloudflare will be deprecating support for Rinkeby on January 30, 2023.”

Bu cümle /web3/ethereum-gateway/reference/rinkeby-deprecation/ sayfasında duruyor ve sayfanın “son güncelleme” tarihi 5 Mayıs 2026. Üç buçuk yıl önce geçmiş bir tarih için gelecek zaman kullanan bir sayfa, dört ay önce güncellenmiş görünüyor ve hâlâ ürün dizininden bağlantılı.

Kanıt 5 — dokümanlar Cloudflare’in kendi öldürdüğü hostname’i öneriyor.

/web3/how-to/use-ipfs-gateway/ sayfası — son güncelleme 16 Nisan 2026 — hâlâ iki adet https://cloudflare-ipfs.com/... örneği veriyor. O hostname Ağustos 2024’te IPFS’e bağlanmayı bıraktı. Cloudflare’in kendi pazarlama sayfası da aynı ölü hostname’i kod örneğinde taşıyor.

Tam abartmamak için — karşı kanıtlar da var. Dokümanlar yayında ve indeksli, panelde abonelik akışı hâlâ çalışıyor, Web3 “Preview services” faturalama dokümanında (29 Mayıs 2026 güncellemesi) aktif bir satır ve Nisan 2026 tarihli bir DNS changelog’u “Web3 gateways”i açıkça “continue to operate normally” diye ayırıyor — yani yönlendirme altyapısı destekleniyor.

Ama “ücretli geçitler süresiz çalışmaya devam edecek” iddiası doğrulanamamıştır. Kesin olan şu: cloudflare-ipfs.com ölü, ve bunu Cloudflare’in kendi blogu ile canlı DNS söylüyor.

Yine de kullanılabilir

Mevcut bir DNSLink geçidin varsa ve çalışıyorsa, aceleyle taşınman için bir sebep yok — ama taşınma planı yapmakta fayda var.

Cloudflare zonu zaten olan ve IPFS içeriğini kendi alan adı altında sunmak isteyenler için kurulum hâlâ en kısa yoldur: bir API çağrısı, ve DNS’i Cloudflare hallediyor.

Alternatifler

Son satır dikkate değer: Cloudflare Web3 geçidi zaten bir Worker. Aynı işi kendi Worker’ınla, kendi seçtiğin RPC sağlayıcısına karşı yazabilirsin — ve o zaman sağlayıcı değiştirmek bir kod değişikliği olur, ürün terk edilmesi değil.

Somut örnekler

IPFS’te barındırılan bir siteyi kendi alan adında sunmak (DNSLink)

Ana kullanım senaryosu budur. Siteyi IPFS’e yayımlar, sonra bir alt alan adını CID’ye yönlendirirsin.

curl "https://api.cloudflare.com/client/v4/zones/{zone_id}/web3/hostnames" \
  --header "X-Auth-Email: <EPOSTA>" \
  --header "X-Auth-Key: <API_KEY>" \
  --header "Content-Type: application/json" \
  --data '{
    "name": "gateway.ornek.com.tr",
    "description": "IPFS geçidim",
    "target": "ipfs",
    "dnslink": "/ipns/onboarding.ipfs.cloudflare.com"
  }'

Cloudflare’in oluşturduğu TXT kaydı şuna benzer:

Güncelleme yayımlamak için DNSLink değerini yeni CID ile değiştirirsin — kullanıcının elindeki adres aynı kalır. Bu, IPFS’in içerik adresli yapısıyla değişmez URL ihtiyacını uzlaştırmanın standart yoludur.

Düğüm çalıştırmadan Ethereum durumu okumak

curl https://gateway.ornek.com.tr/v1/mainnet \
  -H 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","method":"eth_getBlockByNumber","params":["0x2244", true],"id":1}'

İmzalı bir işlemi yayına vermek

curl https://gateway.ornek.com.tr/v1/mainnet \
  -H 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","method":"eth_sendRawTransaction","params":["0xIMZALI_ISLEM"],"id":1}'

Yazma erişimi yalnızca Ethereum’da var — “Cloudflare’s IPFS Gateway is currently limited to read-only access.” İşlemi yerelde imzalarsın; geçit yalnızca bir düğümün mempool’una iletir ve işlem kimliğini döndürür. Özel anahtarın hiçbir zaman Cloudflare’e gitmez.

Geçidi WAF veya Zero Trust ile kilitlemek

Geçit trafiği Cloudflare üzerinden proxy’lendiği için sıradan zone kontrolleri geçerlidir. İki belgelenmiş seçenek: erişimi kısıtlamak için WAF custom rules, ve geçit halka açık değil de arka uç servisleri içinse Cloudflare Access. Enterprise’daki Universal Path geçitlerinde ayrıca bir blocklist var ve CID, /ipfs/ ile /ipns/ yollarını kabul ediyor.

CI’dan IPFS dağıtımını otomatikleştirmek

Build çıktısını bir pinning servisine sabitle, sonra CI’ın son adımında Web3 hostnames API’sine PATCH atarak geçidin DNSLink değerini güncelle. Sonuç: her deploy’da URL sabit kalır, içerik değişir.

Demo 1: Kendi alan adında IPFS DNSLink geçidi kurmak

Ön koşullar: Cloudflare’e eklenmiş bir zone. Maliyet: bu ücretli bir eklenti — ilk adımda ödeme bilgisi girmen gerekiyor.

Adım 1 — Abone ol

Panelde Web3 → Subscribe to Web3 Gateways → geçitleri seç → Proceed to Payment Details → satın almayı tamamla.

Panelde Web3 bölümü; abonelik istemi ve fiyat bilgisinin gösterildiği ekran — fiyat rakamı resmî dokümanlarda yayımlanmadığı için burada kaydedilmesi ayrıca değerli

Bu ekran görüntüsü bu sayfa için özellikle kıymetli: Cloudflare fiyatı hiçbir dokümanda yayımlamıyor. Panelde gördüğün rakam, bu bilginin tek erişilebilir kaynağı.

Adım 2 — Geçidi oluştur

curl "https://api.cloudflare.com/client/v4/zones/{zone_id}/web3/hostnames" \
  --header "X-Auth-Email: <EPOSTA>" \
  --header "X-Auth-Key: <API_KEY>" \
  --header "Content-Type: application/json" \
  --data '{
    "name": "ipfs.ornek.com.tr",
    "description": "Demo IPFS gecidi",
    "target": "ipfs",
    "dnslink": "/ipns/onboarding.ipfs.cloudflare.com"
  }'

curl çıktısı; oluşturulan geçidin kimliği, adı, hedefi ve DNSLink değeri

Adım 3 — Oluşturulan DNS kayıtlarını doğrula

dig +short CNAME ipfs.ornek.com.tr
dig +short TXT _dnslink.ipfs.ornek.com.tr

dig çıktıları; ipfs.cloudflare.com'a işaret eden CNAME ve dnslink= değerini taşıyan TXT kaydı

DNS → Records ekranı; Cloudflare tarafından oluşturulmuş, düzenlenemeyen CNAME ve TXT kayıtları

Adım 4 — İçeriği çek ve cache davranışını ölç

curl -sI https://ipfs.ornek.com.tr/ | grep -iE 'cf-cache-status|cache-control|content-type'
curl -sI https://ipfs.ornek.com.tr/ | grep -i cf-cache-status   # ikinci istek

İki curl çıktısı; ilkinde cf-cache-status MISS, ikincisinde HIT

İlk istek Cloudflare’in IPFS düğümüne gider; ikincisi edge’den döner. Resmî ifade: “If cached, the gateway returns the content immediately over HTTP, without contacting the underlying network.”

Adım 5 — İçeriği güncelle, adresi değiştirme

Yeni bir CID yayımla ve geçidin DNSLink değerini güncelle:

curl -X PATCH "https://api.cloudflare.com/client/v4/zones/{zone_id}/web3/hostnames/{gecit_id}" \
  --header "X-Auth-Email: <EPOSTA>" \
  --header "X-Auth-Key: <API_KEY>" \
  --header "Content-Type: application/json" \
  --data '{"dnslink": "/ipfs/YENI_CID"}'

PATCH çağrısının yanıtı ve aynı URL'den yeni içeriğin döndüğünü gösteren curl çıktısı

Kullanıcının elindeki adres değişmedi, içerik değişti. IPFS’in içerik adresli yapısıyla kalıcı URL ihtiyacını uzlaştırmanın yolu budur.

Adım 6 — Kullanımı panelde gör

Panelde geçidin kullanım ekranı; dahil olan 50 GB veri transferine göre tüketim

Bu demoda ölçülenler: panelde görünen fiyat · geçit oluşturma süresi · oluşturulan DNS kayıtlarının içeriği · ilk ve ikinci istekte cf-cache-status · cache’li ve cache’siz yanıt süresi · DNSLink güncellemesinin yayılma süresi · tüketilen veri transferi.

Demo 2: Ürünün gerçekten çalışıp çalışmadığını doğrulamak

Bu alışılmadık bir demo ama bu ürün için en değerlisi. Amacı, bir teknolojiye bağlanmadan önce satıcının iddiası ile gerçeği bağımsız olarak karşılaştırmayı göstermek — ve bu yöntem yalnızca Web3’e değil, terk edilmiş olabileceğinden şüphelendiğin her servise uygulanabilir.

Adım 1 — Halka açık hostname’lerin yaşayıp yaşamadığını sor

for h in cloudflare-ipfs.com cf-ipfs.com web3-trial.cloudflare-eth.com cloudflare-eth.com; do
  printf '%-32s ' "$h"
  dig +short A "$h" | tr '\n' ' '
  echo
done

dig çıktıları; ilk üç hostname için boş yanıt, yalnızca cloudflare-eth.com için IP adresleri

Beklenen sonuç: cloudflare-ipfs.com, cf-ipfs.com ve — dokümanların hızlı başlangıcında geçen — web3-trial.cloudflare-eth.com için hiçbir A kaydı yok. Yalnızca cloudflare-eth.com ayakta.

Adım 2 — Ayakta olanın gerçekten çalıştığını test et

probe() {
  printf '%-24s ' "$1"
  curl -s https://cloudflare-eth.com/v1/mainnet \
    -H 'Content-Type: application/json' \
    --data "{\"jsonrpc\":\"2.0\",\"method\":\"$1\",\"params\":[],\"id\":1}"
  echo
}

probe web3_clientVersion
probe eth_chainId
probe eth_blockNumber
probe eth_gasPrice

Dört probe çıktısı; ilk ikisinde result alanı dolu, son ikisinde -32046 'Cannot fulfill request' hatası

Görülmesi gereken desen: sabit değer döndüren metotlar çalışıyor, canlı zincir durumu isteyen metotlar başarısız. Bu, “servis ayakta” ile “servis çalışıyor” arasındaki farkı gösteren en net kanıt.

Adım 3 — Hata sözleşmesinin tutmadığını göster

curl -s -o /dev/null -w 'http=%{http_code}\n' https://cloudflare-eth.com/v1/mainnet \
  -H 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'

curl çıktısı; http=200 gösterirken gövdede JSON-RPC hatası olduğu

Dokümanlar desteklenmeyen metotlar için 403 vaat ediyor; gerçek HTTP 200 artı gövdede hata. İstemci kodunda durum koduna değil, gövdedeki error alanına bakman gerektiğini bu adım kanıtlıyor.

Adım 4 — Changelog’da ürünün adını ara

curl -s https://developers.cloudflare.com/changelog/rss.xml \
  | grep -icE 'web3|ipfs|ethereum|blockchain'

grep çıktısı; 1.186 kayıtlık changelog'da neredeyse hiç eşleşme olmadığı

26 Şubat 2024 – 31 Ağustos 2026 arasını kapsayan 1.186 kayıtta tek eşleşme, “Web3 gateways” ifadesinin bir istisna listesinde geçtiği bir DNS sürüm notu.

Adım 5 — Dokümanlardaki örnekleri test et

Dokümanlarda geçen her örnek hostname’i ve komutu olduğu gibi çalıştır.

cloudflare-ipfs.com ve web3-trial.cloudflare-eth.com örneklerinin başarısız olduğu curl çıktıları

Bir ürünün kendi hızlı başlangıç kılavuzunun çalışmaması, bakım durumu hakkında herhangi bir pazarlama metninden daha çok şey söyler.

Bu demoda ölçülenler: kaç resmî hostname’in DNS’te olmadığı · kaç belgeli metodun gerçekte çalıştığı · dokümanlardaki hata sözleşmesi ile gerçek davranış farkı · changelog’daki son ürün kaydının tarihi · resmî örneklerin kaçının çalıştığı.

Fiyatlandırma

Cloudflare bir rakam yayımlamıyor

Bunu net söylemek gerekiyor: Web3 gateways için resmî hiçbir dolar rakamı yoktur.

• /web3/reference/pricing/ ve /web3/pricing/ → 404
• web3/llms.txt hiçbir fiyat sayfası listelemiyor
• Web3, cloudflare.com/plans/ ve cloudflare.com/plans/developer-platform/ sayfalarında hiç geçmiyor

Ürün sayfasındaki “Pricing” kartı bir doküman sayfasına değil, oturum açılmış panele gidiyor:

“Explore pricing options for Web3 Gateways in the dashboard”

Diğer üç sayfa (/web3/reference/limits/, /web3/ipfs-gateway/, /web3/ethereum-gateway/) ise seni pazarlama sayfasına yolluyor:

“For more pricing details, refer to the Web3 product page.”

O adres cloudflare.com/products/web3/’e yönleniyor ve o sayfanın metninde tek bir $ işareti yok. Geçen tek ifade genel bir cümle: “Predictable pricing without surprises.” Fiyat işaretçisi kapalı bir döngü.

Yayımlanan tek bilgi: ücretli eklenti, kullanım bazlı

“Web3 gateways are a paid add-on. To get access, subscribe to a gateway.”

“Availability” satırı Free, Pro, Business ve Enterprise için aynı: “Yes (Usage-based billing).”

Satın alma akışı: panel → Web3 → Subscribe to Web3 Gateways → geçit seçimi → Proceed to Payment Details.

Limitler

IPFS Gateway

Ethereum Gateway

Lisanslama ve hukuki çerçeve

Hizmet tescillidir ve Cloudflare Hizmet Şartları’na tabidir.

Sözleşme açısından en önemli nokta bakım durumudur. Cloudflare ücretli geçitler için bir kapatma duyurusu yapmadı, ama ürünün diğer yarısını haber vererek kapattı ve iki buçuk yıldır hiçbir güncelleme yayımlamadı. Bir müşteriye bu geçit üzerine kurulu bir hizmet satıyorsan, sözleşmene çıkış planı ve taşınma süresi yazmak makul olur.

IPFS içeriği kamuya açıktır. IPFS’e yayımlanan her şey içerik adresiyle herkesçe erişilebilirdir ve geçidi kapatmak içeriği ağdan silmez. Kişisel veri içeren bir dosyayı IPFS’e yayımlamak, KVKK kapsamında geri alınamaz bir yayımlama anlamına gelir — silme hakkını karşılaman teknik olarak mümkün olmayabilir. Bu, geçidin değil IPFS’in özelliğidir ama sonucu sana aittir.

Ethereum işlemleri kalıcı ve herkese açıktır. Zincire yazılan veri geri alınamaz. Geçit yalnızca bir iletim kanalıdır; içeriğin sorumluluğu tamamen sana aittir.

Özel anahtarların geçide gitmez. İşlemi yerelde imzalar, yalnızca imzalı işlemi gönderirsin. Bu iyi bir tasarım — ama unutma ki geçit hangi adreslerin hangi işlemleri yaptığını görür ve bu trafik loglanabilir.

Türkiye açısından ek bir not. Kripto varlık hizmetleri Türkiye’de düzenlemeye tabidir. Bir Cloudflare geçidi üzerinden Ethereum’a erişim sağlamak teknik bir altyapı tercihidir, ama üzerine kurduğun hizmetin niteliğine göre mevzuat yükümlülükleri doğabilir. Bu sayfa teknik bir referans; hukuki değerlendirme yerine geçmez.

Sık yapılan hatalar

cloudflare-ipfs.com veya cf-ipfs.com kullanmak. Bu hostname’ler Ağustos 2024’ten beri IPFS’e bağlanmıyor ve DNS A kaydı bile yok. Cloudflare’in kendi dokümanları ve pazarlama sayfası hâlâ bunları örnek olarak gösteriyor.

Dokümanların hızlı başlangıcındaki web3-trial.cloudflare-eth.com adresini kullanmak. Çözümlenmiyor. Kendi geçit adresini kullan.

Desteklenmeyen metotta 403 beklemek. Gerçekte HTTP 200 ve gövdede JSON-RPC hatası dönüyor. İstemcinde error alanını kontrol et.

Halka açık Ethereum geçidini üretimde kullanmak. Canlı zincir durumu isteyen metotlar -32046 "Cannot fulfill request" döndürüyor.

Universal Path gateway’in her planda olduğunu sanmak. Yalnızca Enterprise. Universal Path sayfası bunu net söylemiyor ama limit tablosu söylüyor.

Mevcut DNS kayıtları olan bir hostname’de geçit oluşturmak. Kayıtların üzerine yazılır.

Geçit ayarlarını sonradan değiştirebileceğini varsaymak. Yalnızca açıklama ve IPFS’te DNSLink değeri düzenlenebilir; gerisi için silip yeniden oluşturman gerekiyor.

L2 ağı beklemek. Arbitrum, Optimism, Base, Polygon — hiçbiri desteklenmedi. Yalnızca Mainnet ve Sepolia.

“Son güncelleme” tarihlerini bakım göstergesi sanmak. Nisan–Ağustos 2026 kümesi site geneli bir doküman yeniden yapılandırmasıdır; içerik dokunulmamıştır.

2022 lansman yazısındaki ücretsizlik iddiasını tekrarlamak. Ürün artık ücretli bir eklenti.

Fiyat rakamı aktarmak. Resmî bir rakam yok; panel dışında hiçbir kaynak güvenilir değil.