> ## 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.

# sendTransaction

> 서명된 거래를 클러스터에 제출하여 처리합니다.

이 메서드는 거래를 아무런 방식으로도 변경하지 않습니다. 클라이언트가 생성한 거래를 있는 그대로 노드에 전달합니다.

노드의 RPC 서비스가 거래를 받으면, 이 메서드는 즉시 성공하며, 확인을 기다리지 않습니다. 이 메서드의 성공적인 응답은 거래가 클러스터에 의해 처리되거나 확인되었음을 보장하지 않습니다.

RPC 서비스가 합리적으로 재시도하더라도, 거래의 recent\_blockhash가 도착하기 전에 만료되면 거래가 거부될 수 있습니다.

[getSignatureStatuses](/docs/ko/api-reference/rpc/http/getsignaturestatuses)를 사용하여 거래가 처리되고 확인되었는지 확인하십시오.

제출 전에 다음의 프리플라이트 검사가 수행됩니다:

1. 거래 서명이 검증됩니다
2. 거래가 프리플라이트 커밋먼트로 지정된 은행 슬롯에 대해 시뮬레이션됩니다. 실패 시 오류가 반환됩니다. 원한다면 프리플라이트 검사를 비활성화할 수 있습니다. 혼란스러운 동작을 피하기 위해 동일한 커밋먼트와 프리플라이트 커밋먼트를 지정하는 것이 좋습니다.

반환된 서명은 거래의 첫 번째 서명으로, 거래(id)를 식별하는 데 사용됩니다. 이 식별자는 제출 전에 거래 데이터에서 쉽게 추출할 수 있습니다.

## 요청 매개변수

<ParamField body="transaction" type="string" required>
  블록체인 제출을 위해 base-58 문자열로 인코딩된 완전히 서명된 Solana 거래입니다.
</ParamField>

<ParamField body="encoding" type="string">
  Solana 거래 페이로드에 사용되는 데이터 인코딩 형식입니다.

  * `base58`
  * `base64`
</ParamField>

<ParamField body="skipPreflight" type="boolean">
  true인 경우, 빠른 제출을 위해 Solana의 프리플라이트 거래 검증을 우회합니다.
</ParamField>

<ParamField body="preflightCommitment" type="string">
  거래 검증 검사를 위한 Solana 네트워크 커밋먼트 수준입니다.

  * `confirmed`
  * `finalized`
  * `processed`
</ParamField>

<ParamField body="maxRetries" type="number">
  실패한 Solana 거래 제출에 대한 자동 재시도 최대 횟수입니다.
</ParamField>

<ParamField body="minContextSlot" type="number">
  거래 처리를 위한 최소 Solana 블록체인 슬롯입니다.
</ParamField>


## OpenAPI

````yaml ko/openapi/rpc-http/sendTransaction.yaml POST /
openapi: 3.1.0
info:
  title: Solana RPC API
  version: 1.0.0
  description: >-
    서명된 트랜잭션을 Solana 블록체인에 전송하기 위한 빠르고 신뢰할 수 있는 Solana 트랜잭션 제출 API로, 구성 가능한 사전
    비행 검사 및 재시도 옵션을 제공합니다.
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://mainnet.helius-rpc.com
    description: 메인넷 RPC 엔드포인트
  - url: https://devnet.helius-rpc.com
    description: 데브넷 RPC 엔드포인트
