Smart contract reference

Program

PDA seeds

const bounty = PublicKey.findProgramAddressSync(
  [Buffer.from("bounty"), sponsor.toBuffer(), bountyId.toArrayLike(Buffer, "le", 8)],
  programId
)[0];
const vault = PublicKey.findProgramAddressSync([Buffer.from("vault"), bounty.toBuffer()], programId)[0];
const submission = PublicKey.findProgramAddressSync(
  [Buffer.from("submission"), bounty.toBuffer(), creator.toBuffer()],
  programId
)[0];

Account data

Bounty

Submission

create_bounty

create_bounty(bounty_id: u64, title: String, description: String,
               reward_per_winner: u64, max_winners: u16, deadline: i64)

Accounts: sponsor (signer, mut), mint, bounty (init PDA), vault (init token account, authority = bounty), sponsor_ata (mut, mint = mint, authority = sponsor), token_program, system_program.

• reward_per_winner > 0, max_winners > 0.
• title is 1–64 bytes; description is at most 280 bytes.
• deadline is later than the current chain time.
• total = reward_per_winner × max_winners is checked for overflow, then transferred from sponsor_ata to vault with transfer_checked.
• Emits BountyCreated.

submit_clip

submit_clip(link: String)

Accounts: creator (signer, mut), bounty (mut), submission (init PDA), system_program.

• link is 1–200 bytes.
• Bounty status is Open and the current time is before deadline.
• Creating the submission PDA fails if the creator already entered, which enforces one entry per creator.
• Increments submission_count. Emits SubmissionCreated.

approve_submission

approve_submission()

Accounts: sponsor (signer, mut), bounty (mut, has_one = sponsor, has_one = mint), submission (mut, has_one = bounty, has_one = creator), creator, mint, vault (mut), creator_ata (init_if_needed associated token account, payer = sponsor), token_program, associated_token_program, system_program.

• Bounty is Open, submission is Pending, and paid_count < max_winners.
• Transfers reward_per_winner from the vault to the creator's token account, signed by the Bounty PDA.
• Sets the submission to Approved with paid_amount and paid_at, then increments paid_count.
• Allowed after the deadline until the sponsor reclaims. Emits PayoutEvent.

reject_submission

reject_submission()

Accounts: sponsor (signer), bounty (has_one = sponsor), submission (mut, has_one = bounty). Requires the submission to be Pending; sets it to Rejected. Emits RejectEvent.

reclaim_unspent

reclaim_unspent()

Accounts: sponsor (signer), bounty (mut, has_one = sponsor, has_one = mint), mint, vault (mut), sponsor_ata (mut), token_program.

• Bounty is Open and the current time is at or after deadline.
• Sets the bounty to Closed before transferring the entire remaining vault balance to sponsor_ata. A second call fails with BountyClosed.
• Emits ReclaimEvent with the amount returned.

Errors

Events