Skip to main content
Version: v1

Wallet SDK v1.0.0 release notes

  • Version: v1.0.0
  • Date: 28 January, 2026
  • Environment: preprod, preview

High-level summary​

Midnight Wallet SDK의 첫 번째 안정 릴리스입니다. Midnight Network을 위한 TypeScript 지갑 구현체로, Midnight의 세 가지 토큰 시스템을 완벽하게 지원합니다: 비차폐 토큰(NIGHT 포함), 영지식 증명을 활용한 차폐 토큰, 수수료 결제를 위한 DUST.

Audience​

이 릴리스는 다음에 해당하는 개발자에게 유용합니다:

  • Midnight Network에서 지갑 기능을 구현하는 경우
  • DApp에 Midnight 토큰 전송을 통합하는 경우
  • 차폐(프라이빗) 및 비차폐 토큰 잔액을 관리해야 하는 경우
  • 당사자 간 원자적 스왑을 구현하는 경우

What changed (Summary of updates)​

  • 비차폐 토큰(NIGHT 포함) 완벽 지원
  • 영지식 증명을 활용한 차폐 토큰 완벽 지원
  • 트랜잭션 수수료 결제를 위한 Dust 관리
  • HD 지갑 키 파생
  • Bech32m 주소 인코딩 및 디코딩
  • 모든 토큰 유형에 걸친 트랜잭션 밸런싱
  • 원자적 스왑 지원

New features​

아래는 이번 릴리스에서 추가된 새로운 기능의 상세 내역입니다.

Wallet facade​

차폐, 비차폐, dust 지갑 운영을 단일 인터페이스로 제공하는 통합 API입니다. 트랜잭션 밸런싱, 전송, 스왑을 처리합니다. 세 가지 개별 지갑 유형을 관리하는 복잡성을 추상화하므로, 대부분의 개발자에게 주요 진입점이 됩니다.

Unshielded wallet​

Schnorr 서명과 함께 UTxO 모델을 사용하여 NIGHT 및 기타 비차폐 토큰을 관리합니다. UTxO을 추적하고, 스왑을 위한 offer을 생성하며, 트랜잭션 밸런싱을 위한 입력/출력을 제공합니다. 투명한 토큰 운영에 사용하세요.

Shielded wallet​

Zswap 영지식 증명을 사용하여 프라이버시가 보호되는 차폐 토큰을 관리합니다. ZK 증명 생성, 코인 커밋먼트 추적, 암호화된 출력 복호화를 처리합니다. 토큰 값과 주소가 관찰자에게 숨겨지면서도 검증 가능성은 유지됩니다.

DUST wallet​

NIGHT 보유에서 생성되는 수수료 결제 리소스인 Dust을 관리합니다. Dust 주소 지정, 잔액 추적, 트랜잭션 밸런싱 중 자동 수수료 결제를 처리합니다. 네트워크에서 모든 트랜잭션을 제출하는 데 필요합니다.

HD wallet​

BIP-32/BIP-44/CIP-1852 표준에 따라 시드에서 암호화 키를 파생합니다. 단일 니모닉 또는 시드에서 비차폐(secp256k1), 차폐(JubJub 곡선), Dust(BLS12-381 곡선) 운영을 위한 키를 생성합니다.

Address format​

Bech32m 형식을 사용하여 Midnight 주소를 인코딩하고 디코딩합니다. 네트워크 식별자와 함께 세 가지 주소 유형을 지원합니다:

  • mn_addr - 비차폐 결제 주소
  • mn_shield-addr - 차폐 결제 주소
  • mn_dust-addr - 수수료 생성을 위한 Dust 주소

Transaction balancing​

출력을 충당하기 위한 입력을 자동으로 제공하고, 잉여분에 대한 잔돈 출력을 생성하며, 수수료를 위한 Dust 지출을 추가합니다. 단일 트랜잭션에서 모든 토큰 유형에 걸쳐 동작합니다. 전송, 컨트랙트 상호작용, 스왑을 가능하게 하는 핵심 운영입니다.

Atomic swaps​

Midnight의 offer 시스템을 사용하여 당사자 간 신뢰 불필요한 토큰 교환을 가능하게 합니다. Offer을 단일 트랜잭션에 병합하여 교환 금액을 관찰자로부터 숨길 수 있습니다. 현재 차폐 전용 또는 비차폐 전용 스왑을 지원합니다.

New features requiring configuration updates​

다음은 새로운 기능을 사용하기 위해 필요한 설정 업데이트입니다.

Prover service connection​

차폐 트랜잭션과 Dust 지출을 위한 영지식 증명에는 외부 prover 서비스가 필요합니다. 이 설정 없이는 지갑에서 차폐 트랜잭션을 제출할 수 없습니다.

