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

# getCompressedAccount

> 지정된 주소 또는 해시를 가진 압축된 계정을 반환합니다.

## 요청 매개변수

<ParamField body="address" type="string" default="11111112D1oxKts8YPdTJRG5FzxTNpMtWmq8hkVx3">
  데이터를 검색할 압축된 계정의 Solana 공개 키입니다.
</ParamField>

<ParamField body="hash" type="string">
  주소가 없을 경우 압축된 Solana 계정의 데이터 해시 식별자입니다.
</ParamField>


## OpenAPI

````yaml ko/openapi/zk-compression/getCompressedAccount.yaml POST /
openapi: 3.0.3
info:
  title: Solana 상태 압축 API
  description: |
    효율적인 데이터 저장 및 검색을 위한 영지식 증명을 사용하여 압축 상태 계정을 위한 고급 Solana 인덱서입니다.
    이 API는 Solana의 상태 압축 기술을 통해 비용 효율적인 NFT 및 토큰 작업을 가능하게 하며, 
    기존 계정에 비해 최대 1000배까지 저장 비용을 절감합니다.
  license:
    name: Apache-2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
  version: 0.50.0
servers:
  - url: https://mainnet.helius-rpc.com
    description: 메인넷 RPC 엔드포인트
  - url: https://devnet.helius-rpc.com
    description: Devnet RPC 엔드포인트
security: []
paths:
  /:
    summary: getCompressedAccount
    post:
      description: |
        상태 압축 기술을 사용하여 압축된 Solana 계정에 대한 자세한 데이터를 검색합니다.
        이 엔드포인트는 기존 Solana 계정에 비해 최대 1000배의 비용 절감을 제공합니다.
        주소 또는 해시로 압축된 NFT 및 토큰 계정을 쿼리하여 계정 정보, 소유권 세부 정보, 온체인 데이터를 얻을 수 있습니다.

        주요 이점:
        - Solana NFT 프로젝트 및 토큰 발행자를 위한 극적인 비용 절감
        - 대량 응용 프로그램을 위한 저장 비용 감소
        - Solana의 보안 및 합의 모델과 완전 호환
        - 대규모 NFT 컬렉션 및 토큰 세트를 위한 확장 가능한 솔루션
        - 압축 자산 작업의 처리량 증가
      operationId: getCompressedAccount
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - jsonrpc
                - id
                - method
                - params
              properties:
                jsonrpc:
                  type: string
                  description: JSON-RPC 프로토콜 버전입니다.
                  enum:
                    - '2.0'
                  default: '2.0'
                id:
                  type: string
                  description: 요청을 식별하기 위한 ID입니다.
                  default: '1'
                method:
                  type: string
                  description: 호출할 메서드 이름입니다.
                  enum:
                    - getCompressedAccount
                  default: getCompressedAccount
                params:
                  type: object
                  description: |
                    Solana의 압축 계정 데이터를 검색하기 위한 요청 매개변수이며, 
                    압축된 NFT 및 토큰의 주소 식별자 또는 데이터 해시를 포함합니다.
                  default:
                    address: null
                    hash: gEF8v1TLb2T9vTaJarFj6kQoSfWNkskMSCJpPJSxZzT
                  properties:
                    address:
                      type: string
                      allOf:
                        - $ref: '#/components/schemas/SerializablePubkey'
                      nullable: true
                      description: 데이터를 검색할 압축된 계정의 Solana 공개 키입니다.
                    hash:
                      type: string
                      allOf:
                        - $ref: '#/components/schemas/Hash'
                      nullable: true
                      description: 주소가 없을 경우 압축된 Solana 계정의 데이터 해시 식별자입니다.
                  additionalProperties: false
                  example:
                    address: null
                    hash: gEF8v1TLb2T9vTaJarFj6kQoSfWNkskMSCJpPJSxZzT
        required: true
      responses:
        '200':
          description: Solana 블록체인에서 압축된 계정 데이터를 성공적으로 검색했습니다.
          content:
            application/json:
              schema:
                type: object
                required:
                  - context
                properties:
                  context:
                    $ref: '#/components/schemas/Context'
                  value:
                    $ref: '#/components/schemas/Account'
                additionalProperties: false
        '400':
          description: 잘못된 요청 - 요청 매개변수가 유효하지 않거나 요청이 잘못되었습니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32602
                  message: Invalid params
                id: '1'
        '401':
          description: 권한 없음 - API 키가 유효하지 않거나 누락되었습니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32001
                  message: Unauthorized
                id: '1'
        '429':
          description: 요청이 너무 많음 - 속도 제한 초과.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32005
                  message: Too many requests
                id: '1'
        '500':
          description: 내부 서버 오류 - 서버에서 오류가 발생했습니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32603
                  message: Internal error
                id: '1'
        '503':
          description: 서비스 불가 - 서비스가 일시적으로 사용 불가합니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32002
                  message: Service unavailable
                id: '1'
        '504':
          description: 게이트웨이 시간 초과 - 요청 시간이 초과되었습니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32003
                  message: Gateway timeout
                id: '1'
      security:
        - ApiKeyQuery: []
