업데이트

현재 MPL-Distro 권한자는 새 PDA를 만들지 않고 기존 클레임 영수증을 무효화하지 않으면서 선택한 배포 필드를 바꿀 수 있습니다.

요약

updateDistribution은 기존 배포에 권한자가 승인한 구성 변경을 적용합니다.

• 전체 할당 구성은 활성 클레임 창 밖에서만 바꿉니다.
• 권한자와 permissioned distributor 같은 운영 필드는 클레임 중에 바꿀 수 있습니다.
• 권한자 변경은 즉시이며 보안에 민감하다고 취급합니다.
• 루트 업데이트와 동시에 교체 Merkle 증명을 원자적으로 공개합니다.

빠른 시작

MPL-Distro 배포 업데이트는 기존 계정에 대한 서명된 구성 변경입니다.

1. 클러스터 시각이 포함적 startTime–endTime 안에 있는지 확인합니다.
2. 바꿀 필드만 updateDistribution에 전달합니다.
3. Merkle 루트가 바뀌면 모든 오프체인 증명을 동시에 교체합니다.
4. 확인 후 저장된 권한자와 permissioned distributor를 검증합니다.

MPL-Distro 업데이트 권한

현재 권한자가 모든 배포 업데이트에 서명해야 합니다.

활성 창은 양쪽 경계 타임스탬프를 포함합니다. 보호된 할당 필드는 startTime <= clusterTime <= endTime일 때 잠깁니다.

MPL-Distro 구성 업데이트

바꿀 필드만 updateDistribution에 전달합니다.

1import { mplDistro, updateDistribution } from '@metaplex-foundation/mpl-distro'
2import { publicKey } from '@metaplex-foundation/umi'
3import { createUmi } from '@metaplex-foundation/umi-bundle-defaults'
4
5const umi = createUmi(
6  process.env.RPC_URL ?? 'https://api.devnet.solana.com'
7).use(mplDistro())
8
9const distributionAddress = process.env.DISTRIBUTION_ADDRESS!
10const newEndTimestamp = Math.floor(Date.now() / 1000) + 14 * 24 * 60 * 60
11const newDistributorAddress = process.env.PERMISSIONED_DISTRIBUTOR!
12
13await updateDistribution(umi, {
14  distribution: publicKey(distributionAddress),
15  endTime: BigInt(newEndTimestamp),
16  name: 'Extended community distribution',
17  newPermissionedDistributor: publicKey(newDistributorAddress),
18}).sendAndConfirm(umi)
19
20// The distribution end time, name, and permissioned distributor are updated.

명시적 treeHeight 없이 totalClaimants를 바꾸면 프로그램이 최소 높이를 추론합니다. 새로 준비한 트리가 반환하는 treeHeight를 전달하는 것이 더 명확하고 claimant 수 추론에 묶이지 않습니다.

배포 권한자 변경

updateDistribution은 업데이트, 입금, 토큰 출금, 보조금 출금을 할 수 있는 서명자를 교체합니다.

1import { mplDistro, updateDistribution } from '@metaplex-foundation/mpl-distro'
2import { publicKey } from '@metaplex-foundation/umi'
3import { createUmi } from '@metaplex-foundation/umi-bundle-defaults'
4
5const umi = createUmi(
6  process.env.RPC_URL ?? 'https://api.devnet.solana.com'
7).use(mplDistro())
8
9const distribution = publicKey(process.env.DISTRIBUTION_ADDRESS!)
10const currentAuthority = umi.identity
11const nextAuthority = publicKey(process.env.NEXT_AUTHORITY!)
12
13await updateDistribution(umi, {
14  distribution,
15  authority: currentAuthority,
16  newAuthority: nextAuthority,
17}).sendAndConfirm(umi)
18
19// Subsequent deposits, withdrawals, and updates require the new authority.

새 권한자는 업데이트에 서명할 필요가 없습니다. 변경을 제출하기 전에 대상 공개 키를 확인하고 그 서명 인프라가 동작하는지 확인하세요.

Permissioned Distributor 변경

updateDistribution은 AllowedDistributor.Permissioned로 구성된 배포가 받는 서명자를 바꿉니다. updateDistribution에 newPermissionedDistributor를 전달하세요.

이 변경은 Merkle 트리나 기존 영수증을 바꾸지 않습니다. 이전 distributor가 서명한 진행 중 트랜잭션은 업데이트가 착지한 뒤 실패합니다.

업데이트 오류

업데이트 오류는 권한자와 타이밍 제약을 보호합니다.

참고사항

구성 변경은 확인 직후 증명 유효성과 운영 권한에 영향을 줍니다.

• 활성 창 중 endTime 변경은 클레임 기간을 연장하거나 단축할 수 있습니다.
• 창 이후 루트 업데이트는 기존 클레임 영수증을 삭제하지 않습니다.
• 기존 영수증은 업데이트 후에도 배포 PDA에 키잉된 채로 남습니다.

FAQ

권한자가 활성 창 중에 Merkle 루트를 바꿀 수 있나요?

아니요. 루트, 트리 높이, 시작 시각, claimant 수는 활성 창 동안 잠기지만 시작 전 또는 종료 후에는 바꿀 수 있습니다.

활성 배포 중에 클레임 종료 시각을 연장할 수 있나요?

예. 권한자는 배포가 활성인 동안 endTime을 업데이트할 수 있습니다.

새 권한자가 권한 변경에 서명해야 하나요?

아니요. 현재 권한자만 updateDistribution에 서명합니다. 제출 전에 대상 키를 확인하세요.