An offer can list a private entry beside its public ones. --private pays that entry instead, in USDC, from a card this command creates on your machine.
With --fund-from-account, your own Starknet account creates and funds the card in one transaction. It must be deployed and must hold USDC and STRK of that network. On Starknet mainnet this is the only way: add --fund-from-account.
You need Node.js 24.7 or later, and a node of the offer's network that you name with --rpc or STARKNET_RPC_URL (https).
The first time, it takes four lines, in this order:
npx -y @vauban-pay/mcp buy <url> --private --fund-from-account --rpc <your node>
npx -y @vauban-pay/mcp buy <url> --private --fund-from-account --rpc <your node> --consent <token>
npx -y @vauban-pay/mcp buy <url> --private --fund-from-account --rpc <your node> --consent <token> --accept-notice
npx -y @vauban-pay/mcp buy <url> --private --fund-from-account --rpc <your node> --consent <token> --accept-notice --recovery-file-saved <code>
- Reads the offer and prints the price, what the card takes from your account, and a consent token, the
<token> of the next lines. Nothing is sent. - Prints the notice of the service that prepares the payment, and stops. Nothing is sent.
- Accepts that notice, makes the card's keys, writes its recovery file, prints its path and a code, and stops. Nothing is sent.
- Once you have kept that file: creates and funds the card from your account, then pays.
With --fund-from-account, the first line also prints what the first payment takes from your account (the deposit, the STRK reserve, the bound on the fee of the creating transaction, and the most STRK in all), and its consent token carries those caps.
The offers that list this entry, for <url>:
- Monthly BTC signal:
https://pay.vauban.tech/x402-mainnet/v1/observations/monthly-v1 - A demo call:
https://pay.vauban.tech/x402-mainnet/v1/quote
Setup in the package README.