ATProto Client

Ruby client for the AT Protocol, with support for oauth/dpop authentication. It has been built and tested for bluesky but it should be agnostic of PDS. An omniauth strategy using this layer should appear soon.

Installation

Add this line to your application's Gemfile:

gem 'atproto_client'

Usage

# Configure the client (optional)
AtProto.configure do |config|
  config.base_url = "https://bsky.social"  # default
end

# Initialize a client
client = AtProto::Client.new(access_token, refresh_token)

# Should be able to fetch collections
client.make_api_request(
  :get,
  "#{PDS_URL}/xrpc/#{lexicon}",
  params:{ repo: "did:therepodid", collection: "app.bsky.feed.post"}
)

# Also gives a handful DPOP handler for any request (here an oauth example)
dpop_handler = AtProto::DpopHandler.new(options.dpop_private_key)
response = @dpop_handler.make_request(
  token_url,
  :post,
  headers: { "Content-Type" => "application/json", "Accept" => "application/json" },
  body: token_params
)

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/lasercats/atproto_client.

License

The gem is available as open source under the terms of the MIT License.