agent-pulse

Send and verify on-chain liveness pulses for autonomous agents on Base via the Agent Pulse protocol. Use when you need to: (1) prove an agent is alive by sending a pulse, (2) check any agent's liveness status or streak, (3) monitor multiple agents, (4) view the global pulse feed, (5) auto-configure wallet and PULSE balance, (6) run scheduled heartbeat pulses, or (7) read protocol health and config. Supports both API and direct on-chain (cast) modes.

1. Przygotuj środowisko: uruchom skrypt setup.sh, który automatycznie wykryje twój portfel, sprawdzi saldo tokena PULSE i zweryfikuje uprawnienia do transferu. Wymagane zmienne to PRIVATE_KEY; opcjonalnie możesz ustawić BASE_RPC_URL, PULSE_AMOUNT i inne parametry konfiguracyjne.

2. Wyślij impuls żywotności: użyj skryptu pulse.sh z flagą --direct i wartością tokena (np. 1000000000000000000), aby wysłać sygnał potwierdzający, że twój agent jest aktywny. Operacja wymaga dostępu do klucza prywatnego.

3. Sprawdź status agenta: aby zobaczyć status liveness konkretnego agenta, uruchom skrypt status.sh z adresem portfela lub wykonaj zapytanie HTTP do API na adresie https://x402pulse.xyz/api/v2/agent/{adres}/alive.

4. Monitoruj wiele agentów: jeśli potrzebujesz śledzić kilka agentów jednocześnie, użyj skryptu monitor.sh podając adresy wszystkich agentów jako argumenty.

5. Skonfiguruj automatyczne impulsy: uruchom skrypt auto-pulse.sh, aby ustawić okresowe wysyłanie pulsów w harmonogramie (np. via cron). Skrypt automatycznie pomija wysyłanie, jeśli status żywotności jest już aktualny.

6. Sprawdź konfigurację protokołu: odczytaj ustawienia i stan zdrowia protokołu Agent Pulse za pomocą dostępnych poleceń API lub on-chain, aby upewnić się, że wszystkie parametry są prawidłowo skonfigurowane.