Examples

This section provides practical examples for common use cases with Regent SDK.

Available Examples

Core Agent

Complete example of building an agent with entrypoints, streaming, and validation:

• Agent creation and configuration

• Entrypoint definitions with Zod schemas

• Streaming handlers

• HTTP server setup

ERC-8004 Identity

Register agents on-chain with reputation:

• SDK initialization

• Agent registration (IPFS/HTTP)

• Feedback and reputation

• Multi-chain discovery

Agent-to-Agent Communication

Inter-agent communication patterns:

• Fetching agent cards

• Direct invocation

• Task-based messaging

• Multi-turn conversations

Payment Policies

Configure payment limits and restrictions:

• Outgoing and incoming limits

• Recipient/sender whitelists

• Rate limiting

• Policy groups

Wallet Integration

Wallet connector examples:

• Local EOA wallets

• Thirdweb Engine wallets

• Server-orchestrated wallets

• Challenge signing

TEE Deployment

Deploy sovereign agents to Trusted Execution Environments:

• TEE configuration and deployment

• Deterministic wallet derivation

• On-chain token and treasury setup

• Attestation verification

• Monitoring and upgrades

Quick Examples

Minimal Agent

import { createAgent } from '@regent/core';
import { http } from '@regent/http';
import { createAgentApp } from '@regent/hono';
import { z } from 'zod';

const agent = await createAgent({
  name: 'minimal-agent',
  version: '1.0.0',
})
  .use(http())
  .addEntrypoint({
    key: 'echo',
    input: z.object({ text: z.string() }),
    handler: async ({ input }) => ({
      output: { echoed: input.text },
    }),
  })
  .build();

const { app } = await createAgentApp(agent);

Bun.serve({ fetch: app.fetch, port: 3000 });

Agent with Payments

import { createAgent } from '@regent/core';
import { http } from '@regent/http';
import { payments, paymentsFromEnv } from '@regent/x402';
import { createAgentApp } from '@regent/hono';

const agent = await createAgent({
  name: 'paid-agent',
  version: '1.0.0',
})
  .use(http())
  .use(payments({ config: paymentsFromEnv() }))
  .addEntrypoint({
    key: 'premium',
    price: '0.10',
    handler: async ({ input }) => ({
      output: { result: 'premium content' },
    }),
  })
  .build();

const { app } = await createAgentApp(agent);

Agent with Identity

import { createRegentAgent } from 'regent-sdk';

const agent = await createRegentAgent({
  name: 'verified-agent',
  description: 'Agent with on-chain identity',
  version: '1.0.0',
  identity: {
    chainId: 84532,
    rpcUrl: 'https://sepolia.base.org',
    ipfs: 'pinata',
    ipfsConfig: { pinataJwt: process.env.PINATA_JWT },
  },
  trust: { reputation: true },
});

const { agentId } = await agent.registerOnchain();
console.log('Registered:', agentId);

Environment Setup

Most examples require environment variables:

# Wallet
AGENT_WALLET_PRIVATE_KEY=0x...

# Payments
PAYMENTS_RECEIVABLE_ADDRESS=0x...
FACILITATOR_URL=https://facilitator.example.com
NETWORK=base-sepolia

# Identity (for ERC-8004)
PINATA_JWT=your-jwt-token

# LLM (for AI examples)
OPENAI_API_KEY=sk-...