Wallet

Examples of using different wallet connectors.

Local EOA Wallet

Use a private key for signing:

import { createAgent } from '@regent/core';
import { http } from '@regent/http';
import { wallets } from '@regent/wallet';

const agent = await createAgent({
  name: 'wallet-agent',
  version: '1.0.0',
})
  .use(http())
  .use(wallets({
    config: {
      agent: {
        type: 'local',
        privateKey: process.env.AGENT_WALLET_PRIVATE_KEY!,
      },
      developer: {
        type: 'local',
        privateKey: process.env.DEVELOPER_WALLET_PRIVATE_KEY!,
      },
    },
  }))
  .build();

// Access wallets
const agentAddress = await agent.wallets.agent?.connector.getAddress();
console.log('Agent wallet:', agentAddress);

From Environment Variables

import { wallets, walletsFromEnv } from '@regent/wallet';

const agent = await createAgent({
  name: 'env-wallet-agent',
  version: '1.0.0',
})
  .use(http())
  .use(wallets({ config: walletsFromEnv() }))
  .build();

Environment variables:

AGENT_WALLET_TYPE=local
AGENT_WALLET_PRIVATE_KEY=0x...
AGENT_WALLET_CHAIN=base-sepolia
AGENT_WALLET_CHAIN_ID=84532

DEVELOPER_WALLET_PRIVATE_KEY=0x...

Thirdweb Engine Wallet

Use thirdweb Engine for managed wallets:

import { ThirdwebWalletConnector } from '@regent/wallet';

const connector = new ThirdwebWalletConnector({
  secretKey: process.env.THIRDWEB_SECRET_KEY!,
  walletLabel: 'agent-wallet',
  chainId: 84532,  // Base Sepolia
});

const address = await connector.getAddress();
console.log('Thirdweb wallet:', address);

Environment config:

AGENT_WALLET_TYPE=thirdweb
AGENT_WALLET_SECRET_KEY=...
AGENT_WALLET_CLIENT_ID=...
AGENT_WALLET_LABEL=agent-wallet
AGENT_WALLET_CHAIN_ID=84532

Server-Orchestrated Wallet (Regent)

Use a server-orchestrated wallet:

import { ServerOrchestratorWalletConnector } from '@regent/wallet';

const connector = new ServerOrchestratorWalletConnector({
  baseUrl: 'https://api.regent.example.com',
  agentRef: 'my-agent-id',
});

// Set access token before use
connector.setAccessToken('bearer-token');

const address = await connector.getAddress();
console.log('Regent wallet:', address);

Environment config:

AGENT_WALLET_TYPE=regent
AGENT_WALLET_BASE_URL=https://api.regent.example.com
AGENT_WALLET_AGENT_REF=my-agent-id
AGENT_WALLET_ACCESS_TOKEN=...

Challenge Signing

Sign authentication challenges:

const connector = agent.wallets.agent?.connector;

const challenge = {
  id: 'challenge-123',
  nonce: 'random-nonce',
  payload: { message: 'Sign this message' },
  issued_at: new Date(),
  expires_at: new Date(Date.now() + 60000),
};

const signature = await connector.signChallenge(challenge);
console.log('Signature:', signature);

EIP-712 Typed Data Signing

const challenge = {
  id: 'typed-challenge',
  nonce: 'abc',
  payload: {
    typedData: {
      primaryType: 'Message',
      types: {
        EIP712Domain: [
          { name: 'name', type: 'string' },
          { name: 'version', type: 'string' },
        ],
        Message: [{ name: 'content', type: 'string' }],
      },
      domain: { name: 'MyApp', version: '1' },
      message: { content: 'Hello, World!' },
    },
  },
  issued_at: new Date(),
  expires_at: new Date(Date.now() + 60000),
};

const signature = await connector.signChallenge(challenge);

Custom Wallet Connector

Bring your own wallet:

import { createSignerConnector, type CompatibleWallet } from '@regent/wallet';

const customWallet: CompatibleWallet = {
  address: '0x1234567890123456789012345678901234567890',
  signMessage: async (message) => {
    // Your signing logic
    return '0x...signature';
  },
  signTypedData: async (data) => {
    // Your EIP-712 signing logic
    return '0x...signature';
  },
};

const signer = createSignerConnector(customWallet);

Wallet Capabilities

Check what a wallet can do:

const connector = agent.wallets.agent?.connector;

const caps = connector.getCapabilities?.();

if (caps?.signer) {
  const signer = await connector.getSigner();
  console.log('Has signer capability');
}

if (caps?.walletClient) {
  const client = await connector.getWalletClient();
  console.log('Has wallet client capability');
}

Get Wallet Metadata

const connector = agent.wallets.agent?.connector;

const metadata = await connector.getWalletMetadata();
console.log('Address:', metadata?.address);
console.log('Chain:', metadata?.chain);
console.log('Provider:', metadata?.provider);
console.log('CAIP-2:', metadata?.caip2);

With Viem

Use viem for advanced wallet operations:

import { LocalEoaWalletConnector, createPrivateKeySigner } from '@regent/wallet';

const signer = createPrivateKeySigner(process.env.PRIVATE_KEY!);

const connector = new LocalEoaWalletConnector({
  signer,
  walletClient: {
    rpcUrl: 'https://sepolia.base.org',
    chainId: 84532,
    chainName: 'Base Sepolia',
    nativeCurrency: {
      name: 'Ether',
      symbol: 'ETH',
      decimals: 18,
    },
  },
});

// Get viem WalletClient
const walletClient = await connector.getWalletClient();

Complete Example

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

async function main() {
  const agent = await createAgent({
    name: 'wallet-enabled-agent',
    version: '1.0.0',
  })
    .use(http())
    .use(wallets({ config: walletsFromEnv() }))
    .use(payments({ config: paymentsFromEnv() }))
    .build();

  const { app } = await createAgentApp(agent);

  // Log wallet info
  const agentWallet = agent.wallets?.agent;
  if (agentWallet) {
    const address = await agentWallet.connector.getAddress();
    console.log(`Agent wallet: ${address}`);
    console.log(`Wallet type: ${agentWallet.kind}`);
  }

  const devWallet = agent.wallets?.developer;
  if (devWallet) {
    const address = await devWallet.connector.getAddress();
    console.log(`Developer wallet: ${address}`);
  }

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

  console.log('Agent running on port 3000');
}

main().catch(console.error);