CPI 비용 모델 및 데이터 동기화

CPI 비용 모델

CPI 비용은 동일한 트랜잭션 컴퓨팅 예산(공유 미터)에서 차감됩니다. 각 invoke / invoke_signed 호출에 대한 전체 비용 공식:

total_cpi_cost = invocation_cost
               + instruction_data_cost
               + account_meta_cost          (SIMD-0339 only)
               + account_info_cost          (SIMD-0339 only)
               + per_account_data_cost      (for each non-executable account)
               + callee_execution_cost

비용 세부 내역

비용 계산 예시

100바이트의 instruction data, 5개의 계정 메타, 5개의 계정 정보(각각 1,000바이트의 데이터 포함), SIMD-0339 활성화 상태인 CPI:

invocation_cost        = 946
instruction_data_cost  = 100 / 250 = 0  (integer division)
account_meta_cost      = (5 * 34) / 250 = 0
account_info_cost      = (5 * 80) / 250 = 1
per_account_data_cost  = 5 * (1000 / 250) = 20
total (before callee)  = 967 CUs

계정 데이터 동기화

CPI 중 두 시점에서 호출자와 피호출자 간에 계정 상태가 동기화됩니다. 이를 통해 양측 모두 일관된 계정 데이터 뷰를 확인할 수 있습니다.

CPI 이전 동기화 (호출자에서 피호출자로)

피호출자가 실행되기 전에 update_callee_account는 호출자의 진행 중인 수정 사항을 피호출자의 계정 뷰로 복사합니다:

CPI 이후 동기화 (피호출자에서 호출자로)

피호출자가 반환된 후 update_caller_account는 피호출자의 수정 사항을 호출자의 뷰로 다시 복사합니다. 이는 쓰기 가능으로 표시된 계정에 대해서만 실행됩니다:

Realloc 제한

계정 데이터는 CPI 중에 현재 최상위 명령어 시작 시점의 계정 데이터 길이를 넘어 MAX_PERMITTED_DATA_INCREASE = 10,240바이트(10 KiB)까지 크기를 조정할 수 있습니다. 이 제한은 update_callee_account (CPI 이전)과 update_caller_account (CPI 이후) 모두에서 적용됩니다. 이를 초과하면 *rsInvalidRealloc*를 반환합니다.

PDA 서명

*rsinvoke_signed*가 호출되면, 런타임은 제공된 seed와 호출자의 프로그램 ID로부터 PDA 주소를 파생합니다. 이는 translate_signers_rust에서 발생합니다:

1. 서명자 seed 배열이 검증됩니다: 최대 MAX_SIGNERS (16)개의 서명자 seed 세트.
2. 각 seed 세트가 검증됩니다: 세트당 최대 MAX_SEEDS (16)개의 seed, 각 seed는 최대 MAX_SEED_LEN (32)바이트.
3. Pubkey::create_program_address가 seed와 호출자의 프로그램 ID(피호출자의 ID가 아님)로 호출됩니다.
4. seed가 유효한 PDA를 생성하지 못하면(즉, 결과 포인트가 ed25519 곡선 위에 있으면), CPI는 BadSeeds와 함께 실패합니다.
5. 파생된 PDA pubkey들이 수집되어 유효한 서명자로서 prepare_next_instruction에 전달됩니다. 권한 검사 중에 피호출자 계정이 서명자로 표시되고 해당 pubkey가 이러한 파생된 PDA 중 하나와 일치하면, 서명자 검사가 통과됩니다.

반환 데이터

프로그램은 반환 데이터 메커니즘을 사용하여 호출자에게 데이터를 전달할 수 있습니다. 이는 두 개의 syscall을 사용합니다:

• sol_set_return_data: 현재 명령어에 대해 최대 MAX_RETURN_DATA (1,024)바이트의 반환 데이터를 설정합니다. 비용은 data_len / cpi_bytes_per_unit + syscall_base_cost CU입니다.
• sol_get_return_data: 가장 최근에 실행된 명령어에 의해 설정된 반환 데이터를 읽습니다. 데이터를 설정한 프로그램 ID와 함께 데이터를 반환합니다. 비용은 (data_len + 32) / cpi_bytes_per_unit + syscall_base_cost CU입니다(프로그램 ID에 대해 32바이트).

반환 데이터는 트랜잭션별로 저장되며 sol_set_return_data를 호출하는 각 명령어에 의해 덮어쓰여집니다. 각 프로그램 호출이 시작될 때 런타임은 반환 데이터를 재설정하여 비웁니다. CPI가 반환된 후 호출자는 피호출자(또는 피호출자가 호출한 모든 프로그램)가 마지막으로 설정한 반환 데이터를 읽을 수 있습니다.