Bluesky Protocol Services
Bluesky Protocol Services (atproto.com)
要約
Blueskyは、ATプロトコルネットワーク上で運営するパブリックインフラストラクチャのための新ブランド「Bluesky Protocol Services」と新ウェブサイトを発表しました。Jetstream v2では、過去の任意の時点からライブストリームにギャップなく追いつける「Network Replay」機能が追加され、開発者はより効率的にネットワークデータを利用できるようになります。また、Jetstreamの利用を簡素化するTypeScriptおよびGoのSDKもリリースされました。
全文翻訳
Introducing Bluesky Protocol Services
本日、私たちはBluesky Protocol Servicesをローンチします。これは、BlueskyがATプロトコルネットワーク上で運用するパブリックインフラストラクチャのための新しいブランドとウェブサイトです。
Blueskyは常にBlueskyアプリ以上のものを運用してきました。私たちはATプロトコル上に構築されたJetstreamインスタンス、リレー、およびBluesky APIエンドポイントを運用しています。しかし、もしあなたがそのインフラストラクチャ上で開発しようとしている開発者だった場合、私たちのドキュメントでは、私たちがサービスとして何を運用しているのか、どこから始めれば良いのかを常に明確に示すことができていませんでした。本日、私たちはそれを修正します。Bluesky Protocol Servicesは、エコシステム内の開発者が必要とするすべてのドキュメントを整理し、Bluesky提供のインフラストラクチャに関するサービス契約を明確にし、古いdocs.bsky.appサイトを置き換え、この記事で紹介するような将来のリリースをきれいに配信するための方法を提供します!
Jetstream v2: Network Replay
新しいサイトと同時にリリースされる主要な機能はJetstream v2です。Jetstreamは、ほとんどの開発者にとってネットワークを大規模に使用するための最良の方法です。あなたが望むスライスを記述すると、それはWebSocket経由でプレーンなJSONとして配信されます。しかし、これまでは履歴を提供できませんでした。ネットワークに既に存在するレコードが必要な場合、リポジトリを自分でバックフィルしてからライブストリームに切り替える必要がありました。
Jetstream v2は、サーバーにその機能を追加します。ネットワーク全体の圧縮アーカイブを保持し、ライブテールに加えて、それを消費するための新しい方法を追加します。
Network Replayを使用すると、過去の任意の時点からキャッチアップし、ギャップなしでライブに切り替えることができます。planSnapshotにフィルタをPOSTし、返された密封されたセグメントをプレーンHTTP経由でダウンロードしてから、先端でライブWebSocketに接続します。Replayはサーバー上でステートレスであり、コンシューマーごとのカーソル、登録するサブスクリプション、クライアントでのステージングは何もありません。Jetstreamがあなたのバッファになります。ネットワークを単にスナップショットすることもできます。これはHTTPのみのアーカイブの時点コピーです(listSegments + getSegment)、ライブテールはありません。同じアーカイブ、同じフィルタ、WebSocketなしです。
これにより、ローカルでのバックフィルを一切行わずに、より洗練されたサーバーサイドのスライスが可能になります。あなたはAppを起動し、1ヶ月分の投稿を分析したり、ダウンタイムから復旧したりできます。これらはすべて、ライブテールと同じJSON形式で行えます。
これらのアーカイブの提供は帯域幅を大量に消費します。サービスが信頼性が高く、実行コストが安価であることを保証するために、これらのリクエストにはAPIトークンが必要になりました。ライブテールは認証なしでオープンなままですが、アーカイブをリクエストした場合にのみトークンが必要になります。ライブストリームに認証要件を導入する計画はありません。
v2インスタンスは現在 wss://jetstream.us-west.bsky.network および wss://jetstream.us-east.bsky.network で稼働しています。既存のv1インスタンスはしばらくの間変更なく稼働し続け、ライブテールは両方で同じように動作するため、移行を急ぐ必要はありません。完全なフローはNetwork Replay docsで確認できます。
そして! いつものように、このインフラストラクチャはオープンソースであり、セルフホスト可能です。Running your own Jetstreamを参照してください。
A Jetstream SDK
JetstreamはプレーンなJSONなので、SDKは必要ありません。しかし、再接続、重複排除、カーソル管理、イベントを型付きレコードにデコードするといった共通の処理があります。そのため、新しいJetstream SDKが登場しました。TypeScriptとGoのクライアントがあり、Jetstreamオブジェクトを構築し、フィルタを渡して、デコードされ型付けされたイベントをfor awaitで処理します。
TypeScript SDKはnpmから利用可能です。これにはnpmxも含まれます。
Go SDKはJetstreamプロジェクトの一部として利用可能です。
Jetstream SDK docsで詳細を確認できます。
The Bluesky TypeScript SDK, rebased on lex
5月に私たちはlex SDKを安定プレビューに昇格させ、スタンドアロンのBlueskyドキュメントもそれに続くことを約束しました。それが完了しました。Bluesky TypeScript SDKは@atproto/lexの上に再構築されており、Bluesky固有のヘルパーのためのレガシーコードパスのメンテナンスを終了しました。これは、プロトコルレイヤーからapp.bskyレコードまで、エンドツーエンドで完全に型付けされたレキシコンツールチェーンです。
この新しいサイトのTypeScriptの例はすべてこれに基づいて書かれており、レガシーな技術的負債からの大きな移行を示しています。これは私たちにとって良いコード衛生であり、非推奨のSDKに対するLLMの推奨を排除するはずです。もしあなたがまだ@atproto/apiコードを使用している場合、それは以前と同様に機能し、Bluesky API guidesが移行リファレンスとして機能します。
Updates to endpoints.bsky.app
最後に、HTTPリファレンスが更新されました。https://docs.bsky.appからこれらのドキュメントを分離することが、このオーバーホールの最初のステップでした。私たちは今、残りを着陸させています。
Replayを支える新しいnetwork.bsky.jetstream.*メソッド(planBackfill、listSegments、getSegment、getBlock)が、完全なリクエストとレスポンススキーマとともにブラウズ可能になりました。また、リファレンスはJetstreamのWebSocketエンドポイントも文書化しているため、Jetstream v2の全サーフェスが1か所に集約されています。
What’s next
上記すべてが本日ライブになりました。新しいサイト、v2 Jetstreamインスタンス、SDKプレビュー、および更新されたHTTPリファレンスです。もしあなたがネットワークに新規参入する場合、まずはHow It Worksから始めてください。これは、レコード、レキシコン、およびファイアホースがどのように連携するかを視覚的に解説したものです。もしあなたがBlueskyアプリのデータモデルに対して構築している場合、Bluesky API guidesはすべてそのまま残っており、新たに書き直されています(それについては以下で詳しく説明します)。
もしあなたが今後数週間でReplay上で何かを構築した場合、ぜひお聞かせください。SDKのオーケストレーションがどこへ向かうべきかを形作る最も速い方法は、あなたがストリームを何に折り込んでいるかを見せていただくことです。