package
0.0.0-20250213232608-c453f8b35c75
Repository: https://github.com/stellar/go.git
Documentation: pkg.go.dev

# README

Clients package

Packages here provide client libraries for accessing the ecosystem of Stellar services.

  • horizonclient - programmatic client access to Horizon (use in conjunction with txnbuild)
  • stellartoml - parse Stellar.toml files from the internet
  • federation - resolve federation addresses into stellar account IDs, suitable for use within a transaction
  • horizon (DEPRECATED) - the original Horizon client, now superceded by horizonclient

See GoDoc for more details.

For developers: Adding new client packages

Ideally, each one of our client packages will have commonalities in their API to ease the cost of learning each. It's recommended that we follow a pattern similar to the net/http package's client shape:

A type, Client, is the central type of any client package, and its methods should provide the bulk of the functionality for the package. A DefaultClient var is provided for consumers that don't need client-level customization of behavior. Each method on the Client type should have a corresponding func at the package level that proxies a call through to the default client. For example, http.Get() is the equivalent of http.DefaultClient.Get().

# Packages

Package horizonclient provides client access to a Horizon server, allowing an application to post transactions and look up ledger information.
Package stellarcore is a client library for communicating with an instance of stellar-core using through the server's HTTP port.