2026-09-13 — CPMM: 프로토콜이 크리에이터 수수료의 일부를 가져갑니다

​

통합자를 위한 요약

• 두 크리에이터 수수료 수집 명령어 모두 계정 목록을 변경했습니다. 이는 호환성이 깨집니다. CollectCreatorFee는 위치 5에 creator_fee_share를 추가합니다. CollectCreatorFeePermissionless는 위치 5에 amm_config를 추가하고 위치 6에 creator_fee_share를 추가합니다. 두 삽입 모두 볼트 앞에 있으므로 그 이후의 모든 것이 이동합니다. 이 트랜잭션을 다시 빌드하세요. 패치하지 마세요.
• creator_fee_share는 존재하지 않을 때도 전달되어야 합니다. 시드 제약으로 선언되지만 확인되지 않은 계정으로 읽혀지므로, 주소는 ["creator_fee_share", creator, amm_config]의 정규 PDA여야 하며 계정 자체는 선택 사항입니다. 비어 있을 때 프로그램은 AmmConfig.creator_fee_share_rate로 폴백합니다.
• AmmConfig는 creator_fee_share_rate를 얻습니다. 패딩에서 분리됩니다. 계정은 여전히 236 바이트이며 모든 기존 설정은 계속 역직렬화됩니다 — 하지만 이전 padding: [u64; 15]의 첫 번째 u64는 이제 활성 필드입니다. 꼬리를 15개 요소 배열로 모델링하는 디코더는 공유 비율을 padding[0]으로 읽습니다.
• PoolState는 변경되지 않습니다. 637 바이트, 같은 오프셋, 같은 필드. 프로토콜의 공유는 기존 protocol_fees_token_{0,1} 카운터에 기록됩니다 — 새로운 카운터도 없고 새로운 수집 명령어도 없습니다.
• protocol_fees_token*는 이제 스왑 외부에서 증가합니다. 프로토콜 누적을 거래량에 대해 조정하는 모든 모니터는 각 크리에이터 수수료 수집에서 점프를 볼 것입니다.
• creator_fees_token*를 읽는 크리에이터 지급 추정기는 이제 과대 계산합니다. (1 − share_rate / 1_000_000)을 곱하세요. 해당 (creator, amm_config) 쌍에 대해 해결됩니다.
• 두 개의 관리자 명령어가 추가됩니다: CreateCreatorFeeShare와 CloseCreatorFeeShare. 하나의 새로운 UpdateAmmConfig 파라미터: 8 → creator_fee_share_rate.
• 새로운 에러 코드 없습니다. 새로운 경로는 InvalidOwner(6001), InvalidInput(6003) 및 MathOverflow(6011)를 재사용합니다. 6000–6015는 변경되지 않습니다.
• IDL 새로고침이 필요합니다 — 두 개의 새로운 명령어, 하나의 새로운 계정 유형, 두 개의 변경된 계정 목록, 하나의 새로운 설정 필드.

​

분할이 작동하는 방식

1. CreatorFeeShare PDA at ["creator_fee_share", creator, amm_config] — 계정이 존재하고 CPMM이 소유할 때, 그 share_rate가 우선합니다.
2. AmmConfig.creator_fee_share_rate — 수수료 계층의 기본값, 그 외에는 사용됩니다.

// states/creator_fee_share.rs
shared_amount  = floor(creator_fee * share_rate / 1_000_000);
creator_amount = creator_fee - shared_amount;

// states/pool.rs — PoolState::settle_creator_fee
self.protocol_fees_token_i = self.protocol_fees_token_i.checked_add(shared_amount_i)?;
self.creator_fees_token_i  = 0;
// creator_amount_i is returned and transferred out to the creator