필요한 업데이트:

  • prove server 엔드포인트 URL을 설정하세요.
  • prove server가 실행 중이고 설정된 엔드포인트 URL을 통해 접근 가능한지 확인하세요.

Node endpoint​

지갑은 트랜잭션을 제출하고 블록체인 상태를 조회하기 위해 Midnight Node에 연결해야 합니다.

필요한 업데이트:

  • Midnight Node WebSocket 엔드포인트를 설정하세요.
  • Midnight Node이 실행 중이고 접근 가능한지 확인하세요.

Indexer endpoint​

지갑은 UTxO, 트랜잭션 이력, 상태 데이터를 동기화하기 위해 인덱서에 연결해야 합니다.

필요한 업데이트:

  • 인덱서 GraphQL 엔드포인트를 설정하세요.
  • 인덱서가 실행 중이고 접근 가능한지 확인하세요.

Known issues​

이 섹션은 이번 Wallet SDK 릴리스의 알려진 이슈를 나열합니다.

Pending coins not cleared on transaction failure​

트랜잭션 제출 또는 증명 생성이 실패할 때, 대기 중으로 표시된 코인이 자동으로 해제되지 않습니다. 이로 인해 대기 상태가 수동으로 해제되거나 지갑을 재시작할 때까지 지갑의 사용 가능 잔액이 실제보다 낮게 표시될 수 있습니다.

해결 방법: 지갑을 재시작하거나 재동기화하여 만료된 대기 상태를 해제하세요.

Transaction history not implemented for shielded and dust wallets​

차폐 지갑과 dust 지갑은 현재 트랜잭션 이력을 추적하지 않습니다. 비차폐 지갑은 트랜잭션 기록을 유지하지만, 차폐 지갑과 dust 지갑은 이력 트랜잭션 데이터 없이 코인 잔액만 추적합니다.

Packages​

PackageVersionDescription
@midnight-ntwrk/wallet-sdk-facade1.0.0차폐, 비차폐, dust 지갑 운영을 단일 인터페이스로 제공하는 통합 API. 트랜잭션 밸런싱, 전송, 스왑을 처리합니다.
@midnight-ntwrk/wallet-sdk-unshielded-wallet1.0.0NIGHT 및 기타 비차폐 토큰을 관리합니다. UTxO을 추적하고, 스왑을 위한 offer을 생성하며, 트랜잭션 밸런싱을 위한 입력/출력을 제공합니다.
@midnight-ntwrk/wallet-sdk-shielded1.0.0프라이버시가 보호되는 차폐 토큰을 관리합니다. ZK 증명 생성, 코인 커밋먼트 추적, 암호화된 출력 복호화를 처리합니다.
@midnight-ntwrk/wallet-sdk-dust-wallet1.0.0트랜잭션 수수료를 위한 Dust을 관리합니다. Dust 지정, 잔액 추적, 트랜잭션 밸런싱 중 자동 수수료 결제를 처리합니다.
@midnight-ntwrk/wallet-sdk-hd3.0.0BIP-32/BIP-44/CIP-1852에 따라 시드에서 암호화 키를 파생합니다. 비차폐(secp256k1), 차폐(JubJub), Dust(BLS12-381) 운영을 위한 키를 생성합니다.
@midnight-ntwrk/wallet-sdk-address-format3.0.0Bech32m 형식을 사용하여 Midnight 주소를 인코딩/디코딩합니다. 결제 주소, 차폐 주소, 네트워크 식별자가 포함된 Dust 주소를 지원합니다.
@midnight-ntwrk/wallet-sdk-node-client1.0.0Midnight Node와 통신합니다. 트랜잭션을 제출하고 블록체인 상태를 조회합니다.
@midnight-ntwrk/wallet-sdk-indexer-client1.0.0WebSocket을 통한 GraphQL로 Midnight 인덱서를 조회합니다. UTxO, 이벤트, 블록 정보를 검색합니다.
@midnight-ntwrk/wallet-sdk-prover-client1.0.0차폐 트랜잭션과 Dust 지출을 위한 영지식 증명을 생성하기 위해 prover 서비스와 연동합니다.
@midnight-ntwrk/wallet-sdk-runtime1.0.0지갑 라이프사이클과 상태 관리를 조직합니다. 프로토콜 업그레이드를 위한 버전 마이그레이션을 지원합니다.
@midnight-ntwrk/wallet-sdk-capabilities3.0.0코인 선택 알고리즘과 트랜잭션 밸런싱 로직을 포함한 공유 지갑 기능.
@midnight-ntwrk/wallet-sdk-abstractions1.0.0모든 패키지에서 사용되는 핵심 인터페이스와 도메인 타입.
@midnight-ntwrk/wallet-sdk-utilities1.0.0직렬화, 네트워킹, 테스트를 위한 공통 유틸리티.