Hoodieswap 스킬
Robinhood Chain(체인 ID 4663)에서 비수탁 실행 준비 레이어로 Hoodieswap을 사용합니다. 자산과 경로를 발견하고, 사용자에게 중요한 조건을 보여준 후 연결된 지갑을 위해 서명되지 않은 트랜잭션을 준비합니다. 개인 키를 요청하거나 저장하거나 사용하지 않습니다.
워크플로우 선택
- 자산 조회 또는 시장 발견을 위해
GET /tokens또는GET /stocks를 호출합니다. - 거래 미리보기를 위해
POST /quote를 호출합니다. 미리보기 견적에는 지갑이 선택사항입니다. - ERC-20 입력의 경우, 사용자가 경로와 지갑을 선택한 후
POST /approval을 호출합니다. - 최종 서명되지 않은 스왑 페이로드를 얻으려면
POST /swap/prepare를 호출합니다. - 토큰 런칭의 경우
dryRun: true와 함께POST /launch/preflight를 호출합니다. 시뮬레이션과 서명되지 않은 Airlock 트랜잭션을 반환한 후 중지합니다. - 트랜잭션을 준비하기 전에 references/safety.md를 읽으십시오.
- 요청 및 응답 필드는 references/schemas.md를 읽으십시오.
- 표준 네트워크 값은 references/robinhood-chain.md를 읽으십시오.
- 서명 계정이 OnChainHoodies ERC-6551 HoodWallet인 경우 references/hoodwallet.md를 읽으십시오.
서명자 프로필 선택
eoa: 기존의 외부 소유 지갑을 위해 트랜잭션을 준비합니다.och-hoodwallet: OnChainHoodies를 통해 Hoodie 소유자와 결정론적 ERC-6551 계정을 확인하고,swapper로 HoodWallet 주소를 사용하여 견적을 받은 후 준비된 호출을 HoodWallet의 승인된 실행 메서드에 전달합니다.- 토큰 바운드 계정을 독립적인 개인 키를 가진 것으로 취급하지 마십시오. 현재 NFT 소유자 또는 명시적으로 승인된 다른 컨트롤러가 호출을 승인하고 실행해야 합니다.
- OnChainHoodies 공개 API는 신원, 소유권 및 지갑 컨텍스트를 제공합니다. 자체적으로 HoodWallet 트랜잭션을 승인하거나 서명하지 않습니다.
거래 워크플로우
- 심볼, 이름 또는 컨트랙트 주소로 요청된 자산을 확인합니다.
- 두 자산이 모두 Robinhood Chain에 있는지 확인하고 소수점 자릿수를 식별합니다. 기본 ETH는
0x0000000000000000000000000000000000000000으로 처리합니다. - 부동 소수점 연산 없이 사람의 입력을 원시 정수 금액으로 변환합니다.
node scripts/quote.mjs --token-in ... --token-out ... --amount ... --decimals ... [--swapper ...]를 실행하거나/quote를 직접 호출합니다.- 선택된 제공자, 입력, 예상 출력, 존재하는 경우 가격 영향, 존재하는 경우 풀 제약 조건 및 모든 경고를 표시합니다. 견적을 보장된 것으로 설명하지 마십시오.
- 사용자가 준비를 명시적으로 승인하도록 요구합니다.
- 입력이 ERC-20이고 견적이 승인을 보고하는 경우 필요한 승인 트랜잭션을 준비합니다. 무제한 지출을 자동으로 승인하지 마십시오.
node scripts/prepare-swap.mjs --quote-file quote.json을 실행하거나 선택된 제공자 견적으로/swap/prepare를 호출합니다.- 체인 ID, 대상, 값, calldata 존재, 토큰 쌍 및 금액을 다시 확인합니다.
- 명시적 검토를 위해 서명되지 않은 트랜잭션을 선택된 서명자 어댑터에 반환합니다.
och-hoodwallet의 경우, 현재 Hoodie 소유권을 확인한 후 정확히 준비된 대상, 값 및 calldata만 HoodWallet 실행 호출에 래핑합니다. - 사용자가 별도로 승인된 지갑 도구나 정책을 활성화하고 정확한 작업을 승인하지 않는 한 에이전트에서 브로드캐스트하지 마십시오.
런칭 워크플로우
- 필수 이름, 티커, 설명, 공개 이미지 URL, 생성자 이메일, 생성자 지갑 및 페어 모드를 수집합니다.
- 주식 토큰과 페어링하는 경우
GET /stocks에서 주소를 확인하고, 임의의 주식 페어 주소를 절대 수락하지 마십시오. source: "launchpad",mode: "preflight"및dryRun: true와 함께 표준 사전 비행 페이로드를 제출합니다.- 예측된 토큰 및 풀, 총 공급량, 수수료, 전체 수혜자 분할, 페어, 안전 속성, 가스 추정치 및 트랜잭션 대상을 제시합니다.
- 사용자 검토를 위해 중지합니다. 사전 비행은 런칭 권한이 아닙니다.
- 생성자 계정만 반환된 Airlock 트랜잭션을 승인하고 보낼 수 있습니다. HoodWallet 생성자는 승인된 ERC-6551 계정 경로를 통해 이를 실행해야 합니다.
결정론 및 오류 처리
- API 호출에서 원시 정수 금액을 사용하고 문자열로 보존합니다.
- 토큰 소수점 자릿수, 주소, 풀 ID, 견적, 잔액 또는 경로 가용성을 임의로 만들지 마십시오.
/quote의404는 실행 가능한 경로를 찾을 수 없음을 의미합니다. 대체 경로를 조작하지 마십시오.NO ROUTE또는NOT CONFIGURED로 표시된 제공자는 해당 요청에 사용할 수 없습니다.- 이전 견적이 오래되었거나 금액이 변경된 경우 트랜잭션 준비 직전에 다시 견적을 받으십시오.
- 견적 또는 만료 시간이 만료되면 준비된 모든 트랜잭션을 만료된 것으로 처리합니다.
- 사용자 거부를 트랜잭션 실패가 아닌 취소로 표시합니다.
API 및 클라이언트
- 프로덕션 기본 URL:
https://hoodieswap.xyz/api/v1 - OpenAPI:
https://hoodieswap.xyz/api/v1/openapi.json - 저장소 사양: openapi/hoodieswap-v1.yaml
- TypeScript 클라이언트: src/client.ts
- 기능 검색:
GET /capabilities
Hoodieswap은 경로와 트랜잭션을 준비합니다. 지갑은 서명 경계로 남아 있으며 Hoodieswap은 절대 관리를 하지 않습니다.