components:
  schemas:
    SerializablePubkey:
      type: string
      description: 계정, 프로그램 및 사용자를 식별하는 데 사용되는 base58 인코딩된 Solana 공개 키입니다.
      default: 11111112D1oxKts8YPdTJRG5FzxTNpMtWmq8hkVx3
      example: 11111112D1oxKts8YPdTJRG5FzxTNpMtWmq8hkVx3
    Hash:
      type: string
      description: Solana 압축 계정 검증에 사용되는 32바이트 암호화 해시를 base58 문자열로 나타낸 것입니다.
      example: 11111112cMQwSC9qirWGjZM6gLGwW69X22mqwLLGP
    Context:
      type: object
      required:
        - slot
      properties:
        slot:
          type: integer
          default: 100
          example: 100
          description: 이 요청의 Solana 블록체인 슬롯 현재 컨텍스트
    Account:
      type: object
      required:
        - hash
        - owner
        - lamports
        - tree
        - leafIndex
        - seq
        - slotCreated
      properties:
        address:
          $ref: '#/components/schemas/SerializablePubkey'
          description: 압축된 Solana 계정의 고유 식별자 주소
        data:
          $ref: '#/components/schemas/AccountData'
          description: 압축된 Solana 계정에 저장된 온체인 데이터
        hash:
          $ref: '#/components/schemas/Hash'
          description: 검증을 위한 압축 계정 데이터의 암호화 해시
        lamports:
          $ref: '#/components/schemas/UnsignedInteger'
          description: 이 압축된 계정이 보유한 Lamports 단위의 SOL 잔액 (1 SOL = 1,000,000,000 lamports)
        leafIndex:
          $ref: '#/components/schemas/UnsignedInteger'
          description: 이 압축 계정이 저장된 머클 트리의 위치 인덱스
        owner:
          $ref: '#/components/schemas/SerializablePubkey'
          description: 이 압축된 계정을 소유한 Solana 프로그램 (일반적으로 압축 프로그램)
        seq:
          $ref: '#/components/schemas/UnsignedInteger'
          description: 이 압축 계정의 업데이트를 추적하기 위한 시퀀스 번호
        slotCreated:
          $ref: '#/components/schemas/UnsignedInteger'
          description: 이 압축 계정이 생성된 Solana 블록체인 슬롯
        tree:
          $ref: '#/components/schemas/SerializablePubkey'
          description: 이 압축 계정이 저장된 머클 트리의 주소
      additionalProperties: false
    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'
    AccountData:
      type: object
      required:
        - discriminator
        - data
        - dataHash
      properties:
        data:
          $ref: '#/components/schemas/Base64String'
        dataHash:
          $ref: '#/components/schemas/Hash'
        discriminator:
          $ref: '#/components/schemas/UnsignedInteger'
      additionalProperties: false
    UnsignedInteger:
      type: integer
      default: 100
      example: 100
      description: Solana 압축 계정에서 다양한 수치 매개변수에 사용되는 음수가 아닌 정수 값입니다.
    Base64String:
      type: string
      description: Solana에서 압축된 계정 데이터를 나타내는 base64 인코딩 문자열입니다.
      default: SGVsbG8sIFdvcmxkIQ==
      example: SGVsbG8sIFdvcmxkIQ==
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: >-
        귀하의 Helius API 키입니다. [대시보드](https://dashboard.helius.dev/api-keys)에서 무료로
        받을 수 있습니다.

````