Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
106 changes: 89 additions & 17 deletions .gitbook/docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -1118,26 +1118,98 @@
"ko/defi/community-buyback",
"ko/defi/transactions",
"ko/defi/transaction-fees",
{
"group": "Open Liquidity Program",
"pages": [
"ko/defi/open-liquidity-program/introduction",
"ko/defi/open-liquidity-program/epochs",
"ko/defi/open-liquidity-program/eligibility",
"ko/defi/open-liquidity-program/scoring",
"ko/defi/open-liquidity-program/formula-parameters",
"ko/defi/open-liquidity-program/reward-allocations",
"ko/defi/open-liquidity-program/flexible-reward-allocations",
"ko/defi/open-liquidity-program/reward-disbursements",
"ko/defi/open-liquidity-program/performance-tracking",
"ko/defi/open-liquidity-program/volatility-response-modifications",
"ko/defi/open-liquidity-program/fee-tiers"
]
}
{
"group": "Open Liquidity Program",
"pages": [
"ko/defi/open-liquidity-program/introduction",
"ko/defi/open-liquidity-program/epochs",
"ko/defi/open-liquidity-program/eligibility",
"ko/defi/open-liquidity-program/scoring",
"ko/defi/open-liquidity-program/formula-parameters",
"ko/defi/open-liquidity-program/reward-allocations",
"ko/defi/open-liquidity-program/flexible-reward-allocations",
"ko/defi/open-liquidity-program/reward-disbursements",
"ko/defi/open-liquidity-program/performance-tracking",
"ko/defi/open-liquidity-program/volatility-response-modifications",
"ko/defi/open-liquidity-program/fee-tiers"
]
}
]
},
{
"group": "개발자",
"icon": "laptop-code",
"expanded": false,
"pages": [
"ko/developers/index",
"ko/developers/convert-addresses",
"ko/developers/network-information",
{
"group": "AI 개발",
"pages": [
"ko/developers/ai/mcp"
]
},
{
"group": "EVM 개발자",
"group": "injectived",
"pages": [
"ko/developers/injectived/index",
"ko/developers/injectived/install",
"ko/developers/injectived/use",
"ko/developers/injectived/advanced",
"ko/developers/testnet-proposals"
]
},
{
"group": "개념",
"pages": [
"ko/developers/concepts/index",
"ko/developers/concepts/sentry-node",
"ko/developers/concepts/indexer-api",
"ko/developers/concepts/trading-account",
"ko/developers/concepts/grpc-protobuf",
"ko/developers/concepts/token-factory",
"ko/developers/concepts/calculation-min-price-tick-size",
"ko/developers/concepts/calculation-min-quantity-tick-size",
"ko/developers/concepts/cosmjs-support",
"ko/developers/concepts/networks"
]
},
{
"group": "자산",
"pages": [
"ko/developers/assets/index",
"ko/developers/assets/denom",
"ko/developers/assets/token-metadata",
"ko/developers/assets/injective-list",
"ko/developers/assets/token-create"
]
},
{
"group": "dApp",
"pages": [
"ko/developers/dapps/index",
"ko/developers/dapps/configure-nuxt",
"ko/developers/dapps/configure-react",
"ko/developers/dapps/run-examples",
"ko/developers/dapps/example-smart-contract",
"ko/developers/dapps/example-dex",
"ko/developers/dapps/example-webpack"
]
},
"redirects/https_testnet_faucet_injective_network",
"redirects/https_sentry_lcd_injective_network_swagger",
"redirects/https_docs_ts_injective_network",
"redirects/https_github_com_InjectiveLabs_sdk_go",
"redirects/https_github_com_InjectiveLabs_sdk_python",
"redirects/https_github_com_InjectiveLabs_cw_injective",
"redirects/https_github_com_InjectiveLabs_injective_rust",
"redirects/https_docs_substreams_dev_documentation_how_to_guides_injective",
"redirects/https_api_injective_exchange"
]
},
{
"group": "EVM 개발자",
"icon": "rectangle-code",
"expanded": false,
"pages": [
Expand Down
158 changes: 158 additions & 0 deletions .gitbook/ko/developers/ai/mcp.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,158 @@
---
title: MCP 서버
description: Model Context Protocol을 사용하여 AI 어시스턴트를 Injective 문서에 연결하세요
---

Injective 문서는 Claude, Cursor 및 기타 MCP 호환 도구와 같은 AI 어시스턴트가 Injective 문서에서 **정보를 검색하고 검색**할 수 있도록 하는 Model Context Protocol (MCP) 서버를 제공합니다.

이것은 문서 검색뿐만 아니라 다른 MCP 서버 및 AI 에이전트와 **함께 사용**할 때도 강력합니다.
예를 들어, Cursor와 같은 에이전트 개발 도구를 연결하여 이 MCP 서버를 사용하면 LLM의 범용 소프트웨어 작성 능력에 **Injective 관련 지식을 추가**하여 Injective 애플리케이션을 바이브 코딩할 수 있습니다.
개발자 도구 구성 방법에 대한 자세한 내용은 아래에 포함되어 있습니다.

## MCP란 무엇인가요?

[MCP](https://modelcontextprotocol.io/introduction)는 AI 어시스턴트가 외부 데이터 소스 및 도구에 연결할 수 있도록 하는 **오픈 표준**입니다.
AI 어시스턴트는 학습 데이터에만 의존하는 대신 MCP를 사용하여 문서에서 직접 실시간의 신뢰할 수 있는 정보에 액세스할 수 있습니다.

## 왜 Injective MCP 서버를 사용해야 하나요?

AI 어시스턴트를 Injective MCP 서버에 연결하면 다음을 수행할 수 있습니다:

- 전체 Injective 문서 검색
- 코드 예제, API 참조 및 가이드 찾기
- 최신 정보로 질문에 답변
- 관련 문서 페이지에 대한 직접 링크 제공

이것은 Injective에서 구축할 때 특히 유용하며, AI가 특정 사용 사례에 맞는 올바른 문서를 찾는 데 도움을 줄 수 있습니다.

## MCP 서버 세부 정보

| 속성 | 값 |
|----------|-------|
| Endpoint | `https://docs.injective.network/mcp` |
| Transport | HTTP (Streamable HTTP) |
| 사용 가능한 도구 | `SearchInjectiveDocs` |

## MCP 서버에 연결

<Tabs>
<Tab title="모든 MCP 클라이언트">
MCP 호환 클라이언트의 경우 endpoint URL을 직접 사용하세요:

```
https://docs.injective.network/mcp
```

서버는 대부분의 최신 MCP 클라이언트에서 지원하는 Streamable HTTP transport를 사용합니다.
</Tab>
<Tab title="Cursor">
Cursor 설정에서 MCP 서버를 추가하세요:

1. Cursor 설정 열기
2. **Features** → **MCP Servers**로 이동
3. **Add new MCP server** 클릭
4. 다음을 입력하세요:
- **Name**: `injective-docs`
- **Type**: `command`
- **Command**: `npx mcp-remote https://docs.injective.network/mcp`
</Tab>
<Tab title="Claude Desktop">
Claude Desktop 구성 파일에 다음을 추가하세요:

<Tabs>
<Tab title="macOS">
`~/Library/Application Support/Claude/claude_desktop_config.json`을 편집하세요:

```json
{
"mcpServers": {
"injective-docs": {
"command": "npx",
"args": [
"mcp-remote",
"https://docs.injective.network/mcp"
]
}
}
}
```
</Tab>
<Tab title="Windows">
`%APPDATA%\Claude\claude_desktop_config.json`을 편집하세요:

```json
{
"mcpServers": {
"injective-docs": {
"command": "npx",
"args": [
"mcp-remote",
"https://docs.injective.network/mcp"
]
}
}
}
```
</Tab>
</Tabs>

구성을 저장한 후 Claude Desktop을 다시 시작하세요. Injective Docs 도구가 Claude의 사용 가능한 도구에 나타납니다.
</Tab>
</Tabs>

## MCP 서버 사용

연결되면 AI 어시스턴트에게 Injective에 대한 질문을 할 수 있습니다.
어시스턴트는 자동으로 `SearchInjectiveDocs` 도구를 사용하여 관련 정보를 찾습니다.

**예시 프롬프트:**

- "Injective에서 지갑을 어떻게 만드나요?"
- "CosmWasm 스마트 컨트랙트를 배포하는 방법을 보여주세요"
- "Injective 메인넷의 네트워크 endpoint가 무엇인가요?"
- "Token Factory 모듈을 어떻게 사용하나요?"
- "Injective에서 마진 트레이딩이 어떻게 작동하는지 설명해주세요"

AI는 문서를 검색하고 관련 페이지 링크와 함께 답변을 제공합니다.

## MCP 도구 참조

### `SearchInjectiveDocs`

Injective 문서 전체에서 관련 정보를 검색합니다.

**매개변수:**

| 매개변수 | 타입 | 필수 | 설명 |
|-----------|------|----------|-------------|
| `query` | string | 예 | 관련 문서를 찾기 위한 검색 쿼리 |

**반환:**

문서 페이지에 대한 제목과 직접 링크가 포함된 컨텍스트 콘텐츠입니다.
이 도구는 전체 Injective 문서 코퍼스에서 시맨틱 검색을 수행하여 쿼리를 페이지 콘텐츠, 제목 및 코드 예제와 매칭합니다.
결과는 관련성 순으로 정렬되며 쿼리에 가장 잘 응답하는 추출된 스니펫과 추가 읽기를 위한 소스 URL과 함께 반환됩니다.

**예시:**

요청:
```json
{
"tool": "SearchInjectiveDocs",
"arguments": {
"query": "token factory를 사용하여 토큰을 만드는 방법"
}
}
```

응답:
```json
{
"content": [
{
"type": "text",
"text": "# Token Factory\n\nToken Factory 모듈을 사용하면 Injective에서 커스텀 토큰을 생성하고 관리할 수 있습니다...\n\n## 토큰 생성\n\n새 토큰을 생성하려면 `tokenfactory/create-denom` 메시지를 사용하세요...\n\nSource: https://docs.injective.network/developers/concepts/token-factory"
}
]
}
```
24 changes: 24 additions & 0 deletions .gitbook/ko/developers/assets/denom.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
---
title: Denom
---

denom은 Injective의 Bank 모듈 내에서 자산이 표현되는 방식입니다. 이러한 자산은 거래, exchange 모듈에서 새 마켓 생성, 경매 참여, 다른 주소로 전송 등에 사용할 수 있습니다.

denom의 출처와 Injective에서 생성된 방식에 따라 다양한 유형의 denom이 있습니다:

* **Native denom** - 이 유형의 denom은 Injective의 네이티브 코인을 나타내는 `inj` denom 하나만 있습니다.
* **Peggy denom** - 이러한 denom은 Peggy 브릿지를 사용하여 Ethereum에서 Injective로 브릿지된 자산을 나타냅니다. `peggy{ERC20_CONTRACT_ADDRESS}` 형식입니다.
* **IBC denom** - 이러한 denom은 IBC를 통해 다른 Cosmos 체인에서 브릿지된 자산을 나타냅니다. `ibc/{hash}` 형식입니다.
* **Insurance Fund Denom** - 이러한 denom은 Injective에서 생성된 insurance fund의 토큰 지분을 나타냅니다. `share{id}` 형식입니다.
* **Factory Denom** - 이러한 denom은 Injective 네이티브 bank 모듈에서 Cosmwasm의 CW20 토큰을 표현한 것입니다. `factory/{OWNER}/{SUBDENOM}` 형식이며, 여기서 `OWNER`는 factory denom을 생성한 소유자입니다. 한 예로 `factory/{CW20_ADAPTER_CONTRACT}/{CW20_CONTRACT_ADDRESS}`라는 CW20 토큰 factory denom이 있으며, 여기서 `CW20_ADAPTER_CONTRACT`는 CW20과 네이티브 Bank 모듈 간의 변환을 수행하는 어댑터 컨트랙트 주소입니다.

## 토큰

토큰은 단순히 Injective 체인의 denom에 일부 메타 정보가 포함된 것입니다. 메타데이터에는 특정 denom에 대한 심볼, 이름, 소수점, 로고 등의 정보가 포함됩니다. denom의 메타데이터는 dApp 개발자에게 매우 중요한데, 체인의 정보가 원시 형태로 저장되기 때문입니다(예: 체인에서 `1inj`는 `1*10^18inj`로 표현됨). 따라서 사용자에게 사람이 읽을 수 있는 정보(숫자, 로고, 심볼 등)를 표시할 수 있는 방법이 필요합니다.

<Callout icon="warning" color="#07C1FF" iconType="regular">
**지원 중단 공지**

Injective SDK 내에서 "Denom Client"가 사용 가능했습니다.
이것은 [Injective List](/developers/assets/injective-list)를 선호하여 더 이상 사용되지 않습니다.
</Callout>
4 changes: 4 additions & 0 deletions .gitbook/ko/developers/assets/index.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
---
title: 자산
---

31 changes: 31 additions & 0 deletions .gitbook/ko/developers/assets/injective-list.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
---
title: Injective List
---

온체인 denom 토큰 메타데이터를 [injective-list](https://github.com/InjectiveLabs/injective-lists) 저장소로 이동했습니다. 이 저장소는 여러 소스에서 데이터를 집계하고 포괄적인 토큰 메타데이터 마스터 목록을 생성합니다.

다음은 injective-list를 TokenFactoryStatic 클래스와 통합하는 방법의 예입니다:

1. GitHub에서 [Injective list JSON 파일](https://github.com/InjectiveLabs/injective-lists?tab=readme-ov-file#-usage)을 다운로드합니다

2. `sdk-ts` 패키지에서 `TokenFactoryStatic` 클래스를 사용합니다

```ts
import { TokenFactoryStatic } from "@injectivelabs/sdk-ts/service";
import { TokenType, TokenStatic } from "@injectivelabs/sdk-ts/types";
import { tokens } from "../data/tokens.json"; // 1단계에서 다운로드한 json 파일

export const tokenFactoryStatic = new TokenFactoryStatic(
tokens as TokenStatic[]
);

// 인스턴스화 후 dApp에서 사용을 시작할 수 있습니다
const denom = "peggy0x...";
const token = tokenFactoryStatic.toToken(denom);

console.log(token);
```

`TokenFactoryStatic`을 사용할 때 고려해야 할 몇 가지 에지 케이스가 있습니다:

- [토큰 목록](https://github.com/InjectiveLabs/injective-lists)에 존재하지 않는 denom에 대한 토큰 메타데이터를 쿼리하려고 하면 `TokenFactoryStatic`이 undefined를 반환합니다. 그렇다면 [CONTRIBUTION 가이드](https://github.com/InjectiveLabs/injective-lists/blob/master/CONTRIBUTING.md)를 따라 패키지에 토큰 메타데이터 정보를 추가해야 합니다.
21 changes: 21 additions & 0 deletions .gitbook/ko/developers/assets/token-create.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
---
title: 토큰 생성
---

Injective에서 자신만의 토큰을 생성하는 가장 쉬운 방법은 `tokenfactory` 모듈을 사용하는 것입니다. `tokenfactory` 모듈을 사용하면 모든 계정이 `factory/{creator address}/{subdenom}` 이름의 새 토큰을 생성할 수 있습니다. 토큰이 생성자 주소로 네임스페이스화되어 있기 때문에 이름 충돌을 해결할 필요가 없어 토큰 발행이 무허가로 이루어질 수 있습니다.

단일 계정은 각 생성된 denom에 고유한 subdenom을 제공하여 여러 denom을 생성할 수 있습니다. denom이 생성되면 원래 생성자에게 자산에 대한 "관리자" 권한이 부여됩니다. 이를 통해 다음을 수행할 수 있습니다:

* 모든 계정에 자신의 denom을 발행
* 모든 계정에서 자신의 denom을 소각
* 두 계정 간의 denom 전송을 생성
* 관리자 변경. 향후 더 많은 관리자 기능이 추가될 수 있습니다. 관리자는 authz 모듈을 사용하여 다른 계정과 관리자 권한을 공유하도록 선택할 수 있습니다. ChangeAdmin 기능을 사용하면 마스터 관리자 계정을 변경하거나 제로 주소 `inj1qqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqe2hm49`로 설정하여 어떤 계정도 자산에 대한 관리자 권한이 없도록 할 수 있습니다.
* 온체인에서 토큰 메타데이터 설정

<Callout icon="info" color="#07C1FF" iconType="regular">
factory denom의 특별한 사용 사례 중 하나는 `CW20_ADAPTER`입니다. 이 어댑터를 사용하면 CW20으로 표현된 자산을 bank denom으로 변환한 다음 마켓 출시, 온체인에서 쉽게 전송 등에 사용할 수 있습니다.

CW20 자산의 denom은 항상 `factory/{CW20_ADAPTER_CONTRACT_ADDRESS}/{CW20_ASSET_ADDRESS}` 형식이며, 여기서 메인넷의 경우 `CW20_ADAPTER_CONTRACT_ADDRESS=inj14ejqjyq8um4p3xfqj74yld5waqljf88f9eneuk`입니다.
</Callout>

denom 생성을 시작하려면 예제를 보기 위해 [TokenFactory Core Module 페이지](/developers-native/examples/token-factory/)로 이동하세요.
24 changes: 24 additions & 0 deletions .gitbook/ko/developers/assets/token-metadata.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
---
title: 토큰 메타데이터
---

Injective의 자산은 denom으로 표현됩니다. Denom(및 금액)은 사람이 읽을 수 없으므로 특정 denom에 대한 토큰 메타데이터 정보를 "첨부"할 수 있는 방법이 필요합니다.

시작하기 섹션에서 우리가 가진 denom 유형을 다시 살펴보겠습니다:

* **Native denom** - 이 유형의 denom은 Injective의 네이티브 코인을 나타내는 `inj` denom 하나만 있습니다.
* **Peggy denom** - 이러한 denom은 Peggy 브릿지를 사용하여 Ethereum에서 Injective로 브릿지된 자산을 나타냅니다. `peggy{ERC20_CONTRACT_ADDRESS}` 형식입니다.
* **IBC denom** - 이러한 denom은 IBC를 통해 다른 Cosmos 체인에서 브릿지된 자산을 나타냅니다. `ibc/{hash}` 형식입니다.
* **Insurance Fund Denom** - 이러한 denom은 Injective에서 생성된 insurance fund의 토큰 지분을 나타냅니다. `share{id}` 형식입니다.
* **Factory Denom** - 이러한 denom은 Injective 네이티브 bank 모듈에서 Cosmwasm의 CW20 토큰을 표현한 것입니다. `factory/{CW20_ADAPTER_CONTRACT}/{CW20_CONTRACT_ADDRESS}` 형식이며, 여기서 `CW20_ADAPTER_CONTRACT`는 CW20과 네이티브 Bank 모듈을 변환하는 어댑터 컨트랙트 주소입니다.

빠른 액세스를 위해 오프체인에서 [injective-lists](https://github.com/InjectiveLabs/injective-lists/tree/master/tokens) 저장소에 토큰 메타데이터 목록을 유지합니다.

## 토큰 검증

토큰의 메타데이터를 검증하는 것은 몇 가지 방법으로 수행할 수 있습니다. 다음은 검증 수준과 그 의미입니다:

* **Verified** → 자산 메타데이터가 `@injectivelabs/token-metadata` 패키지에 **제출되고 검증**되었습니다. 패키지에 토큰 메타데이터를 추가하는 방법에 대한 튜토리얼은 [여기](https://github.com/InjectiveLabs/injective-lists/blob/master/CONTRIBUTING.md)에서 찾을 수 있습니다.
* **Internal** → [여기](/developers-native/examples/token-factory)에서 설명한 대로 `MsgSetDenomMetadata` 메시지를 사용하여 온체인에서 자산의 메타데이터가 검증되었습니다.
* **External** → 자산의 메타데이터가 Ethereum의 컨트랙트 세부 정보 등 외부 소스에서 검증되었습니다.
* **Unverified** → 자산의 메타데이터가 어디에도 제공되지 않았습니다.
Loading