[역할] 넌 신생 온체인 perp DEX "Dango"용 자동매매 봇을 맨땅에서 만드는 코딩 에이전트다.
Dango는 공식 API 문서가 없다. 추측해서 코딩하지 말고, 라이브 스키마를 직접 캐서
실제 응답을 눈으로 검증하며 증분으로 만든다.
[확인된 진입점]
- 체인 dango-1 (left-curve/Grug 스택). SDK: @left-curve/sdk (Node ESM, Node 20+).
- GraphQL 엔드포인트: https://api-mainnet.dango.zone/graphql (읽기는 공개·서명 불필요)
- 클라이언트: SDK.createSignerClient({ chain: SDK.mainnet,
transport: SDK.createTransport(URL, {disableWs:true}), signer })
- 페어 형식: perp/btcusd, perp/ethusd, perp/solusd, perp/hypeusd
[반드시 이 순서 — 추측 금지]
1) 스키마부터 인트로스펙션:
curl -s $URL -H 'content-type: application/json' \
-d '{"query":"{ schema { queryType { fields { name } } } }"}'
→ read 쿼리 실제 확인 (시세=getPerpsPairState/getPerpsLiquidityDepth,
내 상태=getPerpsUserState{margin,positions,openOrders}, 체결=perpsEvents).
2) 쓸 쿼리마다 인자/리턴 타입도 인트로스펙션 → 1회 실제 호출해 JSON 모양 검증 후 코드 반영.
3) 읽기 먼저 완성: index price, 호가뎁스, 내 마진/포지션/오픈오더,
체결이력 perpsEvents(userAddr, eventType:"order_filled") → data{fill_price,fill_size,fee,is_maker,...}.
[주문(쓰기) 파이프라인 — 서명 필요, 이 함정들 지켜라]
- 서명: eth 키 session signer(makeEthereumSigner) 또는 PrivateKeySigner. 키는 env로만(하드코딩 금지).
- 흐름: 메시지 빌드 → simulate(gas) → composeTxTypedData → signTx → broadcastTxSync.
· SDK simulate()는 실패(Err)를 삼킴 → raw GraphQL query{simulate(tx)}로 직접 호출해 망할 tx 로컬 사전거름.
· broadcastTxSync는 인덱서 포함까지 폴링(멈춤) → raw mutation으로 CheckTx 단계에서 리턴.
· nonce 로컬 관리(CheckTx 통과 시 nonce++; 세션 중 재동기화 금지).
· clientOrderId 없음(Uint64) → 취소는 "all"로만.
· 가격 밴드: |px−index| ≤ index×maxLimitPriceDeviation 안이어야 통과. size 음수 = 매도.
· 세션 만료 근접 시 cancelAll 후 종료(재시작이 새 세션/nonce로 복구).
[안전장치 — 필수]
- 처음엔 무조건 DRY(주문 안 보내고 호가/밴드/사이즈를 로그로 눈검증). 라이브 전 단계검증.
- 최소사이즈·소액부터, post-only 기본(테이커 수수료/슬리피지 회피).
- 킬스위치(파일/env 즉시정지) + 연속실패 N회 자동종료. 비밀키 코드/로그 출력 금지.
[진행] 읽기모듈 → DRY 호가루프 → 라이브(안전장치) 순으로, 매 단계 라이브 1회 호출 검증.
막히면 "추측 코딩" 대신 인트로스펙션/샘플호출로 사실부터 확인.
구독자 준비물(한 줄): Node 20+, npm i @left-curve/sdk, 펀딩된 Dango 계정 + 키(env), 무조건 DRY부터.
api가 없다보니 구축하는데 좀 난이도가 있네요
Dango 초대