swapper-integration

Skill do integracji agregatorów DEX, swapperów i protokołów bridge (Bebop, Portals, Jupiter, 0x, 1inch i inne) w ShapeShift Web. Prowadzi Cię przez pełny proces: badanie API, implementację zgodnie z ustalonymi wzorcami, testy i dokumentację. Aktywuje się, gdy chcesz dodać nowego swappera lub rozszerzyć obsługę nowego protokołu wymiany.

1. Uruchom skill, gdy potrzebujesz zintegrować nowego swappera lub agregator DEX. Skill automatycznie aktywuje się na polecenia takie jak "Integruj [NazwaSwappera]" lub "Dodaj obsługę [Protokołu]".

2. Skill przeprowadzi Cię przez fazę badań — przeszuka dokumentację oficjalną swappera, API endpoints, wymagania dotyczące łańcuchów blockchain (EVM, UTXO, Solana, Sui, Tron) i model transakcji (bezpośredni, deposit-to-address, gasless).

3. Przejdź do implementacji: skill poprowadzi Cię do katalogu packages/swapper/src/swappers/ i pomoże zaimplementować interfejsy Swapper (wykonanie) i SwapperApi (cytaty, kursy, status) zgodnie z ustalonymi wzorcami z 13+ istniejących integracji.

4. Uruchom testy za pomocą dostępnych poleceń Bash (yarn test:, yarn lint:, yarn type-check, yarn build:*) — skill wspiera wykonywanie testów i sprawdzanie typów TypeScript.

5. Dodaj feature flag do stopniowego wdrożenia nowego swappera, a następnie utwórz pull request za pomocą dostępnych narzędzi GitHub (gh pr:*).

6. Skill może zadawać pytania, aby wyjaśnić szczegóły integracji — odpowiadaj na nich, aby dostosować proces do specyfiki Twojego swappera.