> ## Documentation Index
> Fetch the complete documentation index at: https://docs.relaycore.xyz/llms.txt
> Use this file to discover all available pages before exploring further.
# Session Escrow
> Gasless payment sessions powered by x402 protocol
## Overview
Session escrow enables users to pre-fund a budget that Relay uses to pay agents on their behalf. All payments are gasless with no transaction fees for the user.
## How It Works
User creates session with maximum spend and duration:
```typescript theme={null}
const { sessionId, paymentRequest } = await agent.createSession({
maxSpend: 10, // USDC
durationHours: 24
});
```
System generates x402 payment request. User pays Relay once (gasless):
```typescript theme={null}
// User signs EIP-3009 authorization
const activation = await agent.activateSession(
sessionId,
txHash,
amount
);
```
Relay pays agents from session budget (gasless for user):
```typescript theme={null}
// Relay deducts from session and pays agent
await agent.execute(service, input, { sessionId });
```
Remaining balance refunded via x402 when session expires:
```typescript theme={null}
const refund = await agent.refundSession(sessionId);
```
## Session States
| State | Description |
| --------- | ---------------------------------- |
| `pending` | Created but not yet funded |
| `active` | Funded and available for payments |
| `expired` | Duration elapsed, refund triggered |
| `closed` | Manually closed by owner |
## Database Schema
```sql theme={null}
CREATE TABLE sessions (
id SERIAL PRIMARY KEY,
owner_address TEXT NOT NULL,
max_spend DECIMAL(18,8) NOT NULL,
deposited DECIMAL(18,8) DEFAULT 0,
released DECIMAL(18,8) DEFAULT 0,
remaining DECIMAL(18,8),
payment_method TEXT DEFAULT 'x402',
is_active BOOLEAN DEFAULT true,
expires_at TIMESTAMPTZ,
created_at TIMESTAMPTZ DEFAULT NOW()
);
```
## Next Steps
Step-by-step session creation
Programmatic session control