Trustless Work V2 is live in beta on Stellar Testnet
news

Trustless Work V2 is live in beta on Stellar Testnet

2026-09-22

trustless-workv2stellarescrowstablecoinsdeveloper-tools

Use this post as AI context

Copy the full article with Trustless Work docs, AI tools, Skill, MCP, and source URL included.

Trustless Work V2 is live in beta on Stellar Testnet

Trustless Work V2 is now live in beta on Stellar Testnet.

This is the first major upgrade to our escrow infrastructure since launching V1.

And it is much more than an API version change.

We rebuilt the contracts, rewrote the Core API, expanded the SDKs, and changed how roles, approvals, milestones, disputes, and escrow administration work.

The reason is simple: after seeing people build with V1, one thing became obvious.

Escrow is not one workflow.

A grant platform, marketplace, agency, procurement system, trade finance product, or autonomous agent may all need escrow, but they don't necessarily need the same trust model.

V2 gives builders more control over how that trust model works.

It is available today for developers to start testing.

V2 is beta, testnet-only, and has not yet completed an external audit. V1 remains our production infrastructure on Stellar Mainnet.

What changed?

We published a deeper technical breakdown of the V1 → V2 changes earlier this year:

Trustless Work V2: Programmable Escrows Become Configurable Payment Infrastructure

The short version is that V2 makes our escrow primitive much more configurable.

Multiple addresses per role

V1 was mostly built around one address per role.

V2 allows multiple:

  • Approvers
  • Service providers
  • Release signers
  • Dispute resolvers

That means an escrow can represent teams, committees, organizations, or multi-party workflows without forcing everything through one wallet.

Quorum approvals

Milestone approval is no longer just a boolean.

V2 lets you define how many approvals are required.

You can build flows like:

  • 1 of 3
  • 2 of 3
  • 3 of 5

This matters when one person should not have unilateral control over a payment decision.

Admin and platform are separate capabilities

V2 introduces a dedicated admin role for managing escrow configuration and milestones.

That separates configuration authority from the platform role.

This gives applications a cleaner way to decide who can configure an escrow, who approves work, who releases funds, who resolves disputes, and who receives platform fees.

Observers

V2 adds read-only observers.

An observer can be associated with an escrow without receiving authority to change its state.

Think auditors, investors, program managers, compliance teams, or other stakeholders that need visibility without control.

Better disputes

Disputes now include a human-readable reason.

That sounds small, but it matters.

A dispute should not only tell an application that something went wrong. It should preserve context about why it went wrong.

Batch operations

V2 also makes larger escrows less painful to operate.

Developers can perform batch milestone operations such as status updates and approvals, with additional batch release and dispute capabilities depending on the escrow type.

Fewer transactions. Fewer signatures. Better UX.

More flexible milestones

Escrow configuration and milestone management are now more clearly separated.

You can also initialize an escrow before every milestone has been defined and add milestones later.

That better matches how a lot of real agreements actually work.

We also rebuilt the developer stack

The contracts are only part of this release.

Core API V2

The new Core API is live at:

https://beta.api.trustlesswork.com

Trustless Work builds the transaction.

The authorized user signs it.

Stellar executes it.

We don't sign for users and we don't take custody of their funds.

V2 also introduces a cleaner indexing and read model, removing some of the manual indexing patterns developers had to handle in V1.

React SDK

Our React SDK V2 beta is available as:

@trustless-work/escrow@5.0.0-beta.1

View it on npm

JavaScript / TypeScript SDK

We are also launching a new framework-agnostic SDK:

@trustless-work/escrow-js@1.0.0-beta.1

View it on npm

This means you no longer need to build a React application to use our SDK.

You can integrate Trustless Work from Node.js, NestJS, Express, Angular, Vue, vanilla JavaScript, and other JavaScript or TypeScript environments.

That is an important step for us.

Trustless Work is infrastructure. The developer experience should reflect that.

Start building

There are a few ways to start testing V2 today.

Get an API key

Create an account in the Trustless Work BackOffice and generate an API key for your integration.

From there, you can start working directly with the V2 API or one of our SDKs.

Try the Laboratory

If you want to understand the escrow lifecycle before writing code, start with the Trustless Work Laboratory.

The Lab lets you interact with the different escrow actions and see how roles, milestones, approvals, releases, and disputes fit together.

It is one of the easiest ways to start exploring V2.

Build with the API or SDKs

Once you are ready to integrate:

Use whichever integration surface fits your stack.

Inspect what you create

Use the Viewer to inspect escrow state and explore Single Release and Multi Release contracts after you start creating them.

The idea is simple:

Get a key → try the flow → build the integration → inspect the result.

What happens to V1?

If you are already integrated with V1, nothing changes today.

V1 remains available and continues to be our current production infrastructure on Stellar Mainnet.

V2 introduces breaking changes, so we are not going to force existing integrations to migrate overnight.

We plan to begin working with existing integrations on the V1 → V2 migration by March 2027.

Until then, our focus is simple:

  • Get developers building with V2
  • Find bugs
  • Get feedback
  • Complete the security and audit work
  • Improve the SDKs and documentation
  • Validate the migration path
  • Get V2 ready for production

This is a beta. Please try to break it.

We can test the flows we expect people to build.

The real value of a public beta is finding the flows we didn't expect.

So don't feel like you need to start by building a full application.

Get an API key in the BackOffice. Open the Lab. Create an escrow. Try the roles. Approve milestones. Open a dispute. Release funds. Look at the result in the Viewer.

Then go deeper.

Build a 3-of-5 approval flow.

Use the JS SDK from a backend.

Build with Single Release and Multi Release.

Push the milestone model.

Find an edge case we missed.

If something breaks, tell us.

That is what this stage is for.

Stablecoins solved a big part of moving money globally.

But a lot of economic activity needs more than moving money from A to B.

Someone delivers.

Someone verifies.

Someone approves.

Sometimes someone disputes.

Then the money moves.

We are building the infrastructure for that layer.

V1 proved the primitive.

V2 makes it much more configurable.

And starting today, you can build with it.

Trustless Work September 2026