Configuration

Azeth uses environment variables for configuration. On testnet, only a private key is required to get started.

Essential Variables

Variable	Required	Description
`AZETH_PRIVATE_KEY`	Yes	Owner private key (0x-prefixed hex). Never commit this.
`AZETH_CHAIN`	No	`baseSepolia` (default) or `base` for mainnet.
`PIMLICO_API_KEY`	Mainnet only	Pimlico bundler API key. On testnet, the Azeth server proxies bundler requests. Free tier at dashboard.pimlico.io.

Configuration by Use Case

AI Agent (MCP)

Testnet (minimum):

AZETH_PRIVATE_KEY=0x...

Production:

AZETH_PRIVATE_KEY=0x...
PIMLICO_API_KEY=pim_...
AZETH_CHAIN=base
XMTP_ENCRYPTION_KEY=$(openssl rand -hex 32)  # For persistent messaging

SDK

const kit = await AzethKit.create({
  privateKey: '0x...',
  chain: 'baseSepolia',
});

For mainnet, set PIMLICO_API_KEY or pass bundlerUrl directly.

CLI

AZETH_PRIVATE_KEY=0x...
PIMLICO_API_KEY=pim_...  # Required for mainnet

The CLI also accepts --chain, --rpc-url, and --server-url flags.

Service Provider

AZETH_PRIVATE_KEY=0x...
PIMLICO_API_KEY=pim_...
X402_PAY_TO=0x...                              # Your payment address
X402_PRICE_FEED_PRICE=$0.05                    # Price per request

Optional Variables

Variable	Default	Description
`BASE_RPC_URL`	`https://sepolia.base.org`	Custom RPC endpoint
`AZETH_SERVER_URL`	`https://api.azeth.ai`	Azeth API server URL
`AZETH_BUNDLER_URL`	Auto from `PIMLICO_API_KEY`	Override bundler URL
`XMTP_ENCRYPTION_KEY`	None	Required for persistent XMTP messaging

Security Notes

Never commit private keys to version control. Use .env files (gitignored) or a secrets manager.
Use a hardware wallet or secure key management for production.
Don't reuse mainnet keys on testnet.
The CLI reads private keys from environment variables only — never from command-line flags.