security: []
paths:
  /:
    post:
      tags:
        - RPC
      summary: sendTransaction
      description: >-
        구성 가능한 옵션을 사용하여 서명된 트랜잭션을 Solana 블록체인 네트워크에 제출합니다. 이 필수 API는 응용 프로그램이
        트랜잭션을 검증 및 원장에 포함하기 위해 브로드캐스트할 수 있도록 하며, 토큰 전송, NFT 발행, 스마트 계약 호출 및 프로그램
        배포를 포함한 모든 Solana 트랜잭션 유형을 지원합니다. 기능에는 사전 비행 검사, 사용자 정의 가능한 재시도 로직 및 확인
        상태를 추적하기 위한 즉각적인 트랜잭션 서명 응답이 포함됩니다.
      operationId: sendTransaction
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                jsonrpc:
                  type: string
                  enum:
                    - '2.0'
                  description: JSON-RPC 프로토콜 버전입니다.
                  example: '2.0'
                  default: '2.0'
                id:
                  type: string
                  description: 요청에 대한 고유 식별자입니다.
                  example: '1'
                  default: '1'
                method:
                  type: string
                  enum:
                    - sendTransaction
                  description: 호출할 RPC 메서드 이름입니다.
                  example: sendTransaction
                  default: sendTransaction
                params:
                  type: array
                  description: 트랜잭션을 전송하기 위한 매개변수입니다.
                  default:
                    - >-
                      4hXTCkRzt9WyecNzV1XPgCDfGAZzQKNxLXgynz5QDuWWPSAZBZSHptvWRL3BjCvzUXRdKvHL2b7yGrRQcWyaqsaBCncVG7BFggS8w9snUts67BSh3EqKpXLUm5UMHfD7ZBe9GhARjbNQMLJ1QD3Spr6oMTBU6EhdB4RD8CP2xUxr2u3d6fos36PD98XS6oX8TQjLpsMwncs5DAMiD4nNnR8NBfyghGCWvCVifVwvA8B8TJxE1aiyiv2L429BCWfyzAme5sZW8rDb14NeCQHhZbtNqfXhcp2tAnaAT
                  items:
                    oneOf:
                      - type: string
                        description: 블록체인 제출을 위한 base-58 문자열로 인코딩된 완전히 서명된 Solana 트랜잭션입니다.
                        example: >-
                          4hXTCkRzt9WyecNzV1XPgCDfGAZzQKNxLXgynz5QDuWWPSAZBZSHptvWRL3BjCvzUXRdKvHL2b7yGrRQcWyaqsaBCncVG7BFggS8w9snUts67BSh3EqKpXLUm5UMHfD7ZBe9GhARjbNQMLJ1QD3Spr6oMTBU6EhdB4RD8CP2xUxr2u3d6fos36PD98XS6oX8TQjLpsMwncs5DAMiD4nNnR8NBfyghGCWvCVifVwvA8B8TJxE1aiyiv2L429BCWfyzAme5sZW8rDb14NeCQHhZbtNqfXhcp2tAnaAT
                      - type: object
                        description: Solana 트랜잭션 제출 및 처리를 위한 고급 구성 옵션입니다.
                        properties:
                          encoding:
                            type: string
                            description: Solana 트랜잭션 페이로드에 사용되는 데이터 인코딩 형식입니다.
                            enum:
                              - base58
                              - base64
                            example: base64
                          skipPreflight:
                            type: boolean
                            description: >-
                              true인 경우 Solana의 사전 비행 트랜잭션 검증을 우회하여 더 빠른 제출을 가능하게
                              합니다.
                            example: false
                          preflightCommitment:
                            type: string
                            description: 트랜잭션 검증 검사를 위한 Solana 네트워크 커밋먼트 수준입니다.
                            enum:
                              - confirmed
                              - finalized
                              - processed
                            example: finalized
                          maxRetries:
                            type: integer
                            description: 실패한 Solana 트랜잭션 제출에 대한 자동 재시도 최대 횟수입니다.
                            example: 5
                          minContextSlot:
                            type: integer
                            description: 트랜잭션 처리를 위한 최소 Solana 블록체인 슬롯 요구사항입니다.
                            example: 1000
      responses:
        '200':
          description: 트랜잭션을 성공적으로 보냈습니다.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                    description: JSON-RPC 프로토콜 버전입니다.
                    enum:
                      - '2.0'
                    example: '2.0'
                  id:
                    type: string
                    description: 요청과 일치하는 식별자입니다.
                    example: '1'
                  result:
                    type: string
                    description: 확인 상태와 트랜잭션 기록을 추적하기 위한 고유한 Solana 트랜잭션 서명입니다.
                    example: >-
                      2id3YC2jK9G5Wo2phDx4gJVAew8DcY5NAojnVuao8rkxwPYPe8cSwE5GzhEgJA2y8fVjDEo6iR6ykBvDxrTQrtpb
              example:
                jsonrpc: '2.0'
                id: '1'
                result: >-
                  2id3YC2jK9G5Wo2phDx4gJVAew8DcY5NAojnVuao8rkxwPYPe8cSwE5GzhEgJA2y8fVjDEo6iR6ykBvDxrTQrtpb
        '400':
          description: 잘못된 요청 - 잘못된 요청 매개변수 또는 잘못된 요청입니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32602
                  message: 잘못된 매개변수
                id: '1'
        '401':
          description: 인증되지 않음 - 잘못되었거나 누락된 API 키입니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32001
                  message: 인증되지 않음
                id: '1'
        '429':
          description: 요청이 너무 많음 - 속도 제한이 초과되었습니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32005
                  message: 요청이 너무 많습니다
                id: '1'
        '500':
          description: 내부 서버 오류 - 서버에서 오류가 발생했습니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32603
                  message: 내부 오류
                id: '1'
        '503':
          description: 서비스 이용 불가 - 서비스가 일시적으로 사용할 수 없습니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32002
                  message: 서비스를 사용할 수 없습니다
                id: '1'
        '504':
          description: 게이트웨이 시간 초과 - 요청 시간이 초과되었습니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32003
                  message: 게이트웨이 시간 초과
                id: '1'
      security:
        - ApiKeyQuery: []
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        jsonrpc:
          type: string
          description: JSON-RPC 프로토콜 버전입니다.
          enum:
            - '2.0'
          example: '2.0'
        error:
          type: object
          properties:
            code:
              type: integer
              description: 오류 코드입니다.
              example: -32602
            message:
              type: string
              description: 오류 메시지입니다.
            data:
              type: object
              description: 오류에 대한 추가 데이터입니다.
        id:
          type: string
          description: 요청과 일치하는 식별자입니다.
          example: '1'
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: >-
        귀하의 Helius API 키입니다. [대시보드](https://dashboard.helius.dev/api-keys)에서 무료로
        얻을 수 있습니다.

````