fidence-cli
v0.3.4
Published
CLI for Fidence Pay — connect AI agents, poll link approval, and create payment intents.
Maintainers
Readme
fidence-cli
Command-line tool for Fidence Pay — connect AI agents to a Kernel smart account with on-chain session keys.
Requires fidence-cli >= 0.3.0. Older versions expect spendingWallets and will not work.
Install
npm install -g [email protected]Or run without installing:
npx [email protected] setup --platform claude --name "My Agent"Quick start
Install the fidence-pay skill:
npx skills add https://github.com/mrin-ai/fidence-skills --skill fidence-pay --global --yesPoint at your Fidence instance (default is local dev):
export FIDENCE_BASE_URL=https://pay.fidence.xyzConnect an agent:
fidence setup --platform claude --name "My Agent"Approve in the browser (connect your owner wallet, fund the smart account with ETH + USDC/USDT, enable the session key).
Poll for the scoped API key and session:
fidence setup poll
Commands
| Command | Description |
|---------|-------------|
| fidence setup | Create an agent link session |
| fidence setup poll | Wait for portal approval; saves fid_agent_ key + session keys |
| fidence status | Show saved config |
| fidence preflight | Dry-run compliance check |
| fidence pay | Create a payment intent and wait for approval |
| fidence pay --auto --to 0x… | Headless ERC-20 pay via the smart account session key |
| fidence wallet status | Show smart account addresses to fund |
Headless auto-pay (smart account)
Requires Automatic payments enabled on /pay/mandates. Supports USDC/USDT only on Ethereum, Base, and Sepolia. Solana agent auto-pay is not supported yet.
export FIDENCE_SEPOLIA_RPC_URL=https://… # recommended
fidence pay --auto --to 0x… --amount 10 --network sepolia --token usdcFund the smart account with USDC/USDT for payments and a little ETH for UserOp gas. There is no paymaster in v1.
If a session key is stolen it can spend ETH up to the gas policy cap (about 0.03 ETH), not unlimited USDC.
Pay any wallet (portal approval)
fidence preflight --type address --to 0x… --amount 1 --network sepolia --token usdt
fidence pay --to 0x… --amount 1 --network sepolia --token usdtEnvironment
| Variable | Default | Description |
|----------|---------|-------------|
| FIDENCE_BASE_URL | http://localhost:3000 | API origin |
| FIDENCE_SEPOLIA_RPC_URL | public RPC | Sepolia JSON-RPC |
| FIDENCE_RPC_URL | — | Fallback RPC for all networks |
