Skip to content

Update dbEncryptionKey setup #445

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 7 commits into
base: main
Choose a base branch
from
Open

Update dbEncryptionKey setup #445

Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
55ec28e
Update dbEncryptionKey setup
humanagent Oct 18, 2025
3435b38
Update encryption key example
humanagent Oct 18, 2025
a6fa6d7
Update keys in agent creation
humanagent Oct 18, 2025
2439fc0
Update doc headings size
humanagent Oct 18, 2025
6dc66ff
Merge branch 'main' into humanagent/feature-20251018-122308
humanagent Oct 22, 2025
5f44f20
Merge branch 'main' into humanagent/feature-20251018-122308
humanagent Oct 22, 2025
96ecc5c
Merge branch 'main' into humanagent/feature-20251018-122308
humanagent Oct 27, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 11 additions & 8 deletions docs/pages/agents/build-agents/create-a-client.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,14 +8,19 @@ Create an XMTP agent that can use the signing capabilities provided by a signer.
import { Agent } from '@xmtp/agent-sdk';
import { createSigner, createUser } from '@xmtp/agent-sdk/user';
import { getRandomValues } from 'node:crypto';
import { fromString } from "uint8arrays/from-string";

// Replace with your own wallet key and encryption key
const walletKey = "0xprivateKey";
const encryptionKey = "encryptionKey";

// Option 1: Create a local user + signer
const user = createUser('0xprivateKey');
const signer = createSigner(user);
const user = createUser(walletKey);
const dbEncryptionKey = fromString(encryptionKey,"hex");

const agent = await Agent.create(signer, {
env: 'dev', // or 'production'
dbEncryptionKey: getRandomValues(new Uint8Array(32)), // save it for later
dbEncryptionKey: dbEncryptionKey, // save it for later
});
```

Expand All @@ -29,11 +34,11 @@ The XMTP Agent SDK allows you to use environment variables (`process.env`) for e
| ------------------------ | -------------------------------------------------------------- | --------------------------------------- |
| `XMTP_WALLET_KEY` | Private key for wallet | `XMTP_WALLET_KEY=0x1234...abcd` |
| `XMTP_ENV` | XMTP network environment (`local`, `dev`, or `production`) | `XMTP_ENV=dev` or `XMTP_ENV=production` |
| `XMTP_DB_ENCRYPTION_KEY` | Database encryption key for the local database (32 bytes, hex) | `XMTP_DB_ENCRYPTION_KEY=0xabcd...1234` |
| `XMTP_DB_ENCRYPTION_KEY` | Database encryption key for the local database (32 bytes, hex) | `XMTP_DB_ENCRYPTION_KEY=abcd...1234` |

Using the environment variables, you can setup your agent in just a few lines of code:

### Generate random keys
## Generate random keys

```tsx [Node]
import { generatePrivateKey } from 'viem';
Expand All @@ -54,7 +59,7 @@ yarn gen:keys

> Running the command will append keys to your existing .env file.

### Use environment variables
## Use environment variables

```tsx [Node]
// Load variables from .env file
Expand All @@ -66,8 +71,6 @@ const agent = await Agent.createFromEnv();

## Configuration options

### Configure an XMTP client

You can configure an XMTP client with these options passed to `Agent.create`:

```tsx [Node]
Expand Down