Run a resolver

What a resolver is, what you need, and the two ways to run one.

A resolver is a small program that answers requests for quote on the cNGN corridors with signed, binding offers from inventory you hold. There is no application and no approval: anyone who can sign can register and quote.

The Panofx Node app

Point and click. Creates the wallet, writes the settings, sends the one-time approvals, registers your node, runs it, and tells you when it needs you. About ten minutes.

The command line

The same node driven by a YAML policy file, for servers and people who prefer it. About twenty minutes.

Both run the identical node. The app is the Mac menu-bar app, or panofx-node app in a browser on Linux and Windows. A node on a server with no screen is set up from a paired browser.

What you need

• A machine that stays online. Linux, macOS or Windows, or any container host. 1 vCPU and 256 MB of RAM is plenty.
• A Base Sepolia RPC URL. The public https://sepolia.base.org works. A keyed provider is steadier.
• About 0.001 Base Sepolia ETH for two one-time approvals. Your node never spends gas after that.
• Inventory in the tokens you want to sell. Testnet USDC from Circle’s faucet (choose Base Sepolia), and testnet cNGN from the Panofx team during the pilot.
• For Solana devnet, a little SOL for token-account rent, and devnet test cNGN and USDC from the Panofx team.

What your node does

Every few seconds the relay sends your node a request: a pair, a side, a size, and the taker’s address. Your node prices it from the reference band plus your spread, checks its balances, and either signs an offer or declines with a reason. If your offer is the best price, the taker’s signature and the keeper’s transaction settle it. Your tokens leave your wallet only at that moment, and only in exchange for the taker’s.

Your node never sends a transaction after the one-time approvals. It holds nothing but its own inventory. It fails closed: no offer is signed on a chain while that chain’s RPC, its clock or the signer is unhealthy.

What it costs you

Protocol fee	Paid by the taker, not by you. 5 bps of the fee token to the treasury.
Gas	Paid by the keeper, repaid by the taker. You pay gas once, for the approvals.
Your margin	Your spread_bps either side of the reference rate.

Where to next

1. Install the node

   Install has the steps for Windows, macOS, Linux and Docker.

2. Set it up

   In the app or from the command line.

3. Operate it

   Day to day, and why your node declined when it does.