• 반올림은 크리에이터에게 유리합니다. 공유는 바닥값이므로 먼지는 크리에이터와 함께 남습니다 — Fees::protocol_fee와 Fees::fund_fee와 같은 방향이며, 이들도 이미 누적된 수수료에서 일부를 분리합니다. 1단위 수수료의 20%는 1이 아니라 0입니다.
• 값이 보존됩니다. 모든 비율과 u64::MAX까지의 모든 수수료에 대해 creator_amount + shared_amount == creator_fee입니다.
• share_rate = 0은 정확히 이전 동작입니다. 기본 설정 값과 누락된 PDA 모두 크리에이터에게 전체 수수료를 제공하므로, 관리자가 비율을 설정할 때까지 기존 풀에는 아무것도 변경되지 않습니다.

​

계정 목록 변경

​

CreateCreatorFeeShare와 CloseCreatorFeeShare

pub struct CreatorFeeShare {
    pub bump: u8,
    pub creator: Pubkey,
    pub amm_config: Pubkey,
    pub share_rate: u64,
    pub padding: [u64; 8],
}
// CreatorFeeShare::LEN == 145

• 풀 크리에이터는 어느 명령어의 당사자도 아니며 서명하지 않습니다. creator 계정은 확인되지 않습니다 — PDA는 아직 풀을 소유하지 않은 키에 대해 생성될 수 있습니다.
• 하나의 계정은 (creator, amm_config) 쌍을 다룹니다, 따라서 그 크리에이터가 해당 수수료 계층에서 소유한 모든 풀을 관리합니다. 두 계층에 풀이 있는 크리에이터는 둘 다에서 다루기 위해 두 개의 계정이 필요합니다.
• 업데이트 경로는 없습니다. 같은 쌍에 대한 두 번째 생성에서 초기화가 실패합니다. 비율을 변경하려면 닫고 다시 생성하세요.

​

UpdateAmmConfig 파라미터 8

Some(8) => update_creator_fee_share_rate(amm_config, value),   // asserts value <= 1_000_000

​

함께 탑승

​

변경되지 않은 것

• PoolState — 637 바이트, 같은 필드, 같은 오프셋. 프로토콜의 공유는 자체 카운터를 추가하는 대신 기존 프로토콜 버킷을 재사용합니다.
• AmmConfig::LEN — 여전히 236 바이트입니다.
• 스왑 수학, 견적, 그리고 k 확인. 크리에이터 수수료는 정확히 이전과 같이 청구됩니다.
• CollectProtocolFee / CollectFundFee — 같은 계정, 같은 서명자. CollectProtocolFee는 단순히 더 많이 수집합니다.
• 에러 코드. 6000–6015 변경 없음. 아무것도 추가되지 않습니다.
• 다른 모든 명령어, 그리고 프로그램 ID.

​

업데이트된 페이지

• products/cpmm/fees — 비율 해결, 분할 산술, 반올림, 통합자 결과를 다루는 새로운 “크리에이터 수수료의 프로토콜 공유” 섹션. creator_fee_share_rate가 비율/단위 목록과 기본 파라미터 테이블에 추가됨. 수집 흐름 테이블 재작업.
• products/cpmm/instructions — 상단의 호환성 깨짐 경고. 두 크리에이터 수수료 경로에 대한 전체 계정 테이블. 새로운 CreateCreatorFeeShare와 CloseCreatorFeeShare 섹션. UpdateAmmConfig 파라미터 8. CollectExcessLamports 순서 참고. 요약 및 상태 변경 행렬 행.
• products/cpmm/accounts — 새로운 CreatorFeeShare 계정 섹션. AmmConfig 레이아웃 및 패딩 분리 경고. PoolState 수수료 카운터 참고. 계정 수명 주기 행.
• products/cpmm/overview — 크리에이터 수수료 콜아웃 및 “예측 가능한 수수료” 글머리 기호.
• products/cpmm/math — 분할이 의도적으로 스왑 수학에서 제외된다는 참고.
• products/cpmm/code-demos — 업그레이드 전 SDK 빌더가 이전 계정 목록을 내보낸다는 경고. 누적 수수료 스니펫 주석 처리.
• reference/program-addresses — 새로운 “CPMM 크리에이터 수수료 공유 권한” 섹션. creator_fee_share가 PDA 시드 블록에 추가됨.
• reference/fee-comparison — creator_fee_share_rate가 다른 기반을 가진 네 번째 CPMM 비율로 호출됨.