> ## Documentation Index
> Fetch the complete documentation index at: https://docs.intention.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# 개발자

> Intention 위에서 개발하는 데 필요한 API 레퍼런스, 통합 가이드, SDK, 테스트넷 도구, 소스 코드가 있는 곳.

Intention 위에서 개발하는 데 필요한 것은 모두 아래 어딘가에 있습니다. 이 페이지는 그 지도입니다.

처음 통합한다면 **통합 가이드**부터 시작하십시오. SDK 설치에서 테스트넷 주문 체결까지 차례로 안내합니다. 시스템의 구조를 이미 알고 필드 단위 세부 사항만 필요하다면 **API 레퍼런스**로 바로 가십시오.

<h2 id="start-here">
  여기서 시작
</h2>

<CardGroup cols={2}>
  <Card title="통합 가이드" icon="book-open" href="https://dev.intention.xyz/">
    개발자용 전체 워크스루입니다. 설치, 인증과 서명, REST 빠른 시작, 계정, 마켓 데이터, 주문, 거래 흐름, USDC 이체, 요청 속도 제한까지 다룹니다.
  </Card>

  <Card title="API 레퍼런스" icon="plug" href="https://testnet-openapi.intention.xyz/">
    스키마와 브라우저 내 요청 실행기를 갖춘 완전한 REST 및 WebSocket 명세입니다.
  </Card>
</CardGroup>

<h2 id="what-the-api-covers">
  API가 다루는 범위
</h2>

레퍼런스는 다음 그룹으로 나뉩니다. 개수는 현재 테스트넷 명세의 엔드포인트 기준입니다.

| 그룹               | 다루는 내용                                      |
| ---------------- | ------------------------------------------- |
| **Markets**      | 무기한 마켓 목록, 오더북, 체결, 캔들, 펀딩 비율               |
| **Trading**      | 미체결 주문, 체결 내역, 클라이언트 주문 ID로 조회              |
| **Transactions** | 트랜잭션 제출, 배치 제출, 시뮬레이션, 인코딩, 대기; gas 추정      |
| **Accounts**     | 주소 및 서브 주소 상태, 포지션, 주문 내역, 거래 내역, 이체, 펀딩 지급 |
| **DEX Config**   | 무기한 및 현물 정의, 수수료 설정, 레버리지 등급, 에이전트 바인딩      |
| **Oracle**       | 현재 블록의 인증 가격                                |
| **Dashboard**    | 계정 가치, 손익 시계열, 거래 캘린더, 요약                   |
| **Export**       | 주문 내역, 거래 내역, 펀딩 지급의 CSV 내보내기               |
| **WebSocket**    | 오더북, 체결, 티커, 캔들, 서브 계정, 블록, 트랜잭션 구독 채널      |

<h2 id="testnet-tools">
  테스트넷 도구
</h2>

개발용 인터랙티브 도구이고, 모두 개발자 사이트에서 제공합니다.

<CardGroup cols={2}>
  <Card title="포셋(faucet)" icon="faucet" href="https://dev.intention.xyz/tools-faucet">
    새 계정으로 테스트넷 자금을 받습니다.
  </Card>

  <Card title="주문 조회" icon="magnifying-glass" href="https://dev.intention.xyz/tools-order-lookup">
    ID로 임의의 주문 상태와 내역을 확인합니다.
  </Card>

  <Card title="WebSocket 테스터" icon="signal-stream" href="https://dev.intention.xyz/tools-websocket">
    실시간 채널을 구독하고 원본 메시지를 확인합니다.
  </Card>

  <Card title="BCS 검증기" icon="binary" href="https://dev.intention.xyz/tools-bcs-verifier">
    서명하기 전에 직렬화된 트랜잭션이 의도한 내용을 담고 있는지 검사합니다.
  </Card>
</CardGroup>

<h2 id="sdks-and-source">
  SDK와 소스
</h2>

<CardGroup cols={2}>
  <Card title="SDK" icon="cubes" href="https://dev.intention.xyz/installation">
    TypeScript, Go, Python, C++ 공식 SDK입니다. 계정 생성, 서명, 주문 구성, 이체를 지원합니다.
  </Card>

  <Card title="GitHub" icon="github" href="https://github.com/intentionxyz">
    SDK와 노드 소프트웨어, 레퍼런스 통합 예제의 소스입니다.
  </Card>
</CardGroup>

<Note>
  공개된 명세는 현재 테스트넷을 대상으로 합니다. 엔드포인트 구조는 이를 기준으로 개발해도 될 만큼 안정적이지만, 메인넷에서 아직 검증되지 않은 부분은 메인넷 릴리스 노트에 다른 언급이 나오기 전까지 언제든 바뀔 수 있다고 보십시오.
</Note>

<h2 id="run-a-node">
  노드 운영
</h2>

노드 운영은 **개방되어 있지 않습니다**. 검증자 집합은 Intention Labs와 초대된 파트너가 운영하고, 참여는 등록이 아니라 승인으로 이루어집니다. 공개된 참여 절차도 없고, 일반 다운로드용으로 공개된 바이너리도 없습니다.

인프라를 운영해야 한다면 제목에 **Node operator**를 넣어 `contact@intention.xyz`로 메일을 보내십시오. 어떤 역할이 있고 무엇을 적어야 하는지는 [노드 운영](/ko/developers/run-a-node)에 정리해 두었습니다.

<Note>
  노드를 원하는 이유는 대부분 읽기 접근 때문입니다. 안정적인 쿼리, 과거 데이터, 남의 인덱서에 기대지 않는 것. 이 정도는 위의 API와 [인덱서](/ko/protocol/architecture/indexer)로 해결되고, 직접 운영해야 할 것은 없습니다.
</Note>

<h2 id="getting-help">
  도움받기
</h2>

통합 관련 질문, 예상과 다른 엔드포인트 동작, 상업적 협의는 모두 `contact@intention.xyz`로 보내십시오. 무엇을 적어야 하는지는 [빌더 및 통합 문의](/ko/help/builder-questions)를 참고하십시오.