Program-Derived Address (PDA)

Definisi: Program-Derived Address (PDA), atau alamat turunan program, adalah alamat Solana 32 byte yang ditentukan secara deterministik dari program ID dan sekumpulan seed. PDA sengaja dibuat di luar kurva Ed25519, sehingga tidak memiliki private key untuk menandatangani transaksi. Program yang ID-nya digunakan dalam derivasi dapat mengotorisasi PDA saat cross-program invocation (CPI) melalui mekanisme invoke_signed milik Solana.1, 2

Jaringan Solana
Jenis alamat Alamat 32 byte yang diturunkan di luar kurva Ed25519
Input derivasi Program ID, nilai seed, dan bump seed
Penggunaan umum State program, akun khusus pengguna, dan otoritas yang dikendalikan program
Dokumentasi resmi Dokumentasi Program-Derived Address
Direktori Direktori Solana

Cara derivasi PDA

Derivasi dimulai dengan program ID dan rangkaian byte seed yang ditentukan oleh rancangan program. Solana menggabungkan seed tersebut dengan bump dan penanda khusus, lalu melakukan hash untuk menghasilkan alamat. Sistem memeriksa apakah hasilnya merupakan titik valid pada kurva Ed25519. Jika alamat masih berada pada kurva, kandidat tersebut ditolak dan helper derivasi mencoba nilai bump lain hingga menemukan alamat di luar kurva. Helper standar menghasilkan bump kanonis, yaitu nilai pertama yang menghasilkan alamat off-curve untuk seed dan program ID tersebut.2

Program ID membatasi ruang alamat: seed yang sama dengan program ID berbeda akan menghasilkan alamat berbeda. API derivasi menerima maksimal 16 nilai seed secara keseluruhan, dengan panjang maksimal 32 byte untuk setiap seed. Karena byte seed digabungkan sebelum di-hash, pengembang perlu menyusun nilainya agar kombinasi berbeda tidak dapat dianggap sama—misalnya dengan panjang tetap atau pemisah yang jelas.2

Sifat Artinya
Deterministik Program ID, seed, dan bump kanonis yang sama menghasilkan alamat yang sama.
Off-curve Alamat bukan public key Ed25519 yang valid, sehingga tidak ada private key yang dapat menandatanganinya.
Otorisasi program Program yang menurunkannya dapat mengotorisasi PDA sebagai signer dalam CPI dengan invoke_signed.
Bukan akun secara otomatis Derivasi hanya menghitung alamat; instruksi terpisah harus membuat akun on-chain di alamat tersebut.

Yang dapat dan tidak dapat dilakukan PDA

Program memakai PDA untuk memberi alamat yang dapat diprediksi bagi state. Contohnya, program dapat menurunkan satu akun konfigurasi atau satu akun profil untuk setiap pengguna dengan memasukkan public key pengguna sebagai salah satu seed. PDA juga dapat menjadi otoritas akun token atau vault, sehingga program mengotorisasi tindakan melalui instruksinya tanpa perlu mengelola private key terpisah untuk alamat itu.1, 3

PDA adalah sebuah alamat, bukan wallet dengan private key tersembunyi. PDA tidak dapat menandatangani transaksi pengguna biasa, dan mengetahui seed tidak memberikan otoritas kepada pemanggil. Saat CPI, runtime memeriksa bahwa program yang memanggil menyediakan seed yang menurunkan PDA di bawah program ID miliknya; runtime lalu menganggap PDA sebagai signer hanya untuk pemanggilan tersebut.1, 3

Menurunkan PDA juga tidak otomatis membuat akun atau menentukan program mana yang boleh mengubah datanya. Akun harus dibuat secara terpisah. Setelah dibuat, field owner pada akun on-chain menentukan program yang boleh mengubah data atau mengurangi lamport, sehingga instruksi perlu memvalidasi alamat, owner, dan state akun yang diharapkan.3, 4

Pertimbangan keamanan

  • Gunakan bump kanonis. Bump nonkanonis dapat menghasilkan alamat off-curve kedua untuk seed yang sama, sehingga membuka risiko substitusi akun jika program menganggap hanya ada satu alamat.2
  • Buat seed tidak ambigu. Byte seed digabungkan sebelum hash. Tanpa panjang tetap atau pemisah, seed terpisah ab dan cd dapat menghasilkan input yang sama dengan satu seed abcd.2
  • Periksa owner dan state akun. Alamat PDA yang dikenal tidak membuktikan bahwa akun sudah dibuat, dimiliki program yang tepat, atau berisi data yang valid.4
  • Jangan anggap seed sebagai rahasia. Seed dipakai untuk menghitung alamat; logika instruksi dan pemeriksaan akunlah yang harus menegakkan otorisasi.

Diperbarui: 12 November 2026.

Istilah Terkait

Artikel Terkait

Lihat Juga

Sumber

  1. Solana. “Program Derived Addresses (PDAs).” Solana Documentation. Diakses 12 November 2026. https://solana.com/docs/core/pda.
  2. Solana. “PDA Derivation.” Solana Documentation. Diakses 12 November 2026. https://solana.com/docs/core/pda/pda-derivation.
  3. Solana. “PDA Accounts.” Solana Documentation. Diakses 12 November 2026. https://solana.com/docs/core/pda/pda-accounts.
  4. Solana. “Accounts.” Solana Documentation. Diakses 12 November 2026. https://solana.com/docs/core/accounts.