NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev, #2295 most downloaded on pub.dev
A Dart library that contains the core commands that can be used with a secondary server (scan, update, lookup, llookup, plookup, etc.)
Latest stable
4.0.0
Last release 18 days ago
04 Nov 2026
Release timing varies
gaps range from 1 weeks to 6 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
2 versions withdrawn
withdrawn after publishing
6 years old
81 releases · first in 2020
Drag across the ruler to compare, or tap a release to open it.
docs: Upgrading to at_client 4.0 takes an app from at_client 3 to 4.
AtLookupImpl's constructor is internal to at_lookup; build a
lookup with AtLookUp.withSecureSocket or withTransport.package:at_lookup/at_lookup_web.dart reaches an atServer from a
browser: webSocketLookUps() finds it through the atDirectory over HTTPS
and connects over wss://; fixedAddressWebSocketLookUps(host:, port:)
connects every atSign to one atServer, for development.AtLookUp.withTransport builds a lookup over any transport.onConnect has
finished, and a connection whose onConnect fails is closed, so the next
call opens one and runs onConnect again.SecondaryConnectException, as any other failure to connect does.executeCommand throws IllegalArgumentException, and
executeVerb an AtLookUpException with code AT0022, before the lookup
finds, connects to or logs in to the atServer; AtCommandExecutor.sendSync
and AtConnection.write throw IllegalArgumentException.ConnectionInvalidException.AT0004, as other socket failures
do.authenticator takes effect on the next command that needs
authentication, which logs in again with it rather than running on the
previous authenticator's login.AtLookUp.connection is an AtConnection?.CacheableSecondaryAddressFinder, SecureSocketUtil,
SecondaryUrlFinder, SecondaryAddressCacheEntry and
AtLookupSecureSocketFactory now come from at_lookup_io.dart, not
at_lookup.dart.FixedSecondaryAddressFinder resolves every atSign to one fixed
address.AtLookupImpl requires secondaryAddressFinder and
transportFactory, and no longer takes secureSocketConfig — that now
belongs to the transport factory. AtLookUp.withSecureSocket requires
secondaryAddressFinder too. Native callers can use
secureSocketLookUps() from at_lookup_io.dart instead.AtLookupImpl.findSecondary is removed. Use a
SecondaryAddressFinder.AtLookUp.withSecureSocket, withTransport, AtLookupImpl,
secureSocketLookUps, webSocketLookUps and AtLookUpFactory take no
clientConfig; give it to at_auth's authenticatorFor, which sends it in
from:.MonitorClient is removed. It has no replacement.AtLookupTransport takes a transportFactory (an
AtTransportFactory) in place of socketFactory and secureSocketConfig;
secureSocketTransport(...) callers are unaffected.AtConnection no longer exposes a socket. getSocket() is gone —
read arriving bytes from inbound, write raw bytes with add(List<int>),
and write(String) returns a Future. A connection is built over an
AtTransport, which an AtTransportFactory opens.AtLookupImpl's secureSocketFactory is now transportFactory
and takes an AtTransportFactory; AtLookupSecureSocketListenerFactory is
now AtLookupMessageListenerFactory. Anything constructing an
OutboundConnectionImpl itself changes with it, including code reaching
src/connection/ through implementation_imports.AtLookUp's credential-ladder members (atChops, enrollmentId,
signingAlgoType, hashingAlgoType, authenticate_cram, and
executeVerb's sync param) are removed. A connection's authenticated
enrollment is connection?.getMetaData()?.authenticatedAsEnrollmentId.AtLookUp's update, lookup, plookup, llookup, delete
and scan are removed, with AtLookupMuxable.readResponse. Run a verb
builder through executeVerb instead.cramAuthenticate, authenticate(privateKey) and the
privateKey and cramSecret fields are removed. For CRAM, set
authenticator to at_auth's authenticatorForCramSecret(...) and call
pkamAuthenticate().atLookupOverSecureSocket is removed. Use
AtLookUp.withSecureSocket or secureSocketLookUps() with an
authenticator.secondaryAddressFinder setter is removed; pass the finder
when the lookup is built.pkamAuthenticate takes no enrollmentId; the authenticator
decides. authenticatedAsEnrollmentId names the enrollment the atServer
accepted, after a reconnect too.AtIOException on every transport; catch
it where you caught SocketException. executeVerb still reports it as
AT0004.authenticator and stop() are on AtLookUp itself, not only on
AtLookupMuxable.startNotifications called while another is still starting joins
it, so one monitor: goes out however many callers ask; a start after
stopNotifications begins afresh.*** in place of the passcode in
otp:put and the otp an enroll: request carries.at_chops.Your coding agent can read these notes before it upgrades. Set up the MCP server →
deprecated, for removal in 4.0: AtLookupImpl's constructor, in favour of AtLookUp.withSecureSocket; the credential members atChops, signingAlgoType, h…
AtLookUp.withSecureSocket(...) creates a lookup from an
AtRootDomain, an authenticator and an AtLookupTransport, and returns
an AtLookupMuxable. onConnect runs on each new connection before
anything else can use it, for a proxy, and a connection whose onConnect
fails is closed.AtLookupMuxable also carries the atServer's notifications, through
notifications, startNotifications and stopNotifications;
notificationConnectionUp says whether that connection is up, and
dropConnection closes it and leaves the lookup usable.AtLookupMuxable.stop() ends a lookup for good: work in flight fails
with StoppedException, and so does every later call. close() still
closes the connection, and the next call reconnects. (3.7.0-rc2 to rc4 had
close() end the lookup for good; that is stop() now.)AtLookUpFactory; the TLS default, secureSocketLookUps, is in the new
package:at_lookup/at_lookup_io.dart, which re-exports at_lookup.dart.AtAuthenticator and AtCommandExecutor let a caller supply its own
authentication.checkAtSignServer(lookUp, atSign) reports whether an atSign is
registered, whether its atServer answers and whether it is activated, with
the cause of any failure.BaseConnection.inbound and BaseConnection.add read and write a
connection's raw bytes.validatedFromChallenge is public, so an authenticator built outside
at_lookup refuses the same from: challenges.Heartbeat OK: lastReceipt <time of the last notification> at info.executeCommand throws a
ConnectionInvalidException that says so, and executeVerb an
AtLookUpException carrying it.close() authenticates its
new connection even when an authentication begun before finishes late.stream: is refused as unexpected
(AT0014).lookup(..., verifyData: true) returns the value only when its
signature verifies against the sharer's public key.executeCommand throws IllegalArgumentException, and
executeVerb an AtLookUpException with code AT0022, before connecting or
authenticating; sendSync and a connection's write throw
IllegalArgumentException.AtNetworkTimeouts.defaultTimeout (30 s unless
set) with nothing arriving, rather than 10 s; a whole reply still has 90 s.SecureSocketUtil.createSecureSocket returns at_lookup's own
SecureSocket: close() flushes and then closes both directions, and
renegotiate() throws UnsupportedError.AtLookupImpl's constructor, in favour of
AtLookUp.withSecureSocket; the credential members atChops,
signingAlgoType, hashingAlgoType and enrollmentId, and
AtLookupImpl's privateKey and cramSecret, in favour of an
AtAuthenticator; executeVerb's sync parameter, which was never read;
and AtLookupMuxable.readResponse, whose only use was the stream verb.update, lookup, plookup, llookup,
delete and scan, in favour of executeVerb with the matching verb
builder; cramAuthenticate, in favour of an AtAuthenticator;
MonitorClient, in favour of AtLookupMuxable's notifications; and
AtConnection.getSocket(), in favour of BaseConnection.inbound and
add.AtLookupImpl.authenticate,
pkamAuthenticate's enrollmentId, AtLookupImpl.socketFactory and
setting secondaryAddressFinder on a built lookup, in favour of what the
lookup is built with; and AtLookupSecureSocketListenerFactory, renamed
AtLookupMessageListenerFactory in 4.0.0.at_chops ^3.6.0 and at_commons ^5.18.0.fix: a refused CRAM authentication's exception carries the atServer's response.
feat: while notifications are on, each heartbeat the atServer answers logs Heartbeat OK: lastReceipt at info, as at_client's Monitor used to.
Heartbeat OK: lastReceipt <time of the last notification> at info, as
at_client's Monitor used to.fix: a notification arriving after an unexpected line from the atServer (an error, a banner, part of a reply) is no longer lost, so a client can no lo
ConnectionInvalidException that says so, logged once at info rather than
also twice at severe.AtLookUp.close() ends the lookup: work in flight fails with
StoppedException, its sockets close, notifications stop, and every later
call throws StoppedException. A caller that closed a lookup and kept using
it calls AtLookupMuxable.dropConnection() instead.checkAtSignServer(lookUp, atSign) reports whether an atSign is
registered, whether its atServer answers and whether it is activated, with
the cause of any failure.AtLookUpFactory, with secureSocketLookUps in at_lookup_io.dart
as the TLS default, lets an application choose how every connection a client
opens travels. AtLookUp.withSecureSocket takes onConnect, run first on
each new connection, for a proxy.AtLookupImpl.notificationReconnectDelays is settable, for tests.monitor:, log at
finer rather than info.at_commons ^5.18.0.…and a transport; AtLookupImpl's constructor is deprecated in its favour.
AtLookupMuxable, an AtLookUp that also carries the atServer's
notifications. notifications is a single-subscription stream whose pause
reaches the socket, startNotifications and stopNotifications control it,
and notificationConnectionUp says when it is up or lost. NB this lets
at_client use one connection rather than creating and authenticating
several; making that easy for SDK users to choose comes in a 4.x minor
release after the post-quantum work.AtLookUp.withSecureSocket(...) creates one from an AtRootDomain, an
authenticator and a transport; AtLookupImpl's constructor is
deprecated in its favour.AtLookupTransport says how connections are made, with
secureSocketTransport(...) in the new package:at_lookup/at_lookup_io.dart,
which re-exports at_lookup.dart. transport has no default.AtAuthenticator and AtCommandExecutor let a caller inject
authentication. The credential members atChops, signingAlgoType,
hashingAlgoType and enrollmentId, and AtLookupImpl's privateKey and
cramSecret, are deprecated, for removal in 4.0.AtLookupMuxable declares authenticator, isConnectionAvailable,
readResponse, scan(auth:, showHiddenKeys:) and lookup(metadata:), so
callers no longer cast to AtLookupImpl.AtConnectionMetaData records authenticatedAsEnrollmentId and
authenticatedAt.OutboundMessageListener gains onNotification, onDisconnect and
pauseDelivery/resumeDelivery.AtLookUp.executeVerb's sync parameter, which was never read;
removal in 4.0.at_chops ^3.6.0 and at_commons ^5.16.0.fix: strengthen the from challenge. A client now checks that a from: challenge has the shape an atServer issues — _ : , and that the atSign it names i
from:
challenge has the shape an atServer issues — _<uuid><atSign>:<uuid>, and
that the atSign it names is the one this client asked for — before signing
it. Defensive in anticipation of broader use of the APKAM keypair in future.feat: CacheableSecondaryAddressFinder takes an optional cacheDuration to override the default 1-hour cache TTL.
CacheableSecondaryAddressFinder takes an optional cacheDuration to override the default 1-hour cache TTL.at_chops constraint to ^3.3.0, the actual minimum this package compiles against.PkamSigningAlgo / SHA512HashingAlgo); crypton and crypto are no
longer imported anywhere in the package and have been dropped from
dependencies. Byte-identical by construction.SecureSocketUtil.createSecureSocket now accepts an optional
timeout (and honours SecureSocketConfig.connectTimeout), passing it to
SecureSocket.connect. SecondaryAddressFinder.findSecondary takes an
optional timeout that bounds the entire atDirectory lookup — the retry loop
and the previously-fixed 30-second response busy-wait — as a single deadline.
Both default to AtNetworkTimeouts.effectiveDefault (30s) and are capped at
60s (#1909). Requires at_commons ^5.13.0.- chore(deps): at_chops ^3.0.0
- fix: revert breaking changes
chore: clean up lint from new strict_top_level_inference rule
strict_top_level_inference rulechore(deps): remove unused deps (path)
feat: add SecureSocketConfig? config to SecondaryUrlFinder constructor
SecureSocketConfig? config to SecondaryUrlFinder constructorSecureSocketConfig.tlsKeysSavePath optionalfeat: add OutboundConnection? connection to the AtLookUp interface
OutboundConnection? connection to the AtLookUp interfacefix: update exception and log messages to use standard terminology ('atServer' instead of 'secondary server', 'atDirectory' instead of 'root server')
fix: git#865 - fixes notifying the switch atSign event multiple times by @sitaram-kalluri in #867
Full Changelog: v3.0.50...v3.0.51
Full Changelog: https://github.com/atsign-foundation/at_client_sdk/compare/v3.0.50...v3.0.51
data e.g. @foo_databuild[deps]: Upgraded the following packages:
feat: consume EnrollVerbBuilder in AtLookup.executeVerb()
fix: Fixed legacy error handling so error message isn't truncated if it contains a hyphen
fix: Modify "executeCommand" to parse the error response from server and return appropriate exception
build[deps]: Upgraded at_chops to v2.0.0
build[deps]: Upgraded the following packages:
fix: revert removing private key reference from at_lookup_impl
fix: more informative exception messages
deprecate: authenticate_cram() from AtLookupImpl. [cramAuthenticate should be used instead]
fix: check isencrypted flag in sync conflict by @murali-shris in https://github.com/atsign-foundation/at_client_sdk/pull/699
Full Changelog: https://github.com/atsign-foundation/at_client_sdk/compare/v3.0.39...v3.0.40
SecondaryUrlFinder (atServer address lookup) resilient to
transient failures to reach an atDirectoryretryDelaysMillis a public static variable
in SecondaryUrlFinder; this allows clients to control
fix: ignore notifications received offline by @kalluriramkumar in https://github.com/atsign-foundation/at_client_sdk/pull/701
Full Changelog: https://github.com/atsign-foundation/at_client_sdk/compare/v3.0.38...v3.0.39
fix: Reverted dependency on 'meta' package to ^1.7.0 as flutter_test package requires 1.7.0 by @gkc in https://github.com/atsign-foundation/at_client_
Full Changelog: https://github.com/atsign-foundation/at_client_sdk/compare/v3.0.34...v3.0.38
fix: ensure outbound sockets are cleaned up properly
feat: changes to call at_chops.sign() method which supports different signing algorithms.
fix: fallback code for backward compatibility if at_chops instance is not set
build:modify changelog for 3.0.32 by @murali-shris in https://github.com/atsign-foundation/at_client_sdk/pull/628
Full Changelog: https://github.com/atsign-foundation/at_client_sdk/compare/v3.0.32...v3.0.34
fix: Removed race condition (related to management of outbound connection state after timeouts) which could in very rare circumstances cause unnecessa
fix: do not sync statsNotificationID from client to server by @purnimavenkatasubbu in https://github.com/atsign-foundation/at_client_sdk/pull/619
Full Changelog: https://github.com/atsign-foundation/at_client_sdk/compare/v3.0.31...v3.0.32
chore:upgrading at_client_mobile dependency versions by @srieteja in https://github.com/atsign-foundation/at_client_sdk/pull/614
Full Changelog: https://github.com/atsign-foundation/at_client_sdk/compare/v3.0.30...v3.0.31
chore: New atPlatform logo by @cpswan in https://github.com/atsign-foundation/at_client_sdk/pull/583
Full Changelog: https://github.com/atsign-foundation/at_client_sdk/compare/v3.0.29...v3.0.30
feat: sync observability by @murali-shris in https://github.com/atsign-foundation/at_client_sdk/pull/572
Full Changelog: https://github.com/atsign-foundation/at_client_sdk/compare/v3.0.28...v3.0.29
createConnection() now directly uses CacheableSecondaryAddressFinder which can be passed on as optional param
Improved timeout handling logic in outbound message listener
Update at_commons version 3.0.18 to display hidden keys in scan
Full Regular Expression matching for notificationService.subscribe by @XavierChanth in https://github.com/atsign-foundation/at_client_sdk/pull/529
Full Changelog: https://github.com/atsign-foundation/at_client_sdk/compare/v3.0.24...v3.0.25
publish at client mobile by @murali-shris in https://github.com/atsign-foundation/at_client_sdk/pull/518
Update at_commons version 3.0.16 for bypass cache feature
- find secondary bug fix
Added CacheableSecondaryAddressFinder
Remove unnecessary print statement
Export secondary address cache from the package
- Updated dependencies
Added cache for secondary url lookup from root server
Rename NotifyDelete to NotifyRemove
Update at_commons version for Info and NoOp verb
Upgrade at_commons version for bug fix in notify verb syntax
Upgrade at_commons version for shared key metadata support in notify
Add encryption shared key and public key checksum of sharedWith atsign in metadata
increase outbound connection timeout
- outbound listener bug fix
Contains the souce code for: at_client: 3.0.9 at_client_mobile: 3.1.5
Contains the souce code for: at_client: 3.0.9 at_client_mobile: 3.1.5
at_lookup fix race condition when not using await with lookup requests
at_utils version change for fix formatAtSign bug for null value
at_commons and at_utils version change
One column per quarter.