autoconf

Aug 15, 2025

Changes in this version

+ const AutoPlaceholder

+ const DefaultCacheSize

+ const DefaultRefreshInterval

+ const DefaultTimeout

+ const MainnetAutoConfURL

+ const RoutingV1IPNSPath

+ const RoutingV1PeersPath

+ const RoutingV1ProvidersPath

+ const SupportedAutoConfSchema

+ const SystemAminoDHT

+ const SystemIPNI

+ var FallbackBootstrapPeers = []string

+ var FallbackDNSResolvers = map[string][]string

+ func ExpandBootstrapPeers(configPeers []string, autoConf *Config, nativeSystems []string) []string

+ func ExpandDNSResolvers(configResolvers map[string]string, autoConf *Config) map[string]string

+ func ExpandDelegatedEndpoints(configEndpoints []string, autoConf *Config, nativeSystems []string, ...) []string

+ func GroupByKnownCapabilities(endpoints []string, supportsRead, supportsWrite bool) (map[string]EndpointCapabilities, error)

+ type Client struct

+ func NewClient(options ...Option) (*Client, error)

+ func (c *Client) GetCached() *Config

+ func (c *Client) GetCachedOrRefresh(ctx context.Context) *Config

+ func (c *Client) GetLatest(ctx context.Context) (*Response, error)

+ func (c *Client) HasCachedConfig() bool

+ func (c *Client) Start(ctx context.Context) (*Config, error)

+ func (c *Client) Stop()

+ type Config struct

+ AutoConfSchema int

+ AutoConfTTL int

+ AutoConfVersion int64

+ DNSResolvers map[string][]string

+ DelegatedEndpoints map[string]EndpointConfig

+ SystemRegistry map[string]SystemConfig

+ func GetMainnetFallbackConfig() *Config

+ func (c *Config) DelegatedEndpointsForRead(ignoredNativeSystems ...string) map[string]EndpointConfig

+ func (c *Config) DelegatedEndpointsForWrite(ignoredNativeSystems ...string) map[string]EndpointConfig

+ func (c *Config) GetBootstrapPeers(nativeSystems ...string) []string

+ func (c *Config) GetDNSResolvers() map[string][]string

+ func (c *Config) GetDelegatedEndpoints(ignoredNativeSystems ...string) map[string]EndpointConfig

+ func (c *Config) WithSupportedPathsOnly(supportedPaths ...string) *Config

+ type DelegatedConfig struct

+ Read []string

+ Write []string

+ type DelegatedRoutingEndpoint struct

+ BaseURL string

+ Capabilities EndpointCapabilities

+ func DetermineKnownCapabilities(endpoint string, supportsRead, supportsWrite bool) (*DelegatedRoutingEndpoint, error)

+ type EndpointCapabilities struct

+ IPNSGet bool

+ IPNSPut bool

+ Peers bool

+ Providers bool

+ func (ec *EndpointCapabilities) Merge(other EndpointCapabilities)

+ func (ec EndpointCapabilities) IsEmpty() bool

+ type EndpointConfig struct

+ Read []string

+ Systems []string

+ Write []string

+ type NativeConfig struct

+ Bootstrap []string

+ type Option func(*Client) error

+ func WithCacheDir(dir string) Option

+ func WithCacheSize(size int) Option

+ func WithFallback(fallbackFunc func() *Config) Option

+ func WithHTTPClient(client *http.Client) Option

+ func WithOnNewVersion(callback func(oldVersion, newVersion int64, configURL string)) Option

+ func WithOnRefresh(callback func(*Response)) Option

+ func WithOnRefreshError(callback func(error)) Option

+ func WithRefreshInterval(interval time.Duration) Option

+ func WithTLSInsecureSkipVerify(skip bool) Option

+ func WithTimeout(timeout time.Duration) Option

+ func WithURL(url string) Option

+ func WithUserAgent(ua string) Option

+ type Response struct

+ CacheAge time.Duration

+ Config *Config

+ FetchTime time.Time

+ Version string

+ func (r *Response) FromCache() bool

+ type SystemConfig struct

+ DelegatedConfig *DelegatedConfig

+ Description string

+ NativeConfig *NativeConfig

+ URL string