# Getting Started
### Overview
The Trustless Work React SDK is a collection of hooks and typed entities.
It uses [Axios](https://axios-http.com/docs/intro) for HTTP requests.
{% hint style="info" %}
Write flows require an API key (`NEXT_PUBLIC_API_KEY`). Read-only calls can work without one.
{% endhint %}
### Quick links
### Setup
{% stepper %}
{% step %}
### Installation
Install the SDK.
{% tabs %}
{% tab title="npm" %}
```sh
npm install "@trustless-work/escrow"
```
{% endtab %}
{% tab title="yarn" %}
```sh
yarn add "@trustless-work/escrow"
```
{% endtab %}
{% endtabs %}
{% endstep %}
{% step %}
### Configure the provider
You’ll configure 2 things:
* `baseURL`: use `development` (testnet) or `mainNet` (mainnet).
* `apiKey`: from the BackOffice dApp.
The SDK exports `TrustlessWorkConfig`. Wrap your app with it to enable all hooks.
{% code title="src/trustless-work-provider.tsx" overflow="wrap" fullWidth="true" %}
```typescript
"use client"; // make sure this is a client component
import React from "react";
import {
// development environment = "https://dev.api.trustlesswork.com"
development,
// mainnet environment = "https://api.trustlesswork.com"
mainNet,
TrustlessWorkConfig,
} from "@trustless-work/escrow";
interface TrustlessWorkProviderProps {
children: React.ReactNode;
}
export function TrustlessWorkProvider({
children,
}: TrustlessWorkProviderProps) {
const apiKey = process.env.NEXT_PUBLIC_API_KEY || "";
return (
{children}
);
}
```
{% endcode %}
{% hint style="warning" %}
If you render this provider on the server, hooks will break. Keep it in a client component.
{% endhint %}
{% endstep %}
{% step %}
### Wrap your app
Pick the snippet that matches your setup.
{% tabs %}
{% tab title="Next.js (App Router)" %}
{% code title="app/layout.tsx" %}
```typescript
import { TrustlessWorkProvider } from "@/trustless-work-provider";
export default function RootLayout({ children }: { children: React.ReactNode }) {
return (
{children}
);
}
```
{% endcode %}
{% endtab %}
{% tab title="React (SPA)" %}
{% code title="src/app.tsx" %}
```typescript
import { TrustlessWorkProvider } from "./trustless-work-provider";
export function App() {
return (
);
}
```
{% endcode %}
{% endtab %}
{% endtabs %}
{% endstep %}
{% step %}
### Use hooks and entities
You can now call SDK hooks from any component under the provider.
Typical flow:
1. Call a hook to get an **unsigned XDR**.
2. Sign the XDR with the correct role wallet.
3. Submit it with `useSendTransaction`.
Read: [useSendTransaction](https://docs.trustlesswork.com/trustless-work/escrow-react-sdk/usesendtransaction).
{% endstep %}
{% endstepper %}
{% hint style="success" %}
This SDK supports **single-release** and **multi-release** escrows. Use the correct hook + payload type for each flow.
{% endhint %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.trustlesswork.com/trustless-work/escrow-react-sdk/getting-started.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.