fluxa-x402-payment

A FluxA Agent Wallet skill that enables agents to request budgets, sign x402 payments, and call paid endpoints autonomously. It walks through the full flow—from mandate creation to X-PAYMENT execution—so agents can perform paid actions without human intervention.

1. Zainstaluj skill w swoim projekcie FluxA i upewnij się, że masz dostęp do skryptów fluxa-cli.bundle.js.

2. Oszacuj całkowity budżet dla zadania, które wymaga płatności. Zalecane jest zaplanowanie kwoty na poziomie 1,5× przewidywanego kosztu, aby mieć margines bezpieczeństwa. Przed wykonaniem poinformuj użytkownika o kwocie, którą chcesz zażądać, i wyjaśnij, że rzeczywisty koszt może być niższy.

3. Utwórz mandat budżetowy za pomocą komendy mandate-create, podając opis zadania i kwotę w USDC (w najmniejszych jednostkach, czyli z 6 miejscami dziesiętnymi — przykład: 1000000 to 1 USDC). Zapamiętaj identyfikator mandatu, który otrzymasz w odpowiedzi.

4. Poczekaj około 10 sekund, a następnie sprawdź status mandatu komendą mandate-status, podając jego ID. Upewnij się, że mandat został zatwierdzony przed przejściem do następnego kroku.

5. Wygeneruj podpis płatności za pomocą komendy x402-v3, przekazując ID mandatu i payload JSON z parametrami płatności. Z odpowiedzi wyodrębnij pole data.xPaymentB64 — to jest Twój mandat płatności.

6. Wyślij żądanie do płatnego endpointu, dodając mandat płatności do nagłówka HTTP X-PAYMENT. Agent może teraz wykonać płatną akcję autonomicznie, bez dodatkowego zatwierdzenia.