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

# Helius를 통한 번들

> 기본 번들을 Helius RPC 엔드포인트를 통해 전송하세요. 최대 5개의 거래를 직접 Jito로 프록시하여 원자적, 올오어낫 실행을 수행합니다.

<Tip>
  이것은 **기본** 번들 경로로, Jito에 직접 프록시되며, 전송당 요금이 청구됩니다.
  지연 요구사항 없이 원자적 실행이 필요하면 가장 좋습니다. 저지연 및 우선 팁 버퍼가 필요한 거래자는 대신
  [보내는 사람 최대 번들](/docs/ko/sending-transactions/sender-max#번들)를 사용하세요.
</Tip>

기본 번들은 최대 5개의 거래를 원자적으로 올오어낫 방식으로 실행하여 Jito로 직접 프록시합니다. 각 `sendBundle` 제출은 플랜에서 **1 크레딧**으로 청구됩니다.

## 지원되는 메서드

| 메서드              | 설명             | 속도 제한        |
| ---------------- | -------------- | ------------ |
| `sendBundle`     | 번들 제출          | 프로젝트당 5 RPS  |
| `simulateBundle` | 제출 없이 번들 시뮬레이션 | 일반 RPC 속도 제한 |

<Tip>
  더 높은 속도 제한이 필요하신가요? [영업팀에 문의하세요](https://www.helius.dev/contact).
</Tip>

## sendBundle

서명된 거래 목록을 원자적 번들로 제출합니다. 번들이 수락되면 거래 서명의 SHA-256 해시인 `bundle_id`를 반환합니다. 이는 번들이 체인에 상륙함을 보장하지 않습니다. 확인을 위해 체인에서 거래 확인을 확인하세요.

팁이 필요합니다. 적어도 하나의 거래는 [Helius 팁 계정](#팁-계정)으로 SOL을 전송해야 합니다. 팁이 너무 낮으면 번들이 선택되지 않을 수 있습니다.

### 요청

| 매개변수                 | 유형              | 설명                                               |
| -------------------- | --------------- | ------------------------------------------------ |
| `params[0]`          | `array[string]` | **필수.** 최대 5개의 완전히 서명된 거래, base64로 인코딩.          |
| `params[1].encoding` | `string`        | 선택 사항. `base64` (권장) 또는 `base58`. 기본값: `base58`. |

### 예시

```bash theme={"system"}
curl "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY" \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "sendBundle",
    "params": [
      [
        "AT2AqtlokikUWgGNnSX5xrmdvBjSaiIPxvFz6zc5Abn5Z0CPFW5GO+Y3rXceLnqLgQFnGw0yTk3NtJdFNsbrwwQBAAIEsXPDJ9cMVbpFQYClVM7PGLh8JOfCD6E2vz5VNmBCF+p4Uhyxec67hYm1VqLV7JTSSYaC/fm7KvWtZOSRzEFT2gAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABUpTWpkpIQZNJOhxYNo4fHw1td28kruB5B+oQEEFRI1i3Wzl2VfewCI8oYXParnP78725sKFzYheTEn8v865YQIDABhqaXRvIGJ1bmRsZSAwOiBqaXRvIHRlc3QCAgABDAIAAACghgEAAAAAAA==",
        "AS6fOZuGDsmyYdd+RC0fiFUgNe1BYTOYT+1hkRXHAeroC8R60h3g34EPF5Ys8sGzVBMP9MDSTVgy1/SSTqpCtA4BAAIEsXPDJ9cMVbpFQYClVM7PGLh8JOfCD6E2vz5VNmBCF+p4Uhyxec67hYm1VqLV7JTSSYaC/fm7KvWtZOSRzEFT2gAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABUpTWpkpIQZNJOhxYNo4fHw1td28kruB5B+oQEEFRI1i3Wzl2VfewCI8oYXParnP78725sKFzYheTEn8v865YQIDABhqaXRvIGJ1bmRsZSAxOiBqaXRvIHRlc3QCAgABDAIAAACghgEAAAAAAA=="
      ],
      {
        "encoding": "base64"
      }
    ]
  }'
```

### 응답

```json theme={"system"}
{
  "jsonrpc": "2.0",
  "result": "892b79ed49138bfb3aa5441f0df6e06ef34f9ee8f3976c15b323605bae0cf51d",
  "id": 1
}
```

`result`는 번들 ID입니다 — `getBundleStatuses`와 함께 사용하여 상륙 추적을 수행하세요.

## getBundleStatuses

제출된 번들의 상태를 반환합니다. 번들이 상륙하지 않았거나 찾을 수 없는 경우 `null`를 반환합니다.

### 요청

| 매개변수        | 유형              | 설명                    |
| ----------- | --------------- | --------------------- |
| `params[0]` | `array[string]` | **필수.** 최대 5개의 번들 ID. |

### 예시

```bash theme={"system"}
curl "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY" \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getBundleStatuses",
    "params": [
      [
        "892b79ed49138bfb3aa5441f0df6e06ef34f9ee8f3976c15b323605bae0cf51d"
      ]
    ]
  }'
```

### 응답

```json theme={"system"}
{
  "jsonrpc": "2.0",
  "result": {
    "context": {
      "slot": 242806119
    },
    "value": [
      {
        "bundle_id": "892b79ed49138bfb3aa5441f0df6e06ef34f9ee8f3976c15b323605bae0cf51d",
        "transactions": [
          "3bC2M9fiACSjkTXZDgeNAuQ4ScTsdKGwR42ytFdhUvikqTmBheUxfsR1fDVsM5ADCMMspuwGkdm1uKbU246x5aE3",
          "8t9hKYEYNbLvNqiSzP96S13XF1C2f1ro271Kdf7bkZ6EpjPLuDff1ywRy4gfaGSTubsM2FeYGDoT64ZwPm1cQUt"
        ],
        "slot": 242804011,
        "confirmation_status": "finalized",
        "err": {
          "Ok": null
        }
      }
    ]
  },
  "id": 1
}
```

번들을 찾을 수 없는 경우 `value` 배열에 `null`를 반환합니다.

## 지역 라우팅

기본적으로 Helius는 Jito의 글로벌 엔드포인트 (`mainnet.block-engine.jito.wtf`)에 번들을 라우팅하며, 이는 근처의 Block Engine으로 자동으로 지리 라우팅됩니다.

특정 지역을 대상으로 하려면 `jito-region` HTTP 헤더를 설정하십시오:

| 헤더 값      | Block Engine 지역 |
| --------- | --------------- |
| `ams`     | 암스테르담           |
| `dub`     | 더블린             |
| `fra`     | 프랑크푸르트          |
| `lon`     | 런던              |
| `nyc`     | 뉴욕              |
| `slc`     | 솔트레이크시티         |
| `sgp`     | 싱가포르            |
| `tyo`     | 도쿄              |
| `mainnet` | 글로벌 (지리 라우팅)    |

### 지역 예시

```bash theme={"system"}
curl "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "jito-region: nyc" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "sendBundle",
    "params": [
      [
        "AT2AqtlokikUWgGNnSX5xrmdvBjSaiIPxvFz6zc5Abn5Z0CPFW5GO+Y3rXceLnqLgQFnGw0yTk3NtJdFNsbrwwQBAAIEsXPDJ9cMVbpFQYClVM7PGLh8JOfCD6E2vz5VNmBCF+p4Uhyxec67hYm1VqLV7JTSSYaC/fm7KvWtZOSRzEFT2gAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABUpTWpkpIQZNJOhxYNo4fHw1td28kruB5B+oQEEFRI1i3Wzl2VfewCI8oYXParnP78725sKFzYheTEn8v865YQIDABhqaXRvIGJ1bmRsZSAwOiBqaXRvIHRlc3QCAgABDAIAAACghgEAAAAAAA==",
        "AS6fOZuGDsmyYdd+RC0fiFUgNe1BYTOYT+1hkRXHAeroC8R60h3g34EPF5Ys8sGzVBMP9MDSTVgy1/SSTqpCtA4BAAIEsXPDJ9cMVbpFQYClVM7PGLh8JOfCD6E2vz5VNmBCF+p4Uhyxec67hYm1VqLV7JTSSYaC/fm7KvWtZOSRzEFT2gAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABUpTWpkpIQZNJOhxYNo4fHw1td28kruB5B+oQEEFRI1i3Wzl2VfewCI8oYXParnP78725sKFzYheTEn8v865YQIDABhqaXRvIGJ1bmRsZSAxOiBqaXRvIHRlc3QCAgABDAIAAACghgEAAAAAAA=="
      ],
      {
        "encoding": "base64"
      }
    ]
  }'
```

## 팁 계정

번들 내의 적어도 하나의 거래는 이 팁 계정 중 하나에 SOL 전송을 포함해야 합니다. 경쟁을 줄이기 위해 무작위로 선택하세요.

```text theme={"system"}
4ACfpUFoaSD9bfPdeu6DBt89gB6ENTeHBXCAi87NhDEE
D2L6yPZ2FmmmTKPgzaMKdhu6EWZcTpLy1Vhx8uvZe7NZ
9bnz4RShgq1hAnLnZbP8kbgBg1kEmcJBYQq3gQbmnSta
5VY91ws6B2hMmBFRsXkoAAdsPHBJwRfBht4DXox3xkwn
2nyhqdwKcJZR2vcqCyrYsaPVdAnFoJjiksCXJ7hfEYgD
2q5pghRs6arqVjRvT5gfgWfWcHWmw1ZuCzphgd5KfWGJ
wyvPkWjVZz1M8fHQnMMCDTQDbkManefNNhweYk5WkcF
3KCKozbAaF75qEU33jtzozcJ29yJuaLJTy2jFdzUY8bT
4vieeGHPYPG2MmyPRcYjdiDmmhN3ww7hsFNap8pVN3Ey
4TQLFNWK8AovT1gFvda5jfw2oJeRMKEmw7aH6MGBJ3or
```

최소 팁은 5,000 lamports입니다.

## 번들 요구사항

* 번들당 **최대 5개 거래**
* 모든 거래는 **완전히 서명**되어야 함
* **base64** 인코딩 사용 (성능상 base58보다 권장)
* 적어도 하나의 거래에 **팁** 포함
* 거래는 **순차적으로** 실행됨 — tx2는 tx1의 상태 변화에 의존 가능

## simulateBundle (선택 사항)

제출 전에 번들을 시뮬레이션하여 오류를 확인할 수 있습니다:

```bash theme={"system"}
curl "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY" \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "simulateBundle",
    "params": [
      {
        "encodedTransactions": [
          "AT2AqtlokikUWgGNnSX5xrmdvBjSaiIPxvFz6zc5Abn5Z0CPFW5GO+Y3rXceLnqLgQFnGw0yTk3NtJdFNsbrwwQBAAIEsXPDJ9cMVbpFQYClVM7PGLh8JOfCD6E2vz5VNmBCF+p4Uhyxec67hYm1VqLV7JTSSYaC/fm7KvWtZOSRzEFT2gAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABUpTWpkpIQZNJOhxYNo4fHw1td28kruB5B+oQEEFRI1i3Wzl2VfewCI8oYXParnP78725sKFzYheTEn8v865YQIDABhqaXRvIGJ1bmRsZSAwOiBqaXRvIHRlc3QCAgABDAIAAACghgEAAAAAAA==",
          "AS6fOZuGDsmyYdd+RC0fiFUgNe1BYTOYT+1hkRXHAeroC8R60h3g34EPF5Ys8sGzVBMP9MDSTVgy1/SSTqpCtA4BAAIEsXPDJ9cMVbpFQYClVM7PGLh8JOfCD6E2vz5VNmBCF+p4Uhyxec67hYm1VqLV7JTSSYaC/fm7KvWtZOSRzEFT2gAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABUpTWpkpIQZNJOhxYNo4fHw1td28kruB5B+oQEEFRI1i3Wzl2VfewCI8oYXParnP78725sKFzYheTEn8v865YQIDABhqaXRvIGJ1bmRsZSAxOiBqaXRvIHRlc3QCAgABDAIAAACghgEAAAAAAA=="
        ]
      }
    ]
  }'
```

## 샌드위치 공격 방어

통계적으로 샌드위치 공격과 연결된 검증자에서 번들을 우회하려면 RPC URL에 `mev-protect=true` 쿼리 매개변수를 추가하세요 — 번들에 대한 변경은 필요하지 않습니다:

```
https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY&mev-protect=true
```

## 자세히 보기

<CardGroup cols={2}>
  <Card title="MEV 보호" icon="shield-halved" href="/docs/ko/sending-transactions/mev-protect">
    샌드위치 공격과 통계적으로 연결된 검증자를 우회합니다.
  </Card>

  <Card title="거래 리베이트" icon="coins" href="/docs/ko/sending-transactions/backrun-rebates">
    생성한 MEV의 일부를 받도록 거래당 옵션을 선택하고, SOL로 지급받습니다.
  </Card>
</CardGroup>