Skip to main content

Change log

Review the latest changes to the Salt SDK. Install the latest version from npm with npm install salt-sdk.

SDK Version 0.0.45​

  • Added Denied Message Proposers policy that can limit proposers from signing messages with Salt accounts. Salt payment authorisations are the only exception. It is applied automatically to all proposers on newly created accounts
  • Added a way to query for signed messages. Use salt.getMessages() and salt.getMessageById() to get the messages you've signed
  • Deprecated: agent collaborator role is now delegate. For this release, the name agent still works but is deprecated, so please switch to delegate
  • The unused notes field has been removed from salt.submitTx() params
  • Improved error handling and new error types for clearer and more consistent error messages

SDK Version 0.0.44​

  • Changing a policy now requires signing an authentication message
  • Added an invitation listener
  • Added payer parameter to createAccount() and submitTx(): The payer can be different from the signer, and paying from Salt accounts is supported
  • Added getAccountFeePayments and getOrganisationFeePayments() as a way to fetch information about fees paid
  • Terminology change in SDK: the term human signer has been changed to proposer

SDK Version 0.0.43​

🚨 Breaking Changes​

  • RoboHost.provisioned has been removed as it was a duplicate of RoboHost.signers.length

Improvements​

  • Robo Guardian Setup process observability improvement: Organisation owners can subscribe to Robo Guardian setup updates via WebSockets as well as a readiness signal (see salt.createRoboHost() docs for an example)
  • AWS: A single AWS account can now host multiple Robo Guardian stacks
  • Audit: Salt now records the SDK version used by all authenticated users

SDK Version 0.0.42​

🚨 This release includes a breaking change, and anything using Salt SDK 0.0.41 will need to be upgraded to version 0.0.42.

  • You can now customise the SIWE message, using the parameter siweStatement in the SALT({...,siweStatement}) constructor
  • Better error handling: Added a HostCeremonyError (a mirror of the existing JoinCeremonyError)
  • Additional checks and logic to mitigate against payload tampering in transaction ceremonies
  • Additional checks and logic for ceremony joiners
  • Improvements to updating collaborators’ statuses

SDK Version 0.0.41​

Updates the bundled MPC signing library.

SDK Version 0.0.40​

The first production release.

  • Each network is now backed by a freshly deployed shard registry that the SDK targets automatically, and signing has been hardened against a failure that could occur when a signer key was reused across a very large number of key generations.
  • Chain handling is simplified: the SDK no longer validates the wallet's connected chain, so the WrongChain error is no longer thrown (the class is retained as a deprecated no-op for backwards compatibility β€” pass the intended chain in your call parameters instead).
  • A PreconfiguredEnvironment type ('MAINNET' | 'TESTNET' | 'STAGING') is now exported.

SDK Version 0.0.39​

  • Adds detailed ceremony-timeout reporting.
  • A new CeremonyTimeoutError tells you which phase timed out (waiting at the party barrier or during a protocol round), how long it waited, how many parties or messages it expected versus received, and which peers were still missing.

SDK Version 0.0.38​

Invitations now include information about who sent them and which organisation they belong to (invitedBy and organisation).

SDK Version 0.0.37​

Renames "members" to "collaborators" across the organisation APIs to match Salt's terminology, and adds a CeremonyJoinError that reports why the relay refused a ceremony join, for example the session was not found, a party was already connected, or the session was already in progress.

🚨 Breaking Changes​

  • inviteMember has been renamed to inviteCollaborator
  • Member, MemberAccessLevel and MemberStatus are now Collaborator, CollaboratorAccessLevel and CollaboratorStatus

SDK Version 0.0.36​

This version introduces some missed types which was causing misleading errors on the event emitters. It also adds a new function and a new supported chain.

SDK Version 0.0.35​

This version changes the way that Robo Guardian containers are registered. Now instead of an API key, you will be given a One time Password to verify after the robos start up. Also due to updates in the underlying libraries, the signing ceremonies should all be more resilient and less sensitive to latency.

SDK Version 0.0.34​

v0.0.34 is a significant change from v0.0.18. A lot of the SDK has been rewritten, but should still feel familiar. Any code that touches the SDK is likely to require changes to migrate to this version.

🚨 Breaking Changes​

  • Accounts created with v0.0.18 or older no longer work
  • The underlying MPC process has been heavily changed - previous code written for v0.0.18 is likely not to work with v0.0.30
  • submitTx arguments have changed
  • ethers is no longer supported - this version uses viem
  • Authentication now uses shorter tokens with refresh tokens

New Features​

  • Expanded organisation management - invite/update/remove members, decline invitations
  • Expanded account management
  • Expanded policy management - list/delete policies for accounts
  • Robo Guardian container setup functions can now be done using the SDK