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), `ethereumSepolia`, `base`, or `ethereum`.
`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.

Guardian Co-Signing

AZETH_GUARDIAN_KEY=0x...           # Guardian private key (optional)
AZETH_GUARDIAN_AUTO_SIGN=true      # Auto-sign operations (default: false)

Having AZETH_GUARDIAN_KEY does not auto-enable co-signing. You must also set AZETH_GUARDIAN_AUTO_SIGN=true for the guardian to automatically approve operations.

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
`AZETH_RPC_URL_BASE_SEPOLIA`	Public RPC	Custom RPC for Base Sepolia
`AZETH_RPC_URL_ETH_SEPOLIA`	Public RPC	Custom RPC for Ethereum Sepolia
`AZETH_RPC_URL_BASE`	Public RPC	Custom RPC for Base mainnet
`AZETH_RPC_URL_ETHEREUM`	Public RPC	Custom RPC for Ethereum mainnet
`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
`XMTP_ENV`	`production`	XMTP network: `production` or `dev`

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.